Đối tượng Liquid có sẵn

Các đối tượng Liquid chứa các thuộc tính để xuất nội dung động vào trang. Ví dụ: đối tượng trang có một thuộc tính được gọi là tiêu đề có thể được sử dụng để xuất tiêu đề của trang hiện tại.

Để truy cập một thuộc tính đối tượng theo tên, hãy sử dụng một dấu chấm (.). Để hiển thị thuộc tính của đối tượng trong mẫu, hãy gói thuộc tính đó trong {{ and }}.

Quan trọng

Để tránh các vấn đề tiềm ẩn với tập lệnh trên nhiều trang (XSS), hãy luôn sử dụng bộ lọc thoát để mã hóa HTML dữ liệu bất cứ khi nào sử dụng đối tượng Liquid để đọc dữ liệu không tin cậy do người dùng cung cấp.

{{ page.title }}

Cũng có thể truy cập các thuộc tính của một đối tượng bằng cách sử dụng tên chuỗi và []. Định dạng này là hữu ích trong trường hợp thuộc tính bắt buộc được xác định chủ động hoặc tên thuộc tính có chứa các ký tự, khoảng cách, ký tự đặc biệt, v.v mà có thể không hợp lệ khi sử dụng dấu chấm (.) bên trong cú pháp.

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

Có thể sử dụng và truy cập các đối tượng sau ở bất cứ vị trí nào trong bất kỳ mẫu nào.

Đối tượng	Nội dung mô tả
thực thể	Cho phép bạn tải bảng Microsoft Dataverse bất kỳ theo ID. Thông tin thêm: thực thể
bây giờ	Một đối tượng ngày/giờ đề cập đến thời gian UTC hiện tại, tại thời điểm mẫu được kết xuất. Lưu ý: Ứng dụng web cổng thông tin sẽ lưu trữ giá trị này và không làm mới mỗi lần. Thông tin khác: Bộ lọc ngày
trang	Tham chiếu đến trang yêu cầu cổng thông tin hiện tại. Đối tượng trang cung cấp quyền truy cập vào những nội dung như đường dẫn cho trang hiện tại, tiêu đề hoặc URL của trang hiện tại và bất kỳ thuộc tính nào khác hoặc các thực thể có liên quan của bản ghi Dataverse cơ sở. Thêm thông tin: trang
params	Một phím tắt tiện lợi cho request.params. Thông tin khác: yêu cầu
yêu cầu	Chứa thông tin về yêu cầu HTTP hiện tại. Thông tin khác: yêu cầu
thiết đặt	Cho phép bạn tải bất kỳ Thiết đặt Trang nào theo tên. Thông tin thêm: thiết đặt
sơ đồ trang web	Cho phép truy cập vào sơ đồ trang web trên cổng thông tin Thông tin thêm: sơ đồ trang web
đánh dấu trang	Cho phép bạn tải bất kỳ Công cụ đánh dấu Site nào theo tên. Thông tin thêm: công cụ đánh dấu trang web
đoạn mã	Cho phép bạn tải bất kỳ Đoạn mã Nội dung nào theo tên. Thông tin thêm: trích đoạn nội dung
người dùng	Đề cập đến người dùng cổng thông tin hiện tại, cho phép truy cập tất cả các thuộc tính của bản ghi liên hệ Dataverse cơ bản. Nếu không có người dùng nào đăng nhập, biến này là null. Thông tin thêm: người dùng
liên kết web	Cho phép bạn tải bất kỳ Bộ liên kết web nào theo tên hoặc ID. Thông tin thêm: liên kết trang web
trang web	Tham khảo bản ghi Trang web, cho phép truy cập tất cả các thuộc tính của bản ghi Trang web Dataverse (adx_website) cho cổng thông tin. Thông tin thêm: trang web

quảng cáo

Cho phép truy xuất và hiển thị quảng cáo.

Đối tượng quảng cáo cho phép bạn chọn một quảng cáo hoặc vị trí quảng cáo cụ thể:

<div>

{% assign ad = ads[Ad Name] %}

<h4>{{ ad.title }}</h4>

<a href={{ ad.redirect_url }}>

<img src={{ ad.image.url }} alt={{ ad.image.alternate_text }} />

</a>

</div>

Thuộc tính quảng cáo

