Đánh số tự động (Auto Number)

Mục đích

Bước Đánh số tự động (Auto Number) cấp một số chạy (running number) theo một khóa phạm vi (scope key) bạn chọn, rồi định dạng số đó thành một mã theo mẫu mã số (code template). Bước này chỉ cấp giá trị bên trong phiên chạy hiện tại — nó không tự ghi giá trị vừa cấp vào bất kỳ Bản ghi Thực thể nào. Muốn lưu mã đó vào một trường, hãy thêm bước Đặt biến (Set variable) hoặc Bản ghi thực thể (Entity record) ngay sau bước này.

Khi nào dùng

Cần một mã số chạy dùng ngay trong phiên chạy (ví dụ số biên bản, số công văn) trước khi tài liệu hoặc bản ghi được tạo.
Muốn đặt tên tệp tài liệu xuất ra theo một mẫu mã có số thứ tự.
Cần đánh số liên tục đúng quy định — chỉ cấp số sau khi mọi cổng phê duyệt đã hoàn tất, để tránh bỏ trống số cho các phiên chạy bị từ chối giữa chừng.
Muốn tính mã trước rồi mới quyết định ghi vào Thực thể nào, thay vì gắn cứng bộ đếm vào một Thực thể cụ thể.

Cài đặt chính

Cài đặt	Mô tả
Khóa phạm vi (scope key)	Nhóm bộ đếm. Mỗi khóa phạm vi khác nhau có số chạy riêng — thêm năm để đặt lại theo năm, ví dụ `hstl:{{ year() }}`. Gõ `@` để chèn giá trị từ bước trước.
Mẫu mã số (code template)	Định dạng số vừa cấp thành chuỗi mã cuối cùng. Dùng `{{ value }}` cho số, `{{ value \| pad(3) }}` để thêm số 0 phía trước. Gõ `@` để chèn giá trị.

Cả hai trường đều dùng cú pháp biểu thức {{ }} và có sẵn hàm year() (năm hiện tại) cùng bộ lọc pad (thêm số 0 ở đầu, ví dụ {{ 5 | pad(3) }} → 005). Riêng Mẫu mã số còn có thêm value — chính số vừa được cấp cho lần chạy này.

Đầu ra

Bước Đánh số tự động trả ra hai giá trị mà các bước sau có thể tham chiếu qua nodes.{id}.output:

Đường dẫn	Mô tả
`nodes.{id}.output.value`	Số vừa được cấp (số nguyên).
`nodes.{id}.output.code`	Chuỗi mã đã định dạng theo Mẫu mã số.

Dùng nodes.{id}.output.code để điền vào tên tệp tài liệu, tiêu đề hoặc nội dung email, hoặc gán vào một trường Thực thể thông qua bước Đặt biến hay Bản ghi thực thể.

Ví dụ

Trong quy trình Xử lý công văn đến, sau khi công văn được phân loại và người phụ trách xác nhận, bạn thêm một bước Đánh số tự động:

Khóa phạm vi: cvd:{{ year() }}
Mẫu mã số: {{ value | pad(4) }}/CV-{{ year() }}

Bước này cấp ra nodes.danh_so.output.code = 0007/CV-2026. Bước Tạo tài liệu phía sau dùng giá trị này để đặt tên tệp, và bước Bản ghi thực thể ghi nó vào trường so_cong_van của Thực thể Công văn.

Xem thêm: Đặt biến · Bản ghi thực thể · Tạo tài liệu