Optimieren Sie Ihre Integrationen mit dem erweiterten API Designer!

Wir freuen uns, die wesentlichen Verbesserungen bekannt zu geben, die wir am API Designer-Modul vorgenommen haben.

Mit diesen Verbesserungen können Sie noch effizientere und leistungsfähigere benutzerdefinierte APIs erstellen. Ihr Schwerpunkt liegt auf der Verbesserung von Massenvorgängen, der Erweiterung ausgewählter API-Funktionen und der Verbesserung der Verwendung mehrerer Feldbedingungen.

Sehen wir uns die Details dieser Verbesserungen an:

Erweiterung 1: Unterstützung von Massenvorgängen für UPDATE/UPSERT-Datensätze

API Designer: Unterstützung für Massenvorgänge

Mit dem neuesten Update können Sie Massenvorgänge zum Aktualisieren oder Upserting von Datensätzen durchführen. Diese Erweiterung ermöglicht es Ihnen, mehrere Datensätze in einer einzigen Anfrage zu erstellen oder zu aktualisieren, wodurch Ihre API-Interaktionen effizient und zeitsparend werden.

Hauptmerkmale

  • API erstellen: Erstellen Sie mehrere Datensätze in einer einzigen Anfrage, indem Sie den Parameter bulk="true" übergeben. Zugehöriges Dokument
  • API aktualisieren: Bisher konnten Sie pro Anfrage nur einen Datensatz aktualisieren. Jetzt können Sie durch Erfüllen der Where-Bedingung mehrere Datensätze in einer einzigen Anfrage aktualisieren. Zugehöriges Dokument

Massendatensatz-Limit: 50

Beispiel-Anwendungsfall:

Kontakte-Modul: Aktualisieren Sie mehrere Datensätze beliebiger Felder mit einer einzigen Anfrage. Sie können beispielsweise mehrere Kontaktdatensätze aktualisieren, indem Sie bestimmte Bedingungen erfüllen oder neue erstellen, wenn sie nicht vorhanden sind.

 

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

Diese Verbesserung optimiert Ihren Arbeitsablauf und reduziert die Anzahl der für Massenvorgänge erforderlichen API-Aufrufe.

Verbesserung 2: API zur Unterstützung der Rückgabe von übergeordneten Modulfeldern auswählen

API Designer: Erweiterte Select-API

Wir haben die Funktionalität der Select API um Felder aus Referenzfeldmodulen erweitert. Diese Erweiterung ermöglicht es Ihnen, umfassende Daten in einer einzigen Anfrage abzurufen.

Hauptmerkmale

  • Bisher konnte die Select-API nur Felder aus dem aktuellen Modul abrufen.
  • Jetzt können Sie auch Felder aus Referenzfeldmodulen auswählen.

Beispiele für Anwendungsfälle – Beziehung zwischen Fällen und Kontakten (N:1):

  • Rufen Sie Fallakten zusammen mit den Telefonnummern der zugehörigen Kontakte ab.
  • Rufen Sie Fallakten zusammen mit dem Vor- und Nachnamen des Kontakts ab.
  • Erhalten Sie Fallakten mit der Mobiltelefonnummer und dem vollständigen Namen des „Zugewiesen an“-Benutzers.
 

Diese Verbesserung optimiert Ihren Arbeitsablauf und reduziert die Anzahl der für Massenvorgänge erforderlichen API-Aufrufe.

Verbesserung 2: API zur Unterstützung der Rückgabe von übergeordneten Modulfeldern auswählen

API Designer: Erweiterte Select-API

Wir haben die Funktionalität der Select API um Felder aus Referenzfeldmodulen erweitert. Diese Erweiterung ermöglicht es Ihnen, umfassende Daten in einer einzigen Anfrage abzurufen.

Hauptmerkmale

  • Bisher konnte die Select-API nur Felder aus dem aktuellen Modul abrufen.
  • Jetzt können Sie auch Felder aus Referenzfeldmodulen auswählen.

Beispiele für Anwendungsfälle – Beziehung zwischen Fällen und Kontakten (N:1):

  • Rufen Sie Fallakten zusammen mit den Telefonnummern der zugehörigen Kontakte ab.
  • Rufen Sie Fallakten zusammen mit dem Vor- und Nachnamen des Kontakts ab.
  • Erhalten Sie Fallakten mit der Mobiltelefonnummer und dem vollständigen Namen des „Zugewiesen an“-Benutzers.
 

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

Diese Erweiterung ermöglicht Ihnen den Zugriff auf detaillierte und verknüpfte Daten und vereinfacht so die Datenabrufprozesse.

Verbesserung 3: Unterstützung für mehrere Feldbedingungen in der Where-Klausel hinzugefügt

API Designer: Erweiterte Where-Klausel

