tencentcloud-sdk-nodejs 4.0.674 → 4.0.676

package/src/services/ess/v20201111/ess_client.ts

@@ -28,10 +28,10 @@ import {
   DescribeIntegrationDepartmentsResponse,
   FileInfo,
   CreateFlowApproversResponse,
-  DescribeIntegrationMainOrganizationUserRequest,
+  DescribeFileUrlsResponse,
   ModifyApplicationCallbackInfoResponse,
   CreateMultiFlowSignQRCodeResponse,
-  FlowCreateApprover,
+  FlowApproverUrlInfo,
   ReviewerInfo,
   DescribeThirdPartyAuthCodeResponse,
   HasAuthUser,
@@ -46,7 +46,7 @@ import {
   StartFlowResponse,
   SealInfo,
   StaffRole,
-  FlowApproverUrlInfo,
+  CreateIntegrationRoleRequest,
   AuthorizedUser,
   CreateConvertTaskApiRequest,
   DeleteIntegrationEmployeesResponse,
@@ -62,17 +62,19 @@ import {
   TemplateInfo,
   CreateDocumentResponse,
   DescribeIntegrationEmployeesRequest,
+  UnbindEmployeeUserIdWithClientOpenIdResponse,
   CreateIntegrationUserRolesResponse,
   CreateFlowRequest,
   CreateSchemeUrlRequest,
   DeleteIntegrationDepartmentResponse,
   AutoSignConfig,
   DescribeThirdPartyAuthCodeRequest,
-  UnbindEmployeeUserIdWithClientOpenIdResponse,
+  DescribeIntegrationMainOrganizationUserRequest,
   CreateReleaseFlowResponse,
   CreateWebThemeConfigResponse,
   BindEmployeeUserIdWithClientOpenIdRequest,
   DescribeIntegrationDepartmentsRequest,
+  Permission,
   CreateIntegrationDepartmentResponse,
   DescribeFlowTemplatesRequest,
   DeleteSealPoliciesResponse,
@@ -97,15 +99,18 @@ import {
   CreateUserAutoSignEnableUrlResponse,
   FlowGroupInfo,
   CreateFlowSignUrlResponse,
+  RegisterInfo,
   DescribeFileUrlsRequest,
   FormField,
   CreateChannelSubOrganizationModifyQrCodeRequest,
   UserInfo,
   CreateFlowApproversRequest,
+  ModifyIntegrationRoleResponse,
+  FlowCreateApprover,
   Staff,
   RecipientComponentInfo,
   CreateFlowEvidenceReportResponse,
-  DescribeFileUrlsResponse,
+  CreateIntegrationRoleResponse,
   DescribeFlowComponentsRequest,
   CreateIntegrationDepartmentRequest,
   GroupOrganization,
@@ -119,7 +124,7 @@ import {
   FailedUpdateStaffData,
   GetTaskResultApiRequest,
   FlowGroupOptions,
-  RegisterInfo,
+  ModifyIntegrationRoleRequest,
   CreateFlowGroupByFilesResponse,
   CreateIntegrationEmployeesResponse,
   DeleteIntegrationRoleUsersRequest,
@@ -166,6 +171,7 @@ import {
   CreateEmbedWebUrlResponse,
   CreateSealPolicyRequest,
   DescribeOrganizationSealsRequest,
+  PermissionGroup,
   CancelFlowRequest,
   UploadFile,
   Component,
@@ -312,13 +318,22 @@ callbackinfo包含： 回调地址和签名key
   }
 
   /**
-   * 对企业员工进行印章授权
-   */
-  async CreateSealPolicy(
-    req: CreateSealPolicyRequest,
-    cb?: (error: string, rep: CreateSealPolicyResponse) => void
-  ): Promise<CreateSealPolicyResponse> {
-    return this.request("CreateSealPolicy", req, cb)
+     * 此接口（CreateIntegrationRole）用来创建企业自定义的SaaS角色或集团角色。
+
+适用场景1：创建当前企业的自定义SaaS角色或集团角色，并且创建时不进行权限的设置（PermissionGroups 参数不传），角色中的权限内容可通过控制台编辑角色或通过接口 ModifyIntegrationRole 完成更新。
+
+适用场景2：创建当前企业的自定义SaaS角色或集团角色，并且创建时进行权限的设置（PermissionGroups 参数要传），权限树内容 PermissionGroups 可参考接口 DescribeIntegrationRoles 的输出。
+适用场景3：创建集团角色时可同时设置角色管理的子企业列表，可通过设置 SubOrganizationIds 参数达到此效果。
+
+适用场景4：主企业代理子企业操作的场景，需要设置Agent参数，并且ProxyOrganizationId设置为子企业的id即可。
+
+注意事项：SaaS角色和集团角色对应的权限树是不一样的。
+     */
+  async CreateIntegrationRole(
+    req: CreateIntegrationRoleRequest,
+    cb?: (error: string, rep: CreateIntegrationRoleResponse) => void
+  ): Promise<CreateIntegrationRoleResponse> {
+    return this.request("CreateIntegrationRole", req, cb)
   }
 
   /**
@@ -332,7 +347,7 @@ callbackinfo包含： 回调地址和签名key
   }
 
   /**
-   * 对流程的合同文件进行验证，判断文件是否合法。
+   * 对流程的合同文件进行数字签名验证，判断文件是否被篡改。
    */
   async VerifyPdf(
     req: VerifyPdfRequest,
@@ -485,6 +500,10 @@ callbackinfo包含： 回调地址和签名key
 - 模板中配置的签署顺序是无序
 - B端企业的签署方式是静默签署
 - B端企业是非首位签署
+
+ 通过一码多扫二维码发起的合同，涉及到的合同回调消息可参考文档[合同发起以及签署相关回调](https://qian.tencent.com/developers/company/callback_types_contracts_sign)
+
+用户通过签署二维码发起合同时，因企业额度不足导致失败 会触发签署二维码相关回调,具体参考文档[签署二维码相关回调](https://qian.tencent.com/developers/company/callback_types_commons#%E7%AD%BE%E7%BD%B2%E4%BA%8C%E7%BB%B4%E7%A0%81%E7%9B%B8%E5%85%B3%E5%9B%9E%E8%B0%83)
      */
   async CreateMultiFlowSignQRCode(
     req: CreateMultiFlowSignQRCodeRequest,
@@ -574,6 +593,22 @@ callbackinfo包含： 回调地址和签名key
     return this.request("CreateChannelSubOrganizationModifyQrCode", req, cb)
   }
 
+  /**
+     * 此接口（UploadFiles）用于文件上传。<br/>
+适用场景：用于生成pdf资源编号（FileIds）来配合“用PDF创建流程”接口使用，使用场景可详见“用PDF创建流程”接口说明。<br/>
+
+其中上传的文件，图片类型(png/jpg/jpeg)大小限制为5M，其他大小限制为60M。<br/>
+调用时需要设置Domain/接口请求域名为 file.ess.tencent.cn,代码示例：<br/>
+HttpProfile httpProfile = new HttpProfile();<br/>
+httpProfile.setEndpoint("file.test.ess.tencent.cn");<br/>
+     */
+  async UploadFiles(
+    req: UploadFilesRequest,
+    cb?: (error: string, rep: UploadFilesResponse) => void
+  ): Promise<UploadFilesResponse> {
+    return this.request("UploadFiles", req, cb)
+  }
+
   /**
    * 查询出证报告，返回报告 URL。出证报告编号通过CreateFlowEvidenceReport接口获取。
    */
@@ -685,9 +720,8 @@ callbackinfo包含： 回调地址和签名key
   }
 
   /**
-     * 上传了word、excel、图片文件后，通过该接口发起文件转换任务，将word、excel、图片文件转换为pdf文件。
-注：如果是集团代子企业发起任务场景，可以通过对Agent参数（未列在入参列表）设置代理的相关应用信息来支持，Agent参数设置可以参考CreateFlow接口的Agent相关说明。
-     */
+   * 上传了word、excel、图片文件后，通过该接口发起文件转换任务，将word、excel、图片文件转换为pdf文件。
+   */
   async CreateConvertTaskApi(
     req: CreateConvertTaskApiRequest,
     cb?: (error: string, rep: CreateConvertTaskApiResponse) => void
@@ -718,19 +752,32 @@ callbackinfo包含： 回调地址和签名key
   }
 
   /**
-     * 此接口（UploadFiles）用于文件上传。<br/>
-适用场景：用于生成pdf资源编号（FileIds）来配合“用PDF创建流程”接口使用，使用场景可详见“用PDF创建流程”接口说明。<br/>
+     * 此接口（ModifyIntegrationRole）用来更新企业自定义的SaaS角色或集团角色。
 
-其中上传的文件，图片类型(png/jpg/jpeg)大小限制为5M，其他大小限制为60M。<br/>
-调用时需要设置Domain/接口请求域名为 file.ess.tencent.cn,代码示例：<br/>
-HttpProfile httpProfile = new HttpProfile();<br/>
-httpProfile.setEndpoint("file.test.ess.tencent.cn");<br/>
+适用场景1：更新当前企业的自定义SaaS角色或集团角色，并且更新时不进行角色中权限的更新（PermissionGroups 参数不传）。
+
+适用场景2：更新当前企业的自定义SaaS角色或集团角色，并且更新时进行角色中权限的设置（PermissionGroups 参数要传），权限树内容 PermissionGroups 可参考接口 DescribeIntegrationRoles 的输出。
+适用场景3：更新集团角色管理的子企业列表，可通过设置 SubOrganizationIds 参数达到此效果。
+
+适用场景4：主企业代理子企业操作的场景，需要设置Agent参数，并且ProxyOrganizationId设置为子企业的id即可。
+
+注意事项：SaaS角色和集团角色对应的权限树是不一样的。
      */
-  async UploadFiles(
-    req: UploadFilesRequest,
-    cb?: (error: string, rep: UploadFilesResponse) => void
-  ): Promise<UploadFilesResponse> {
-    return this.request("UploadFiles", req, cb)
+  async ModifyIntegrationRole(
+    req: ModifyIntegrationRoleRequest,
+    cb?: (error: string, rep: ModifyIntegrationRoleResponse) => void
+  ): Promise<ModifyIntegrationRoleResponse> {
+    return this.request("ModifyIntegrationRole", req, cb)
+  }
+
+  /**
+   * 对企业员工进行印章授权
+   */
+  async CreateSealPolicy(
+    req: CreateSealPolicyRequest,
+    cb?: (error: string, rep: CreateSealPolicyResponse) => void
+  ): Promise<CreateSealPolicyResponse> {
+    return this.request("CreateSealPolicy", req, cb)
   }
 
   /**