ServiceNow 向け Adobe Acrobat Sign - インストールおよび設定ガイド(V 2.2)

概要

この ServiceNow 向け Adobe Acrobat Sign アプリケーションを使用すると、ServiceNow プラットフォームのネイティブ機能を使用して、署名用に文書を送信できます。Acrobat Sign と ServiceNow の統合により、次の機能にアクセスできます。

  • 複数の受信者に署名用に文書を送信します。 
  • ライフサイクル全体で署名プロセスを追跡し、各ステージで予想される署名者を特定します。
  • 埋め込まれたか個別の監査追跡文書を含む署名済み文書を取得します。
  • 署名プロセス前または署名プロセス中に文書に入力されたフォームデータを取得します。
  • 最初のレビューとそれ以降の送信のために署名プロセスの下書きを作成します。送信前の署名に対する変更は、ServiceNow に同期されます。
  • 署名プロセス中に電子メール通知を生成して個人に送信します。
  • ServiceNow のローカルファイルまたは外部ソースから署名用文書を入手します。
  • 送信前に ServiceNow レコードのデータを使用して入力可能なフィールドを含む文書テンプレートを使用します。単一のテンプレートを使用して、インシデントまたはサービスリクエストなど、選択されたサブジェクトレコードに基づいてユーザー固有の文書を生成できます。
  • ServiceNow に同期され、送信プロセス中に選択可能な、Acrobat Sign アカウントのライブラリテンプレートを使用します。

ServiceNow 向け Adobe Acrobat Sign - インストールおよびカスタマイズガイド』では、次の手順について説明します。

ServiceNow 向け Acrobat Sign アプリケーションをインストールして設定すると、それを使用して契約書の送信、署名、追跡、管理を行うことができます。詳しくは、『ServiceNow 向け Adobe Acrobat Sign:ユーザーガイド』を参照してください。

ServiceNow 向け Acrobat Sign アプリケーションのインストール

ServiceNow にアプリケーションをインストールできるのは、Adobe Acrobat Sign 管理者および ServiceNow システム管理者(管理者)のみです。  

  1. ServiceNow Store ページに移動し、Adobe Acrobat Sign を検索します。

    servicenow-store-search

  2. 検索結果から Adobe Acrobat Sign を選択し、「取得」を選択します。

    注意:

    アプリケーションのインストール中は、ポップアップブロッカーを無効にします。

    get-sign-app

  3. プロンプトが表示されたら、ServiceNow 管理者の資格情報を使用してログインし、インストール手順に従います。

  4. インストールを確認するには、ServiceNow インスタンスのトップメニューで、すべてシステムアプリケーション会社のアプリケーションを選択してから「インストール済み」タブを選択します。Adobe Acrobat Sign の最新バージョンのリストが表示されます。

    installed-apps

    注意:

    ServiceNow 向け Adobe Acrobat Sign プラグインは、次のドメインで動作するように設定されています。

    • service-now.com
    • servicenowservices.com

    servicenowservices.comGovernment Cloud のお客様向けであり、追加のシステムプロパティ設定が必要です。ドメインが servicenowservices.com ドメイン上にある場合は、システムプロパティ x_adosy_as.oauth_redirect_host を作成して設定し、インスタンスの完全なサブドメイン(例:mydomain.servicenowservices.com)を作成する必要があります。

    セルフサービスメニューに新しい「Adobe Acrobat Sign」オプションが次の 2 つのモジュールと共に表示されます。

    • 署名済み文書 - ログインしたユーザーが依頼者または署名者のいずれかである場合の、完了状態の契約書リストが含まれます。
    • 署名用 – ログインユーザーによる署名待ちの契約書のリストが含まれます。契約書のステータスは「署名用に送信」または「承認用に送信」です。

    注意:セルフサービスメニューは、ロールが署名者(x_adosy_as.adobe_sign_signer)であるユーザーにのみ表示されます。

    menu-acrobat-sign

    すべてのアプリケーションのメニューには「Adobe Acrobat Sign」オプションが含まれます。そこには次のモジュールが含まれています。

    • 署名用に送信 - 契約書を作成および送信するレコードプロデューサーを開きます。
    • 自分の契約書 - ログインしたユーザーが依頼者または署名者である場合の、すべての契約書のリスト。
    • 自分の署名 - ログインしたユーザーが契約書の参加者(署名者)である場合の、レコードの詳細。

    運用

    • 契約書 - 署名プロセスのバックエンドの詳細。  受け取って対応する JSON およびすべての Adobe Acrobat Sign イベントを含みます。
    • ソース文書 - 契約書に追加できる文書を示します。ローカルまたはライブラリの場合があります。
    • 参加者 - 署名プロセスの署名者と詳細。
    • イベント - Adobe Acrobat Sign イベントごとに送受信されるバックエンドの詳細。
    • フォームデータ - 契約書が署名された後に返されたフォームデータを含むテーブル。文書やフィールドデータについての報告に使用できます。

    管理

    • Acrobat Sign に接続 - 有効な Adobe Acrobat Sign アカウントを ServiceNow にリンクできる接続画面。
    • Acrobat Sign グループ - Acrobat Sign グループの名前と ID のリストが含まれます。
    • Acrobat Sign ユーザー - Acrobat Sign ユーザーの詳細が含まれます。
    • e シール -
    • 文書テンプレート - 契約書に追加できるテンプレート化された文書。ローカルまたはライブラリの場合があります。
    • 文書フィールド - テンプレートの文書に埋め込まれているフォームフィールドの詳細。
    • 結合ルール - 文書テンプレートを ServiceNow 内の特定タイプのサブジェクトレコードに関連付けます。
    • 結合フィールド - サブジェクトレコードからのフィールドを関連する文書テンプレート内に含まれているフィールドにリンクするレコード。
    • プロパティ - 署名後 URI リダイレクト、通知、および監査証跡に関する、Adobe Acrobat Sign のデフォルト設定。

    ヘルプとサポート - Adobe Acrobat Sign ヘルプへのリンク。

    注意:
    • 「署名用に送信」、「自分の契約書」、「自分の署名」モジュールは、送信者(x_adosy_as.adobe_sign_sender)ロールを持つユーザーに表示されます。 
    • 運用メニューおよび 管理メニューは、管理者(x_adosy_as.adobe_sign_admin)またはマネージャー(x_adosy_as.adobe_sign_manager)ロールを持つユーザーにのみ表示されます。

    サービスポータルウィジェット

    Adobe Acrobat Sign をお使いのサービスポータルに追加する場合は、URL /adobe_sign でデモを参照できます。

    このポータルは、「x_adosy_as.adobe_sign_sender」および「x_adosy_as.adobe_sign_signer」ロールに制限されています。

    この機能を自分のポータルに追加するには、ウィジェットを複製し、必要に応じてロールを変更します。

    • Adobe Acrobat ダッシュボードの項目リスト - 契約書リストのヘッダーウィジェットによって使用される項目リスト。
    • Adobe Acrobat Sign の署名用に送信 - テンプレートまたはファイルから新しい契約書を作成するためのウィジェット。
    • Adobe Acrobat Sign の契約書リスト — 契約書リストを表示するためのウィジェット。

    サービスポータルページ

    • Adobe Acrobat Sign - Adobe Acrobat Sign ポップアップウィジェットを含んでおり、ServiceNow のレコードから使用して新しい契約書をその場で作成できます。
    • Adobe Acrobat Sign Homepage - アプリケーションに付属するデモサービスポータル用のホームページです。

    アプリケーションには、次の 4 つのロールが付属します。

    • 署名者(x_adosy_as.adobe_sign_signer)
      • ロール x_adosy_as.adobe_sign_signer を持つ ServiceNow ユーザーには、「Adobe Acrobat Sign セルフサービス」モジュールへのアクセス権が与えられます。
      • また、ユーザー「サービスポータルウィジェット」へのアクセス権も付与されます。
      • このロールは、文書/契約書に署名する必要のあるユーザー/グループに追加する必要があります。
    • 送信者(x_adosy_as.adobe_sign_sender)
      • ロール x_adosy_as.adobe_sign_sender を持つ ServiceNow ユーザーには、機能するアプリケーションへのアクセス権が与えられます。
      • このロールは、リクエストした文書/契約書、または署名することが要求されている文書/契約書を追跡できる必要のあるユーザー/グループに追加する必要があります。
    • マネージャー(x_adosy_as.adobe_sign_manager)
      • ロール x_adosy_as.adobe_sign_manager を持つ ServiceNow ユーザーには、Acrobat Sign 機能へのマネージャーレベルのアクセス権が与えられます。
      • マネージャーは、すべての送信者によって作成された契約書を管理できます。
      • このロールは、他のユーザーによって作成された契約書をキャンセルする権限を付与します。
    • 管理者(x_adosy_as.adobe_sign_admin)
      • 「x_adosy_as.adobe_sign_admin」ロールを持つ ServiceNow ユーザーには、すべての機能へのフルアクセス権が与えられます。

    デフォルトで、アプリケーションには、文書に署名できるユーザーに割り当てるべきロールが付属します。文書に署名するアクセス権をすべてのユーザーに付与するには、設定を更新する必要があります。

    警告:

    アプリケーションファイルに行う変更により、今後のアップデートは適用されなくなります。

    アップデートセットに加えられた変更を取得して、その変更をアプリケーションのアップデートの後に再度適用できるようにしてください。

    カスタマイズは本番環境に適用する前に、専用のテスト環境で必ずテストしてください。

