Tác giả: Andrey Glushkov
Các mẫu tài liệu chứa các mã tượng trưng được sử dụng thay cho các dữ liệu khác. Ví dụ: mã {DocumentCreateTime} được sử dụng trong mẫu tài liệu và được thay thế bằng thời gian tạo tài liệu thực tế trong biểu mẫu in tài liệu.
Nhưng có các định dạng ngày hoặc định dạng địa chỉ khác nhau, làm thế nào bạn có thể chọn một định dạng ngày cụ thể mà bạn cần ?
Đừng lo lắng, bạn có thể sửa đổi các mã tượng trưng trong các mẫu tài liệu và giải quyết vấn đề này.
Cách thức hoạt động
Bạn có thể thêm các ký hiệu cụ thể sau ~ vào mã ký hiệu để thay đổi định dạng dữ liệu. Ví dụ: {DocumentCreateTime~dmY h:s}
| Đọc thêm về cách chỉnh sửa các mẫu tài liệu trong bài viết - Các mẫu tài liệu. |
Bạn có thể sửa đổi mã tượng trưng cho ngày tháng, địa chỉ, tên và số tiền.
Ngày và giờ
Theo mặc định, định dạng ngày trong mẫu tài liệu giống với quốc gia chứa mẫu tài liệu này. Hãy sửa đổi mã ký hiệu được sử dụng để thêm thời gian tạo tài liệu vào biểu mẫu in tài liệu.
| Các định dạng ngày và giờ khả dụng |
⬪ dmy - 30.08.18 ⬪ dmY - 30.08.2018 ⬪ d, n, y - 30, 8, 2018 ⬪ H:i:s - 15:07:06 ⬪ Ymd g:i:sa - 2018-08-30 3:07:06 chiều ⬪ F j, Y, G:i - 30/08/2018 15:07 Bạn có thể đọc thêm về các định dạng ngày và giờ có thể có trong bài viết. | |
Đây là hiển thị bản in:
Tên
Bạn có thể sửa đổi định dạng tên bằng cách thêm các từ cụ thể vào mã ký hiệu. Ví dụ: mã tượng trưng {FormattedName~Format=#TITLE# #NAME# #SECOND_NAME_SHORT# #LAST_NAME#} sẽ được thay thế bằng lời chào, tên, chữ cái đầu tiên của tên thứ hai và họ ở dạng in.
| Tham số định dạng tên |
⬪ #TITLE# - lời chào ⬪ #NAME# - tên ⬪ #LAST_NAME# - họ ⬪ #SECOND_NAME# - tên thứ hai ⬪ #NAME_SHORT# - chữ cái đầu tiên của tên ⬪ #LAST_NAME_SHORT# - chữ cái đầu tiên của họ ⬪ #SECOND_NAME_SHORT# - chữ cái đầu tiên của tên thứ hai | |
Địa chỉ
Theo mặc định, định dạng địa chỉ trong mẫu tài liệu giống với định dạng địa chỉ được sử dụng ở quốc gia chứa mẫu tài liệu này. Nhưng chúng tôi có thể sửa đổi mã ký hiệu địa chỉ và sử dụng, chẳng hạn như định dạng địa chỉ Bắc Mỹ mặc dù mẫu tài liệu được liên kết với Vương quốc Anh.
| Định dạng địa chỉ và dấu phân cách |
Phần Định dạng của mã ký hiệu xác định loại định dạng địa chỉ: ⬪ 1 - Châu Âu ⬪ 2 - Vương quốc Anh ⬪ 3 - Bắc Mỹ ⬪ 4 - Nga (Đường phố-->Quốc gia) ⬪ 5 - Nga (Quốc gia-->Đường phố) Phần Dấu phân cách của mã ký hiệu xác định loại dấu phân cách được sử dụng trong địa chỉ ở dạng in: ⬪ 1 - dấu phẩy ⬪ 2 - không có dải phân cách ⬪ 3 - ngắt dòng | |
Đây là hiển thị bản in tài liệu sau khi sửa đổi mã ký hiệu địa chỉ:
| Mã tượng trưng {Address} sẽ được thay thế bằng địa chỉ được chỉ định trong trường Địa chỉ đường phố của chi tiết công ty. |
Số tiền
Đối với số tiền, bạn có thể sửa đổi mã ký hiệu để các số 0 sau dấu chấm và tiền tệ sẽ được hiển thị ở dạng in của tài liệu.
| Tham số số tiền |
⬪ WZ (Có số không) - nếu bạn chọn giá trị Y, số không sau dấu chấm sẽ được hiển thị. Ví dụ: 12.00 thay vì 12. ⬪ NS (Không có dấu) - nếu bạn chọn giá trị N, ký hiệu tiền tệ sẽ được thêm vào. Nếu bạn chọn giá trị Y, ký hiệu tiền tệ sẽ không được hiển thị. | |
Ví dụ: hãy sửa đổi mã ký hiệu {TotalSum} để các số 0 sau dấu chấm sẽ được hiển thị và ký hiệu tiền tệ sẽ được thêm vào:
Đây là hiển thị bản in tài liệu:
Số điện thoại
Bạn có thể chỉ định định dạng số điện thoại bằng cách thêm mã ký hiệu cụ thể sau định dạng. Ví dụ:
{ClientPhone~format=E.164}
Các định dạng có sẵn:
⬪ E.164 - +12122191234
⬪ Quốc tế - +1 212 219-12-34
⬪ Quốc Gia - 1 (212) 219-12-34
Một sản phẩm, thuế hoặc liên hệ cụ thể từ danh sách
Một số dữ liệu được thêm vào tài liệu dưới dạng danh sách. Ví dụ: thuế, sản phẩm hoặc địa chỉ liên hệ.
| Đọc cách thêm danh sách vào tài liệu trong bài viết - Mẫu tài liệu. |
Bạn có thể thêm vào tài liệu một mục cụ thể từ danh sách. Chỉ cần sử dụng mã tượng trưng:
{ProductsProductName}
Theo mặc định, mục đầu tiên trong danh sách sẽ được thêm vào tài liệu.
Nếu bạn cần thêm một mục không phải là mục đầu tiên trong danh sách, chỉ cần thêm chỉ mục vào mã tượng trưng này. Ví dụ: mã tượng trưng này sẽ thêm mục thứ ba:
{ProductsProductName~index=2}
| Mục đầu tiên trong danh sách có index=0. |
"Nhiều" trường
Trong Bitrix24 CRM, các trường có thể được đánh dấu là Nhiều. Điều đó có nghĩa là trường này có thể có nhiều giá trị cùng một lúc. Ví dụ: các trường Điện thoại, Email, Messeneger hoặc bất kỳ trường tùy chỉnh nào được đánh dấu là Nhiều.
| Các mẫu tài liệu không hỗ trợ Bind To CRM Elements và các loại tệp của "Nhiều" trường. |
Trước tiên, hãy sử dụng mã ký hiệu để thêm các giá trị của "nhiều" trường vào tài liệu:
⬪ mfirst=y - thêm giá trị đầu tiên
⬪ mfirst=n - thêm tất cả các giá trị
Ví dụ:
{TestField~mfirst=n}
Theo mặc định, các giá trị được phân tách bằng dấu phẩy. Sử dụng mseparator mã tượng trưng để chọn dấu phân cách - cooma (1) hoặc ngắt dòng (2):
{TestField~mseparator=2}
Liệt kê tất cả các sản phẩm, liên hệ hoặc thuế từ danh sách
Ví dụ: bạn có thể liệt kê tất cả các sản phẩm trong tài liệu. Chỉ cần thêm all=y vào mã tượng trưng tương ứng:
{ProductsProductName~all=y}
Thay vì dấu phẩy, bạn có thể sử dụng dấu ngắt dòng làm dấu phân cách bằng cách thêm mseparator=2 vào mã ký hiệu:
{ProductsProductName~mseparator=2,all=y}
Trường hợp văn bản (từ phiên bản documentgenerator 22.200.0)
Một trong những yêu cầu thường xuyên là công cụ sửa đổi để thay đổi kiểu chữ.
Ví dụ: {DocumentCreateTime~format=d F Y} hiển thị tên của tháng bằng chữ in hoa.
Bây giờ bạn có thể thêm công cụ letterCase vào bất kỳ trường nào để thay đổi kiểu chữ.
Công cụ sửa đổi có thể nhận các giá trị sau:
⬪ upper - chữ hoa,
⬪ lower - chữ thường,
⬪ title - chữ hoa cho chữ cái đầu tiên của mỗi từ.
Bài viết được đề xuất
⬪ Địa chỉ của khách hàng trong hóa đơn
