DocuSign スポーク

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む16読むのに数分

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

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

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

    IntegrationHub サブスクリプション

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

    スポークバージョン

    DocuSign 電子署名スポーク v 3.0.0 が最新バージョンです。

    スポークの依存関係

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

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

    互換バージョン

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

    主な機能

    DocuSign 電子署名スポークにより Flow Designer で次を実行できます。

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

    スポークの要件

    • DocuSign アカウント
    • DocuSign 管理者資格情報
    • ServiceNow とデータ連携するように構成された DocuSign アプリケーション
    • クライアント ID、インテグレーターキー、秘密キー、RSA キーペアなどの DocuSign アプリケーションの詳細
    • ServiceNow IntegrationHub サブスクリプション
      注:
      Service Catalog (com.glideapp.servicecatalog.flow_designer) プラグインに対する Flow Designer サポートが有効化されていることを確認します。

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

    スポークのフロー

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

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

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

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

    スポークのサブフロー

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

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

    スポークのアクション

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

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

    スポークモジュール

    DocuSign 電子署名スポークは、DocuSign モジュールを ServiceNow インスタンスに追加します。DocuSign 電子署名スポークは、ServiceNow でテンプレートとエンベロープを同期して保存します。DocuSign 電子署名スポークには、次のテーブルとレコードが含まれています。

    テーブル/レコード 説明
    接続エイリアス 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 電子署名スポークテーブルには、次のフィールドが含まれています。
    テーブル フィールド
    アカウント [sn_docusign_spoke_accounts]
    • アカウント ID
    • アカウント名
    • 説明
    • メール
    • エイリアス
    • 表示名
    テンプレート [sn_docusign_spoke_docusign_templates]
    • アカウント
    • テンプレート ID
    • 名前
    • 説明
    • 最終変更日
    • 表示名
    エンベロープ [sn_docusign_spoke_envelopes]
    • アカウント
    • ID
    • ステータス
    • 署名日
    • 却下理由
    • 表示名
    • 埋め込み署名
    • 署名日のタイムゾーン
    • テンプレート

    DocuSign アカウント要件

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

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

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

    このスポークでは、DocuSign 接続および資格情報エイリアスレコードを使用してアクションを許可します。 スポークの設定については、「 追加の DocuSign アカウントの接続エイリアスの作成です。またはを選択できますDocuSign JWT 権限許可を使用してスポークを設定DocuSign認証コードグラントを使用したスポークの設定。いずれかのセットアップ方法を選択するタイミングの詳細については、「」を参照してください https://developers.docusign.com/platform/auth/choose/。

    MID Server の要件

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