Как указать размеры шаблона docusignTab

Question

Я пытаюсь программно добавить вкладки в шаблон, используя конечную точку POST /v2/accounts/{accountId}/templates/{templateId}/recipients/{recipientId}/tabs

Я могу надежно разместить checkboxTabs, dateSignedTabs, signHereTabs и initialHereTabs, но когда дело доходит до размещения textTabs (наиболее важные из них), я не могу контролировать размеры при использовании API Explorer .

Я ввожу параметры высоты и ширины

Но запрос становится

{
  "textTabs": [
    {
      "documentId": "1",
      "locked": "true",
      "pageNumber": "1",
      "required": "false",
      "tabLabel": "dataLabel",
      "xPosition": "200",
      "yPosition": "200"
    }
  ]
}

с ответом типа

{
    "textTabs": [
        {
            "isPaymentAmount": "false",
            "shared": "false",
            "requireInitialOnSharedChange": "false",
            "requireAll": "false",
            "required": "false",
            "locked": "true",
            "concealValueOnDocument": "false",
            "disableAutoSize": "false",
            "tabLabel": "dataLabel",
            "font": "arial",
            "bold": "false",
            "italic": "false",
            "underline": "false",
            "fontColor": "black",
            "fontSize": "size7",
            "documentId": "1",
            "recipientId": "XXXXXX",
            "pageNumber": "1",
            "xPosition": "200",
            "yPosition": "200",
            "tabId": "e940cc97-a68c-4da6-9ffe-487439579bc6"
        }
    ]
}

и отображает на странице как очень маленькое текстовое поле.

1) Это ограничение API Explorer ?

2) Или высота и ширина не являются допустимыми параметрами при создании вкладок из этой конечной точки? 2.а) и если да, то как правильно?

Answer 1

Это абсолютно проблема с API Explorer: если вы берете запрос, который он вам дает, и вручную отправляете его с нужными параметрами:

{
  "textTabs": [
    {
      "documentId": "1",
      "locked": "true",
      "pageNumber": "1",
      "required": "false",
      "tabLabel": "dataLabel",
            "height": "11",
            "width": "400",
      "xPosition": "200",
      "yPosition": "200"
    }
  ]
}

, вы сможете установить height &width!

Теперь Docusign может изменить их по причинам, которые ваш человеческий разум не может понять.400 !== 396 in the response но не волнуйтесь, надеюсь, это только часть процесса.И поверьте себе, по крайней мере, эта страница API Explorer работает, в отличие от некоторых конечных точек , которые прямо не имеют документации!

также, пример реализациис использованием python sdk : (в случае, если чтение автоматически генерируемого кода неясно)

tabs = {
    "checkboxTabs": [
        {
            "documentId": "1",
            "locked": "true",
            "pageNumber": "1",
            "tabLabel": "check1",
            "xPosition": "100",
            "yPosition": "100"
        }
    ],
    "dateSignedTabs": [
        {
            "documentId": "1",
            "pageNumber": "1",
            "xPosition": "300",
            "yPosition": "100"
        }
    ],
    "signHereTabs": [
        {
            "documentId": "1",
            "pageNumber": "1",
            "xPosition": "200",
            "yPosition": "200"
        }
    ],
    "initialHereTabs": [
        {
            "documentId": "1",
            "pageNumber": "1",
            "xPosition": "300",
            "yPosition": "200"
        }
    ],
    "textTabs": [
        {
            "pageNumber": "1",
            "xPosition": "50",
            "yPosition": "50",
            "tabLabel": "text1",
            "locked": "true",
            "required": "false",
            "documentId": "1",
            "height": "11",
            "width": "400"
        }
    ]
}
response = Template.template_api.create_tabs(recipient_id=recipient_id, template_id=template_id, account_id=Template.accountID, template_tabs=tabs).to_dict()