问题[docusignapi](coding)

我有一个模板，TextTabs 和 CheckboxTabs 都成功通过了，但是 NumberTabs 却没有显示。我正在阅读关于 Number Tabs 和 Numerical Tabs 的对比，我仔细检查了一下，发现模板好像是用 Number 设置的。在发送给 DocuSign 之前我可以看到数值。但是打开信封后，数值却不见了。

我应该使用数值吗？还有其他缺少什么吗？

更新：我试过 Numerical 函数，成功了。新问题：如何判断模板中显示的是 Numerical 函数？

   Number n = new Number
   {
        TabLabel = kvp.Key,// name of DS field, e.g. amount
        Value = kvp.Value //e.g. 25.53
   };

   List<Number>? numTabs = [];
   numTabs.Add(n);

   tabs ??= new Tabs();
   tabs.NumberTabs = numTabs ;

   //continue to populate envelope/signer information in envelope definition

这是我的 DocuSign 模板字段定义，例如金额：

使用 DocuSign 的 C# SDK 开发组织的内部应用程序以发送信封/嵌入签名。按照快速入门示例，我可以执行这些操作。由于它使用演示/测试 DocuSign 环境，因此在部署此应用程序时，代码将需要调用 DocuSign 生产环境。

由于组织的员工而不是客户将使用此应用程序，因此代码使用授权码授予，而不是 JWT 令牌。

1. 那么，在获取访问令牌后，代码是否应该从 DocuSignClient 实例调用 SetOAuthBasePath？SDK 表示“使用此方法设置自定义 OAuth 基本路径”。但 DocuSign 又如何知道呢？

2. 我假设对用户的 BaseUri 的 UserInfo 端点调用已经具有正确的环境（因为他们已经过身份验证），然后 BaseUri 将“指向”适当的环境。真的吗？

我看到 C# SDK 确实有我们可以引用的常量。我在生产环境中是否应该使用这些来设置：

public class DocuSignClient
{
    public const string Production_REST_BasePath = "https://www.docusign.net/restapi";

    public const string Demo_REST_BasePath = "https://demo.docusign.net/restapi";
...
}

public class OAuth
{
...
    public static string Demo_OAuth_BasePath = "account-d.docusign.com";

    public static string Production_OAuth_BasePath = "account.docusign.com";
}

代码示例而不是DocuSignClient docuSignClient = new DocuSignClient()：

protected DocuSignClient GetDocuSignClient(bool isForAuth, bool useProd, string? userBaseUri = null)
{
    DocuSignClient rtn = new DocuSignClient();

    //DocuSignClient defaults to demo environment
    if (isForAuth && useProd)
    {
        rtn.SetOAuthBasePath(OAuth.Production_OAuth_BasePath);
    }
    
    if (!isForAuth && !string.IsNullOrEmpty(userBaseUri))
    {
        //we should have a User BaseUri, which will be based on the environment authenticated 
        rtn.SetBasePath(userBaseUri);
    }
    return rtn;
}

我已经在 Laravel 应用程序中实现了 DocuSign，并且目前使用 JWT Grant Authentication 将文档发送给客户进行签名。集成工作正常，但我遇到了一个问题：当我发送带有文档的信封供客户签名时，最初我必须通过 DocuSign 同意页面手动提供同意。

由于我的应用程序设计为后端微服务，通过触发器自动发送文档，因此此手动同意流程会中断流程。我想问一下是否有办法使此同意流程自动化，这样无需人工干预即可发送文档。

是否有任何配置或 API 功能允许应用程序自动同意或预授权，或者在这样的后端服务中使用 DocuSign 时有任何最佳实践？

