Salesforce İçin Adobe Sign: Process Builder ile Otomatik Akışlar

Genel bakış

Salesforce'taki Process Builder , Salesforce ortamınızdaki tetikleyici etkinliklere dayanan eylemleri otomatikleştirmenize olanak sağlayan bir grafik işaretleme ve tıklatma aracıdır.

İşlemler, if/then türünde bir mantık akışı türüne dayanır ve bir tetikleyici olay, en az bir koşul ve gerçek zamanlı ve/veya zamanlanmış bir olay olarak gerçekleşebilecek en az bir eylem içerir.

Adobe Sign iki eylem türünü destekler: Kayıtları ve Apex'i Güncelleme

Her eylem türünün birden fazla çağrılabilir  eylemi vardır:

• Gönder
• İptal
• Sil
• Hatırlat
• Güncelle
• Yükle (şablon) seçeneği yalnızca Apex eylem türü ile kullanılabilir

Process Builder son derece güçlü bir araçtır ve çalışma şeklinin tam açıklaması bu belgenin kapsamı dışındadır.

Bu belgede, Salesforce İçin Adobe Sign paketinde v20 sürümüyle kullanılabilen eylemler vurgulanmaktadır.

Genel olarak Process Builder hakkında daha fazla bilgi edinmek istiyorsanız bu belgelere ve Salesforce'da bulunan etkileşimli Trailhead sayfasına bakabilirsiniz.

"Kayıtları Güncelle"yi eylem türü olarak kullanan süreçler

Bu yaklaşımda, Salesforce Process Builder'daki Kayıtları Güncelle eylem türü, bir eylemi çağırmak için anlaşma kaydındaki Arka Plan Eylemi seçim listesi alanı ayarlanarak kullanılır.

İlgili Adobe Sign sözleşmesinde eylem başlatabilen yeni bir süreç oluşturulabilir (Süreç, kayıt değişikliği etkinliklerine göre tetiklenir). Kullanıcılar eylemin ne zaman gerçekleşeceğini kontrol edebilir (yani ana kayıtta hangi alan güncellemesinden sonra) ve eylem için hangi ilgili sözleşme(ler)in seçileceğini.

Şu an aşağıdaki eylemler desteklenmektedir:

• Gönder
• İptal
• Sil
• Hatırlat
• Güncelle

Şunlara dikkat edin:

• İşlem sırasında tespit edilen tüm hatalar Hata Mesajı alanına kaydedilir ve ilgili Sözleşme sayfasında görüntülenebilir
• Planlanmış işlemler desteklenir
• Adobe Sign kitaplık belgeleri desteklenmektedir
• Bir veya daha fazla üst ve alt sözleşme seçilebilir
• Bir sözleşme kaydını güncellerken, ilgili kayıt echosign_dev1 nesnesidir
  • echosign_dev1 nesnesi, ortak Salesforce nesneleriyle (Hesap, Fırsat, İletişim Yetkilisi vb.) ilişkilidir. Sözleşmeler özel bir nesneyle ilgiliyse bu ad, organizasyona özel olur.

• Eylemler, sözleşme kaydındaki Arka Plan Eylemi seçim listesi alanının ilgili eylem değeriyle güncellenmesiyle tetiklenir

• Sözleşme kaydının halihazırda mevcut olması gerekir. "Kayıtları Güncelle" eylem türü kullanılarak bir sözleşme şablonundan oluşturulamaz veya yüklenemez

Apex'i eylem türü olarak kullanan süreçler

Bu yaklaşımda, Salesforce Process Builder'daki Apex eylem türü kullanılarak ilgili eylemi gerçekleştirmek için yönetilen pakete dahil olan İptal Yöntemi çağrılır. 

İlgili Adobe Sign sözleşmesinde eylem başlatabilen yeni bir süreç oluşturulabilir (Süreç, kayıt değişikliği etkinliklerine göre tetiklenir).

Aşağıda çağrılabilir eylemler tanımlanmıştır:

• Sözleşme Şablonu Yükleme Çağrılabilir Eylemi
  • AgreementTemplateLoadInvocableAction.load
    • Ana kimlikleri ve çalışma zamanı değişkenlerini şablona aktarın.
    • Şablon oluşturma işleminin senkronize olmayan modda çalışıp çalışmadığını kontrol etmek için isteğe bağlı bir parametreyi aktarın
      • Şablon, Adobe Sign kitaplığından bir belge içeriyorsa bu işlem gereklidir
    • Oluşturulan sözleşme kayıt kimliğini veya herhangi bir hata mesajını getirir
      • Hata, tetikleme eylemini gerçekleştiren kullanıcılara görünmez

Sözleşme Türünü Yükle Sınıfı çağrıldığında yapılandırabileceğiniz dört alan seçeneği vardır:

• Ana Kayıt Kimliği: Sözleşmenin ilişkilendirilmesi gereken nesnenin Salesforce kayıt kimliği. 
  • Genellikle Alan Referansı ve nesne Fırsat, Hesap vb. olduğunda değer olarak "[Object].Id" yazılacak şekilde ayarlanır.
