Tagi szablonów

  • Artykuł

Uwaga

12 października 2022 r. funkcja Portale usługi Power Apps została przekształcona w usługę Power Pages. Więcej informacji: Usługa Microsoft Power Pages jest teraz ogólnie dostępna (blog)
Wkrótce zmigrujemy i scalimy dokumentację funkcji Portale usługi Power Apps z dokumentacją usługi Power Pages.

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żna dowiedzieć się więcej o tworzeniu zapytań dotyczących danych przy użyciu fetchxml na stronie używaj FetchXML, aby zapytać o dane.

{% 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 wyników w podanej zmiennej (na przykład „resultVariable” w powyższej próbce) zawiera wyniki zapytania FetchXML 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
filtr
link-entity
filtr type
hint
isquickfindfields		 condition
filtr
link-entity name
from
to
alias
link-type
widoczne
część wspólna
all-attributes
no-attrs
attribute		 order
filtr
link-entity
condition column
nazwa encji
attribute
operator
aggregate
alias
uiname
uitype
uihidden
value		 value

include

Uwzględnia zawartość jednego szablonu w innym, według nazwy. W portalach Power Apps źródłem tego innego szablonu będzie szablon sieci Web. 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. Zostaną one następnie definiowane jako zmienne w dołączonym szablonie.

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

block

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

extends

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

W portalach Power Apps, 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. Jest to przydatne 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
Tagi encji usługi Power Apps Dataverse
Używanie tagu szablonu języka Liquid w składnikach kodu

Uwaga

Czy możesz poinformować nas o preferencjach dotyczących języka dokumentacji? Wypełnij krótką ankietę. (zauważ, że ta ankieta jest po angielsku)

Ankieta zajmie około siedmiu minut. Nie są zbierane żadne dane osobowe (oświadczenie o ochronie prywatności).