ServiceNow için Adobe Acrobat Sign: Yükleme ve Yapılandırma Kılavuzu (V 2.2)

Genel Bakış

ServiceNow için Adobe Acrobat Sign uygulaması, ServiceNow platformunun yerel işlevlerini kullanarak belgeleri imza için göndermenizi sağlar. Acrobat Sign'ın ServiceNow ile entegrasyonu aşağıdaki özelliklere ve işlevlere erişmenizi sağlar:

  • Belgeleri imza için birden çok alıcıya gönderme. 
  • İmzalama sürecini yaşam döngüsü boyunca izleme ve her aşamada beklenen imzalayanları belirleme.
  • İmzalanan belgeyi gömülü veya ayrı bir denetim kaydı belgesiyle alma.
  • İmzalama işlemi sırasında veya öncesinde belgeye girilen tüm form verilerini alma.
  • İlk inceleme ve sonraki gönderim için imzalama işlemi taslakları oluşturma. İmzalayanlara gönderilmeden önce yapılan tüm değişiklikler ServiceNow ile senkronize edilir.
  • İmzalama işlemi sırasında e-posta bildirimleri oluşturma ve kişilere gönderme.
  • ServiceNow'daki yerel dosyalardan veya harici bir kaynaktan imza için belgeleri alma.
  • Göndermeden önce ServiceNow kayıtlarındaki veriler kullanılarak doldurulabilecek alanlar içeren belge şablonları kullanma. Bu, bir Olay veya Hizmet Talebi gibi seçilen bir konu kaydına dayalı olarak kullanıcıya özel belgeler oluşturmak için tek bir şablon kullanmanıza olanak tanır.
  • Acrobat Sign hesabınızın, ServiceNow ile senkronize edilen ve gönderim işlemi sırasında seçilebilen kitaplık şablonlarını kullanma.

ServiceNow için Adobe Acrobat Sign: Yükleme ve Özelleştirme Kılavuzu, aşağıdakilere ilişkin talimatlar sağlar:

ServiceNow uygulaması için Acrobat Sign'ı yükleyip yapılandırdıktan sonra sözleşmeleri göndermek, imzalamak, izlemek ve yönetmek için kullanabilirsiniz. ServiceNow için Adobe Acrobat Sign: Kullanıcı Kılavuzu'nu inceleyin.

ServiceNow uygulaması için Acrobat Sign'ı yükleme

Uygulamayı ServiceNow'a yükleyebilmek için Adobe Acrobat Sign yöneticisi ve ServiceNow Sistem Yöneticisi (yönetici) olmanız gerekir.  

  1. ServiceNow Mağazası sayfasına gidin ve Adobe Acrobat Sign'ı arayın.

    servicenow-store-search

  2. Arama sonuçlarından Adobe Acrobat Sign'ı ve ardından Edin'i seçin.

    Not:

    Uygulamanın yüklenmesi sırasında açılır pencere engelleyicilerini devre dışı bırakın.

    get-sign-app

  3. İstenirse ServiceNow yönetici kimlik bilgilerinizi kullanarak oturum açın ve yükleme adımlarını izleyin.

  4. Kurulumu doğrulamak için ServiceNow örneğinin üst menüsünden Tümü > Sistem Uygulamaları > Şirket Uygulamalarım'ını belirleyin ve ardından Yüklü sekmesini seçin. Adobe Acrobat Sign'ın en son sürümüne ait liste görüntülenir.

    installed-apps

    Not:

    ServiceNow için Adobe Acrobat Sign eklentisi aşağıdaki etki alanlarıyla çalışacak şekilde yapılandırılmıştır:

    • service-now.com
    • servicenowservices.com

    servicenowservices.com, Government Cloud müşterilerine yöneliktir ve bunun için ek bir sistem özelliği ayarı gerekir. Etki alanınız servicenowservices.com etki alanındaysa x_adosy_as.oauth_redirect_host sistem özelliğini örneğinizin tam alt etki alanıyla oluşturmanız/ayarlamanız gerekir (mydomain.servicenowservices.com gibi).

    "Self Servis" menüsünde yeni Adobe Acrobat Sign seçeneği aşağıdaki iki modülle birlikte görüntülenir:

    • İmzalı Belgelerim: Oturum açmış kullanıcının istekte bulunan veya imzalayan olduğu eksiksiz durumdaki sözleşmelerin listesini içerir.
    • İmza İçin: Oturum açmış kullanıcının imzasını bekleyen sözleşmelerin listesini içerir. Sözleşmeler "İmza için Gönderildi" veya "Onay için Gönderildi" durumundadır.

    Not: "Self Servis" menüleri yalnızca İmzalayan (x_adosy_as.adobe_sign_signer) rolüne sahip kullanıcılar tarafından görüntülenebilir.

    menu-acrobat-sign

    "Tüm uygulamalar" menüsünde aşağıdaki modülleri içeren bir Adobe Acrobat Sign seçeneği bulunur:

    • İmza için Gönder: Sözleşme oluşturmak ve göndermek için bir kayıt üreticisi açar.
    • Sözleşmelerim - Oturum açan kullanıcının istekte bulunan veya imzalayan olduğu tüm sözleşmelerin listesi.
    • İmzalarım: Oturum açan kullanıcının bir sözleşmenin Katılımcısı (imzalayan) olduğu kayıtların ayrıntıları.

    Operasyonel

    • Sözleşmeler: İmza sürecinin arka uç ayrıntıları.  JSON ile alınan ve üzerinde işlem yapılan tüm Adobe Acrobat Sign etkinliklerini içerir.
    • Kaynak Belgeler: Sözleşmeye eklenebilecek belgeleri temsil eder. Yerel veya Kitaplık olabilir
    • Katılımcılar: İmzalayanlar ve imza süreçlerinin ayrıntıları.
    • Etkinlikler: Her bir Adobe Acrobat Sign etkinliği için gönderilen ve alınan bilgilerin arka uç ayrıntıları.
    • Form verileri: Bir sözleşme imzalandıktan sonra geri gönderilen form verilerini içeren tablo. Bu, belgeler ve bunların alan verileri hakkında raporlama yapmak için kullanılabilir.

    Yönetim

    • Acrobat Sign ile bağlantı kur: Geçerli bir Adobe Acrobat Sign hesabını ServiceNow ile ilişkilendirebileceğiniz bağlantı ekranı.
    • Acrobat Sign grupları: Acrobat Sign gruplarının ad ve kimliklerinin listesini içerir.
    • Acrobat Sign kullanıcıları: Acrobat Sign kullanıcılarının ayrıntılarını içerir.
    • Elektronik Mühürler:
    • Belge şablonları: Bir sözleşmeye eklenebilecek belge şablonları. Yerel veya Kitaplık olabilir.
    • Belge alanları: Şablonun belgesine gömülü form alanlarının ayrıntıları.
    • Birleştirme kuralları: Bir Belge şablonunu ServiceNow içindeki belirli bir konu kaydıyla ilişkilendirir.
    • Alanları birleştirme: Konu kaydını oluşturan bir alanı, ilgili Belge şablonunda bulunan bir alana bağlayan kayıtlardır.
    • Özellikler: İmza sonrası URI yönlendirmesi, bildirimler ve denetim kaydı için varsayılan Adobe Acrobat Sign ayarlarıdır.

    Yardım ve Destek: Adobe Acrobat Sign yardım bağlantıları.

    Not:
    • "İmza için Gönder", "Sözleşmelerim" ve "İmzalarım" modülleri Gönderen (x_adosy_as.adobe_sign_sender) rolüne sahip kullanıcılar tarafından görülebilir. 
    • "Operasyonel" ve "Yönetim" menüleri yalnızca Admin (x_adosy_as.adobe_sign_admin) veya Yönetici (x_adosy_as.adobe_sign_manager) rolüne sahip kullanıcılar tarafından görülebilir.

    Hizmet Portalı Widget'ları

    Adobe Acrobat Sign'ı Hizmet Portalınıza eklemek istiyorsanız /adobe_sign URL'si üzerinden bir demo görebilirsiniz.

    Bu portal "x_adosy_as.adobe_sign_sender" ve "x_adosy_as.adobe_sign_signer" rolleriyle sınırlıdır.

    Bu işlevi kendi portalınıza eklemek için widget'ları çoğaltın ve rolleri uygun şekilde değiştirin.

    • Adobe Acrobat Kontrol Paneli Öğe Listesi: Sözleşme Listesi üst bilgi widget'ı tarafından kullanılan öğe listesi.
    • Adobe Acrobat Sign İmza için Gönder: Şablon veya dosyadan yeni bir sözleşme oluşturmak için kullanılan widget.
    • Adobe Acrobat Sign Sözleşme Listesi: Sözleşme listesini görüntülemek için kullanılan bir widget.

    Hizmet Portalı Sayfaları

    • Adobe Acrobat Sign: Bu sayfa, Adobe Acrobat Sign Açılır Pencere widget'ını içerir ve ServiceNow'daki kayıtlardan anında yeni sözleşmeler oluşturmak için kullanılabilir.
    • Adobe Acrobat Sign Ana Sayfası: Bu sayfa, uygulama ile birlikte sunulan demo Hizmet Portalı'nın ana sayfasıdır.

    Uygulamaya dahil olan dört rol vardır:

    • İmzalayan (x_adosy_as.adobe_sign_signer)
      • x_adosy_as.adobe_sign_signer rolüne sahip ServiceNow kullanıcılarına Adobe Acrobat Sign Self Servis modüllerine erişim izni verilir
      • Ayrıca, kullanıcı Hizmet Portalı widget'ına erişim de sağlanır
      • Bu rolün, Belgeleri/Sözleşmeleri imzalaması gereken tüm kullanıcılara/gruplara eklenmesi gerekir
    • Gönderen (x_adosy_as.adobe_sign_sender)
      • x_adosy_as.adobe_sign_sender rolüne sahip ServiceNow kullanıcılarına uygulamaya erişim izni verilir
      • Bu rol, talep ettikleri veya imzalamaları gereken Belgeleri/Sözleşmeleri izleyebilmek için gereken tüm kullanıcılara/gruplara eklenmelidir
    • Yönetici (x_adosy_as.adobe_sign_manager)
      • "x_adosy_as.adobe_sign_manager" rolüne sahip ServiceNow kullanıcılarının Acrobat Sign özelliklerine yönetici düzeyinde erişimi vardır
      • Yönetici, tüm gönderenler tarafından oluşturulan sözleşmeleri yönetebilir
      • Bu rol, diğer kullanıcılar tarafından oluşturulan sözleşmeleri iptal etmeye izin verir
    • Yönetici (x_adosy_as.adobe_sign_admin)
      • "x_adosy_as.adobe_sign_admin" rolüne sahip ServiceNow kullanıcıları tüm işlevlere tam erişim sağlayabilir

    Uygulama, varsayılan olarak belgeleri imzalayabilecek kullanıcılara atanması gereken bir rolle birlikte gelir. Tüm kullanıcılara belge imzalama erişimi vermek için ayarları güncellemeniz gerekir.

    Dikkat:

    Uygulama dosyalarında yaptığınız değişiklikler gelecekteki güncellemelerin uygulanmasını engeller.

    Bir güncelleme kümesinde yapılan değişiklikleri yakalayarak bu değişikliklerin uygulamaya yapılan bir güncellemeden sonra yeniden uygulanmasını sağlayın.

    Üretime uygulamadan önce her zaman özel bir test ortamında özelleştirmeleri test edin.

