如何在DocuSign模板中设置完成后PDF的动态文档名称？

要实现将签署完成后的PDF名称从固定的“Document”改为“Document fullName”（其中fullName是自定义textTab字段的值），需要通过DocuSign API来实现，具体步骤如下：

• 步骤1：确认自定义textTab的标识
  先在模板编辑界面找到fullName这个textTab的tabLabel（这是字段的唯一标识），后续代码中需要用这个标签来匹配字段。同时从业务系统或用户输入中获取该字段的实际值，比如John Doe。

• 步骤2：调用API时动态配置文档名称
  在使用Envelopes::create API基于模板创建信封时，修改documents数组中对应文档的name属性，将其拼接为Document ${fullName}的格式，同时确保正确填充自定义textTab的值。

  以下是Python SDK的示例代码：

  from docusign_esign import EnvelopesApi, EnvelopeDefinition, TemplateRole, Text
  
  # 初始化API客户端、配置账号信息等前置操作省略
  
  # 从业务逻辑中获取fullName的实际值
  full_name = "John Doe"
  
  # 构建信封定义
  envelope_definition = EnvelopeDefinition(
      template_id="你的模板ID",
      status="sent",
      template_roles=[
          TemplateRole(
              email="签署人邮箱",
              name="签署人姓名",
              role_name="模板中定义的角色名",
              tabs={
                  "textTabs": [
                      Text(
                          tab_label="fullName",  # 与模板中textTab的标签完全一致
                          value=full_name
                      )
                  ]
              }
          )
      ],
      documents=[
          {
              "document_id": "1",  # 对应模板中的文档ID
              "name": f"Document {full_name}"
          }
      ]
  )
  
  # 发送信封
  envelopes_api = EnvelopesApi(api_client)
  envelopes_api.create_envelope(account_id="你的账号ID", envelope_definition=envelope_definition)
  

• 关键注意点

  • 代码中的tabLabel必须和模板里textTab的标签完全匹配，否则无法正确填充字段值
  • 直接通过DocuSign控制台发起信封无法实现这种动态命名，必须通过API集成完成
  • 签署完成后，收件人收到的PDF附件名称会自动变为设置的动态名称

内容的提问来源于stack exchange，提问作者abhishekbutola