Vtiger CRM-Entwickler-Newsletter

Sie können beispielsweise benutzerspezifische Datensätze mit umfassenden Details zum aktuell angemeldeten Benutzer abrufen und so Zugriff auf wichtige Informationen wie Benutzereinstellungen, Rollen und Berechtigungen gewähren. Sie können auch Kontaktdaten oder andere CRM-Daten in Echtzeit aktualisieren.

In dieser Ausgabe geben wir folgende zwei Beispiele:

Wie rufe ich die Details eines aktuell angemeldeten Benutzers mithilfe der VTAP-API ab?
Wie rufe ich mithilfe der VTAP-API Steuerverwaltungsdetails (z. B. Steuern, Gebühren und Steuerregionen) für ein Inventarmodul ab?

Lassen Sie uns einen Blick darauf werfen.

Beispiel 1: Zeigen Sie eine Schaltfläche basierend auf den Rollen der Benutzer an.


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

Hinweis: Sie erhalten die Rolle des Benutzers von VTAP.user() (Benutzerinformationen). Basierend auf der Benutzerrolle können Sie die Schaltflächen einschränken, z. B. Anzeigen/Ausblenden.

Beispiel 2 – Wie ruft man mithilfe der VTAP-API Steuerverwaltungsdetails (wie Steuern, Gebühren und Steuerregionen) für ein Inventarmodul ab?

Verwenden Sie die Describe Core API, um ausführliche Informationen zu einem bestimmten Inventarmodul abzurufen. Verwenden Sie beispielsweise die Describe Core API, um ausführliche Informationen zum Modul „Angebote“ abzurufen.


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

Hinweis:

In der API-Antwort sind alle Informationen zu Gebühren und Steuern unter dem Schlüssel „chargesAndItsTaxes“ zu finden.
In der API-Antwort sind die Informationen zu Steuerregionen unter dem Schlüssel „tax_regions“ zu finden.

Beispiel 3: Wie aktualisiere ich die Felder „Gebühren“ und „Gesamtrabatt“ im Block „Lagerposition“?

3a. Wie aktualisiere ich Gebühren mithilfe der VTAP-API?

Gehen Sie folgendermaßen vor, um Gebühren zu aktualisieren:

Rufen Sie den Datensatz mit der Methode VTAP.API.GET ab.
Greifen Sie in der Antwort auf das Objekt „chargesAndItsTaxes“ zu und identifizieren Sie jede Gebühr.
Ändern Sie den Schlüsselwert für jede Gebühr innerhalb des Objekts „chargesAndItsTaxes“.
Senden Sie das aktualisierte Objekt in der Vtap.API.put-Anfrage und stellen Sie sicher, dass Sie es unter dem Gebührenschlüssel einschließen.

Beispiel für Gebühren:


  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. Wie aktualisiere ich den Gesamtrabatt mithilfe der VTAP-API?

Der Gesamtrabatt ist entweder ein direkter Betrag oder ein Prozentsatz, daher müssen wir die Rabattart zusammen mit dem Rabattbetrag senden.

Beispiel für einen Gesamtrabatt vom Typ „Betrag“:


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

Beispiel für einen Pauschalrabatt vom Typ „Prozent“:


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

Wir sind überzeugt, dass diese Beispiele Ihre Erfahrung mit VTAP-APIs verbessern und sicherstellen, dass Sie genau die Daten abrufen, die Sie benötigen. Bleiben Sie dran für mehr.

Viel Spaß beim Codieren!

Melden Sie sich an, um die neuesten Updates zu erhalten!

Ich erkläre mich damit einverstanden, dass Vtiger Updates zu Neuigkeiten und anderen interessanten Lektüren sendet.

Ich habe die datenschutzerklärung von Vtiger.