Acrobat Sign'a bağlanma

ServiceNow için Adobe Acrobat Sign uygulaması, hem ticari hem de resmi kurum (FedRAMP) hesaplarıyla çalışacak şekilde tasarlanmıştır. Hangi hesap türüne sahip olduğunuzdan emin değilseniz ticari bulut müşterilerine yönelik talimatları izleyin.

Ticari bulut müşterileri için:

Adobe Acrobat Sign uygulaması ServiceNow'a yüklendikten sonra, Adobe Acrobat Sign grubu veya hesap yöneticileri ServiceNow'ı aşağıdaki adımları kullanarak Adobe Acrobat Sign Commercial Cloud'a bağlamalıdır:

  1. Adobe Acrobat Sign > Yönetim > Adobe Acrobat Sign'a Bağlan konumuna gidin.

  2. Açılan iletişim kutusunda Bağlan'ı seçin.

    connect-sign-1

  3. Yönetici kimlik bilgilerini kullanarak Acrobat Sign hesabınızda oturum açın.

    connect-sign-2

  4. Görüntülenen izinler iletişim kutusunda, izinleri vermek ve bağlantıyı kurmak için Erişime İzin Ver'i seçin.

    connect-sign-3

    Not:

    Kimlik doğrulama, açılır bir pencerede gerçekleştirilir.  Kimlik doğrulama panelini görmüyorsanız açılır pencere engelleyicinizin devre dışı olduğundan emin olun.

    Bağlantı tamamlandığında, bağlı Acrobat Sign hesabı ve ilişkili olduğu ServiceNow hesabıyla birlikte bir onay mesajı görüntülenir.

    Acrobat Sign, Commercial Cloud'a bağlandı

Government Cloud müşterileri için:

Adobe Acrobat Sign uygulaması ServiceNow'a yüklendikten sonra, Adobe Acrobat Sign Government Cloud grubu veya hesap yöneticisi kullanıcısı, ServiceNow'ı Adobe Acrobat Sign Government Cloud'a bağlayabilir.

  1. Sol panelden Adobe Acrobat Sign > Yönetim > Özellikler'i seçin.

    ServiceNow için Sign'da fedramp'i etkinleştirin.

  2. Açılan uygulama özellikleri sayfasında:

    1. Adobe Acrobat Sign Government Cloud'ı Kullan seçeneğini etkinleştirin.
    2. Bağlantı Oturum Açma İpucu adlı özelliği bulun ve değeri Adobe Acrobat Sign Government Cloud'da oturum açmak için kullanacağınız e-posta adresine ayarlayın.
    3. Kaydet'i seçin.
  3. Adobe Acrobat Sign > Yönetim > Acrobat Sign'a Bağlan alanına gidin.

  4. Açılan sayfada Bağlan öğesini seçin.

    fedramp-2

  5. İstenirse Adobe Acrobat Sign Government Cloud hesabınızda oturum açın.

    Bağlantı kurulduktan sonra, uygulama ServiceNow'a yeniden yönlendirir ve bağlantı durumunu otomatik olarak günceller.

    fedramp-3

ServiceNow uygulaması için Acrobat Sign'ı yapılandırma

Uygulama özelliklerini ayarlama

Uygulama özelliklerine erişmek ve bu özellikleri ayarlamak için Adobe Acrobat Sign > Yönetim > Özellikler alanına gidin.

