¡Mejore sus integraciones con el Diseñador API mejorado!

Estamos encantados de anunciar las importantes mejoras que hemos realizado en el módulo API Designer.

Estas mejoras le permitirán crear API personalizadas aún más eficientes y potentes. Se centran en mejorar las operaciones masivas, ampliar la funcionalidad API seleccionada y mejorar el uso de múltiples condiciones de campo.

Profundicemos en los detalles de estas mejoras:

Mejora 1: compatibilidad con operaciones masivas para registros UPDATE/UPSERT

Diseñador de API: soporte de operaciones masivas

Con la última actualización, puede realizar operaciones masivas para actualizar o insertar registros. Esta mejora le permite crear o actualizar varios registros en una sola solicitud, lo que hace que sus interacciones API sean eficientes y ahorren tiempo.

Características Clave:

  • Crear API: Cree varios registros en una sola solicitud pasando el parámetro Bulk="true". Documento relacionado
  • Actualizar API: Anteriormente, sólo podía actualizar un registro por solicitud. Ahora puede actualizar varios registros en una sola solicitud cumpliendo la condición Dónde. Documento relacionado

Límite de registros masivos: 50

Caso de uso de muestra:

Módulo de Contactos: Actualice múltiples registros de cualquier campo con una sola solicitud. Por ejemplo, puede actualizar varios registros de contacto haciendo coincidir condiciones específicas o creando otros nuevos si no existen.

 

  
<?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>
 

Esta mejora agiliza su flujo de trabajo y reduce la cantidad de llamadas API necesarias para operaciones masivas.

Mejora 2: seleccione API para admitir la devolución de campos del módulo principal

Diseñador de API: API seleccionada mejorada

Hemos ampliado la funcionalidad de Select API para incluir campos de módulos de campos de referencia. Esta mejora le permite obtener datos completos en una sola solicitud.

Características Clave:

  • Anteriormente, Select API solo podía recuperar campos del módulo actual.
  • Ahora también puede seleccionar campos de los módulos de campos de referencia.

Casos de uso de muestra: relación de casos y contactos (N:1):

  • Obtenga registros de casos junto con los números de teléfono de los contactos relacionados.
  • Recupere registros de casos junto con el nombre y apellido del contacto.
  • Obtenga registros de casos con el número de móvil y el nombre completo del usuario 'Asignado a'.
 

Esta mejora agiliza su flujo de trabajo y reduce la cantidad de llamadas API necesarias para operaciones masivas.

Mejora 2: seleccione API para admitir la devolución de campos del módulo principal

Diseñador de API: API seleccionada mejorada

Hemos ampliado la funcionalidad de Select API para incluir campos de módulos de campos de referencia. Esta mejora le permite obtener datos completos en una sola solicitud.

Características Clave:

  • Anteriormente, Select API solo podía recuperar campos del módulo actual.
  • Ahora también puede seleccionar campos de los módulos de campos de referencia.

Casos de uso de muestra: relación de casos y contactos (N:1):

  • Obtenga registros de casos junto con los números de teléfono de los contactos relacionados.
  • Recupere registros de casos junto con el nombre y apellido del contacto.
  • Obtenga registros de casos con el número de móvil y el nombre completo del usuario 'Asignado 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>
 

Esta mejora le permite acceder a datos detallados e interconectados, simplificando los procesos de recuperación de datos.

Mejora 3: Se agregó soporte para múltiples condiciones de campo en la cláusula Where

Diseñador de API: cláusula Where avanzada

Con esta actualización, puede utilizar varios campos en la condición Dónde de sus consultas Seleccionar. Esta mejora proporciona mayor flexibilidad y precisión al filtrar sus datos.

Características Clave:

  • Condiciones de campo múltiple: agregue más de un campo del módulo actual o módulos de campo de referencia en la condición donde.
  • Parámetro de pegamento: use el parámetro de pegamento (pegamento="o" o pegamento="y") para combinar múltiples condiciones.

Casos de uso de muestra: módulo simple:

  • Agregue condiciones en 'Etapa de ventas' y 'Fuente principal' con pegamento="o".
  • Incluya campos de referencia en la condición Dónde, como contact_id y related_to.
 

Esta mejora le permite acceder a datos detallados e interconectados, simplificando los procesos de recuperación de datos.

Mejora 3: Se agregó soporte para múltiples condiciones de campo en la cláusula Where

Diseñador de API: cláusula Where avanzada

Con esta actualización, puede utilizar varios campos en la condición Dónde de sus consultas Seleccionar. Esta mejora proporciona mayor flexibilidad y precisión al filtrar sus datos.

Características Clave:

  • Condiciones de campo múltiple: agregue más de un campo del módulo actual o módulos de campo de referencia en la condición donde.
  • Parámetro de pegamento: use el parámetro de pegamento (pegamento="o" o pegamento="y") para combinar múltiples condiciones.

Casos de uso de muestra: módulo simple:

  • Agregue condiciones en 'Etapa de ventas' y 'Fuente principal' con pegamento="o".
  • Incluya campos de referencia en la condición Dónde, como contact_id y 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>
 

Ejemplo complejo: También puede agregar condiciones que involucren campos de referencia de módulos relacionados. Por ejemplo:

  • Relaciones: Existe una relación (N:1) entre acuerdos y contactos, así como entre acuerdos y cuentas.
  • Condiciones combinadas: Agregue condiciones en contact_id y related_to usando pegamento="o". Si uno o ambos valores de parámetro coinciden, se devolverá la respuesta.
 

Ejemplo complejo: También puede agregar condiciones que involucren campos de referencia de módulos relacionados. Por ejemplo:

  • Relaciones: Existe una relación (N:1) entre acuerdos y contactos, así como entre acuerdos y cuentas.
  • Condiciones combinadas: Agregue condiciones en contact_id y related_to usando pegamento="o". Si uno o ambos valores de parámetro coinciden, se devolverá la respuesta.

 

  
<?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>
 

Esta mejora le brinda la capacidad de crear consultas más complejas y refinadas, lo que garantiza que recupere exactamente los datos que necesita.

Creemos que estas mejoras mejorarán significativamente su experiencia con nuestro módulo API Designer, haciéndolo más versátil y potente. Le animamos a explorar estas nuevas funciones y ver cómo pueden beneficiar sus proyectos de desarrollo.

Estén atentos para más actualizaciones.

¡Feliz codificación!
 

Esta mejora le brinda la capacidad de crear consultas más complejas y refinadas, lo que garantiza que recupere exactamente los datos que necesita.

Creemos que estas mejoras mejorarán significativamente su experiencia con nuestro módulo API Designer, haciéndolo más versátil y potente. Le animamos a explorar estas nuevas funciones y ver cómo pueden beneficiar sus proyectos de desarrollo.

Estén atentos para más actualizaciones.

¡Feliz codificación!
 
 

¡Regístrese para recibir las últimas actualizaciones!

 
 

Copyright 2025 Vtiger. Todos los derechos reservados. Diversas marcas registradas de sus respectivos propietarios.