Přejděte na stránku Obchod ServiceNow a vyhledejte aplikaci Adobe Acrobat Sign.
Naposledy aktualizováno
20. 6. 2025
Přehled
Aplikace Adobe Acrobat Sign pro ServiceNow umožňuje odesílat dokumenty k podpisu pomocí nativních funkcí platformy ServiceNow. Integrace služby Acrobat Sign s platformou ServiceNow vám poskytne přístup k následujícím vlastnostem a funkcím:
- Odesílání dokumentů k podpisu více příjemcům.
- Sledování procesu podepisování v průběhu jeho životního cyklu a identifikování předpokládaných podepisujících osob v jednotlivých fázích.
- Načtení podepsaného dokumentu s vloženým nebo samostatným dokumentem protokolu auditu.
- Načtení dat formuláře zadaných do dokumentu před procesem podepisování nebo v jeho průběhu.
- Vytváření předběžných verzí procesu podepisování pro počáteční kontrolu a následné odeslání. Všechny změny podepisujících provedené před odesláním jsou synchronizovány se službou ServiceNow.
- Generování a odesílání e-mailových upozornění jednotlivcům v průběhu procesu podepisování.
- Poskytování dokumentů k podpisu z místních souborů ve službě ServiceNow nebo z externího zdroje.
- Používání šablon dokumentů s poli, která lze před odesláním vyplnit s využitím dat ze záznamů služby ServiceNow. Umožňuje použít jedinou šablonu k vytváření uživatelsky specifických dokumentů na základě vybraného záznamu předmětu, jako je Incident nebo Požadavek na službu.
- Použití šablon z knihovny vašeho účtu Acrobat Sign, které jsou synchronizovány se službou ServiceNow a jsou k dispozici pro výběr během procesu odesílání.
Adobe Acrobat Sign pro ServiceNow: Příručka pro instalaci a konfiguraci obsahuje pokyny pro následující postupy:
- Instalace aplikace Acrobat Sign pro ServiceNow
- Připojení ke službě Acrobat Sign
- Konfigurace aplikace Acrobat Sign pro ServiceNow
- Použití služby Acrobat Sign se správou smluv
- Použití skriptovacích rozhraní API
Po instalaci a konfiguraci můžete aplikaci Acrobat Sign pro ServiceNow používat k odesílání, podepisování, sledování a správě dohod. Viz Adobe Acrobat Sign pro ServiceNow: Příručka uživatele.
Chcete-li instalovat aplikaci na platformu ServiceNow, musíte být správcem služby Adobe Acrobat Sign a správcem systému ServiceNow.
Můžete požádat o bezplatný zkušební účet služby Adobe Acrobat Sign pro ServiceNow.
-
-
Z výsledků vyhledávání vyberte možnost Adobe Acrobat Sign a poté vyberte tlačítko Získat.
Poznámka:Během instalace aplikace zakažte blokování automaticky otevíraných oken.
-
Pokud budete vyzváni, přihlaste se pomocí přihlašovacích údajů správce služby ServiceNow a postupujte podle pokynů pro instalaci.
-
Chcete-li ověřit instalaci, pak v horní nabídce instance ServiceNow vyberte položky Vše > Systémové aplikace > Moje firemní aplikace a poté vyberte kartu Instalováno. Zobrazí se výpis nejnovější verze služby Adobe Acrobat Sign.
Poznámka:Zásuvný modul Adobe Acrobat Sign pro ServiceNow je nakonfigurován pro práci s následujícími doménami:
- service-now.com
- servicenowservices.com
Doména servicenowservices.com je určena pro zákazníky používající cloud pro státní správu a vyžaduje další nastavení vlastností systému. Pokud je vaše doména v doméně servicenowservices.com, musíte vytvořit/nastavit systémovou vlastnost x_adosy_as.oauth_redirect_host s úplnou subdoménou vaší instance (například mydomain.servicenowservices.com).
V nabídce „Samoobsluha“ se zobrazí nová možnost Adobe Acrobat Sign s následujícími dvěma moduly:
- Moje podepsané dokumenty – Obsahuje seznam dohod ve stavu dokončeno, kde je přihlášený uživatel žadatelem nebo podepisujícím.
- K podpisu – Obsahuje seznam dohod, které čekají na podpis přihlášeného uživatele. Dohody jsou ve stavu „Odesláno k podpisu“ nebo „Odesláno ke schválení“.
Poznámka: Nabídky samoobsluhy se zobrazí pouze uživatelům s rolí Podepisující (x_adosy_as.adobe_sign_signer).
Nabídka Vše zahrnuje možnost Adobe Acrobat Sign, která obsahuje následující moduly:
- Odeslat k podpisu – Otevírá funkci pro produkci záznamů, z níž lze vytvořit a odeslat dohodu.
- Moje dohody – Seznam všech dohod, kde je přihlášený uživatel žadatelem nebo podepisující osobou.
- Moje podpisy – Podrobnosti záznamů, kde je přihlášený uživatel účastníkem (podepisující osobou) dohody.
Provozní
- Dohody – Podrobnosti procesu podepisování. Zahrnuje JSON a také všechny události služby Adobe Acrobat Sign, které uživatel přijímá a reaguje na ně.
- Zdrojové dokumenty – Tato položka představuje dokument, který lze přidat k dohodě. Může se jednat o dokument Místní nebo dokument Knihovny
- Účastníci – Podepisující osoby a podrobnosti jejich procesu podepisování.
- Události – Podrobnosti o tom, co je odesíláno a přijímáno v rámci každé události služby Adobe Acrobat Sign.
- Data formuláře – Tabulka, která obsahuje data vráceného formuláře po podepsání dohody. Lze je použít k vytváření sestav o dokumentech a jejich datových polích.
Správa
- Připojení ke službě Acrobat Sign – Obrazovka připojení, na které lze propojit platný účet služby Adobe Acrobat Sign se službou ServiceNow.
- Skupiny služby Acrobat Sign – Obsahuje seznam názvů a ID skupin služby Acrobat Sign.
- Uživatelé služby Acrobat Sign – Obsahuje podrobnosti o uživatelích služby Acrobat Sign.
- Elektronické pečeti –
- Šablony dokumentů – Šablony dokumentů, které lze přidat k dohodě. Může se jednat o šablonu Místní nebo Knihovna.
- Pole dokumentů – Podrobnosti polí formulářů, která jsou vložena do dokumentu šablony.
- Pravidla slučování – Přiřadí šablonu dokumentu k určitému typu záznamu předmětu v rámci služby ServiceNow.
- Sloučení polí – Záznamy, které propojují pole ze záznamu předmětu s polem obsaženým v příslušné šabloně dokumentu.
- Vlastnosti – Výchozí nastavení služby Adobe Acrobat Sign pro přesměrování URI po podpisu, oznámení a protokol auditu.
Nápověda a podpora – Odkazy na nápovědu ke službě Adobe Acrobat Sign.
Poznámka:- Moduly „Odeslat k podpisu“, „Moje dohody“ a „Moje podpisy“ se zobrazují uživatelům s rolí Odesílatele (x_adosy_as.adobe_sign_sender).
- Nabídky „Provozní“ a „Správa“ se zobrazují uživatelům s rolí správce (x_adosy_as.adobe_sign_admin) nebo manažera (x_adosy_as.adobe_sign_manager).
Ovládací prvky portálu služeb
Chcete-li přidat službu Adobe Acrobat Sign na svůj portál služeb, můžete si zobrazit ukázku na adrese URL /adobe_sign.
Tento portál je omezen na role x_adosy_as.adobe_sign_sender a x_adosy_as.adobe_sign_signer.
Chcete-li přidat tuto funkci do svého vlastního portálu, duplikujte widgety a upravte role podle potřeby.
- Seznam položek řídicího panelu Adobe Acrobat – Seznam položek, který používá ovládací prvek záhlaví Seznam dohod.
- Odeslání k podpisu ze služby Adobe Acrobat Sign – Ovládací prvek pro vytvoření nové dohody ze šablony nebo souboru.
- Seznam dohod ve službě Adobe Acrobat Sign – Ovládací prvek pro zobrazení seznamu dohod.
Stránky portálu služeb
- Adobe Acrobat Sign – Obsahuje ovládací prvek automaticky otevíraného okna služby Adobe Acrobat Sign a lze použít ze záznamů ve službě ServiceNow k průběžnému vytváření nových dohod.
- Domovská stránka Adobe Acrobat Sign – Jedná se o domovskou stránku pro ukázkovou verzi portálu služeb, která je součástí aplikace.
V aplikaci jsou čtyři role:
- Podepisující osoba (x_adosy_as.adobe_sign_signer)
- Uživatelé služby ServiceNow s rolí x_adosy_as.adobe_sign_signer mají přístup k modulům samoobsluhy služby Adobe Acrobat Sign
- Rovněž mohou přistupovat k uživatelskému ovládacímu prvku portálu služeb
- Tuto roli je potřeba přidat ke všem uživatelům/skupinám, od nichž se vyžaduje podepisování dokumentů nebo dohod
- Odesílatel (x_adosy_as.adobe_sign_sender)
- Uživatelé služby ServiceNow s rolí x_adosy_as.adobe_sign_sender mají přístup k aplikaci, aby mohli využívat funkce
- Tuto roli je potřeba přidat ke všem uživatelům/skupinám, jež mají mít možnost sledovat dokumenty nebo dohody, které si vyžádali nebo které mají podepsat
- Manažer (x_adosy_as.adobe_sign_manager)
- Uživatelé služby ServiceNow s rolí x_adosy_as.adobe_sign_manager mají přístup k funkcím služby Acrobat Sign na úrovni manažera
- Manažer může spravovat dohody vytvořené všemi odesílateli
- Tato role uděluje oprávnění rušit dohody vytvořené jinými uživateli
- Správce (x_adosy_as.adobe_sign_admin)
- Uživatelé služby ServiceNow s rolí x_adosy_as.adobe_sign_admin mají úplný přístup ke všem funkcím
Při výchozím nastavení obsahuje aplikace roli, která by měla být přidělena uživatelům, kteří mohou podepisovat dokumenty. Chcete-li poskytnout všem uživatelům přístup k podepisování dokumentů, musíte tato nastavení aktualizovat.
Pozor:Změny provedené v souborech aplikace zabrání instalaci budoucích aktualizací.
Zaznamenejte veškeré změny provedené v sadě aktualizace, aby se tyto změny mohly znovu použít po aktualizaci aplikace.
Než přizpůsobení nasadíte, vždy je vyzkoušejte ve vyhrazeném zkušebním prostředí.
Aplikace Adobe Acrobat Sign pro ServiceNow je navržena tak, aby spolupracovala jak s komerčními účty, tak s účty pro státní správu (FedRAMP). Pokud si nejste jisti, jaký účet máte, postupujte podle pokynů pro zákazníky používající komerční cloud.
Po instalaci aplikace Adobe Acrobat Sign do prostředí služby ServiceNow musí správci skupin nebo účtů služby Adobe Acrobat Sign připojit službu ServiceNow ke komerčnímu cloudu Adobe Acrobat Sign provedením následujících kroků:
-
Přejděte na položku Adobe Acrobat Sign > Správa > Připojit ke službě Adobe Acrobat Sign.
-
V následně zobrazeném dialogovém okně vyberte tlačítko Připojit.
-
Přihlaste se ke svému účtu Acrobat Sign pomocí přihlašovacích údajů správce.
-
Výběrem tlačítka Povolit přístup v následně zobrazeném dialogovém okně oprávnění udělte oprávnění a navažte připojení.
Poznámka:Ověřování proběhne v automaticky otevíraném okně. Pokud se panel ověřování nezobrazí, zkontrolujte, zda máte deaktivováno blokování automaticky otevíraných oken.
Po dokončení připojení se zobrazí potvrzovací zpráva s připojeným účtem Acrobat Sign a účtem ServiceNow, ke kterému je přidružen.
Po instalaci aplikace Adobe Acrobat Sign do prostředí služby ServiceNow musí uživatel s rolí správce skupin nebo účtů cloudu Adobe Acrobat Sign pro státní správu připojit službu ServiceNow ke cloudu Adobe Acrobat Sign pro státní správu.
-
Na levém panelu vyberte položky Adobe Acrobat Sign > Správa > Vlastnosti.
-
Na stránce vlastností aplikace, která se následně otevře:
- Zapněte přepínač Používat cloud Adobe Acrobat Sign pro státní správu.
- Najděte vlastnost s názvem Nápověda pro přihlášení k připojení a nastavte hodnotu na e-mailovou adresu, kterou budete používat pro přihlášení ke cloudu Adobe Acrobat Sign pro státní správu.
- Vyberte možnost Uložit.
-
Přejděte na položku Adobe Acrobat Sign > Správa > Připojit ke službě Acrobat Sign.
-
Na následně zobrazené stránce vyberte tlačítko Připojit.
-
Pokud budete vyzváni, přihlaste se ke svému účtu cloudu Adobe Acrobat Sign pro státní správu.
Po navázání připojení se aplikace přesměruje zpět do služby ServiceNow a automaticky aktualizuje stav připojení.
Postup konfigurace aplikace Acrobat Sign pro ServiceNow naleznete v následujících částech věnovaných nastavení konfigurace:
Chcete-li získat přístup k vlastnostem aplikace a nastavit je, přejděte na položku Adobe Acrobat Sign > Správa > Vlastnosti.
Zobrazí se následující výchozí nastavení:
- Název hostitele [x_adosy_as.redirect_host]: Pokud máte vlastní adresu URL instance, určete plně kvalifikovaného hostitele, který bude použit při přesměrování URI pro zpětná volání OAuth a API (např. webhooky).
Při výchozím nastavení je tato hodnota prázdná a hostitelem je hodnota, kterou uchovává systémová vlastnost „glide.servlet.uri“.
Platí pouze pro přesměrování instance ServiceNow. Pokud chcete přesměrovat podepisujícího po podpisu na jiného hostitele, uveďte tohoto hostitele ve vlastnosti URI přesměrování podepisujícího (post_sign_uri). - Výchozí adresa URL po podepsání [x_adosy_as.post_sign_uri]: Výchozí umístění pro přesměrování uživatele po podepsání dokumentu ve službě Acrobat Sign. Používá se v případě, že při vytváření dohody nebyl zadán žádný identifikátor URI po podepsání. Tento identifikátor URI je relativní vůči zadanému názvu instance, ale lze jej přepsat zahrnutím protokolu (například https://www.adobe.com/). Uvedení protokolu umožní přesměrovat po podepsání i mimo tuto instanci ServiceNow. Parametr sys_id vytvořené dohody lze vložit pomocí řetězce „{sys_id}“ v adrese URL. Výchozí hodnota „/x_adosy_as_agreement_list.do?sysparm_query=requested_byDYNAMIC90d1921e5f510100a9ad2572f2b477fe%5EORsignersDYNAMIC90d1921e5f510100a9ad2572f2b477fe%5Estate=Complete%5EORDERBYDESCsys_created_on“ přesune uživatele do seznamu dokončených dohod.
- Prodleva přesměrování podpisujícího [x_adosy_as.post_sign_late]: <span style="color: rgb(80,80,80);">Prodleva (v sekundách), než bude uživatel přesměrován po podepsání dokumentu ve službě Acrobat Sign. Výchozí hodnota je 3.
- Ochrana proti clickjackingu [x_adosy_as.clickjacking_domains]: Zadejte seznam čárkami oddělených adres URL nadřazených domén, ve kterých mohou být dokumenty odeslané k podpisu zahrnuty do prvku iframe, např. service-now.com.
Toto nastavení je vyžadováno u zákazníků používajících cloud pro státní správu. Ponechání tohoto pole prázdného může mít za následek prázdné stránky služby Acrobat Sign, když jsou zobrazeny v rámečku. - Povolit e-maily ze služby Acrobat Sign [x_adosy_as.send_adobe_sign_emails]: <span style="color: rgb(80,80,80);">Určuje, zda služba Acrobat Sign zasílá e-maily s upozorněním během procesu podepisování. Výchozí hodnota je false.
- Zobrazovat předběžné verze dohod v novém okně [x_adosy_as.popout_draft]: Při výchozím nastavení se po kliknutí na tlačítko Zkontrolovat detaily na dohodě otevře předběžná verze ve službě Acrobat Sign ve stejném okně prohlížeče.
Chcete-li místo toho otevřít nové okno, nastavte pro tuto možnost hodnotu true. Výchozí hodnota je false. - Zahrnout audit [x_adosy_as.include_audit]: <span style="color: rgb(80,80,80);">Určuje, zda bude v podepsaných dokumentech obsažen protokol auditu. Výchozí hodnota je true.
- Používat cloud Adobe Acrobat Sign pro státní správu [x_adosy_as.fedramp]: <span style="color: rgb(80,80,80);">Zákazníci používající cloud Adobe pro státní správu musí tuto vlastnost povolit, aby aplikace Acrobat Sign pro ServiceNow mohla používat služby cloudu Acrobat Sign pro státní správu. Výchozí hodnota je false.
- Nápověda pro přihlášení k připojení [x_adosy_as.login_hint]: <span style="color: rgb(80,80,80);">Hodnota login_hint použitá při prvním připojení ke cloudu Adobe Acrobat Sign pro státní správu. Toto nastavení automaticky vyplní stránku „Připojit ke službě Acrobat Sign“ a obvykle se jedná o e-mailovou adresu uživatele s rolí správce účtu. Výchozí hodnota je prázdný řetězec.
- Pole formátování aktivit dohody [glide.ui.x_adosy_as_agreement_activity.fields]: Nastavte, která pole se mají zobrazit ve formátu aktivit zobrazeném v záznamu dohody.
Výchozí hodnota je „name, state, status, agreement_id, compose_url, post_sign_uri, etag“. - Dotaz pro „Moje dohody“ [x_adosy_as.my_agreements_query]: <span style="color: rgb(80,80,80);">Dotaz, který bude použit při zobrazení vašich dohod na místech, jako je portál. Výchozí hodnota „requested_byDYNAMIC90d1921e5f510100a9ad2572f2b477fe^ORsignersDYNAMIC90d1921e5f510100a9ad2572f2b477fe“ vrátí dohody, ve kterých je uživatel žadatelem nebo podepisujícím.
- Přípona souboru z více částí [x_adosy_as.multipart_extension]: <span style="color: rgb(80,80,80);">Přípona názvu souboru pro dočasné přílohy souboru složeného z více částí. Výchozí (doporučená) hodnota je „mpfd“.
- Protokolování aplikací [x_adosy_as.logging.verbosity]: <span style="color: rgb(80,80,80);">Řídí systémové protokolování. Výchozí hodnota je „info“.
- Připojení pro ladění [x_adosy_as.connect_debug]: <span style="color: rgb(80,80,80);">Umožňuje zobrazovat diagnostická upozornění při připojování ke službě Acrobat Sign. Výchozí hodnota je false.
Vlastnost Výchozí adresa URL pro přesměrování se vztahuje na všechny dohody, pro které nebyla nastavena hodnota v poli „Identifikátor URI po podepsání“.
Poznámka:
V adresách URL pro přesměrování nejsou podporovány nekódované speciální znaky nebo mezery. Pokud tedy položka „Výchozí adresa URL po podepsání“ v rámci vlastností aplikace obsahuje symbol stříška (^), musíte jej zakódovat jako %5E.
Například zápis /x_adosy_as_agreement_list.do?sysparm_query=requested_byDYNAMIC90d1921e5f510100a9ad2572f2b477fe^ORsignersDYNAMIC90d1921e5f510100a9ad2572f2b477fe^state=Complete^ORDERBYDESCsys_created_on musí být změněn na:
/x_adosy_as_agreement_list.do?sysparm_query=requested_byDYNAMIC90d1921e5f510100a9ad2572f2b477fe%5EORsignersDYNAMIC90d1921e5f510100a9ad2572f2b477fe%5Estate=Complete%5EORDERBYDESCsys_created_on
Zbývající vlastnosti řídí, zda služba Acrobat Sign odesílá upozornění během procesu podepisování (výchozí nastavení = Ne) a zda jsou součástí podepsaných dokumentů protokoly auditu (výchozí nastavení = Ano).
Aplikace Adobe Acrobat Sign obsahuje vlastní součásti, které lze konfigurovat podle vašich požadavků. V níže uvedeném seznamu součástí naleznete informace o tom, jak jednotlivé součásti upravit.
Tlačítko „Podepsat v aplikaci Adobe Acrobat“ je tlačítko akce uživatelského rozhraní v tabulce Úloha [úloha]. Je přístupné pouze pro uživatele s rolí Odesílatel (x_adosy_as.adobe_sign_sender). Umožňuje odesílatelům přidávat dokumenty a podepisující k dohodě a odeslat připojený dokument do služby Adobe Acrobat Sign k podpisu.
Správci systému mohou přidat akci „Podepsat v aplikaci Adobe Acrobat“ do dalších tabulek, a to následovně:
- Otevřete stávající akci „Podepsat v aplikaci Adobe Acrobat“ jedním z následujících dvou způsobů:
- Na libovolném formuláři otevřeném z úlohy (jako je Incident) klikněte pravým tlačítkem myši a vyberte položku Konfigurovat akce uživatelského rozhraní.
- Přejděte na položku Definice systému > Akce uživatelského rozhraní a poté vyhledejte možnost Podepsat v aplikaci Adobe Acrobat.
- Změňte název tabulky podle potřeby.
- Klikněte pravým tlačítkem myši na horní panel akcí a výběrem možnosti Vložit a zůstat vytvořte kopii stávajícího záznamu s novou tabulkou.
„Související seznam Adobe Acrobat Sign“ zobrazí dohody, které souvisejí se záznamem, na němž je seznam nakonfigurován. Dohody uvedené v souvisejícím seznamu si mohou zobrazit pouze uživatelé s rolí Uživatel (x_adosy_as.adobe_sign_user), tedy žadatelé nebo podepisující příslušné dohody.
Správci systému nebo uživatelé s rolí „personalize_form“ mohou konfigurovat rozvržení formuláře a souvisejícího seznamu.
Postup přidání souvisejícího seznamu do formulářů:
- V příslušném formuláři klikněte pravým tlačítkem myši a přejděte na položku Konfigurovat > Související seznamy.
- V seznamu Dostupné vyberte položku Adobe Acrobat Sign.
- Výběrem pravé šipky přidejte tuto položku do seznamu Vybrané.
- Vyberte možnost Uložit.
Tím se přesunete na konfigurovaný formulář a související seznam „Adobe Acrobat Sign“ se zobrazí v dolní části formuláře.
Aplikace Acrobat Sign pro ServiceNow je poskytována s následujícími prvky portálu služeb, které lze zkopírovat nebo použít s vlastními portály služeb.
Portál služeb Adobe Acrobat Sign dodávaný s aplikací není určen k použití nebo rozšíření. Pouze podporuje rozhraní Odeslat k podpisu.
Portál je přístupný na adrese /adobe_sign.
Součástí aplikace jsou dvě stránky portálu služeb:
- Adobe Acrobat Sign (x_adosy_as_send)
- Domovská stránka Adobe Acrobat Sign (x_adosy_as_home)
Stránka Adobe Acrobat Sign (x_adosy_as_send) je používána výhradně pro rozhraní Odeslat k podpisu a neměla by být upravována.
Domovská stránka Adobe Sign (x_adosy_as_home) je specifikována jako domovská stránka portálu služeb a slouží jako ukázka zahrnutých ovládacích prvků.
Ovládací prvky, které jsou součástí aplikace, můžete používat podle svých požadavků. Chcete-li sledovat změny ovládacích prvků a získávat aktualizace z aplikace, musíte veškeré změny provádět pouze v klonu příslušného ovládacího prvku.
- Odeslání k podpisu ze služby Adobe Acrobat Sign: Slouží k vytvoření dohody ze šablon nebo nahraných souborů. Lze zpřístupnit pomocí položky nabídky Odeslat k podpisu a akce uživatelského rozhraní Podepsat v aplikaci Adobe Acrobat a je k dispozici uživatelům s rolí Odesílatel.
Možnosti ovládacího prvku: Ovládací prvek je navržen tak, aby jej bylo možné přizpůsobit podle potřeby prostřednictvím možností instance ovládacího prvku nebo parametrů adresy URL. K automatickému vyplnění údajů formuláře slouží šablony dokumentů a pravidla slučování. Při použití parametrů adresy URL můžete logické možnosti nastavit na hodnotu „true“ nebo „1“.
Jméno |
Typ |
Popis |
subject_table |
Řetězec |
Název tabulky, do které dohoda patří. |
subject_id |
Řetězec |
Parametr sys_id záznamu, ke kterému dohoda patří. |
agreement_name |
Řetězec |
Název nové dohody. |
attachments |
Řetězec |
Seznam parametrů sys_id příloh, které mají být v dohodě použity. |
templates |
Řetězec |
Seznam parametrů sys_id šablon dokumentů, které mají být v dohodě použity. |
signers |
Řetězec |
Seznam uživatelů nebo e-mailových adres, které chcete přidat jako podepisující. |
ccs |
Řetězec |
Seznam uživatelů nebo e-mailových adres, které chcete přidat jako položky podepisujících na kopii. |
password_protect |
Booleovský |
Vyžaduje, aby uživatel nastavil heslo k ochraně dohody. Uživatel bude muset nastavit heslo, i když má parametr hide_options nebo lock_options přiřazenu hodnotu true. |
send_emails |
Booleovský |
Umožňuje společnosti Adobe zasílat e-mailová upozornění během procesu podepisování. |
submit_as_draft |
Booleovský |
Umožňuje vytvořit předběžnou verzi dohody namísto okamžitého odeslání k podpisu. |
copy_to_subject |
Booleovský |
Umožňuje zkopírovat podepsaný soubor dohody do záznamu předmětu. Musí být zadány platné hodnoty parametrů subject_table a subject_id. |
post_sign_uri |
Řetězec |
Umožňuje nastavit vlastní přesměrování pro podepisující, když dokončí podepisování. Výchozí přesměrování přesune uživatele na záznam dohody. |
hide_options |
Řetězec |
Seznam čárkami oddělených možností, které mají být skryty (password_protect, send_emails, submit_as_draft, copy_to_subject). Nastavením hodnoty true skryjete všechny možnosti před uživatelem. |
lock_options |
Řetězec |
Seznam čárkami oddělených možností, které mají být pouze pro čtení (password_protect, send_emails, submit_as_draft, copy_to_subject). Nastavením hodnoty true zabráníte uživateli, aby změnil kteroukoli z možností. |
hide_subject |
Booleovský |
Zabrání výběru příloh v předmětu. |
skip_documents |
Booleovský |
Umožňuje přeskočit úvodní panel dokumentů. To platí pouze v případě, že byly předem vybrány přílohy nebo šablony. |
- Seznam položek řídicího panelu Adobe Acrobat: Lze použít k přidání seznamu aktuálních dohod, které je potřebné podepsat, na portál služeb zaměstnance nebo zákazníka. Tento seznam je používán ve funkci Úkoly na domovské stránce služby Adobe Sign.
Chcete-li získat přístup k záznamům zobrazeným v tomto seznamu, přejděte na položku Samoobsluha > Adobe Acrobat Sign > K podpisu. - Záhlaví služby Adobe Acrobat Sign: Používá se na domovské stránce služby Adobe Sign k prezentaci funkce Úkoly.
Šablona dokumentu definuje šablonu, kterou lze zvolit pro začlenění do dohody. Pomocí šablony lze nabídnout standardní dokument, který lze opakovaně použít pro mnoho jednotlivých dohod. Záznam „Zdrojový dokument“ odkazuje na šablonu, aby zpřístupnil funkce této šablony pro přidruženou dohodu.
Šablona může být místní v instanci služby ServiceNow nebo se může jednat o šablonu knihovny, přičemž v takovém případě jsou její detaily synchronizovány z připojeného účtu služby Adobe Acrobat Sign.
Po instalaci a konfiguraci aplikace mohou správci synchronizovat šablony knihovny. Šablona knihovny Adobe Acrobat Sign je definována v rámci účtu služby Adobe Sign a její detaily jsou synchronizovány se službou ServiceNow. Definující dokument šablony knihovny je rovněž uložen v připojeném účtu služby Acrobat Sign, a proto není nutné jej k odeslání nahrávat.
Postup synchronizace šablon knihovny se službou ServiceNow:
- Přejděte na položku Adobe Acrobat Sign > Správa > Šablony dokumentů.
- Vyberte tlačítko Aktualizovat knihovnu.
Dojde k aktualizaci zobrazení seznamu se šablonami knihovny z připojeného účtu služby Acrobat Sign.
Definující dokument místní šablony je uchováván ve službě ServiceNow jako záznam přílohy. Během procesu odesílání musí být nahrán do služby Acrobat Sign.
Dokument šablony může, ale nemusí obsahovat pole formuláře, která je nutné předem vyplnit daty ze záznamu předmětu dohody. Pokud dokument taková pole formuláře obsahuje, musíte použít šablonu.
- Přejděte na položku Acrobat Sign > Správa > Šablony dokumentů.
- Vyberte možnost Nové.
- Na stránce Nový záznam šablony:
- Zadejte název šablony.
- V seznamu Typ vyberte možnost Místní.
- Klikněte pravým tlačítkem myši a poté vyberte možnost Uložit.
- Chcete-li k šabloně přiřadit dokument, vyberte a přetáhněte soubor na záznam šablony nebo zvolte ikonu sponky v záhlaví a vyberte soubor. Po přidání souboru zavřete dialogové okno výběrem ikony X.
Dokument se připojí k šabloně dokumentu a v poli „Dokument“ se pro něj zobrazí odkaz.
Je nutné postupovat stejně jako v případě vytváření šablon bez polí. Jakmile je však dokument přidružen, musíte podle potřeby provést následující další kroky pro nastavení konfigurace:
- Ověřte, zda je zaškrtnuto políčko „Vyplnitelný“.
Pokud je k šabloně přidružen dokument obsahující vyplnitelná pole, políčko bude automaticky zaškrtnuto.
- Vytvořte záznamy polí dokumentu.
Pro nadřazenou šablonu dokumentu musíte vytvořit záznamy polí dokumentu. Zároveň musíte definovat detaily polí formuláře, která jsou vložena do dokumentu šablony.
Chcete-li tak učinit, uložte záznam šablony dokumentu a poté vyberte možnost Aktualizovat pole.
Související seznam „Pole dokumentu“ se vyplní záznamy odpovídajícími vyplnitelným polím formuláře v připojeném dokumentu.
- Konfigurace pravidel slučování
Pravidlo slučování přiřadí šablonu dokumentu k určitému typu záznamu předmětu v rámci služby ServiceNow.
Na jednu šablonu dokumentu může odkazovat několik pravidel slučování (jedno pro každý typ záznamu předmětu, který posloužil k předběžnému vyplnění polí šablony).
Šablonu lze například vyplnit daty ze záznamů Incident, Požadavek služby nebo Požadavek změny (v takovém případě by šablona měla tři pravidla slučování, jedno pro každou tabulku předmětu).
Konfigurace pravidla slučování:
- Přejděte do souvisejícího seznamu Pravidlo slučování.
- Vyberte možnost Nové.
- Vyberte tabulku, například Incident.
- Klikněte pravým tlačítkem myši a vyberte možnost Uložit.
- Konfigurace sloučení polí
Záznam Sloučení polí spojuje pole ze záznamu předmětu s polem obsaženému v příslušné šabloně dokumentu. Sloučení polí je potřeba vytvořit ručně při konfigurování pravidla Sloučení.
Postup vytváření záznamů sloučení polí:
- Přejděte na položku Adobe Acrobat Sign > Správa > Pravidla slučování.
- V záznamu pravidla slučování vyberte možnost Aktualizovat pole.
Vložený seznam „Sloučení polí“ se vyplní s použitím polí dokumentu. - Chcete-li propojit příslušná pole dokumentu s odpovídajícími poli záznamu, vyberte odkaz na odpovídající pole záznamu pro pole dokumentu, které chcete mapovat (například název).
- V rozevírací nabídce vyberte příslušné Pole záznamu <span style="text-align: initial; color: rgb(80, 80, 80);">(například Volající).
- Vyberte tlačítko Aktualizovat.
Dojde k přesměrování zpět na záznam Pravidlo slučování. Související seznam Sloučení polí nyní obsahuje hodnotu Pole záznamu zvolenou v předchozím kroku.
Za účelem zachování přehlednosti odstraňte (a potvrďte) zbývající sloučení polí, která nebudou mapována, aby vložený seznam Sloučení polí obsahoval pouze hodnoty, které budou mapovány.
Aplikace Acrobat Sign pro ServiceNow umožňuje vytvářet nové dohody, ke kterým mají uživatelé přístup prostřednictvím katalogu služeb, vytvořením položky Produkce záznamů. Položku Produkce záznamů můžete nakonfigurovat tak, aby shromažďovala veškerá data, která chcete sloučit do dokumentu, a automaticky vytvořila dohodu a odeslala ji uživateli.
Uživatelé s rolí catalog_admin nebo admin mohou vytvořit položku katalogu. Níže uvedený postup vysvětluje, jak vytvořit položku katalogu s názvem Produkce záznamů. Opakováním postupu můžete vytvořit další položky katalogu.
Poznámka: Při konfiguraci instance se ujistěte, že není vybrána aplikace Adobe Acrobat Sign.
Proces vytváření jednotlivých položek Produkce záznamů se může lišit v závislosti na konkrétních požadavcích na pole dokumentu, šablonu, proměnnou a další, přičemž však platí stejné principy. Příklad uvedený v této příručce ukazuje, jak vytvořit dohodu o povolení k parkování.
Vytvoření položky Produkce záznamů:
-
Přejděte na položku Katalog služeb > Definice katalogu > Produkce záznamů a poté vyberte možnost Nová.
-
Na následně otevřené nové stránce Produkce záznamů:
- Zadejte název záznamu do pole Název.
- Do pole Název tabulky zadejte název Dohoda [x_adosy_as_agreement].
- Zadejte krátký popis.
- V poli Přesměrovat do nastavte hodnotu Generovaný záznam úlohy.
-
Vyberte kartu Usnadnění přístupu a podle potřeby nastavte pole Katalogy, Kategorie a Dostupnost. Poté klikněte pravým tlačítkem myši na pruh záhlaví a vyberte možnost Uložit.
Tato pole můžete nastavit pomocí souvisejících seznamů „Kategorie“ a „Katalogy“.
-
Pomocí souvisejícího seznamu Proměnná přidejte proměnné podle potřeby tak, aby odpovídaly polím dokumentu.
V tomto příkladu přidáme pole pro jméno, zaměstnance a manažera.
Poznámka:Výchozí hodnota pro proměnnou otázky „Název povolení“ je: javascript:'Parkovací povolení pro ' + gs.getUserDisplayName()
-
Nakonfigurujte skript produkce záznamů, který převezme proměnné a vytvoří dohodu pro odeslání k podpisu. V poli „Script“:
- Zkopírujte a vložte následující skript, který čte proměnné položky katalogu.
- Aktualizujte definice proměnných, abyste získali informace od produkce.
- Aktualizujte parametr sys_id používané šablony dokumentu.
- Aktualizujte parametr post_sign_uri, pokud chcete, aby byl uživatel po podepsání přesměrován někam jinam.
// Příklad produkce záznamu služby Adobe Acrobat Sign pro šablonu Povolení k parkování
(function() {
// Shromáždí informace, které potřebujeme, z proměnných vyplněných uživatelem
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 = "Povolení k parkování pro " + employee_name;
// Pevně stanovený parametr sys_id použité šablony dokumentu
var document_template = '5a2e0131db4c7c10c39151fcd39619af'; // Povolení k parkování
// Nastavení dat pro sloučení s výše uvedenou šablonou dokumentu.
// Každá vlastnost je název pole dokumentu, na které chceme mapovat.
var merge_data = {
name : agreement_name,
employeename : employee_name,
managername : manager_name,
};
// Nastavení nové dohody
var agreement = new x_adosy_as.Agreement(current);
// Přidání dokumentů, které chceme nechat podepsat
agreement.addDocument(document_template, merge_data);
// Přidání podepisujících
agreement.addSigner(employee_id);
agreement.addSigner(manager_id);
// Nastavení názvu dohody
current.name = agreement_name;
// Nastavení adresy URL, na kterou budou podepisující po podepsání přesměrováni
current.post_sign_uri = '/x_adosy_as_agreement.do?sys_id=' + current.sys_id;
// Nastavení stavu 'Připraveno', aby bylo možné okamžité odeslání k podpisu
current.state = 'Připraveno';
})();
Chcete-li přidat dokumenty k podpisu k existujícím položkám katalogu, můžete do pracovního postupu přidat úlohu, která vygeneruje dohodu, a úlohu katalogu, která dohodu přiřadí uživateli k podpisu.
Následující příklad ukazuje, jak můžete použít aplikaci Acrobat Sign, nicméně konkrétní detaily konfiguračních kroků se mohou lišit podle požadavků vašeho procesu.
Chcete-li vytvořit dohodu z aktivity pracovního postupu, musíte nakonfigurovat následující součásti:
- Úloha katalogu: Vytvoří dohodu, odešle ji k podpisu a přiřadí úlohu podepisujícímu.
- Akce skriptu: Reaguje na událost vyvolanou při podpisu dohody a poté uzavře úlohu, čímž vytvoří smyčku zpětné vazby a umožní pokračování pracovního postupu.
Postup vytvoření úlohy katalogu:
- V editoru pracovního postupu vyberte kartu Základní.
- Přejděte na položku Základní aktivity > Úlohy a poté přetáhněte aktivitu Úloha katalogu na příslušné místo v pracovním postupu.
- Přiřaďte úloze název a nastavte její prioritu.
- Zaškrtněte políčko Čekat na dokončení.
- V části Skript zaškrtněte políčko příznaku Rozšířený a poté do pole Rozšířený skript zadejte požadovaný kód. Příklad kódu je uveden níže.
- Vyberte tlačítko Aktualizovat.
// Příklad vytvoření aktivity pracovního postupu úlohy
(function () {
// Uživatel, který musí podepsat dohodu
var signer_id = current.request.requested_for + '';
var signer_name = current.request.requested_for.getDisplayValue() + '';
// Název dohody
var agreement_name = current.short_description + ' pro ' + signer_name;
// Pevně stanovený parametr sys_id šablony dokumentu Adobe Sign pro tuto akci
// Toto by skutečně měla být proměnná pracovního postupu, aby bylo možné ji řídit daty.
var document_template = '2a9b1f57db508810257e73278c9619dc'; // Moje šablona
// Nastavení GUID bez volání funkce newRecord() – vyžadováno pro předmět dohody
task.setNewGuid(gs.generateGUID(task.getTableName()));
// Nastavení úlohy
task.short_description = current.short_description;
task.assigned_to = signer_id;
task.description = 'Dohoda: ' + '\'' + agreement_name + '\'' +
' byla odeslána k vašemu podpisu.\n' +
'Chcete-li ji podepsat, buď:\n' +
'– Přejděte na položku: \'Samoobsluha > Adobe Sign > K podpisu\', nebo\n' +
'– Klikněte na odkaz na dohodu v souvisejícím seznamu '+
'služby \'Adobe Acrobat Sign\' (uvedeném níže).';
// Možnosti dohody (pole v záznamu dohody)
var options = {
submit_as_draft: true // Kontrola dohody v aplikaci Adobe před odesláním
};
// Vytvoření objektu, který napomůže procesu podepisování
var adobe = new x_adosy_as.AdobeSign();
// Vytvoření dohody a zadání záznamu úlohy jako předmětu
adobe.createAgreement(agreement_name, task, options);
// Přidání šablony dokumentu.
adobe.addDocument(document_template);
// Přidání podepisujících. Může se jednat o parametry sys_id uživatelů nebo e-mailové adresy.
adobe.addSigner(signer_id);
// Odeslání dohody do společnosti Adobe.
adobe.submitAgreement();
})();
Nyní můžete nastavit akci skriptu, která po dokončení dohody automaticky nastaví úlohu katalogu do stavu Plně uzavřeno. Akci skriptu musíte nakonfigurovat tak, aby byla aktivována událostí x_adosy_as.agreement.complete v tabulce Dohoda.
Postup vytvoření nové akce skriptu:
- Přejděte na položku Systémové zásady > Události > Akce skriptu a klikněte na možnost Nová.
- Na nové stránce Akce skriptu:
- Přiřaďte název akci skriptu.
- Nastavte název události na x_adosy_as.agreement.complete.
- Zaškrtněte políčko Aktivní.
- Zkopírujte skript z níže uvedené části Akce skriptu: Ukázkový kód a vložte jej do pole Skript.
- Klikněte pravým tlačítkem myši na pruh záhlaví a vyberte možnost Uložit.
Akce skriptu: Ukázkový kód
// Akce skriptu pro nastavení stavu úlohy katalogu na Plně uzavřeno
(function () {
var catalog_task = current.subject_id.getRefRecord();
if (!catalog_task.isValidRecord() || catalog_task.getTableName() != 'sc_task') {
return;
}
catalog_task.state = 3; // Plně uzavřeno
catalog_task.update();
})();
Službu Acrobat Sign můžete používat i s jinými záznamy než se záznamy založenými na úlohách, jak je popsáno výše v části Vlastní součásti. Níže uvedené pokyny ukazují, jak používat službu Acrobat Sign ke správě smluv. Konkrétní podrobnosti kroků konfigurace se mohou lišit podle požadavků vašeho procesu.
Chcete-li používat službu Acrobat Sign ke správě smluv, musíte nakonfigurovat následující dvě součásti:
- Akce uživatelského rozhraní: Vytvoří dohodu a odešle ji k podpisu. Jakmile bude dohoda podepsána, spustí se událost.
- Akce skriptu: Reaguje na událost a poskytuje smyčku zpětné vazby, čímž posune proces dopředu a aktualizuje smlouvu.
Poznámka: Akce uživatelského rozhraní mohou definovat pouze uživatelé s rolí „ui_action_admin“ nebo „admin“. Akce skriptu mohou definovat pouze uživatelé s rolí „admin“.
-
Přejděte na položku Definice systému > Akce uživatelského rozhraní a poté vyberte možnost Nová.
Případně ve formuláři Smlouva [ast_contract] klikněte pravým tlačítkem myši a poté vyberte položky Konfigurovat > Akce uživatelského rozhraní > Nová.
-
Na stránce Nový záznam akce uživatelského rozhraní zadejte následující údaje:
- Ujistěte se, že je v poli Tabulka zvolena možnost „Smlouva [ast_contract]“.
- Do pole Název zadejte název záznamu.
- V rozevírací nabídce Tabulka vyberte požadovanou tabulku.
- Zadejte pořadí.
- Zaškrtněte políčko Aktivní.
- Zaškrtněte políčko Zobrazit vložení.
- Zaškrtněte políčko Zobrazit aktualizaci.
- Zaškrtněte políčko Tlačítko formuláře.
- Po dokončení klikněte pravým tlačítkem myši na horní panel a poté vyberte možnost Uložit.
Formulář se uloží a znovu načte.
- Ujistěte se, že je v poli Tabulka zvolena možnost „Smlouva [ast_contract]“.
-
Do pole Podmínka zadejte podmínku pro zobrazení akce uživatelského rozhraní.
V aktuálním příkladu je vybrána následující podmínka: ‘current.state == 'draft' andand current.substate == 'under_review' andand !current.approver.nil()’.
-
Do pole Skript zadejte kód (viz níže uvedený příklad kódu), který vytvoří záznam dohody, nastaví určité hodnoty polí a odešle jej do služby Adobe Acrobat Sign.
Kód, který zadáte, se může lišit podle vašich konkrétních požadavků, ale obecný princip platí.
Poznámka:Pevně zakódované sys_id šablony dokumentu odkazuje na šablonu, kterou používáme v našem příkladu.
Vy budete mít před sebou šablonu, kterou vytvoříte (viz část Vytváření místních šablon, kde jsou uvedeny podrobnosti o vytváření šablony).
// Příklad akce uživatelského rozhraní pro vytvoření nové dohody ve službě Adobe Acrobat Sign
(function() {
// Název dohody
var agreement_name = 'Smlouva: ' + current.short_description;
// Pevně stanovený parametr sys_id šablony dokumentu pro tuto akci
var document_template = '6d0cdc26db708c50257e73278c9619c4'; // Smlouva
// Vytvoření objektu, který napomůže procesu podepisování
var adobe = new x_adosy_as.AdobeSign();
// Vytvoření dohody a zadání aktuálního záznamu jako předmětu
adobe.createAgreement(agreement_name, current);
// Přidání šablony dokumentu. Může se jednat také o parametr sys_id přílohy.
adobe.addDocument(document_template);
// Přidání podepisujících. Může se jednat o parametry sys_id uživatelů nebo e-mailové adresy.
adobe.addSigner(current.approver);
// Odeslání dohody do společnosti Adobe.
adobe.submitAgreement();
// Přesměrování uživatele zpět na tento záznam.
action.setRedirectURL(current);
})();
Akce skriptů lze spouštět pouze pomocí událostí. Akce skriptu je nakonfigurována tak, aby byla spouštěna jednou z událostí v tabulce Dohoda dodávané s aplikací Adobe Acrobat Sign: x_adosy_as.agreement.complete
Postup vytvoření nové akce skriptu:
-
Přejděte na položku Systémové zásady > Události > Akce skriptu.
-
Vyberte možnost Nový.
-
Na stránce Nový záznam akce skriptu:
- Zadejte název skriptu.
- V poli Název události vyberte událost, která spustí akci skriptu.
- Zaškrtněte políčko Aktivní.
- Zadejte požadovaný kód. Využijte níže uvedený příklad kódu.
(function () { var contract = current.subject_id.getRefRecord(); if (!contract.isValidRecord() || contract.getTableName() != 'ast_contract') { return; } contract.state = 'active'; contract.update(); })();V tomto kódu získáme smlouvu z pole subject_id a zkontrolujeme, že se jedná o platný záznam tabulky Smlouva. Pokud tomu tak je, změníme stav na aktivní a provedeme aktualizaci.
-
Vyberte tlačítko Odeslat.
Aplikaci Adobe Acrobat Sign můžete snadno rozšířit tak, aby pracovala s libovolnými procesy používajícími interní rozhraní API. Rozhraní API je přístupné prostřednictvím prostoru názvů x_adosy_as.
AdobeSign()
Vytvoří instanci AdobeSign.
Příklad:
// Vytvoření nové instance AdobeSign
var adobe = new x_adosy_as.AdobeSign();
#addCcUser(String user_id)
Přidá k aktuální dohodě záznam pro kopii ke sdílení s nezúčastněnými uživateli. Uživatele, kteří nejsou zaregistrováni jako uživatelé služby ServiceNow, lze přidat zadáním e-mailové adresy.
Parametry:
Jméno |
Typ |
Stav |
Popis |
user_id |
Řetězec |
Vyžadované |
Parametr sys_id uživatele nebo e-mailová adresa. |
Vrácené hodnoty:
Typ |
Popis |
void |
Metoda nevrací hodnotu |
Příklad:
// Přidání uživatele pro kopii do dohody
var adobe = new x_adosy_as.AdobeSign();
adobe.createAgreement('Moje dohoda');
adobe.addCcUser(current.requested_by);
adobe.addCcUser('abel.tuter@example.com');
#addDocument(String doc_selector, Object merge_data)
Přidá dokument nebo šablonu k aktuální dohodě.
Parametry:
Jméno |
Typ |
Stav |
Popis |
doc_selector |
Řetězec |
Vyžadované |
Název šablony nebo parametr sys_id šablony či přílohy. |
merge_data |
Objekt |
Volitelné |
Objekt typu klíč-hodnota názvů polí dokumentu pro hodnoty polí dokumentu. |
Vrácené hodnoty:
Typ |
Popis |
Řetězec |
V případě úspěšného provedení parametr sys_id vytvořeného záznamu zdrojového dokumentu. |
Příklad:
// Vytvoření dohody pomocí šablony
var template_id = '2a9b1f57db508810257e73278c9619dc';
var adobe = new x_adosy_as.AdobeSign();
adobe.createAgreement('Moje dohoda');
adobe.addDocument(template_id);
#addElectronicSeal(String seal_id)
Přidá elektronickou pečeť k aktuální dohodě.
Parametry:
Jméno |
Typ |
Stav |
Popis |
seal_id |
Řetězec |
Vyžadované |
Parametr sys_id, název nebo ID pečeti elektronické pečeti, která má být přidána. |
Vrácené hodnoty:
Typ |
Popis |
Řetězec | Logická hodnota |
Parametr sys_id nového záznamu účastníka nebo hodnota false, pokud nebyla pečeť nalezena. |
Příklad:
// Přidání elektronické pečeti k dohodě
var adobe = new x_adosy_as.AdobeSign();
adobe.createAgreement('Moje dohoda');
adobe.addElectronicSeal('<SEAL>');
#addParticipant(String user_id, String participant_role)
Alternativní metoda k metodě addSigner(), která umožňuje přidat k dohodě účastníky s určitou rolí. Účastníky, kteří nejsou zaregistrováni jako uživatelé služby ServiceNow, lze přidat zadáním e-mailové adresy.
Poznámka: Tato metoda by měla být používána pouze u existujících záznamů dohod, které jsou uloženy v databázi.
Parametry:
Jméno |
Typ |
Stav |
Popis |
user_id |
Řetězec |
Vyžadované |
Parametr sys_id uživatele nebo e-mailová adresa. |
role |
Řetězec |
Volitelné |
Role účastníka v rámci dohody. Výchozí nastavení je SIGNER. Mezi další hodnoty patří APPROVER, ACCEPTOR, CERTIFIED_RECIPIENT, FORM_FILLER. |
Vrácené hodnoty:
Typ |
Popis |
Řetězec | Logická hodnota |
Parametr sys_id nového záznamu účastníka nebo hodnota false, pokud záznam uživatele nebyl nalezen nebo neměl e-mailovou adresu. |
Příklad:
// Přidání účastníka do dohody
var adobe = new x_adosy_as.AdobeSign();
adobe.createAgreement('Moje dohoda');
adobe.addParticipant('abel.tuter@example.com', 'APPROVER');
#addSigner(String user_id)
Přidání podepisujícího do aktuální dohody. Podepisující, kteří nejsou zaregistrováni jako uživatelé služby ServiceNow, lze přidat zadáním e-mailové adresy.
Parametry:
Jméno |
Typ |
Stav |
Popis |
user_id |
Řetězec |
Vyžadované |
Parametr sys_id uživatele nebo e-mailová adresa. |
Vrácené hodnoty:
Typ |
Popis |
void |
Metoda nevrací hodnotu. |
Příklad:
// Přidání účastníka do dohody
var adobe = new x_adosy_as.AdobeSign();
adobe.createAgreement('Moje dohoda');
adobe.addSigner('abel.tuter@example.com');
#copySignedDocumentToRecord(GlideRecord record)
Zkopíruje podepsaný dokument dohody do jiného záznamu.
Parametry:
Jméno |
Typ |
Stav |
Popis |
nahrát |
GlideRecord |
Vyžadované |
Cílový záznam, do kterého má být zkopírován podepsaný dokument. |
Vrácené hodnoty:
Typ |
Popis |
Řetězec | Logická hodnota |
Parametr sys_id nové přílohy nebo hodnota false, pokud operace selhala. |
Příklad:
// Získání cílového záznamu
var target = new GlideRecord('...');
// Kopírování podepsaného dokumentu z dohody do cíle
var adobe = new x_adosy_as.AdobeSign();
adobe.setAgreementRecord(agreement);
adobe.copySignedDocumentToRecord(target);
#copySignedDocumentToSubject()
Zkopíruje podepsaný dokument dohody do záznamu předmětu.
Vrácené hodnoty:
Typ |
Popis |
Řetězec | Logická hodnota |
Parametr sys_id nové přílohy nebo hodnota false, pokud operace selhala. |
Příklad:
// Kopírování podepsaného dokumentu z dohody do záznamu předmětu
var adobe = new x_adosy_as.AdobeSign();
adobe.setAgreementRecord(agreement);
adobe.copySignedDocumentToSubject();
#createAgreement(String name, GlideRecord subject, Object option
Vytvoří dohodu. Metoda může být použita skripty, které potřebují nastavit novou dohodu.
Parametry:
Jméno |
Typ |
Stav |
Popis |
název |
Řetězec |
Vyžadované |
Název dohody. |
subject |
GlideRecord |
Volitelné |
Záznam předmětu, např. Smlouva nebo Žádost |
options |
Objekt |
Volitelné |
Objekt typu klíč-hodnota názvů polí záznamu dohody k hodnotám. |
Vrácené hodnoty:
Typ |
Popis |
Řetězec | null |
Parametr sys_id nové dohody nebo hodnota null. |
Příklad:
// Vytvoření nové předběžné verze dohody
var options = {
submit_as_draft: true
};
var adobe = new x_adosy_as.AdobeSign();
adobe.createAgreement("Moje dohoda", current, options);
#getAgreement()
Získá aktuálně zahrnutou instanci dohody.
Vrácené hodnoty:
Typ |
Popis |
Dohoda | null |
Instance dohody nebo hodnota null. |
Příklad:
// Získání instance dohody
var adobe = new x_adosy_as.AdobeSign();
adobe.createAgreement("Moje dohoda", current, options);
var agreement = adobe.getAgreement();
#getAgreementRecord()
Vrátí aktuální záznam dohody.
Vrácené hodnoty:
Typ |
Popis |
GlideRecord | null |
Aktuální záznam dohody nebo hodnota null. |
Příklad:
// Získání záznamu dohody
var adobe = new x_adosy_as.AdobeSign();
adobe.createAgreement("Moje dohoda", current, options);
var agreement = adobe.getAgreementRecord();
#saveAgreement(String state)
Uloží aktuální záznam dohody. Volitelně lze předat stav dohody. Pokud není parametr stavu nastaven na hodnotu „Připraveno“, nedojde ke spuštění odesílání do služby Adobe Acrobat Sign.
Parametry:
Jméno |
Typ |
Stav |
Popis |
state |
Řetězec |
Volitelné |
Stav dohody. |
Vrácené hodnoty:
Typ |
Popis |
Řetězec |
Parametr sys_id uloženého záznamu dohody nebo hodnota null. |
Příklad:
// Vytvoření dohody
var adobe = new x_adosy_as.AdobeSign();
adobe.createAgreement('Moje dohoda');
adobe.addSigner('abel.tuter@example.com');
adobe.saveAgreement();
#setAgreementRecord(String|GlideRecord agreement)
Nastaví kontext dohody na daný záznam.
Parametry:
Jméno |
Typ |
Stav |
Popis |
dohoda |
GlideRecord | Řetězec |
Vyžadované |
Záznam dohody. |
Vrácené hodnoty:
Typ |
Popis |
void |
Metoda nevrací hodnotu. |
Příklad:
// Práce na dohodě
var adobe = new x_adosy_as.AdobeSign();
adobe.setAgreementRecord(agreement);
#setSubject(GlideRecord subject
Nastaví záznam předmětu dohody.
Parametry:
Jméno |
Typ |
Stav |
Popis |
subject |
GlideRecord |
Vyžadované |
Záznam předmětu. |
Vrácené hodnoty:
Typ |
Popis |
void |
Metoda nevrací hodnotu. |
Příklad:
// Získání záznamu předmětu
var subject = new GlideRecord('...')
// Aktualizace předmětu dohody
var adobe = new x_adosy_as.AdobeSign();
adobe.setAgreementRecord(agreement);
adobe.setSubject(subject);
adobe.saveAgreement();
#submitAgreement()
Uloží aktuální dohodu a odešle ji do služby Adobe Acrobat Sign nastavením stavu „Připraveno“.
Vrácené hodnoty:
Typ |
Popis |
Řetězec |
Parametr sys_id uloženého záznamu dohody nebo hodnota null. |
Příklad:
// Odeslání dohody
var adobe = new x_adosy_as.AdobeSign();
adobe.setAgreementRecord(agreement);
adobe.submitAgreement();
.canSend()
Určuje, zda může aktuální uživatel použít akci uživatelského rozhraní „Podepsat v aplikaci Adobe Acrobat“. Odeslání je povoleno, pokud instance není FedRAMP nebo pokud má aktuální uživatel roli Odesílatel.
Vrácené hodnoty:
Typ |
Popis |
Booleovský |
Hodnota true, pokud uživatel může odesílat. |
Příklad:
// Kontrola, zda může aktuální uživatel odesílat k podpisu
if(AdobeSign.canSend()) {
gs.addInfoMessage('Tento uživatel může používat proces podepisování.');
} else {
gs.addErrorMessage('Tento uživatel nemá oprávnění používat proces podepisování.');
}
getAgreements(String subject_table, String subject_id)
Získá instanci GlideRecord dohod týkajících se předmětu.
Parametry:
Jméno |
Typ |
Stav |
Popis |
subject_table |
Řetězec | GlideRecord |
Vyžadované |
Název tabulky předmětu nebo samotný záznam předmětu. |
subject_id |
Řetězec |
Volitelné |
Parametr sys_id předmětu při předávání názvu tabulky. |
Vrácené hodnoty:
Typ |
Popis |
GlideRecord |
Instance GlideRecord dohod týkajících se předmětu. |
Příklad:
// Získání dohody pomocí názvu tabulky a parametru sys_id
var agreement = x_adosy_as.AdobeSign.getAgreements('sc_req_item', '<sys_id>');
while (agreement.next()) {
gs.addInfoMessage(agreement.getDisplayValue());
}
// Získání dohody pomocí GlideRecord
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)
Získá instanci GlideRecord dohod patřících uživateli. Tato metoda spoléhá na vlastnost x_adosy_as.my_agreements_query pro počáteční dotaz. Další filtry dotazu lze přidat pomocí parametru query.
Parametry:
Jméno |
Typ |
Stav |
Popis |
|
query |
Řetězec |
Volitelné |
Volitelný zakódovaný dotaz pro další omezení seznamu dohod. |
|
Vrácené hodnoty:
Typ |
Popis |
GlideRecord |
Dohody patřící uživateli. |
Příklad:
// Získání dohod, které jsou pro aktuálního uživatele kompletní
var query = 'state=Complete^ORDERBYsys_created_on';
var agreement = x_adosy_as.AdobeSign.getMyAgreements(query);
while (agreement.next()) {
gs.addInfoMessage(agreement.getDisplayValue());
}
.isFedRamp()
Určuje, zda je systém připojen k Adobe FedRAMP (cloudu pro státní správu).
Vrácené hodnoty:
Typ |
Popis |
Booleovský |
Hodnota true, pokud je vlastnost x_adosy_as.fedramp nastavena na hodnotu „true“. |
Příklad:
// Kontrola, zda používáme připojení FedRAMP
if(x_adosy_as.AdobeSign.isFedRamp()) {
gs.addInfoMessage('Acrobat Sign používá připojení ke cloudu státní správy.');
} else {
gs.addErrorMessage('Acrobat Sign nepoužívá připojení ke cloudu státní správy.');
}