Aşağıdaki varsayılan ayarları görüntülenir:

  • Ana Bilgisayar Adı [x_adosy_as.redirect_host]Özel bir örnek URL'niz varsa, OAuth için Redirect URI ve API geri çağırmaları (örn. web kancaları) bölümünde kullanılacak tam nitelikli ana bilgisayarı belirtin.
    Varsayılan olarak bu değer boştur ve ana bilgisayar, "glide.servlet.uri" sistem özelliği tarafından tutulan değerdir.
    Yalnızca ServiceNow örneğinin yeniden yönlendirilmesi için geçerlidir. İmzalayanı imza sonrasında farklı bir ana bilgisayara yeniden yönlendirmek istiyorsanız bu ana bilgisayarı Signer Redirect URI (post_sign_uri) özelliğinde belirtin.
  • İmza Sonrası Varsayılan URL [x_adosy_as.post_sign_uri]: Acrobat Sign'da bir belge imzaladıktan sonra kullanıcının yeniden varsayılan olarak yönlendirildiği yerdir. Sözleşme oluşturulurken İmza Sonrası URI belirtilmediğinde kullanılır. Bu URI, belirtilen örnek adıyla ilişkilidir ancak imzadan sonra yeniden yönlendirmenin bu ServiceNow örneğinden başka bir yere gitmesine olanak tanıyan bir protokol (ör. https://www.adobe.com/) dahil edilerek geçersiz kılınabilir. Oluşturulan sözleşmenin sys_id değeri, URL'de "{sys_id}" kullanılarak eklenebilir. Varsayılan değer "/x_adosy_as_agreement_list.do?sysparm_query=requested_byDYNAMIC90d1921e5f510100a9ad2572f2b477fe%5EORsignersDYNAMIC90d1921e5f510100a9ad2572f2b477fe%5Estate=Complete%5EORDERBYDESCsys_created_on" şeklindedir ve kullanıcıyı tamamlanmış sözleşmelerin listesine götürür.
  • İmzalayanı Yeniden Yönlendirme Gecikmesi [x_adosy_as.post_sign_delay]Acrobat Sign'da bir belge imzaladıktan sonra kullanıcının yeniden yönlendirilmesinden önceki gecikmedir (saniye cinsinden). Varsayılan değer 3'tür.
  • Clickjacking Savunması [x_adosy_as.clickjacking_domain]İmza için gönderilen belgelerin bir iFrame içine yerleştirilebileceği ana etki alanı URL'lerinin virgülle ayrılmış bir listesini sağlar (ör. service-now.com).
    Bu, Government Cloud müşterileri için gereklidir. Bu alanı boş bırakmak, bir çerçeve içerisinde gösterildiğinde Acrobat Sığın'dan boş sayfalar çıkmasına neden olabilir.
  • Acrobat Sığın'dan e-postalara izin ver [x_adosy_as.send_adobe_sign_emails]İmzalama işlemi sırasında Acrobat Sign tarafından bildirim e-postalarının gönderilip gönderilmeyeceğini kontrol edin. Varsayılan, "yanlış" değeridir.
  • Açılır Taslak Sözleşmeler [x_adosy_as.popout_draft]Varsayılan olarak, sözleşmedeki "Ayrıntıları İncele" düğmesi tıklatıldığında taslak Acrobat Sign'da aynı tarayıcı penceresinde açılır.
    Bunun yerine yeni bir pencere açmak için bu seçeneği "doğru" olarak ayarlayın. Varsayılan, "yanlış" değeridir.
  • Denetimi Dahil Et [x_adosy_as.include_audit]İmzalanan belgelere dahil edilen denetim kaydını kontrol edin. Varsayılan, "doğru" değeridir.
  • Adobe Acrobat Sign Government Cloud'ı kullan [x_adosy_as.fedramp]: Adobe Government Cloud müşterileri, ServiceNow için Acrobat Sign Government Cloud hizmetlerini kullanmak üzere bu özelliği etkinleştirmelidir. Varsayılan, "yanlış" değeridir.
  • Bağlantı Oturum Açma İpucu [x_adosy_as.login_hint]: Adobe Acrobat Sign Government Cloud'a ilk kez bağlanırken kullanılan oturum açma ipucu değeri. Bu, genellikle hesap yöneticisi kullanıcısının e-postası olan "Acrobat Sign'a Bağlan" sayfasını otomatik olarak doldurur. Varsayılan değer boştur.
  • Sözleşme Faaliyeti Biçimlendirici Alanları [glide.ui.x_adosy_as_agreement_activity.fields]Hangi alanların sözleşme kaydında gösterilen faaliyet formatında gösterilmesi gerektiğini ayarlayın.
    Varsayılan değer "name, state, status,agreement_id,compose_url,post_sign_uri,etag" şeklindedir.
  • "Sözleşmelerim" Sorgusu [x_adosy_as.my_agreements_query]Sözleşmelerimi Portal gibi yerlerde gösterirken kullanılacak sorgudur. Varsayılan değer, kullanıcının istekte bulunan veya imzalayan olduğu sözleşmeleri döndüren "requested_byDYNAMIC90d1921e5f510100a9ad2572f2b477fe^ORsignersDYNAMIC90d1921e5f510100a9ad2572f2b477fe" değeridir.
  • Çok Parçalı Dosya Uzantısı [x_adosy_as.multipart_extension]:Geçici Çok Parçalı Dosya ekleri için kullanılacak dosya adı uzantısıdır. Varsayılan (önerilen) değer "mpfd"dir.
  • Uygulama kayıt işlemi [x_adosy_as.logging.verbosity]Sistem kayıt işlemini kontrol edin. Varsayılan değer "info"dur.
  • Hata Ayıklama Bağlantısı [x_adosy_as.connect_debug]Acrobat Sign'a bağlanırken tanılama uyarılarını gösterir. Varsayılan, "yanlış" değeridir.

Varsayılan yeniden yönlendirme URL özelliği, "İmza Sonrası URI" alanındaki değerin ayarlanmadığı tüm sözleşmelere uygulanır.

Not:

Yeniden yönlendirme URL'lerinde kodlanmamış özel karakterler veya boşluklar desteklenmez. Uygulama Özellikleri içerisindeki "Varsayılan İmza Sonrası URL" bir düzeltme sembolü (^) içeriyorsa bunu %5E şeklinde kodlamanız gerekir.

Örneğin, /x_adosy_as_agreement_list.do?sysparm_query=requested_byDYNAMIC90d1921e5f510100a9ad2572f2b477fe^ORsignersDYNAMIC90d1921e5f510100a9ad2572f2b477fe^state=Complete^ORDERBYDESCsys_created_on şu şekilde değiştirilmelidir:

 /x_adosy_as_agreement_list.do?sysparm_query=requested_byDYNAMIC90d1921e5f510100a9ad2572f2b477fe%5EORsignersDYNAMIC90d1921e5f510100a9ad2572f2b477fe%5Estate=Complete%5EORDERBYDESCsys_created_on 

Kalan özellikler, imzalama işlemi sırasında bildirimlerin Acrobat Sign tarafından gönderilip gönderilmeyeceğini (varsayılan = Hayır) ve Denetim kaydının imzalanan belgelere dahil edilip edilmeyeceğini (varsayılan = Evet) yönetir.

Özel bileşenleri yapılandırma

Adobe Acrobat Sign uygulaması, gereksinimlerinize göre yapılandırılabilen özel bileşenler içerir. Her birinin nasıl değiştirileceğini görmek için aşağıdaki bileşen listesine bakın.

“Adobe Acrobat ile İmzala”, Görev [task] tablosundaki bir Kullanıcı Arabirimi Eylem düğmesidir. Yalnızca Gönderen rolüne sahip kullanıcılar tarafından erişilebilir (x_adosy_as.adobe_sign_sender). Gönderenlerin bir sözleşmeye belge ile imzalayan eklemesine ve ekteki belgeyi imza için Adobe Acrobat Sign'a göndermesine izin verir.

ui-action-1

Sistem yöneticileri, “Adobe Acrobat ile İmzala” eylemini aşağıdaki şekilde diğer tablolara ekleyebilir:

  1. Aşağıdaki iki yöntemden birini kullanarak mevcut "Adobe Acrobat ile İmzala" eylemini açın:
    • Görev bölümünden genişletilen herhangi bir formda (Incidnet gibi) Kullanıcı Arabirimi Eylemlerini Yapılandır seçeneğine sağ tıklatın .
    • Sistem Tanımı > Kullanıcı Arabirimi Eylemleri konumuna gidin ve Adobe Acrobat ile İmzala'yı arayın.
  2. Tablo adını gerektiği gibi değiştirin.
  3. Yeni tabloyla mevcut kaydın bir kopyasını oluşturmak için üst eylem çubuğunu sağ tıklatın ve Ekle ve Kal'ı seçin.

"Adobe Acrobat Sign ile ilgili liste" listenin yapılandırıldığı kayıtla ilgili sözleşmeleri görüntüler. Yalnızca Kullanıcı (x_adosy_as.adobe_sign_user) rolüne sahip ve sözleşmenin istekte bulunan veya imzalayanları olan kullanıcılar ilgili listedeki sözleşmeleri görebilir.

"personalize_form" rolüne sahip sistem yöneticileri veya kullanıcılar, formu ve ilgili liste düzenini yapılandırabilir.

İlgili Listeyi Formlara eklemek için:

  1. İlgili formda sağ tıklatın ve Yapılandır > İlgili Listeler alanına gidin.
  2. Kullanılabilir listesinden Adobe Acrobat Sign'ı seçin.
  3. Seçili listesine eklemek için sağ oku seçin.
  4. Kaydet'i seçin.

Yapılandırmakta olduğunuz forma geri dönersiniz ve formun altında "Adobe Acrobat Sign" ile ilgili liste görünür.

related-list-3

Hizmet portalı bileşenlerini yapılandırma

ServiceNow için Acrobat Sign uygulaması, kendi Hizmet Portallarınızla kullanılabilecek veya kopyalanabilecek aşağıdaki Servis Portalı öğeleriyle birlikte gelir.

