Potenzia le tue integrazioni con l'API Designer migliorato!

Siamo entusiasti di annunciare i miglioramenti significativi che abbiamo apportato al modulo API Designer.

Questi miglioramenti ti consentiranno di creare API personalizzate ancora più efficienti e potenti. Si concentrano sul miglioramento delle operazioni in blocco, sull'espansione di funzionalità API selezionate e sul miglioramento dell'uso di più condizioni sul campo.

Entriamo nei dettagli di questi miglioramenti:

Miglioramento 1: supporto delle operazioni in blocco per i record UPDATE/UPSERT

Progettazione API: supporto per operazioni in blocco

Con l'ultimo aggiornamento è possibile eseguire operazioni in blocco per l'aggiornamento o l'upserting dei record. Questo miglioramento ti consente di creare o aggiornare più record in un'unica richiesta, rendendo le tue interazioni API efficienti e facendo risparmiare tempo.

Caratteristiche principali:

  • Crea API: Crea più record in un'unica richiesta passando il parametro bulk="true". Documento correlato
  • Aggiorna API: In precedenza era possibile aggiornare solo un record per richiesta. Ora puoi aggiornare più record in un'unica richiesta soddisfacendo la condizione Where. Documento correlato

Limite di registrazione in blocco: 50

Caso d'uso di esempio:

Modulo Contatti: Aggiorna più record di qualsiasi campo con un'unica richiesta. Ad esempio, puoi aggiornare più record di contatti soddisfacendo condizioni specifiche o creandone di nuovi se non esistono.

 

  
<?xml version="1.0"?>
   <api method="post" module="Contacts">
        <upsert bulk="true">
             <where>
                <field name="mobile" condition="eq" value="@mobile"></field>  
            </where>
            <update>
               <record>
                   <field name="mobile" value="@mobile"></field>
                   <field name="email" value="@email" presence="optional"></field>
                   <field name="lastname" value="@lastname" presence="optional"></field>
               </record>
            </update>
            <create module="Contacts" bulk="true">
                <record>
                   <field name="mobile" value="@mobile"></field>
                   <field name="email" value="@email" presence="optional"></field>
                   <field name="lastname" value="@lastname" presence="optional"></field>
               </record>
            </create>
            <return>
                <field name="mobile"></field>
                <field name="email"></field>
                <field name="lastname"></field>
            </return>
        </upsert>
    </api>




  
<?xml version="1.0"?>
   <api method="post" module="Contacts">
        <upsert bulk="true">
             <where>
                <field name="mobile" condition="eq" value="@mobile"></field>  
            </where>
            <update>
               <record>
                   <field name="mobile" value="@mobile"></field>
                   <field name="email" value="@email" presence="optional"></field>
                   <field name="lastname" value="@lastname" presence="optional"></field>
               </record>
            </update>
            <create module="Contacts" bulk="true">
                <record>
                   <field name="mobile" value="@mobile"></field>
                   <field name="email" value="@email" presence="optional"></field>
                   <field name="lastname" value="@lastname" presence="optional"></field>
               </record>
            </create>
            <return>
                <field name="mobile"></field>
                <field name="email"></field>
                <field name="lastname"></field>
            </return>
        </upsert>
    </api>
 

Questo miglioramento semplifica il flusso di lavoro, riducendo il numero di chiamate API necessarie per le operazioni in blocco.

Miglioramento 2: selezionare l'API per supportare la restituzione dei campi del modulo principale

Progettazione API: API di selezione migliorata

Abbiamo ampliato la funzionalità dell'API Select per includere i campi dei moduli dei campi di riferimento. Questo miglioramento consente di recuperare dati completi in un'unica richiesta.

Caratteristiche principali:

  • In precedenza, l'API Select poteva recuperare solo i campi dal modulo corrente.
  • Ora puoi selezionare i campi anche dai moduli dei campi di riferimento.

Casi d'uso di esempio - Relazione tra casi e contatti (N:1):

  • Recupera i record dei casi insieme ai numeri di telefono dei relativi contatti.
  • Recupera i record del caso insieme al nome e al cognome del contatto.
  • Ottieni i record del caso con il numero di cellulare e il nome completo dell'utente "Assegnato a".
 

Questo miglioramento semplifica il flusso di lavoro, riducendo il numero di chiamate API necessarie per le operazioni in blocco.

Miglioramento 2: selezionare l'API per supportare la restituzione dei campi del modulo principale

Progettazione API: API di selezione migliorata