Acrobat Sign に接続する

ServiceNow 向け Adobe Acrobat Sign アプリケーションは、コマーシャルとガバメント(FedRAMP)の両方のアカウントで動作するように設計されています。お持ちのアカウントが不明な場合は、コマーシャルクラウドのお客様の手順に従ってください。

コマーシャルクラウドのお客様の場合:

Adobe Acrobat Sign アプリケーションを ServiceNow にインストールしたら、Adobe Acrobat Sign グループまたはアカウント管理者は次の手順に従って、ServiceNow を Adobe Acrobat Sign Commercial Cloud に接続する必要があります。

  1. Adobe Acrobat Sign管理Adobe Acrobat Sign に接続に移動します。

  2. 表示されるダイアログで、「接続」を選択します。

    connect-sign-1

  3. 管理者資格情報を使用して Acrobat Sign アカウントにログインします。

    connect-sign-2

  4. 表示される権限ダイアログで「アクセスを許可」を選択し、権限を付与して接続を確立します。

    connect-sign-3

    注意:

    認証はポップアップ画面で行われます。  認証パネルが表示されない場合は、ポップアップブロッカーが無効になっていることを確認します。

    接続が完了すると、接続されている Acrobat Sign アカウントと、関連付けられている ServiceNow アカウントが確認メッセージに表示されます。

    Commercial Cloud に接続した Acrobat Sign

Government Cloud のお客様の場合:

Adobe Acrobat Sign アプリケーションを ServiceNow にインストールすると、Adobe Acrobat Sign Government Cloud グループまたはアカウント管理者ユーザーは、ServiceNow を Adobe Acrobat Sign Government Cloud に接続できます。

  1. 左のパネルから、Adobe Acrobat Sign管理プロパティを選択します。

    ServiceNow 向け Sign で fedramp を有効にします。

  2. 開いたアプリケーションプロパティページで、以下の操作を実行します。

    1. Adobe Acrobat Sign Government Cloud を使用」トグルを有効にします。
    2. 接続ログインのヒントという名前のプロパティを探し、Adobe Acrobat Sign Government Cloud へのログインに使用する電子メールアドレスに値を設定します。
    3. 保存」を選択します。
  3. Adobe Acrobat Sign/管理/Acrobat Sign に接続に移動します。

  4. 表示されるページで「接続」を選択します。

    fedramp-2

  5. 要求された場合は、Adobe Acrobat Sign Government Cloud アカウントにログインします。

    接続が確立されると、アプリケーションは ServiceNow にリダイレクトし、接続ステータスは自動的に更新されます。

    fedramp-3

ServiceNow 向け Acrobat Sign アプリケーションの設定

アプリケーションプロパティを設定する

アプリケーションのプロパティにアクセスして設定するには、Adobe Acrobat Sign管理プロパティに移動します。

