Skip to main content

Vượt qua cơ bản

Giờ là lúc mở khóa sức mạnh thực sự: truy vấn xuyên suốt mô hình dữ liệu.

Truy vấn xuyên Đối tượng (Cross-Object)

Khi có Object Picker hoặc quan hệ Cha-Con, UQL cho phép “đi qua” quan hệ bằng dot notation.

Cú pháp

referencing_field_key.field_on_referenced_object
  • VD đơn giản: Tìm tất cả Project của khách hàng enterprise.
    • client.tier = "Enterprise"
    • client = trường trên 🧊 Project, tier = trường trên 🧊 Client.
  • VD nhiều tầng: Tìm TaskProject cha thuộc Client ở “TP.HCM”.
    • parent.client.city = "TP.HCM"
    • Chuỗi: Task → Project → Client.

Hàm tích hợp

HàmMô tảVí dụ
currentUser()Người dùng đang chạy truy vấnassignee = "currentUser()"
now()Ngày giờ hiện tạistart_date > "now()"
today()Ngày hôm nay (không giờ)due_date = "today()"
count(field_key)Đếm số item trong trường multi-valuecount(sub_tasks) > 10

Truy vấn Lịch sử

Dùng operator đặc biệt để kiểm tra lịch sử chuyển trạng thái:
  • status changed from "ĐANG DUYỆT" to "ĐÃ DUYỆT"
  • Phù hợp cho Dashboard đo hiệu suất quy trình hoặc Saved Filter tìm Đầu việc đã qua giai đoạn duyệt.

Ví dụ tổng hợp

Câu hỏi: “Tìm tất cả Task ĐANG LÀM giao cho tôi, thuộc Project của khách Enterprise, mà Project đó có hơn 5 stakeholder.”
status = "IN_PROGRESS" AND assignee = "currentUser()" AND parent.client.tier = "Enterprise" AND count(parent.stakeholders) > 5

Đọc tiếp