POST metodas
POST yra http metodas, kuris vienu metu į „Salesforce“ prideda vieną / kelis įrašus. Įrašus su URI galime įterpti per tinkintą Apex REST API arba tiesiai iš URI.
Pasirinktinis poilsio šaltinis „Apex“.
Norėdami parašyti REST „Apex“, turime naudoti kai kuriuos komentarus, kurie pasiekia jūsų „Apex“ klasės REST API.
@HttpPost komentaras
Šis metodas iškviečiamas, kai siunčiamas HTTP POST, kuris įgalina Apex metodą atskleisti kaip REST šaltinį. Tada sukuriamas naujas šaltinis.
Sintaksė: @httpPost
Pavyzdys:
Parašykite „RestApi_Post_Record.apxc“ Apex klasę, kuri apima REST „POST“ metodą, kad į „Salesforce“ objektą „Case“ įterptumėte būsenos, prioriteto ir temos laukus.
- Sukurkite Post_Method su trimis parametrais: būsena, prioritetu ir eilutės tipo tema.
- Perduodami šiuos parametrus sukurkite objektą „Case“.
- Norėdami įterpti įrašą į „Salesforce“ objektą „Case“, naudokite įterpimo DML.
pasaulinė klasė RestApi_Post_Record{
// REST - Post Method
@http Post
global static Case Post_Method (Eilutės prioritetas, eilutės būsena, eilutės tema){
Case case_obj= new Case(Priority=priority,Status = status,Subject=subject);
// Įterpti DML
įterpti case_obj;
return case_obj;
}
}
URI ir rezultatas:
Eikite į Workbench ir eikite į REST Explorer. Nurodykite šį URI ir paleiskite jį:
/services/apexrest/v56.0/RestApi_Post_Record/
Užklausos turinyje nurodykite duomenis:
{'Prioritetas': 'Aukštas',
'Būsena': 'Nauja',
'Tema': 'Mobiliojo ryšio problema'
}
Atidarykite įrašą „Salesforce“ (programų paleidimo priemonėje eikite į objektą „Case“).
Įterpkite vieną įrašą tiesiai iš URI
Eikite į REST Explorer skirtuke „Komunalinės paslaugos“ ir nurodykite šį URI bei nurodykite šį įrašą užklausos turinyje:
/services/data/v56.0/sobjects/Case/Prašymo įstaiga:
{'Prioritetas': 'Vidutinis',
'Būsena': 'Nauja',
„Tema“: „Microsoft komandos – neprieina“
}
Eikite į „Salesforce“ skirtuką „Cases“ ir peržiūrėkite įrašą.
Įterpkite kelis įrašus tiesiai iš URI
Jei norite įterpti kelis įrašus vienu metu, turime nurodyti URI taip: /services/data/v56.0/composite/tree/sObject
Užklausos institucija saugo įrašus tokiu formatu:
'įrašai' :[{'attributes' : {'type' : 'Object', 'referenceId' : 'reference1'},
laukas:vertė,
...
...
},{
'attributes' : {'type' : 'Object', 'referenceId' : 'reference1'},
laukas:vertė,
...
...
}]
}
Į „Salesforce“ objektą „Case“ įterpkime du įrašus.
URI: /services/data/v56.0/composite/tree/Case/Prašymo įstaiga:
{'įrašai' :[{
'attributes' : {'type' : 'Case', 'referenceId' : 'reference1'},
'Prioritetas': 'Aukštas',
'Būsena': 'Nauja',
'Tema': 'Mechaninio rotoriaus dizaino problema',
'Tipas': 'Elektrinė'
},{
'attributes' : {'type' : 'Case', 'referenceId' : 'reference2'},
'Prioritetas': 'Žemas',
'Būsena': 'Nauja',
'Tema': 'Generatoriaus paleidimas po elektros gedimo' ,
'Tipas': 'Elektrinė'
}]
}
Į „Salesforce“ įterpiami du įrašai su CaseNumber 00001038 ir 00001039.
PUT metodas
Kaip jau aptarėme, PUT yra http metodas, naudojamas įrašams kurti / atnaujinti. Šiame vadove mes naudojame šį metodą norėdami sukurti naują „Salesforce“ įrašą naudodami tinkintą REST API.
@httpPut : Šis metodas iškviečiamas, kai siunčiamas HTTP PUT, kuris įgalina Apex metodą atskleisti kaip REST šaltinį. Tada sukuriamas naujas išteklius arba atnaujinamas esamas šaltinis.
Sintaksė: @httpPutPavyzdys:
Parašykite „RestApi_Put_Record.apxc“ Apex klasę, kuri apima REST „PUT“ metodą, kad į „Salesforce“ objektą „Case“ įterptumėte būsenos, prioriteto ir aprašo laukus.
@RestResource(urlMapping='/v56.0/RestApi_Put_Record/')pasaulinė klasė RestApi_Put_Record{
// REST – Įdėjimo metodas
@httpPut
global static Case Put_Method (Eilutės prioritetas, eilutės būsena, eilutės tema){
Case case_obj= new Case(Priority=priority,Status = status,Subject=subject);
// Įterpti DML
įterpti case_obj;
return case_obj;
}
}
URI ir rezultatas:
Eikite į Workbench ir eikite į REST Explorer. Nurodykite šį URI ir paleiskite jį:
/services/apexrest/v56.0/RestApi_Put_Record/Užklausos turinyje nurodykite duomenis:
{'Prioritetas': 'Aukštas',
'Būsena': 'Uždaryta',
'Tema': 'Reikalingas daržovių malūnėlio vadovas'
}
Atidarykite įrašą „Salesforce“ (programų paleidimo priemonėje eikite į objektą „Case“).
Išvada
Dabar galite įterpti įrašus į „Salesforce“ naudodami http PUT ir POST metodus. Sužinojome, kaip įterpti įrašus tiesiai į „Workbench“ ir naudoti pasirinktinę REST API per „Apex“ klasę. „Salesforce“ objektas „Case“ šiame vadove naudojamas kaip pavyzdys. Faktinis skirtumas tarp PUT ir POST yra tas, kad POST naudojamas duomenims įterpti, o PUT naudojamas duomenims įterpti / atnaujinti. @httpPut anotacija naudojama PUT metodui, o @httpPost anotacija naudojama POST metodui.