Μέθοδος POST
Το POST είναι μια μέθοδος http που προσθέτει μεμονωμένες/πολλαπλές εγγραφές κάθε φορά στο Salesforce. Μπορούμε να εισάγουμε τις εγγραφές με URI μέσω του προσαρμοσμένου Apex REST API ή απευθείας από το URI.
Προσαρμοσμένος πόρος ανάπαυσης στο Apex
Για να γράψουμε REST στο Apex, πρέπει να χρησιμοποιήσουμε κάποιους σχολιασμούς που έχουν πρόσβαση στο REST API στην κλάση Apex.
@HttpPost Σχολιασμός
Αυτή η μέθοδος καλείται όταν αποστέλλεται HTTP POST που επιτρέπει στη μέθοδο Apex να εκτεθεί ως πόρος REST. Στη συνέχεια, δημιουργεί έναν νέο πόρο.
Σύνταξη: @httpPost
Παράδειγμα:
Γράψτε την κλάση Apex 'RestApi_Post_Record.apxc' που περιλαμβάνει τη μέθοδο REST 'POST' για να εισαγάγετε τα πεδία κατάστασης, προτεραιότητας και θέματος στο αντικείμενο 'Case' του Salesforce.
- Δημιουργήστε το Post_Method με τρεις παραμέτρους: κατάσταση, προτεραιότητα και θέμα τύπου συμβολοσειράς.
- Δημιουργήστε ένα αντικείμενο 'Case' περνώντας αυτές τις παραμέτρους.
- Χρησιμοποιήστε το ένθετο DML για να εισαγάγετε την εγγραφή στο αντικείμενο Salesforce 'Case'.
παγκόσμια τάξη RestApi_Post_Record{
// REST - Μέθοδος ανάρτησης
@httpPost
καθολική στατική περίπτωση Post_Method (Προτεραιότητα συμβολοσειράς, Κατάσταση συμβολοσειράς, Θέμα συμβολοσειράς){
Case case_obj= new Case(Priority=priority,Status = status,Subject=subject);
// Εισαγωγή DML
εισαγωγή case_obj;
επιστροφή case_obj;
}
}
URI και αποτέλεσμα:
Μεταβείτε στο Workbench και μεταβείτε στον REST Explorer. Καθορίστε το ακόλουθο URI και εκτελέστε το:
/services/apexrest/v56.0/RestApi_Post_Record/
Καθορίστε τα δεδομένα στο σώμα αιτήματος:
{'Προτεραιότητα':'Υψηλή',
'Κατάσταση':'Νέο',
'Θέμα':'Πρόβλημα με κινητό'
}
Ανοίξτε την εγγραφή στο Salesforce (πλοηγηθείτε στο αντικείμενο 'Υπόθεση' από την Εφαρμογή εκκίνησης).
Εισαγάγετε μια μεμονωμένη εγγραφή απευθείας από το URI
Μεταβείτε στην Εξερεύνηση REST στην καρτέλα 'Βοηθητικά προγράμματα' και καθορίστε το ακόλουθο URI και καθορίστε αυτήν την εγγραφή στο Σώμα αιτήματος:
/services/data/v56.0/sobjects/Case/Σώμα αιτήματος:
{'Προτεραιότητα':'Μεσαίο',
'Κατάσταση':'Νέο',
'Θέμα':'Ομάδες της Microsoft - Not Comingup'
}
Μεταβείτε στην καρτέλα 'Υποθέσεις' του Salesforce και προβάλετε την εγγραφή.
Εισαγάγετε πολλές εγγραφές απευθείας από το URI
Εάν θέλετε να εισάγετε πολλές εγγραφές ταυτόχρονα, πρέπει να καθορίσουμε το URI ως εξής: /services/data/v56.0/composite/tree/sObject
Ο φορέας αιτήματος διατηρεί τα αρχεία με την ακόλουθη μορφή:
'ρεκόρ' :[{'attributes' : {'type' : 'Object', 'referenceId' : 'reference1'},
πεδίο: τιμή,
...
...
},{
'attributes' : {'type' : 'Object', 'referenceId' : 'reference1'},
πεδίο: τιμή,
...
...
}]
}
Ας εισαγάγουμε δύο εγγραφές στο αντικείμενο Salesforce 'Case'.
URI: /services/data/v56.0/composite/tree/Case/Σώμα αιτήματος:
{'ρεκόρ' :[{
'attributes' : {'type' : 'Case', 'referenceId' : 'reference1'},
'Προτεραιότητα':'Υψηλή',
'Κατάσταση':'Νέο',
'Θέμα':'Πρόβλημα σχεδιασμού με μηχανικό ρότορα',
'Τύπος':'Ηλεκτρικός'
},{
'attributes' : {'type' : 'Case', 'referenceId' : 'reference2'},
'Προτεραιότητα':'Χαμηλή',
'Κατάσταση':'Νέο',
'Subject':'Εκκίνηση γεννήτριας μετά από ηλεκτρική βλάβη' ,
'Τύπος':'Ηλεκτρικός'
}]
}
Δύο εγγραφές εισάγονται στο Salesforce με CaseNumber 00001038 και 00001039.
Μέθοδος PUT
Όπως συζητήσαμε προηγουμένως, το PUT είναι μια μέθοδος http που χρησιμοποιείται για τη δημιουργία/ενημέρωση των εγγραφών. Σε αυτόν τον οδηγό, χρησιμοποιούμε αυτήν τη μέθοδο για να δημιουργήσουμε μια νέα εγγραφή Salesforce χρησιμοποιώντας το προσαρμοσμένο API REST.
@http Βάλτε : Αυτή η μέθοδος καλείται όταν αποστέλλεται το HTTP PUT, το οποίο επιτρέπει στη μέθοδο Apex να εκτεθεί ως πόρος REST. Στη συνέχεια, δημιουργεί έναν νέο πόρο ή ενημερώνει τον υπάρχοντα πόρο.
Σύνταξη: @httpPutΠαράδειγμα:
Γράψτε την κλάση Apex 'RestApi_Put_Record.apxc' που περιλαμβάνει τη μέθοδο REST 'PUT' για να εισαγάγετε τα πεδία κατάστασης, προτεραιότητας και περιγραφής στο αντικείμενο 'Case' του Salesforce.
@RestResource(urlMapping='/v56.0/RestApi_Put_Record/')παγκόσμια κλάση RestApi_Put_Record{
// REST - Μέθοδος Put
@http Βάλτε
καθολική στατική Case Put_Method (Προτεραιότητα συμβολοσειράς, Κατάσταση συμβολοσειράς, Θέμα συμβολοσειράς){
Case case_obj= new Case(Priority=priority,Status = status,Subject=subject);
// Εισαγωγή DML
εισαγωγή case_obj;
επιστροφή case_obj;
}
}
URI και αποτέλεσμα:
Μεταβείτε στο Workbench και μεταβείτε στον REST Explorer. Καθορίστε το ακόλουθο URI και εκτελέστε το:
/services/apexrest/v56.0/RestApi_Put_Record/Καθορίστε τα δεδομένα στο σώμα αιτήματος:
{'Προτεραιότητα':'Υψηλή',
'Κατάσταση': 'Κλειστό',
'Subject':'Ζητείται οδηγός λαχανικών-μύλος'
}
Ανοίξτε την εγγραφή στο Salesforce (πλοηγηθείτε στο αντικείμενο 'Υπόθεση' από την Εφαρμογή εκκίνησης).
συμπέρασμα
Τώρα, μπορείτε να εισάγετε τις εγγραφές στο Salesforce χρησιμοποιώντας τις μεθόδους http PUT και POST. Μάθαμε πώς να εισάγουμε τις εγγραφές απευθείας στον πάγκο εργασίας και να χρησιμοποιούμε το προσαρμοσμένο API REST μέσω της κλάσης Apex. Το αντικείμενο Salesforce 'Case' χρησιμοποιείται σε αυτόν τον οδηγό ως παράδειγμα. Η πραγματική διαφορά μεταξύ PUT και POST είναι ότι το POST χρησιμοποιείται για την εισαγωγή των δεδομένων ενώ το PUT χρησιμοποιείται για την εισαγωγή/ενημέρωση των δεδομένων. Ο σχολιασμός @httpPut χρησιμοποιείται για τη μέθοδο PUT και ο σχολιασμός @httpPost για τη μέθοδο POST.