Tăng sức mạnh tích hợp của bạn với Trình thiết kế API nâng cao!

Chúng tôi rất vui mừng được thông báo những cải tiến quan trọng mà chúng tôi đã thực hiện đối với mô-đun Trình thiết kế API.

Những cải tiến này sẽ giúp bạn xây dựng các API tùy chỉnh mạnh mẽ và hiệu quả hơn nữa. Họ tập trung vào việc cải thiện các hoạt động hàng loạt, mở rộng chức năng API chọn lọc và tăng cường việc sử dụng nhiều điều kiện trường.

Hãy cùng đi sâu vào chi tiết về những cải tiến này:

Cải tiến 1: Hỗ trợ vận hành hàng loạt cho các bản ghi CẬP NHẬT/UPSERT

Trình thiết kế API: Hỗ trợ vận hành hàng loạt

Với bản cập nhật mới nhất, bạn có thể thực hiện các thao tác hàng loạt để cập nhật hoặc nâng cấp bản ghi. Tính năng nâng cao này cho phép bạn tạo hoặc cập nhật nhiều bản ghi trong một yêu cầu, giúp tương tác API của bạn hiệu quả và tiết kiệm thời gian.

Tính năng chính:

  • Tạo API: Tạo nhiều bản ghi trong một yêu cầu bằng cách chuyển tham số Bulk="true". Tài liệu liên quan
  • Cập nhật API: Trước đây, bạn chỉ có thể cập nhật một bản ghi cho mỗi yêu cầu. Giờ đây, bạn có thể cập nhật nhiều bản ghi trong một yêu cầu bằng cách khớp với điều kiện Where. Tài liệu liên quan

Giới hạn bản ghi hàng loạt: 50

Trường hợp sử dụng mẫu:

Mô-đun Danh bạ: Cập nhật nhiều bản ghi của bất kỳ trường nào bằng một yêu cầu duy nhất. Ví dụ: bạn có thể cập nhật nhiều bản ghi người liên hệ bằng cách khớp các điều kiện cụ thể hoặc tạo bản ghi mới nếu chúng không tồn tại.

 

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

Cải tiến này hợp lý hóa quy trình làm việc của bạn, giảm số lượng lệnh gọi API cần thiết cho các hoạt động hàng loạt.

Cải tiến 2: Chọn API để hỗ trợ trả về các trường mô-đun gốc

Trình thiết kế API: API chọn nâng cao

Chúng tôi đã mở rộng chức năng của Select API để bao gồm các trường từ mô-đun trường tham chiếu. Cải tiến này cho phép bạn tìm nạp dữ liệu toàn diện trong một yêu cầu duy nhất.

Tính năng chính:

  • Trước đây, Select API chỉ có thể truy xuất các trường từ mô-đun hiện tại.
  • Giờ đây, bạn cũng có thể chọn các trường từ mô-đun trường tham chiếu.

Các trường hợp sử dụng mẫu - Mối quan hệ giữa các trường hợp và liên hệ (N:1):

  • Tìm nạp hồ sơ trường hợp cùng với số điện thoại của người liên hệ có liên quan.
  • Truy xuất hồ sơ trường hợp cùng với họ và tên của người liên hệ.
  • Nhận hồ sơ trường hợp với số điện thoại di động và tên đầy đủ của người dùng 'Được chỉ định cho'.
 

Cải tiến này hợp lý hóa quy trình làm việc của bạn, giảm số lượng lệnh gọi API cần thiết cho các hoạt động hàng loạt.

Cải tiến 2: Chọn API để hỗ trợ trả về các trường mô-đun gốc

Trình thiết kế API: API chọn nâng cao

Chúng tôi đã mở rộng chức năng của Select API để bao gồm các trường từ mô-đun trường tham chiếu. Cải tiến này cho phép bạn tìm nạp dữ liệu toàn diện trong một yêu cầu duy nhất.

Tính năng chính:

  • Trước đây, Select API chỉ có thể truy xuất các trường từ mô-đun hiện tại.
  • Giờ đây, bạn cũng có thể chọn các trường từ mô-đun trường tham chiếu.

Các trường hợp sử dụng mẫu - Mối quan hệ giữa các trường hợp và liên hệ (N:1):

  • Tìm nạp hồ sơ trường hợp cùng với số điện thoại của người liên hệ có liên quan.
  • Truy xuất hồ sơ trường hợp cùng với họ và tên của người liên hệ.
  • Nhận hồ sơ trường hợp với số điện thoại di động và tên đầy đủ của người dùng 'Được chỉ định cho'.
 

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

Cải tiến này cho phép bạn truy cập dữ liệu chi tiết và được kết nối với nhau, đơn giản hóa quá trình truy xuất dữ liệu.

Cải tiến 3: Đã thêm hỗ trợ cho nhiều điều kiện trường trong mệnh đề Where

Trình thiết kế API: Mệnh đề nâng cao

