Udostępnij za pośrednictwem

Tagi szablonów

  • Artykuł

Tagi szablonu kontrolują dane wyjściowe szablonu na różne sposoby, i umożliwiają łączenie wielu szablonów w jedną całość.

fetchxml

Zezwala użytkownikowi na wysyłanie zapytań dotyczących danych z Microsoft Dataverse i renderowanie wyników na stronie.

Uwaga

Możesz dowiedzieć się więcej na temat wykonywania zapytań dotyczących danych przy użyciu polecenia fetchxml używanego FetchXML do wykonywania zapytań dotyczących danych.

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

Używając fetchxml do wysyłania zapytań o dane, upewnij się, że nie używasz tagów samozamykających się. Na przykład zamiast <attribute name="title"/> użyj <attribute name="title"></attribute> z jawnym tagiem zamykającym </attribute>.

Atrybut wyników

Atrybut results w podanej zmiennej (taki jak "resultVariable" w powyższym przykładzie) przechowuje FetchXML wyniki zapytania i kilka innych atrybutów.

  • Encje

    Ten atrybut zawiera wyniki zapytania fetchxml. Można powtórzyć wynik i użyć go w szablonie sieci Web.

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

  • TableName

    Pobiera logiczną nazwę encji

  • ExtensionData

    Pobiera lub konfiguruje struktury zawierające dodatkowe dane.

  • MinActiveRowVersion

    Pobiera najmniejszą aktywną wartość wersji wiersza.

  • MoreRecords

    Pobiera informacje o tym, czy jest dostępnych więcej rekordów.

  • PagingCookie

    Pobiera bieżące informacje o stronicowaniu.

  • TotalRecordCount

    Pobiera łączną liczbę rekordów w kolekcji.
    ReturnTotalRecordCount miał wartość „prawda” podczas wykonywania zapytania.

  • TotalRecordCountLimitExceeded

    Pobiera informację o tym, czy wyniki zapytania przekraczają całkowitą liczbę rekordów.

Atrybut XML

Atrybut XML w podanej zmiennej (na przykład „resultVariable” w powyższej próbce) zawiera wyniki zapytania, które mogą być używane do pobierania danych z Microsoft Dataverse. Ten atrybut jest przydatny do debugowania, gdy użytkownik chce poznać sposób stosowania uprawnień w tabeli do tego tagu fetchxml.

Inne obsługiwane elementy i atrybuty

tag fetchxml liquid obsługuje następujące atrybuty oraz elementy podrzędne.

Element/element podrzędny Atrybuty Element podrzędny
fetch mapping
version
count
page
paging-cookie
utc-offset
aggregate
distinct
min-active-row-version
output-format
returntotalrecordcount
no-lock		 order
podmiot
order attribute
alias
malejąco
podmiot name
all-attributes
no-attrs
attribute		 order
filter
link-entity
filtr type
hint
isquickfindfields		 condition
filtr
link-entity name
from
to
alias
link-type
visible
intersect
all-attributes
no-attrs
attribute		 order
filter
link-entity
condition column
entityname
attribute
operator
aggregate
alias
uiname
uitype
uihidden
value		 value

include

Uwzględnia zawartość jednego szablonu w innym, według nazwy. W Power Pages źródłem tego innego szablonu będzie szablon sieci Web. Operator pozwala to na ponowne wykorzystanie wspólnych fragmentów szablonu w wielu miejscach.

Gdy szablon stanowi część innego szablonu, dołączony szablon ma dostęp do wszelkich zmiennych zdefiniowanych w szablonie nadrzędnym.

{% include 'My Template' %}

Jest również możliwe przekazanie dowolnej liczby parametrów do tagu uwzględnij. Te parametry zostaną następnie definiowane jako zmienne w dołączonym szablonie.

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

block

Używany z extends, aby zapewnić dziedziczenie szablonów. Zobacz extends do użycia.

extends

Używany z tagiem block, zapewnia dziedziczenie szablonów. Dzięki temu operatorowi wiele szablonów może korzystać z wspólnego układu, zastępując konkretne obszary układu nadrzędnego.

W Power Pages, nazwa szablonu nadrzędnego podana w tagu będzie się zazwyczaj odnosiła do nazwy szablonu sieci Web.

W przypadku używania extends, musi to być pierwsza zawartość w szablonie, a po niej może się znajdować wyłącznie jeden lub kilka tagów block.

Jeśli blok zdefiniowany w szablonie nadrzędnym nie jest zastępowany, jego zawartość w szablonie nadrzędnym (jeśli istnieje) będzie renderowana.

comment

Pozwala zostawić nierenderowany kod wewnątrz szablonu Liquid. Zawartość bloku nie będzie renderowana, a kod Liquid nie zostanie wykonany.

Kod

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

Wynik

Hello. My name is Charles.

raw

Umożliwia wyjście kodu Liquid na stronie bez parsowania i wykonywania.

Dane wyjściowe

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

podstawienie

Gdy włączysz buforowanie nagłówków i stopek, a chcesz uniknąć buforowania niektórych danych wyjściowych sekcji, można użyć tego tagu. Ten tag umożliwia blok zawartości w nagłówku lub stopce, gdzie dane wyjściowe bloku zawiniętej zawartości nie są zapisywane w pamięci podręcznej. Ten operator jest przydatny w scenariuszach, w których użytkownik korzysta z obiektu, który często może być aktualizowany, takiego jak żądanie, strona, język i data. Na przykład, zapoznaj się ze scenariuszami aktualizowania kodu źródłowego szablonu sieci Web nagłówka i stopki jeśli buforowanie nagłówka i stopi zostało włączone.

Napiwek

Adres URL użyty w polu request.url może być dowolną żądaną wartością i jest przechowywany do kolejnych żądań. Aby zachować prawidłową wartość w polu request.url, warto rozważyć użycie znacznika substytucji, częściowego adresu URL, takiego jak ~{WebPath} lub przechowywanie adresu URL portalu w Ustawieniach witryny.

codecomponent

Zobacz Opis tagu encji składnika Dataverse kodu, Używanie składników kodu Znacznik szablonu Liquid.

Zobacz też

Tagi przepływu sterowania
Tagi iteracji
Tagi zmiennych
Znaczniki Dataverse Liquid
Używanie tagu szablonu języka Liquid w składnikach kodu