• Sözleşme Şablonu Kimliği: Yüklenecek sözleşme şablonunun Salesforce kayıt kimliği. Türü "Kimlik" ve değeri kayıt kimliği olarak ayarlayın
• Sözleşme Şablonu Çalışma Zamanı Değişkenleri - Bir değişkendeki alıcılar ve/veya belgeler. 
  • Bir değişken: myRecipient=auserguy@adobe.com 
  • İki değişken: myRecipient=auserguy@adobe.com,myAttachment=00Pf4000002df0q
• Senkronize olmayan işlem: İsteğe bağlıdır, gerekmedikçe belirtmeyin. Varsayılan olarak bu yanlış olacaktır, böylece şablon çağrısı eşzamanlı modda çalışacaktır (yani aynı işlem/iş parçacığında)
  • Sözleşme şablonunuz bir Adobe Sign kitaplık belgesi yüklerse Doğru olarak ayarlayın
  • Otomatik Gönder, şablon için doğruysa değerin Yanlış olması gerekir
  • Adobe Sign kitaplık belgelerini bir arada otomatik olarak gönderemezsiniz
  • İşlem, toplu veya diğer senkronize olmayan bir işlemden başlatıldıysa yerleşik Salesforce sınırlamaları dikkate alınmalıdır

• Sözleşme İptali Çağrılabilir Eylem
  • AgreementCancelInvocableAction.cancelAgreement
    • Sözleşme kimliğini aktarın
    • Hata mesajlarını geri döndürün

• Anlaşma Silme Çağrılabilir Eylemi
  
  • AgreementDeleteInvocableAction.deleteAgreement
    • Sözleşme kimliğini aktarın
    • Hata mesajlarını geri döndürün

• Sözleşme Hatırlatma Çağrılabilir Eylem
  • AgreementRemindInvocableAction.sendReminder
    • Sözleşme kimliğini aktarın
    • Hata mesajlarını geri döndürün

• Agreement Send Invocable Action
  
  • AgreementSendInvocableAction.sendAgreement
    • Sözleşme kimliğini aktarın
    • Hata mesajlarını geri döndürün

• Agreement Agreement Update Invocable Action
  
  • AgreementUpdateInvocableAction.updateAgreement
    • Sözleşme kimliğini aktarın
    • Hata mesajlarını geri döndürün

İptal, Sil, Hatırlat, Gönder ve Güncelle eylemleri, yalnızca üzerinde işlem yapılacak sözleşmenin Sözleşme Kimliğini gerektirir:

Şunlara dikkat edin:

• Planlanmış işlemler desteklenir
• Otomatik gönderimli sözleşme şablonları desteklenir (yani oluşturmak ve göndermek)
• Tüm eylemler, tek seferde birden fazla isteği kabul edebilir
• Tüm istisnalar tespit edilerek sonuç kaydında saklanır ve işlemin yürütülmesini aksatmaması için Apex hata ayıklama günlüğüne bir hata olarak kaydedilir.
• Şablon Yükleme fonksiyonu parametresi (Senkronize Olmayan İşleme), şablon işlemenin senkronize modda olup olmadığını kontrol eder. Arayan kişi, şablon yüklemenin senkronizasyon modda çalışması gerekip gerekmediğini belirtmelidir 
  • Varsayılan işlem senkronize modda çalışır. İşlemler toplu olarak senkronize çalışmalıdır
  • Otomatik gönder özelliği etkinse işlem senkronize modda olmalıdır
  • Adobe Sign kitaplık belgesi yüklemeniz gerekirse senkronize olmayan özel işlem gerçekleşir

Sınırlamalar:

• Otomatik gönder şablonlarının ve Adobe Sign kitaplık belgelerinin bir arada kullanılması, Salesforce'da bir akışın başka bir akışı çalıştırmadığı bir sınırlama nedeniyle desteklenmemektedir
  
• Çağrılabilir eyleme aktarılan her parametre için yalnızca üst alanlar (alt alanlar değil) referans alınabilir. Ana kayıt altındaki alt sözleşmelerde işlem yapamazsınız
• Bir Apex kullanımından dönen değerler işlem oluşturucuda kullanılamaz. Değer döndüren hiçbir eylem desteklenmez (yani belge bilgisi alma veya imzalama URL'si alma).

Queueable Service

Sözleşme işlemlerini Salesforce kuyruğa alınabilir arabirimiyle gerçekleştirmek için yeni bir hizmet katmanı uygulanmıştır. Kuyruğa Alınabilir terimi hakkında daha fazla bilgi için buraya tıklayın. Eylemler, temel hizmet API'lerini çağırır ve ardından Adobe Sign API'sini belirtir. 

Aşağıdaki eylemler desteklenir:

• Gönder
• İptal
• Sil
• Hatırlat
• Güncelle

Genel echosign_dev1.AdobeSignApiQueueableService , echosign_dev1.QueueableServiceParameter türünde bir parametre alan ve çağrılacak eylem ile sözleşme kayıt kimliğini içeren hizmet Apex sınıfıdır: