Salesforce

Parny | Salesforce Entegrasyon Rehberi

Parny, Salesforce alarmlarıyla doğrudan entegrasyonu destekler. Salesforce, potansiyel sorunları tespit etmek ve önlemek için alarm oluşturabilen bir ağ ve sistem izleme aracıdır. Bu belgede, Salesforce'da oluşturulan alarmları Parny kullanarak bir webhook'a yönlendirmeyi açıklıyoruz.


Parny Ayarları


  1. Parny arayüzüne gidin.

  2. Kuruluşunuzun "Hizmetler" bölümüne gidin.

  3. Sağ üst köşedeki "Yeni Hizmetler" seçeneğine tıklayın.

  4. İlgili hizmet adını girin.

Hizmet Adı Kullanımı: Buradaki hizmet adı yapıdan bağımsızdır ve kuruluşun tercihine göre seçilebilir.


  1. Entegrasyonlar listesinden Salesforce'u seçin.

  2. "Ekle"'ye tıklayın.

  3. Hizmet oluşturulduktan sonra, aşağıdaki ekran görünecektir.


drawing


  • Artık hizmetinizin token bölümüne tıklayarak Salesforce Webhook URL’nizi kopyalayabilirsiniz.


Salesforce Yapılandırması

Bu bölümde, "Webhook Ekleme" sürecinde size rehberlik edeceğiz.


Webhook Ekleme


Not: Eğer Salesforce "Profesyonel Sürüm" kullanıyorsanız, aşağıdaki işlemleri gerçekleştiremeyeceksiniz. "Geliştirici sürümü" bu işlemler için uygundur.


Apex Sınıfı Oluşturma


  1. Salesforce'ta bir Webhook eklemek için bir "apex sınıfı" ve "apex tetikleyici" oluşturmak gerekir.


  2. Sağ üst köşedeki "Ayarlar" butonuna tıkladıktan sonra, "Kurulum" butonuna tıklamalısınız.


drawing


  1. "Kurulum" butonuna tıkladıktan sonra, arama çubuğuna "apex sınıfı" yazarak "apex sınıfı" butonuna tıklayın. Ardından, yeni bir apex sınıfı oluşturmak için "yeni" butonuna tıklayın.



drawing


  1. Bir apex sınıfı tanımlamak için, Salesforce'tan webhook uyarılarını almak için bazı kodlar yazmak gerekecektir.


  1. Aşağıdaki kodu kopyalayarak kaydederseniz, "apex sınıfı" kolayca oluşturulabilir.


	@RestResource(urlMapping='/Webhook/*')
	global class WebhookCustom {
	public static String jsonContent(List<Object> triggerNew, List<Object> triggerOld) {
	String newObjects = '[]';
	if (triggerNew != null) {
	newObjects = JSON.serialize(triggerNew);
	}
	String oldObjects = '[]';
	if (triggerOld != null) {
	oldObjects = JSON.serialize(triggerOld);
	}
	String userId = JSON.serialize(UserInfo.getUserId());
	String content = '{"new": ' + newObjects + ', "old": ' + oldObjects + ', "userId": ' + userId + '}';
	return content;
	}
	@future(callout=true) public static void callout(String url, String content) {
	Http 


Apex Tetikleyici Oluşturma


  1. "apex sınıfı" oluşturduktan sonra, alarm durumunu tetikleyecek koşulları belirlememiz gerekiyor.


  2. Bir "apex tetikleyici" oluşturmak için, "nesne yöneticisi" butonuna tıklamalı ve ardından arama çubuğuna "varlık ilişkisi" yazmalısınız.


drawing


  1. "varlık ilişkisi"ne tıkladıktan sonra, sol çubukta açılan tetikleyici butonuna tıklayın. Ardından "yeni" butonuna tıklayın. Tıkladıktan sonra, alan bazı kodlarla doldurulmalıdır. Örneğin, yeni bir "etkinlik" oluşturulursa sistemimizi tetiklemek istiyorsanız, aşağıdaki kod örnek olarak kullanılabilir;


	trigger webhookTrigger on Event (before insert,before delete) {

	string url = 'your webhook url';
	string content = Webhook.jsonContent(Trigger.new, Trigger.old);

	<Name of your apex class>


  1. Bu durumda, sistemimiz yeni etkinlik oluşturulduğunda ve silindiğinde tetiklenecektir. Farklı tetikleyici türleri için Salesforce’un geliştirici kılavuzuna bakılabilir.


"apex" için geliştirici kılavuzu: https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_dev_guide.htm


Uzak site tanımlama


  1. Normalde, uzak site gerekli değildir. Ancak bazı web siteleri uyarı webhook'larını göndermede engellenebilir. "uzak site" oluşturarak, güvenilir "alan adlarımız" engellenmeden korunabilir.


  2. "Kurulum Ekranı"'nda, arama çubuğuna "uzak site" yazdıktan sonra, güvenlik sekmesi altında "Uzak Site Ayarları" butonuna tıklanmalıdır. Ardından, "yeni uzak site" butonuna tıklayarak yeni bir uzak site ekleyebilirsiniz. Güvenilir "alan" URL'nizi ve site adınızı girin ve kaydedin.


Bu ayarlarla, Salesforce alarmlarınız Parny'e yönlendirilecek ve kuruluşunuzun Parny arayüzündeki diğer uyarılarla birlikte yönetilebilecektir.