这是我的负责准备和发送信封的服务类。

 public function getToken(ApiClient $apiClient): string
    {
        try {
            $privateKey = file_get_contents(storage_path(env('DS_KEY_PATH')), true);
            $response = $apiClient->requestJWTUserToken(
                env('DS_CLIENT_ID'),
                env('DS_IMPERSONATED_USER_ID'),
                $privateKey,
                env('DS_JWT_SCOPE')
            );
            $token = $response[0];
            return $token->getAccessToken();
        } catch (\Throwable $th) {
            if (strpos($th->getMessage(), 'consent_required') !== false) {
                throw new \Exception('consent_required');
            }
            throw $th;
        }
    }

    /**
     * Build and return the consent URL
     *
     * @return string
     */
    public function getConsentUrl(): string
    {
        return "https://account-d.docusign.com/oauth/auth?response_type=code&scope=signature%20impersonation&client_id="
            . env('DS_CLIENT_ID')
            . "&redirect_uri=" . urlencode(env('DS_REDIRECT_URI'));
    }

    /**
     * Build the envelope definition from the request
     *
     * @param Request $request
     * @return EnvelopeDefinition
     */
    public function buildEnvelope(Request $request): EnvelopeDefinition
    {
        $fileContent = $request->file('formFile')->get();
        $fileName = $request->file('formFile')->getClientOriginalName();
        $fileExtension = $request->file('formFile')->getClientOriginalExtension();
        $recipientEmail = $request['email'];
        $recipientName = $request['name'];

        $document = new Document([
            'document_id' => "1",
            'document_base64' => base64_encode($fileContent),
            'file_extension' => $fileExtension,
            'name' => $fileName
        ]);

        $sign_here_tab = new SignHere([
            'anchor_string' => "FIRMA CLIENTE",
            'page_number' => "1",
            'anchor_units' => "pixels",
            'anchor_x_offset' => "40",
            'anchor_y_offset' => "40"
        ]);

        $tabs = new Tabs([
            'sign_here_tabs' => [$sign_here_tab]
        ]);

        $signer = new Signer([
            'email' => $recipientEmail,
            'name' => $recipientName,
            'recipient_id' => "1",
            'tabs' => $tabs
        ]);

        $recipients = new Recipients([
            'signers' => [$signer]
        ]);

        $inlineTemplate = new InlineTemplate([
            'recipients' => $recipients,
            'sequence' => "1"
        ]);

        $compositeTemplate = new CompositeTemplate([
            'composite_template_id' => "1",
            'document' => $document,
            'inline_templates' => [$inlineTemplate]
        ]);

        return new EnvelopeDefinition([
            'composite_templates' => [$compositeTemplate],
            'email_subject' => "Please sign",
            'status' => "sent"
        ]);
    }

    /**
     * Send the envelope using the DocuSign API
     *
     * @param ApiClient $apiClient
     * @param string $accountId
     * @param EnvelopeDefinition $envelopeDefinition
     * @return object
     */
    public function sendEnvelope(ApiClient $apiClient, string $accountId, EnvelopeDefinition $envelopeDefinition): object
    {
        $envelopeApi = new EnvelopesApi($apiClient);
        return $envelopeApi->createEnvelope($accountId, $envelopeDefinition);
    }

我一直在查看DocuSign API的网页，想知道给定的“tabs”子元素中的'pageNumber'标签（例如signHereTabs、initialHereTabs、textTabs等）是否是强制性的？

如果我有以下信息要与DocuSign API一起使用，'anchorString'的值'[POS_Xn]'是否会在整个多页文档中搜索，还是我必须通过在'signHereTabs'声明中添加'pageNumber'标签来指定该值存在的页面（在我的情况下是7页中的第4页）？

为了明确，'anchorString'中的值'[POS_Xn]'在要签署的文档中只出现一次。

{
    "emailSubject": "请签署附件文档",
    "emailBlurb": "待签署信息",
    "documents": [
        {
            "documentId": "1",
            "documentBase64": "Base64字符串",
            "name": "Testfile1.pdf"
        }
    ],
    "recipients": {
        "signers": [
            {
                "email": "[email protected]",
                "name": "John Doe",
                "recipientId": "1",
                "routingOrder": "1",
                "tabs": {
                    "signHereTabs": [{
                        "anchorString": "[POS_Xn]",
                        "documentId": "1"
                    }]
                }
            }
        ]
    },
    "status": "sent"
}

如何更改 DocuSign 注册电子邮件地址 我按“我的个人资料”->“电子邮件地址”->“更新”

当我输入新电子邮件时，需要进行验证。我填写完验证码后，还是无法更改。

我通过 Java 中的 API 使用 DocuSign 作为使用签名订单进行开发。第一个收件人收到一封电子邮件并签名，一切正常。现在第二个收件人应该收到一封电子邮件，但不幸的是没有。即使第二个收件人的状态从创建更改为已发送（通过 API 和 DocuSing-Profile）。

我还看到管理配置文件中的更改，那里的状态工作正常，从创建更改为已发送，但收件人没有收到任何电子邮件。

看起来，在使用签名订单时，docusign 在首次收件人后不会发送任何电子邮件。有人经历过这个错误吗？任何想法？

PS：我还尝试了以下方法：

• 无签名订单 -> 所有收件人都会收到电子邮件（包括第二收件人的电子邮件）。
• 更改顺序：第二个收件人成为第一个收件人，反之亦然 -> 第一个收件人正常接收电子邮件，第二个收件人不正常 -> 这意味着电子邮件接收没有问题。