Uygulamayla birlikte verilen Adobe Acrobat Sign Hizmet Portalı kullanım amaçlı değildir ve genişletilmez. Yalnızca "İmza için Gönder" arabirimini destekler.

Portala /adobe_sign adresinden erişilebilir.

Uygulamada iki Hizmet Portalı sayfası bulunur:

  • Adobe Acrobat Sign (x_adosy_as_send)
  • Adobe Acrobat Sign Ana Sayfası (x_adosy_as_home)

Adobe Acrobat Sign (x_adosy_as_send) sayfası yalnızca İmza için Gönder arabirimi için kullanılır ve değiştirilmemelidir.

Adobe Sign Ana Sayfası (x_adosy_as_home), Hizmet Portalı ana sayfası olarak belirtilmiştir ve birlikte verilen örnek widget'ları göstermek için tasarlanmıştır.

Uygulama ile birlikte gelen widget'ları gereksinimlerinize göre kullanabilirsiniz. Widget değişikliklerini izleyebilmek ve uygulamanızdan güncellemeler alabilmek için tüm değişiklikleri yalnızca widget'ın bir klonunda yapmanız gerekir.

  • Adobe Acrobat Sign İmza için Gönder: Şablonlardan ve/veya yüklenen dosyalardan Sözleşme oluşturmak için kullanılır. İmza için Gönder menü öğesi ve Adobe Acrobat ile İmzala Kullanıcı Arabirimi Eylemi ile erişilebilir ve Gönderen rolüne sahip kullanıcılar tarafından kullanılabilir.

Widget Seçenekleri: Widget, gerektiğinde widget örneği seçenekleri veya URL parametreleri aracılığıyla özelleştirilmek üzere tasarlanmıştır. Form verilerini otomatik olarak doldurmak için Belge Şablonları ve Birleştirme Kuralları özelliğini kullanın. URL parametrelerini kullanırken Boole seçeneklerini "doğru" veya "1" olarak ayarlayabilirsiniz.

Ad

Tür

Açıklama

subject_table

Dize

Sözleşmenin ait olduğu tablonun adıdır.

subject_id

Dize

Sözleşmenin ait olduğu kaydın sys_id değeridir.

agreement_name

Dize

Yeni sözleşmenin adıdır.

attachments

Dize

Sözleşmede kullanılacak ek sys_id değerlerinin listesidir.

şablonlar

Dize

Sözleşmede kullanılacak belge şablonu sys_id değerlerinin listesidir.

signers

Dize

İmzalayan olarak eklenecek kullanıcı veya e-posta adreslerinin listesidir.

ccs

Dize

CC girişleri olarak eklenecek kullanıcı veya e-posta adreslerinin listesidir.

password_protect

Boole değeri

Sözleşmeyi korumak için kullanıcının bir parola belirlemesini ister. hide_options veya lock_options "doğru" olsa bile kullanıcının bir parola oluşturması gerekir.

send_emails

Boole değeri

Adobe'nin imzalama işlemi sırasında e-posta bildirimleri göndermesini sağlar.

submit_as_draft

Boole değeri

Hemen imza için göndermek yerine taslak bir sözleşme oluşturur.

copy_to_subject

Boole değeri

İmzalanan sözleşme dosyasını konu kaydına kopyalar. Geçerli bir subject_table ve subject_id sağlanmalıdır.

post_sign_uri

Dize

İmzalayanlar imzalama işlemini bitirdiklerinde özel bir yeniden yönlendirme sağlar. Varsayılan yeniden yönlendirme, kullanıcıyı sözleşme kaydına gönderir.

hide_options

Dize

Gizlenecek seçeneklerin virgülle ayrılmış listesidir (password_protect, send_emails, submit_as_draft, copy_to_subject). Tüm seçenekleri kullanıcıdan gizlemek için "doğru" olarak ayarlayın.

lock_options

Dize

Salt okunur yapmak için virgülle ayrılmış seçenekler listesidir (password_protect, send_emails, submit_as_draft, copy_to_subject). Tüm seçeneklerin kullanıcı tarafından değiştirilmesini önlemek için "doğru" olarak ayarlayın.

hide_subject

Boole değeri

Konudaki eklerin seçilmesini engeller.

skip_documents

Boole değeri

İlk belgeler panelini atlar. Bu yalnızca ekler veya şablonlar önceden seçildiğinde geçerli olur.

  • Adobe Acrobat Kontrol Paneli Öğe Listesi: İmzalanması gereken geçerli sözleşmelerin listesini çalışan veya müşterilerinizin Hizmet Portalına eklemek için kullanılabilir. Bu liste, Adobe Sign Ana Sayfasının "Yapılacaklar" özelliğinde kullanılır.
    Bu listede gösterilen kayıtlara erişmek için Self Servis > Adobe Acrobat Sign > İmza için alanına gidin.
  • Adobe Acrobat Sign Üst Bilgisi: "Yapılacaklar" özelliğini göstermek için Adobe Sign Ana Sayfasında kullanılır.
widget

Belge şablonları oluşturma

Belge şablonu, sözleşmeye dahil edilmek üzere seçilebilecek bir şablonu tanımlar.  Bir şablon, birçok ayrı sözleşme için yeniden kullanılabilecek standart bir belge sunmak için kullanılabilir. "Kaynak belge" kaydı, şablonun özelliklerini ilgili sözleşmede kullanılabilir hale getirmek için bir şablona referansta bulunur.

Şablon, ServiceNow örneği için yerel olabilir veya ayrıntıları bağlı Adobe Acrobat Sign hesabından senkronize edilen bir Kitaplık şablonu olabilir.

Kitaplık Şablonlarını Senkronize Etme

Uygulama yüklendikten ve yapılandırıldıktan sonra yöneticiler Kitaplık şablonlarını senkronize edebilir. Acrobat Sign hesabında bir Adobe Acrobat Sign Kitaplık şablonu tanımlanır ve ayrıntıları ServiceNow ile senkronize edilir.  Kitaplık şablonunun tanımlayıcı belgesi de bağlı Acrobat Sign hesabında saklanır ve bu nedenle gönderim için yükleme gerekmez.

Kitaplık şablonlarını ServiceNow'a senkronize etmek için:

  1. Adobe Acrobat Sign > Yönetim > Belge şablonları konumuna gidin.
  2. Kitaplığı Yenile öğesini seçin.

Bu, bağlı Acrobat Sign hesabından liste görünümünü Kitaplık Şablonları ile günceller.

refresh-library

Yerel Şablonlar Oluşturma

Bir Yerel şablonun tanımlayıcı belgesi, ServiceNow'da bir ek kayıt olarak tutulur ve bu kaydın gönderme işleminin bir parçası olarak Acrobat Sign'a yüklenmesi gerekir.

Bir şablonun belgesi, sözleşmenin konu kaydındaki veriler kullanılarak önceden doldurulması gereken form alanlarını içerebilir veya içermeyebilir. Belgede bu tür form alanları varsa şablon kullanmanız gerekir.

  1. Acrobat Sign > Yönetim > Belge şablonları konumuna gidin.
  2. Yeni öğesini seçin.
  3. Şablon için "Yeni" kayıt sayfasında:
    1. Şablona bir Ad verin.
    2. "Tür" öğesini, "Yerel" olarak ayarlayın.
    3. Sağ tıklatın ve Kaydet öğesini seçin.
  4. Dosyayı seçip şablon kaydına sürükleyerek veya üst bilgideki ataş simgesini seçip dosyayı belirleyerek bir belgeyi şablonla ilişkilendirebilirsiniz. Dosya eklendikten sonra, iletişim kutusunu kapatmak için X simgesini seçin.

Belge, "Belge" şablonuna eklenir ve "Belge" alanında referans verilir.

create-template-without-field-1

create-template-without-field-2

create-template-without-field-3

Alanlar olmadan Şablon oluşturmak için belirtilen adımların aynısını uygulamanız gerekir. Ancak belge ilişkilendirildikten sonra aşağıdaki ek yapılandırma adımlarını gerektiği gibi tamamlamanız gerekir:

  • "Doldurulabilir" alanın doğru olarak ayarlandığını doğrulayın. 

Doldurulabilir alanlar içeren bir belge şablonla ilişkilendirildiğinde otomatik olarak kontrol edilir.

  • Belge alanı kayıtları oluşturun.

