Newsletter des développeurs Vtiger CRM

Par exemple, vous pouvez récupérer des enregistrements spécifiques à un utilisateur avec des détails complets sur l'utilisateur actuellement connecté, en lui accordant l'accès à des informations vitales telles que les préférences, les rôles et les autorisations de l'utilisateur. Vous pouvez également mettre à jour les coordonnées ou d'autres données CRM en temps réel.

Dans cette édition, nous donnons les deux exemples suivants :

Comment récupérer les détails d'un utilisateur actuellement connecté à l'aide de l'API VTAP ?
Comment récupérer les détails de gestion des taxes (tels que les taxes, les frais et les régions fiscales) pour un module d'inventaire à l'aide de l'API VTAP ?

Jetons un coup d'oeil.

Exemple 1 : Afficher un bouton en fonction des rôles des utilisateurs.


  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'
            });
        }
    }
});

Note: Vous obtiendrez le rôle de l'utilisateur à partir de VTAP.user() (informations utilisateur). En fonction du rôle de l'utilisateur, vous pouvez restreindre le bouton comme afficher/masquer.

Exemple 2 - Comment récupérer les détails de gestion des taxes (tels que les taxes, les frais et les régions fiscales) pour un module d'inventaire à l'aide de l'API VTAP ?

Utilisez l'API Describe Core pour récupérer des informations détaillées sur un module d'inventaire spécifique. Par exemple, utilisez l'API Describe Core pour récupérer des informations détaillées sur le module Devis.


  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);
    } 
});

Note:

Dans la réponse de l'API, toutes les informations relatives aux frais et aux taxes peuvent être trouvées sous la clé chargesAndItsTaxes.
Dans la réponse de l'API, les informations relatives aux régions fiscales peuvent être trouvées sous la clé tax_regions.

Exemple 3 - Comment mettre à jour les champs Frais et Remise globale du bloc d'articles d'inventaire ?

3a. Comment mettre à jour les frais à l'aide de l'API VTAP ?

Suivez ces étapes pour mettre à jour les frais :

Récupérez l'enregistrement à l'aide de la méthode VTAP.API.GET.
Accédez à l’objet chargesAndItsTaxes dans la réponse et identifiez chaque frais.
Modifiez la valeur clé pour chaque frais dans l’objet chargesAndItsTaxes.
Envoyez l'objet mis à jour dans la requête Vtap.API.put, en vous assurant de l'inclure sous la clé frais.

Exemple de frais :


  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. Comment mettre à jour la remise globale à l'aide de l'API VTAP ?

La remise globale est soit un montant direct, soit un pourcentage. Nous devons donc envoyer le type de remise ainsi que le montant de la remise.

Exemple de remise globale de type montant :


  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) => {});

Exemple de remise globale de type pourcentage :


  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) => {});

Nous pensons que ces exemples amélioreront votre expérience avec les API VTAP, en vous assurant de récupérer exactement les données dont vous avez besoin. Restez à l'écoute pour en savoir plus.

Bonne codage!

Inscrivez-vous pour recevoir les dernières mises à jour!

J'autorise Vtiger à envoyer des mises à jour sur les nouveautés et autres lectures intéressantes.

J'ai lu politique de confidentialité de Vtiger.