템플릿 태그

아티클
03/16/2023

참고

2022년 10월 12일부터 Power Apps 포털이 Power Pages가 됩니다. 추가 정보: Microsoft Power Pages는 이제 일반적으로 사용할 수 있습니다(블로그)
곧 Power Apps 포털 설명서를 마이그레이션하고 Power Pages 설명서와 병합할 예정입니다.

템플릿 태그는 다양한 방법으로 템플릿 출력을 제어하고 여러 템플릿을 단일 출력으로 결합할 수 있습니다.

fetchxml

사용자가 Microsoft Dataverse에서 데이터를 쿼리하고 결과를 페이지에 렌더링할 수 있습니다.

참고

FetchXML을 사용하여 데이터 쿼리에서 fetchxml을 사용하여 데이터 쿼리에 대해 자세히 배울 수 있습니다.

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

fetchxml을 사용하여 데이터를 쿼리할 때 자동 닫기 태그를 사용하지 않도록 하세요. 예를 들어 <attribute name="title"/> 대신,<attribute name="title"></attribute>을(를) </attribute> 명시적 닫기 태그와 함께 사용하세요.

결과 특성

제공된 변수의 결과 특성(예: 위 샘플의 'resultVariable')에는 FetchXML 쿼리 결과와 몇 가지 다른 특성이 있습니다.

엔터티

이 특성에는 fetchxml 쿼리 결과가 포함됩니다. 결과를 반복하여 웹 템플릿에서 사용할 수 있습니다.

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

TableName

엔터티의 논리적 이름을 가져옵니다.
ExtensionData

추가 데이터가 들어 있는 구조를 가져옵니다.
MinActiveRowVersion

가장 낮은 활성 행 버전 값을 가져옵니다.
MoreRecords

사용 가능한 레코드가 더 있는지 여부를 가져옵니다.
PagingCookie

현재 페이징 정보를 가져옵니다.
TotalRecordCount

컬렉션의 총 레코드 수를 가져옵니다.
쿼리가 실행될 때 ReturnTotalRecordCount가 true였습니다.
TotalRecordCountLimitExceeded

쿼리 결과가 총 레코드 수를 초과하는지 여부를 가져옵니다.

XML 특성

제공된 변수의 XML 특성(예: 위 샘플의 'resultVariable')은 Microsoft Dataverse에서 데이터를 가져오는 데 사용할 수 있는 결과 쿼리를 보유합니다. 이 특성은 테이블 권한이 fetchxml 태그에 적용되는 방식을 이해하려는 경우 디버깅 목적으로 유용합니다.

기타 지원되는 요소 및 특성

Fetchxml 액체 태그는 다음 특성과 하위 요소를 지원합니다.

요소/하위 요소	특성	하위 요소
fetch	매핑 버전 개수 page 페이징 쿠키 utc-오프셋 집계 distinct 최소 활성 행 버전 출력-형식 returntotalrecordcount 잠금 없음	주문 엔터티
주문	특성 별칭 내림차순
엔터티	name 모든-특성 특성 없음 특성	주문 필터 링크-엔터티
필터	type 힌트 isquickfindfields	조건 필터
링크-엔터티	name 발신 수신 별칭 링크-유형 표시 교차 모든-특성 특성 없음 특성	주문 필터 링크-엔터티
조건	열 entityname 특성 운영자 집계 별칭 uiname uitype uihidden value	value

포함

이름별로 템플릿 한 개의 콘텐츠를 다른 템플릿에 포함시킵니다. Power Apps 포털에서 이 다른 템플릿의 원본은 일반적으로 웹 템플릿이 됩니다. 이렇게 하면 공통 템플릿 부분을 여러 곳에 다시 사용할 수 있습니다.

한 템플릿이 다른 템플릿에 포함되어 있으면, 포함된 템플릿에는 상위 템플릿에 정의된 모든 변수에 대한 액세스 권한이 생깁니다.

{% include 'My Template' %}

또한 임의 개수의 명명된 매개 변수를 include 태그에 전달할 수 있습니다. 그런 다음, 포함된 템플릿에서 변수로 정의됩니다.

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

block

템플릿 상속을 제공하기 위해 extends와 함께 사용됩니다. 사용법은 extends를 참조하십시오.

extends

block 태그와 함께 사용되며 템플릿 상속을 제공합니다. 이렇게 하면 상위 레이아웃의 특정 영역을 다시 정의하는 동안 여러 템플릿이 공유 레이아웃을 사용할 수 있습니다.

Power Apps 포털에서 태그에 제공된 상위 템플릿 이름은 일반적으로 웹 템플릿의 이름을 참조합니다.

extends가 사용되면 템플릿의 첫 번째 콘텐츠여야 하며, 그 뒤에 하나 이상의 block 태그만 올 수 있습니다.

상위 템플릿에 정의된 블록을 다시 정의하지 않은 경우, 상위 템플릿(있는 경우)의 해당 콘텐츠가 렌더링됩니다.

comment

유동 템플릿 내에 렌더링 되지 않은 코드를 둘 수 있습니다. 블록 내 콘텐츠가 렌더링되지 않으며, 블록 내 유동 코드는 실행되지 않습니다.

코드

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

출력

Hello. My name is Charles.

raw

유동 코드를 구문 분석하거나 실행하지 않고도 페이지에 출력할 수 있습니다.

출력

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

대체

머리글 및 바닥글 캐싱을 활성화하고 특정 섹션 출력의 캐싱을 방지하려는 경우 이 태그를 사용할 수 있습니다. 이 태그는 래핑된 콘텐츠 블록의 출력이 캐시되지 않는 머리글 또는 바닥글의 콘텐츠 블록을 제공합니다. 이는 사용자가 요청, 페이지, 언어 및 날짜와 같이 자주 업데이트될 수 있는 개체를 사용하는 시나리오에서 유용합니다. 예를 들어, 머리글 및 바닥글 캐싱이 활성화된 경우 머리글 및 바닥글 웹 템플릿 원본 코드 업데이트 시나리오를 참조하십시오.

팁

request.url에 사용된 URL은 요청된 값이 될 수 있으며 후속 요청에 대해 캐시됩니다. request.url의 올바른 값을 보장하려면 대체 태그, ~{WebFile 경로}와 같은 부분 URL을 사용하거나 사이트 설정에 포털 URL을 저장하십시오.

codecomponent

codecomponent Dataverse 엔터티 태그 이해하기, 코드 구성 요소 Liquid 템플릿 태그 사용을 참조하세요.

참고 항목:

제어 흐름 태그
반복 태그
변수 태그
Power Apps Dataverse 테이블 태그
코드 구성 요소에 Liquid 템플릿 태그 사용

참고

귀사의 설명서 언어 기본 설정에 대해 말씀해 주시겠습니까? 간단한 설문 조사에 응해주세요. (이 설문 조사는 영어로 되어 있습니다.)

이 설문 조사는 약 7분 정도 걸립니다. 개인 데이터는 수집되지 않습니다(개인정보처리방침).

Share via