Vtiger CRM-ontwikkelaarsnieuwsbrief

U kunt bijvoorbeeld gebruikerspecifieke records ophalen met uitgebreide details over de momenteel ingelogde gebruiker, waardoor u toegang krijgt tot essentiële informatie zoals gebruikersvoorkeuren, rollen en machtigingen. U kunt ook contactgegevens of andere CRM-gegevens in realtime bijwerken.

In deze editie geven we de volgende twee voorbeelden:

Hoe kan ik de gegevens van een momenteel ingelogde gebruiker ophalen met behulp van de VTAP API?
Hoe kan ik belastingbeheergegevens (zoals belastingen, toeslagen en belastingregio's) voor een inventarismodule ophalen met behulp van de VTAP API?

Laten we eens kijken.

Voorbeeld 1: Een knop weergeven op basis van de rollen van de gebruikers.


  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: U krijgt de rol van de gebruiker van VTAP.user() (gebruikersinfo). Op basis van de gebruikersrol kunt u de knop beperken, zoals weergeven/verbergen.

Voorbeeld 2 - Hoe kan ik belastingbeheergegevens (zoals belastingen, toeslagen en belastingregio's) voor een inventarismodule ophalen met behulp van de VTAP API?

Gebruik de Describe Core API om gedetailleerde informatie over een specifieke inventarismodule op te halen. Gebruik bijvoorbeeld de Describe Core API om gedetailleerde informatie over de Quotes-module op te halen.


  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:

In het API-antwoord vindt u alle informatie over kosten en belastingen onder de sleutel chargesAndItsTaxes.
In het API-antwoord is de informatie met betrekking tot belastingregio's te vinden onder de sleutel tax_regions.

Voorbeeld 3 - Hoe kan ik de velden Kosten en Algemene korting in het blok Voorraadregelartikel bijwerken?

3a. Hoe kan ik kosten bijwerken met behulp van de VTAP API?

Volg deze stappen om kosten bij te werken:

Haal het record op met de VTAP.API.GET-methode.
Open het chargesAndItsTaxes-object in het antwoord en identificeer elke kostenpost.
Wijzig de sleutelwaarde voor elke kostenpost binnen het chargesAndItsTaxes-object.
Verstuur het bijgewerkte object in de Vtap.API.put-aanvraag en zorg ervoor dat u het onder de sleutel charges opneemt.

Voorbeeld van kosten:


  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. Hoe kan ik de algemene korting bijwerken met behulp van de VTAP API?

De totale korting is een bedrag of een percentage. Daarom moeten we het kortingstype samen met het kortingsbedrag meesturen.

Voorbeeld voor algemene korting van het type bedrag:


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

Voorbeeld voor algemene korting van het type percentage:


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

Wij geloven dat deze voorbeelden uw ervaring met VTAP API's zullen verbeteren, zodat u precies de gegevens ophaalt die u nodig hebt. Blijf op de hoogte voor meer.

Veel plezier met coderen!

Schrijf je in om de laatste updates te ontvangen!

Ik geef toestemming aan Vtiger om updates te sturen van nieuwe en andere interessante artikelen.

Ik heb de Privacybeleid van Vtiger.