Metoda POST
POST este o metodă http care adaugă înregistrări unice/mai multe simultan în Salesforce. Putem insera înregistrările cu URI prin API-ul Apex REST personalizat sau direct din URI.
Resursă de odihnă personalizată în Apex
Pentru a scrie REST în Apex, trebuie să folosim câteva adnotări care accesează API-ul REST în clasa ta Apex.
Adnotare @HttpPost
Această metodă este apelată atunci când este trimis HTTP POST care permite ca metoda Apex să fie expusă ca resursă REST. Apoi, creează o nouă resursă.
Sintaxă: @httpPost
Exemplu:
Scrieți clasa Apex „RestApi_Post_Record.apxc” care implică metoda REST „POST” pentru a insera câmpurile de stare, prioritate și subiect în obiectul „Caz” Salesforce.
- Creați Post_Method cu trei parametri: stare, prioritate și subiectul tipului șirului.
- Creați un obiect „Case” prin transmiterea acestor parametri.
- Utilizați inserarea DML pentru a insera înregistrarea în obiectul „Caz” Salesforce.
clasa globală RestApi_Post_Record{
// REST - Metoda post
@httpPost
global static Case Post_Method(Prioritate șir, Stare șir, Subiect șir){
Case case_obj= new Case(Priority=priority,Status = status,Subject=subject);
// Inserați DML
introduce case_obj;
return case_obj;
}
}
URI și rezultat:
Accesați Workbench și navigați la REST Explorer. Specificați următorul URI și executați-l:
/services/apexrest/v56.0/RestApi_Post_Record/
Specificați datele în Corpul de solicitare:
{'Priority':'Ridicat',
'Stare':'Nou',
'Subject':'Problemă mobilă'
}
Deschideți înregistrarea în Salesforce (navigați la obiectul „Case” din Lansatorul de aplicații).
Inserați o singură înregistrare direct din URI
Navigați la REST Explorer sub fila „Utilități” și specificați următorul URI și specificați această înregistrare în Corpul cererii:
/services/data/v56.0/sobjects/Case/Organismul de solicitare:
{'Priority':'Mediu',
'Stare':'Nou',
'Subject':'Echipe Microsoft - Nu apare'
}
Accesați fila „Cazuri” Salesforce și vizualizați înregistrarea.
Inserați mai multe înregistrări direct din URI
Dacă doriți să introduceți mai multe înregistrări simultan, trebuie să specificăm URI-ul după cum urmează: /services/data/v56.0/composite/tree/sObject
Organismul de solicitare deține înregistrările în următorul format:
'înregistrări' :[{'atribute': {'type': 'Obiect', 'referenceId': 'reference1'},
câmp:valoare,
...
...
},{
'atribute': {'type': 'Obiect', 'referenceId': 'reference1'},
câmp:valoare,
...
...
}]
}
Să inserăm două înregistrări în obiectul „Caz” Salesforce.
URI: /services/data/v56.0/composite/tree/Case/Organismul de solicitare:
{'înregistrări' :[{
'atribute': {'type': 'Caz', 'referenceId': 'reference1'},
'Priority':'Ridicat',
'Stare':'Nou',
'Subject':'Problemă de proiectare cu rotorul mecanic',
'Type':'Electric'
},{
'atribute': {'type': 'Caz', 'referenceId': 'reference2'},
'Priority':'Scăzut',
'Stare':'Nou',
'Subject':'Pornirea generatorului după o defecțiune electrică' ,
'Type':'Electric'
}]
}
Două înregistrări sunt inserate în Salesforce cu CaseNumber 00001038 și 00001039.
Metoda PUT
După cum am discutat anterior, PUT este o metodă http care este folosită pentru a crea/actualiza înregistrările. În acest ghid, folosim această metodă pentru a crea o nouă înregistrare Salesforce utilizând API-ul REST personalizat.
@httpPut : Această metodă este apelată atunci când este trimis HTTP PUT care permite ca metoda Apex să fie expusă ca resursă REST. Apoi, creează o nouă resursă sau actualizează resursa existentă.
Sintaxă: @httpPutExemplu:
Scrieți clasa Apex „RestApi_Put_Record.apxc” care implică metoda REST „PUT” pentru a insera câmpurile de stare, prioritate și descriere în obiectul „Caz” Salesforce.
@RestResource(urlMapping='/v56.0/RestApi_Put_Record/')clasa globală RestApi_Put_Record{
// REST - Metoda Put
@httpPut
static global Case Put_Method (Prioritate șir, Stare șir, Subiect șir){
Case case_obj= new Case(Priority=priority,Status = status,Subject=subject);
// Inserați DML
introduce case_obj;
return case_obj;
}
}
URI și rezultat:
Accesați Workbench și navigați la REST Explorer. Specificați următorul URI și executați-l:
/services/apexrest/v56.0/RestApi_Put_Record/Specificați datele în Corpul de solicitare:
{'Priority':'Ridicat',
'Status':'Închis',
'Subject':'Este necesar ghidul pentru tocat legume'
}
Deschideți înregistrarea în Salesforce (navigați la obiectul „Case” din Lansatorul de aplicații).
Concluzie
Acum, puteți insera înregistrările în Salesforce utilizând metodele http PUT și POST. Am învățat cum să inserăm înregistrările direct în Workbench și să folosim API-ul REST personalizat prin clasa Apex. Obiectul „Caz” Salesforce este utilizat în acest ghid ca exemplu. Diferența reală dintre PUT și POST este că POST este folosit pentru a insera datele, în timp ce PUT este folosit pentru a insera/actualiza datele. Adnotarea @httpPut este utilizată pentru metoda PUT și adnotarea @httpPost este folosită pentru metoda POST.