Abbiamo ampliato la funzionalità dell'API Select per includere i campi dei moduli dei campi di riferimento. Questo miglioramento consente di recuperare dati completi in un'unica richiesta.

Caratteristiche principali:

  • In precedenza, l'API Select poteva recuperare solo i campi dal modulo corrente.
  • Ora puoi selezionare i campi anche dai moduli dei campi di riferimento.

Casi d'uso di esempio - Relazione tra casi e contatti (N:1):

  • Recupera i record dei casi insieme ai numeri di telefono dei relativi contatti.
  • Recupera i record del caso insieme al nome e al cognome del contatto.
  • Ottieni i record del caso con il numero di cellulare e il nome completo dell'utente "Assegnato a".
 

  
<?xml version="1.0"?>
<api method="get">
    <select module="Cases">
        <record>
            <field name="title"></field>
            <field name="casestatus"></field>
            <field name="assigned_user_id"></field>
            <field name="createdtime"></field>
            <field name="case_no"></field>
            <field name="assigned_user_id" module="Users">
                <select>
                    <field name="first_name"></field>
                    <field name="last_name"></field>
                    <field name="userlabel"></field>
                </select>
            </field>
            <field name="contact_id" module="Contacts">
                <select>
                    <field name="firstname"></field>
                    <field name="lastname"></field>
                    <field name="mobile"></field>
                </select>
            </field>
            <field name="group_id" module="Groups">
                <select>
                    <field name="groupname"></field>
                </select>
            </field>
        </record>
        <where>
            <field name="contact_id" module="Contacts">
                <select>
                    <where>
                        <field name="lastname" value="@name"></field>
                    </where>
                </select>
            </field>
        </where>
    </select>
</api>




  
<?xml version="1.0"?>
<api method="get">
    <select module="Cases">
        <record>
            <field name="title"></field>
            <field name="casestatus"></field>
            <field name="assigned_user_id"></field>
            <field name="createdtime"></field>
            <field name="case_no"></field>
            <field name="assigned_user_id" module="Users">
                <select>
                    <field name="first_name"></field>
                    <field name="last_name"></field>
                    <field name="userlabel"></field>
                </select>
            </field>
            <field name="contact_id" module="Contacts">
                <select>
                    <field name="firstname"></field>
                    <field name="lastname"></field>
                    <field name="mobile"></field>
                </select>
            </field>
            <field name="group_id" module="Groups">
                <select>
                    <field name="groupname"></field>
                </select>
            </field>
        </record>
        <where>
            <field name="contact_id" module="Contacts">
                <select>
                    <where>
                        <field name="lastname" value="@name"></field>
                    </where>
                </select>
            </field>
        </where>
    </select>
</api>
 

Questo miglioramento consente di accedere a dati dettagliati e interconnessi, semplificando i processi di recupero dei dati.

Miglioramento 3: aggiunto il supporto per più condizioni di campo nella clausola Where

Progettazione API: clausola Where avanzata

Con questo aggiornamento puoi utilizzare più campi nella condizione Dove delle query Seleziona. Questo miglioramento offre maggiore flessibilità e precisione nel filtraggio dei dati.

Caratteristiche principali:

  • Condizioni di campo multiplo: aggiungi più di un campo dal modulo corrente o dai moduli di campo di riferimento nella condizione dove.
  • Parametro colla: utilizza il parametro colla (glue="o" o colla="e") per combinare più condizioni.

Casi d'uso di esempio - Modulo semplice:

  • Aggiungi condizioni in "Fase di vendita" e "Fonte lead" con Glue="or".
  • Includi campi di riferimento nella condizione Where, come contact_id e related_to.
 

Questo miglioramento consente di accedere a dati dettagliati e interconnessi, semplificando i processi di recupero dei dati.

Miglioramento 3: aggiunto il supporto per più condizioni di campo nella clausola Where

Progettazione API: clausola Where avanzata

Con questo aggiornamento puoi utilizzare più campi nella condizione Dove delle query Seleziona. Questo miglioramento offre maggiore flessibilità e precisione nel filtraggio dei dati.

Caratteristiche principali:

  • Condizioni di campo multiplo: aggiungi più di un campo dal modulo corrente o dai moduli di campo di riferimento nella condizione dove.
  • Parametro colla: utilizza il parametro colla (glue="o" o colla="e") per combinare più condizioni.

Casi d'uso di esempio - Modulo semplice:

  • Aggiungi condizioni in "Fase di vendita" e "Fonte lead" con Glue="or".
  • Includi campi di riferimento nella condizione Where, come contact_id e related_to.
 

  
