如何删除“发件人视图”创建的锁？

Question

在我的应用程序中，我为信封创建了一个仪表板，其中包含一个表单，用户可以在其中编辑基本的信封收件人信息，表单的操作捕获更改并发出PUT请求以更新DocuSign上的信息。此仪表板上还有发件人视图，它在后台加载，当用户单击Bootstrapnav-tab时可见。

在通过表单将更改保存给收件人时，我遇到一个错误：

"errorCode": "EDIT_LOCK_NOT_LOCK_OWNER",\\r\\n  "message": "The user is not the owner of the lock. The envelope is locked by another user or in another application"\\r\\n}'

我认为这是由于发送者视图在后台加载，因此在没有首先单击发送者视图iFrame中的“放弃更改”的情况下阻止了对信封的更改。不幸的是，我不能指望我的用户每次都要对信封进行更改。即使我在实际需要之前不加载发件人视图iFrame，我仍然不相信用户在提交表单之前放弃更改。

我已经尝试删除锁，但这证明是不成功的，我必须等待锁超时，然后才能再次使用发件人视图。

API是否提供了任何解决方案来强制移除信封上的锁或复制发送方视图的“放弃更改”操作？

Answer 1

您可以使用以下代码

    var config = new Configuration(new ApiClient(basePath));
    config.AddDefaultHeader("Authorization", "Bearer " + accessToken);
    var envelopesApi = new EnvelopesApi(config);
    try
    {
       // this line will throw error if envelope is not locked, so handle it using try & catch block
       LockInformation lockInfo = envelopesApi.GetLock(accountId, envelopeId);

       // check if this app locked it
        if (lockInfo?.LockDurationInSeconds?.Length > 0)
       {
           // add a header with the LockToken to ensure this app has the right to unlock 
            string LockHeader = $"{{\"lockToken\":\"{lockInfo.LockToken}\"}}";
            envelopesApi.Configuration.AddDefaultHeader("X-DocuSign-Edit", LockHeader);
            envelopesApi.DeleteLock(accountId, envelopeId);
       }
    }
    catch (ApiException exp)
    {      
       // Do Whatever you want to do
       
    }

我在“如何解锁Docusign信封”中找到了这个

Answer 2

您是对的，很遗憾无法删除发件人视图锁。锁只能使用由lockedByApp（与lockedByUser相反）授予的令牌删除。使用发件人视图，经典DocuSign体验（CDE）或新DocuSign体验（NDSE）都是lockedByApp，GET不包括令牌。

发件人视图：

{
  "lockedByUser": {
    "userName": "Rickey S",
    "userId": "xxxxxxxx-2c1d-493a-89d7-6bb3117b52bf",
    "uri": "/users/xxxxxxxx-2c1d-493a-89d7-6bb3117b52bf"
  },
  "lockedByApp": "New DocuSign Experience",
  "lockedUntilDateTime": "2016-06-15T05:34:16.8600000Z",
  "lockType": "edit"
}

API生成的锁：

{
  "lockedByUser": {
    "userName": "Rickey S",
    "userId": "xxxxxxxx-2c1d-493a-89d7-6bb3117b52bf",
    "uri": "/users/xxxxxxxx-2c1d-493a-89d7-6bb3117b52bf"
  },
  "lockedByApp": "Rickey Postman",
  "lockedUntilDateTime": "2016-06-15T05:33:30.6270000Z",
  "lockDurationInSeconds": "120",
  "lockType": "edit",
  "useScratchPad": "false",
  "lockToken": "xxxxxxxxxxAtZmQ4NS00YzNjLTllN2ItZjExMzE3MzliODgy"
}