Ana Belge şablonu için belge alanı kayıtları oluşturmalı ve şablon belgesine gömülü form alanlarının ayrıntılarını tanımlamalısınız.

Bunu yapmak içinBelge şablonu kaydını kaydedin ve ardından Alanları yenile öğesini seçin.

"Belge alanları" ile ilgili liste, ekli belgedeki doldurulabilir form alanlarına karşılık gelen kayıtlarla doldurulur.

create-template-with-fields

  • Birleştirme Kurallarını Yapılandırma

Birleştirme kuralı, bir Belge şablonunu ServiceNow'daki belirli bir konu kaydıyla ilişkilendirir.

Tek bir Belge şablonunun kendisine bağlı birden fazla Birleştirme kuralı olabilir (şablonun alanlarını önceden doldurmak için kullanılan her konu kaydı türü için bir tane).

Örneğin, bir şablon Olay, Hizmet isteği veya Değişiklik isteği kaydındaki veriler kullanılarak doldurulabilir (bu durumda şablonun her bir konu tablosu için birer tane olmak üzere üç birleştirme kuralı olur).

Birleştirme kuralını yapılandırmak için:

  1. Birleştirme kuralıyla ilgili listede gezinin.
  2. Yeni öğesini seçin.
  3. Bir Tablo seçin, ör. "Incident".
  4. Sağ tıklatın ve Kaydet öğesini seçin..
merge-rule

  • Birleştirme Alanlarını Yapılandırma

Birleştirme alanı kaydı, konu kaydından bir alanı, ilgili Belge şablonu içinde bulunan bir alana bağlar.  Birleştirme kuralı yapılandırılırken birleştirme alanlarının manuel oluşturulması gerekir.

Birleştirme alanı kayıtları oluşturmak için:

  1. Adobe Acrobat Sign > Yönetim > Birleştirme kuralları alanına gidin.
  2. Birleştirme kuralı kaydında Alanları yenile öğesini seçin.
    "Birleştirme alanları" gömülü listesi Belge alanlarıyla doldurulur.
  3. İlgili Belge alanlarını karşılık gelen Kayıt alanlarına bağlamak için, eşlemek istediğiniz Belge alanının (ör. ad) karşılık gelen Kayıt alanının bağlantısını seçin.
  4. Açılır menüden ilgili Kayıt alanını (ör. Caller) seçin.
  5. Güncelle öğesini seçin.

Birleştirme kuralı kaydına yeniden yönlendirilirsiniz. Birleştirme alanları ile ilgili liste artık önceki adımda seçilen Kayıt alanının değerini içermektedir.

Düzenli olması adına, birleştirme alanları gömülü listesinde yalnızca eşleşen değerlerin bulunması için kalan Birleştirme alanlarından eşlenmeyecek olanları silin (ve Doğrulayın).

merge-fields-1

Hizmet Kataloğu Öğesi Oluşturma

ServiceNow için Acrobat Sign, bir Kayıt Üreticisi oluşturarak kullanıcıların Hizmet Kataloğu üzerinden erişebilecekleri yeni sözleşmeler oluşturmanıza olanak tanır. Kayıt Üreticisini, belgede birleştirmek istediğiniz tüm verileri toplayacak ve sözleşmeyi otomatik olarak oluşturup kullanıcıya gönderecek şekilde yapılandırabilirsiniz. 

catalog_admin veya admin rolüne sahip kullanıcılar katalog öğesi oluşturabilir. Aşağıdaki adımlarda, Kayıt Üreticisi adlı bir katalog öğesinin nasıl oluşturulacağı açıklanmaktadır. Başka katalog öğeleri oluşturmak için bu adımları tekrarlayabilirsiniz.

Not: Örneğinizi yapılandırırken Adobe Acrobat Sign uygulamasının seçili olmadığından emin olun.

Her Kayıt Üreticisi oluşturma işlemi Belge alanları, şablon, değişken ve diğer özelliklere yönelik gereksinimlere göre farklılık gösterebilir ancak hepsi için aynı prensipler geçerlidir.  Bu kılavuzdaki örnek, Park İzni Sözleşmesi oluşturmayı göstermektedir. 

Kayıt Üreticisi oluşturmak için:

  1. Hizmet Kataloğu > Katalog Tanımı > Kayıt Üreticileri konumuna gidin ve Yeni öğesini seçin.

  2. Açılan yeni "Kayıt Üreticisi" sayfasında:

    1. Kayda bir Ad verin.
    2. "Tablo Adı" öğesini "Sözleşme" [x_adosy_as_agreement] olarak ayarlayın.
    3. Kısa bir açıklama girin.
    4. Yeniden Yönlendir alanını Oluşturulan Görev Kaydı olarak ayarlayın.
    Görev kaydı oluşturma

  3. Erişilebilirlik sekmesini seçin ve Kataloglar, Kategori ve Kullanılabilirlik alanlarını gereken şekilde ayarlayın. Ardından, üst bilgi çubuğunu sağ tıklatın ve Kaydet öğesini seçin.

    Bu alanları "Kategoriler" ve "Kataloglar" ilgili listelerini kullanarak ayarlayabilirsiniz. 

    Erişilebilirlik sekmesi

  4. "Değişken" ilgili listesinde, Belge alanlarıyla eşleşmesi için gereken değişkenleri ekleyin.

    Bu örnekte ad, çalışan ve yönetici alanlarını ekliyoruz.

    Değişkenler sekmesi

    Not:

    "İzin adı" soru değişkeni için Varsayılan değer: "javascript:'Parking Permit for ' + gs.getUserDisplayName()"

  5. Değişkenleri alacak ve imza için gönderilecek sözleşmeyi oluşturacak olan Kayıt Üreticisi Komut Dosyasını yapılandırın. "Komut Dosyası" alanında:

    1. Katalog öğesi değişkenlerini okuyan aşağıdaki komut dosyasını kopyalayıp yapıştırın.
    2. Üreticiden bilgi toplamak için değişken tanımlarını güncelleyin.
    3. Kullandığınız belge şablonu için sys_id değerini güncelleyin.
    4. Kullanıcının imzaladıktan sonra başka bir yere gitmesini istiyorsanız post_sign_uri'yi güncelleyin.

     

    // Park İzni şablonu için Adobe Acrobat Sign Kayıt Üreticisi örneği

    (function() {

      // Kullanıcı tarafından doldurulan değişkenlerden ihtiyaç duyulan bilgileri toplayın

      var employee_id    = producer.employee + '';

      var employee_name  = producer.employee.getDisplayValue() + '';

      var manager_id     = producer.manager + '';

      var manager_name   = producer.manager.getDisplayValue() + '';

      var agreement_name = "Parking permit for " + employee_name;

      // Kullanılan Belge Şablonunun sabit kodlanmış sys_id değeri

      var document_template = '5a2e0131db4c7c10c39151fcd39619af'; // Parking Permit

      // Yukarıdaki Belge Şablonu ile birleştirilecek verileri ayarlayın.

      // Her özellik, eşlemek istediğimiz bir Belge Alanının adıdır.

      var merge_data = {

        name         : agreement_name,

        employeename : employee_name,

        managername  : manager_name,

      };

      // Yeni Sözleşmeyi ayarlayın

      var agreement = new x_adosy_as.Agreement(current);

     

      // İmzalanmasını istediğimiz belgeleri ekleyin

      agreement.addDocument(document_template, merge_data);

      // İmzalayanları ekleyin

      agreement.addSigner(employee_id);

      agreement.addSigner(manager_id);

      // Sözleşme adını ayarlayın

      current.name = agreement_name;

      // İmzalayanların imzaladıktan sonra yeniden yönlendirileceği URL'yi ayarlayın

      current.post_sign_uri = '/x_adosy_as_agreement.do?sys_id=' + current.sys_id;

      // Hemen imza için göndermek üzere durumu "Ready" (Hazır) olarak ayarlayın

      current.state = 'Ready';

    })();

İş Akışı Etkinliğinden Sözleşme Oluşturma

Mevcut Katalog öğelerine imza için belge eklemek üzere iş akışınıza sözleşmeyi oluşturan bir görev ve imzalaması için sözleşmeyi bir kullanıcıya atayan bir katalog görevi ekleyebilirsiniz.

