POST Yöntemi
POST, Salesforce'a aynı anda tek/birden çok kayıt ekleyen bir http yöntemidir. Kayıtları URI ile özel Apex REST API aracılığıyla veya doğrudan URI'den ekleyebiliriz.
Apex'te Özel Dinlenme Kaynağı
Apex'te REST yazmak için, Apex sınıfınızdaki REST API'sine erişen bazı ek açıklamaları kullanmalıyız.
@HttpPost Açıklama
Bu yöntem, Apex yönteminin bir REST kaynağı olarak gösterilmesini sağlayan HTTP POST gönderildiğinde çağrılır. Ardından, yeni bir kaynak oluşturur.
Sözdizimi: @httpPost
Örnek:
Durum, öncelik ve konu alanlarını Salesforce 'Case' nesnesine eklemek için REST 'POST' yöntemini içeren 'RestApi_Post_Record.apxc' Apex sınıfını yazın.
- Post_Method'u üç parametreyle oluşturun: durum, öncelik ve dize türünün konusu.
- Bu parametreleri geçirerek bir “Case” nesnesi oluşturun.
- Kaydı Salesforce 'Vaka' nesnesine eklemek için DML ekle'yi kullanın.
küresel sınıf RestApi_Post_Record{
// REST - Gönderi Yöntemi
@httpPost
global static Case Post_Method(Dize Önceliği, Dize Durumu, Dize Konusu){
Case case_obj= new Case(Priority=priority,Status = status,Subject=subject);
// DML'yi ekle
case_obj'u ekle;
case_obj'u döndür;
}
}
URI ve Sonuç:
Workbench'e gidin ve REST Explorer'a gidin. Aşağıdaki URI'yi belirtin ve çalıştırın:
/hizmetler/apexrest/v56.0/RestApi_Post_Record/
İstek Gövdesindeki verileri belirtin:
{'Öncelik':'Yüksek',
'Durum':'Yeni',
'Konu':'Mobil sorunu'
}
Salesforce'ta kaydı açın (Uygulama Başlatıcı'dan 'Vaka' nesnesine gidin).
Doğrudan URI'den Tek Bir Kayıt Ekleyin
'Yardımcı Programlar' sekmesi altındaki REST Explorer'a gidin ve aşağıdaki URI'yi belirtin ve bu kaydı İstek Gövdesi altında belirtin:
/services/data/v56.0/sobjects/Case/İstek Gövdesi:
{'Öncelik':'Orta',
'Durum':'Yeni',
'Subject':'Microsoft ekipleri - Gelmiyor'
}
Salesforce 'Vakalar' sekmesine gidin ve kaydı görüntüleyin.
Doğrudan URI'den Birden Fazla Kayıt Ekleyin
Aynı anda birden fazla kayıt eklemek istiyorsanız, URI'yi aşağıdaki gibi belirtmemiz gerekir: /services/data/v56.0/composite/tree/sObject
Talep Kuruluşu, kayıtları aşağıdaki formatta tutar:
'kayıtlar':[{'attributes' : {'type' : 'Object', 'referenceId' : 'reference1'},
alan değeri,
...
...
},{
'attributes' : {'type' : 'Object', 'referenceId' : 'reference1'},
alan değeri,
...
...
}]
}
Salesforce 'Case' nesnesine iki kayıt ekleyelim.
URI: /services/data/v56.0/composite/tree/Case/İstek Gövdesi:
{'kayıtlar':[{
'attributes' : {'type' : 'Case', 'referenceId' : 'reference1'},
'Öncelik':'Yüksek',
'Durum':'Yeni',
'Konu':'Mekanik rotorda tasarım sorunu',
'Tip':'Elektrikli'
},{
'attributes' : {'type' : 'Case', 'referenceId' : 'reference2'},
'Öncelik':'Düşük',
'Durum':'Yeni',
'Subject':'Elektrik arızası sonrası jeneratörün çalıştırılması' ,
'Tip':'Elektrikli'
}]
}
Salesforce'a CaseNumber 00001038 ve 00001039 ile iki kayıt eklenir.
PUT Yöntemi
Daha önce tartıştığımız gibi PUT, kayıtları oluşturmak/güncellemek için kullanılan bir http yöntemidir. Bu kılavuzda, özel REST API'sini kullanarak yeni bir Salesforce kaydı oluşturmak için bu yöntemi kullanıyoruz.
@httpPut : Bu yöntem, Apex yönteminin bir REST kaynağı olarak gösterilmesini sağlayan HTTP PUT gönderildiğinde çağrılır. Ardından yeni bir kaynak oluşturur veya mevcut kaynağı günceller.
Sözdizimi: @httpPutÖrnek:
Durum, öncelik ve açıklama alanlarını Salesforce 'Case' nesnesine eklemek için REST 'PUT' yöntemini içeren 'RestApi_Put_Record.apxc' Apex sınıfını yazın.
@RestResource(urlMapping='/v56.0/RestApi_Put_Record/')küresel sınıf RestApi_Put_Record{
// REST - Koyma Yöntemi
@httpPut
global statik Case Put_Method(Dize Önceliği, Dize Durumu, Dize Konusu){
Case case_obj= new Case(Priority=priority,Status = status,Subject=subject);
// DML'yi ekle
case_obj'u ekle;
case_obj'u döndür;
}
}
URI ve Sonuç:
Workbench'e gidin ve REST Explorer'a gidin. Aşağıdaki URI'yi belirtin ve çalıştırın:
/hizmetler/apexrest/v56.0/RestApi_Put_Record/İstek Gövdesindeki verileri belirtin:
{'Öncelik':'Yüksek',
'Durum':'Kapalı',
'Subject':'Sebze Öğütücü kılavuzu gerekli'
}
Salesforce'ta kaydı açın (Uygulama Başlatıcı'dan 'Vaka' nesnesine gidin).
Çözüm
Artık, http PUT ve POST yöntemlerini kullanarak kayıtları Salesforce'a ekleyebilirsiniz. Kayıtları doğrudan Workbench'e nasıl ekleyeceğimizi ve Apex sınıfı aracılığıyla özel REST API'sini nasıl kullanacağımızı öğrendik. Salesforce 'Vaka' nesnesi bu kılavuzda örnek olarak kullanılmıştır. PUT ve POST arasındaki asıl fark, POST'un verileri eklemek için, PUT'un ise verileri eklemek/güncellemek için kullanılmasıdır. PUT yöntemi için @httpPut ek açıklaması ve POST yöntemi için @httpPost ek açıklaması kullanılır.