Đố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 ý: Giá trị này được ứng dụng web cổng thông tin lưu vào bộ đệm ẩn và không được 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 sẽ là rỗng. 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
Cung cấp khả năng truy cập 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 tổng quát và thuộc tính được liệt kê bên dưới.
| Thuộc tính | Nội dung mô tả |
|---|---|
| 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í. Có thể sử dụng Thẻ lặp lại và Bộ lọc mảng với tập hợ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 bảng, có tất cả các thuộc tính tương tự cùng những thuộc tính được liệt kê dưới đây.
| Đặc điểm | Nội dung mô tả |
|---|---|
| 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 sẽ được chuyển hướng đến bằng cách 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. |
| chiều rộng | Trả về chiều rộng bằng pixel cho hình ảnh |
blog
Cung cấp khả năng truy cập và kết xuất Blog cũng như 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>
–
<a href={{ post.author_url }}> {{ post.author_name }} </a>
–
<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(để nhận tất 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, thì đối tượng bảng sẽ được trả về. Nếu không tìm thấy bảng có ID đã cho, thì giá trị null sẽ được trả về.
{% 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 nhậ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 ghi chú (chú thích) bất kỳ được liên kết với bảng, được sắp xếp theo thứ tự 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. Nói chung, tùy chọn này sẽ 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ừ phi 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:
{{ page.adx_webpage_entitylist.adx_name }}Trong trường hợp mối quan hệ linh hoạt (tức là tự tham chiếu) thì đối tượng mối quan hệ linh hoạt 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ể có liên quan hoặc truy cập số lượng lớn mối quan hệ trong một mẫu, có thể có tác động tiêu cực đến hiệu suất kết xuất 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 đối tượng bảng, ghi chú còn có các thuộc tính bổ sung sau.
| Thuộc tính | Mô tả |
|---|---|
| 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. Do nội dung của thuộc tính này có thể lớn nên sẽ không được tải cùng phần còn lại của thuộc tính ghi chú và chỉ được tải theo yêu cầu. Lưu ý: Việc sử dụng thuộc tính documentbody có thể có tác động tiêu cực đến quá trình kết xuất hiệu suất và cần được tiến hành cẩn thận. 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ú là tệp đính kèm, yêu cầu đối với URL này sẽ tải xuống tệp đính kèm tệp ghi chú. |
Lưu ý
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 đó 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.
Thuộc tính
Lưu ý
| Đặ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 lô-gic của thuộc tính để tra cứu cho tài khoản sẽ được sử dụng để lọc bản ghi kết quả bởi tài khoản mẹ 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 lô-gic thuộc tính để tra cứu cho liên hệ sẽ được sử dụng để lọc bản ghi kết quả bởi 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 lô-gic của thuộc tính để tra cứu cho adx_website sẽ được sử dụng để lọc bản ghi kết quả bởi 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 Dataverse sẽ đượ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 dạng xem. |
| 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. Nội dung này sẽ là 1 trừ khi không có kết quả nào được trả về, trong trường hợp này, nội dung 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ả trả về, nội dung này sẽ 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, nội dung này sẽ 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 đó, nội dung này sẽ là null. |
| 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
Cung cấp khả năng truy cập và kết xuất 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:
| Thuộc tính | Nội dung mô tả |
|---|---|
| số lần xuất hiện | 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 lần xuất hiện sự kiện và chỉ định khoảng ngày cho lần xuất hiện để truy xuất cũng như lưu trữ dàn trang bằng bộ lọc liquid
{% assign occurances = event.occurrences.from[today].to[advance_date] %}
lưu ý rằng
{% assign occurances = event.occurrences.min[today].max[advance_date] %}
cũng có thể.
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. Các thuộc tính liên kết được cho dưới đây:
| Đặc điểm | Nội dung mô tả |
|---|---|
| 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ã
{% 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
Cung cấp khả năng truy cập và hiển thị Diễn đàn và Chuỗi 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 đ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 đ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 đ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. Có thể kết hợp bộ lọc với các bộ lọc Liquid khác.
{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}
| 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: 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. Có thể kết hợp bộ lọc với các bộ lọc Liquid khác.
{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
| 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. 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à đối tượng thực thể, có tất cả thuộc tính giống nhau ngoài những thuộc tính được liệt kê bên dưới.
| Thuộc tính | Mô tả |
|---|---|
| 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 của số nhận xét dành 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 của số lần xem bài viết. |
Đố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
danh mục là đối tượng thực thể, có tất cả thuộc tính giống nhau ngoài những thuộc tính được liệt kê bên dưới.
| Thuộc tính | Mô tả |
|---|---|
| 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ữ.
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 đ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ủ, mục cha/mẹ 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:
{{ page.adx_webpage_entitylist.adx_name }}Trong trường hợp mối quan hệ linh hoạt (ví dụ: 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ể có liên quan hoặc truy cập số lượng lớn mối quan hệ trong một mẫu, có thể có tác động tiêu cực đến hiệu suất kết xuất 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ò
Cung cấp khả năng truy cập 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 đ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í. Có thể sử dụng Thẻ lặp lại và Bộ lọc mảng với tập hợ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 đ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ò. Có thể sử dụng Thẻ lặp lại và thực thể với tập hợ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 được người dùng chọn (nếu họ đã bình chọn). |
| số lượng bình chọn | Trả về số lượng bình chọn đã được lập bảng biểu cho cuộc thăm dò. |
Thuộc tính Tùy chọn Cuộc thăm dò
Lưu ý
| Đặ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ố lượng bình chọn đã được lập bảng biểu 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 hoạt động của chỉ mục tìm kiếm liên quan đến tính năng lọc bảo mật và các yếu tố thiết kế khác, con số này chỉ gần đúng và có thể không phù hợp hoàn toàn 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 số lượng kết quả thực tế được trả về cho trang hiện tại (do con số này có thể ít hơn kích thước trang tối đa được 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ợ phần được đánh dấu, chẳng hạn như truy vấn mờ (~) và truy vấn ký tự đại diện (*). Thuộc tính này sẽ được để trống 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, có kích thước trang là 10, giá trị này sẽ 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ả sẽ được trả về theo yêu cầu của 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 %}
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 sẽ 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, mục cha/mẹ sẽ là null. |
| Chức danh | 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 dấu trang tồn tại, đối tượng dấu trang sẽ được trả về. Nếu không tìm thấy đánh dấu trang có tên đã cho, rỗng sẽ bị trả về.
{{ 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 %}
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, rỗng 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 sẽ là rỗng.
người dùng là đối tượng thực thể.
{% 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 bộ lọc has_role để kiểm vai trò cá nhân của thành viên. |
| basic_badges_url | Trả về url dịch vụ để xuất ra huy hiệu người dùng. Để kết xuất huy hiệu cho một người dùng, bạn phải đưa tag vào 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 bộ liên kết web tồn tại thì đối tượng bộ đặt liên kết sẽ được trả về. Nếu không tìm thấy bộ liên kết có ID hoặc tên đã cho, rỗng sẽ được trả về.
<!-- 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 %}
Thuộc tính của Bộ Liên kết Web
Lưu ý
Bộ liên kết web đối tượng thực thể, có tất cả thuộc tính giống nhau ngoài những thuộc tính được liệt kê bên dưới.
| Thuộc tính | Mô tả |
|---|---|
| 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à đối tượng thực thể, có tất cả thuộc tính giống nhau ngoài những thuộc tính được liệt kê bên dưới.
| Thuộc tính | Nội dung mô tả |
|---|---|
| Nội dung mô tả | 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. |
| Hình ảnh | Đối tượng hình ảnh liên kết web cho liên kết này. Thuộc tính này sẽ được để trống nếu không có hình ảnh nào hiển thị. |
| 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 có giá trị chiều cao nào được cung cấp thì thuộc tính này sẽ được để trống. |
| 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 có giá trị chiều rộng nào được cung cấp thì thuộc tính này sẽ được để trống. |
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ã
{{ 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 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 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
Phản hồi
Sắp ra mắt: Trong năm 2024, chúng tôi sẽ dần gỡ bỏ Sự cố với GitHub dưới dạng cơ chế phản hồi cho nội dung và thay thế bằng hệ thống phản hồi mới. Để biết thêm thông tin, hãy xem: https://aka.ms/ContentUserFeedback.
Gửi và xem ý kiến phản hồi dành cho