次のデフォルト設定が表示されます。

  • ホスト名 [x_adosy_as.redirect_host]カスタムインスタンス URL がある場合は、OAuth コールバックと API コールバックのリダイレクト URI で使用する完全修飾ホストを指定します(Webhook など)。
    デフォルトではこの値は空で、ホストはシステムプロパティ「glide.servlet.uri」によって保持される値です。
    これは、ServiceNow インスタンスのリダイレクトにのみ適用されます。署名者を署名後に別のホストにリダイレクトする場合は、そのホストを署名者リダイレクト URI(post_sign_uri)プロパティで指定します。
  • デフォルトの署名後 URL [x_adosy_as.post_sign_uri]Acrobat Sign で文書に署名した後にユーザーをリダイレクトするデフォルトの場所です。契約書の作成時に署名後 URI が指定されていない場合に使用します。この URI は、指定したインスタンス名の相対 URI ですが、プロトコル(https://www.adobe.com/ など)を含めることで上書きし、署名後のリダイレクト先を、この ServiceNow インスタンス以外の場所にすることができます。作成した契約書の sys_id は、URL に「{sys_id}」を使用して挿入できます。デフォルト値は「/x_adosy_as_agreement_list.do?sysparm_query=requested_byDYNAMIC90d1921e5f510100a9ad2572f2b477fe%5EORsignersDYNAMIC90d1921e5f510100a9ad2572f2b477fe%5Estate=Complete%5EORDERBYDESCsys_created_on」で、ユーザーは完成した契約書のリストに移動します。
  • 署名者のリダイレクト遅延 [x_adosy_as.post_sign_delay]Acrobat Sign でユーザーが文書に署名した後にリダイレクトされるまでの遅延(秒)です。初期設定値は 3 です。
  • クリックジャッキング防衛 [x_adosy_as.clickjacking_domains]署名用に送信した文書が iframe 内に含まれる場合がある親ドメイン URL のコンマ区切りリストを指定します(例:service-now.com)。
    Government Cloud のお客様にはこれが必要です。このフィールドを空白のままにすると、フレーム内に Acrobat Sign が表示される場合にページが空白になることがあります。
  • Acrobat Sign からのメールを許可 [x_adosy_as.send_adobe_sign_emails]署名プロセス中に Acrobat Sign から通知電子メールを送信するかどうかを制御します。デフォルト値は false です。
  • 下書き契約書のポップアウト [x_adosy_as.popout_draft]デフォルトでは、契約書の「詳細を確認」ボタンをクリックすると、同じブラウザーウィンドウの Acrobat Sign で下書きが開きます。
    その代わりに新しいウィンドウを開くには、このオプションを true に設定します。デフォルト値は false です。
  • 監査を含める [x_adosy_as.include_audit]署名済み文書に含まれる監査証跡を制御します。デフォルト値は true です。
  • Adobe Acrobat Sign Government Cloud を使用 [x_adosy_as.fedramp]Adobe Government Cloud のお客様は、ServiceNow 向け Acrobat Sign で Acrobat Sign Government Cloud サービスを使用するには、このプロパティを有効にする必要があります。デフォルト値は false です。
  • 接続ログインのヒント [x_adosy_as.login_hint]Adobe Acrobat Sign Government Cloud への初回接続時に使用する login_hint 値です。「Acrobat Sign に接続」ページには情報が自動入力され、通常はアカウント管理者の電子メールになります。デフォルト値は空白です。
  • 契約アクティビティフォーマッターフィールド [glide.ui.x_adosy_as_agreement_activity.fields]契約書レコードに表示されるアクティビティの形式に表示するフィールドを設定します。
    デフォルト値は「name, state, status,agreement_id,compose_url,post_sign_uri,etag」です。
  • 自分の契約書クエリ [x_adosy_as.my_agreements_query]ポータルなどの場所で契約書を表示する際に使用するクエリ。 デフォルト値は「requested_byDYNAMIC90d1921e5f510100a9ad2572f2b477fe^ORsignersDYNAMIC90d1921e5f510100a9ad2572f2b477fe」で、ユーザーが依頼者または署名者である契約書を返します。
  • マルチパートファイル拡張子 [x_adosy_as.multipart_extension]一時的な Multipart 添付ファイルのファイル名拡張子。デフォルト(推奨)値は「mpfd」です。
  • アプリケーションログ [x_adosy_as.logging.verbosity]システムログを制御します。デフォルト値は「info」です。
  • 接続のデバッグ [x_adosy_as.connect_debug]Acrobat Sign への接続時に診断アラートを表示します。デフォルト値は false です。

デフォルトのリダイレクト URL プロパティは、「署名後 URI」フィールドの値が設定されていない契約書に適用されます。

注意:

リダイレクト URL では、エンコードされていない特殊文字やスペースはサポートされていません。したがって、アプリケーションプロパティ内の「デフォルトの署名後 URL」にキャレット記号(^)が含まれている場合は、%5E としてエンコードする必要があります。

例:/x_adosy_as_agreement_list.do?sysparm_query=requested_byDYNAMIC90d1921e5f510100a9ad2572f2b477fe^ORsignersDYNAMIC90d1921e5f510100a9ad2572f2b477fe^state=Complete^ORDERBYDESCsys_created_on は次の値に変更する必要があります。

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

残りのプロパティは、署名プロセス中に Acrobat Sign によって通知が送信されるかどうか(デフォルト = いいえ)、および監査証跡が署名済み文書に付属するかどうか(デフォルト = はい)を管理します。

カスタムコンポーネントを設定する

Adobe Acrobat Sign アプリケーションには、必要に応じて設定できるカスタムコンポーネントが含まれています。各コンポーネントの変更方法については、以下のコンポーネントのリストを参照してください。

「Adobe Acrobat で署名」は、タスク [task] テーブルの UI アクションボタンです。送信者ロール(x_adosy_as.adobe_sign_sender)を持つユーザーのみがこれにアクセスできます。送信者は文書と署名者を契約書に追加し、添付文書を署名用に Adobe Acrobat Sign に送信できます。

ui-action-1

システム管理者は、次のように、「Adobe Acrobat で署名」アクションを他のテーブルに追加できます。

  1. 次の 2 つの方法のいずれかに従い、既存の「Adobe Acrobat で署名」アクションを開きます。
    • タスク(インシデントなど)から拡張したフォームで右クリックし、「UI アクションの設定」を選択します。
    • システム定義UI アクションに移動して、「Adobe Acrobat で署名」を探します。
  2. 必要に応じて、テーブル名を変更します。
  3. 上部のアクションバーで右クリックし、「挿入と維持」を選択して、新しいテーブルとともに既存レコードのコピーを作成します。

Adobe Acrobat Sign 関連リストには、リストが設定されたレコードに関連する契約書が表示されます。この関連リストでは、ユーザーロール(x_adosy_as.adobe_sign_user)を持つユーザー、つまり契約書の依頼者または署名者にのみ契約書が表示されます。

「personalize_form」ロールを持つシステム管理者またはユーザーは、フォームおよび関連リストのレイアウトを設定できます。

関連リストをフォームに追加するには:

  1. 関連するフォームで右クリックし、設定/関連リストに移動します。
  2. 利用可能リストから Adobe Acrobat Sign を選択します。
  3. 右矢印を選択して、それを選択済みリストに追加します。
  4. 保存」を選択します。

設定しているフォームに戻り、フォームの下部に「Adobe Acrobat Sign」関連リストが表示されます。

related-list-3

サービスポータルコンポーネントを設定する

ServiceNow 向け Acrobat Sign アプリケーションには、次の Service Portal 要素が付属しています。これは、独自の Service Portal で使用またはコピーできます。

アプリケーションに含まれる Adobe Acrobat Sign Service Portal は、使用または拡張を意図していません。サポートされるのは、署名用に送信インターフェイスのみです。

ポータルには、/adobe_sign からアクセスできます。

アプリケーションには、次の 2 つの Service Portal ページが含まれています。

  • Adobe Acrobat Sign(x_adosy_as_send)
  • Adobe Acrobat Sign Homepage(x_adosy_as_home)

Adobe Acrobat Sign(x_adosy_as_send)ページは、署名用に送信インターフェイス専用であり、変更はできません。

Adobe Sign Homepage(x_adosy_as_home)は、Service Portal ホームページとして指定し、含まれるウィジェットの例を示すために使用します。

必要に応じて、アプリケーションに含まれるウィジェットを使用できます。ウィジェットの変更を追跡し、アプリケーションから更新を取得するには、ウィジェットの複製でのみ変更を行う必要があります。

  • Adobe Acrobat Sign の署名用に送信:テンプレートやアップロードされたファイルから契約書を作成するために使用します。署名用に送信メニュー項目と Adobe Acrobat で署名 UI アクションによってアクセスし、ロールが送信者であるユーザーが使用できます。

ウィジェットのオプション:ウィジェットは、必要に応じてウィジェットインスタンスのオプションまたは URL パラメーターを使用してカスタマイズするように設計されています。フォームデータを自動的に入力するには、文書テンプレートと結合ルールを使用します。URL パラメーターを使用する際に、ブール値オプションを「true」または「1」に設定できます。

名前

タイプ

説明

subject_table

文字列

契約書が属するテーブルの名前。

subject_id

文字列

契約書が属するレコードの sys_id。

agreement_name

文字列

新しい契約書の名前。

attachments

文字列

契約書で使用する添付ファイル sys_id のリスト。

テンプレート

文字列

契約書で使用する文書テンプレート sys_id のリスト。

signers

文字列

署名者として追加するユーザーまたは電子メールアドレスのリスト。

ccs

文字列

CC エントリとして追加するユーザーまたは電子メールアドレスのリスト。

password_protect

ブール値

契約書を保護するため、パスワードの設定をユーザーに求めます。hide_options または lock_options が true の場合でも、ユーザーはパスワードを設定する必要があります。

send_emails

ブール値

Adobe が署名プロセス中に電子メール通知を送信するように設定します。

submit_as_draft

ブール値

直ちに署名用に送信するのではなく、下書き契約書を作成します。

copy_to_subject

ブール値

署名済みの契約書ファイルをサブジェクトレコードにコピーします。有効な subject_table と subject_id を指定する必要があります。

post_sign_uri

文字列

署名者が署名を完了したときのカスタムのリダイレクトを指定します。デフォルトのリダイレクトでは、ユーザーは契約書レコードに送られます。

hide_options

文字列

非表示にするオプションのコンマ区切りリスト(password_protect、send_emails、submit_as_draft、copy_to_subject)。true に設定すると、ユーザーに対してすべてのオプションが非表示になります。

lock_options

文字列

読み取り専用にするオプションのコンマ区切りリスト(password_protect、send_emails、submit_as_draft、copy_to_subject)。すべてのオプションがユーザーによって変更されないようにするには、true に設定します。

hide_subject

ブール値

サブジェクトの添付ファイルが選択されないようにします。

skip_documents

ブール値

最初の文書パネルをスキップします。添付ファイルまたはテンプレートが事前に選択されている場合にのみ、これは適用されます。

  • Adobe Acrobat ダッシュボードの項目リスト:従業員または顧客サービスポータルに、署名する必要がある現在の契約書のリストを追加するために使用できます。このリストは、Adobe Sign Homepage の To-Do 機能で使用します。
    このリストに表示されるレコードにアクセスするには、セルフサービス/Adobe Acrobat Sign/署名用に移動します。
  • Adobe Acrobat Sign ヘッダー:Adobe Sign Homepage で To-Do 機能の紹介に使用します。
ウィジェット

文書テンプレートを作成

文書テンプレートは、契約書に含めるように選択できるテンプレートを定義します。  テンプレートを使用すると、標準的な文書を提供できます。これは、多くの個々の契約書で再利用できます。「ソース文書」レコードは、関連する契約書でそのテンプレートの機能を使用できるようにするテンプレートを参照します。

テンプレートは、ServiceNow インスタンスに対してローカルである場合もあれば、接続されている Adobe Acrobat Sign アカウントから詳細を同期されているライブラリテンプレートである場合もあります。

ライブラリテンプレートの同期

アプリケーションのインストールと設定が完了したら、管理者はライブラリテンプレートを同期できます。Adobe Acrobat Sign ライブラリテンプレートは、Acrobat Sign アカウント内で定義され、その詳細は ServiceNow に同期されます。  ライブラリテンプレートを定義している文書は、接続されている Acrobat Sign アカウントにも保存されるため、送信にアップロードを必要としません。

ライブラリテンプレートを ServiceNow に同期するには:

  1. Adobe Acrobat Sign/管理/文書テンプレートに移動します。
  2. ライブラリを更新」を選択します。

これにより、接続されている Acrobat Sign アカウントからライブラリテンプレートのリストビューが更新されます。

refresh-library

ローカルテンプレートの作成

ローカルテンプレートを定義している文書は、添付レコードとして ServiceNow 内に保持されます。またこれは、送信プロセスの一環として Acrobat Sign にアップロードされる必要があります。

テンプレートの文書には、契約書のサブジェクトレコードのデータを使用して事前入力する必要があるフォームフィールドが含まれている場合と含まれていない場合があります。文書にこのようなフォームフィールドが含まれている場合は、テンプレートを使用する必要があります。

  1. Acrobat Sign/管理/文書テンプレートに移動します。
  2. 新規」を選択します。
  3. テンプレートの新規レコードページで、次の操作を行います。
    1. テンプレートに名前を付けます。
    2. 「タイプ」を「ローカル」に設定します。
    3. 右クリックし、「保存」を選択します。
  4. 文書をテンプレートに関連付けるには、ファイルを選択してテンプレートレコードにドラッグするか、ヘッダーのクリップアイコンを選択してファイルを選択します。ファイルを追加したら、「X」アイコンを選択してダイアログを閉じます。

文書は文書テンプレートに添付され、「文書」フィールドで参照されます。

create-template-without-field-1

create-template-without-field-2

create-template-without-field-3

フィールドを使用しないテンプレートの作成で説明したものと同じ手順に従う必要があります。ただし、文書を関連付けたら、必要に応じて次の追加の設定手順を実行する必要があります。

  • 「入力可能」フィールドが true に設定されていることを確認します。 

入力可能なフィールドを含む文書がテンプレートに関連付けられると、これは自動的にチェックされます。

  • 文書フィールドレコードを作成します。

親文書テンプレートの文書フィールドレコードを作成し、テンプレートの文書内に埋め込むフォームフィールドの詳細を定義する必要があります。

これを行うには、文書テンプレートレコードを保存し、「フィールドを更新」を選択します。

「文書フィールド」関連リストには、添付された文書の入力可能なフォームフィールドに対応するレコードが入力されます。

create-template-with-fields

  • 結合ルールの設定

結合ルールは、文書テンプレートを ServiceNow 内の特定タイプのサブジェクトレコードと関連付けます。

1 つの文書テンプレートに複数の結合ルールをリンクできます(テンプレートのフィールドに事前に入力するために使用された、サブジェクトレコードのタイプごとに 1 つ)。

例えば、テンプレートはインシデント、サービスリクエスト、または変更リスエストレコードからのデータを使用して入力される場合があります(この場合、テンプレートには、3 つの結合ルールがあります。サブジェクトテーブルごとに 1 つです)。

結合ルールを設定するには:

  1. 結合ルール関連リストに移動します。
  2. 新規」を選択します。
  3. テーブルを選択します(例:インシデント)。
  4. 右クリックして「保存」を選択します。
merge-rule

  • 結合フィールドの設定

結合フィールドレコードは、サブジェクトレコードからのフィールドを関連する文書テンプレート内に含まれているフィールドにリンクします。結合フィールドは、結合ルールを設定するときに手動で作成する必要があります。

結合フィールドレコードを作成するには:

  1. Adobe Acrobat Sign/管理/結合ルールに移動します。
  2. 結合ルールレコードで、「フィールドを更新」を選択します。
    「結合フィールド」埋め込みリストに文書フィールドが入力されます。
  3. 関連する文書フィールドを対応するレコードフィールドにリンクするには、マッピングする文書フィールド(名前など)の対応するレコードフィールドへのリンクを選択します。
  4. 関連するレコードフィールド(呼び出し元など)をドロップダウンメニューから選択します。
  5. アップデート」を選択します。

結合ルールレコードにリダイレクトされます。結合フィールド」関連リストに、前の手順で選択されたレコードフィールドの値が格納されました。

見やすくするため、マッピングされない残りの結合フィールドを削除(および確認)して、結合フィールドの埋め込みリストにマッピングされる値のみが格納されるようにします。

merge-fields-1

サービスカタログアイテムの作成

ServiceNow 向け Acrobat Sign では、レコードプロデューサーを作成することで、サービスカタログからアクセスできる新しい契約書を作成できます。文書に結合するデータを収集し、契約書を自動的に作成してユーザーに送信するようにレコードプロデューサーを設定できます。 

catalog_admin または admin のユーザーはカタログアイテムを作成できます。次の手順では、レコードプロデューサーというカタログアイテムの作成方法について説明します。他のカタログアイテムの作成に、この手順を再現することができます。

注意:インスタンスの設定時には、Adobe Acrobat Sign アプリケーションが選択されていないことを確認します。

各レコードプロデューサーの作成プロセスは、文書フィールド、テンプレート、変数などの特定の要件に応じて異なる場合がありますが、同じ原則が適用されます。  このガイドの例では、駐車許可に関する契約書の作成方法を示します。 

レコードプロデューサーを作成するには:

  1. サービスカタログカタログ定義レコードプロデューサーに移動し、「新規」を選択します。

  2. 表示される新規レコードプロデューサーページで、次のように操作します。

    1. レコードに名前を付けます。
    2. テーブル名を「契約書」に設定します(x_adosy_as_agreement)。
    3. 短い説明を入力します。
    4. リダイレクト先」フィールドを「生成されたタスクレコード」に設定します。
    タスクレコードの生成

  3. アクセシビリティ」タブを選択し、カタログカテゴリ可用性のフィールドを必要に応じて設定します。次に、ヘッダーバーを右クリックし、「保存」を選択します。

    これらのフィールドは、「カテゴリ」および「カタログ」関連リストを使用して設定できます。 

    「アクセシビリティ」タブ

  4. 「変数」関連リストを使用し、必要に応じて文書フィールドに一致する変数を追加します。

    この例では、名前、従業員、管理者の各フィールドを追加します。

    「Variables」タブ

    注意:

    「Permit name」質問変数のデフォルト値は、‘javascript:'Parking Permit for ' + gs.getUserDisplayName()’ です。

  5. 変数を取得し、署名用に送信する契約書を作成するレコードプロデューサースクリプトを設定します。「スクリプト」フィールドでは、次を行います。

    1. カタログアイテムの変数を読み取る、以下のスクリプトをコピーして貼り付けます。
    2. 変数の定義を更新して、プロデューサーから情報を収集します。
    3. 使用している文書テンプレート sys_id を 更新します。
    4. ユーザーを署名後に別の場所に移動させる場合は、post_sign_uri を更新します。

     

    // Example Adobe Acrobat Sign Record Producer for a Parking Permit template

    (function() {

      // Collect the information that we need from the variables filled in by the user

      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;

      // Hardcoded sys_id of the Document Template being used

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

      // Setup the data to merge with the Document Template above.

      // Each property is the name of a Document Field we want to map to.

      var merge_data = {

        name         : agreement_name,

        employeename : employee_name,

        managername  : manager_name,

      };

      // Setup the new Agreement

      var agreement = new x_adosy_as.Agreement(current);

     

      // Add the documents we want to have signed

      agreement.addDocument(document_template, merge_data);

      // Add the signers

      agreement.addSigner(employee_id);

      agreement.addSigner(manager_id);

      // Set the agreement name

      current.name = agreement_name;

      // Set the URL that signers will be redirected to after signing

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

      // Set the state to 'Ready' to immediately send for signature

      current.state = 'Ready';

    })();

ワークフローアクティビティからの契約書の作成

既存のカタログアイテムに署名用の文書を追加するには、契約書を生成するタスク、および署名用にユーザーに割り当てるカタログタスクをワークフローに追加します。

次の例は、Acrobat Sign アプリケーションの使用方法を示していますが、設定手順の具体的な詳細は、プロセスの要件に応じて異なる場合があります。

ワークフローアクティビティから契約書を作成するには、次のコンポーネントを設定する必要があります。

  • カタログタスク:契約書を作成して署名用に送信し、タスクを署名者に割り当てます。
  • スクリプトアクション:契約書が署名されたときに発生するイベントに反応し、タスクを閉じてフィードバックループを提供し、ワークフローを先に進めます。

カタログタスクを作成するには:

  1. ワークフローエディターで「コア」タブを選択します。
  2. コアアクティビティ/タスクに移動し、カタログタスクアクティビティをワークフローの適切な場所にドラッグします。
  3. タスクに名前を付けて優先度を設定します。
  4. 完了を待機」を true に設定します。
  5. 「スクリプト」セクションで詳細フラグを true に設定し、「高度なスクリプト」フィールドにコードを書き込みます。コード例を以下に示します。
  6. アップデート」を選択します。
ワークフローアクティビティから契約書を作成します。

// Example task workflow activity creation

(function () {

  // The user who needs to sign the Agreement

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

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

  // The name of the Agreement

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

  // Hardcoded sys_id of the Adobe Sign Document template for this action

  // This should really be a workflow variable to data-drive it.

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

  // set the GUID without calling newRecord() - needed for the agreement subject

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

  // Setup the task

  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).';

  // Agreement options (fields on the agreement record)

  var options = {

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

  };

  // Create an object to assist with the signing process

  var adobe = new x_adosy_as.AdobeSign();

  // Create the agreement and provide the task record as the subject

  adobe.createAgreement(agreement_name, task, options);

  // Add the document template.

  adobe.addDocument(document_template);

  // Add the signers.This could be user sys_ids or email addresses.

  adobe.addSigner(signer_id);

  // Submit the agreement to Adobe.

  adobe.submitAgreement();

})();

