Docusign eSignature スポーク

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：16分

    • Docusign eSignature を使用してデジタル署名用にドキュメントを個人または受信者のリストに送信するプロセスを自動化します。たとえば、従業員のオンボーディングと退職、機密保持契約、法務契約、作業指示書の送信を自動化します。ドキュメントテンプレートで ServiceNow データを使用し、ユーザーが必要に応じて署名用のドキュメントをアップロードできるようにします。

    ストアでアプリを要求する

    ServiceNow Store Web サイトにアクセスして利用可能なすべてのアプリを表示し、ストアにリクエストを送信する方法について確認してください。リリースされたすべてのアプリのリリースノート情報については、「ServiceNow Storeバージョン履歴のリリースノート」を参照してください。

    統合ハブサブスクリプション

    このスポークには Integration Hub のサブスクリプションが必要です。詳細については、「法務スケジュール - 統合ハブの概要」を参照てください。

    スポークバージョン

    Docusign eSignature スポーク v3.1.2 が最新バージョンです。

    スポークの依存関係

    アプリのインストールで問題が発生した場合は、次の依存プラグインがインストールされていることを確認してください。

    • ServiceNow 統合ハブアクションステップ：REST (com.glide.hub.action_step.rest)
    • ServiceNow 統合ハブランタイム (com.glide.hub.integration.runtime)
    • ServiceNow フローデザイナー：動的入力 (com.glide.hub.dynamic_inputs)
    注:
    これらのプラグインの一部はライセンス可能な機能であり、スポーク実装以外で使用する場合は適切なライセンスが必要です。ライセンスの詳細については、アカウントマネージャーにお問い合わせください。

    互換バージョン

    このスポークは Docusign eSignature API バージョン v2 または v2.1 用にビルドされていますが、それ以降のバージョンと互換性がある可能性があります。

    主な機能

    Docusign eSignature スポークにより、フローデザイナーで以下のことができるようになります。

    • デジタル署名用に ServiceNow 添付ファイルまたは Docusign eSignature テンプレートからドキュメントを個人または受信者のリストに送信するプロセスを自動化します。
    • ServiceNow で Docusign eSignature アカウントとテンプレートを検出して同期します。
      • アカウントと関連テンプレートのリストを Docusign eSignature から取得し、[アカウントを取得] サブフローを使用して、それらをアカウント [sn_docusign_spoke_accounts] テーブルとテンプレート [sn_docusign_spoke_docusign_templates] テーブルにレコードとして挿入または更新します。
      • 指定された Docusign eSignature アカウントに関連付けられたテンプレートを取得し、[テンプレートをアカウントごとに取得] サブフローを使用して、各テンプレートをテンプレート [sn_docusign_spoke_docusign_templates] テーブルにレコードとして挿入または更新します。
    • テンプレートとオンデマンドドキュメント要求を送信するためにサンプルフローをコピーしてカスタマイズします。
    • ドキュメントが署名されるまでフローを一時停止します。スクリプト化された REST API Webhook は、受信者がドキュメントに署名するのを待機します。
    • 署名されたドキュメントの値をフローで使用します。
    • 完了した Docusign eSignature ドキュメントを監査目的で ServiceNow レコードに添付します。
    • エンベロープとユーザーを管理します。

    スポークの要件

    • Docusign eSignature アカウント
    • Docusign eSignature アドミニストレーター認証情報
    • ServiceNow と統合するために構成された Docusign eSignature アプリケーション
    • クライアント ID、インテグレーターキー、秘密キー、RSA キーペアなどの Docusign eSignature アプリケーションの詳細
    • ServiceNow 統合ハブサブスクリプション
      注:
      サービスカタログ (com.glideapp.servicecatalog.flow_designer) プラグインに対するフローデザイナーサポートが有効化されていることを確認します。

    カスタムアプリケーションの作成と構成については、Docusign 開発者センター のドキュメントを参照してください。

    スポークのフロー

    Docusign eSignature スポークには、Docusign タスクの自動化をデモするためのサンプルフローが用意されています。Docusign eSignature スポークアクションを使用して、組織で必要なタスクを自動化します。サンプルフローをカスタマイズするには、新しいアプリケーションスコープにコピーします。利用可能なサンプルフローは次のとおりです。

    フロー 説明
    デジタル署名のためにドキュメントを送信 [デジタル署名のためにドキュメントを送信] アイテムによってサービスカタログ要求が作成されたときに、デジタル署名用にドキュメントを Docusign に送信します。このフローを使用する前に、[デジタル署名のためにドキュメントを送信] カタログアイテムを有効化します。
    Docusign テンプレートを使用して候補者に雇用オファーを送信 テンプレートを使用して、Docusign エンベロープをユーザーに送信します。たとえば、このフローを使用してジョブオファーを候補者に送信します。このフローを使用する前に、[テンプレートのデモンストレーション (Demonstrate Template)：候補にジョブオファーを送信] を有効化します。

    Docusign eSignature スポーク は、Docusign eSignature スポーク のサンプルフローで使用するカタログアイテムを追加します。Docusign eSignature スポーク サンプルフローをトリガーする前に、これらのカタログアイテムをアクティブ化します。

    カタログアイテム 説明
    デジタル署名のためにドキュメントを送信 DocuSign で、デジタル署名のためにドキュメントを送信します。
    テンプレートのデモンストレーション (Demonstrate Template)：候補にジョブオファーを送信 DocuSign テンプレートを使用して、ジョブオファーを送信します。

    スポークのサブフロー

    Docusign eSignature スポークには、Docusign タスクの自動化をデモするためのサンプルサブフローが用意されています。サンプルサブフローをカスタマイズするには、新しいアプリケーションスコープにコピーします。利用可能なサンプルサブフローは次のとおりです。

    カテゴリ サブフロー 説明
    エンベロープ管理 Docusign エンベロープを ServiceNow レコードに添付 エンベロープ内のすべてのドキュメントを ServiceNow レコードに添付します。
    Docusign フィールドデータを取得して設定 カタログアイテム変数のリストを処理し、各変数値でドラフトエンベロープを更新します。
    ユーザー管理 ユーザーを作成 権限プロファイルとグループメンバーシップを含むユーザーを作成します。
    ユーザーを更新 権限プロファイルとグループメンバーシップを含むユーザーを更新します。
    テンプレート管理 テンプレートをアカウントごとに取得 Docusign アカウントからテンプレートを取得し、テンプレートテーブルに保存します。
    デフォルト Docusign Webhook サンプルサブフロー 指定されたエンベロープの受信者の詳細を取得します。
    アカウント管理 アカウントの取得 Docusign アカウントとすべてのアカウントに関連する テンプレートを取得し、それぞれアカウントテーブルとテンプレートテーブルに保存します。

    スポークのアクション

    Docusign eSignature スポークは、ServiceNow でイベントが発生したときに Docusign タスクを自動化するアクションを提供します。使用可能なアクションは次のとおりです。

    カテゴリ アクション 説明
    アカウント管理 アカウント署名プロバイダーを検索 指定されたアカウントで使用できる署名プロバイダーのリストを取得します。
    エイリアスでアカウントを検索 スポークの接続および資格情報エイリアスレコードに関連付けられたアカウントを取得します。
    ロール ID を検索 指定されたロール名のロール ID を取得します。
    一括エンベロープ管理 一括送信リストの作成 一括送信リストを作成します。
    一括送信要求の作成 エンベロープまたはテンプレートを使用して、既存の一括送信リストに基づいて一括送信要求を作成します。
    一括送信テスト要求の作成 既存のエンベロープまたはテンプレートとの互換性をテストするための一括送信テスト要求を作成します。
    一括送信リストの削除 指定した一括送信リストを削除します。
    一括送信バッチエンベロープストリームの検索 指定された一括送信バッチからエンベロープを取得します。
    一括送信バッチステータスの検索 成功の数、処理待ちの数、エラーの数など、指定された一括送信バッチの一般的なステータスを取得します。
    一括送信バッチストリームの検索 一括送信バッチの情報を取得します。
    一括送信リストの検索 指定した一括送信リストを取得します。
    一括送信リストの検索 一括送信リストのリストを取得します。
    一括送信バッチアクションの更新 指定した一括送信バッチに対して一括アクション (再送信、修正、または無効化) を実行します。
    一括送信バッチステータスの更新 指定した一括送信バッチの名前を更新します。
    一括送信リストの更新 指定した一括送信リストを更新します。
    ドキュメント署名 埋め込み署名 URL を検索 アプリケーションに埋め込まれた署名 URL を作成します。ユーザーは、アプリケーションを離れることなくドキュメントに署名できます。
    注:
    署名 URL は 300 秒間有効であり、一度に 1 人の受信者に送信できます。
    埋め込み署名 URL をインラインで検索 Docusign の受信者ビューを埋め込むことができる URL を取得します。
    ドキュメント管理 エンベロープにドキュメントを追加 エンベロープにドキュメントを追加します。
    結合したドキュメントを ServiceNow レコードに添付 Docusign ドキュメントを ServiceNow レコードに添付します。
    Docusign ドキュメントを ServiceNow レコードに添付 署名済みの Docusign ドキュメントを取得し、ServiceNow レコードに添付します。
    名前でドキュメント ID を検索 指定されたドキュメント名を使用してエンベロープからドキュメント ID を取得します。
    エンベロープ内のドキュメントを検索 指定された Docusign エンベロープ内のリストを ID と名前付きで返します。
    エンベロープ内のドキュメントを置換 エンベロープに対するドキュメントを置換します。
    エンベロープ管理 エンベロープに受信者を追加 指定された受信者を指定されたエンベロープに追加します。
    注:
    • このアクションで使用される受信者 ID はエンベロープに関連付けられており、[すべてのテンプレートフィールドを取得 (Get All Template Fields)] アクションで使用される受信者 ID とは異なります。
    • アドミニストレーターは、この受信者 ID の数値を入力します。
    エンベロープに受信者を追加 指定された受信者を指定されたエンベロープに追加します。
    Docusign 証明書を ServiceNow レコードに添付 Docusign 証明書を ServiceNow レコードに添付します。
    エンベロープをキャンセル 処理中のエンベロープをキャンセルします。
    テンプレートからドラフトエンベロープを作成 既存の Docusign テンプレートからドラフトエンベロープを作成します。
    複合テンプレートからエンベロープを作成 既存の複合テンプレートからエンベロープを作成します。
    フィールド ID を検索 指定されたドラフトエンベロープから指定されたフィールドの ID を取得します。
    フィールド値を検索 指定されたエンベロープから指定されたフィールドの値を取得します。
    フィールドを検索 ドラフトエンベロープ内のドキュメントに関連付けられたフィールドのリストを取得します。
    ロール名で受信者 ID を検索 指定されたエンベロープから指定されたロール名の受信者 ID を取得します。
    エンベロープ内の受信者を検索 指定された Docusign エンベロープ内の受信者のリストを受信者 ID とロール名付きで返します。
    エンベロープから受信者を削除 Docusign エンベロープから受信者を削除します。
    アドホック署名要求をユーザーに送信 (アドホック署名要求をユーザーに送信) 指定された ServiceNow レコードに関連付けられた Docusign ドキュメントを、署名のために指定された受信者に送信します。
    アドホック署名要求をユーザーに送信：インライン 1 つ以上のアップロードしたドキュメントを ServiceNow レコードから複数の受信者に送信します。
    エンベロープを送信 指定された受信者にエンベロープを送信します。
    注:
    エンベロープを送信する前に、すべての受信者の詳細を入力する必要があります。
    フィールド値の設定 指定されたドラフトエンベロープに指定されたフィールドの値を設定します。
    複数のフィールド値の設定 (Set Field Values) ドラフトエンベロープ内のドキュメントに関連付けられた複数のフィールドの値をアサインします。
    Docusign からの署名を待機 指定されたドキュメントが署名または却下されるまでフローを一時停止します。さらに処理するために、ドキュメントのステータスをフローに返します。
    グループ管理 グループにユーザーを追加 グループからユーザーを追加します。
    グループ ID を検索 指定されたロール名のグループ ID を取得します。
    グループからユーザーを削除 グループから指定されたユーザーを削除します。
    テンプレート管理 テンプレートをアカウントごとに検索 指定された Docusign アカウントに関連付けられているテンプレートを取得します。
    テンプレートフィールドを検索 受信者用に定義されたテンプレートのすべてのフィールドを取得します。
    注:
    • このアクションで使用される受信者 ID はテンプレートに関連付けられており、[エンベロープに受信者を追加] アクションで使用される受信者 ID とは異なります。
    • 受信者 ID の値は、システムによって生成された一意の番号です。
    テンプレート受信者を検索 テンプレート用に定義されたすべての受信者を取得します。
    ユーザー管理 ユーザーの作成 指定されたユーザーの詳細を使用して Docusign ユーザーを作成します。
    ユーザーの詳細を検索 ユーザーの詳細を取得します。
    ユーザーを更新 指定されたユーザーを更新します。
    ユーザーを削除 指定された Docusign ユーザーを削除します。

    スポークモジュール

    Docusign eSignature スポークは、Docusign モジュールを ServiceNow インスタンスに追加します。Docusign eSignature スポークは、ServiceNow のテンプレートとエンベロープを同期して保存します。Docusign eSignature スポークには、以下のテーブルとレコードが含まれています。

    テーブル/レコード 説明
    接続エイリアス Docusign 接続エイリアス。
    スケジュール済みジョブ テンプレートとエンベロープを Docusign アカウントと同期する [アカウントとテンプレートを取得 (Get Accounts & Templates)] スケジュール済みジョブ。
    アカウント ServiceNow インスタンスと同期された Docusign アカウント。アカウントを同期するには、「 Docusign と ServiceNow との同期」を参照してください。[アカウントを取得] サブフローは、アカウントと関連テンプレートのリストを Docusign から取得し、それらをアカウント [sn_docusign_spoke_accounts] テーブルとテンプレート [sn_docusign_spoke_docusign_templates] テーブルにレコードとして挿入または更新します。
    テンプレート 同期された Docusign アカウントからの Docusign テンプレート。[テンプレートをアカウントごとに取得] サブフローでは、指定された Docusign アカウントに関連付けられたテンプレートを取得し、各テンプレートをテンプレート [sn_docusign_spoke_docusign_templates] テーブルにレコードとして挿入または更新します。
    エンベロープ 同期された Docusign アカウントからの Docusign エンベロープ。Docusign アカウントに Webhook が設定されている場合にのみ、エンベロープテーブルのレコードが更新されます。
    Docusign eSignature スポークテーブルには、以下のフィールドが含まれています。
    テーブル フィールド
    アカウント [sn_docusign_spoke_accounts]
    • アカウント ID
    • アカウント名
    • 説明
    • メール
    • エイリアス
    • 表示名
    テンプレート [sn_docusign_spoke_docusign_templates]
    • アカウント
    • テンプレート ID
    • 名前
    • 説明
    • 最終変更日
    • 表示名
    エンベロープ [sn_docusign_spoke_envelopes]
    • アカウント
    • ID
    • ステータス
    • 署名日
    • 却下理由
    • 表示名
    • 埋め込み署名
    • 署名日のタイムゾーン
    • テンプレート

    Docusign アカウント要件

    Docusign eSignature スポークでは、OAuth 2.0 JWT ベアラー権限許可トークンを生成するために、Docusign アカウントを設定する必要があります。

    接続および資格情報エイリアスの要件

    統合ハブ は、エイリアスを使用して、接続情報および認証情報、および OAuth 認証情報を管理します。エイリアスを使用することで、複数の環境を使用する場合に、複数の認証情報と接続情報プロファイルを構成する必要がなくなります。接続または認証情報が変更された場合、接続を使用するどのアクションも更新する必要はありません。

    このスポークは Docusign の接続および資格情報エイリアスレコードを使用してアクションを許可します。

    重要:
    • 認証コード権限許可または JWT 権限許可を使用して Docusign スポークを設定できます。
      • 統合でブラウザまたはクライアントを使用して Web サーバーに要求を行う場合は、認証コード権限許可を使用します。
      • 統合の各ユーザーが単一のシステムアカウントを使用してログインする場合は、JWT 権限許可を使用します。

      いずれかのセットアップ方法を選択する条件の詳細については、Docusign 開発者センターのドキュメントの「OAuth タイプの選択」を参照してください。

    • 会社によっては、Docusign を使用する部門ごとに Docusign アカウントがあります。このスポークで複数のアカウントを使用するには、各アカウントの子エイリアスを作成します。また、フロー内のベースエイリアスより子エイリアスが優先されていることを確認してください。実行時に、システムはアカウントに関連付けられている子エイリアスを識別し、要求で正しい接続と資格情報を送信します。

      会社にアカウントが 1 つしかない場合は、スポークで提供されるデフォルトの Docusign エイリアスを使用し、認証コード権限許可または JWT 権限許可を使用して Docusign スポークの設定に進むことができます。

    MID サーバーの要件

    これらのアクションでは REST 呼び出しを使用します。REST 呼び出しはインスタンスまたは MID サーバーで実行できます。Docusign エイリアスに関連付けられた接続レコードを使用して、アクションを実行する場所および MID サーバー選択属性を設定します。 詳細については「MID サーバー」を参照してください。