Apex-verkkopalvelut: rakennuspalikat verkkovelhoille
Johdanto:
Tässä blogikirjoituksessa perehdyn mukautettujen Apex-verkkopalvelujen rakentamiseen Salesforcessa. Niitä tarvitaan, kun ulkoisen prosessin pitää lukea tai kirjoittaa tietoja Salesforceen eikä vakio-REST API riitä. Käymme läpi viisi esimerkkiä, jotka monimutkaistuvat vähitellen vakiokyselyistä päivityksiin.
Mukautettujen verkkopalvelujen yleiskatsaus
Tutustumme viiteen esimerkkiin mukautetuista verkkopalveluista:
GET tavallisella SObject-luettelolla: Hae tietoja tavallisella SObject-luettelolla.
Kääre ja JSON-vastaus: Paranna GET-pyyntöä käärimällä se JSON-vastaukseen.
Parametrien lisääminen: Lisää GET-pyyntöön parametreja tarkempien tietojen hakemiseksi.
POST lisäämiseen: Toteuta POST-pyyntö tietojen lisäämiseksi.
Virheilmoitusten palauttaminen: Käsittele ja palauta virheilmoitukset asianmukaisesti.
Mukautettujen verkkopalvelujen toteutus
Esimerkki 1: GET tavallisella SObject-luettelolla
Tässä esimerkissä määritämme REST-resurssin mukautetulla URI:lla ja määritämme HTTP-verbin (GET). Luokka on määriteltävä globaaliksi, ja palautamme luettelon tavallisista tileistä yksinkertaisella kyselyllä.
Esimerkki 2: kääre ja JSON-vastaus
Jotta voimme hallita asiakkaalle palautettavia tietoja, käytämme vastausobjektia. SObject-luettelon sijaan palautamme luettelon mukautetuista vastausobjekteista, kevyen esityksen asiakkaasta, jossa on vain ID ja nimi.
Esimerkki 3: parametrien lisääminen
Parametrit ovat tärkeitä, kun tarvitset tietyn asiakkaan tiedot. Lukemalla RestContext.params-arvon voit hakea asiakkaan ID:n ja käyttää sitä SOQL-kyselyn WHERE-ehdossa tietojen suodattamiseen.
Esimerkki 4: POST lisäämiseen
Kun tietoja pitää kirjoittaa, käytetään POST-metodia. Tässä esimerkissä luomme vastausobjektin ja pyyntöobjektin. Pyyntöobjekti vastaanottaa asiakkaan, jolla on nimi, ja käytämme JSON-sarjallistajaa pyynnön purkamiseen tiettyyn luokkaan. Kun uusi tili on luotu ja lisätty, palautetaan onnistumisen tila.
Esimerkki 5: virheilmoitusten palauttaminen
Tämä esimerkki on samanlainen kuin esimerkki 4, mutta siinä on virheenkäsittely. Jos tapahtuu poikkeus, virhe otetaan kiinni, lisätään luetteloon ja tilakoodiksi asetetaan 500 (tai mikä tahansa haluamasi numero).
Lopuksi
Näillä esimerkeillä olemme näyttäneet mukautettujen Apex-verkkopalvelujen perusrakennuspalikat Salesforcessa. Aloitimme yksinkertaisesta GET-pyynnöstä ja lisäsimme monimutkaisuutta vähitellen: parametreja, POST-pyyntöjä ja virheenkäsittelyä.
Pysy kuulolla
Kiitos lukemisesta, odotan innolla, että pääsen pian jakamaan kanssasi lisää tietoa täynnä olevia seikkailuja! Pysy kuulolla täällä www.SteveTechArc.com-sivustolla ja YouTube-kanavalla @SteveTechArc (opens in a new tab). Tilaa kanava ja syvennä ymmärrystäsi Salesforcesta ja siitä, miten voit integroida sen muihin järjestelmiin.
Autamme muuttamaan maailmaa jakamalla integraatio-osaamista muille arkkitehdeille ja kaikille, jotka ovat matkalla arkkitehdiksi!
STA 1.8