スクリプトアクションを設定し、契約書が完成したときにカタログタスクを自動的にクローズ済み完了状態に設定できるようになりました。契約書テーブルの x_adosy_as.agreement.complete イベントによってトリガーされるスクリプトアクションを設定する必要があります。

新しいスクリプトアクションを作成するには:

  1. システムポリシー/イベント/スクリプトアクションに移動して「新規」をクリックします。
  2. 新しいスクリプトアクションページで、次の操作を行います。
    1. スクリプトアクションに名前を付けます。
    2. イベント名を x_adosy_as.agreement.complete に設定します。
    3. アクティブ」チェックボックスをオンにします。
    4. 「スクリプト」フィールドで、次の「スクリプトアクション:サンプルコード」のスクリプトをコピーして貼り付けます。
  3. ヘッダーバーを右クリックし、「保存」を選択します。
worflow-actitivty-script-action

スクリプトアクション:サンプルコード

// Script Action to set the catalog task state to Close Complete

(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 を使用する

上記のカスタムコンポーネントで説明したように、Acrobat Sign をタスクベースのレコード以外のレコードと共に使用できます。以下の手順は、契約書管理に Acrobat Sign を使用する方法を示しています。設定手順の具体的な詳細は、プロセスの要件によって異なる場合があります。

Acrobat Sign を契約書管理に使用するには、次の 2 つのコンポーネントを設定する必要があります。

  • UI アクション契約書を作成し、署名用に送信します。  契約書が署名されると、イベントが発生します。
  • スクリプトアクションイベントに反応し、フィードバックループ(プロセスを進行し、契約を更新します)を提供します。

注意:「ui_action_admin」または「admin」ロールを持つユーザーのみが UI アクションを定義できます。管理者ロールのユーザーは、スクリプトアクションのみを定義できます。

UI アクションの作成

「Contract [ast_contract]」フォームに UI アクションを作成するには

  1. システム定義UI アクションに移動し、「新規」を選択します。

    または、Contract [ast_contract] フォームで右クリックし、設定/UI アクション/新規を選択します。

  2. UI アクションの新規レコードページで、次の詳細を入力します。

    1. テーブルが「Contract [ast_contract]」であることを確認します。
    2. 「名前」フィールドで、レコードの名前を入力します。
    3. テーブルドロップダウンメニューから、テーブルを選択します。
    4. 「順序」に順序を入力します。
    5. アクティブ」チェックボックスをオンにします。
    6. 挿入を表示」チェックボックスをオンにします。
    7. 更新を表示」チェックボックスをオンにします。
    8. フォームボタン」チェックボックスをオンにします。
    9. 完了したら、上部のバーを右クリックし、「保存」を選択します。

    フォームが保存されてリロードされます。

    ui-action-new-record

  3. 条件」フィールドで、UI アクションを表示する条件を入力します。

    現在の例では、‘current.state == 'draft' andand current.substate == 'under_review' andand !current.approver.nil()’ という条件を選択します。

    条件

  4. スクリプト」フィールドに、契約書レコードの作成、特定のフィールド値の設定、Adobe Acrobat Sign への送信を行うコードを入力します(以下のコード例を参照)。

    入力するコードは、具体的な要件に基づいて異なる場合がありますが、一般原則が適用されます。

    注意:

    文書テンプレートのハードコーディングされた sys_id とは、この例で使用するテンプレートを指します。

    ここでは、ご自身で作成するテンプレートになります(テンプレートの作成について詳しくは、「ローカルテンプレートの作成」を参照してください)。

    // Example UI Action for create a new Adobe Acrobat Sign Agreement

    (function() {

      // The name of the Agreement

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

      // Hardcoded sys_id of the Document Template for this action

      var document_template = '6d0cdc26db708c50257e73278c9619c4'; // Contract

      // Create an object to assist with the signing process

      var adobe = new x_adosy_as.AdobeSign();

      // Create the agreement and provide the current record as the subject

      adobe.createAgreement(agreement_name, current);

      // Add the document template.This could also be an attachment sys_id.

      adobe.addDocument(document_template);

      // Add the signers.This could be user sys_ids or email addresses.

      adobe.addSigner(current.approver);

      // Submit the agreement to Adobe.

      adobe.submitAgreement();

      // Redirect the user back to this record.

      action.setRedirectURL(current);

    })();

スクリプトアクションの作成

スクリプトアクションはイベントのみでトリガーできます。スクリプトアクションは、Adobe Acrobat Sign に付属する契約書テーブルのイベントのいずれかによってトリガーされるように設定されます。x_adosy_as.agreement.complete

新しいスクリプトアクションを作成するには:

  1. システムポリシーイベントスクリプトアクションに移動します。

  2. 新規」を選択します。

  3. スクリプトアクションの新規レコードページで、次の操作を実行します。

    1. スクリプトの名前を入力します
    2. スクリプトアクションをトリガーするイベント名を選択します。
    3. アクティブ」チェックボックスをオンにします。
    4. コードを記述します。以下のコード例を参照してください。
    スクリプトアクションに名前を付けます。

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

    このコードでは、現在の契約書の subject_id フィールドから契約を取得し、契約テーブルで有効なレコードであることを確認します。そうである場合は、状態を「アクティブ」に変更し、更新します。

  4. 送信」を選択します。

スクリプト API を使用する

内部 API を使用して、任意のプロセスで動作するように Adobe Acrobat Sign アプリケーションを簡単に拡張できます。 API には x_adosy_as 名前空間を通じてアクセスできます。

AdobeSign()

AdobeSign インスタンスを作成します。

例:

// Create a new instance of AdobeSign

var adobe = new x_adosy_as.AdobeSign();

 #addCcUser(String user_id)

関与しないユーザーと共有するため、CC エントリを現在の契約書に追加します。ServiceNow ユーザーとして登録されていないユーザーは、電子メールアドレスを指定することで追加できます。

パラメーター:

名前

タイプ

ステータス

説明

user_id

文字列

必須

ユーザーの sys_id または電子メールアドレス。

戻り値:

タイプ

説明

void

メソッドは値を返しません

例:

// Add a CC user to the agreement

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)

