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

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

始める前に

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

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

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

始める前に

必要なロール：admin

このタスクについて

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

手順

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

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

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

始める前に

必要なロール：admin

手順

1. 移動先 すべて > システム OAuth > アプリケーションレジストリー.
2. [New] をクリックします。
3. [Create an OAuth API endpoint for external clients (外部クライアント用の OAuth API エンドポイントを作成します)] を選択します。
4. フォームのフィールドに入力します。

   表 : 1. アプリケーションレジストリフォーム

   フィールド	説明
   名前	アプリケーションレジストリレコードを識別する名前です。例:Docusign 外部トリガー。
   OAuth アプリケーションユーザー	OAuth トークンフローがマッピングされているユーザーロール。 重要: デフォルトでは、このフィールドはアプリケーションレジストリフォームに表示されません。フォームレイアウトを構成して、フォーム上のフィールドを表示します。フォームレイアウトの構成の詳細については、「 Configuring the form layout」を参照してください。

5. フォームヘッダーを右クリックし、[保存] をクリックします。
   アプリケーションレジストリレコードが作成され、 クライアントシークレット の値が生成されます。

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

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

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

始める前に

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

このタスクについて

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

手順

1. 移動先 すべて > プロセス自動化 > ワークフロースタジオ.
2. [統合] タブを選択します。
3. [受信] タブを切り替えて有効にします。
4. Docusign eSignature スポークカードを見つけて、[詳細を表示] を選択します。
   
5. [Configure] を選択します。
   
6. フォームに、これらの値を入力します。

   フィールド	説明
   必要なロール	フローのトリガーに使用するロール。たとえば、 admin を選択します。
   アプリケーションレジストリー	着信コールを認証するために作成したアプリケーションレジストリを選択します。たとえば、[ Docusign 外部トリガー] を選択します。

   

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

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

   

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

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

始める前に

必要なロール：admin

手順

1. アドミンとして Docusign アカウントにログインします。
2. [管理] をクリックします。
3. 移動先 統合 > コネクト.
4. [構成] で、[構成の追加] をクリックし、[カスタム] を選択します。
5. フォームに、次の値を入力します。

   フィールド	説明
   名前	カスタム設定レコードを識別する名前です。
   公開する 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 Delivered) 署名済み/完了済みエンベロープ (Envelope Signed/Completed) 拒否済みエンベロープ (Envelope Declined) エンベロープが無効になりました エンベロープが削除されました 受信者に送信されました 受信者の自動応答 受信者に配送されました 受信者の署名済み/完了 受信者が拒否しました [ データを含める] で、[ 受信者 ] オプションを選択します。要件に応じて他のオプションを選択します。

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」を参照してください。