Docusign REST APIを使用してSignerAttachmentTabにドキュメントを添付

Question

お客様が記入して署名するテンプレートを定義しました。このテンプレートには、事前に入力したいくつかのフィールドと、添付するドキュメントがあります。顧客は他のフィールドに記入し、さらに文書を添付します。署名リクエストを生成するためにREST APIを使用しています。正しいRESTリクエストを生成してテンプレートのタブを埋めることができ、受信者を設定して署名リクエストを正常に送信できます。すべてこれは素晴らしい作品です。しかし今、テンプレート内の適切なSignerAttachmentTabに添付されたドキュメントを取得しようとしています.RESTを受け入れることができません。

[ドキュメント]フィールドを使用しようとしましたが、それは思われるテンプレートでは機能しません。複合テンプレートを作成し、ドキュメントのドキュメント、テンプレート自体のサーバーテンプレート、および挿入するタブデータを格納するインラインテンプレートを定義しました。これにより、正しいタブページ番号に関するエラーが生成され続けます。私たちはさまざまな価値観を試してきましたが、文書をテンプレートに添付するためのフォーラムのすべての記事とドキュメントを見てきましたが、どれも動作していないようです。

アップロードするファイルを指定するドキュメントでは、ドキュメントIDと名前を設定します。サーバーテンプレートでは、テンプレートIDを指定します。インラインテンプレートでは、受信者を作成し、その情報を設定し、データでエンベロープタブを構築して、そのドキュメントにSignerAttachmentTabを追加します。このタブでは、ドキュメントIDをDocument要素のドキュメントIDと一致するように設定します。テンプレート自体に使用されているラベルにtabLabelを設定します。 pagenumberを設定しようとしましたが、何も変わりません。私たちが望むのは、ドキュメントを顧客に送ることだけです。開いたら、添付ファイルのフィールドをダブルクリックして、送信しようとしている文書を表示できます。

レシピエクスプローラを使用して生のRESTを使用すると、TAB_PAGEN_IS_NOT_IN_DOCUMENTエラーが発生して失敗します。ドキュメントがテンプレートよりも優先されているようです。残念ながら、エディタでテンプレートの順序を変更することはできません。サーバーとインラインテンプレートのシーケンス番号を設定する以外です。 DocuSignのテストシステムを使用して生成されたリクエストは次のとおりです。

{ 
    "compositeTemplates":[{ 
     "document": { 
      "documentBase64":"<Base64BytesHere>", 
      "documentId":"2", 
      "name":"Test.pdf" 
     }, 
     "inlineTemplates":[{ 
      "recipients":{ 
       "signers":[{ 
        "email":"abc@def.org", 
        "name":"Person", 
        "recipientId":"1", 
        "roleName":"Sender 1", 
        "tabs":{ 
          "signerAttachmentTabs":[{ 
           "documentId":"2", 
           "tabLabel":"MyAttachment" 
          }], 
          "textTabs":[{ 
           "tabLabel":"someText", 
           "value":"Value1" } 
          ]} 
       }]}, 
      "sequence":"2" 
     }], 
     "serverTemplates":[{ 
       "sequence":"1", 
       "templateId":"guid}] 
      }], 
     "emailBlurb":"A message", 
     "emailSubject":"Test", 
     "status":"sent" 
} 

私は、フォーラムで既存の投稿を見てきましたし、どちらか彼らは私の場合には対応していませんか、彼らが実際にテンプレートに文書を添付するが、しようとしていないが、単に文書のようにそれらを含めますテンプレートに追加します。

Answer 1

日時：

しかし、今、私たちは、テンプレート内の適切なSignerAttachmentTabに添付された文書を取得しようとしていると我々はそれを受け入れることをRESTを取得することはできません。

APIを使用してSignerAttachmentTabにドキュメントを追加しようとしていますか？

これはサポートされていません。署名者自身だけがSignerAttachmentTabに文書を追加します。 APIはそれらのためにそれを行うことはできません。

署名者が署名式の一部として文書を封筒に添付（アップロード）することを確認したいという問題がありますか？タブはオプションではありません（必須）。しかし、それは添付ファイルの内容をチェックしません。

添付ファイルをチェックするにはWebフック/ Connectを使用し、正しいファイルが添付されていない場合は署名者の別のエンベロープを生成します。

Answer 2

私が間違っていたことを理解しました。添付ファイルのないテンプレートの場合は、TemplateRoleとEnvelopeTabsを使用していました。しかし、添付ファイルの場合、ドキュメントを含めると、ドキュメントはテンプレートを上書きします。そこで、テンプレートとデータ用のサーバーとインラインテンプレートを含む複合テンプレートに切り替えました。許可されているさまざまな分野でさまざまな組み合わせで文書を追加しようとすると、一般的に要求は送信されますが、文書はありませんでした。

最終的な解決策は元のTemplateRoleアプローチに戻り、草案としてエンベロープを作成することでした。封筒の草案が作成されたら、その封筒に文書を追加することができました。しかし残念なことに封筒を送信するには、受信者を再接続する必要があります。私はそれをきれいにするために探していますが、それ以外の場合は今私のために働いています。