Thẻ mẫu

Thẻ mẫu kiểm soát đầu ra của một mẫu theo nhiều cách khác nhau, cũng như cho phép kết hợp nhiều mẫu vào một đầu ra duy nhất.

fetchxml

Cho phép người dùng truy vấn dữ liệu từ Microsoft Dataverse và hiển thị kết quả trong trang.

Lưu ý

Bạn có thể tìm hiểu thêm về cách truy vấn dữ liệu bằng Fetchxml tại use FetchXML để truy vấn dữ liệu.

{% fetchxml resultVariable %}
<!— Fetchxml query -->
...
{% endfetchxml %}

Khi sử dụng fetchxml để truy vấn dữ liệu, hãy đảm bảo bạn không dùng thẻ tự đóng. Ví dụ: thay vì <attribute name="title"/>, hãy sử dụng <attribute name="title"></attribute> với thẻ đóng rõ ràng </attribute>.

Thuộc tính kết quả

Thuộc tính results trong biến được cung cấp (chẳng hạn như 'resultVariable' trong mẫu ở trên) chứa FetchXML kết quả truy vấn và một vài thuộc tính khác.

• Thực thể

  Thuộc tính này chứa kết quả của truy vấn fetchxml. Bạn có thể lặp lại kết quả và sử dụng nó trong mẫu web của mình.

  <table> 
  {% for entityVariable in resultVariable.results.entities %} 
  <tr> 
  <td>Attribut-1: {{ entityVariable.attribute1 }}</td> 
  <td>Attribut-2: {{ entityVariable.attribute2 }}</td> 
  </tr> 
  {% endfor %} 
  </table> 
  

• TableName

  Lấy tên logic của thực thể.

• ExtensionData

  Tải cấu trúc có chứa dữ liệu phụ.

• MinActiveRowVersion

  Lấy giá trị phiên bản hàng hoạt động thấp nhất.

• MoreRecords

  Lấy thông tin liệu có nhiều hồ sơ khác không.

• PagingCookie

  Lấy thông tin phân trang hiện tại.

• TotalRecordCount

  Lấy tổng số lượng bản ghi trong bộ sưu tập.
  ReturnTotalRecordCount là đúng khi truy vấn được thực thi.

• TotalRecordCountLimitExceeded

  Xem thử kết quả của truy vấn có vượt quá tổng số bản ghi không.

Thuộc tính XML

Thuộc tính XML trong biến được cung cấp (chẳng hạn như 'resultVariable' trong mẫu ở trên) giữ truy vấn kết quả có thể được sử dụng để lấy dữ liệu từ Microsoft Dataverse. Thuộc tính này sẽ hữu ích cho mục đích gỡ lỗi khi bạn muốn hiểu cách áp dụng quyền đối với bảng này cho nhãn fetchxml.

Các yếu tố và thuộc tính được hỗ trợ khác

Thẻ liquid fetchxml hỗ trợ các thuộc tính sau và các phần tử con.

Phần tử / Phần tử con	Thuộc tính	Yếu tố con
tìm nạp	ánh xạ phiên bản số lượng trang cookie phân trang utc-offset tổng hợp phân biệt min-active-row-version output-format returntotalrecordcount no-lock	sắp xếp thực thể
đơn hàng	thuộc tính biệt danh giảm dần
thực thể	tên all-attributes no-attrs thuộc tính	sắp xếp lọc link-entity
lọc	loại gợi ý isquickfindfields	điều kiện lọc
link-entity	tên từ đến biệt danh loại liên kết hiển thị giao nhau all-attributes no-attrs thuộc tính	sắp xếp lọc link-entity
điều kiện	cột entityname thuộc tính toán tử tổng hợp biệt danh uiname uitype uihidden giá trị	giá trị

bao gồm

Bao gồm các nội dung của một mẫu vào một mẫu khác, theo tên. Trong Power Pages, nguồn thông tin của mẫu khác này thường sẽ là mẫu web. Toán tử này cho phép tái sử dụng các phần mẫu chung ở nhiều nơi.

Khi một mẫu được bao gồm trong một mẫu khác, mẫu được bao gồm sẽ có quyền truy cập vào mọi biến được xác định trong mẫu tổng.

{% include 'My Template' %}

Mẫu này cũng có thể gửi số lượng tham số được đặt tên bất kỳ tới thẻ bao gồm. Sau đó các tham số này sẽ được xác định là biến trong mẫu được bao gồm.

{% include 'My Template' a:x, b:y %}

khối

Sử dụng kết hợp với phần mở rộng để cung cấp các mẫu thừa kế. Xem phần mở rộng để biết cách sử dụng.

mở rộng

Sử dụng kết hợp với thẻ khối, cung cấp mẫu thừa kế. Toán tử này cho phép nhiều mẫu sử dụng bố cục được chia sẻ, trong khi thay thế các khu vực cụ thể của bố cục chính.

Trong Power Pages, tên của mẫu tổng được cung cấp cho thẻ thường sẽ tham chiếu đến tên của mẫu web.

Khi phần mở rộng được sử dụng, nó phải là nội dung đầu tiên trong mẫu, và theo sau chỉ được là một hoặc nhiều thẻ khối.

Nếu một khối được xác định trong mẫu tổng không được thay thế, nội dung của khối trong mẫu tổng (nếu có) sẽ được kết xuất.

nhận xét

Cho phép bạn để lại mã chưa được kết xuất trong mẫu Liquid. Mọi nội dung trong khối sẽ không được kết xuất và mọi mã Liquid bên trong sẽ không được thực thi.

Mã

Hello{% comment %}, {{ user.fullname }}{% endcomment %}. My name is Charles.

Đầu ra

Hello. My name is Charles.

xử lý thô

Cho phép đầu ra của mã Liquid trên trang mà không cần phân tích hoặc thực thi.

Đầu ra

Hello, {{ user.fullname }}. My name is Charles.

thay thế

Khi bạn bật bộ đệm đầu trang và chân trang và muốn tránh lưu đầu ra phần nhất định vào bộ đệm, bạn có thể sử dụng thẻ này. Thẻ này cung cấp khối nội dung trong đầu trang hoặc chân trang nơi đầu ra của khối nội dung đã được ngắt không được lưu vào bộ đệm ẩn. Toán tử này hữu ích trong các tình huống khi người dùng đang sử dụng một đối tượng có thể thường xuyên được cập nhật, chẳng hạn như yêu cầu, trang, ngôn ngữ và ngày. Ví dụ: tham khảo các kịch bản cập nhật mã nguồn của mẫu trang web đầu trang và chân trang khi bật tính năng lưu đầu trang và chân trang vào bộ đệm ẩn.

Mẹo

URL dùng trong request.url có thể là bất kỳ giá trị nào được yêu cầu, và sẽ được lưu vào bộ đệm cho các yêu cầu tiếp theo. Để đảm bảo giá trị trong request.url là chính xác, hãy cân nhắc sử dụng thẻ thay thế, URL bán phần chẳng hạn như ~{WebFile path} hoặc lưu trữ URL cổng thôn tin trong phần Cài đặt trang.

codecomponent

Xem bài viết Hiểu về thẻ thực thể Dataverse của thành phần mã, Sử dụng thẻ mẫu Liquid cho thành phần mã.

Xem thêm

Kiểm soát các thẻ của dòng quy trình
Thẻ lặp lại
Thẻ biến số
Dataverse Thẻ Liquid
Sử dụng thẻ mẫu Liquid cho các thành phần mã