1. Oracle Integration Generation 2スタート・ガイド
  2. レシピ・リファレンス
  3. ソーシャル・レシピと生産性レシピ
  4. DocuSignと統合
機械翻訳について

DocuSignと統合

これらのレシピを使用して、DocuSignアカウントにドラフト・エンベロープを作成し、それぞれ既存のDocuSignエンベロープのステータスを取得します。

ノート:

統合ストアでは、次の方法で次のレシピを使用できます:
  • REST - DocuSign | エンベロープの作成
  • REST - DocuSign | エンベロープ・ステータスの取得

Oracleには、これらのレシピがサンプルとしてのみ用意されています。 これらのレシピはガイダンスのみを目的としており、エラーがないことを保証するものではありません。 これらのレシピはサポートされていません。

概要

これらのレシピでは、次のことができます:
  • DocuSignアカウントにドキュメント(PDFドキュメントなど)を含むドラフト・エンベロープを作成します。 その後、DocuSignアカウントからこのエンベロープを編集して、必要な受信者に送信できます。
  • DocuSignアカウントの既存のエンベロープのステータスを取得します。
DocuSignレシピを実行するには、DocuSignアプリケーションへのアクセスに必要な詳細を使用して、Oracle DocuSign接続を構成する必要があります。 その後、RESTリクエストを介してレシピをトリガーし、必要なリクエスト・ペイロードを指定できます。
  • RESTの場合 - DocuSign |エンベロープ・レシピの作成では、DocuSignエンベロープ内に挿入するドキュメントのID、ドキュメントの名前、およびリクエストのペイロードとしてドキュメントのBase64値を指定する必要があります。 その後、レシピの「DocuSignアダプタ」が起動され、DocuSignアカウントにドキュメントを含むドラフト・エンベロープが作成されます。 新しいエンベロープIDを含むレスポンスが返されます。
  • RESTの場合 - DocuSign |エンベロープ・ステータスの取得レシピで、ステータスをリクエスト・ペイロードとするDocuSignエンベロープのIDを指定する必要があります。 その後、レシピの「DocuSignアダプタ」が起動され、指定したエンベロープのステータスがフェッチされます。 ステータスおよび最終ステータス変更日時を含むレスポンスが返されます。
Integration Name 説明 RESTコマンドおよびペイロードの例

エンベロープの作成

DocuSignアカウントのドキュメントを含むドラフト・エンベロープを作成します。
REST APIコマンド:
POST: https://<host:port>/ic/api/integration/v1/flows/rest/ORCL-R-REST_DOCUSI_SEND_ENVELO/1.0/createdocusign
リクエスト・ペイロードの例:
{ "documentId" : "12345", "name" : "new", "documentBase64" : "<Base64_equivalent_of_a_PDF_file>"
}
レスポンス・ペイロードの例:
{
    "envelopeId": "cdf684b3-b1af-4d2a-a56e-4d3a146c5c08"
}

エンベロープ・ステータスの取得

DocuSignアカウントの既存のエンベロープのステータスを取得します。
REST APIコマンド:
POST: https://<host:port>/ic/api/integration/v1/flows/rest/ORCL-R-REST_DOCUSI_GET_ENVE_STAT/1.0/envelopstatuschanges
リクエスト・ペイロードの例:
{ "envelopidId":"13e47618-b03f-4fac-ac4d-3fc0c9477311" }
レスポンス・ペイロードの例:
{
    "status": "created",
    "statuschangedatetime": "2021-04-13T13:22:20.1730000Z"
}

システムおよびアクセスの要件

  • Oracle Integration
  • DocuSign

レシピのインストール、構成および実行

レシピのインストール、構成および実行の詳細は、「統合アクセラレータおよびレシピの開始」を参照してください。

レシピ・パッケージに存在するOracle REST接続およびOracle DocuSign接続を構成します。 これらの接続を構成する必要があるのは一度だけです。 DocuSignレシピはどちらも同じ接続を使用します。

これらの接続を構成する場合は、次の情報を指定する必要があります。

接続名 パラメータ

Oracle REST接続

接続パラメータはすでに構成されています。 接続をテストして保存します。

Oracle DocuSign接続

セキュリティ

  • クライアントID(インテグレータ・キー): DocuSignに作成された統合のアプリケーション/統合キー。
  • クライアント・シークレット: DocuSignに作成された統合の秘密キー。
  • スコープ: 権限を付与するスコープのリスト(signature extendedなど)。
  • インスタンス・タイプ: DocuSignインスタンスのタイプ。 これはオプションのフィールドです。
  • アカウントID: DocuSignに作成された統合のAPIアカウントID。 これはオプションのフィールドです。

詳細は、「Oracle IntegrationでのDocuSignアダプタの使用」の「DocuSignアダプタ接続の作成」を参照してください。

関連ドキュメント