<?xml version="1.0"?>
<api method="get">
    <select module="Potentials">
        <record>
            <field name="potentialname"></field>
            <field name="amount"></field>
            <field name="assigned_user_id"></field>
            <field name="createdtime"></field>
        </record>
        <where glue="or">
            <field name="sales_stage" value="@sales_stage" presence="optional"></field>
            <field name="leadsource" value="@leadsource" presence="optional"></field>
        </where>
    </select>
</api>




  
<?xml version="1.0"?>
<api method="get">
    <select module="Potentials">
        <record>
            <field name="potentialname"></field>
            <field name="amount"></field>
            <field name="assigned_user_id"></field>
            <field name="createdtime"></field>
        </record>
        <where glue="or">
            <field name="sales_stage" value="@sales_stage" presence="optional"></field>
            <field name="leadsource" value="@leadsource" presence="optional"></field>
        </where>
    </select>
</api>
 

Esempio complesso: Puoi anche aggiungere condizioni che coinvolgono i campi di riferimento dai moduli correlati. Ad esempio:

  • Relazioni: Esiste una relazione (N:1) tra offerte e contatti, nonché tra offerte e account.
  • Condizioni combinate: Aggiungi condizioni su contact_id e related_to utilizzando Glue="or". Se uno o entrambi i valori dei parametri corrispondono, verrà restituita la risposta.
 

Esempio complesso: Puoi anche aggiungere condizioni che coinvolgono i campi di riferimento dai moduli correlati. Ad esempio:

  • Relazioni: Esiste una relazione (N:1) tra offerte e contatti, nonché tra offerte e account.
  • Condizioni combinate: Aggiungi condizioni su contact_id e related_to utilizzando Glue="or". Se uno o entrambi i valori dei parametri corrispondono, verrà restituita la risposta.

 

  
<?xml version="1.0"?>
<api method="get">
    <select module="Potentials">
        <record>
            <field name="potentialname"></field>
            <field name="amount"></field>
            <field name="assigned_user_id"></field>
            <field name="createdtime"></field>
        </record>
        <where glue="OR">
               <field name="contact_id" module="Contacts">
                   <select>
                       <where>
                           <field name="mobile" condition="eq" value="@mobile" presence="optional"></field>
                       </where>
                    </select>
               </field>
               <field name="related_to" module="Accounts">
                    <select>
                         <where>
                             <field name="phone" condition="eq" value="@phone" presence="optional"></field>
                         </where>
                    </select>
                </field>
            </where>
    </select>
</api>




  
<?xml version="1.0"?>
<api method="get">
    <select module="Potentials">
        <record>
            <field name="potentialname"></field>
            <field name="amount"></field>
            <field name="assigned_user_id"></field>
            <field name="createdtime"></field>
        </record>
        <where glue="OR">
               <field name="contact_id" module="Contacts">
                   <select>
                       <where>
                           <field name="mobile" condition="eq" value="@mobile" presence="optional"></field>
                       </where>
                    </select>
               </field>
               <field name="related_to" module="Accounts">
                    <select>
                         <where>
                             <field name="phone" condition="eq" value="@phone" presence="optional"></field>
                         </where>
                    </select>
                </field>
            </where>
    </select>
</api>
 

Questo miglioramento ti dà la possibilità di creare query più complesse e raffinate, assicurandoti di recuperare esattamente i dati di cui hai bisogno.

Riteniamo che questi miglioramenti miglioreranno significativamente la tua esperienza con il nostro modulo API Designer, rendendolo più versatile e potente. Ti invitiamo a esplorare queste nuove funzionalità e vedere come possono apportare vantaggi ai tuoi progetti di sviluppo.

Restate sintonizzati per ulteriori aggiornamenti.

Buona programmazione!
 

Questo miglioramento ti dà la possibilità di creare query più complesse e raffinate, assicurandoti di recuperare esattamente i dati di cui hai bisogno.

Riteniamo che questi miglioramenti miglioreranno significativamente la tua esperienza con il nostro modulo API Designer, rendendolo più versatile e potente. Ti invitiamo a esplorare queste nuove funzionalità e vedere come possono apportare vantaggi ai tuoi progetti di sviluppo.

Restate sintonizzati per ulteriori aggiornamenti.

Buona programmazione!
 
 

Iscriviti per ricevere gli ultimi aggiornamenti!

 
 

Copyright 2026 Vtiger. Tutti i diritti riservati. Vari marchi registrati dai rispettivi proprietari.