Wzmocnij swoje integracje dzięki ulepszonemu Projektantowi API!

Z radością ogłaszamy znaczące ulepszenia, które wprowadziliśmy w module API Designer.

Te ulepszenia umożliwią Ci tworzenie jeszcze bardziej wydajnych i wydajnych niestandardowych interfejsów API. Koncentrują się na ulepszaniu operacji masowych, rozszerzaniu wybranych funkcji API i ulepszaniu wykorzystania wielu warunków polowych.

Przyjrzyjmy się szczegółom tych ulepszeń:

Ulepszenie 1: Obsługa operacji zbiorczych dla rekordów UPDATE/UPSERT

Projektant API: Obsługa operacji zbiorczych

Dzięki najnowszej aktualizacji możesz wykonywać operacje zbiorcze w celu aktualizacji lub wstawiania rekordów. To ulepszenie umożliwia tworzenie lub aktualizowanie wielu rekordów w jednym żądaniu, dzięki czemu interakcje z interfejsem API są wydajne i oszczędzają czas.

Kluczowe cechy:

  • Utwórz API: Utwórz wiele rekordów w jednym żądaniu, przekazując parametr „bulk="true". Powiązany dokument
  • Zaktualizuj interfejs API: Wcześniej można było zaktualizować tylko jeden rekord na żądanie. Teraz możesz zaktualizować wiele rekordów w jednym żądaniu, dopasowując warunek Where. Powiązany dokument

Limit rekordów zbiorczych: 50

Przykładowy przypadek użycia:

Moduł kontaktów: Aktualizuj wiele rekordów dowolnego pola za pomocą jednego żądania. Na przykład możesz zaktualizować wiele rekordów kontaktów, dopasowując określone warunki lub tworząc nowe, jeśli nie istnieją.


  

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

 

To ulepszenie usprawnia przepływ pracy, zmniejszając liczbę wywołań API wymaganych w przypadku operacji masowych.

Ulepszenie 2: Wybierz interfejs API do obsługi zwracanych pól modułu nadrzędnego

Projektant API: Ulepszony interfejs Select API

Rozszerzyliśmy funkcjonalność Select API o pola z modułów pól referencyjnych. To ulepszenie umożliwia pobranie kompleksowych danych w jednym żądaniu.

Kluczowe cechy:

  • Wcześniej interfejs Select API mógł pobierać tylko pola z bieżącego modułu.
  • Teraz możesz wybierać pola również z modułów pól referencyjnych.

Przykładowe przypadki użycia - relacje przypadków i kontaktów (N:1):

  • Pobierz zapisy spraw wraz z numerami telefonów odpowiednich kontaktów.
  • Pobierz dokumentację sprawy wraz z imieniem i nazwiskiem kontaktu.
  • Uzyskaj dokumentację spraw zawierającą numer telefonu komórkowego i imię i nazwisko użytkownika „Przypisane do”.
 

To ulepszenie usprawnia przepływ pracy, zmniejszając liczbę wywołań API wymaganych w przypadku operacji masowych.

Ulepszenie 2: Wybierz interfejs API do obsługi zwracanych pól modułu nadrzędnego

Projektant API: Ulepszony interfejs Select API

Rozszerzyliśmy funkcjonalność Select API o pola z modułów pól referencyjnych. To ulepszenie umożliwia pobranie kompleksowych danych w jednym żądaniu.

Kluczowe cechy:

  • Wcześniej interfejs Select API mógł pobierać tylko pola z bieżącego modułu.
  • Teraz możesz wybierać pola również z modułów pól referencyjnych.

Przykładowe przypadki użycia - relacje przypadków i kontaktów (N:1):

  • Pobierz zapisy spraw wraz z numerami telefonów odpowiednich kontaktów.
  • Pobierz dokumentację sprawy wraz z imieniem i nazwiskiem kontaktu.
  • Uzyskaj dokumentację spraw zawierającą numer telefonu komórkowego i imię i nazwisko użytkownika „Przypisane do”.

  

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

 

To ulepszenie umożliwia dostęp do szczegółowych i wzajemnie powiązanych danych, upraszczając procesy wyszukiwania danych.

Ulepszenie 3: Dodano obsługę wielu warunków pól w klauzuli Where

