POST módszer
A POST egy http-metódus, amely egyszerre egyetlen/több rekordot ad hozzá a Salesforce-hoz. Az URI-val rendelkező rekordokat beilleszthetjük az egyedi Apex REST API-n keresztül vagy közvetlenül az URI-ból.
Egyéni pihenőforrás az Apexben
A REST Apexben való megírásához használnunk kell néhány megjegyzést, amelyek hozzáférnek a REST API-hoz az Apex osztályban.
@HttpPost megjegyzés
Ez a metódus akkor kerül meghívásra, ha HTTP POST küldése történik, amely lehetővé teszi az Apex metódus REST erőforrásként való közzétételét. Ezután új erőforrást hoz létre.
Szintaxis: @httpPost
Példa:
Írja be a „RestApi_Post_Record.apxc” Apex osztályt, amely magában foglalja a REST „POST” metódust az állapot-, prioritás- és tárgymezők beszúrásához a Salesforce „Case” objektumába.
- Hozza létre a Post_Methodot három paraméterrel: állapot, prioritás és karakterlánc-típus tárgya.
- Hozzon létre egy „Case” objektumot ezen paraméterek átadásával.
- A DML beszúrásával illessze be a rekordot a Salesforce „Case” objektumába.
globális osztály RestApi_Post_Record{
// REST - Post Method
@httpPost
globális statikus Case Post_Method(String priority, String Status, String Subject){
Case case_obj= new Case(Priority=priority,Status = állapot,Tárgy=tárgy);
// DML beszúrása
insert case_obj;
return case_obj;
}
}
URI és eredmény:
Lépjen a Workbench oldalra, és keresse meg a REST Explorert. Adja meg a következő URI-t, és hajtsa végre:
/services/apexrest/v56.0/RestApi_Post_Record/
Adja meg az adatokat a kérelem törzsében:
{'Priority': 'Magas',
'Status':'Új',
'Tárgy': 'Mobil probléma'
}
Nyissa meg a rekordot a Salesforce-ban (navigáljon a „Case” objektumhoz az alkalmazásindítóból).
Egyetlen rekord beszúrása közvetlenül az URI-ból
Keresse meg a REST Explorert a „Segédprogramok” lapon, és adja meg a következő URI-t, és adja meg ezt a rekordot a Kérelem törzsében:
/services/data/v56.0/sobjects/Case/Kérelem szerve:
{'Priority': 'Közepes',
'Status':'Új',
'Tárgy': 'Microsoft csapatok – nem jönnek'
}
Lépjen a Salesforce „Cases” lapjára, és tekintse meg a rekordot.
Több rekord beszúrása közvetlenül az URI-ból
Ha egyszerre több rekordot szeretne beszúrni, az alábbiak szerint kell megadnunk az URI-t: /services/data/v56.0/composite/tree/sObject
A kérelmező szerv a nyilvántartásokat a következő formátumban tartja:
'rekordok' :[{'attributes' : {'type' : 'Object', 'referenceId' : 'reference1'},
mező:érték,
...
...
},{
'attributes' : {'type' : 'Object', 'referenceId' : 'reference1'},
mező:érték,
...
...
}]
}
Szúrjunk be két rekordot a Salesforce „Case” objektumába.
URI: /services/data/v56.0/composite/tree/Case/Kérelem szerve:
{'rekordok' :[{
'attributes' : {'type' : 'Case', 'referenceId' : 'reference1'},
'Priority': 'Magas',
'Status':'Új',
'Tárgy':'Tervezési probléma a mechanikus rotorral',
'Típus': 'Elektromos'
},{
'attributes' : {'type' : 'Case', 'referenceId' : 'reference2'},
'Priority':'Alacsony',
'Status':'Új',
'Tárgy': 'A generátor indítása elektromos hiba után' ,
'Típus': 'Elektromos'
}]
}
Két rekord van beszúrva a Salesforce-ba a 00001038 és a 00001039 esetszámmal.
PUT módszer
Amint azt korábban megbeszéltük, a PUT egy http metódus, amelyet a rekordok létrehozására/frissítésére használnak. Ebben az útmutatóban ezt a módszert használjuk új Salesforce rekord létrehozására az egyéni REST API használatával.
@httpPut : Ezt a metódust a HTTP PUT elküldésekor hívják meg, amely lehetővé teszi az Apex metódus REST erőforrásként való megjelenítését. Ezután új erőforrást hoz létre, vagy frissíti a meglévő erőforrást.
Szintaxis: @httpPutPélda:
Írja be a „RestApi_Put_Record.apxc” Apex osztályt, amely magában foglalja a REST „PUT” metódust, hogy beillessze az állapot-, prioritás- és leírásmezőket a Salesforce „Case” objektumába.
@RestResource(urlMapping='/v56.0/RestApi_Put_Record/')globális osztály RestApi_Put_Record{
// REST - Put Method
@httpPut
globális statikus eset Put_Method(karakterlánc prioritás, karakterlánc állapota, karakterlánc tárgya){
Case case_obj= new Case(Priority=priority,Status = állapot,Tárgy=tárgy);
// DML beszúrása
insert case_obj;
return case_obj;
}
}
URI és eredmény:
Lépjen a Workbench oldalra, és keresse meg a REST Explorert. Adja meg a következő URI-t, és hajtsa végre:
/services/apexrest/v56.0/RestApi_Put_Record/Adja meg az adatokat a kérelem törzsében:
{'Priority': 'Magas',
'Állapot': 'Zárt',
'Tárgy':'Zöldségdaráló útmutató szükséges'
}
Nyissa meg a rekordot a Salesforce-ban (navigáljon a „Case” objektumhoz az alkalmazásindítóból).
Következtetés
Most már beillesztheti a rekordokat a Salesforce-ba a http PUT és POST metódusok használatával. Megtanultuk, hogyan lehet a rekordokat közvetlenül beszúrni a Workbenchbe, és hogyan használhatjuk az egyéni REST API-t az Apex osztályon keresztül. Ebben az útmutatóban példaként a Salesforce „Case” objektumot használjuk. A PUT és a POST közötti tényleges különbség az, hogy a POST az adatok beszúrására szolgál, míg a PUT az adatok beszúrására/frissítésére szolgál. A @httpPut annotáció a PUT metódushoz, a @httpPost annotáció pedig a POST metódushoz használatos.