> ## Documentation Index
> Fetch the complete documentation index at: https://huongdan.luklak.com/llms.txt
> Use this file to discover all available pages before exploring further.

# UQL Nâng cao: Truy vấn xuyên Đối tượng

> Dot notation, hàm tích hợp, truy vấn lịch sử — khai thác toàn bộ sức mạnh UQL cho phân tích chuyên sâu.

## 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 `Task` mà `Project` cha thuộc `Client` ở "TP.HCM".
  * `parent.client.city = "TP.HCM"`
  * Chuỗi: Task → Project → Client.

## Hàm tích hợp

| Hàm                | Mô tả                                | Ví dụ                        |
| :----------------- | :----------------------------------- | :--------------------------- |
| `currentUser()`    | Người dùng đang chạy truy vấn        | `assignee = "currentUser()"` |
| `now()`            | Ngày giờ hiện tại                    | `start_date > "now()"`       |
| `today()`          | Ngày hôm nay (không giờ)             | `due_date = "today()"`       |
| `count(field_key)` | Đếm số item trong trường multi-value | `count(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."

```uql theme={null}
status = "IN_PROGRESS" AND assignee = "currentUser()" AND parent.client.tier = "Enterprise" AND count(parent.stakeholders) > 5
```

***

## Đọc tiếp

* [Quay lại Tổng quan UQL](/02-platform/platform-overview/filter-and-uql/index)
* [Kiến trúc nền tảng](/02-platform/platform-overview/index)