Aşağıdaki örnekte, Acrobat Sign uygulamasını nasıl kullanabileceğiniz gösterilmektedir ancak yapılandırma adımlarının belirli ayrıntıları, sürecinizin gereksinimlerine göre farklılık gösterebilir.

Bir iş akışı etkinliğinden sözleşme oluşturmak için aşağıdaki bileşenleri yapılandırmanız gerekir:

  • Katalog Görevi: Sözleşmeyi oluşturur, imza için gönderir ve imzalayana bir görev atar.
  • Komut Dosyası İşlemi: Sözleşme imzalandığında tetiklenen etkinliğe yanıt verir ve ardından görevi kapatarak geri bildirim döngüsü sağlar ve iş akışını devam ettirir.

Katalog görevi oluşturmak için:

  1. İş Akışı Düzenleyici'de Temel sekmesini seçin.
  2. Temel Etkinlikler > Görevler bölümüne gidin ve ardından Katalog Görevi etkinliğini iş akışınızdaki uygun yere sürükleyin.
  3. Göreve bir Ad verin ve Önceliğini ayarlayın.
  4. Tamamlanması için bekle seçeneğini "doğru" olarak ayarlayın.
  5. Komut Dosyası bölümünde, Gelişmiş bayrağını "doğru" olarak ayarlayın ve ardından Gelişmiş komut dosyası alanına kodunuzu yazın. Aşağıda örnek bir kod verilmiştir.
  6. Güncelle öğesini seçin.
İş Akışı Etkinliğinden sözleşme oluşturun.

// Örnek görev iş akışı etkinliği oluşturma

(function () {

  // Sözleşmeyi imzalaması gereken kullanıcı

  var signer_id = current.request.requested_for + '';

  var signer_name = current.request.requested_for.getDisplayValue() + '';

  // Sözleşmenin adı

  var agreement_name = current.short_description + ' for ' + signer_name;

  // Bu eylem için Adobe Sign Belge şablonunun sabit kodlanmış sys_id değeri

  // Bu, gerçekten de verilere dayalı olması için kullanılan bir iş akışı değişkeni olmalıdır.

  var document_template = '2a9b1f57db508810257e73278c9619dc'; // My Template

  // newRecord()'ı çağırmadan GUID'yi ayarlayın; sözleşme konusu için gereklidir

  task.setNewGuid(gs.generateGUID(task.getTableName()));

  // Görevi ayarlayın

  task.short_description = current.short_description;

  task.assigned_to = signer_id;

  task.description = 'Agreement: ' + '\'' + agreement_name + '\'' +

    ' has been submitted  for your signature.\n' +

    'To sign, either:\n' +

    '- Navigate to: \'Self-Service > Adobe Sign > For Signature\', or\n' +

    '- Click the link to the Agreement in the \'Adobe Acrobat Sign\' '+

    'related list (below).';

  // Sözleşme seçenekleri (sözleşme kaydındaki alanlar)

  var options = {

    submit_as_draft: true // review the agreement in Adobe before sending

  };

  // İmzalama işlemine yardımcı olacak bir nesne oluşturun

  var adobe = new x_adosy_as.AdobeSign();

  // Sözleşmeyi oluşturun ve görev kaydını konu olarak sağlayın

  adobe.createAgreement(agreement_name, task, options);

  // Belge şablonunu ekleyin.

  adobe.addDocument(document_template);

  // İmzalayanları ekleyin. Bu, kullanıcı sys_id değerleri veya e-posta adresleri olabilir.

  adobe.addSigner(signer_id);

  // Sözleşmeyi Adobe'ye gönderin.

  adobe.submitAgreement();

})();

Artık sözleşme tamamlandığında katalog görevini otomatik olarak "Tamamlanarak Kapatıldı" durumuna ayarlamak için bir Komut Dosyası İşlemi oluşturabilirsiniz. Komut Dosyası İşleminizi Sözleşme tablosundaki x_adosy_as.agreement.complete etkinliği tarafından tetiklenecek şekilde yapılandırmanız gerekir.

Yeni bir Komut Dosyası İşlemi oluşturmak için:

  1. Sistem İlkesi > Etkinlikler > Komut Dosyası İşlemleri'ne gidin ve Yeni öğesini tıklatın.
  2. Yeni Komut Dosyası İşlemi sayfasında:
    1. Komut Dosyası İşlemine bir ad verin.
    2. Etkinlik adını x_adosy_as.agreement.complete olarak ayarlayın.
    3. Etkin onay kutusunu seçin.
    4. Komut Dosyası alanında, komut dosyasını aşağıdaki Komut Dosyası İşlemi: Örnek Kodu'dan kopyalayıp yapıştırın.
  3. Üst bilgi çubuğunu sağ tıklatın ve Kaydet öğesini seçin.
worflow-actitivty-script-action

Komut Dosyası İşlemi: Örnek Kodu

// Katalog görevi durumunu "Tamamlanarak Kapatıldı" olarak ayarlamak için Komut Dosyası İşlemi

(function () {

  var catalog_task = current.subject_id.getRefRecord();

  if (!catalog_task.isValidRecord() || catalog_task.getTableName() != 'sc_task') {

    return;

  }

  catalog_task.state = 3; // Closed Complete

  catalog_task.update();

})();

Acrobat Sign'ı Sözleşme Yönetimi ile kullanma

Acrobat Sign'ı yukarıda Özel Bileşenler bölümünde açıklanan Görev tabanlı kayıtlar dışındaki kayıtlarla kullanabilirsiniz. Aşağıdaki talimatlar, Acrobat Sign'ın Sözleşme Yönetimi için nasıl kullanılacağını göstermektedir. Yapılandırma adımlarının özel ayrıntıları, sürecinizin gereksinimlerine göre farklılık gösterebilir.

Sözleşme yönetimi için Acrobat Sign'ı kullanmak isterseniz aşağıdaki iki bileşeni yapılandırmanız gerekir:

  • Kullanıcı Arabirimi Eylemi: Sözleşmeyi oluşturur ve imza için gönderir.  Sözleşme imzalandıktan sonra bir etkinlik başlatılır.
  • Komut Dosyası İşlemi: Etkinliğe yanıt verir ve bir geri bildirim döngüsü sağlayarak işlemi devam ettirir ve Sözleşmeyi günceller.

Not: Yalnızca "ui_action_admin" veya "admin" rolleri olan kullanıcılar Kullanıcı Arabirimi eylemlerini tanımlayabilir. "Admin" rolüne sahip kullanıcılar yalnızca bir komut dosyası işlemi tanımlayabilir.

Kullanıcı Arabirimi Eylemi Oluşturma

Sözleşme [ast_contract] formunda bir Kullanıcı Arabirimi eylemi oluşturmak için:

  1. Sistem Tanımı > Kullanıcı Arabirimi Eylemleri bölümüne gidin ve Yeni öğesini seçin.

    Alternatif olarak, Sözleşme [ast_contract] formunda sağ tıklatın ve ardından Yapılandır > Kullanıcı Arabirimi Eylemleri > Yeni öğesini seçin.

  2. Kullanıcı Arabirimi Eylemi Yeni kayıt sayfasında aşağıdaki ayrıntıları girin:

    1. Tablonun Contract [ast_contract] olduğundan emin olun. 
    2. Ad alanında, kayıt için bir ad girin.
    3. Tablo açılır menüsünden bir Tablo seçin.
    4. Bir Sipariş girin.
    5. Etkin onay kutusunu seçin.
    6. Eklemeyi göster onay kutusunu seçin.
    7. Güncellemeyi göster onay kutusunu seçin.
    8. Form düğmesi onay kutusunu seçin.
    9. İşlem tamamlandıktan sonra üst çubuğu sağ tıklatın ve Kaydet'i seçin.

    Form kaydedilir ve yeniden yüklenir.

    ui-action-new-record

  3. Koşul alanına kullanıcı arabirimi eylemini görüntüleme koşulunuzu girin.

    Geçerli örnek, koşulu şu şekilde seçer: ‘current.state == 'draft' andand current.substate == 'under_review' andand !current.approver.nil()’.

    Koşul

  4. Komut Dosyası alanında, Sözleşme kaydı oluşturmak için bir kod girin (aşağıdaki örnek koda bakın), belirli alan değerlerini ayarlayın ve Adobe Acrobat Sign'a gönderin.

    Sağladığınız kod, özel gereksinimlerinize göre değişebilir ancak genel ilke geçerlidir.

    Not:

    Belge şablonunun sabit kodlanmış sys_id değeri, örneğimizde kullandığımız şablonu ifade eder.

    Sizinki, oluşturduğunuz şablon olacaktır (şablon oluşturmayla ilgili ayrıntılar için bkz. Yerel Şablonlar Oluşturma).

    // Yeni bir Adobe Acrobat Sign Sözleşmesi oluşturmak için Kullanıcı Arabirimi Eylemi örneği

    (function() {

      // Sözleşmenin adı

      var agreement_name = 'Contract: ' + current.short_description;

      // Bu eylem için Belge Şablonunun sabit kodlanmış sys_id değeri

      var document_template = '6d0cdc26db708c50257e73278c9619c4'; // Contract

      // İmzalama işlemine yardımcı olacak bir nesne oluşturun

      var adobe = new x_adosy_as.AdobeSign();

      // Sözleşmeyi oluşturun ve geçerli kaydı konu olarak sağlayın

      adobe.createAgreement(agreement_name, current);

      // Belge şablonunu ekleyin. Bu bir ek sys_id değeri olabilir.

      adobe.addDocument(document_template);

      // İmzalayanları ekleyin. Bu, kullanıcı sys_id değerleri veya e-posta adresleri olabilir.

      adobe.addSigner(current.approver);

      // Sözleşmeyi Adobe'ye gönderin.

      adobe.submitAgreement();

      // Kullanıcıyı tekrar bu kayda yönlendirin.

      action.setRedirectURL(current);

    })();