Mit diesem Update können Sie mehrere Felder in der Where-Bedingung Ihrer Select-Abfragen verwenden. Diese Verbesserung bietet mehr Flexibilität und Präzision beim Filtern Ihrer Daten.

Hauptmerkmale

  • Bedingungen für mehrere Felder: Fügen Sie in der Where-Bedingung mehr als ein Feld aus dem aktuellen Modul oder Referenzfeldmodulen hinzu.
  • Klebeparameter: Verwenden Sie den Klebeparameter (glue="or" oder glue="and"), um mehrere Bedingungen zu kombinieren.

Beispiele für Anwendungsfälle – Einfaches Modul:

  • Fügen Sie mit glue="or" Bedingungen für „Verkaufsphase“ und „Lead-Quelle“ hinzu.
  • Schließen Sie Referenzfelder in die Where-Bedingung ein, wie etwa „contact_id“ und „related_to“.
 

Diese Erweiterung ermöglicht Ihnen den Zugriff auf detaillierte und verknüpfte Daten und vereinfacht so die Datenabrufprozesse.

Verbesserung 3: Unterstützung für mehrere Feldbedingungen in der Where-Klausel hinzugefügt

API Designer: Erweiterte Where-Klausel

Mit diesem Update können Sie mehrere Felder in der Where-Bedingung Ihrer Select-Abfragen verwenden. Diese Verbesserung bietet mehr Flexibilität und Präzision beim Filtern Ihrer Daten.

Hauptmerkmale

  • Bedingungen für mehrere Felder: Fügen Sie in der Where-Bedingung mehr als ein Feld aus dem aktuellen Modul oder Referenzfeldmodulen hinzu.
  • Klebeparameter: Verwenden Sie den Klebeparameter (glue="or" oder glue="and"), um mehrere Bedingungen zu kombinieren.

Beispiele für Anwendungsfälle – Einfaches Modul:

  • Fügen Sie mit glue="or" Bedingungen für „Verkaufsphase“ und „Lead-Quelle“ hinzu.
  • Schließen Sie Referenzfelder in die Where-Bedingung ein, wie etwa „contact_id“ und „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>
 

Komplexes Beispiel: Sie können auch Bedingungen hinzufügen, die Referenzfelder aus verwandten Modulen beinhalten. Zum Beispiel:

  • Beziehungen: Es besteht eine Beziehung (N:1) zwischen Deals und Kontakten sowie zwischen Deals und Accounts.
  • Kombinierte Bedingungen: Fügen Sie Bedingungen für contact_id und related_to mit glue="or" hinzu. Wenn einer oder beide Parameterwerte übereinstimmen, wird die Antwort zurückgegeben.
 

Komplexes Beispiel: Sie können auch Bedingungen hinzufügen, die Referenzfelder aus verwandten Modulen beinhalten. Zum Beispiel:

  • Beziehungen: Es besteht eine Beziehung (N:1) zwischen Deals und Kontakten sowie zwischen Deals und Accounts.
  • Kombinierte Bedingungen: Fügen Sie Bedingungen für contact_id und related_to mit glue="or" hinzu. Wenn einer oder beide Parameterwerte übereinstimmen, wird die Antwort zurückgegeben.

 

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

Diese Erweiterung gibt Ihnen die Möglichkeit, komplexere und verfeinerte Abfragen zu erstellen und so sicherzustellen, dass Sie genau die Daten abrufen, die Sie benötigen.

Wir sind davon überzeugt, dass diese Verbesserungen Ihre Erfahrung mit unserem API Designer-Modul deutlich verbessern und es vielseitiger und leistungsfähiger machen werden. Wir ermutigen Sie, diese neuen Funktionen zu erkunden und herauszufinden, wie sie Ihren Entwicklungsprojekten zugute kommen können.

Bleiben Sie dran für weitere Updates.

Viel Spaß beim Codieren!
 

Diese Erweiterung gibt Ihnen die Möglichkeit, komplexere und verfeinerte Abfragen zu erstellen und so sicherzustellen, dass Sie genau die Daten abrufen, die Sie benötigen.

Wir sind davon überzeugt, dass diese Verbesserungen Ihre Erfahrung mit unserem API Designer-Modul deutlich verbessern und es vielseitiger und leistungsfähiger machen werden. Wir ermutigen Sie, diese neuen Funktionen zu erkunden und herauszufinden, wie sie Ihren Entwicklungsprojekten zugute kommen können.

Bleiben Sie dran für weitere Updates.

Viel Spaß beim Codieren!
 
 

Melden Sie sich an, um die neuesten Updates zu erhalten!

 
 

Copyright 2026 Vtiger. Alle Rechte vorbehalten. Verschiedene Marken, die von ihren jeweiligen Eigentümern gehalten werden.