Zvýšte výkon svojich integrácií s vylepšeným návrhárom API!

S nadšením oznamujeme významné vylepšenia, ktoré sme vykonali v module API Designer.

Tieto vylepšenia vám umožnia vytvoriť ešte efektívnejšie a výkonnejšie vlastné rozhrania API. Zameriavajú sa na zlepšenie hromadných operácií, rozšírenie vybraných funkcií API a zlepšenie používania viacerých podmienok v teréne.

Poďme sa ponoriť do detailov týchto vylepšení:

Vylepšenie 1: Podpora hromadnej prevádzky pre záznamy UPDATE/UPSERT

API Designer: Podpora hromadnej prevádzky

S najnovšou aktualizáciou môžete vykonávať hromadné operácie na aktualizáciu alebo nahradenie záznamov. Toto vylepšenie vám umožňuje vytvárať alebo aktualizovať viacero záznamov v jednej požiadavke, vďaka čomu sú interakcie s rozhraním API efektívne a časovo úsporné.

Kľúčové vlastnosti:

  • Vytvoriť API: Vytvorte viacero záznamov v jednej požiadavke zadaním parametra bulk="true". Súvisiaci dokument
  • Aktualizovať API: Predtým ste mohli aktualizovať iba jeden záznam na žiadosť. Teraz môžete aktualizovať viacero záznamov v jednej požiadavke zadaním podmienky Kde. Súvisiaci dokument

Limit hromadného záznamu: 50

Vzorový prípad použitia:

Modul kontaktov: Aktualizujte viacero záznamov ľubovoľného poľa jednou požiadavkou. Môžete napríklad aktualizovať viacero záznamov kontaktov priradením konkrétnych podmienok alebo vytvorením nových, ak neexistujú.

 

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

Toto vylepšenie zefektívňuje váš pracovný tok a znižuje počet volaní API potrebných na hromadné operácie.

Vylepšenie 2: Vyberte API na podporu vrátených polí rodičovského modulu

API Designer: Enhanced Select API

Rozšírili sme funkčnosť Select API tak, aby zahŕňala polia z modulov referenčných polí. Toto vylepšenie vám umožňuje získať komplexné údaje v jednej požiadavke.

Kľúčové vlastnosti:

  • Predtým mohlo Select API získavať polia iba z aktuálneho modulu.
  • Teraz môžete vybrať polia aj z modulov referenčných polí.

Vzorové prípady použitia – prípady a vzťah medzi kontaktmi (N:1):

  • Získajte záznamy o prípadoch spolu s telefónnymi číslami príslušného kontaktu.
  • Získajte záznamy o prípadoch spolu s krstným menom a priezviskom kontaktu.
  • Získajte záznamy o prípadoch s mobilným číslom a celým menom používateľa „Priradené“.
 

Toto vylepšenie zefektívňuje váš pracovný tok a znižuje počet volaní API potrebných na hromadné operácie.

Vylepšenie 2: Vyberte API na podporu vrátených polí rodičovského modulu

API Designer: Enhanced Select API

Rozšírili sme funkčnosť Select API tak, aby zahŕňala polia z modulov referenčných polí. Toto vylepšenie vám umožňuje získať komplexné údaje v jednej požiadavke.

Kľúčové vlastnosti:

  • Predtým mohlo Select API získavať polia iba z aktuálneho modulu.
  • Teraz môžete vybrať polia aj z modulov referenčných polí.

Vzorové prípady použitia – prípady a vzťah medzi kontaktmi (N:1):

  • Získajte záznamy o prípadoch spolu s telefónnymi číslami príslušného kontaktu.
  • Získajte záznamy o prípadoch spolu s krstným menom a priezviskom kontaktu.
  • Získajte záznamy o prípadoch s mobilným číslom a celým menom používateľa „Priradené“.
 

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

Toto vylepšenie vám umožňuje prístup k detailným a vzájomne prepojeným údajom, čím sa zjednodušujú procesy získavania údajov.

Vylepšenie 3: Pridaná podpora pre podmienky viacerých polí v klauzule Where

API Designer: Rozšírená klauzula Where

