# Version khác revision thế nào?

Phân biệt version và revision; chọn version khi tạo PDF.

Bạn sẽ gặp cả **version** và **revision** khi làm việc với mẫu. Version giúp chọn bản mẫu để sử dụng; revision ghi lại những lần thay đổi bên trong bản đó. Hiểu hai lớp này sẽ giúp bạn vừa phát triển thiết kế mới, vừa tìm lại nội dung đã lưu.

## 1. Version là bản bạn chọn để chạy

Một template có thể có v1, v2 và các version tiếp theo. Mỗi version có nội dung và trạng thái Draft/Published riêng. Trong Run, bạn chọn số version trước khi tạo PDF.

Khi tích hợp, chỉ định `version` để quy trình dùng đúng bản đã chọn. Nếu bỏ qua, hệ thống lấy current version của template; giá trị này không đồng nghĩa với “bản published mới nhất”.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Run → Version chọn bản mẫu dùng cho lần chạy">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>RUN</strong><div class="wf-actions"></div></div><div class="wf-fields"><div><small class="sim-label">VERSION</small><span class="sim-input wf-select sim-focus">v2<svg class="sim-chevron" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><path d="m4 6 4 4 4-4" /></svg></span></div><div><small class="sim-label">VARIANT</small><span class="sim-input wf-select">Standard<svg class="sim-chevron" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><path d="m4 6 4 4 4-4" /></svg></span></div></div></div></div>
<figcaption>Run → Version chọn bản mẫu dùng cho lần chạy</figcaption>
</figure>

## 2. Revision ghi các lần thay đổi trong version

Khi nội dung được lưu, lịch sử ghi một revision để bạn xem lại hoặc khôi phục. Ví dụ, v2 có thể gồm revision 1 khi tạo, revision 2 khi đổi nội dung và revision 3 khi chỉnh CSS.

Số revision không thay cho số version trong Run. Chỉ định v2 cũng không ghim vào một revision bất biến: v2 vẫn có thể được lưu thêm thay đổi.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Một version có nhiều revision trong lịch sử">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>Version 2 · History</strong><div class="wf-actions"></div></div><div class="wf-rows"><div class="sim-focus"><span>Revision 3</span><small>Sửa CSS · hiện tại</small></div><div class=""><span>Revision 2</span><small>Đổi nội dung</small></div><div class=""><span>Revision 1</span><small>Tạo version</small></div></div></div></div>
<figcaption>Một version có nhiều revision trong lịch sử</figcaption>
</figure>

## 3. Tạo version từ bản có sẵn hoặc bắt đầu trống

Mở bộ chọn version ở thanh trên cùng và chọn **New version**. Chọn version nguồn rồi bấm **Create** để dùng lại thiết kế đó; hoặc chọn **Blank** để bắt đầu trống.

Đợi quá trình tạo hoàn tất trước khi chỉnh. Version mới cần được kiểm tra và publish riêng; các lần gọi đang chỉ định version cũ vẫn dùng số cũ cho đến khi bạn đổi.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="New version → chọn nguồn → Create hoặc Blank">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>New version</strong><div class="wf-actions"></div></div><div class="wf-fields"><div><small class="sim-label">BASED ON</small><span class="sim-input wf-select sim-focus">Version 1<svg class="sim-chevron" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><path d="m4 6 4 4 4-4" /></svg></span></div></div><div class="sim-form-footer ds-pad"><span class="sim-control">Blank</span><span class="sim-control sim-dark">Create</span></div></div></div>
<figcaption>New version → chọn nguồn → Create hoặc Blank</figcaption>
</figure>

## 4. Phân biệt version, variant và schemaVersion

Ba tên gần nhau nhưng dùng cho ba việc khác nhau:

| Tên | Vai trò |
| --- | --- |
| Version | Bản mẫu được chọn khi tạo PDF. |
| Variant | Bộ giá trị hoặc phần hiển thị khác nhau trong một version. |
| `schemaVersion` | Định dạng dữ liệu của template trong file JSON. |

Nếu chỉ cần đổi bộ nhãn hoặc màu mà vẫn dùng chung cấu trúc, xem [Variants](/docs/vi/data/variants/). Nếu cần quay lại một lần lưu trước, dùng [lịch sử revision](/docs/vi/publishing/history/).

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Version và Variant được chọn riêng trong Run">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>RUN</strong><div class="wf-actions"></div></div><div class="wf-fields"><div><small class="sim-label">VERSION</small><span class="sim-input wf-select sim-focus">v2<svg class="sim-chevron" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><path d="m4 6 4 4 4-4" /></svg></span></div><div><small class="sim-label">VARIANT</small><span class="sim-input wf-select">Standard<svg class="sim-chevron" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><path d="m4 6 4 4 4-4" /></svg></span></div></div></div></div>
<figcaption>Version và Variant được chọn riêng trong Run</figcaption>
</figure>