現在の契約書に文書またはテンプレートを追加します。

パラメーター:

名前

タイプ

ステータス

説明

doc_selector

文字列

必須

テンプレートの名前、またはテンプレートか添付ファイルの sys_id。

merge_data

オブジェクト

オプション

文書フィールド名と文書フィールドの値の key-value オブジェクト。

戻り値:

タイプ

説明

文字列

正常な場合は、作成されたソース文書レコードの sys_id。

例:

// Create an agreement with a template

var template_id = '2a9b1f57db508810257e73278c9619dc';

var adobe = new x_adosy_as.AdobeSign();

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

#addElectronicSeal(String seal_id)

現在の契約書に e シールを追加します。

パラメーター:

名前

タイプ

ステータス

説明

seal_id

文字列

必須

追加する e シールの sys_id、名前、シール ID のいずれか。

戻り値:

タイプ

説明

String|Boolean

新規参加者レコードの sys_id。シールが見つからなかった場合は false。

例:

// Add an electronic seal to the agreement

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement('My Agreement');

adobe.addElectronicSeal('<SEAL>');

 #addParticipant(String user_id, String participant_role)

addSigner() の代わりの方法では、指定したロールを持つ参加者を契約書に追加できます。ServiceNow ユーザーとして登録されていない参加者は、メールアドレスを指定することで追加できます。

