Vtiger CRM Developer ניוזלטר

סיכום הבעיה

בעת ניהול רשומות קשורות בין מודולים, משתמשים נתקלים לעיתים קרובות במכשולים תפעוליים כגון:

ניתוק קישור של רשומות קשורות (למשל, הסרת חשבונית או איש קשר משויכים מעסקה).
מחיקה לצמיתות של רשומות מיושנות (כגון מנויים לא פעילים).
ביצוע מסננים מורכבים מרובי תנאים כדי לאחזר מערכי נתונים ספציפיים (כגון תשלומים עם סטטוסים מוגדרים או ניסיונות ניסיון חוזר).

ביצוע משימות אלו באופן ידני או עם הנחיות API לא ברורות עלול להוביל לחוסר יעילות, סיכון מוגבר לאובדן נתונים וחוסר עקביות ביישום הלוגיקה.

מַטָרָה

הדגם כיצד לנתק קישור של רשומות קשורות ממודול אב באמצעות VTAP באופן תכנותי.
הראה כיצד למחוק רשומה ממודול בצורה בטוחה.
ספק שיטה מובנית לסינון רשומות על סמך תנאים מרובים באמצעות הפרמטר q.
שתף שיטות עבודה מומלצות לאחזור מזהי קשרים באופן דינמי באמצעות API לצורך גמישות וקלות תחזוקה.

פרטי היישום

ביטול קישור של רשומה קשורה:

כדי להסיר קשר בין שתי רשומות (לדוגמה, ניתוק קישור של חשבונית מרשומה פוטנציאלית), השתמש בקטע הבא:


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

פעולה זו תבטל רק את הקישור של הרשומה. החשבונית והפוטנציאל המקוריים יישארו שלמים.

כיצד לאחזר באופן דינמי את ה-relation_id:


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


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

פעולה זו מחזירה את כל המטא-דאטה הקשורים למודול Potentials, כולל מזהי קשר ותוויות.

מחיקת רשומה:


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

פעולה זו תסיר לצמיתות את רשומת המנוי עם מזהה 596. השתמש באפשרות זו רק כאשר הרשומה אינה נחוצה עוד.

סינון רשומות באמצעות הפרמטר q:

כדי לאחזר רשומות ממודול התשלומים בהתבסס על מספר תנאי סינון:


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

הטבות

ניהול רשומות יעילאוטומציה של תהליכי ניתוק ומחיקה, חוסכת זמן ומפחיתה טעויות אנוש.
שליטה טובה יותרלמפתחים יש שליטה מדויקת על אילו רשומות מושפעות, מה שמשפר את שלמות הנתונים.
סינון מתקדםהפרמטר q מאפשר שאילתות מורכבות מרובות תנאים, וממזער קריאות API מיותרות.
ידידותי למפתחיםתמיכה מלאה בתחביר אסינכרוני של JavaScript (async/await), מה שהופך את האינטגרציה לחלקה בסביבות VTAP.

אנו מאמינים שדוגמאות אלו ישפרו את החוויה שלך עם Vtiger CRM. אנו רוצים להבטיח שמפתחים ומשתמשי CRM יוכלו לשתף מידע וידע הדדי כדי לקדם את הפונקציונליות של ה-CRM.

הישאר מעודכן לעוד. קידוד שמח!

הירשם כדי לקבל את העדכונים האחרונים!

אני נותן הסכמה ל-Vtiger לשלוח עדכונים של מה חדש ושאר קריאות מעניינות.

קראתי את מדיניות פרטיות של וטיגר.

זכויות יוצרים 2026 Vtiger. כל הזכויות שמורות. סימנים מסחריים שונים המוחזקים על ידי בעליהם בהתאמה.