Blog · 18 September 2023 · Steve Simpson · Integrasi

Apex Web Service: Blok Bangunan untuk Para Penyihir Web

Pendahuluan:

Dalam artikel ini, saya akan menyelami pembuatan layanan web Apex kustom di Salesforce. Layanan ini sangat penting ketika Anda membutuhkan proses eksternal untuk berinteraksi dengan Salesforce, entah untuk mengambil atau menulis data, dan REST API standar tidak mencukupi. Kita akan membahas lima contoh, dengan kerumitan yang meningkat secara bertahap, dari kueri standar hingga pembaruan.

Diagram: lima contoh layanan web Apex kustom yang dipanggil dari Postman: GET yang mengembalikan daftar rekaman, GET dengan objek respons, GET dengan parameter, POST, dan POST dengan error

Gambaran Umum Layanan Web Kustom

Kita akan menjelajahi lima contoh layanan web kustom:

GET Memakai Daftar SObject Standar: Mengambil data memakai daftar SObject standar.

Wrapper dengan Respons JSON: Menyempurnakan permintaan GET dengan membungkusnya dalam respons JSON.

Menambahkan Parameter: Menambahkan parameter ke permintaan GET untuk pengambilan data yang lebih spesifik.

Memakai POST untuk Insert: Menerapkan permintaan POST untuk menyisipkan data.

Mengembalikan Pesan Error: Menangani dan mengembalikan pesan error dengan tepat.

Menerapkan Layanan Web Kustom

Contoh 1: GET Memakai Daftar SObject Standar

Dalam contoh ini, kita mendefinisikan resource REST dengan URI kustom dan menentukan verb HTTP-nya (GET). Kelasnya harus dideklarasikan sebagai global, dan kita mengembalikan daftar akun standar memakai kueri sederhana.

Kode Apex: resource REST dengan metode GET yang mengkueri Akun dan mengembalikan daftarnya dengan serialisasi bawaan

Contoh 2: Wrapper dengan Respons JSON

Agar bisa mengendalikan data yang dikirim kembali ke klien, kita memakai objek respons. Alih-alih mengembalikan daftar SObject, kita mengembalikan daftar objek respons kustom, yang memberikan representasi ringan dari seorang pelanggan dengan hanya ID dan nama.

Kode Apex: metode GET yang membangun objek respons berisi daftar pelanggan

Contoh 3: Menambahkan Parameter

Parameter sangat penting ketika Anda membutuhkan data untuk pelanggan tertentu. Dengan membaca RestContext.params, Anda bisa mengambil ID pelanggan dan memakainya di klausa WHERE SOQL untuk menyaring data.

Kode Apex: metode GET yang membaca parameter customerid dari permintaan dan mengembalikan pelanggan itu dalam objek respons

Contoh 4: Memakai POST untuk Insert

Ketika Anda perlu menulis data, metode POST yang dipakai. Dalam contoh ini, kita membuat objek respons dan objek permintaan. Objek permintaan menerima pelanggan dengan sebuah nama, dan kita memakai serializer JSON untuk menserialisasi permintaan ke kelas tertentu. Setelah membuat dan menyisipkan akun baru, status sukses dikembalikan.

Kode Apex: metode POST yang mengurai body permintaan, menyisipkan Akun, dan mengembalikan status sukses atau error

Contoh 5: Mengembalikan Pesan Error

Contoh ini mirip dengan Contoh 4, tetapi menyertakan penanganan error. Jika terjadi exception, error-nya ditangkap, ditambahkan ke sebuah daftar, dan kode statusnya diatur ke 500 (atau angka apa pun yang Anda inginkan).

Kode Apex: metode POST dengan penanganan error, yang mengembalikan pesan error dan kode status HTTP 500

Kesimpulan

Melalui contoh-contoh ini, kita telah menunjukkan blok-blok bangunan dasar untuk membuat layanan web Apex kustom di Salesforce. Dimulai dari permintaan GET sederhana, kita meningkatkan kerumitannya secara bertahap, dengan menambahkan parameter, permintaan POST, dan penanganan error.

Nantikan Terus

Terima kasih sudah membaca, dan saya menantikan kesempatan berbagi lebih banyak petualangan penuh pengetahuan bersama Anda! Terus ikuti di www.SteveTechArc.com dan kanal YouTube @SteveTechArc (opens in a new tab). Berlangganan dan perdalam pemahaman Anda tentang Salesforce dan cara mengintegrasikannya dengan sistem lain.

Membantu mengubah dunia dengan berbagi informasi integrasi kepada sesama Arsitek dan mereka yang sedang menempuh Perjalanan Menjadi Arsitek!

Transkrip dibantu AI

STA 1.8