Với bản cập nhật này, bạn có thể sử dụng nhiều trường trong điều kiện Where của truy vấn Chọn. Cải tiến này mang lại sự linh hoạt và chính xác cao hơn trong việc lọc dữ liệu của bạn.

Tính năng chính:

  • Nhiều điều kiện trường: Thêm nhiều trường từ mô-đun hiện tại hoặc mô-đun trường tham chiếu trong điều kiện ở đâu.
  • Tham số keo: Sử dụng tham số keo (glue="or" hoặc keo="và") để kết hợp nhiều điều kiện.

Các trường hợp sử dụng mẫu - Mô-đun đơn giản:

  • Thêm điều kiện vào 'Giai đoạn bán hàng' và 'Nguồn khách hàng tiềm năng' bằng keo="hoặc".
  • Bao gồm các trường tham chiếu trong điều kiện Where, chẳng hạn như contact_id và liên quan_to.
 

Cải tiến này cho phép bạn truy cập dữ liệu chi tiết và được kết nối với nhau, đơn giản hóa quá trình truy xuất dữ liệu.

Cải tiến 3: Đã thêm hỗ trợ cho nhiều điều kiện trường trong mệnh đề Where

Trình thiết kế API: Mệnh đề nâng cao

Với bản cập nhật này, bạn có thể sử dụng nhiều trường trong điều kiện Where của truy vấn Chọn. Cải tiến này mang lại sự linh hoạt và chính xác cao hơn trong việc lọc dữ liệu của bạn.

Tính năng chính:

  • Nhiều điều kiện trường: Thêm nhiều trường từ mô-đun hiện tại hoặc mô-đun trường tham chiếu trong điều kiện ở đâu.
  • Tham số keo: Sử dụng tham số keo (glue="or" hoặc keo="và") để kết hợp nhiều điều kiện.

Các trường hợp sử dụng mẫu - Mô-đun đơn giản:

  • Thêm điều kiện vào 'Giai đoạn bán hàng' và 'Nguồn khách hàng tiềm năng' bằng keo="hoặc".
  • Bao gồm các trường tham chiếu trong điều kiện Where, chẳng hạn như contact_id và liên quan_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>
 

Ví dụ phức tạp: Bạn cũng có thể thêm các điều kiện liên quan đến trường tham chiếu từ các mô-đun liên quan. Ví dụ:

  • Các mối quan hệ: Có mối quan hệ (N:1) giữa Giao dịch và Người liên hệ, cũng như giữa Giao dịch và Tài khoản.
  • Điều kiện kết hợp: Thêm điều kiện trên contact_id và liên quan_để sử dụng keo="hoặc". Nếu một hoặc cả hai giá trị tham số khớp nhau thì phản hồi sẽ được trả về.
 

Ví dụ phức tạp: Bạn cũng có thể thêm các điều kiện liên quan đến trường tham chiếu từ các mô-đun liên quan. Ví dụ:

  • Các mối quan hệ: Có mối quan hệ (N:1) giữa Giao dịch và Người liên hệ, cũng như giữa Giao dịch và Tài khoản.
  • Điều kiện kết hợp: Thêm điều kiện trên contact_id và liên quan_để sử dụng keo="hoặc". Nếu một hoặc cả hai giá trị tham số khớp nhau thì phản hồi sẽ được trả về.

 

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

Cải tiến này cung cấp cho bạn khả năng tạo các truy vấn phức tạp và tinh tế hơn, đảm bảo bạn truy xuất chính xác dữ liệu mình cần.

Chúng tôi tin rằng những cải tiến này sẽ cải thiện đáng kể trải nghiệm của bạn với mô-đun Trình thiết kế API của chúng tôi, khiến mô-đun này trở nên linh hoạt và mạnh mẽ hơn. Chúng tôi khuyến khích bạn khám phá những tính năng mới này và xem chúng có thể mang lại lợi ích như thế nào cho các dự án phát triển của bạn.

Hãy theo dõi để biết thêm thông tin cập nhật.

Chúc bạn viết mã vui vẻ!
 

Cải tiến này cung cấp cho bạn khả năng tạo các truy vấn phức tạp và tinh tế hơn, đảm bảo bạn truy xuất chính xác dữ liệu mình cần.

Chúng tôi tin rằng những cải tiến này sẽ cải thiện đáng kể trải nghiệm của bạn với mô-đun Trình thiết kế API của chúng tôi, khiến mô-đun này trở nên linh hoạt và mạnh mẽ hơn. Chúng tôi khuyến khích bạn khám phá những tính năng mới này và xem chúng có thể mang lại lợi ích như thế nào cho các dự án phát triển của bạn.

Hãy theo dõi để biết thêm thông tin cập nhật.

Chúc bạn viết mã vui vẻ!
 
 

Đăng ký để nhận thông tin cập nhật mới nhất!

 
 

Bản quyền 2026 Vtiger. Đã đăng ký Bản quyền. Nhãn hiệu khác nhau được tổ chức bởi chủ sở hữu tương ứng của họ.