다음을 통해 공유

템플릿 태그

  • 아티클

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

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 매핑
버전
수
페이지
페이징 쿠키
utc-오프셋
집계
distinct
최소 활성 행 버전
출력-형식
returntotalrecordcount
잠금 없음		 주문
엔터티
주문 특성
별칭
내림차순
엔터티 이름
모든-특성
특성 없음
특성		 주문
필터링
링크-엔터티
필터 유형
힌트
isquickfindfields		 조건
필터
링크-엔터티 이름
시작
끝
별칭
연결 유형
표시됨
교차
모든-특성
특성 없음
특성		 주문
필터링
링크-엔터티
조건 열
엔터티 이름
특성
연산자
집계
별칭
uiname
uitype
uihidden
value		 value

포함

이름별로 템플릿 한 개의 콘텐츠를 다른 템플릿에 포함시킵니다. Power Pages에서 이 다른 템플릿의 원본은 일반적으로 웹 템플릿이 됩니다. 이 연산자를 통해 여러 위치에서 공통 템플릿 조각을 재사용할 수 있습니다.

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

{% include 'My Template' %}

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

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

block

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

extends

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

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

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

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

comment

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

코드

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 템플릿 태그 사용을 참조하세요.

참조 항목

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