Увеличете вашите интеграции с подобрения API Designer!

Ние сме развълнувани да обявим значителните подобрения, които направихме в модула API Designer.

Тези подобрения ще ви дадат възможност да изградите още по-ефективни и мощни персонализирани API. Те се фокусират върху подобряването на груповите операции, разширяването на избраната функционалност на API и подобряването на използването на множество полеви условия.

Нека се потопим в подробностите за тези подобрения:

Подобрение 1: Поддръжка на групови операции за UPDATE/UPSERT записи

API Designer: Поддръжка на групови операции

С последната актуализация можете да извършвате групови операции за актуализиране или добавяне на записи. Това подобрение ви позволява да създавате или актуализирате множество записи в една заявка, правейки вашите API взаимодействия ефективни и спестяващи време.

Основни функции:

  • Създаване на API: Създайте множество записи в една заявка, като подадете параметъра bulk="true". Свързан документ
  • Актуализиране на API: Преди това можете да актуализирате само един запис на заявка. Сега можете да актуализирате множество записи в една заявка, като отговаряте на условието Where. Свързан документ

Лимит за групови записи: 50

Примерен случай на употреба:

Модул за контакти: Актуализирайте множество записи на всяко поле с една заявка. Например, можете да актуализирате множество записи за контакт, като съпоставите конкретни условия или създадете нови, ако не съществуват.

 

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

Това подобрение рационализира вашия работен процес, като намалява броя на извикванията на API, необходими за групови операции.

Подобрение 2: Изберете API за поддръжка на полета за връщане на родителски модул

API Designer: Разширен API за избор

Разширихме функционалността на Select API, за да включим полета от модули за справочни полета. Това подобрение ви позволява да извличате изчерпателни данни в една заявка.

Основни функции:

  • Преди това Select API можеше да извлича само полета от текущия модул.
  • Сега можете също да избирате полета от модули за справочни полета.

Примерни случаи на употреба - Връзка между случаи и контакти (N:1):

  • Извличане на записи на случаи заедно с телефонните номера на свързания контакт.
  • Извличане на записи на случаи заедно с имената и фамилиите на контакта.
  • Вземете записи на случаи с мобилния номер и пълното име на потребителя „Присвоено на“.
 

Това подобрение рационализира вашия работен процес, като намалява броя на извикванията на API, необходими за групови операции.

Подобрение 2: Изберете API за поддръжка на полета за връщане на родителски модул

API Designer: Разширен API за избор

Разширихме функционалността на Select API, за да включим полета от модули за справочни полета. Това подобрение ви позволява да извличате изчерпателни данни в една заявка.

Основни функции:

  • Преди това Select API можеше да извлича само полета от текущия модул.
  • Сега можете също да избирате полета от модули за справочни полета.

Примерни случаи на употреба - Връзка между случаи и контакти (N:1):

  • Извличане на записи на случаи заедно с телефонните номера на свързания контакт.
  • Извличане на записи на случаи заедно с имената и фамилиите на контакта.
  • Вземете записи на случаи с мобилния номер и пълното име на потребителя „Присвоено на“.
 

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

Това подобрение ви позволява достъп до подробни и взаимосвързани данни, опростявайки процесите за извличане на данни.

Подобрение 3: Добавена поддръжка за условия на множество полета в клаузата Where

API Designer: Разширена клауза Where

С тази актуализация можете да използвате множество полета в условието Where на вашите заявки за избор. Това подобрение осигурява по-голяма гъвкавост и прецизност при филтрирането на вашите данни.

Основни функции:

  • Условия за множество полета: Добавете повече от едно поле от текущия модул или модули за референтни полета в условието where.
  • Слепващ параметър: Използвайте слепващия параметър (glue="or" или glue="and"), за да комбинирате множество условия.

Примерни случаи на употреба - прост модул:

  • Добавете условия за „Етап на продажби“ и „Източник на възможни клиенти“ с glue="or".
  • Включете референтни полета в условието Where, като contact_id и related_to.
 

Това подобрение ви позволява достъп до подробни и взаимосвързани данни, опростявайки процесите за извличане на данни.

Подобрение 3: Добавена поддръжка за условия на множество полета в клаузата Where

API Designer: Разширена клауза Where

С тази актуализация можете да използвате множество полета в условието Where на вашите заявки за избор. Това подобрение осигурява по-голяма гъвкавост и прецизност при филтрирането на вашите данни.

Основни функции:

  • Условия за множество полета: Добавете повече от едно поле от текущия модул или модули за референтни полета в условието where.
  • Слепващ параметър: Използвайте слепващия параметър (glue="or" или glue="and"), за да комбинирате множество условия.

Примерни случаи на употреба - прост модул:

  • Добавете условия за „Етап на продажби“ и „Източник на възможни клиенти“ с glue="or".
  • Включете референтни полета в условието Where, като contact_id и 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>
 

Сложен пример: Можете също да добавите условия, включващи референтни полета от свързани модули. Например:

  • Връзки: Има връзка (N:1) между сделки и контакти, както и между сделки и акаунти.
  • Комбинирани условия: Добавете условия за contact_id и related_to с помощта на glue="or". Ако една или и двете стойности на параметъра съвпадат, отговорът ще бъде върнат.
 

Сложен пример: Можете също да добавите условия, включващи референтни полета от свързани модули. Например:

  • Връзки: Има връзка (N:1) между сделки и контакти, както и между сделки и акаунти.
  • Комбинирани условия: Добавете условия за contact_id и related_to с помощта на glue="or". Ако една или и двете стойности на параметъра съвпадат, отговорът ще бъде върнат.

 

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

Това подобрение ви дава възможност да създавате по-сложни и прецизни заявки, гарантирайки, че извличате точно данните, от които се нуждаете.

Вярваме, че тези подобрения значително ще подобрят изживяването ви с нашия модул API Designer, правейки го по-гъвкав и мощен. Препоръчваме ви да проучите тези нови функции и да видите как те могат да бъдат от полза за вашите проекти за разработка.

Останете настроени за повече актуализации.

Приятно кодиране!
 

Това подобрение ви дава възможност да създавате по-сложни и прецизни заявки, гарантирайки, че извличате точно данните, от които се нуждаете.

Вярваме, че тези подобрения значително ще подобрят изживяването ви с нашия модул API Designer, правейки го по-гъвкав и мощен. Препоръчваме ви да проучите тези нови функции и да видите как те могат да бъдат от полза за вашите проекти за разработка.

Останете настроени за повече актуализации.

Приятно кодиране!
 
 

Регистрирайте се, за да получавате най-новите актуализации!

 
 

Copyright 2026 Vtiger. Всички права запазени. Различни търговски марки, притежавани от съответните им собственици.