Vďaka tejto aktualizácii môžete použiť viaceré polia v podmienke Kde vo vašich výberových dotazoch. Toto vylepšenie poskytuje väčšiu flexibilitu a presnosť pri filtrovaní vašich údajov.

Kľúčové vlastnosti:

  • Podmienky viacerých polí: Pridajte viac ako jedno pole z aktuálneho modulu alebo referenčných modulov poľa v podmienke where.
  • Parameter lepidla: Ak chcete skombinovať viacero podmienok, použite parameter lepidla (glue="or" alebo lepidlo="and").

Príklady použitia – jednoduchý modul:

  • Pridajte podmienky pre 'Sales Stage' a 'Lead Source' s lepidlom = "alebo".
  • Zahrňte referenčné polia do podmienky Kde, ako napríklad contact_id a related_to.
 

Toto vylepšenie vám umožňuje prístup k detailným a vzájomne prepojeným údajom, čím sa zjednodušujú procesy získavania údajov.

Vylepšenie 3: Pridaná podpora pre podmienky viacerých polí v klauzule Where

API Designer: Rozšírená klauzula Where

Vďaka tejto aktualizácii môžete použiť viaceré polia v podmienke Kde vo vašich výberových dotazoch. Toto vylepšenie poskytuje väčšiu flexibilitu a presnosť pri filtrovaní vašich údajov.

Kľúčové vlastnosti:

  • Podmienky viacerých polí: Pridajte viac ako jedno pole z aktuálneho modulu alebo referenčných modulov poľa v podmienke where.
  • Parameter lepidla: Ak chcete skombinovať viacero podmienok, použite parameter lepidla (glue="or" alebo lepidlo="and").

Príklady použitia – jednoduchý modul:

  • Pridajte podmienky pre 'Sales Stage' a 'Lead Source' s lepidlom = "alebo".
  • Zahrňte referenčné polia do podmienky Kde, ako napríklad contact_id a 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>
 

Komplexný príklad: Môžete tiež pridať podmienky zahŕňajúce referenčné polia zo súvisiacich modulov. Napríklad:

  • vzťahy: Existuje vzťah (N:1) medzi ponukami a kontaktmi, ako aj medzi ponukami a účtami.
  • Kombinované podmienky: Pridajte podmienky pre contact_id a related_to pomocou lepidlo="or". Ak sa jedna alebo obe hodnoty parametrov zhodujú, vráti sa odpoveď.
 

Komplexný príklad: Môžete tiež pridať podmienky zahŕňajúce referenčné polia zo súvisiacich modulov. Napríklad:

  • vzťahy: Existuje vzťah (N:1) medzi ponukami a kontaktmi, ako aj medzi ponukami a účtami.
  • Kombinované podmienky: Pridajte podmienky pre contact_id a related_to pomocou lepidlo="or". Ak sa jedna alebo obe hodnoty parametrov zhodujú, vráti sa odpoveď.

 

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

Toto vylepšenie vám dáva možnosť vytvárať komplexnejšie a presnejšie dotazy, čím zaistíte, že získate presne tie údaje, ktoré potrebujete.

Veríme, že tieto vylepšenia výrazne zlepšia vaše skúsenosti s naším modulom API Designer, vďaka čomu bude všestrannejší a výkonnejší. Odporúčame vám preskúmať tieto nové funkcie a zistiť, ako môžu byť prínosom pre vaše vývojové projekty.

Zostaňte naladení na ďalšie aktualizácie.

Šťastné kódovanie!
 

Toto vylepšenie vám dáva možnosť vytvárať komplexnejšie a presnejšie dotazy, čím zaistíte, že získate presne tie údaje, ktoré potrebujete.

Veríme, že tieto vylepšenia výrazne zlepšia vaše skúsenosti s naším modulom API Designer, vďaka čomu bude všestrannejší a výkonnejší. Odporúčame vám preskúmať tieto nové funkcie a zistiť, ako môžu byť prínosom pre vaše vývojové projekty.

Zostaňte naladení na ďalšie aktualizácie.

Šťastné kódovanie!
 
 

Prihláste sa a získajte najnovšie aktualizácie!

 
 

Autorské práva 2026 Vtiger. Všetky práva vyhradené. Rôzne ochranné známky vlastnené ich príslušnými vlastníkmi.