Thuộc tính	Nội dung mô tả
vị trí	Trả về đối tượng adplacements.
[id hoặc tên quảng cáo]	Bạn có thể truy cập bất kỳ quảng cáo nào theo thuộc tính Tên hoặc Id của đối tượng. {% assign ad = ads[Ad Name] %} {% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Thuộc tính Vị trí Quảng cáo

Đặc điểm	Nội dung mô tả
[id hoặc tên vị trí quảng cáo]	Bạn có thể truy cập bất kỳ vị trí quảng cáo nào theo thuộc tính Tên hoặc Id của đối tượng. {% assign placement = ads.placements[Placement Name or Id] %} {% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %}

Thuộc tính Vị trí Quảng cáo

Vị trí đặt quảng cáo là một đối tượng bảng có cùng các thuộc tính chung và các thuộc tính sau:

Đặc điểm	Description
Quảng cáo	Trả về tập hợp các đối tượng quảng cáo được liên kết với vị trí. Thẻ lặp và Bộ lọc mảng có thể được sử dụng với bộ sưu tập này.
Tên	Trả về trường Tên cho vị trí quảng cáo.
placement_url	Có thể sử dụng URL để truy xuất vị trí quảng cáo được kết xuất đầy đủ theo mẫu.
random_url	URL có thể sử dụng để truy xuất quảng cáo ngẫu nhiên từ vị trí quảng cáo được kết xuất đầy đủ theo mẫu.

Thuộc tính quảng cáo

Lưu ý

Quảng cáo là một đối tượng dạng bảng, có tất cả các thuộc tính giống nhau ngoài ra còn có các thuộc tính sau:

Đặc điểm	Description
ad_url	URL có thể sử dụng để truy xuất quảng cáo được kết xuất đầy đủ theo mẫu.
Sao chép	Trả về trường Sao chép cho quảng cáo.
hình ảnh	Trả về đối tượng hình ảnh (nếu có) cho quảng cáo.
Tên	Trả về trường Tên cho quảng cáo.
open_in_new_window	Trả về true nếu URL được chỉ định theo redirect_url mở ra một cửa sổ mới.
redirect_url	URL mà người dùng được chuyển hướng đến khi chọn quảng cáo.

Thuộc tính Hình ảnh Quảng cáo

Đặc điểm	Nội dung mô tả
alternate_text	Trả về văn bản xuất hiện trong thuộc tính alt của thẻ.
chiều cao	Trả về chiều cao bằng pixel cho hình ảnh
url	Trả về nguồn URL cho hình ảnh.
width	Trả về chiều rộng bằng pixel cho hình ảnh

blog

Cho phép truy xuất và hiển thị Blog và Bài đăng trên Blog.

Đối tượng blogs cho phép bạn chọn một blog cụ thể hoặc bài đăng trên blog.

{% assign posts = blogs.posts | paginate: 0,4 %}

<div class=content-panel panel panel-default>

<div class=panel-heading>

{% assign sitemarker = sitemarkers["Blog Home"] %}

{% assign snippet = snippets[Home Blog Activity Heading] %}

<a class=pull-right href={{sitemarker.url}}> All Blogs </a>

<h4>

<a class=feed-icon fa fa-rss-square href={{ blogs.feedpath }} />

{{ snippet.adx_value }}

</h4>

</div>

<ul class=list-group>

{% for post in posts.all %}

<li class=list-group-item >

<a class=user-avatar href={{ post.author_url }}>

<img src={{ post.user_image_url }} />

</a>

<h4 class=list-group-item-heading>

<a href={{ post.app_relative_path }}>{{ post.title }}</a>

</h4>

<div class=content-metadata>

<abbr class=timeago>{{ post.publish_date }}</abbr>

&ndash;

<a href={{ post.author_url }}> {{ post.author_name }} </a>

&ndash;

<a href={{ post.application_path }}#comments>

<span class=fa fa-comment aria-hidden=true></span> {{ post.comment_count }}

</a>

</div>

</li>

{% endfor %}

</ul>

</div>

Đối tượng blogs

Đối tượng blogs cho phép bạn truy cập bất kỳ blog cụ thể nào trong cổng thông tin hoặc truy cập mọi bài đăng trên blog trong cổng thông tin.

Bảng dưới đây giải thích các thuộc tính được liên kết với đối tượng blogs.

Thuộc tính	Mô tả
bài đăng	Trả về đối tượng blogposts chứa tất cả bài đăng trên blog trong cổng thông tin.
[id hoặc tên blog]	Bạn có thể truy cập bất kỳ blog nào theo thuộc tính Tên hoặc Id của blog đó.

{% assign blog = blogs["Blog Name"] %}                             

{% assign blog = blogs["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}  |

Đối tượng blog

Đối tượng blog cho phép bạn làm việc với một blog duy nhất, từ đó cho phép bạn truy cập bài đăng cho blog đó.

Bảng dưới đây giải thích các thuộc tính khác nhau được liên kết với Đối tượng blog.

Thuộc tính	Mô tả
bài đăng	Trả về đối tượng blogposts chứa tất cả bài đăng trên blog cho blog đó.
Tên	Tên blog.
tiêu đề	Tiêu đề blog.
url	URL của blog.

Đối tượng blogposts

Đối tượng blogposts cho phép bạn truy cập tập hợp các đối tượng bài đăng trên blog. Ngoài việc sử dụng bộ lọc liquid, bạn có thể sắp xếp bài đăng trên blog và thực hiện dàn trang:

{% assign blogposts = blogs.posts | order\_by “adx\_name”, “desc” | paginate: 0,4 | all %}

Các tùy chọn khả thi khác:

• blogs.posts.all (để lấy tất cả các bài đăng trên blog)
• blogs.posts | from\_index: 0 | take: 2

Bảng dưới đây giải thích các thuộc tính khác nhau được liên kết với Đối tượng blogposts.

Thuộc tính	Mô tả
Tất cả	Trả về tất cả các đối tượng blogpost trong tập hợp

Đối tượng blogpost

Đề cập đến một bài đăng duy nhất trên blog.

Bảng dưới đây giải thích các thuộc tính khác nhau được liên kết với Đối tượng blogpost.

Thuộc tính	Mô tả
URL	URL của bài đăng.
nội dung	Trả về trường Nội dung cho bài đăng.
tác giả	Trả về tác giả cho bài đăng (đơn giản chỉ là đối tượng bảng người liên hệ.
tiêu đề	Tiêu đề của bài đăng.
comment_count	Trả về giá trị số nguyên của số nhận xét cho bài đăng đã cho.
publish_date	Ngày đã xuất bản bài đăng.

thực thể

Thận trọng

Để tránh các vấn đề tiềm ẩn với tập lệnh trên nhiều trang (XSS), hãy luôn sử dụng bộ lọc thoát để mã hóa HTML dữ liệu chuỗi bất cứ khi nào sử dụng thực thể đối tượng Liquid để đọc dữ liệu do người dùng không tin cậy cung cấp.

Lưu ý

Một số quy ước đặt tên của Dataverse đã thay đổi, ví dụ: các thực thể Dataverse giờ được gọi là bảng. Việc thay đổi tên không áp dụng cho các đối tượng Liquid. Đối tượng thực thể Liquid sẽ tiếp tục được gọi là thực thể.

Cho phép bạn tải bảng Dataverse bất kỳ theo ID. Nếu bảng tồn tại, một đối tượng bảng sẽ được trả về. Nếu không tìm thấy bảng có ID đã cho thì sẽ trả về null .

{% assign account = entities.account['936DA01F-9ABD-4d9d-80C7-02AF85C822A8'] %}

{% if account %}

{{ account.name | escape }} ({{ account.statecode.label | escape }})

{% endif %}

{% assign entity_logical_name = 'contact' %}

{% assign contact = entities[entity_logical_name][request.params.contactid] %}

{% if contact %}

{{ contact.fullname | escape }} ({{ contact.parentcustomerid.name | escape }})

{% endif %}

Thực thể

Đối tượng thực thể cung cấp quyền truy cập vào các thuộc tính của bản ghi bảng. Dataverse

Thuộc tính	Mô tả
ID	ID GUID của bảng dưới dạng chuỗi. Ví dụ: 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name	Tên lô-gic Dataverse của bảng.
Ghi chú	Tải bất kỳ ghi chú (chú thích) nào liên quan đến bảng, được sắp xếp từ cũ nhất đến mới nhất (createdon). Ghi chú được trả về dưới dạng đối tượng ghi chú.
quyền	Tải kết quả xác nhận Quyền đối với bảng cho bảng. Kết quả được trả về dưới dạng đối tượng quyền.
URL	Trả về đường dẫn URL của hệ thống quản lý nội dung Power Pages cho bảng. Nếu bảng không có URL hợp lệ trong trang web hiện tại thì trả về null. Nhìn chung, điều này chỉ trả về giá trị cho một số loại bảng nhất định đã được tích hợp vào CMS cổng thông tin, trừ khi bạn đã tùy chỉnh Nhà cung cấp URL trong ứng dụng của mình.
[tên mối quan hệ hoặc thuộc tính]	Bạn có thể truy nhập bất kỳ thuộc tính nào của bảng Dataverse theo tên lô-gic. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }} Giá trị của hầu hết thuộc tính bảng sẽ ánh xạ trực tiếp với các loại Liquid: trường Hai tùy chọn sẽ ánh xạ với Boolean, trường văn bản với chuỗi, trường số/loại tiền với số, trường ngày/giờ với đối tượng ngày. Tuy nhiên, một số loại thuộc tính được trả về dưới dạng đối tượng: Các trường Tra cứu (Tham chiếu bảng được liên kết) được trả về dưới dạng đối tượng tham chiếu bảng được liên kết. Trường Bộ Tùy chọn/Danh sách chọn được trả về dưới dạng đối tượng giá trị bộ tùy chọn. Bạn cũng có thể tải bất kỳ thực thể nào có liên quan theo tên sơ đồ mối quan hệ. {{ page.adx_webpage_entitylist.adx_name }}Trong trường hợp mối quan hệ có tính phản xạ (tức là tự tham chiếu), một đối tượng mối quan hệ có tính phản xạ sẽ được trả về. (Nếu không, kết quả mong muốn sẽ là mơ hồ.){{ page.adx_webpage_webpage.referencing.adx_name }} Lưu ý: Việc tải số lượng lớn các thực thể liên quan hoặc truy cập số lượng lớn các mối quan hệ trong một mẫu duy nhất có thể ảnh hưởng tiêu cực đến hiệu suất hiển thị mẫu. Tránh tải các thực thể có liên quan cho từng mục trong mảng, trong vòng lặp. Nếu có thể, hãy sử dụng thẻ bảng Dataverse để tải tập hợp thực thể.

Thông tin tham chiếu của bảng được liên kết

Giá trị thuộc tính tra cứu được trả về dưới dạng đối tượng tham chiếu bảng được liên kết, với các thuộc tính sau.

Thuộc tính	Mô tả
ID	ID GUID của bảng được tham chiếu, dưới dạng chuỗi. Ví dụ: 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name	Tên lô-gic Dataverse của bảng được tham chiếu.
Tên	Thuộc tính tên chính của bảng được tham chiếu.

Ghi chú

Ghi chú là một đối tượng bảng cung cấp quyền truy nhập vào các thuộc tính và mối quan hệ của bản ghi chú thích. Ngoài tất cả các thuộc tính của một đối tượng bảng, ghi chú còn có các thuộc tính bổ sung sau.

Đặc điểm	Description
documentbody	Tải thuộc tính documentbody của bản ghi chú thích ghi chú, dưới dạng chuỗi được mã hóa Base64. Vì nội dung của thuộc tính này có thể lớn nên nó không được tải cùng với các thuộc tính ghi chú còn lại mà chỉ được tải khi có yêu cầu. Lưu ý: Việc sử dụng thuộc tính documentbody có thể ảnh hưởng tiêu cực đến hiệu suất hiển thị mẫu và cần phải thận trọng. Thay vào đó, hãy sử dụng thuộc tính url để cung cấp liên kết cho các tệp đính kèm ghi chú nếu có thể.
url	Trả về đường dẫn URL cho trình xử lý tệp đính kèm chú thích cổng thông tin được tích hợp. Nếu người dùng có quyền và ghi chú có tệp đính kèm, yêu cầu gửi tới URL này sẽ tải xuống tệp đính kèm ghi chú.

Lưu ý

Bộ lọc bổ sung

Giá trị Bộ Tùy chọn

Thuộc tính Bộ tùy chọn/Danh sách chọn được trả về dưới dạng đối tượng tham chiếu bảng được liên kết, với các thuộc tính sau.

Thuộc tính	Mô tả
Nhãn	Nhãn đã bản địa hóa của giá trị thuộc tính bộ tùy chọn/danh sách chọn. Ví dụ: Hiện hoạt
Giá trị	Giá trị số nguyên của giá trị thuộc tính bộ tùy chọn/danh sách chọn. Ví dụ: 0

Quyền đối với bảng

Đối tượng Quyền đối với bảng cung cấp quyền truy nhập vào các kết quả xác nhận quyền được tổng hợp cho bảng.

Đặc điểm	Nội dung mô tả
can_append	Trả về true nếu người dùng hiện tại có quyền gắn thêm bản ghi vào mối quan hệ của bản ghi này. Nếu không, trả về false.
can_append_to	Trả về true nếu người dùng hiện tại có quyền gắn thêm bản ghi này vào mối quan hệ của bảng khác. Nếu không, trả về false.
can_create	Trả về true nếu người dùng hiện tại có quyền tạo bản ghi mới cho loại bảng này. Nếu không, trả về false.
can_delete	Trả về true nếu người dùng hiện tại có quyền xóa bản ghi này. Nếu không, trả về false.
can_read	Trả về true nếu người dùng hiện tại có quyền đọc bản ghi này. Nếu không, trả về false.
can_write	Trả về true nếu người dùng hiện tại có quyền cập nhật bản ghi này. Nếu không, trả về false.
rules_exist	Trả về true nếu kết quả quyền được biểu thị theo đối tượng này là kết quả của quy tắc quyền được xác định rõ ràng. Trả về false nếu chúng là kết quả mặc định khi không có quyền được xác định rõ ràng.

Mối quan hệ Linh hoạt

Cố gắng tải mối quan hệ linh hoạt (tức là tự tham chiếu) trên thực thể được trả về dưới dạng đối tượng có các thuộc tính sau.

Đặc điểm	Nội dung mô tả
is_reflexive	Trả về true. Có thể được sử dụng để kiểm tra xem đối tượng được trả về theo mối quan hệ có phải là đối tượng mối quan hệ linh hoạt hay không.
được tham chiếu	Trả về một loạt thực thể được tham chiếu cho mối quan hệ nhất định.
đang tham chiếu	Trả về bảng tham chiếu cho mối quan hệ đã cho. Trả về null nếu không tồn tại bảng tham chiếu nào. Nếu mối quan hệ là nhiều-nhiều (N:N) thì sẽ trả về một loạt thực thể tham chiếu.

entitylist

Đối tượng danh sách thực thể được sử dụng trong thẻ bảng Dataverse. Đối tượng này cung cấp quyền truy nhập vào tất cả các thuộc tính của danh sách đã cho.

Lưu ý

Hiển thị danh sách liên quan đến trang hiện tại

Thuộc tính

Lưu ý

các thực thể

Đặc điểm	Nội dung mô tả
create_enabled	Trả về true nếu việc tạo bản ghi mới được đặt cấu hình cho danh sách. Nếu không, trả về false.
create_url	Trả về đường dẫn URL được đặt cấu hình cho liên kết/nút tạo cho danh sách.
detail_enabled	Trả về true nếu dạng xem chi tiết cho bản ghi riêng lẻ được đặt cấu hình cho danh sách. Nếu không, trả về false.
detail_id_parameter	Trả lại tên tham số chuỗi truy vấn để sử dụng cho ID bản ghi khi xây dựng URL dạng xem chi tiết bản ghi. Xem bộ lọc URL để biết chi tiết về cách sử dụng bộ lọc Liquid để xây dựng URL. Ví dụ: id
detail_label	Trả về nhãn bản địa hóa được đặt cấu hình cho liên kết/nút dạng xem chi tiết cho danh sách.
detail_url	Trả về đường dẫn URL được đặt cấu hình cho liên kết/nút dạng xem chi tiết cho danh sách.
empty_list_text	Trả về văn bản bản địa hóa được đặt cấu hình hiển thị khi dạng xem danh sách không trả về kết quả nào.
enable_entity_permissions	Trả về true nếu tính năng lọc Quyền đối với bảng được kích hoạt cho danh sách này. Nếu không, trả về false.
entity_logical_name	Trả về tên lô-gic bảng Dataverse cho các bản ghi sẽ được danh sách này hiển thị. Ví dụ: người liên hệ
filter_account_attribute_name	Trả về tên logic của thuộc tính để tra cứu tới tài khoản được sử dụng để lọc các bản ghi kết quả theo tài khoản cha của người dùng cổng thông tin hiện tại. Ví dụ: accountid
filter_apply_label	Trả về nhãn bản địa hóa được đặt cấu hình sử dụng cho liên kết/nút áp dụng bộ lọc thuộc tính nâng cao cho kết quả danh sách.
filter_definition	Trả về định nghĩa bộ lọc thuộc tính JSON cho danh sách. Hãy xem thông tin chi tiết về cách sử dụng bộ lọc Liquid metafilters để xử lý định nghĩa này trong bộ lọc Danh sách.
filter_enabled	Trả về true nếu tính năng lọc thuộc tính nâng cao được kích hoạt cho danh sách này. Nếu không, trả về false.
filter_portal_user_attribute_name	Trả về tên logic của thuộc tính để tra cứu tới liên hệ được sử dụng để lọc bản ghi kết quả theo liên hệ của người dùng cổng thông tin hiện tại. Ví dụ: contactid
filter_website_attribute_name	Trả về tên logic của thuộc tính để tra cứu tới adx_website được sử dụng để lọc các bản ghi kết quả theo trang web cổng thông tin hiện tại. Ví dụ: adx_websiteid
language_code	Trả về mã ngôn ngữ số nguyên Dataverse sẽ được sử dụng để chọn tất cả các nhãn đã bản địa hóa cho danh sách này.
page_size	Trả về kích cỡ trang kết quả được đặt cấu hình cho danh sách.
primary_key_name	Trả về tên lô-gic của thuộc tính khóa chính cho các bản ghi sẽ được danh sách này hiển thị.
search_enabled	Trả về true nếu chức năng tìm kiếm được kích hoạt cho danh sách này. Nếu không, trả về false.
search_placeholder	Trả về văn bản bản địa hóa được đặt cấu hình cho phần giữ chỗ trường tìm kiếm danh sách.
search_tooltip	Trả về văn bản bản địa hóa được đặt cấu hình cho chú giải công cụ tìm kiếm danh sách.
dạng xem	Trả về dạng xem có sẵn cho danh sách, dưới dạng đối tượng dạng xem danh sách.
[tên thuộc tính logic]	Bạn có thể truy nhập mọi thuộc tính của bản ghi Dataverse danh sách (adx_entitylist) theo tên lô-gic, theo cách tương tự như đối tượng bảng. Ví dụ: {{ entitylist.adx_name }}

Thuộc tính dạng xem danh sách

Đặc điểm	Nội dung mô tả
các cột	Trả về các cột trong dạng xem dưới dạng đối tượng cột dạng xem danh sách.
entity_logical_name	Trả về tên lô-gic của bảng Dataverse cho bản ghi có trong dạng xem. Ví dụ: người liên hệ
ID	Trả về ID GUID của dạng xem.
language_code	Trả về mã ngôn ngữ số nguyên được sử dụng để chọn tất cả các nhãn bản địa hóa (tiêu đề cột, v.v.) cho chế độ xem. Dataverse
Tên	Trả về tên hiển thị Dataverse của dạng xem.
primary_key_logical_name	Trả về tên lô-gic khóa chính của bảng Dataverse cho bản ghi có trong dạng xem. Ví dụ: contactid
sort_expression	Trả về cụm từ phân loại mặc định cho dạng xem. Ví dụ: nameASC, createdon DESC

Thuộc tính cột dạng xem danh sách

Đặc điểm	Nội dung mô tả
attribute_type	Trả về tên loại thuộc tính Dataverse cho cột, dưới dạng chuỗi. Ví dụ: Tra cứu, Danh sách chọn, Chuỗi, Boolean, DateTime
logical_name	Trả về tên lô-gic của thuộc tính Dataverse cho cột. Ví dụ: createdon
Tên	Trả về tên hiển thị Dataverse được bản địa hóa cho cột. Ví dụ: Ngày tạo
sort_ascending	Trả về một chuỗi biểu thức sắp xếp để sắp xếp các cột theo thứ tự tăng dần. Ví dụ: createdon ASC
sort_descending	Trả về một chuỗi biểu thức sắp xếp để sắp xếp các cột theo thứ tự giảm dần. Ví dụ: createdon DESC
sort_disabled	Trả về true nếu đã vô hiệu hóa tính năng sắp xếp cho cột. Nếu không, trả về false.
sort_enabled	Trả về true nếu đã kích hoạt tính năng sắp xếp cho cột. Nếu không, trả về false.
chiều rộng	Trả về chiều rộng được cấu hình cho cột, bằng pixel.

entityview

Đối tượng entityview được sử dụng trong thẻ entityview và cung cấp quyền truy cập vào siêu dữ liệu cho dạng xem, bên cạnh việc xem bản ghi kết quả.

Thuộc tính

Thuộc tính	Mô tả
các cột	Trả về các cột trong dạng xem, dưới dạng đối tượng cột dạng xem bảng.
entity_permission_denied	Trả về true nếu quyền truy nhập để xem kết quả bị từ chối do không đủ Quyền đối với bảng cho người dùng hiện tại. Trả về false nếu quyền truy cập đọc để xem các kết quả đã được cấp.
entity_logical_name	Tên lô-gic của bảng Dataverse của bản ghi kết quả dạng xem. Ví dụ: người liên hệ
first_page	Số trang của trang đầu tiên của kết quả dạng xem. Giá trị này là 1 trừ khi không có kết quả nào được trả về, trong trường hợp đó giá trị sẽ là null.
ID	ID GUID của dạng xem Dataverse xác định entityview này.
language_code	Mã ngôn ngữ số nguyên Dataverse được sử dụng để tải các nhãn được bản địa hóa cho dạng xem hiện tại.
last_page	Số trang của trang cuối cùng của kết quả dạng xem. Nếu không có kết quả nào được trả về, giá trị này là null.
tên	Tên của dạng xem Dataverse sẽ xác định entityview này, ví dụ: Người liên hệ Hiện hoạt.
next_page	Số trang của trang tiếp theo của kết quả dạng xem. Nếu không có trang kết quả tiếp theo, giá trị này là null.
Trang	Số trang của trang hiện tại của kết quả dạng xem.
trang	Trả về một mảng các số trang có chứa tất cả các trang kết quả cho dạng xem hiện tại.
page_size	Số lượng kết quả được trả về mỗi trang cho dạng xem hiện tại.
previous_page	Số trang của trang tiếp theo của kết quả dạng xem. Nếu không có trang kết quả trước đó thì trang này sẽ trống.
primary_key_logical_name	Tên lô-gic Dataverse của thuộc tính khóa chính của bảng kết quả cho dạng xem này. Ví dụ: contactid.
bản ghi	Trang hiện tại của bản ghi kết quả cho dạng xem, dưới dạng đối tượng bảng.
sort_expression	Cụm từ phân loại mặc định cho dạng xem. Ví dụ: nameASC, createdon DESC.
total_pages	Tổng số trang của trang kết quả cho dạng xem.
total_records	Tổng số kết quả cho dạng xem (trên tất cả các trang).

sự kiện

Cho phép truy xuất và hiển thị các sự kiện. Đối tượng sự kiện cho phép bạn chọn một sự kiện cụ thể hoặc tất cả sự kiện.

Đối tượng sự kiện

Đối tượng sự kiện cho phép bạn truy cập bất kỳ sự kiện cụ thể nào trong cổng thông tin hoặc truy cập tất cả sự kiện trong cổng thông tin (bất kể sự kiện đó là gì).

Đối tượng sự kiện có các thuộc tính sau đây:

Đặc điểm	Description
lần xảy ra	Trả về eventoccurancessobject có chứa tất cả số lần xuất hiện sự kiện trong cổng thông tin
[id hoặc tên sự kiện]	Bạn có thể truy cập sự kiện bất kỳ theo thuộc tính Id hoặc Tên của sự kiện đó. {% assign event = events["Event Name"] %} {% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Đối tượng sự kiện

Đối tượng sự kiện cho phép bạn làm việc với một sự kiện, qua đó giúp bạn truy cập lịch trình và số lần xuất hiện cho sự kiện đó.

Đối tượng sự kiện có các thuộc tính sau:

Thuộc tính	Nội dung mô tả
lần xảy ra	Trả về eventoccurrencesobject có chứa tất cả số lần xuất hiện cho sự kiện.
tên	Tên của sự kiện.
url	URL của sự kiện.

Đối tượng eventoccurences

Đối tượng eventoccurrences cho phép bạn truy cập tập hợp đối tượng lần xuất hiện sự kiện. Bạn có thể sắp xếp các sự kiện xảy ra và chỉ định phạm vi ngày để truy xuất các sự kiện đó, cũng như thực hiện phân trang bằng cách sử dụng bộ lọc chất lỏng:

{% assign occurances = event.occurrences.from[today].to[advance_date] %}

Ngoài ra còn có thể thực hiện tùy chọn sau:

{% assign occurances = event.occurrences.min[today].max[advance_date] %}

Các thuộc tính sau được liên kết với đối tượng eventoccurrences

Thuộc tính	Mô tả
Tất cả	Trả về tất cả các đối tượng eventoccurance trong tập hợp.

Đối tượng eventoccurence

Biểu thị lần xuất hiện sự kiện duy nhất. Sau đây là các thuộc tính liên quan:

Đặc điểm	Description
URL	URL của lần xuất hiện.
is_all_day_event	Đây có phải là sự kiện cả ngày không?
start_time	Giờ bắt đầu cho sự kiện.
end_time	Giờ kết thúc cho sự kiện.

forloop

Bao gồm các thuộc tính hữu ích trong khối vòng for.

Lưu ý

chỉ có thể sử dụng forloop trong thẻ for.

Mã số

{% for child in page.children %}

{% if forloop.first %}

This is the first child page!

{% else %}

This is child page number {{ forloop.index }}.

{% endif %}

{% endfor %}

Đầu ra

This is the first child page!

This is child page number 2.

This is child page number 3.

Thuộc tính

Thuộc tính	Mô tả
đầu tiên	Trả về true nếu đó là lần lặp đầu tiên của vòng lặp. Trả về false nếu đó không phải là lần lặp đầu tiên.
chỉ mục	Vi trí của mục hiện tại trong tập hợp, nơi mục đầu tiên có vị trí 1.
index0	Vi trí của mục hiện tại trong tập hợp, nơi mục đầu tiên có vị trí 0.
Cuối cùng	Trả về true nếu đó là lần lặp cuối cùng của vòng lặp. Trả về false nếu đó không phải là lần lặp cuối cùng.
độ dài	Trả về số lần lặp cho vòng lặp ߝ số mục trong tập hợp được lặp lại.
rindex	Số mục còn lại trong vòng lặp (độ dài - chỉ mục) trong đó 1 là chỉ mục của mục cuối cùng.
rindex0	Số mục còn lại trong vòng lặp (độ dài - chỉ mục) trong đó 0 là chỉ mục của mục cuối cùng.

diễn đàn

Cho phép truy xuất và hiển thị Diễn đàn và Chủ đề diễn đàn. Khả năng sử dụng liquid để kết xuất dữ liệu diễn đàn mở rộng ra các bài đăng, nhưng để tạo bài đăng hoặc chuỗi chủ đề mới, bạn phải sử dụng Mẫu trang của biểu mẫu nhiều bước ASP.NET có tích hợp chức năng đã nêu (như Chuỗi chủ đề diễn đàn và Mẫu trang bài đăng diễn đàn mặc định).

Đối tượng diễn đàn cho phép bạn chọn Diễn đàn hoặc Chuỗi chủ đề Diễn đàn:

<div class=content-panel panel panel-default>

<div class=panel-heading>

<h4>

<span class=fa fa-comments aria-hidden=true></span>

{{ snippets[Home Forum Activity Heading] | default: Forum Activity | h }}

</h4>

</div>

{% for forum in website.forums %}

<ul class=list-group>

<li class=list-group-item>

<div class=row>

<div class=col-sm-6>

<h4 class=list-group-item-heading><a href="{{ forum.url | h }}"> {{ forum.name | h }}</a></h4>

<div class=list-group-item-text content-metadata>{{ forum.adx_description | h }}</div>

</div>

<div class=col-sm-3 content-metadata>{{ forum.thread_count }} threads</div>

<div class=col-sm-3 content-metadata>{{ forum.post_count }} posts</div>

</div>

</li>

</ul>

{% endfor %}

</div>

Đối tượng diễn đàn

Đối tượng diễn đàn cho phép bạn truy cập vào bất kỳ diễn đàn cụ thể nào trong cổng thông tin hoặc truy cập vào mọi chuỗi chủ đề diễn đàn trong cổng thông tin (bất kể diễn đàn có là gì).

Đối tượng diễn đàn cho phép bạn làm việc với một diễn đàn duy nhất, qua đó giúp bạn truy cập chuỗi chủ đề cho diễn đàn đó.

Đối tượng forumthreads cho phép bạn truy cập tập hợp các đối tượng forumthread. Bạn có thể sắp xếp chuỗi chủ đề diễn đàn cũng như thực hiện dàn trang bằng bộ lọc liquid.

{% assign threads = forum.threads | order_by adx_name, desc | paginate: 0,4 | all %}

Chuỗi chủ đề Diễn đàn Duy nhất

Đối tượng forumposts cho phép bạn truy cập tập hợp các đối tượng forumpost.

Thuộc tính

Thuộc tính	Mô tả
chuỗi chủ đề	Trả về đối tượng forumthreads có chứa tất cả đối tượng forumthread trong cổng thông tin.
Tất cả	Trả về tất cả các đối tượng diễn đàn trong cổng thông tin. Lưu ý rằng website.forums cũng là đối tượng tương đương.
thread_count	Trả về giá trị số nguyên của số lượng chuỗi chủ đề trong toàn bộ trang web.
post_count	Trả về giá trị số nguyên của tổng số lượng bài đăng trong cổng thông tin.
[id hoặc tên diễn đàn]	Bạn có thể truy cập diễn đàn bất kỳ theo thuộc tính Id hoặc Tên của diễn đàn đó. `{% assign forum = forums[Forum Name] %} {% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %}

Đối tượng diễn đàn

Thuộc tính

Lưu ý

các thực thể

Đặc điểm	Nội dung mô tả
chuỗi chủ đề	Trả về đối tượng forumthreads có chứa tất cả các chuỗi chủ đề diễn đàn cho diễn đàn.
Tên	Tên của Diễn đàn.
thread_count	Trả về giá trị số nguyên của số lượng chuỗi chủ đề trong diễn đàn.
post_count	Trả về giá trị số nguyên của số lượng bài đăng trong toàn bộ diễn đàn.

Đối tượng forumthreads

Thuộc tính

Thuộc tính	Mô tả
Tất cả	Trả về tất cả các đối tượng forumthread trong tập hợp.

Đối tượng forumthread

Thuộc tính

Lưu ý

các thực thể

Đặc điểm	Nội dung mô tả
bài đăng	Trả về đối tượng forumposts có chứa tất cả các bài đăng diễn đàn cho chuỗi chủ đề.
tác giả	Trả về tác giả cho chuỗi chủ đề (đơn giản chỉ là đối tượng bảng người liên hệ).
latest_post	Trả về bài đăng mới nhất trong chuỗi chủ đề.
first_post	Trả về bài đăng đầu tiên trong chuỗi chủ đề.
post_count	Trả về giá trị số nguyên của số lượng bài đăng trong chuỗi chủ đề.
is_answered	Chuỗi chủ đề có được trả lời hay không?
is_sticky	Chuỗi chủ đề có cố định hay không?

Đối tượng forumposts

Thuộc tính

Thuộc tính	Mô tả
Tất cả	Trả về tất cả các đối tượng forumthread trong tập hợp.

Bài đăng Diễn đàn Duy nhất

Thuộc tính

Lưu ý

các thực thể

Đặc điểm	Nội dung mô tả
tác giả	Trả về tác giả cho bài đăng (đơn giản chỉ là đối tượng bảng người liên hệ).
nội dung	Nội dung của bài đăng.
is_answer	Bài đăng này có trả lời cho chuỗi chủ đề không?

kiến thức

Cung cấp quyền truy nhập vào bản ghi bảng danh mục và knowledgearticle Dataverse để kết xuất danh mục và bài viết trong cổng thông tin.

Thuộc tính

Thuộc tính	Mô tả
bài viết	Trả về đối tượng articles có chứa đối tượng bài viết cho các bản ghi bảng knowledgearticle có sẵn trong cổng thông tin.
phần thưởng	Trả về đối tượng categories có chứa đối tượng danh mục cho các bản ghi bảng danh mục có sẵn trong cổng thông tin.

đối tượng articles

Đối tượng articles cho phép bạn truy cập vào tập hợp các đối tượng bài viết. Bạn có thể sắp xếp bài viết cũng như thực hiện dàn trang bằng bộ lọc liquid.

{% assign count = count | default: 3 %}
{% assign languagecode = website.selected_language.code %}
{% assign popular_articles = knowledge.articles | popular: count,languagecode  %}
{% if popular_articles %}
    <div class=list-group>
    {% for article in popular_articles %}
      <div class=list-group-item clearfix>
        <a class=title href={{ article.url | escape }}>{{ article.title | escape }}</a>
        <p class=description>{{ article.description | escape }}</p>
      </div>
    {% endfor %}
    </div>
{% endif %}

Thuộc tính

Thuộc tính	Mô tả
phổ biến	Trả về tập hợp các đối tượng bài viết có chứa dạng xem phổ biến nhất. {% assign popular_articles = knowledge.articles.popular %}
gần đây	Trả về tập hợp các đối tượng bài viết có chứa ngày sửa đổi mới nhất. {% assign recent_articles = knowledge.articles.recent %}
hàng đầu	Trả về tập hợp các đối tượng bài viết có chứa xếp hạng cao nhất. {% assign top_articles = knowledge.articles.top %}

Bộ lọc

Các bộ lọc sau có thể chấp nhận tham số tùy chọn cho ngôn ngữ và kích thước trang. Tham số đầu tiên là số lượng bản ghi cần truy xuất. Kích thước trang mặc định là 5. Tham số thứ hai là mã ngôn ngữ để truy xuất bài viết cho một ngôn ngữ nhất định. Bộ lọc có thể kết hợp với các bộ lọc chất lỏng khác. ...

{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}

Đặc điểm	Description
phổ biến	Trả về tập hợp các đối tượng bài viết có chứa dạng xem phổ biến nhất. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %}
gần đây	Trả về tập hợp các đối tượng bài viết có chứa ngày sửa đổi mới nhất. {% assign recent_articles = knowledge.articles \| recent: 5 %}
hàng đầu	Trả về tập hợp các đối tượng bài viết có chứa xếp hạng cao nhất. {% assign top_articles = knowledge.articles \| top: 3, en-US %}

đối tượng categories

Đối tượng categories cho phép bạn truy cập tập hợp các đối tượng danh mục. Bạn có thể sắp xếp danh mục cũng như thực hiện dàn trang bằng bộ lọc liquid.

{% assign category_url = sitemarkers['Category'].url %}
  {% assign count = count | default: 0 %}  
  {% assign categories = knowledge.categories | top_level: count %}
  {% if categories %}
    <div class=list-group unstyled>
    {% for category in categories %}
      <a href={{ category_url | add_query: 'id', category.categorynumber }} class=list-group-item>
        {{ category.title }}
      </a>
    {% endfor %}
    </div>
  {% endif %}

Thuộc tính

Thuộc tính	Mô tả
gần đây	Trả về tập hợp các đối tượng danh mục có chứa ngày sửa đổi mới nhất.
top_level	Trả về tập hợp các đối tượng danh mục không có danh mục mẹ.

Bộ lọc

Các bộ lọc sau có thể chấp nhận tham số tùy chọn thể hiện kích thước trang. Kích thước trang mặc định là 5. Bộ lọc có thể kết hợp với các bộ lọc chất lỏng khác. ...

{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}

Đặc điểm	Description
gần đây	Trả về tập hợp các đối tượng danh mục có chứa ngày sửa đổi mới nhất. Bạn có thể cung cấp các tham số {% assign recent_categories = knowledge.categories \| recent: 10 %}
top_level	Trả về tập hợp các đối tượng danh mục không có danh mục mẹ. {% assign root_categories = knowledge.categories \| top_level %}

Đối tượng bài viết

Đối tượng bài viết cho phép bạn làm việc với knowledgearticle duy nhất để hiển thị chi tiết về bài viết đó trong cổng thông tin.

Thuộc tính

Bài viết là một thực thể đối tượng, có tất cả các thuộc tính giống nhau, ngoài các thuộc tính sau:

Đặc điểm	Description
article_public_number	Số hiệu Bài viết Hiện hoạt của bài viết.
comment_count	Giá trị số nguyên biểu thị số lượng bình luận cho một bài viết nhất định.
nội dung	Nội dung của bài viết.
current_user_can_comment	Trả về giá trị Boolean để cho biết người dùng hiện tại có thể thêm nhận xét về bài viết hay không.
is_rating_enabled	Trả về giá trị boolean để cho biết xếp hạng trên bài viết đã được bật hay chưa.
từ khóa	Từ khóa cho bài viết.
tên	Bí danh thay thế cho tiêu đề của bài viết.
xếp hạng	Giá trị xếp hạng thập phân cho bài viết.
tiêu đề	Tiêu đề của bài viết.
view_count	Giá trị số nguyên biểu thị số lần bài viết được xem.

Đối tượng danh mục

Đối tượng danh mục cho phép bạn làm việc với một danh mục duy nhất để hiển thị chi tiết về danh mục đó trong cổng thông tin.

Thuộc tính

Thể loại là một thực thể đối tượng, có tất cả các thuộc tính giống nhau, ngoài các thuộc tính sau:

Đặc điểm	Description
categorynumber	Số Danh mục của danh mục.
tên	Bí danh thay thế cho tiêu đề của danh mục.
tiêu đề	Tiêu đề của danh mục.

ngôn_ngữ

Cung cấp tên ngôn ngữ hiện tại và mã ngôn ngữ nếu tùy chọn hỗ trợ nhiều ngôn ngữ được bật.

Thuộc tính

Thuộc tính	Nội dung mô tả
URL	URL yêu cầu hiện tại có tiền tố là mã ngôn ngữ hiện tại.
url_substitution	URL yêu cầu hiện tại được bắt đầu bằng mã ngôn ngữ hiện tại bỏ qua bộ đệm đầu ra trang.
tên	Tiêu đề của ngôn ngữ hiện tại.
code	Mã ngôn ngữ của ngôn ngữ.

Ví dụ: mẫu web Menu thả xuống theo mặc định sử dụng đối tượng liquid này để liệt kê các ngôn ngữ hiện có khi có nhiều ngôn ngữ.

Nhật ký

Người tạo có khả năng kết hợp các câu lệnh nhật ký vào mã Liquid của họ. Khi trang Power pages đang chạy, các nhật ký do người tạo thêm vào mã Liquid sẽ được hiển thị trong Power Pages tiện ích mở rộng công cụ dành cho nhà phát triển. Các nhật ký này, được nhúng bởi nhà sản xuất, sẽ hiển thị trong tiện ích mở rộng công cụ dành cho nhà phát triển khi cài đặt chẩn đoán được bật.

Cú pháp sau có thể được sử dụng trong mã Liquid để ghi lại các thông báo tùy chỉnh:

{% log message:'Custom message' level:'Warning' %}

Thuộc tính nhật ký

Đặc điểm	Description
Nhật ký	Tên vật thể lỏng
thông báo	Một chuỗi đại diện cho bất kỳ thông báo tùy chỉnh nào để ghi nhật ký
mức độ	Ghi lại tin nhắn dưới dạng Thông tin, Cảnh báo hoặc Lỗi

Ví dụ:

{% log message: 'Log from Home page' %}

{% fetchxml query %}
<fetch version="1.0" mapping="logical" >
<entity name="contact">
<attribute name="fullname"/>
<attribute name="emailaddress1"/>
</entity>
</fetch>
{% endfetchxml %}

{% assign contacts = query.results.entities %}

{% for contact in contacts %}
<div> Contact name: {{contact.fullname}} </div><br/>
{% capture msgg %} 
Contact email is {{contact.emailaddress1}} for name {{contact.fullname}}
{% endcapture %}
{% log message: msgg %}
{% endfor %}

trang

Tham chiếu đến trang yêu cầu cổng thông tin hiện tại. Đối tượng này kết hợp các thuộc tính của sơ đồ trang và yêu cầu hiện tại của thực thể (thường là trang web).

Đối tượng trang cung cấp quyền truy cập vào những nội dung như đường dẫn cho trang hiện tại, tiêu đề hoặc URL của trang hiện tại và bất kỳ thuộc tính nào khác hoặc các thực thể có liên quan của bản ghi Dataverse cơ sở.

<ul class=breadcrumb>

{% for crumb in page.breadcrumbs %}

<li><a href={{ crumb.url | escape }}>{{ crumb.title | escape }}</a></li>

{% endfor %}

<li class=active>{{ page.title | escape }}</li>

</ul>

<div class=page-header>

<h1>{{ page.title | escape }}</h1>

</div>

<div class=page-copy>

{{ page.adx_copy }}

</div>

<div class=list-group>

{% for child in page.children %}

<a class=list-group-item href={{ child.url | escape }}>

{{ child.title | escape }}

</a>

{% endfor %}

</div>

<!-- Page {{ page.id }} was last modified on {{ page.modifiedon }}. -->

Thuộc tính của trang

Lưu ý

các thực thể

Đặc điểm	Nội dung mô tả
đánh dấu đường dẫn	Trả về đối tượng nút sơ đồ trang web có đánh dấu đường dẫn cho trang, bắt đầu từ nút gốc sơ đồ trang web và kết thúc tại cha.
con	Trả về đối tượng nút sơ đồ trang web con của trang.
mẹ	Trả về nút sơ đồ trang web mẹ của trang. Nếu trang là Trang chủ, phần tử cha sẽ là null.
tiêu đề	Tiêu đề của trang.
URL	URL của trang.
[tên mối quan hệ hoặc thuộc tính]	Bạn có thể truy cập mọi thuộc tính của bản ghi Dataverse cơ sở của trang theo tên lô-gic. {{ page.createdon }} {% assign attribute_name = 'name' %} {{ page[attribute_name] }} Giá trị của hầu hết thuộc tính bảng sẽ ánh xạ trực tiếp với các loại Liquid: trường Hai tùy chọn sẽ ánh xạ với Boolean, trường văn bản với chuỗi, trường số/loại tiền với số, trường ngày/giờ với đối tượng ngày. Tuy nhiên, một số loại thuộc tính được trả về dưới dạng đối tượng: Các trường Tra cứu (Tham chiếu bảng được liên kết) được trả về dưới dạng đối tượng tham chiếu bảng được liên kết. Trường Bộ Tùy chọn/Danh sách chọn được trả về dưới dạng đối tượng giá trị bộ tùy chọn. Bạn cũng có thể tải bất kỳ thực thể nào có liên quan theo tên sơ đồ mối quan hệ. {{ page.adx_webpage_entitylist.adx_name }} Trong trường hợp mối quan hệ có tính phản xạ (tức là tự tham chiếu), thì đối tượng thực thể sẽ được trả về. (Nếu không, kết quả mong muốn sẽ là mơ hồ.){{ page.adx_webpage_webpage.referencing.adx_name }} Lưu ý: Việc tải số lượng lớn các thực thể liên quan hoặc truy cập số lượng lớn các mối quan hệ trong một mẫu duy nhất có thể ảnh hưởng tiêu cực đến hiệu suất hiển thị mẫu. Tránh tải các thực thể có liên quan cho từng mục trong mảng, trong vòng lặp. Nếu có thể, hãy ưu tiên sử dụng thẻ bảng Dataverse để tải tập hợp thực thể.

cuộc thăm dò

Cho phép truy xuất và hiển thị cuộc thăm dò.

Đối tượng cuộc thăm dò cho phép bạn chọn cuộc thăm dò hoặc vị trí cuộc thăm dò cụ thể:

<div>

{% assign poll = polls[Poll Name] %}

<h4>{{ poll.question }}</h4>

{% for option in poll.options %}

<div>

<input type=radio name={{ poll.name }} id={{ option.id }} />

<label for={{ option.id }}>{{ option.answer }}</label>

</div>

{% endfor %}

<button type=button>{{ poll.submit_button_label }}</button>

</div>

Thuộc tính của cuộc thăm dò

Thuộc tính	Nội dung mô tả
vị trí	Trả về đối tượng pollplacements.
[id hoặc tên cuộc thăm dò]	Bạn có thể truy cập bất kỳ cuộc thăm dò nào nào theo thuộc tính Tên hoặc Id của cuộc thăm dò. {% assign poll = polls[Poll Name] %} {% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %}

Thuộc tính Vị trí Cuộc thăm dò

Đặc điểm	Nội dung mô tả
[id hoặc tên vị trí cuộc thăm dò]	Bạn có thể truy cập mọi vị trí cuộc thăm dò theo thuộc tính Tên hoặc Id của cuộc thăm dò đó.{% assign placement = polls.placements[Placement Name or Id] %} {% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %}

Thuộc tính Vị trí Cuộc thăm dò

Lưu ý

các thực thể

Đặc điểm	Nội dung mô tả
Tên	Trả về trường Tên cho vị trí cuộc thăm dò.
placement_url	URL có thể được dùng để truy xuất vị trí cuộc thăm dò được kết xuất đầy đủ theo mẫu.
cuộc thăm dò	Trả về tập hợp các đối tượng cuộc thăm dò được liên kết với vị trí. Thẻ lặp và Bộ lọc mảng có thể được sử dụng với bộ sưu tập này.
random_url	URL có thể sử dụng để truy xuất cuộc thăm dò ngẫu nhiên từ vị trí quảng cáo được kết xuất đầy đủ theo mẫu.
submit_url	URL mà một cuộc thăm dò đã hoàn thành được gửi.

Thuộc tính Cuộc thăm dò

Lưu ý

các thực thể

Đặc điểm	Nội dung mô tả
has_user_voted	Trả về true nếu người dùng hiện tại (đã đăng nhập hoặc ẩn danh) đã bình chọn trong cuộc thăm dò này.
Tên	Trả về trường Tên cho cuộc thăm dò.
tùy chọn	Trả về tập hợp các đối tượng tùy chọn cuộc thăm dò được liên kết với cuộc thăm dò. Thẻ lặp và thực thể có thể được sử dụng với bộ sưu tập này.
poll_url	URL có thể được dùng để truy xuất cuộc thăm dò được kết xuất đầy đủ theo mẫu.
Câu hỏi	Trả về trường Câu hỏi cho cuộc thăm dò.
submit_button_label	Trả về một chuỗi có thể được sử dụng để ghi đè lên nhãn nút gửi cho cuộc thăm dò.
submit_url	URL mà một cuộc thăm dò đã hoàn thành được gửi.
user_selected_option	Trả về đối tượng polloption do người dùng chọn (nếu họ đã bỏ phiếu).
số lượng bình chọn	Trả về số phiếu bầu được lập bảng cho cuộc thăm dò.

Thuộc tính Tùy chọn Cuộc thăm dò

Lưu ý

các thực thể

Đặc điểm	Nội dung mô tả
câu trả lời	Trả về trường Câu trả lời cho cuộc thăm dò.
tỷ lệ phần trăm	Trả về tỷ lệ phần trăm số bình chọn trong cuộc thăm dò cho các tùy chọn dưới dạng số thập phân từ 0 đến 100.
số lượng bình chọn	Trả về số phiếu bầu được lập bảng cho tùy chọn.

yêu cầu

Chứa thông tin về yêu cầu HTTP hiện tại.

{% assign id = request.params['id'] | escape %}

<a href={{ request.url | add_query: 'foo', 1 | escape }}>Link</a>

Lưu ý

• Bạn có thể chủ động xây dựng URL trong Liquid bằng Bộ lọc URL.
• URL dùng trong request.url có thể là bất kỳ giá trị yêu cầu nào, và được lưu vào bộ đệm cho các yêu cầu sau đó. Để đảm bảo dùng đúng giá trị trong request.url, hãy cân nhắc sử dụng thẻ thay thế, URL bán phần như ~{đường dẫn WebFile path} hoặc lưu trữ URL cổng thông tin trong phần Cài đặt trang.
• Bản phát hành Power Pages phiên bản 9.3.8.x trở lên sẽ thực thi bộ lọc Liquid escape theo mặc định cho đối tượng Liquid người dùng và yêu cầu. Để tắt cấu hình mặc định này và cho phép các đối tượng Liquid này không thoát bộ lọc Liquid, hãy xem cài đặt trang web cổng thông tin - Site/EnableDefaultHtmlEncoding.

Thuộc tính

Thuộc tính	Mô tả
params	Các giá trị tham số được đặt tên cho yêu cầu hiện tại. params là tổ hợp các tham số của chuỗi truy vấn URL, tham số bài đăng biểu mẫu và cookie.
Đường dẫn	Đường dẫn của URL yêu cầu hiện tại. /profile/
path_and_query	Đường dẫn và truy vấn của URL yêu cầu hiện tại. /profile/?foo=1&bar=something
truy vấn	Phần truy vấn của URL yêu cầu hiện tại. ?foo=1&bar=something
URL	URL đầy đủ của yêu cầu hiện tại. https://www.example.com/profile/?foo=1&bar=something

searchindex

Đối tượng searchindex được sử dụng trong thẻ bảng Dataverse và cung cấp quyền truy nhập vào kết quả của truy vấn.

{% searchindex query: 'support', page: params.page, page_size: 10 %}

{% if searchindex.results.size > 0 %}

<p>Found about {{ searchindex.approximate_total_hits }} matches:</p>

<ul>

{% for result in searchindex.results %}

<li>

<h3><a href={{ result.url | escape }}>{{ result.title | escape }}</a></h3>

<p>{{ result.fragment }}</p>

</li>

{% endfor %}

</ul>

{% else %}

<p>Your query returned no results.</p>

{% endif %}

{% endsearchindex %}

Thuộc tính

Đặc điểm	Nội dung mô tả
approximate_total_hits	Trả về tổng số lần truy cập gần đúng phù hợp với truy vấn chỉ mục. Do cách chỉ mục tìm kiếm hoạt động liên quan đến bộ lọc bảo mật và các yếu tố thiết kế khác, con số này chỉ mang tính gần đúng và có thể không khớp chính xác với tổng số kết quả có sẵn cho người dùng hiện tại trong một số trường hợp.
Trang	Trả về số trang của truy vấn hiện tại.
page_size	Trả về kích thước trang tối đa của truy vấn hiện tại. Nếu bạn muốn biết số lượng kết quả thực tế được trả về cho trang hiện tại (vì số lượng này có thể nhỏ hơn kích thước trang tối đa đã chỉ định), hãy sử dụng results.size.
kết quả	Trả về trang kết quả truy vấn dưới dạng đối tượng kết quả của chỉ mục tìm kiếm.

Kết quả Chỉ mục Tìm kiếm

Thuộc tính	Mô tả
thực thể	Thực thể cơ sở cho kết quả.
phân đoạn	Một phân đoạn văn bản ngắn có liên quan đến kết quả, có thuật ngữ phù hợp với truy vấn đã chỉ định được đánh dấu bằng thẻ HTML <em>. Một số loại truy vấn không hỗ trợ các đoạn được tô sáng, chẳng hạn như truy vấn mờ (~) và truy vấn ký tự đại diện (*). Thuộc tính này có giá trị null trong những trường hợp đó.
ID	ID bảng Dataverse của bản ghi cơ sở cho kết quả, dưới dạng chuỗi. Ví dụ: 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name	Tên lô-gic bảng Dataverse của bản ghi cơ sở cho kết quả. Ví dụ: adx_webpage
Số	Số lượng kết quả, trên tất cả các trang kết quả, bắt đầu từ 1. Ví dụ, đối với kết quả đầu tiên của trang kết quả thứ hai, với kích thước trang là 10, giá trị này là 11.
điểm	Điểm số Lucene của kết quả sẽ tồn tại dưới dạng giá trị dấu phẩy động. Kết quả trả về được sắp xếp theo giá trị này.
tiêu đề	Tiêu đề của kết quả.
URL	URL cho kết quả. Điều này sẽ thường – nhưng không nhất thiết phải – là một đường dẫn tuyệt đối cho ứng dụng hiện tại, chứ không phải là một URL đầy đủ. Ví dụ: /articles/article1/

thiết đặt

Cho phép bạn tải bất kỳ thiết đặt trang nào theo tên. Nếu không tìm thấy cài đặt có tên đã cho, rỗng sẽ bị trả về.

Lưu ý

Thiết đặt được trả về dưới dạng chuỗi nhưng bạn có thể sử dụng Bộ lọc loại để chuyển đổi sang các loại khác.

{{ settings[My Setting] }}

{% assign search_enabled = settings[Search/Enabled] | boolean %}

{% if search_enabled %}

Search is enabled.

{% endif %}

{% assign pagesize = settings['page size'] | integer | default: 10 %}

{% if pagesize > 10 %}

Page size is greater than 10.

{% endif %}

Lưu ý

Hiển thị tiêu đề trang web và thanh điều hướng chính

sơ đồ trang web

Cho phép truy cập vào sơ đồ trang web trên cổng thông tin

<h1>{{ sitemap.root.title }}</h1>

<ul class=breadcrumb>

{% for crumb in sitemap.current.breadcrumbs %}

<li><a href={{ crumb.title }}>{{ crumb.title }}</a></li>

{% endfor %}

<li class=active>{{ sitemap.current.title }}</li>

</ul>

{% for child in sitemap.current.children %}

<a href={{ child.url }}>{{ child.title }}</a>

{% endfor %}

It's also possible to load a site map node by URL path:

{% assign node = sitemap[/content/page1/] %}

{% if node %}

{% for child in node.children %}

<a href={{ child.url }}>{{ child.title }}</a>

{% endfor %}

{% endif %}

Thuộc tính của Sơ đồ Trang web

Thuộc tính	Mô tả
Hiện tại	Trả về đối tượng nút sơ đồ trang web cho trang hiện tại.
Gốc	Trả về đối tượng nút sơ đồ trang web cho trang gốc (chủ) của trang web.

Thuộc tính Nút của Sơ đồ Trang web

Thuộc tính	Mô tả
Đánh dấu đường dẫn	Trả về đối tượng nút sơ đồ trang web có đánh dấu đường dẫn cho nút, bắt đầu từ nút gốc sơ đồ trang web và kết thúc tại cha.
Con	Trả về đối tượng nút sơ đồ trang web con của nút.
Mô tả	Mô tả/nội dung tóm tắt cho nút. (Trường này có thể chứa HTML.)
Thực thể	Trả về thực thể cơ sở của nút. Nếu nút không có bảng cơ sở thì giá trị này là null.
is_sitemap_ancestor	Trả về true nếu nút sơ đồ trang là nút trước đó của nút hiện tại, nếu không thì đặt thành false.
is_sitemap_current	Trả về true nếu nút sơ đồ trang là nút hiện tại, nếu không thì đặt thành false.
Cấp độ mẹ	Trả về nút sơ đồ trang web mẹ của nút. Nếu nút là nút gốc thì nút cha sẽ là null.
Title	Tiêu đề của nút.
URL	URL của nút.

đánh dấu trang

Cho phép bạn tải bất kỳ dấu trang nào theo tên. Nếu sitemarker tồn tại, một đối tượng sitemarker sẽ được trả về. Nếu không tìm thấy sitemarker có tên đã cho, thì sẽ trả về null .

{{ sitemarkers[Login].url }}

{% assign my_sitemarker = sitemarkers["My Site Marker"] %}

{% if my_sitemarker %}

<a href={{ my_sitemarker.url }}>{{ my_sitemarker.adx_name }}</a>

{% else %}

Site marker My Site Marker does not exist.

{% endif %}

Lưu ý

Hiển thị tiêu đề trang web và thanh điều hướng chính

Thuộc tính Dấu trang

Đặc điểm	Nội dung mô tả
URL	URL của mục tiêu dấu trang.
[tên thuộc tính logic]	Bạn có thể truy cập mọi thuộc tính của bản ghi Dataverse mục tiêu dấu trang theo tên lô-gic. Ví dụ: {{ sitemarker.adx_name }}

đoạn mã

Cho phép bạn tải bất kỳ đoạn mã nội dung nào theo tên. Nếu không tìm thấy đoạn mã có tên đã cho, null sẽ được trả về.

{{ snippets[Header] }}

{% assign footer = snippets[Footer] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

Bao gồm các thuộc tính hữu ích trong khối vòng lặp Thẻ lặp lại.

Lưu ý

chỉ có thể sử dụng tablerowloop trong thẻ thẻ lặp lại.

Thuộc tính

Thuộc tính	Mô tả
Cột	Trả về chỉ mục của dòng hiện tại, bắt đầu từ 1.
col0	Trả về chỉ mục của dòng hiện tại, bắt đầu từ 0.
col_first	Trả về true nếu cột hiện tại là cột đầu tiên trong hàng, trả về false nếu không phải là cột đầu tiên.
col_last	Trả về true nếu cột hiện tại là cột cuối cùng trong hàng, trả về false nếu không phải là cột cuối cùng.
Đầu tiên	Trả về true nếu đó là lần lặp đầu tiên của vòng lặp. Trả về false nếu đó không phải là lần lặp đầu tiên.
Chỉ mục	Vi trí của mục hiện tại trong tập hợp, nơi mục đầu tiên có vị trí 1.
index0	Vi trí của mục hiện tại trong tập hợp, nơi mục đầu tiên có vị trí 0.
Cuối cùng	Trả về true nếu đó là lần lặp cuối cùng của vòng lặp. Trả về false nếu đó không phải là lần lặp cuối cùng.
Độ dài	Trả về số lần lặp cho vòng lặp ߝ số mục trong tập hợp được lặp lại.
Rindex	Số mục còn lại trong vòng lặp (độ dài - chỉ mục) trong đó 1 là chỉ mục của mục cuối cùng.
rindex0	Số mục còn lại trong vòng lặp (độ dài - chỉ mục) trong đó 0 là chỉ mục của mục cuối cùng.

Người dùng

Đề cập đến người dùng cổng thông tin hiện tại, cho phép truy cập tất cả các thuộc tính của bản ghi liên hệ Dataverse cơ bản. Nếu không có người dùng nào đăng nhập, biến này là null.

Người dùng là một thực thể đối tượng.

{% if user %}
 
Hello, {{ user.fullname | escape }}!
 
{% else %}
 
Hello, anonymous user!
 
{% endif %}

Lưu ý

Bản phát hành Power Pages phiên bản 9.3.8.x trở lên sẽ thực thi bộ lọc Liquid escape theo mặc định cho đối tượng Liquid người dùng và yêu cầu. Để tắt cấu hình mặc định này và cho phép các đối tượng Liquid này không thoát bộ lọc Liquid, hãy xem cài đặt trang web cổng thông tin - Site/EnableDefaultHtmlEncoding.

Thuộc tính

Ngoài việc có tất cả các thuộc tính của đối tượng thực thể, người dùng còn có các thuộc tính sau.

Thuộc tính	Mô tả
vai trò	Trả về các vai trò mà người dùng thuộc về, dưới dạng mảng. {% if user.roles contains 'Administrators' %} User is an administrator. {% endif %} Lưu ý: Bạn cũng có thể sử dụng has_role bộ lọc để kiểm tra tư cách thành viên vai trò cá nhân.
basic_badges_url	Trả về url dịch vụ để xuất ra huy hiệu người dùng. Để hiển thị huy hiệu cho người dùng, bạn phải thêm thẻ có các thuộc tính "data-badge" và "data-uri". Để kết xuất huy hiệu hiện tại của người dùng: <div data-badge data-uri='{{user.basic_badges_url }}'></div> Để kết xuất huy hiệu của người dùng theo id (userid tùy biến): `<div data-badge data-uri='{{user.basic_badges_url

liên kết web

Cho phép bạn tải bất kỳ liên kết web nào theo tên hoặc ID.

Nếu tập hợp liên kết web tồn tại, thì đối tượng tập hợp liên kết web sẽ được trả về. Nếu không tìm thấy tập hợp liên kết web có tên hoặc ID đã cho, thì sẽ trả về null .

<!-- Load web link set by ID -->

{{ weblinks[page.adx_navigation.id].name }}

<!-- Load web link set by name -->

{% assign nav = weblinks[Primary Navigation] %}

{% if nav %}

<h1>{{ nav.title | escape }}</h1>

<ul>

{% for link in nav.weblinks %}

<li>

<a href={{ link.url | escape }} title={{ link.tooltip | escape }}>

{% if link.image %}

<img src={{ link.image.url | escape }} alt={{ link.image.alternate_text | escape }} />

{% endif %}

{{ link.name | escape }}

</a>

</li>

{% endfor %}

</ul>

{% endif %}

Lưu ý

Hiển thị tiêu đề trang web và thanh điều hướng chính |

Thuộc tính của Bộ Liên kết Web

Lưu ý

Một tập hợp liên kết web là một thực thể đối tượng, có tất cả các thuộc tính giống nhau, ngoài các thuộc tính sau:

Đặc điểm	Description
Sao chép	Bản sao HTML của bộ liên kết web.
Tên	Tên của bộ liên kết web.
Chức danh	Tiêu đề của bộ liên kết web.
Liên kết web	Một loạt đối tượng liên kết web được liên kết với bộ liên kết web.
[tên thuộc tính logic]	Bạn có thể truy cập mọi thuộc tính của bản ghi Dataverse trong bộ liên kết web theo tên lô-gic. Ví dụ: {{ weblinkset.createdon }}

Thuộc tính Liên kết Web

Lưu ý

Liên kết web là một thực thể đối tượng, có tất cả các thuộc tính giống nhau, ngoài các thuộc tính sau:

Đặc điểm	Description
Description	Bản mô tả HTML của liên kết web.
display_image_only	Thuộc tính Boolean chỉ ra rằng liệu có nên chỉ hiển thị liên kết web dưới dạng hình ảnh mà không có văn bản liên kết hay không.
display_page_child_links	Thuộc tính Boolean chỉ ra rằng liệu liên kết web có nên hiển thị liên kết cho các trang con sơ đồ trang của trang được liên kết, dưới dạng liên kết phụ hay không.
Image	Đối tượng hình ảnh liên kết web cho liên kết này. Thuộc tính này có giá trị null nếu không có hình ảnh nào.
is_external	Thuộc tính Boolean chỉ ra rằng liệu URL đích của liên kết web là cho trang web bên ngoài (chứ không phải cho trang cổng thông tin bên trong).
is_sitemap_ancestor	Trả về true nếu URL của liên kết web tham chiếu nút trước đó của nút sơ đồ trang hiện tại, nếu không thì đặt thành false.
is_sitemap_current	Trả về true nếu URL của liên kết web tham chiếu nút sơ đồ trang hiện tại, nếu không thì đặt thành false.
Tên	Tên/tiêu đề của liên kết web.
Nofollow	Thuộc tính Boolean chỉ ra rằng liệu có nên đánh dấu liên kết web là rel=nofollow hay không.
open_in_new_window	Thuộc tính Boolean chỉ ra rằng liệu có nên mở liên kết web trong thẻ/cửa sổ trình duyệt mới khi chọn hay không.
Chú giải công cụ	Văn bản chú giải cho liên kết web.
url	URL của liên kết web.
Liên kết web	Một loạt đối tượng liên kết web con được liên kết với liên kết web.
[tên thuộc tính logic]	Bạn có thể truy cập mọi thuộc tính của bản ghi Dataverse trong liên kết web theo tên lô-gic. Ví dụ: {{ weblink.createdon }}

Thuộc tính Hình ảnh Liên kết Web

alternate_text	Văn bản thay thế cho hình ảnh.
Chiều cao	Số nguyên chứa chiều cao được chỉ định của hình ảnh. Nếu không cung cấp giá trị chiều cao, thuộc tính này sẽ là null.
URL	URL của hình ảnh.
Chiều rộng	Số nguyên chứa chiều rộng được chỉ định của hình ảnh. Nếu không cung cấp giá trị chiều rộng, thuộc tính này sẽ là null.

trang web

Tham khảo trang web cổng thông tin, cho phép truy cập vào tất cả thuộc tính của bản ghi Trang web (adx_website) Dataverse cho cổng thông tin.

Lưu ý

Trang web là đối tượng thực thể, có tất cả thuộc tính đều giống nhau.

Mã số

{{ website.adx_name }} ({{ website.id }})

Đầu ra

Community Portal (936DA01F-9ABD-4d9d-80C7-02AF85C822A8)

Thuộc tính

Bảng sau đây liệt kê các thuộc tính cho thẻ này có thể được sử dụng thay thế các thuộc tính mặc định để tránh bộ nhớ đệm.

Mặc định	Thay thế (tránh bộ nhớ đệm)	Ví dụ:
sign_in_url	sign_in_url_substitution	Mặc định: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F Thay thế (tránh lưu vào bộ nhớ đệm): website.sign_in_url_substitution: /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F ("substitute-page" trong ví dụ này thay thế URL được lưu trong bộ nhớ cache mặc định.)
sign_out_url	sign_out_url_substitution	Mặc định: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F Thay thế (tránh lưu vào bộ nhớ đệm): website.sign_out_url_substitution: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F ("substitute-page" trong ví dụ này thay thế URL được lưu trong bộ nhớ cache mặc định.)

Xem thêm

Các loại chất lỏng
Thẻ chất lỏng
Bộ lọc chất lỏng