POST-menetelmä
POST on http-menetelmä, joka lisää yhden tai useita tietueita kerrallaan Salesforceen. Voimme lisätä tietueet URI:lla mukautetun Apex REST API:n kautta tai suoraan URI:sta.
Mukautettu leporesurssi Apexissa
Kirjoittaaksemme RESTin Apexissa, meidän on hyödynnettävä joitain merkintöjä, jotka käyttävät Apex-luokkasi REST-sovellusliittymää.
@HttpPost-merkintä
Tätä menetelmää kutsutaan, kun HTTP POST lähetetään, mikä mahdollistaa Apex-menetelmän paljastamisen REST-resurssina. Sitten se luo uuden resurssin.
Syntaksi: @httpPost
Esimerkki:
Kirjoita 'RestApi_Post_Record.apxc' Apex-luokka, joka sisältää REST 'POST'-metodin tila-, prioriteetti- ja aihekenttien lisäämiseksi Salesforcen Case-objektiin.
- Luo Post_Method kolmella parametrilla: status, prioriteetti ja merkkijonotyypin aihe.
- Luo 'Case'-objekti välittämällä nämä parametrit.
- Lisää tietue Salesforce Case -objektiin lisäämällä DML.
globaali luokka RestApi_Post_Record{
// REST - Post Method
@httpPost
globaali staattinen Case Post_Method(merkkijonon prioriteetti, merkkijonon tila, merkkijonon aihe){
Case case_obj= new Case(Priority=priority,Status = tila,Aihe=aihe);
// Lisää DML
lisää case_obj;
return case_obj;
}
}
URI ja tulos:
Siirry Workbenchiin ja siirry REST Exploreriin. Määritä seuraava URI ja suorita se:
/services/apexrest/v56.0/RestApi_Post_Record/
Määritä tiedot pyyntötekstissä:
{'Priority':'Korkea',
'Status':'Uusi',
'Aihe':'Mobiiliongelma'
}
Avaa tietue Salesforcessa (siirry Case-objektiin sovellusten käynnistysohjelmasta).
Lisää yksi tietue suoraan URI:sta
Siirry Apuohjelmat-välilehden REST Exploreriin ja määritä seuraava URI ja määritä tämä tietue Request Body -kohdassa:
/services/data/v56.0/sobjects/Case/Pyyntöteksti:
{'Priority':'Keskitaso',
'Status':'Uusi',
'Aihe':'Microsoft-tiimit - Ei tulossa'
}
Siirry Salesforcen 'Cases' -välilehdelle ja katso tietue.
Lisää useita tietueita suoraan URI:sta
Jos haluat lisätä useita tietueita kerralla, meidän on määritettävä URI seuraavasti: /services/data/v56.0/composite/tree/sObject
Pyyntöelin säilyttää tiedot seuraavassa muodossa:
'ennätykset' :[{'attributes' : {'type' : 'Object', 'referenceId' : 'reference1'},
kenttä:arvo,
...
...
},{
'attributes' : {'type' : 'Object', 'referenceId' : 'reference1'},
kenttä:arvo,
...
...
}]
}
Lisätään kaksi tietuetta Salesforce 'Case' -objektiin.
URI: /services/data/v56.0/composite/tree/Case/Pyyntöteksti:
{'ennätykset' :[{
'attributes' : {'type' : 'Case', 'referenceId' : 'reference1'},
'Priority':'Korkea',
'Status':'Uusi',
'Subject':'Mekaanisen roottorin suunnitteluongelma',
'Tyyppi': 'Sähköinen'
},{
'attributes' : {'type' : 'Case', 'referenceId' : 'reference2'},
'Priority':'Matala',
'Status':'Uusi',
'Aihe':'Generaattorin käynnistys sähkövian jälkeen' ,
'Tyyppi': 'Sähköinen'
}]
}
Salesforceen lisätään kaksi tietuetta tapausnumeroilla 00001038 ja 00001039.
PUT-menetelmä
Kuten aiemmin keskustelimme, PUT on http-menetelmä, jota käytetään tietueiden luomiseen/päivittämiseen. Tässä oppaassa käytämme tätä menetelmää uuden Salesforce-tietueen luomiseen mukautetun REST-sovellusliittymän avulla.
@httpPut : Tätä menetelmää kutsutaan, kun HTTP PUT lähetetään, mikä mahdollistaa Apex-menetelmän paljastamisen REST-resurssina. Sitten se luo uuden resurssin tai päivittää olemassa olevan resurssin.
Syntaksi: @httpPutEsimerkki:
Kirjoita 'RestApi_Put_Record.apxc' Apex-luokka, joka sisältää REST 'PUT'-metodin lisätäksesi tila-, prioriteetti- ja kuvauskentät Salesforcen Case-objektiin.
@RestResource(urlMapping='/v56.0/RestApi_Put_Record/')globaali luokka RestApi_Put_Record{
// REST - Put Method
@httpPut
globaali staattinen tapaus Put_Method(merkkijonon prioriteetti, merkkijonon tila, merkkijonon aihe){
Case case_obj= new Case(Priority=priority,Status = tila,Aihe=aihe);
// Lisää DML
lisää case_obj;
return case_obj;
}
}
URI ja tulos:
Siirry Workbenchiin ja siirry REST Exploreriin. Määritä seuraava URI ja suorita se:
/services/apexrest/v56.0/RestApi_Put_Record/Määritä tiedot pyyntötekstissä:
{'Priority':'Korkea',
'Tila':'Suljettu',
'Aihe':'Vihannesmyllyn opas tarvitaan'
}
Avaa tietue Salesforcessa (siirry Case-objektiin sovellusten käynnistysohjelmasta).
Johtopäätös
Nyt voit lisätä tietueet Salesforceen käyttämällä http PUT- ja POST-menetelmiä. Opimme lisäämään tietueita suoraan Workbenchiin ja käyttämään mukautettua REST-sovellusliittymää Apex-luokan kautta. Salesforce 'Case' -objektia käytetään tässä oppaassa esimerkkinä. Todellinen ero PUT:n ja POST:n välillä on, että POST:ia käytetään tietojen lisäämiseen, kun taas PUT:ta käytetään tietojen lisäämiseen/päivittämiseen. @httpPut-merkintää käytetään PUT-menetelmässä ja @httpPost-merkintää käytetään POST-menetelmässä.