POST-meetod
POST on http-meetod, mis lisab Salesforce'i korraga ühe/mitu kirjet. Saame URI-ga kirjed sisestada kohandatud Apex REST API kaudu või otse URI-st.
Kohandatud puhkeressurss Apexis
REST-i kirjutamiseks Apexis peame kasutama mõningaid märkusi, mis pääsevad juurde teie Apexi klassi REST API-le.
@HttpPosti märkus
Seda meetodit kutsutakse välja siis, kui saadetakse HTTP POST, mis võimaldab Apexi meetodit avaldada REST-ressursina. Seejärel loob see uue ressursi.
Süntaks: @httpPost
Näide:
Kirjutage 'RestApi_Post_Record.apxc' Apex-klass, mis hõlmab meetodit REST 'POST', et lisada Salesforce'i objekti 'Case' oleku-, prioriteedi- ja teemaväljad.
- Looge Post_Method kolme parameetriga: olek, prioriteet ja stringitüübi teema.
- Looge nende parameetrite edastamisega objekt 'Case'.
- Kasutage kirje sisestamiseks Salesforce'i objekti 'Case' DML-i lisamist.
globaalne klass RestApi_Post_Record{
// REST – Postitusmeetod
@httpPost
globaalne staatiline Case Post_Method(Stringi prioriteet, stringi olek, stringi teema){
Case case_obj= new Case(Priority=priority,Status = staatus,Subject=subject);
// Sisesta DML
sisesta case_obj;
return case_obj;
}
}
URI ja tulemus:
Avage Workbench ja navigeerige REST Exploreri juurde. Määrake järgmine URI ja käivitage see:
/services/apexrest/v56.0/RestApi_Post_Record/
Täpsustage andmed päringu sisus:
{'Priority': 'Kõrge',
'Olek': 'Uus',
'Teema': 'Mobiiliprobleem'
}
Avage kirje Salesforce'is (navigeerige rakenduste käivitajast objektile Case).
Sisestage üksikkirje otse URI-st
Liikuge vahekaardi „Utiliidid” all asuvasse REST Explorerisse ja määrake järgmine URI ja määrake see kirje päringu sisu all:
/services/data/v56.0/sobjects/Case/Taotluse sisu:
{'Priority': 'Keskmine',
'Olek': 'Uus',
'Teema': 'Microsofti meeskonnad – ei tule'
}
Minge Salesforce'i vahekaardile 'Juhtumid' ja vaadake kirjet.
Sisesta mitu kirjet otse URI-st
Kui soovite sisestada mitu kirjet korraga, peame määrama URI järgmiselt. /services/data/v56.0/composite/tree/sObject
Taotluse asutus säilitab dokumente järgmises vormingus:
'plaadid' :[{'attributes' : {'type' : 'Object', 'referenceId' : 'reference1'},
väli:väärtus,
...
...
},{
'attributes' : {'type' : 'Object', 'referenceId' : 'reference1'},
väli:väärtus,
...
...
}]
}
Sisestame kaks kirjet Salesforce'i objekti 'Case'.
URI: /services/data/v56.0/composite/tree/Case/Taotluse sisu:
{'plaadid' :[{
'attributes' : {'type' : 'Case', 'referenceId' : 'reference1'},
'Priority': 'Kõrge',
'Olek': 'Uus',
'Subject':'Mehaanilise rootori disainiprobleem',
'Tüüp': 'Elektriline'
},{
'attributes' : {'type' : 'Case', 'referenceId' : 'reference2'},
'Priority':'Madal',
'Olek': 'Uus',
'Subject':'Generaatori käivitamine pärast elektrikatkestust' ,
'Tüüp': 'Elektriline'
}]
}
Salesforce'i sisestatakse kaks kirjet juhtuminumbritega 00001038 ja 00001039.
PUT-meetod
Nagu me varem arutasime, on PUT http-meetod, mida kasutatakse kirjete loomiseks/värskendamiseks. Selles juhendis kasutame seda meetodit uue Salesforce'i kirje loomiseks kohandatud REST API abil.
@httpPut : seda meetodit kutsutakse välja HTTP PUT-i saatmisel, mis võimaldab Apex-meetodit avaldada REST-ressursina. Seejärel loob see uue ressursi või värskendab olemasolevat.
Süntaks: @httpPutNäide:
Kirjutage tippklass 'RestApi_Put_Record.apxc', mis hõlmab meetodit REST 'PUT', et lisada Salesforce'i objekti 'Case' oleku-, prioriteedi- ja kirjeldusväljad.
@RestResource(urlMapping='/v56.0/RestApi_Put_Record/')globaalne klass RestApi_Put_Record{
// REST - Pane meetod
@httpPut
globaalne staatiline Case Put_Method(stringi prioriteet, stringi olek, stringi teema){
Case case_obj= new Case(Priority=priority,Status = staatus,Subject=subject);
// Sisesta DML
sisesta case_obj;
return case_obj;
}
}
URI ja tulemus:
Avage Workbench ja navigeerige REST Exploreri juurde. Määrake järgmine URI ja käivitage see:
/services/apexrest/v56.0/RestApi_Put_Record/Täpsustage andmed päringu sisus:
{'Priority':'Kõrge',
'Olek': 'Suletud',
'Teema':'Vaja on juurviljaveski juhendit'
}
Avage kirje Salesforce'is (navigeerige rakenduste käivitajast objektile Case).
Järeldus
Nüüd saate kirjed Salesforce'i sisestada, kasutades meetodeid http PUT ja POST. Õppisime, kuidas sisestada kirjeid otse Workbenchi ja kasutada kohandatud REST API-d läbi Apexi klassi. Selles juhendis kasutatakse näitena Salesforce'i objekti 'Case'. Tegelik erinevus PUT-i ja POST-i vahel seisneb selles, et POST-i kasutatakse andmete sisestamiseks, samas kui PUT-i kasutatakse andmete sisestamiseks/värskendamiseks. Annotatsiooni @httpPut kasutatakse PUT-meetodi jaoks ja @httpPost-märkimist POST-meetodi jaoks.