# Preview và render thật

Phân biệt preview và render về điều kiện chạy, quota và lưu kết quả.

Bạn có thể xem tài liệu ngay trong editor, hoặc tạo một PDF để tải và sử dụng. **Preview** phục vụ quá trình chỉnh mẫu; **render** tạo một công việc có trạng thái, lịch sử và file kết quả. Chọn theo việc bạn đang cần làm, thay vì chỉ nhìn vào hai bản xem trước giống nhau.

## 1. Preview khi đang chỉnh mẫu

Dùng **Layout** và **PDF** trong editor để xem bố cục và kết quả phân trang. Bạn có thể preview version còn Draft mà chưa cần publish.

Preview không tính quota render thành công và không tạo một PDF lưu trong Renders như lần chạy thật. Các giới hạn tài nguyên và thời gian xử lý vẫn áp dụng cho việc xem thử.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Editor → Layout / PDF dùng để xem thử">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>Editor</strong><div class="wf-actions"><span class="sim-control sim-focus">PDF</span></div></div><div class="sim-tabs"><span class="">Layout</span><span class="sim-active">PDF</span></div><div class="wf-canvas"><div class="wf-paper"><b>Tembuilder</b><strong>Document</strong><i></i><i></i><i></i><i></i><small>1 / 1</small></div></div></div></div>
<figcaption>Editor → Layout / PDF dùng để xem thử</figcaption>
</figure>

**Layout** phản ánh phần thiết kế đang chỉnh. **PDF** dựng nội dung mẫu đã lưu: hãy Save rồi tạo lại PDF preview sau khi sửa. Dữ liệu preview lấy từ các giá trị của editor, ban đầu là Default; giá trị nhập ở Run chỉ dùng cho công việc của Run. Bản PDF preview trước đó không tự cập nhật.

## 2. Render khi cần file kết quả

Mở **Run** hoặc dùng render API để tạo PDF. Version cần published và key cần quyền `template:render` trong đúng project.

Lần chạy thành công được tính vào quota, có bản ghi trong Renders và file có thể tải trong thời gian lưu trữ của gói. Run trong editor cũng tạo loại công việc này.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Published version + dữ liệu → Render → PDF">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>RUN</strong><div class="wf-actions"></div></div><div class="wf-rows"><div class=""><span>Version 2</span><small>Published</small></div><div class=""><span>Parameters</span><small>{ recipient: &quot;Tembuilder&quot; }</small></div></div><div class="sim-form-footer ds-pad"><span class="sim-control sim-focus sim-dark">Render</span></div></div></div>
<figcaption>Published version + dữ liệu → Render → PDF</figcaption>
</figure>

## 3. Chọn đúng cách cho từng bước

| Bạn đang cần | Dùng |
| --- | --- |
| Chỉnh font, lề, nội dung hoặc ngắt trang | Preview trong editor. |
| Thử một bộ dữ liệu với bản đã publish | Run. |
| Tạo PDF từ phần mềm của bạn | Render API. |
| Tìm lại file hoặc lỗi của lần chạy | Renders. |

Để thao tác trực tiếp mà chưa viết tích hợp, bắt đầu với [Thử dữ liệu trong Run](/docs/vi/renders/playground/).

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Preview phục vụ chỉnh mẫu · Run tạo PDF có lịch sử">
<div class="sim-stage"><div class="ds-columns"><div class="sim-panel"><div class="ds-head"><strong>Preview</strong><div class="wf-actions"></div></div><div class="wf-rows"><div class="sim-focus"><span>Draft</span><small>✓</small></div><div class=""><span>Renders</span><small>—</small></div></div></div><div class="sim-panel"><div class="ds-head"><strong>Run</strong><div class="wf-actions"></div></div><div class="wf-rows"><div class="sim-focus"><span>Published</span><small>✓</small></div><div class=""><span>Renders</span><small>✓</small></div></div></div></div></div>
<figcaption>Preview phục vụ chỉnh mẫu · Run tạo PDF có lịch sử</figcaption>
</figure>

## 4. Khi preview được nhưng Run chưa chạy được

Đối chiếu version đang mở trong editor với version được chọn ở Run: hai lựa chọn có thể khác nhau. Sau đó kiểm tra trạng thái Published, key đang dùng và dữ liệu đầu vào.

Nếu công việc đã được nhận, mở kết quả trong Renders để đọc lỗi cụ thể. Việc nhận yêu cầu chưa có nghĩa PDF đã hoàn tất; chỉ tải file khi trạng thái là `success` và output sẵn sàng.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Đối chiếu Version trong Run với bản đã publish">
<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>Đối chiếu Version trong Run với bản đã publish</figcaption>
</figure>