注意:この方法は、データベースに保存されている既存の契約書レコードでのみ使用してください。

パラメーター:

名前

タイプ

ステータス

説明

user_id

文字列

必須

ユーザーの sys_id または電子メールアドレス。

role

文字列

オプション

契約書内の参加者のロール。デフォルトは SIGNER です。その他の値には、APPROVER、ACCEPTOR、CERTIFIED_RECIPIENT、FORM_FILLER が含まれます。

戻り値:

タイプ

説明

String|Boolean

新しい参加者レコードの sys_id。ユーザーレコードが見つからなかったか、電子メールアドレスがなかった場合は false。

例:

// Add a participant to the agreement

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement('My Agreement');

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

#addSigner(String user_id)

現在の契約書に署名者を追加します。ServiceNow ユーザーとして登録されていない署名者は、電子メールアドレスを指定することで追加できます。

パラメーター:

名前

タイプ

ステータス

説明

user_id

文字列

必須

ユーザーの sys_id または電子メールアドレス。

戻り値:

タイプ

説明

void

このメソッドは値を返しません。

例:

// Add a participant to the agreement

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement('My Agreement');

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

#copySignedDocumentToRecord(GlideRecord record)

契約書の署名済み文書を別のレコードにコピーします。

パラメーター:

名前

