POST metoda
POST je http metoda koja dodaje jedan/više zapisa odjednom u Salesforce. Zapise s URI-jem možemo umetnuti putem prilagođenog Apex REST API-ja ili izravno iz URI-ja.
Prilagođeni resurs za odmor u Apexu
Da bismo napisali REST u Apexu, moramo upotrijebiti neke bilješke koje pristupaju REST API-ju u vašoj Apex klasi.
@HttpPost Napomena
Ova se metoda poziva kada se pošalje HTTP POST koji omogućuje da Apex metoda bude izložena kao REST resurs. Zatim stvara novi resurs.
Sintaksa: @httpPost
Primjer:
Napišite Apex klasu “RestApi_Post_Record.apxc” koja uključuje metodu REST “POST” za umetanje polja statusa, prioriteta i predmeta u Salesforceov “Case” objekt.
- Stvorite Post_Method s tri parametra: status, prioritet i subjekt vrste niza.
- Stvorite objekt 'Case' prosljeđivanjem ovih parametara.
- Upotrijebite DML za umetanje za umetanje zapisa u objekt Salesforce 'Case'.
globalna klasa RestApi_Post_Record{
// REST - Post metoda
@httpPost
globalni statički Case Post_Method(Prioritet niza, Status niza, Predmet niza){
Case case_obj= new Case(Priority=priority,Status = status,Subject=subject);
// Umetni DML
umetnite case_obj;
vrati case_obj;
}
}
URI i rezultat:
Idite na Workbench i idite na REST Explorer. Navedite sljedeći URI i izvršite ga:
/services/apexrest/v56.0/RestApi_Post_Record/
Navedite podatke u tijelu zahtjeva:
{'Prioritet': 'Visoki',
'Status': 'Novo',
'Predmet': 'Problem s mobilnim uređajem'
}
Otvorite zapis u Salesforceu (dođite do objekta 'Slučaj' iz Pokretača aplikacija).
Umetnite jedan zapis izravno iz URI-ja
Dođite do REST Explorera pod karticom 'Utilities' i navedite sljedeći URI i navedite ovaj zapis pod tijelom zahtjeva:
/services/data/v56.0/subjects/Case/Tijelo zahtjeva:
{'Prioritet': 'Srednji',
'Status': 'Novo',
'Predmet': 'Microsoft timovi - ne dolaze'
}
Idite na Salesforce karticu “Slučajevi” i pogledajte zapis.
Umetnite više zapisa izravno iz URI-ja
Ako želite umetnuti više zapisa odjednom, trebamo navesti URI na sljedeći način: /services/data/v56.0/composite/tree/sObject
Tijelo zahtjeva čuva evidenciju u sljedećem formatu:
'zapisi' :[{'attributes' : {'type' : 'Object', 'referenceId' : 'reference1'},
polje:vrijednost,
...
...
},{
'attributes' : {'type' : 'Object', 'referenceId' : 'reference1'},
polje:vrijednost,
...
...
}]
}
Umetnimo dva zapisa u objekt Salesforce 'Case'.
URI: /services/data/v56.0/composite/tree/Case/Tijelo zahtjeva:
{'zapisi' :[{
'attributes' : {'type' : 'Case', 'referenceId' : 'reference1'},
'Prioritet': 'Visoki',
'Status': 'Novo',
'Predmet': 'Problem s dizajnom mehaničkog rotora',
'Vrsta': 'Elektrika'
},{
'attributes' : {'type' : 'Case', 'referenceId' : 'reference2'},
'Prioritet': 'Nizak',
'Status': 'Novo',
'Predmet': 'Pokretanje generatora nakon električnog kvara' ,
'Vrsta': 'Elektrika'
}]
}
Dva su zapisa umetnuta u Salesforce s CaseNumber 00001038 i 00001039.
Metoda PUT
Kao što smo prethodno spomenuli, PUT je http metoda koja se koristi za stvaranje/ažuriranje zapisa. U ovom vodiču koristimo ovu metodu za stvaranje novog Salesforce zapisa pomoću prilagođenog REST API-ja.
@httpPut : Ova se metoda poziva kada se pošalje HTTP PUT koji omogućuje da Apex metoda bude izložena kao REST resurs. Zatim stvara novi resurs ili ažurira postojeći resurs.
Sintaksa: @httpPutPrimjer:
Napišite Apex klasu “RestApi_Put_Record.apxc” koja uključuje metodu REST “PUT” za umetanje polja statusa, prioriteta i opisa u objekt Salesforce “Case”.
@RestResource(urlMapping='/v56.0/RestApi_Put_Record/')globalna klasa RestApi_Put_Record{
// REST - Put metoda
@httpPut
global static Case Put_Method(Prioritet niza, Status niza, Predmet niza){
Case case_obj= new Case(Priority=priority,Status = status,Subject=subject);
// Umetni DML
umetnite case_obj;
vrati case_obj;
}
}
URI i rezultat:
Idite na Workbench i idite na REST Explorer. Navedite sljedeći URI i izvršite ga:
/services/apexrest/v56.0/RestApi_Put_Record/Navedite podatke u tijelu zahtjeva:
{'Prioritet': 'Visoki',
'Status': 'Zatvoreno',
'Predmet': 'Potreban je vodič za mlin za povrće'
}
Otvorite zapis u Salesforceu (dođite do objekta 'Slučaj' iz Pokretača aplikacija).
Zaključak
Sada možete umetnuti zapise u Salesforce pomoću metoda http PUT i POST. Naučili smo kako umetnuti zapise izravno u Workbench i koristiti prilagođeni REST API kroz Apex klasu. Objekt Salesforce 'Case' koristi se u ovom vodiču kao primjer. Stvarna razlika između PUT i POST je u tome što se POST koristi za umetanje podataka, dok se PUT koristi za umetanje/ažuriranje podataka. Napomena @httpPut koristi se za metodu PUT, a oznaka @httpPost koristi se za metodu POST.