Paraan ng POST
Ang POST ay isang http na paraan na nagdaragdag ng isa/maraming tala sa isang pagkakataon sa Salesforce. Maaari naming ipasok ang mga tala na may URI sa pamamagitan ng custom na Apex REST API o direkta mula sa URI.
Custom na Rest Resource sa Apex
Upang magsulat ng REST sa Apex, kailangan naming gumamit ng ilang anotasyon na nag-a-access sa REST API sa iyong klase ng Apex.
@HttpPost Anotasyon
Tinatawag ang pamamaraang ito kapag ipinadala ang HTTP POST na nagbibigay-daan sa paraan ng Apex na malantad bilang isang mapagkukunan ng REST. Pagkatapos, lumilikha ito ng bagong mapagkukunan.
Syntax: @httpPost
Halimbawa:
Isulat ang 'RestApi_Post_Record.apxc' na klase ng Apex na kinasasangkutan ng REST 'POST' na paraan para ipasok ang status, priority, at subject na mga field sa Salesforce na 'Case' object.
- Lumikha ng Post_Method na may tatlong parameter: status, priyoridad, at paksa ng uri ng string.
- Gumawa ng object na 'Case' sa pamamagitan ng pagpasa sa mga parameter na ito.
- Gamitin ang insert DML para ipasok ang record sa Salesforce na 'Case' object.
pandaigdigang klase RestApi_Post_Record{
// REST - Paraan ng Post
@httpPost
global static Case Post_Method(String Priority, String Status, String Subject){
Case case_obj= bagong Case(Priority=priority,Status = status,Subject=subject);
// Ipasok ang DML
ipasok ang case_obj;
ibalik case_obj;
}
}
URI at Resulta:
Pumunta sa Workbench at mag-navigate sa REST Explorer. Tukuyin ang sumusunod na URI at isagawa ito:
/services/apexrest/v56.0/RestApi_Post_Record/
Tukuyin ang data sa Katawan ng Kahilingan:
{'Priyoridad': 'Mataas',
'Status': 'Bago',
'Paksa': 'Isyu sa mobile'
}
Buksan ang record sa Salesforce (mag-navigate sa object na 'Case' mula sa App Launcher).
Direktang Magpasok ng Isang Tala mula sa URI
Mag-navigate sa REST Explorer sa ilalim ng tab na 'Mga Utility' at tukuyin ang sumusunod na URI at tukuyin ang record na ito sa ilalim ng Request Body:
/services/data/v56.0/sobjects/Case/Katawan ng Kahilingan:
{'Priyoridad':'Katamtaman',
'Status': 'Bago',
'Paksa': 'Mga koponan ng Microsoft - Hindi Paparating'
}
Pumunta sa tab na 'Mga Kaso' ng Salesforce at tingnan ang talaan.
Direktang Magpasok ng Maramihang Mga Tala mula sa URI
Kung gusto mong magpasok ng maramihang mga tala sa isang pagkakataon, kailangan naming tukuyin ang URI tulad ng sumusunod: /services/data/v56.0/composite/tree/sObject
Ang Request Body ang nagtataglay ng mga tala sa sumusunod na format:
'mga tala' :[{'attributes' : {'type' : 'Object', 'referenceId' : 'reference1'},
field:value,
...
...
},{
'attributes' : {'type' : 'Object', 'referenceId' : 'reference1'},
field:value,
...
...
}]
}
Maglagay tayo ng dalawang tala sa object na 'Case' ng Salesforce.
URI: /services/data/v56.0/composite/tree/Case/Katawan ng Kahilingan:
{'mga tala' :[{
'attributes' : {'type' : 'Case', 'referenceId' : 'reference1'},
'Priyoridad': 'Mataas',
'Status': 'Bago',
'Subject': 'Isyu sa disenyo sa mechanical rotor',
'Uri': 'Elektrisidad'
},{
'attributes' : {'type' : 'Case', 'referenceId' : 'reference2'},
'Priyoridad': 'Mababa',
'Status': 'Bago',
'Subject':'Pagsisimula ng generator pagkatapos ng electrical failure' ,
'Uri': 'Elektrisidad'
}]
}
Dalawang record ang ipinapasok sa Salesforce na may CaseNumber 00001038 at 00001039.
Paraan ng PUT
Tulad ng naunang napag-usapan natin, ang PUT ay isang http na paraan na ginagamit upang lumikha/mag-update ng mga talaan. Sa gabay na ito, ginagamit namin ang paraang ito para gumawa ng bagong tala ng Salesforce gamit ang custom na REST API.
@httpPut : Tinatawag ang pamamaraang ito kapag ipinadala ang HTTP PUT na nagbibigay-daan sa paraan ng Apex na malantad bilang isang mapagkukunan ng REST. Pagkatapos, gagawa ito ng bagong mapagkukunan o i-update ang kasalukuyang mapagkukunan.
Syntax: @httpPutHalimbawa:
Isulat ang klase ng Apex na 'RestApi_Put_Record.apxc' na kinabibilangan ng REST 'PUT' na paraan upang ipasok ang mga field ng status, priyoridad, at paglalarawan sa object ng Salesforce na 'Case'.
@RestResource(urlMapping='/v56.0/RestApi_Put_Record/')pandaigdigang klase RestApi_Put_Record{
// REST - Ilagay ang Paraan
@httpPut
global static Case Put_Method(String Priority, String Status, String Subject){
Case case_obj= bagong Case(Priority=priority,Status = status,Subject=subject);
// Ipasok ang DML
ipasok ang case_obj;
ibalik case_obj;
}
}
URI at Resulta:
Pumunta sa Workbench at mag-navigate sa REST Explorer. Tukuyin ang sumusunod na URI at isagawa ito:
/services/apexrest/v56.0/RestApi_Put_Record/Tukuyin ang data sa Katawan ng Kahilingan:
{'Priyoridad': 'Mataas',
'Status': 'Sarado',
'Subject': 'Kailangan ang gabay ng Vegetable-Grinder'
}
Buksan ang record sa Salesforce (mag-navigate sa object na 'Case' mula sa App Launcher).
Konklusyon
Ngayon, nagagawa mong ipasok ang mga tala sa Salesforce gamit ang mga pamamaraang http PUT at POST. Natutunan namin kung paano direktang ipasok ang mga tala sa Workbench at gamitin ang custom na REST API sa pamamagitan ng klase ng Apex. Ang bagay na 'Case' ng Salesforce ay ginagamit sa gabay na ito bilang isang halimbawa. Ang aktwal na pagkakaiba sa pagitan ng PUT at POST ay ang POST ay ginagamit upang ipasok ang data samantalang ang PUT ay ginagamit upang ipasok/i-update ang data. Ang @httpPut annotation ay ginagamit para sa PUT method at ang @httpPost annotation ay ginagamit para sa POST method.