Komut Dosyası İşlemi Oluşturma

Komut Dosyası işlemlerini yalnızca etkinlikler tarafından tetikleyebiliriz. Komut Dosyası işlemi, Adobe Acrobat Sign ile gönderilen Sözleşme tablosundaki etkinliklerden biri tarafından tetiklenecek şekilde yapılandırılmıştır: x_adosy_as.agreement.complete

Yeni bir komut dosyası işlemi oluşturmak için:

  1. Sistem İlkesi > Etkinlikler > Komut Dosyası İşlemleri konumuna gidin.

  2. Yeni öğesini seçin.

  3. Komut Dosyası işlemi Yeni kayıt sayfasında:

    1. Komut dosyası için bir ad girin.
    2. Komut dosyası işlemini tetikleyen Etkinlik Adı'nı seçin.
    3. Etkin onay kutusunu seçin.
    4. Kodunuzu yazın. Aşağıdaki örnek koda bakın.
    Komut dosyası işlemine bir ad verin

    (function () { 
       
      var contract = current.subject_id.getRefRecord(); 
      
      if (!contract.isValidRecord() || contract.getTableName() != 'ast_contract') { 
        return; 
      } 
      
      contract.state = 'active'; 
      contract.update(); 
    })();

    Bu kodda, sözleşmeyi mevcut sözleşmenin subject_id alanından alırız ve Sözleşme tablosunda geçerli bir kayıt olup olmadığını kontrol ederiz. Geçerliyse durumu etkin ve güncel olarak değiştiririz.

  4. Gönder öğesini seçin.

Komut dosyası oluşturma API'lerini kullanma

Adobe Acrobat Sign uygulamasını dahili API'leri kullanarak tüm işlemlerinizle çalışacak şekilde kolayca genişletebilirsiniz. API'ye x_adosy_as ad alanı aracılığıyla erişilebilir.

AdobeSign()

AdobeSign örneği oluşturur.

Örnek:

// AdobeSign'ın yeni bir örneğini oluşturun

var adobe = new x_adosy_as.AdobeSign();

 #addCcUser(String user_id)

Katılımcı olmayan kullanıcılarla paylaşmak için geçerli sözleşmeye bir CC girişi ekleyin. ServiceNow kullanıcıları olarak kayıtlı olmayan kullanıcılar bir e-posta adresi sağlayarak eklenebilir.

Parametreler:

Ad

Tür

Durum

Açıklama

user_id

Dize

Zorunlu

Bir kullanıcının veya e-posta adresinin sys_id değeri.

Döndürülenler:

Tür

Açıklama

geçersiz

Yöntem bir değer döndürmüyor

Örnek:

// Sözleşmeye bir CC kullanıcısı ekleyin

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement('My Agreement');

adobe.addCcUser(current.requested_by);

adobe.addCcUser('abel.tuter@example.com');

#addDocument(String doc_selector, Object merge_data)

Geçerli sözleşmeye bir belge veya şablon ekleyin.

Parametreler:

Ad

Tür

Durum

Açıklama

doc_selector

Dize

Zorunlu

Şablonun adı veya şablon ya da ekin sys_id değeri.

merge_data

Nesne

İsteğe Bağlı

Belge alan adlarından belge alan değerlerine anahtar değer nesnesi.

Döndürülenler:

Tür

Açıklama

Dize

Başarılı olursa oluşturulan Kaynak Belge kaydının sys_id değeri.

Örnek:

// Şablonla bir sözleşme oluşturun

var template_id = '2a9b1f57db508810257e73278c9619dc';

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement('My Agreement');
adobe.addDocument(template_id);

#addElectronicSeal(String seal_id)

Geçerli sözleşmeye elektronik bir mühür ekleyin.

Parametreler:

Ad

Tür

Durum

Açıklama

seal_id

Dize

Zorunlu

Eklenecek elektronik mührün sys_id değeri, adı veya mühür kimliği.

Döndürülenler:

Tür

Açıklama

String|Boolean

Yeni katılımcı kaydının sys_id değeri veya mührün bulunamaması durumunda "yanlış" değeri.

Örnek:

// Sözleşmeye elektronik bir mühür ekleyin

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement('My Agreement');

adobe.addElectronicSeal('<SEAL>');

 #addParticipant(String user_id, String participant_role)

addSigner()'a alternatif bir yöntem, katılımcıların belirli bir rolle bir sözleşmeye eklenmesine olanak tanır. ServiceNow kullanıcıları olarak kayıtlı olmayan katılımcılar, bir e-posta adresi sağlayarak eklenebilir.

Not: Bu yöntem yalnızca veritabanına kaydedilen mevcut sözleşme kayıtlarıyla kullanılmalıdır.

Parametreler:

Ad

Tür

Durum

Açıklama

user_id

Dize

Zorunlu

Bir kullanıcının veya e-posta adresinin sys_id değeri.

rol

Dize

İsteğe Bağlı

Katılımcının sözleşme içindeki rolü. Varsayılan, SIGNER değeridir. Diğer değerler şunlardır: APPROVER, ACCEPTOR, CERTIFIED_RECIPIENT, FORM_FILLER.

Döndürülenler:

Tür

Açıklama

String|Boolean

Yeni katılımcı kaydının sys_id değeri veya kullanıcı kaydı bulunamadıysa ya da e-posta adresi yoksa "yanlış" değeri.

Örnek:

// Sözleşmeye katılımcı ekleyin

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement('My Agreement');

adobe.addParticipant('abel.tuter@example.com', 'APPROVER');

#addSigner(String user_id)

Sözleşmeye bir imzalayan ekleyin. ServiceNow kullanıcıları olarak kayıtlı olmayan imzalayanlar, bir e-posta adresi sağlayarak eklenebilir.

Parametreler:

Ad

Tür

Durum

Açıklama

user_id

Dize

Zorunlu

Bir kullanıcının veya e-posta adresinin sys_id değeri.

Döndürülenler:

Tür

Açıklama

geçersiz

Yöntem bir değer döndürmüyor.

Örnek:

// Sözleşmeye katılımcı ekleyin

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement('My Agreement');

adobe.addSigner('abel.tuter@example.com');

#copySignedDocumentToRecord(GlideRecord record)

Bir sözleşmenin imzalı belgesini başka bir kayda kopyalayın.

Parametreler:

Ad

Tür

Durum

Açıklama

kayıt

GlideRecord

Zorunlu

İmzalanan belgenin kopyalanacağı hedef kayıt.

Döndürülenler:

Tür

Açıklama

String|Boolean

Yeni eklentinin sys_id değeri veya işlem başarısız olursa "yanlış" değeri.

Örnek:

// Hedef kaydı alın

var target = new GlideRecord('...');

// İmzalanan belgeyi sözleşmeden hedefe kopyalayın
var adobe = new x_adosy_as.AdobeSign();