タイプ

ステータス

説明

record

GlideRecord

必須

署名済み文書のコピー先の対象レコード。

戻り値:

タイプ

説明

String|Boolean

新しい添付ファイルの sys_id。操作に失敗した場合は false。

例:

// Get the target record

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

// Copy the signed document from the agreement to the target
var adobe = new x_adosy_as.AdobeSign();

adobe.setAgreementRecord(agreement);

adobe.copySignedDocumentToRecord(target);

#copySignedDocumentToSubject()

契約書の署名済み文書をサブジェクトレコードにコピーします。

戻り値:

タイプ

説明

String|Boolean

新しい添付ファイルの sys_id。操作に失敗した場合は false。

例:

// Copy the signed document from the agreement to the subject record
var adobe = new x_adosy_as.AdobeSign();

adobe.setAgreementRecord(agreement);

adobe.copySignedDocumentToSubject();

#createAgreement(String name, GlideRecord subject, Object option

契約書を作成します。新しい契約書を設定する必要があるスクリプトで使用できます。

パラメーター:

名前

タイプ

ステータス

説明

name

文字列

必須

契約書名。

件名

GlideRecord

オプション

サブジェクトレコード(契約書、リクエストなど)

options

オブジェクト

オプション

契約書レコードのフィールド名と値の key-value オブジェクト。

