Docusign eSignature スポークのトリガーの設定

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：5分

    • ServiceNow インスタンスでコールバック URL を生成するトリガーを設定します。

    始める前に

    • 統合ハブのサブスクリプションを要求します。
    • Docusign eSignature スポークをアクティブ化して設定します。
    • 必要なロール：admin。

    クライアント認証情報権限許可タイプのシステムプロパティを有効にする

    Docusign OAuth クライアントから ServiceNow インスタンスへのインバウンド統合に OAuth クライアント認証情報の権限許可タイプを使用するには、glide.oauth.inbound.client.credential.grant_type.enabled システムプロパティを作成または有効にします。

    始める前に

    必要なロール：admin

    このタスクについて

    クライアント認証情報の権限許可タイプの詳細については、「 Client Credentials」を参照してください。

    手順

    1. 次のように移動する。 All (すべて) > システムプロパティ > すべてのプロパティ.
    2. glide.oauth.inbound.client.credential.grant_type.enabled システムプロパティを検索します。
    3. レコードを開きます。
    4. [値] に「true」と入力します。
    5. フォームヘッダーを右クリックし、[保存] をクリックします。

    着信コールを認証するアプリケーションレジストリを作成します

    ServiceNowインスタンスにアプリケーションレジストリを作成して、着信コールを認証します。

    始める前に

    必要なロール：admin

    手順

    1. 次のように移動する。 All (すべて) > システム OAuth > アプリケーションレジストリー.
    2. [New] をクリックします。
    3. [Create an OAuth API endpoint for external clients (外部クライアント用の OAuth API エンドポイントを作成します)] を選択します。
    4. フォームのフィールドに入力します。
      表 : 1. アプリケーションレジストリフォーム
      フィールド 説明
      名前 アプリケーションレジストリレコードを識別する名前です。例:Docusign 外部トリガー。
      OAuth アプリケーションユーザー OAuth トークンフローがマッピングされているユーザーロール。
    5. フォームヘッダーを右クリックし、[保存] をクリックします。
      アプリケーションレジストリレコードが作成され、 クライアントシークレット の値が生成されます。

      後で使用するために [クライアント ID] と [クライアント シークレット] の値をコピーして記録します。

    ServiceNow インスタンスでのトリガー定義のアクティブ化

    トリガー定義をアクティブ化して、 ServiceNow インスタンスにコールバック URL を生成します。

    始める前に

    必要なロール:flow_designer および connection_admin。

    このタスクについて

    Docusign はコールバック URL を使用して、ペイロードを ServiceNow インスタンスに安全に送信します。

    手順

    1. 次のように移動する。 All (すべて) > プロセス自動化 > Workflow Studio (ワークフロースタジオ).
    2. [統合] タブを選択します。
    3. [受信] タブを切り替えて有効にします。
    4. Docusign eSignature スポークカードを見つけて、[詳細を表示] を選択します。
      Docusign eSignature スポークカードを見つけます。
    5. [Configure] を選択します。
      エンドポイントを構成します。
    6. フォームに、これらの値を入力します。
      フィールド 説明
      必要なロール フローのトリガーに使用するロール。たとえば、 admin を選択します。
      アプリケーションレジストリー 着信コールを認証するために作成したアプリケーションレジストリを選択します。たとえば、[ Docusign 外部トリガー] を選択します。

      エンドポイントをアクティブ化します。

    7. [アクティブ化] をクリックします。
      エンドポイントがアクティブ化され、 URL の値が生成されます。

      後で使用するために URL の値をコピーして記録します。

      後で使用するために URL をコピーします。

    Docusign アカウントに構成を追加

    Docusign アカウントにカスタム構成を追加して、リアルタイムのデータ更新を ServiceNow インスタンスに送信します。

    始める前に

    必要なロール：admin

    手順

    1. アドミンとして Docusign アカウントにログインします。
    2. [管理] をクリックします。
    3. 次のように移動する。 統合 > コネクト.
    4. [構成] で、[構成の追加] をクリックし、[カスタム] を選択します。
    5. フォームに、次の値を入力します。
      フィールド 説明
      [Name (名前)] カスタム設定レコードを識別する名前です。
      公開する URL トリガー定義を有効にしたときに生成される URL を https://<ServiceNow-instance-name>.service-now.com/api/sn_docusign_spoke/docusign_esignature_external_trigger の形式で入力します。

      詳細については、「ServiceNow インスタンスでのトリガー定義のアクティブ化」を参照してください。
      データ形式 必ず REST v2.1 を選択してください。
      イベントメッセージ配信モード [Send Individual Messages (SIM) (個別メッセージの送信 (SIM)] を選択します。
      イベントのトリガー エンベロープと受信者を展開し、次のイベントを選択します。
      • 送信済みエンベロープ (Envelope Sent)
      • 配信済みエンベロープ (Envelope Delivered)
      • 署名済み/完了済みエンベロープ (Envelope Signed/Completed)
      • 拒否済みエンベロープ (Envelope Declined)
      • 無効化済みエンベロープ (Envelope Voided)
      • 削除済みエンベロープ
      • 受信者送信済み
      • 受信者配送済み
      • 受信者の署名済み/完了
      • 受信者拒否

      選択するイベントをトリガーします。
    6. [統合とセキュリティの設定] で、[OAuth を含める (推奨)] チェックボックスをオンにします。
    7. [構成を追加] をクリックします。
      カスタム設定レコードが作成されます。
    8. 作成したカスタム設定レコードの [アクション ] をクリックし、[ 編集] を選択します。
      カスタム構成を編集します。
    9. [統合とセキュリティの設定] で、[OAuth の管理] をクリックします。
      [OAuth 2.0] タブが表示されます。
    10. [クライアント ID] と [クライアントシークレット] の値を入力します。
      これらの値は、 ServiceNow インスタンスでアプリケーションレジストリレコードを作成するときに作成されます。詳細については、「着信コールを認証するアプリケーションレジストリを作成します」を参照してください。
    11. 認証サーバーの URL を https://<ServiceNow-instance-name>.service-now.com/oauth_token.do の形式で入力します。
    12. [Save (保存)] をクリックします。

    次のタスク

    要件に応じて、これらのトリガーを使用して ワークフロースタジオ でフローを作成します。詳細については、「Create a flow with an external trigger」を参照してください。