adobe.setAgreementRecord(agreement);

adobe.copySignedDocumentToRecord(target);

#copySignedDocumentToSubject()

Sözleşmenin imzalı belgesini, sözleşmenin konu kaydına kopyalayın.

Döndürülenler:

Tür

Açıklama

String|Boolean

Yeni eklentinin sys_id değeri veya işlem başarısız olursa "yanlış" değeri.

Örnek:

// İmzalanan belgeyi sözleşmeden konu kaydına kopyalayın
var adobe = new x_adosy_as.AdobeSign();

adobe.setAgreementRecord(agreement);

adobe.copySignedDocumentToSubject();

#createAgreement(String name, GlideRecord subject, Object option

Bir sözleşme oluşturur. Yeni bir sözleşme oluşturması gereken komut dosyaları tarafından kullanılabilir.

Parametreler:

Ad

Tür

Durum

Açıklama

ad

Dize

Zorunlu

Sözleşme adı.

konu

GlideRecord

İsteğe Bağlı

Konu kaydı (ör. bir Sözleşme veya bir İstek)

seçenekler

Nesne

İsteğe Bağlı

Sözleşme kayıt alanı adlarından değerlere anahtar değer nesnesi.

Döndürülenler:

Tür

Açıklama

String|null

Yeni sözleşmenin sys_id değeri veya boş.

Örnek:

// Yeni bir taslak sözleşme oluşturun

var options = {

  submit_as_draft: true

};

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement("My Agreement", current, options);

#getAgreement()

Geçerli kapsam dahilinde olan Sözleşme örneğini alın.

Döndürülenler:

Tür

Açıklama

Agreement|null

Sözleşme örneği veya boş.

Örnek:

// Sözleşme örneğini alın

var adobe = new x_adosy_as.AdobeSign();
adobe.createAgreement("My Agreement", current, options);
var agreement = adobe.getAgreement();

#getAgreementRecord()

Geçerli sözleşme kaydını döndürün.

Döndürülenler:

Tür

Açıklama

GlideRecord|null

Geçerli sözleşme kaydı veya boş.

Örnek:

// Sözleşme kaydını alın

var adobe = new x_adosy_as.AdobeSign();
adobe.createAgreement("My Agreement", current, options);
var agreement = adobe.getAgreementRecord();

#saveAgreement(String state)

Geçerli sözleşme kaydını kaydedin. Sözleşme durumu isteğe bağlı olarak geçebilir. Durum parametresi "Hazır" olarak ayarlanmadıkça bu işlem Adobe Acrobat Sign'a gönderme işlemini tetiklemez.

Parametreler:

Ad

Tür

Durum

Açıklama

durum

Dize

İsteğe Bağlı

Sözleşmenin durumu.

Döndürülenler:

Tür

Açıklama

Dize

Kaydedilen sözleşme kaydının sys_id değeri veya boş.

Örnek:

// Bir sözleşme oluşturun

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement('My Agreement');

adobe.addSigner('abel.tuter@example.com');

adobe.saveAgreement();

#setAgreementRecord(String|GlideRecord agreement)

Sözleşmenin bağlamını verilen kayda ayarlar.

Parametreler:

Ad

Tür

Durum

Açıklama

sözleşme

GlideRecord|String

Zorunlu

Sözleşme kaydı.

Döndürülenler:

Tür

Açıklama

geçersiz

Yöntem bir değer döndürmüyor.

Örnek:

// Bir sözleşme üzerinde çalışın

var adobe = new x_adosy_as.AdobeSign();

adobe.setAgreementRecord(agreement);

#setSubject(GlideRecord subject

Sözleşmenin konu kaydını ayarlayın.

Parametreler:

Ad

Tür

Durum

Açıklama

konu

GlideRecord

Zorunlu

Konu kaydı.

Döndürülenler:

Tür

Açıklama

geçersiz

Yöntem bir değer döndürmüyor.

Örnek:

// Bir konu kaydı alın
var subject = new GlideRecord('...')

// Sözleşmenin konusunu güncelleyin

var adobe = new x_adosy_as.AdobeSign();

adobe.setAgreementRecord(agreement);
adobe.setSubject(subject);
adobe.saveAgreement();

#submitAgreement()

Geçerli sözleşmeyi kaydedin ve durumunu "Hazır" olarak ayarlayarak Adobe Acrobat Sign'a gönderin.

Döndürülenler:

Tür

Açıklama

Dize

Kaydedilen sözleşme kaydının sys_id değeri veya boş.

Örnek:

// Bir sözleşme gönderin

var adobe = new x_adosy_as.AdobeSign();

adobe.setAgreementRecord(agreement);
adobe.submitAgreement();

.canSend()

Geçerli kullanıcının "Adobe Acrobat ile İmzala" Kullanıcı Arabirimi Eylemini kullanıp kullanamayacağını belirler. Örnek FedRAMP değilse veya geçerli kullanıcının Gönderen rolü varsa gönderme işlemine izin verilir.

Döndürülenler:

Tür

Açıklama

Boole değeri

Kullanıcı gönderebiliyorsa "doğru."

Örnek:

// Geçerli kullanıcının imza için gönderip gönderemeyeceğini kontrol edin

if(AdobeSign.canSend()) {

  gs.addInfoMessage('Bu kullanıcı imzalama işlemini kullanabilir.');

} else {

  gs.addErrorMessage('Bu kullanıcının imzalama işlemini kullanmak için izni bulunmamaktadır.');

}

.getAgreements(String subject_table, String subject_id)

Konuyla ilgili sözleşmelerin GlideRecord örneğini alın.

Parametreler:

Ad

Tür

Durum

Açıklama

subject_table

String|GlideRecord

Zorunlu

Konu tablosu adı veya konu kaydının kendisi.

subject_id

Dize

İsteğe Bağlı

Aynı zamanda tablo adını da geçiren konunun sys_id değeri.

Döndürülenler:

Tür

Açıklama

GlideRecord

Konuyla ilgili sözleşmelerin GlideRecord örneği.

Örnek:

// Tablo adını ve sys_id değerini kullanarak sözleşmeleri alın

var agreement = x_adosy_as.AdobeSign.getAgreements('sc_req_item', '<sys_id>');

while (agreement.next()) {

  gs.addInfoMessage(agreement.getDisplayValue());

}

// GlideRecord kullanarak sözleşmeleri alın

var req_item = new GlideRecord('sc_req_item');

req_item.get('<sys_id>');

var agreement = x_adosy_as.AdobeSign.getAgreements(req_item);

while (agreement.next()) {

  gs.addInfoMessage(agreement.getDisplayValue());

}

.getMyAgreements(String query)

Kullanıcıya ait sözleşmelerin GlideRecord örneğini alın. Bu yöntem, ilk sorgu için x_adosy_as.my_agreements_query özelliğine dayanır. Sorgu parametresiyle birlikte ek sorgu filtreleri eklenebilir.

Parametreler:

Ad

Tür

Durum

Açıklama

sorgu

Dize

İsteğe Bağlı

Sözleşme listesini daha fazla kısıtlamak için isteğe bağlı kodlanmış sorgu.

         

Döndürülenler:

Tür

Açıklama

GlideRecord

Kullanıcıya ait sözleşmeler.

Örnek:

// Geçerli kullanıcı için tamamlanan sözleşmeleri alın
var query = 'state=Complete^ORDERBYsys_created_on';

var agreement = x_adosy_as.AdobeSign.getMyAgreements(query);

while (agreement.next()) {

  gs.addInfoMessage(agreement.getDisplayValue());

}

.isFedRamp()

Sistemin Adobe FedRAMP'a (Government Cloud) bağlı olup olmadığını belirleyin.

Döndürülenler:

Tür

Açıklama

Boole değeri

x_adosy_as.fedramp özelliği "doğru" olarak ayarlandıysa "doğru".

Örnek:

// FedRAMP bağlantısı kullanıp kullanmadığımızı kontrol edin

if(x_adosy_as.AdobeSign.isFedRamp()) {

  gs.addInfoMessage ("Acrobat Sign bir government cloud bağlantısı kullanıyor.");

} else {

  gs.addErrorMessage("Acrobat Sign, government cloud bağlantısı kullanmıyor.");

}

 Adobe

Daha hızlı ve daha kolay yardım alın

Yeni kullanıcı mısınız?