Projektant API: Zaawansowana klauzula Where

Dzięki tej aktualizacji możesz używać wielu pól w warunku Where w zapytaniach Wybierz. To ulepszenie zapewnia większą elastyczność i precyzję filtrowania danych.

Kluczowe cechy:

  • Warunki wielu pól: Dodaj więcej niż jedno pole z bieżącego modułu lub modułów pól odniesienia w warunku Where.
  • Parametr kleju: Użyj parametru kleju (glue="lub" lub klej="i"), aby połączyć wiele warunków.

Przykładowe przypadki użycia – moduł prosty:

  • Dodaj warunki na „Etap sprzedaży” i „Źródło potencjalnego klienta” za pomocą kleju „lub”.
  • Uwzględnij pola referencyjne w warunku Where, takie jak contact_id i powiązane_do.
 

To ulepszenie umożliwia dostęp do szczegółowych i wzajemnie powiązanych danych, upraszczając procesy wyszukiwania danych.

Ulepszenie 3: Dodano obsługę wielu warunków pól w klauzuli Where

Projektant API: Zaawansowana klauzula Where

Dzięki tej aktualizacji możesz używać wielu pól w warunku Where w zapytaniach Wybierz. To ulepszenie zapewnia większą elastyczność i precyzję filtrowania danych.

Kluczowe cechy:

  • Warunki wielu pól: Dodaj więcej niż jedno pole z bieżącego modułu lub modułów pól odniesienia w warunku Where.
  • Parametr kleju: Użyj parametru kleju (glue="lub" lub klej="i"), aby połączyć wiele warunków.

Przykładowe przypadki użycia – moduł prosty:

  • Dodaj warunki na „Etap sprzedaży” i „Źródło potencjalnego klienta” za pomocą kleju „lub”.
  • Uwzględnij pola referencyjne w warunku Where, takie jak contact_id i powiązane_do.

  

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

 

Złożony przykład: Możesz także dodać warunki obejmujące pola referencyjne z powiązanych modułów. Na przykład:

  • Relacje: Istnieje związek (N:1) pomiędzy Transakcjami i Kontaktami, a także pomiędzy Transakcjami i Kontami.
  • Połączone warunki: Dodaj warunki do contact_id i powiązane_to za pomocą kleju="lub". Jeśli jedna lub obie wartości parametrów są zgodne, odpowiedź zostanie zwrócona.

 

Złożony przykład: Możesz także dodać warunki obejmujące pola referencyjne z powiązanych modułów. Na przykład:

  • Relacje: Istnieje związek (N:1) pomiędzy Transakcjami i Kontaktami, a także pomiędzy Transakcjami i Kontami.
  • Połączone warunki: Dodaj warunki do contact_id i powiązane_to za pomocą kleju="lub". Jeśli jedna lub obie wartości parametrów są zgodne, odpowiedź zostanie zwrócona.


  

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

 

To ulepszenie umożliwia tworzenie bardziej złożonych i dopracowanych zapytań, zapewniając uzyskanie dokładnie tych danych, których potrzebujesz.

Wierzymy, że te ulepszenia znacząco poprawią Twoje doświadczenie z naszym modułem API Designer, czyniąc go bardziej wszechstronnym i wydajnym. Zachęcamy do zapoznania się z tymi nowymi funkcjami i sprawdzenia, jakie korzyści mogą one przynieść Twoim projektom programistycznym.

Bądź na bieżąco, aby uzyskać więcej aktualizacji.

Miłego kodowania!

 

To ulepszenie umożliwia tworzenie bardziej złożonych i dopracowanych zapytań, zapewniając uzyskanie dokładnie tych danych, których potrzebujesz.

Wierzymy, że te ulepszenia znacząco poprawią Twoje doświadczenie z naszym modułem API Designer, czyniąc go bardziej wszechstronnym i wydajnym. Zachęcamy do zapoznania się z tymi nowymi funkcjami i sprawdzenia, jakie korzyści mogą one przynieść Twoim projektom programistycznym.

Bądź na bieżąco, aby uzyskać więcej aktualizacji.

Miłego kodowania!

 
 

Zarejestruj się, aby otrzymywać najnowsze aktualizacje!