收件人标签x /位置不匹配 [英] Recipient tab x/yposition mismatch
问题描述
我可以通过REST API成功地将各种标签添加到草稿信封的收件人。但是，当我通过网站的管理选项卡查看目标文档并检查选项卡上的设置时，位置值与通过REST API输入的位置值完全不同。
I can successfully add various tabs to a recipient of an draft envelope via the REST API. However, when I go to look at the target document via the manage tab of the website and I check the settings on the tab, the location values are completely different than what I entered via the REST API.
有什么区别？为什么会有所不同？网页和API上的精确计量单位是什么？
What is the difference? Why the difference? What exactly is the unit of measurement on the webpage as well as the API?
推荐答案
如果您只是想确定在REST API的创建信封请求中使用的X / Y坐标值，以便在DocuSign中查看信封时，在预期/所需的位置显示选项卡，您可以尝试以下操作：
If you're merely trying to determine the X/Y coordinate values to use in the REST API Create Envelope request such that tabs are displayed in expected/desired locations when the Envelope is viewed in DocuSign, you might try the following:
1）使用DocuSign Web控制台，创建（草稿）信封，然后上传您将通过API发送的文档。还可以使用Web界面将标签拖放到文档上的正确位置。 （另存为草稿信封。）例如，在一个文档中，我添加了两个标签（SignHere和DateSigned）：
1) Using the DocuSign web console, create a (Draft) envelope and upload the document(s) that you will be sending via the API. Also use the web interface to drag/drop tags into the proper locations on the document(s). (Save as a Draft Envelope.) For example, here's a document where I've added two tags (SignHere and DateSigned):
2）接下来，检查标签属性（X / Y REST API请求 对该草稿信封 进行坐标调整）：（https：// {{env}} .docusign.net / restapi / {{version}} / accounts / {{acctId}} /信封/ {{envelopeId}} /收件人？include_tabs = true& include_extended = true）。这是一个示例响应-高亮显示的值显示了选项卡的X / Y坐标， 根据REST API ：
2) Next, inspect the tab properties (X/Y coordinates) for that Draft Envelope via REST API request: (https://{{env}}.docusign.net/restapi/{{version}}/accounts/{{acctId}}/envelopes/{{envelopeId}}/recipients?include_tabs=true&include_extended=true). Here's an example response -- the highlighted values show X/Y coordinates for the tabs, according to the REST API:
3）最后，要创建一个带有在DocuSign中查看信封时将标签置于预期/期望位置的信封，请使用REST API创建信封请求，该请求包含与步骤1中使用的文档相同的文件，并指定您在X / Y坐标上在步骤2响应中收到（即，根据REST API的X / Y坐标）。例如，这是创建信封（JSON）请求的收件人部分-使用在步骤2响应中收到的X / Y坐标。
3) Finally, to create an Envelope with tabs placed at the expected/desired locations when the Envelope is viewed in DocuSign, use a REST API "Create Envelope" request that contains the same documents used in Step #1 and specifies the X/Y coordinates that you received in Step #2 response (i.e., the X/Y coordinates according to the REST API). For example, here's the "recipients" portion of the Create Envelope (JSON) request -- using X/Y coordinates that I received in Step #2 response.
"recipients": {
"signers" : [{
"email": "bobsemail@outlook.com",
"name": "Bob Adamson",
"recipientId": "1",
"routingOrder": "1",
"tabs": {
"signHereTabs": [
{
"recipientId": "1",
"tabLabel": "Customer_Signature",
"documentId": "1",
"pageNumber": "1",
"xPosition": "99",
"yPosition": "424"
}],
"dateSignedTabs": [
{
"recipientId": "1",
"tabLabel": "Customer_Date",
"documentId": "1",
"pageNumber": "1",
"xPosition": "373",
"yPosition": "456"
}]
}
}]
}
如果我随后在DocuSign中查看由步骤3中描述的创建信封请求创建的信封，我会看到这些标签正好放在我希望/希望它们放在的位置：
If I then view (in DocuSign) the Envelope created by my "Create Envelope" request described in Step 3, I see that the tabs are placed exactly where I expect/desire them to be:
很显然，我在这里描述的过程并不理想（如果通过控制台中显示的API匹配Tab属性设置/检索X / Y坐标会更好），但也许可以。会为您拍摄的最终结果。
Obviously the process I've describe here is not ideal (it'd be much better if the X/Y coordinates set/retrieved via API matched Tab properties shown in the console), but perhaps it'll get you the end result you're shooting for.
这篇关于收件人标签x /位置不匹配的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！
