1

REST API を使用して、ドラフト エンベロープの受信者にさまざまなタブを正常に追加できます。しかし、ウェブサイトの管理タブから目的のドキュメントを見に行き、タブの設定を確認すると、REST API で入力した場所の値とはまったく異なります。

違いはなんですか？違いはなぜですか？ウェブページと API の測定単位は正確には何ですか?

4

2 に答える 2

1

（コードと画像を含めることができるように、これを「コメント」ではなく「回答」として提供します。これが必ずしもあなたの質問に答えるとは限らないことは理解していますが、DocuSignの誰かが私が概説したシナリオについてコメントできることを願っています.明確にします。）

面白い。(何らかの理由で) API を介して指定した XY 座標の測定単位が、DocuSign Web コンソールがタブの [場所] プロパティに使用する測定単位と異なる場合でも、倍率は同じであること。しかし、そうではないようです。

たとえば、API リクエストを送信して、xPosition =100 および yPosition =100 を指定する [Signature] タブを持つ Draft Envelope を作成する場合(ここの部分的なリクエスト JSON に示されているように):

"recipients": {
"signers" : [{
"email": "bobsEmail@outlook.com",
"name": "Bob Adamson",
"recipientId": "1",
"routingOrder": "1",
"tabs": {
       "signHereTabs": [
       {
           "recipientId": "1",
           "tabLabel": "Customer_Signature",
           "name": "KB_TEST_SIG",
           "documentId": "1",
           "pageNumber": "1",
           "xPosition": "100",
           "yPosition": "100"
       }]
   }
}]

次に、DocuSign Web コンソールを使用してそのドラフト エンベロープを開き、[署名] タブの [場所] プロパティを調べると、次のようになります。

Web コンソールのタグ プロパティ

API リクエストでは、xPosition (定義: 「ドキュメントの左上隅を原点とする座標空間で、ページ上のタブの水平オフセットを示す」) とyPosition (定義: 「ドキュメントの左上隅を原点とする座標空間で、ページ上のタブの垂直方向のオフセットを示す」)、コンソールに表示される [左から]と[上から] の値が一致しなくなりましたお互い：

  • 左から：208
  • 上から：252

別のテストとして、逆のことを試してみました。

  1. Web コンソールを介してドラフト エンベロープを作成/保存します。単一の [署名] タブには、[場所] プロパティの [左から] = 100 および[上から] = 100 が設定されています。
  2. API リクエストでタブのプロパティを調べます: (https://{{env}}.docusign.net/restapi/{{version}}/accounts/{{acctId}}/envelopes/{{envelopeId}}/recipients?include_tabs =true&include_extended=true

API 応答は、 xPosition =48 およびyPosition =27 を示しています (コンソールを介してドラフト エンベロープを作成するときに、左から=100 および上から=100に設定したにもかかわらず)。

これらすべてから導き出せる唯一の論理的結論は、API を介して指定されたxPositionおよびyPosition座標が、コンソール。DocuSign の担当者がこの動作を確認および/または明確化できることを願っています。

さらに奇妙なのは、SOAP API を介して返されたタグの XY 座標が、REST API を介して返された XY 座標と一致しないことです (もちろん、REST 座標も SOAP 座標もコンソールに表示されるものと一致しません)。

  1. REST API を使用してドラフト エンベロープを作成します。xPosition = 100、yPosition = 100 の座標を持つ単一の SignHereTab を含めます。
  2. REST API (https://{{env}}.docusign.net/restapi/{{version}}/accounts/{{acctId}}/envelopes/{{envelopeId}}/recipients?include_tabs=) を介してタグのプロパティを検査しますtrue&include_extended=true)。タグ座標は期待どおりです: xPosition = 100、yPosition = 100。
  3. SOAP API (RequestStatusEx) を介してタグのプロパティを検査します。応答で返されるタグ座標: xPosition = 208、yPosition = 208
  4. コンソールからタグのプロパティを調べます (エンベロープの編集 >> タグのプロパティの表示)。「場所」の下に表示されるタグ座標:左から= 208.上から= 252.
于 2013-11-02T00:46:53.187 に答える