Vtiger CRM Geliştirici Bülteni

Sorun Özeti

Modüller arasında ilgili kayıtları yönetirken kullanıcılar sıklıkla şu gibi operasyonel engellerle karşı karşıya kalırlar:

İlgili kayıtların bağlantısını kaldırma (örneğin, bir Anlaşmadan ilişkili bir Fatura veya Kişiyi kaldırma).
Eski girdileri (etkin olmayan Abonelikler gibi) kalıcı olarak silme.
Belirli veri kümelerini (örneğin, tanımlı durumlara sahip Ödemeler veya yeniden deneme girişimleri) almak için karmaşık, çok koşullu filtreler yürütme.

Bu görevlerin manuel olarak veya belirsiz API kılavuzlarıyla gerçekleştirilmesi verimsizliğe, veri kaybı riskinin artmasına ve mantık uygulamasında tutarsızlıklara yol açabilir.

Hedef

VTAP kullanarak ilgili kayıtların ana modülden nasıl bağlantısının kaldırılacağını program aracılığıyla gösterin.
Bir modülden bir kaydın nasıl güvenli bir şekilde silineceğini gösterin.
q parametresini kullanarak birden fazla koşula göre kayıtları filtrelemek için yapılandırılmış bir yöntem sağlayın.
Esneklik ve sürdürülebilirlik için API aracılığıyla ilişki kimliklerini dinamik olarak almaya yönelik en iyi uygulamaları paylaşın.

Uygulama ayrıntıları

İlgili Bir Kaydın Bağlantısını Kaldırma:

İki kayıt arasındaki ilişkiyi kaldırmak için (örneğin, bir Faturayı Potansiyel'den ayırmak için), aşağıdaki kod parçacığını kullanın:


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

Bu işlem yalnızca kaydın bağlantısını kaldıracaktır. Orijinal Fatura ve Potansiyel aynı kalacaktır.

relation_id'yi dinamik olarak nasıl alabilirim:


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


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

Bu, Potansiyeller modülüne ilişkin tüm ilgili meta verileri, ilişki kimlikleri ve etiketler dahil olmak üzere döndürür.

Bir Kaydı Silme:


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

Bu, 596 kimlikli Abonelik kaydını kalıcı olarak kaldıracaktır. Bunu yalnızca kayda artık ihtiyaç duyulmadığında kullanın.

q Parametresini Kullanarak Kayıtları Filtreleme:

Ödemeler modülünden birden fazla filtre koşuluna göre kayıtları almak için:


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

Faydalar

Verimli Kayıt Yönetimi: Bağlantıyı kaldırma ve silme işlemlerini otomatikleştirerek zamandan tasarruf sağlar ve insan hatasını azaltır.
Daha iyi kontrol: Geliştiriciler, hangi kayıtların etkileneceği konusunda kesin kontrole sahip olur ve bu da veri bütünlüğünü iyileştirir.
Gelişmiş Filtreleme: q parametresi karmaşık, çok koşullu sorguları etkinleştirir ve gereksiz API çağrılarını en aza indirir.
Geliştirici Dostu: Asenkron JavaScript sözdizimini (async/await) tam olarak destekler ve VTAP ortamlarına entegrasyonu kolaylaştırır.

Bu örneklerin Vtiger CRM ile deneyiminizi iyileştireceğine inanıyoruz. Geliştiricilerin ve CRM kullanıcılarının CRM'nin işlevselliğini daha da artırmak için bilgi ve birikimlerini karşılıklı olarak paylaşabilmelerini sağlamak istiyoruz.

Daha fazlası için bizi izlemeye devam edin. İyi kodlamalar!

En son güncellemeleri almak için kaydolun!

Yeniliklerin ve diğer ilginç okumaların güncellemelerini göndermesi için Vtiger'a izin veriyorum.

Okudum gizlilik politikasını kabul ettiğinizi onaylıyorsunuz. Vtiger'ın.