Vtiger CRM-Entwickler-Newsletter

Problemzusammenfassung

Bei der Verwaltung verwandter Datensätze über mehrere Module hinweg stehen Benutzer häufig vor operativen Hürden wie:

Aufheben der Verknüpfung zugehöriger Datensätze (z. B. Entfernen einer zugehörigen Rechnung oder eines Kontakts aus einem Deal).
Dauerhaftes Löschen veralteter Einträge (wie inaktive Abonnements).
Ausführen komplexer Filter mit mehreren Bedingungen zum Abrufen bestimmter Datensätze (z. B. Zahlungen mit definierten Status oder Wiederholungsversuchen).

Das manuelle Ausführen dieser Aufgaben oder mit unklarer API-Anleitung kann zu Ineffizienzen, einem erhöhten Risiko von Datenverlusten und Inkonsistenzen bei der Logikimplementierung führen.

Ziel

Zeigen Sie, wie Sie mithilfe von VTAP programmgesteuert die Verknüpfung verwandter Datensätze mit einem übergeordneten Modul aufheben.
Zeigen Sie, wie Sie einen Datensatz sicher aus einem Modul löschen.
Stellen Sie eine strukturierte Methode bereit, um Datensätze basierend auf mehreren Bedingungen mithilfe des q-Parameters zu filtern.
Teilen Sie Best Practices zum dynamischen Abrufen von Beziehungs-IDs über die API, um Flexibilität und Wartbarkeit zu gewährleisten.

Implementierungsdetails

Aufheben der Verknüpfung eines zugehörigen Datensatzes:

Um eine Beziehung zwischen zwei Datensätzen zu entfernen (z. B. die Verknüpfung einer Rechnung mit einem potenziellen Kunden aufzuheben), verwenden Sie den folgenden Codeausschnitt:


  VTAP.Api.Delete('records/relationrecords', {
    module: 'Potentials',
    related_module: 'Invoice',
    id: ‘WXYZ’,
    related_record_id: ‘ABCD’,
    relation_id: ‘1234’
}, (error, response) => {
    console.log(response);
});


  VTAP.Api.Delete('records/relationrecords', {
    module: 'Potentials',
    related_module: 'Invoice',
    id: ‘WXYZ’,
    related_record_id: ‘ABCD’,
    relation_id: ‘1234’
}, (error, response) => {
    console.log(response);
});

Dadurch wird lediglich die Verknüpfung des Datensatzes aufgehoben. Die ursprüngliche Rechnung und das Potenzial bleiben erhalten.

So rufen Sie die relation_id dynamisch ab:


  VTAP.Detail.Relations('Potentials').then((relations) => {
    console.log(relations);
});


  VTAP.Detail.Relations('Potentials').then((relations) => {
    console.log(relations);
});

Dadurch werden alle zugehörigen Metadaten für das Modul „Potentials“ zurückgegeben, einschließlich Beziehungs-IDs und Beschriftungen.

Löschen eines Datensatzes:


  To delete a record (for example, a Subscription), use:
VTAP.Api.Delete('records', {
    module: 'Subscription',
    id: '596'
}, (error, response) => {
    console.log(response);
});


  To delete a record (for example, a Subscription), use:
VTAP.Api.Delete('records', {
    module: 'Subscription',
    id: '596'
}, (error, response) => {
    console.log(response);
});

Dadurch wird der Abonnementdatensatz mit der ID 596 dauerhaft entfernt. Verwenden Sie dies nur, wenn der Datensatz nicht mehr benötigt wird.

Filtern von Datensätzen mit dem Parameter q:

So rufen Sie Datensätze aus dem Zahlungsmodul basierend auf mehreren Filterbedingungen ab:


  VTAP.Api.Get("records", {
    module: "Payments",
    q: [[
            ["retrycounter", "equal", ["2"]],
            ["createdtime", "greater", ["2025-05-27"]],
            ["cf_payments_internetdisabledbyvtiger", "equal", ["0"]],
            ["paymentsstatus", "n", ["Received"]]
       ]]
}, (error, response) => {
    if (error) {
        console.error("Error:", error);
    } else {
        console.log(response);
    }
});


  VTAP.Api.Get("records", {
    module: "Payments",
    q: [[
            ["retrycounter", "equal", ["2"]],
            ["createdtime", "greater", ["2025-05-27"]],
            ["cf_payments_internetdisabledbyvtiger", "equal", ["0"]],
            ["paymentsstatus", "n", ["Received"]]
       ]]
}, (error, response) => {
    if (error) {
        console.error("Error:", error);
    } else {
        console.log(response);
    }
});

Vorteile

Effizientes Datensatzmanagement: Automatisiert das Aufheben von Verknüpfungen und das Löschen von Daten, spart Zeit und reduziert menschliche Fehler.
Bessere Kontrolle: Entwickler haben genaue Kontrolle darüber, welche Datensätze betroffen sind, was die Datenintegrität verbessert.
Erweiterte Filterung: Der q-Parameter ermöglicht komplexe Abfragen mit mehreren Bedingungen und minimiert unnötige API-Aufrufe.
Entwicklerfreundlich: Vollständige Unterstützung der asynchronen JavaScript-Syntax (async/await), wodurch die Integration in VTAP-Umgebungen reibungslos verläuft.

Wir glauben, dass diese Beispiele Ihre Erfahrung mit Vtiger CRM verbessern werden. Wir möchten sicherstellen, dass Entwickler und CRM-Benutzer Informationen und Wissen austauschen können, um die Funktionalität des CRM zu verbessern.

Bleiben Sie dran für mehr. Viel Spaß beim Programmieren!

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.