戻り値:

タイプ

説明

String|null

新しい契約書の sys_id または null。

例:

// Create a new draft agreement

var options = {

  submit_as_draft: true

};

var adobe = new x_adosy_as.AdobeSign();

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

#getAgreement()

現在範囲内にある契約書インスタンスを取得します。

戻り値:

タイプ

説明

Agreement|null

契約書インスタンスまたは null。

例:

// Get the agreement instance

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

#getAgreementRecord()

現在の契約書レコードを返します。

戻り値:

タイプ

説明

GlideRecord|null

現在の契約書レコードまたは null。

例:

// Get the agreement record

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

#saveAgreement(String state)

現在の契約書レコードを保存します。契約書の状態は、オプションで渡すことができます。state パラメーターが「Ready」に設定されていない限り、Adobe Acrobat Sign への送信はトリガーされません。

パラメーター:

名前

タイプ

ステータス

説明

state

文字列

オプション

契約書の状態。

戻り値:

タイプ

説明

文字列

保存された契約レコードの sys_id または null。

例:

// Create an agreement

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement('My Agreement');

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

adobe.saveAgreement();

#setAgreementRecord(String|GlideRecord agreement)

指定されたレコードに契約書コンテキストを設定します。

パラメーター:

名前

タイプ

ステータス

説明

までの

GlideRecord|String

必須

契約書レコード。

戻り値:

タイプ

説明

void

このメソッドは値を返しません。

例:

// Work on an agreement

var adobe = new x_adosy_as.AdobeSign();

adobe.setAgreementRecord(agreement);

#setSubject(GlideRecord subject

契約書のサブジェクトレコードを設定します。

パラメーター:

名前

タイプ

ステータス

説明

件名

GlideRecord

必須

サブジェクトレコード。

戻り値:

タイプ

説明

void

このメソッドは値を返しません。

例:

// Get a subject record
var subject = new GlideRecord('...')

// Update the subject of an agreement

var adobe = new x_adosy_as.AdobeSign();

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

#submitAgreement()

現在の契約書を保存し、状態を「準備完了」に設定して Adobe Acrobat Sign に送信します。

戻り値:

タイプ

説明

文字列

保存された契約レコードの sys_id または null。

例:

// Submit an agreement

var adobe = new x_adosy_as.AdobeSign();

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

.canSend()

現在のユーザーが「Adobe Acrobat で署名」UI アクションを使用できるかどうかを指定します。インスタンスが FedRAMP でない場合、または現在のユーザーが Sender ロールを持っている場合は、送信が許可されます。

戻り値:

タイプ

説明

ブール値

ユーザーが送信できる場合は true。

例:

// Check if the current user can send for signature

if(AdobeSign.canSend()) {

  gs.addInfoMessage('This user can use the sign process.');

} else {

  gs.addErrorMessage('This user does not have permission to use the sign process.');

}

getAgreements(String subject_table, String subject_id)

サブジェクトに関連する契約書の GlideRecord インスタンスを取得します。

パラメーター:

名前

タイプ

ステータス

説明

subject_table

String|GlideRecord

必須

サブジェクトテーブル名またはサブジェクトレコード自体。

subject_id

文字列

オプション

テーブル名も渡す際のサブジェクトの sys_id。

戻り値:

タイプ

説明

GlideRecord

サブジェクトに関連する契約書の GlideRecord インスタンス。

例:

// Get agreements using the table name and sys_id

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

while (agreement.next()) {

  gs.addInfoMessage(agreement.getDisplayValue());

}

// Get agreements using a 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)

ユーザーに属する契約書の GlideRecord インスタンスを取得します。このメソッドは、最初のクエリの x_adosy_as.my_agreements_query プロパティに依存します。クエリパラメーターを使用して、追加のクエリフィルターを追加できます。

パラメーター:

名前

タイプ

ステータス

説明

query

文字列

オプション

契約書リストをさらに制限するためのオプションのエンコード済みクエリ。

         

戻り値:

タイプ

説明

GlideRecord

ユーザーに属する契約書。

例:

// Get agreements that are complete for the current user
var query = 'state=Complete^ORDERBYsys_created_on';

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

while (agreement.next()) {

  gs.addInfoMessage(agreement.getDisplayValue());

}

.isFedRamp()

システムが Adobe FedRAMP(Government Cloud)に接続されているかどうかを判別します。

戻り値:

タイプ

説明

ブール値

x_adosy_as.fedramp プロパティが「true」に設定されている場合は true。

例:

// Check if we are using a FedRAMP connection

if(x_adosy_as.AdobeSign.isFedRamp()) {

  gs.addInfoMessage('Acrobat Sign is using a government cloud connection.');

} else {

  gs.addErrorMessage('Acrobat Sign is not using a government cloud connection.');

}

ヘルプをすばやく簡単に入手

新規ユーザーの場合

Adobe MAX 2025

Adobe MAX Japan
クリエイターの祭典

2025 年 2 月 13 日
東京ビッグサイト