POST metode
POST er en http-metode som legger til enkelt-/flere poster om gangen i Salesforce. Vi kan sette inn postene med URI gjennom den tilpassede Apex REST API eller direkte fra URI.
Egendefinert hvileressurs i Apex
For å skrive REST i Apex, må vi bruke noen merknader som får tilgang til REST API i Apex-klassen din.
@HttpPost-kommentar
Denne metoden kalles når HTTP POST sendes som gjør at Apex-metoden kan eksponeres som en REST-ressurs. Deretter oppretter den en ny ressurs.
Syntaks: @httpPost
Eksempel:
Skriv 'RestApi_Post_Record.apxc' Apex-klassen som involverer REST 'POST'-metoden for å sette inn status-, prioritets- og emnefelt i Salesforce 'Case'-objektet.
- Opprett Post_Method med tre parametere: status, prioritet og emne for strengtype.
- Opprett et 'Case'-objekt ved å sende disse parameterne.
- Bruk insert DML for å sette inn posten i Salesforce 'Case'-objektet.
global klasse RestApi_Post_Record{
// REST - Post Metode
@httpPost
global statisk sak Post_Method(strengprioritet, strengstatus, strengemne){
Sak case_obj= ny sak(Prioritet=prioritet,Status = status,Emne=emne);
// Sett inn DML
sett inn case_obj;
returner case_obj;
}
}
URI og resultat:
Gå til Workbench og naviger til REST Explorer. Spesifiser følgende URI og utfør den:
/services/apexrest/v56.0/RestApi_Post_Record/
Spesifiser dataene i forespørselsteksten:
{'Prioritet': 'Høy',
'Status': 'Ny',
'Subject': 'Mobilproblem'
}
Åpne posten i Salesforce (naviger til «Case»-objektet fra appstarteren).
Sett inn en enkelt post direkte fra URI
Naviger til REST Explorer under 'Verktøy'-fanen og spesifiser følgende URI og spesifiser denne posten under Request Body:
/services/data/v56.0/sobjects/Case/Forespørselstekst:
{'Prioritet': 'Middels',
'Status': 'Ny',
'Subject': 'Microsoft-team - kommer ikke'
}
Gå til Salesforce-fanen 'Saker' og se posten.
Sett inn flere poster direkte fra URI
Hvis du vil sette inn flere poster om gangen, må vi spesifisere URI som følger: /services/data/v56.0/composite/tree/sObject
Forespørselsorganet oppbevarer postene i følgende format:
'rekorder' :[{'attributes' : {'type' : 'Objekt', 'referanseId' : 'referanse1'},
felt:verdi,
...
...
},{
'attributes' : {'type' : 'Objekt', 'referanseId' : 'referanse1'},
felt:verdi,
...
...
}]
}
La oss sette inn to poster i Salesforce 'Case'-objektet.
URI: /services/data/v56.0/composite/tree/Case/Forespørselstekst:
{'rekorder' :[{
'attributes' : {'type' : 'Case', 'referenceId' : 'referanse1'},
'Prioritet': 'Høy',
'Status': 'Ny',
'Subject':'Designproblem med mekanisk rotor',
'Type': 'Elektrisk'
},{
'attributes' : {'type' : 'Case', 'referenceId' : 'referanse2'},
'Priority': 'Lav',
'Status': 'Ny',
'Subject':'Starter generator etter elektrisk feil' ,
'Type': 'Elektrisk'
}]
}
To poster settes inn i Salesforce med saksnummer 00001038 og 00001039.
PUT metode
Som vi tidligere diskuterte, er PUT en http-metode som brukes til å opprette/oppdatere postene. I denne veiledningen bruker vi denne metoden til å opprette en ny Salesforce-post ved å bruke den tilpassede REST APIen.
@httpPut : Denne metoden kalles når HTTP PUT sendes som gjør at Apex-metoden kan eksponeres som en REST-ressurs. Deretter oppretter den en ny ressurs eller oppdaterer den eksisterende ressursen.
Syntaks: @httpPutEksempel:
Skriv 'RestApi_Put_Record.apxc' Apex-klassen som involverer REST 'PUT'-metoden for å sette inn status-, prioritets- og beskrivelsesfeltene i Salesforce 'Case'-objektet.
@RestResource(urlMapping='/v56.0/RestApi_Put_Record/')global klasse RestApi_Put_Record{
// REST - Put Method
@httpPut
global statisk sak Put_Method(strengprioritet, strengstatus, strengemne){
Sak case_obj= ny sak(Prioritet=prioritet,Status = status,Emne=emne);
// Sett inn DML
sett inn case_obj;
returner case_obj;
}
}
URI og resultat:
Gå til Workbench og naviger til REST Explorer. Spesifiser følgende URI og utfør den:
/services/apexrest/v56.0/RestApi_Put_Record/Spesifiser dataene i forespørselsteksten:
{'Prioritet': 'Høy',
'Status': 'Stengt',
'Subject':'Veiledning for grønnsakskvern trengs'
}
Åpne posten i Salesforce (naviger til «Case»-objektet fra appstarteren).
Konklusjon
Nå kan du sette inn postene i Salesforce ved å bruke http PUT- og POST-metodene. Vi lærte hvordan vi setter inn postene direkte i Workbench og bruker den tilpassede REST APIen gjennom Apex-klassen. Salesforce 'Case'-objektet brukes i denne veiledningen som et eksempel. Den faktiske forskjellen mellom PUT og POST er at POST brukes til å sette inn dataene mens PUT brukes til å sette inn/oppdatere dataene. @httpPut-kommentaren brukes for PUT-metoden og @httpPost-kommentaren brukes for POST-metoden.