DocuSign 自定义标签 - CustomTabRequired 属性答案

【问题标题】：DocuSign custom tags - CustomTabRequired propertyDocuSign 自定义标签 - CustomTabRequired 属性
【发布时间】：2014-10-08 04:01:48
【问题描述】：

我正在使用 DocuSign 的基于 SOAP 的 API 调用在所选的 DocuSign 帐户中创建信封。在添加自定义标签时，如果我不需要收件人在自定义标签中输入信息，我将自定义标签属性“CustomTabRequired”设置为 false。如果我要求收件人在自定义标签中输入信息，我设置自定义标签属性 “CustomTabRequired”为真，“CustomTabRequiredSpecified”为真。

创建信封后，如果我没有将自定义标记所需属性设置为 true，它仍会强制收件人填写信息以完成签名过程。除了这两个属性之外，我还需要设置什么吗？我在我的 DocuSign 模拟账户和真实账户中都观察到了这种行为。

请指教。

【问题讨论】：

标签： docusignapi

【解决方案1】：

我们已在 Stack Overflow 外部进行连接，发现某些属性已从您的请求中删除，但为了社区的利益-

使用 DocuSign SOAP API 并创建自定义选项卡时，您只需确保将 CustomTabRequired 属性设置为 true。例如，在 PHP 中，您可以像这样创建选项卡：

//+++ Add Custom Tab +++
$tab = new Tab();
$tab->DocumentID = "1";
$tab->RecipientID = "1";
$tab->PageNumber = "1";
$tab->Type = TabTypeCode::Custom;
$tab->Name = "CustomTextTag1";
$tab->TabLabel = "CustomTextTag1";
$tab->CustomTabType = CustomTabType::Text;
$tab->CustomTabRequired = false;
$tab->XPosition = "100";
$tab->YPosition = "100";

在您尝试完成时使选项卡成为可选的重要一点是：

$tab->CustomTabRequired = false;

只要您的请求中存在该属性，它就会使相关选项卡成为可选选项。请注意，如果使用 DocuSign 的 REST API，则相应的 JSON 属性仅标记为 required。

【讨论】：

我们发现/解决了这个问题。在设置自定义标签属性 CustomTabRequired=false 时，我们需要明确设置属性 CustomTabRequiredSpecified=true。看起来基于 SOAP 的 API 调用需要我们为每个标签属性设置指定的属性。当我们忽略那些指定的属性时，标签属性没有被正确设置。非常感谢您的帮助。