Vtiger CRM Developer Newsletter

Zhrnutie problému

Pri správe súvisiacich záznamov v rôznych moduloch sa používatelia často stretávajú s prevádzkovými prekážkami, ako napríklad:

Odpojenie súvisiacich záznamov (napr. odstránenie priradenej faktúry alebo kontaktu z obchodu).
Trvalé odstránenie zastaraných položiek (ako napríklad neaktívnych predplatných).
Vykonávanie zložitých filtrov s viacerými podmienkami na načítanie špecifických súborov údajov (ako sú platby s definovanými stavmi alebo opakované pokusy).

Manuálne vykonávanie týchto úloh alebo s nejasnými pokynmi API môže viesť k neefektívnosti, zvýšenému riziku straty údajov a nekonzistentnostiam v implementácii logiky.

Objektívne

Ukážte, ako programovo odpojiť súvisiace záznamy od nadradeného modulu pomocou VTAP.
Ukážte, ako bezpečne odstrániť záznam z modulu.
Poskytnite štruktúrovanú metódu na filtrovanie záznamov na základe viacerých podmienok pomocou parametra q.
Zdieľajte osvedčené postupy na dynamické načítanie ID relácií prostredníctvom rozhrania API pre flexibilitu a údržbu.

Podrobnosti o implementácii

Zrušenie prepojenia súvisiaceho záznamu:

Ak chcete odstrániť vzťah medzi dvoma záznamami (napríklad zrušenie prepojenia faktúry s potenciálom), použite nasledujúci úryvok kódu:


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

Týmto sa iba odpojí záznam. Pôvodná faktúra a potenciál zostanú nedotknuté.

Ako dynamicky načítať relation_id:


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


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

Toto vráti všetky súvisiace metadáta pre modul Potenciály vrátane ID vzťahov a označení.

Odstránenie záznamu:


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

Týmto sa natrvalo odstráni záznam predplatného s ID 596. Použite to iba vtedy, keď už záznam nie je potrebný.

Filtrovanie záznamov pomocou parametra q:

Ak chcete načítať záznamy z modulu Platby na základe viacerých podmienok filtrovania:


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

Výhody

Efektívna správa záznamovAutomatizuje procesy odpojenia a vymazania, čím šetrí čas a znižuje ľudské chyby.
Lepšia kontrolaVývojári majú presnú kontrolu nad tým, ktoré záznamy sú ovplyvnené, čím sa zlepšuje integrita údajov.
Rozšírené filtrovanieParameter q umožňuje komplexné dotazy s viacerými podmienkami, čím minimalizuje nepotrebné volania API.
Priateľský pre vývojárovPlne podporuje asynchrónnu syntax JavaScriptu (async/await), čo uľahčuje integráciu v prostrediach VTAP.

Veríme, že tieto príklady zlepšia vaše skúsenosti s Vtiger CRM. Chceme zabezpečiť, aby si vývojári a používatelia CRM mohli vzájomne vymieňať informácie a znalosti na podporu funkčnosti CRM.

Zostaňte naladení na ďalšie. Šťastné kódovanie!

Prihláste sa a získajte najnovšie aktualizácie!

Poskytujem spoločnosti Vtiger súhlas so zasielaním aktualizácií noviniek a iných zaujímavých informácií.

Prečítal som si zásady ochrany osobných údajov Vtigera.

Autorské práva 2026 Vtiger. Všetky práva vyhradené. Rôzne ochranné známky vlastnené ich príslušnými vlastníkmi.