Vtiger CRM 开发人员通讯 | 2024 年 XNUMX 月

例如，您可以获取特定于用户的记录，其中包含有关当前登录用户的全面详细信息，并授予对用户偏好、角色和权限等重要信息的访问权限。您还可以实时更新联系人详细信息或其他 CRM 数据。

在本版中，我们给出以下两个示例：

如何使用 VTAP API 检索当前登录用户的详细信息？
如何使用 VTAP API 检索库存模块的税务管理详细信息（例如税金、费用和税区）？

让我们来看看。

示例 1：根据用户的角色显示按钮。


  var Contacts_Component_ListViewExamples = VTAP.Component.Core.extend({
    created() {
        var userInfo = VTAP.User();
        var userRole = userInfo.roleid.label;

        // Define the roles allowed to view the button
        var allowedRoles = ['CEO','Sales Manager'];
        if (allowedRoles.includes(userRole)) {
            VTAP.Component.Register('LIST_BASIC_BUTTON', {
                label: 'Custom Page',
                clickHandler: () => {
                    window.location.href = " ";  
                },
                icon: 'fa-check',
                variant: 'primary'
            });
        }
    }
});


  var Contacts_Component_ListViewExamples = VTAP.Component.Core.extend({
    created() {
        var userInfo = VTAP.User();
        var userRole = userInfo.roleid.label;

        // Define the roles allowed to view the button
        var allowedRoles = ['CEO','Sales Manager'];
        if (allowedRoles.includes(userRole)) {
            VTAP.Component.Register('LIST_BASIC_BUTTON', {
                label: 'Custom Page',
                clickHandler: () => {
                    window.location.href = " ";  
                },
                icon: 'fa-check',
                variant: 'primary'
            });
        }
    }
});

注意：：您将从 VTAP.user()（用户信息）获取用户的角色。根据用户角色，您可以限制按钮的显示/隐藏。

示例 2 - 如何使用 VTAP API 检索库存模块的税务管理详细信息（例如税金、费用和税区）？

使用 Describe Core API 检索有关特定库存模块的详细信息。例如，使用 Describe Core API 获取有关 Quotes 模块的详细信息。


  VTAP.Api.Get("describe", { 
    "module": "Quotes", 
}, (error, response) => {
    if (error) {
        console.error("Error:", error);
    } 
});


  VTAP.Api.Get("describe", { 
    "module": "Quotes", 
}, (error, response) => {
    if (error) {
        console.error("Error:", error);
    } 
});

注意：:

在 API 响应中，所有与费用和税费相关的信息都可以在 chargeAndItsTaxes 键下找到。
在 API 响应中，可以在 tax_regions 键下找到与税务区域相关的信息。

示例 3 - 如何更新库存明细项目块字段费用和总折扣？

3a. 如何使用 VTAP API 更新费用？

请按照以下步骤更新费用：

使用 VTAP.API.GET 方法检索记录。
访问响应中的 chargeAndItsTaxes 对象并识别每项费用。
修改 chargeAndItsTaxes 对象中每项费用的键值。
在 Vtap.API.put 请求中发送更新的对象，确保将其包含在费用键下。

收费示例：


  VTAP.Api.Put('records', {
        module: 'Quotes',
        id: VTAP.Detail.Id(),
        hdnProductId1:<product_id>,
        totalProductCount: 1,
        charges: {}
    }, (error, response) => {});


  VTAP.Api.Put('records', {
        module: 'Quotes',
        id: VTAP.Detail.Id(),
        hdnProductId1:<product_id>,
        totalProductCount: 1,
        charges: {}
    }, (error, response) => {});

3b. 如何使用 VTAP API 更新整体折扣？

整体折扣可以是直接金额或百分比，因此我们需要将折扣类型与折扣金额一起发送。

金额类型的总体折扣示例：


  VTAP.Api.Put('records', {
        module: 'Quotes',
        id: VTAP.Detail.Id(),
        hdnProductId1: 490,
        totalProductCount: 1,
        discount_amount_final: 500,
        discount_type_final: 'amount',
    }, (error, response) => {});


  VTAP.Api.Put('records', {
        module: 'Quotes',
        id: VTAP.Detail.Id(),
        hdnProductId1: 490,
        totalProductCount: 1,
        discount_amount_final: 500,
        discount_type_final: 'amount',
    }, (error, response) => {});

百分比类型的总体折扣示例：


  VTAP.Api.Put('records', {
        module: 'Quotes',
        id: VTAP.Detail.Id(),
        hdnProductId1: 490,
        totalProductCount: 1,
        discount_percentage_final: 10,
        discount_type_final: 'percentage',
    }, (error, response) => {});


  VTAP.Api.Put('records', {
        module: 'Quotes',
        id: VTAP.Detail.Id(),
        hdnProductId1: 490,
        totalProductCount: 1,
        discount_percentage_final: 10,
        discount_type_final: 'percentage',
    }, (error, response) => {});

我们相信这些示例将改善您使用 VTAP API 的体验，确保您准确检索所需的数据。敬请期待更多内容。

编码愉快！

注册以接收最新更新！

我同意 Vtiger 发送新内容和其他有趣读物的更新。

我已阅读私隐政策 Vtiger。