Metode POST
POST adalah metode http yang menambahkan satu/beberapa catatan sekaligus ke Salesforce. Kami dapat memasukkan catatan dengan URI melalui API REST Apex khusus atau langsung dari URI.
Sumber Daya Istirahat Khusus di Apex
Untuk menulis REST di Apex, kita harus menggunakan beberapa anotasi yang mengakses REST API di kelas Apex Anda.
Anotasi @HttpPost
Metode ini dipanggil ketika HTTP POST dikirim yang memungkinkan metode Apex diekspos sebagai sumber daya REST. Kemudian, itu menciptakan sumber daya baru.
Sintaks: @httpPost
Contoh:
Tulis kelas Apex “RestApi_Post_Record.apxc” yang melibatkan metode REST “POST” untuk memasukkan bidang status, prioritas, dan subjek ke dalam objek “Kasus” Salesforce.
- Buat Post_Method dengan tiga parameter: status, prioritas, dan subjek tipe string.
- Buat objek 'Kasus' dengan meneruskan parameter ini.
- Gunakan insert DML untuk memasukkan record ke dalam objek 'Case' Salesforce.
kelas global RestApi_Post_Record{
// REST - Metode Posting
@httpPost
Post_Metode Kasus global statis (Prioritas String, Status String, Subjek String){
Kasus case_obj= Kasus baru(Prioritas=prioritas, Status = status, Subjek=subjek);
// Masukkan DML
masukkan case_obj;
return case_obj;
}
}
URI dan Hasil:
Pergi ke Workbench dan arahkan ke REST Explorer. Tentukan URI berikut dan jalankan:
/services/apexrest/v56.0/RestApi_Post_Record/
Tentukan data di Badan Permintaan:
{'Prioritas':'Tinggi',
'Status':'Baru',
'Subjek':'Masalah seluler'
}
Buka catatan di Salesforce (navigasi ke objek 'Kasus' dari Peluncur Aplikasi).
Sisipkan Rekaman Tunggal Langsung dari URI
Arahkan ke REST Explorer di bawah tab 'Utilities' dan tentukan URI berikut dan tentukan catatan ini di bawah Badan Permintaan:
/services/data/v56.0/sobjects/Kasus/Badan Permintaan:
{'Prioritas':'Sedang',
'Status':'Baru',
'Subjek':'Tim Microsoft - Tidak Hadir'
}
Buka tab 'Kasus' Salesforce dan lihat catatannya.
Sisipkan Banyak Rekaman Langsung dari URI
Jika Anda ingin menyisipkan beberapa record sekaligus, kita perlu menentukan URI sebagai berikut: /services/data/v56.0/composite/tree/sObject
Badan Permintaan menyimpan catatan dalam format berikut:
'catatan' :[{'atribut' : {'type' : 'Objek', 'referenceId' : 'reference1'},
bidang:nilai,
...
...
},{
'atribut' : {'type' : 'Objek', 'referenceId' : 'reference1'},
bidang:nilai,
...
...
}]
}
Mari masukkan dua catatan ke dalam objek 'Kasus' Salesforce.
URI: /services/data/v56.0/composite/tree/Case/Badan Permintaan:
{'catatan' :[{
'attributes' : {'type' : 'Case', 'referenceId' : 'reference1'},
'Prioritas':'Tinggi',
'Status':'Baru',
'Subjek':'Masalah desain dengan rotor mekanis',
'Jenis':'Listrik'
},{
'attributes' : {'type' : 'Case', 'referenceId' : 'reference2'},
'Prioritas':'Rendah',
'Status':'Baru',
'Subjek':'Menyalakan generator setelah listrik padam',
'Jenis':'Listrik'
}]
}
Dua rekaman dimasukkan ke Salesforce dengan CaseNumber 00001038 dan 00001039.
Metode PUT
Seperti yang telah kita bahas sebelumnya, PUT adalah metode http yang digunakan untuk membuat/memperbarui record. Dalam panduan ini, kami menggunakan metode ini untuk membuat rekaman Salesforce baru menggunakan REST API khusus.
@httpPut : Metode ini dipanggil saat HTTP PUT dikirim yang memungkinkan metode Apex diekspos sebagai sumber daya REST. Kemudian, itu membuat sumber daya baru atau memperbarui sumber daya yang ada.
Sintaks: @httpPutContoh:
Tulis kelas Apex “RestApi_Put_Record.apxc” yang melibatkan metode REST “PUT” untuk menyisipkan bidang status, prioritas, dan deskripsi ke dalam objek “Kasus” Salesforce.
@RestResource(urlMapping='/v56.0/RestApi_Put_Record/')kelas global RestApi_Put_Record{
// REST - Letakkan Metode
@httpPut
MetodePut_Kasus statis global(Prioritas String, Status String, Subjek String){
Kasus case_obj= Kasus baru(Prioritas=prioritas, Status = status, Subjek=subjek);
// Masukkan DML
masukkan case_obj;
return case_obj;
}
}
URI dan Hasil:
Pergi ke Workbench dan arahkan ke REST Explorer. Tentukan URI berikut dan jalankan:
/services/apexrest/v56.0/RestApi_Put_Record/Tentukan data di Badan Permintaan:
{'Prioritas':'Tinggi',
'Status':'Tutup',
'Subjek':'Panduan Penggiling Sayuran diperlukan'
}
Buka catatan di Salesforce (navigasi ke objek 'Kasus' dari Peluncur Aplikasi).
Kesimpulan
Sekarang, Anda dapat memasukkan catatan ke dalam Salesforce menggunakan metode http PUT dan POST. Kami mempelajari cara menyisipkan record secara langsung di Workbench dan menggunakan REST API kustom melalui kelas Apex. Objek 'Kasus' Salesforce digunakan dalam panduan ini sebagai contoh. Perbedaan sebenarnya antara PUT dan POST adalah POST digunakan untuk memasukkan data sedangkan PUT digunakan untuk memasukkan/memperbarui data. Anotasi @httpPut digunakan untuk metode PUT dan anotasi @httpPost digunakan untuk metode POST.