사용 가능한 Liquid 개체
참고
2022년 10월 12일부터 Power Apps 포털이 Power Pages가 됩니다. 추가 정보: Microsoft Power Pages는 이제 일반적으로 사용할 수 있습니다(블로그)
곧 Power Apps 포털 설명서를 마이그레이션하고 Power Pages 설명서와 병합할 예정입니다.
유동 개체는 페이지에 동적 콘텐츠를 출력하는 특성을 포함합니다. 예를 들어, 페이지 개체는 현재 페이지의 제목을 출력하는 데 쓰일 수 있는 제목이라 불리는 특성을 가집니다.
이름으로 개체 특성에 액세스하려면 마침표(.)를 사용하십시오. 템플릿에서 객체의 속성을 렌더링하려면 {{ and }}로 래핑합니다.
중요
잠재적인 XSS(교차 사이트 스크립팅) 문제를 방지하려면 항상 탈출 필터를 사용하여 사용자가 제공한 신뢰할 수 없는 데이터를 읽기 위해 Liquid 개체를 사용할 때마다 데이터를 HTML로 인코딩합니다.
{{ page.title }}
개체의 특성은 문자열 이름과 []을 사용하여 액세스할 수도 있습니다. 이 형식은 필수 특성이 동적으로 결정되거나 특성 이름에 유효하지 않은 문자, 공백, 특수 문자 등이 포함되어 구문 내에 마침표(.)를 사용하는 경우에 유용합니다.
{{ page[title] }}
{% assign attribute_name = Name with spaces %}
{{ object[attribute_name] }}
다음 개체는 어디서든, 어느 템플릿에서든 사용하고 액세스할 수 있습니다.
| 개체 | 설명 |
|---|---|
| 엔터티 | ID로 모든 Power Apps 테이블을 로드할 수 있습니다. 추가 정보: 엔터티 |
| 지금 | 템플릿이 렌더링될 때 현재 UTC 시간을 나타내는 날짜/시간 개체입니다. 참고: 이 값은 포털 웹 앱에 의해 캐싱되며 매번 새로 고쳐지지 않습니다. 추가 정보: 날짜 필터 |
| 페이지 | 현재 포털 요청 페이지를 참조합니다. 페이지 개체는 현재 페이지의 이동 경로, 현재 페이지의 제목 또는 URL, 그리고 기본 Power Apps 레코드의 기타 특성 또는 관련된 엔터티에 대한 액세스를 제공합니다. 추가 정보: 페이지 |
| params | request.params에 대한 편리한 바로 가기입니다. 추가 정보: 요청 |
| 요청 | 현재 HTTP 요청에 대한 정보가 담겨 있습니다. 추가 정보: 요청 |
| 설정 | 이름을 사용하여 모든 사이트 설정을 로드할 수 있습니다. 추가 정보: 설정 |
| sitemap | 포털 사이트 맵에 대한 액세스를 허용합니다. 추가 정보: 사이트 맵 |
| 사이트 마커 | 이름을 사용하여 모든 사이트 마커를 로드할 수 있습니다. 추가 정보: sitemarkers |
| 조각 | 이름으로 콘텐츠 조각을 로드할 수 있습니다. 추가 정보: 코드 조각 |
| 사용자 | 현재 포털 사용자를 참조하여 기본 Power Apps 연락처 레코드의 모든 특성에 액세스할 수 있습니다. 로그인한 사용자가 없으면 이 변수는 null입니다. 추가 정보: 사용자 |
| 웹 링크 | 이름 또는 ID로 모든 웹 링크 집합을 로드할 수 있습니다. 추가 정보: 웹 링크 |
| 웹 사이트 | 포털 웹 사이트 레코드를 참조하여 포털에 대한 Power Apps 웹 사이트(adx_website) 레코드의 모든 특성에 액세스할 수 있습니다. 추가 정보: 웹 사이트 |
광고
광고에 액세스하고 광고를 렌더링하는 기능을 제공합니다.
광고 개체를 사용하여 특정 광고 또는 광고 배치를 선택할 수 있습니다.
<div>
{% assign ad = ads[Ad Name] %}
<h4>{{ ad.title }}</h4>
<a href={{ ad.redirect_url }}>
<img src={{ ad.image.url }} alt={{ ad.image.alternate_text }} />
</a>
</div>
광고 특성
| 특성 | 설명 |
|---|---|
| placements | 광고 배치 개체를 반환합니다. |
| [광고 이름 또는 ID] | 이름 또는 ID 속성으로 어느 광고에든 액세스할 수 있습니다. {% assign ad = ads[Ad Name] %}{% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
광고 배치 특성
| 특성 | 설명 |
|---|---|
| [광고 배치 이름 또는 ID] | 이름 또는 ID 속성으로 어느 광고 배치에든 액세스할 수 있습니다.{% assign placement = ads.placements[Placement Name or Id] %}{% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %} |
광고 배치 특성
광고 게재 위치는 동일한 일반 속성과 아래 나열된 속성을 가진 테이블 개체입니다.
| 특성 | 설명 |
|---|---|
| 광고 | 배치와 연관된 광고 개체 모음을 반환합니다. 반복 태그 및 배열 필터는 이 모음과 함께 사용할 수 있습니다. |
| 이름 | 광고 배치의 이름 필드를 반환합니다. |
| placement_url | 템플릿으로 완전히 렌더링된 광고 배치를 검색하는 데 사용할 수 있는 URL입니다. |
| random_url | 템플릿으로 완전히 렌더링된 배치에서 무작위로 광고를 검색하는 데 사용할 수 있는 URL입니다. |
광고 특성
참고
광고는 아래에 나열된 특성 이외에 모두 동일한 특성을 가진 테이블 개체입니다.
| 특성 | 설명 |
|---|---|
| ad_url | 템플릿으로 완전히 렌더링된 광고를 검색하는 데 사용할 수 있는 URL입니다. |
| 복사 | 광고의 복사 필드를 반환합니다. |
| image | 광고의 이미지 개체(있는 경우)를 반환합니다. |
| 이름 | 광고의 이름 필드를 반환합니다. |
| open_in_new_window | redirect_url이 지정한 URL이 새 창에서 열리는 경우 true를 반환합니다. |
| redirect_url | 사용자가 광고를 선택했을 때 리디렉션되는 URL입니다. |
광고 이미지 특성
| 특성 | 설명 |
|---|---|
| alternate_text | 태그의 대체 특성에 나타내고자 하는 텍스트를 반환합니다. |
| height | 이미지의 높이를 픽셀로 반환합니다. |
| URL | 이미지에 대한 URL 원본을 반환합니다. |
| width | 이미지의 너비를 픽셀로 반환합니다. |
blogs
블로그 및 블로그 게시물에 액세스하고 렌더링할 수 있는 기능을 제공합니다.
블로그 개체는 특정 블로그 또는 블로그 게시물의 선택을 가능하게 합니다.
{% assign posts = blogs.posts | paginate: 0,4 %}
<div class=content-panel panel panel-default>
<div class=panel-heading>
{% assign sitemarker = sitemarkers["Blog Home"] %}
{% assign snippet = snippets[Home Blog Activity Heading] %}
<a class=pull-right href={{sitemarker.url}}> All Blogs </a>
<h4>
<a class=feed-icon fa fa-rss-square href={{ blogs.feedpath }} />
{{ snippet.adx_value }}
</h4>
</div>
<ul class=list-group>
{% for post in posts.all %}
<li class=list-group-item >
<a class=user-avatar href={{ post.author_url }}>
<img src={{ post.user_image_url }} />
</a>
<h4 class=list-group-item-heading>
<a href={{ post.app_relative_path }}>{{ post.title }}</a>
</h4>
<div class=content-metadata>
<abbr class=timeago>{{ post.publish_date }}</abbr>
–
<a href={{ post.author_url }}> {{ post.author_name }} </a>
–
<a href={{ post.application_path }}#comments>
<span class=fa fa-comment aria-hidden=true></span> {{ post.comment_count }}
</a>
</div>
</li>
{% endfor %}
</ul>
</div>
blogs 개체
블로그 개체를 통해 포털의 특정 블로그에 액세스하거나 포털의 모든 블로그 게시물에 액세스할 수 있습니다.
다음 표는 블로그 개체와 관련된 특성을 설명합니다.
| 특성 | 설명 |
|---|---|
| posts | 포털의 모든 블로그 게시물을 포함하는 블로그 게시물 개체를 반환합니다. |
| [블로그 이름 또는 ID] | 이름 또는 ID 속성으로 어떤 블로그에든 액세스할 수 있습니다. |
{% assign blog = blogs["Blog Name"] %}
{% assign blog = blogs["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
blog 개체
블로그 개체를 통해 단일 블로그로 작업하여 해당 블로그를 위한 게시물에 액세스할 수 있습니다.
다음 표는 blog 개체와 관련된 다양한 특성을 설명합니다.
| 특성 | 설명 |
|---|---|
| posts | 블로그를 위한 모든 블로그 게시물을 포함하는 블로그 게시물 개체를 반환합니다. |
| 이름 | 블로그의 이름. |
| 제목 | 블로그의 제목. |
| URL | 블로그의 URL. |
blogposts 개체
블로그 게시물 개체를 사용하여 블로그 게시물 개체 모음에 액세스할 수 있습니다. 블로그 게시물의 순서를 정하고 페이지를 매기며 유동 필터를 사용할 수 있습니다.
{% assign blogposts = blogs.posts | order\_by “adx\_name”, “desc” | paginate: 0,4 | all %}
기타 가능한 옵션:
blogs.posts.all(모든 블로그 게시물을 가져오는 방법)blogs.posts | from\_index: 0 | take: 2
다음 표는 blogposts 개체와 관련된 다양한 특성을 설명합니다.
| 특성 | 설명 |
|---|---|
| 모두 | 컬렉션에 있는 모든 블로그 게시물 개체를 반환합니다. |
blogpost 개체
단일 블로그 게시물을 지칭합니다.
다음 표는 blogpost 개체와 관련된 다양한 특성을 설명합니다.
| 특성 | 설명 |
|---|---|
| URL | 게시물의 URL. |
| 콘텐츠 | 게시물의 콘텐츠 필드를 반환합니다. |
| 작성자 | 게시물의 작성자(단순히 연락처 테이블 개체)를 반환합니다. |
| 제목 | 게시물의 제목. |
| comment_count | 특정 게시물에 달린 댓글 수의 정수값을 반환합니다. |
| publish_date | 게시물이 게시된 날짜. |
엔터티
주의
잠재적인 교차 사이트 스크립팅(XSS) 문제를 방지하려면 엔터티 Liquid 개체를 사용하여 신뢰할 수 없는 사용자가 제공한 데이터를 읽을 때마다 항상 이스케이프 필터를 사용하여 문자열 데이터를 HTML 인코딩합니다.
참고
Dataverse의 일부 명명 규칙이 변경되었습니다. 예를 들어 Dataverse 엔터티는 이제 테이블이라고 합니다. 이름 변경 사항은 Liquid 개체에 적용되지 않습니다. 유동 엔터티 개체는 계속 엔터티라고 합니다.
ID로 모든 Power Apps 테이블을 로드할 수 있습니다. 테이블이 존재하는 경우, 테이블 개체가 반환될 것입니다. 주어진 ID의 테이블이 발견되지 않으면 null이 반환될 것입니다.
{% assign account = entities.account['936DA01F-9ABD-4d9d-80C7-02AF85C822A8'] %}
{% if account %}
{{ account.name | escape }} ({{ account.statecode.label | escape }})
{% endif %}
{% assign entity_logical_name = 'contact' %}
{% assign contact = entities[entity_logical_name][request.params.contactid] %}
{% if contact %}
{{ contact.fullname | escape }} ({{ contact.parentcustomerid.name | escape }})
{% endif %}
Entity
엔터티 개체는 Power Apps 테이블 레코드의 특성에 대한 접근 권한을 제공합니다.
| 특성 | 설명 |
|---|---|
| ID | 문자열로서의 테이블의 GUID ID입니다. 예: 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| logical_name | 테이블의 Power Apps 논리 이름입니다. |
| 참고 | 테이블과 연계된 메모(annotation)를 이전부터 최신의 순서로 로드합니다(createdon). 메모는 메모 개체로 반환됩니다. |
| 권한 | 테이블에 대한 테이블 권한 주장 결과를 로드합니다. 결과는 권한 개체로 반환됩니다. |
| URL | 테이블에 대한 Power Apps 포털 콘텐츠 관리 시스템 URL 경로를 반환합니다. 테이블이 현재 웹사이트에 유효한 URL을 갖고 있지 않는 경우 null을 반환합니다. 귀하가 응용 프로그램에서 URL 공급자를 사용자 지정하지 않은 한 일반적으로 이것은 포털 CMS 에 통합된 특정 테이블 유형을 위한 값만 반환할 것입니다. |
| [특성 또는 관계 이름] | 논리적 이름으로 Power Apps 테이블의 특성에 액세스할 수 있습니다. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }} 대부분의 테이블 특성들의 값은 직접 유동 유형에 매핑됩니다. 두 옵션 필드는 부울에, 텍스트 필드는 문자열에, 숫자/통화 필드는 숫자에, 날짜/시간 필드는 날짜 개체에 매핑됩니다. 그러나 일부 특성 유형은 다음 개체로 반환됩니다.
{{ page.adx_webpage_entitylist.adx_name }}관계가 재귀 관계(즉, 자가 참조적)인 경우에는 재귀 관계 개체가 반환될 것입니다. (그렇지 않으면, 결과가 애매모호할 것입니다.){{ page.adx_webpage_webpage.referencing.adx_name }} 참고: 단일 템플릿에서 큰 수의 관련 엔터티를 로드하거나 큰 수의 관계에 액세스하는 것은 템플릿 렌더링 수행에 부정적 영향을 미칠 수 있습니다. 한 루프 내에서 연속으로 각 항목의 관련 엔터티 로드를 피하십시오. 가능하면 엔터티 컬렉션을 로드하기 위해 Dataverse 테이블 태그를 사용하세요. |
연결된 테이블 참조
특성 조회 값은 다음 특성을 가진 연결된 테이블 참조 개체로 반환됩니다.
| 특성 | 설명 |
|---|---|
| ID | 문자열로서의 참조되는 테이블의 GUID ID입니다. 예: 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| logical_name | 참조된 테이블의 Power Apps 논리적 이름입니다. |
| 이름 | 참조된 테이블의 기본 이름 특성입니다. |
내용
메모는 주석 레코드의 특성과 관계에 대한 접근 권한을 제공하는 테이블 개체입니다. 테이블 개체의 모든 특성뿐만 아니라 메모는 다음 추가 특성을 갖습니다.
| 특성 | 설명 |
|---|---|
| documentbody | 메모 주석 레코드의 documentbody 특성을 Base64 인코딩 문자열로 로드합니다. 이 특성의 콘텐츠가 클 수 있기 때문에 나머지 메모 특성과 함께 로드되지 않고 요구 시에만 로드됩니다. 참고: documentbody 특성 사용은 템플릿 렌더링 성능에 부정적 영향을 미칠 수 있으므로 조심해서 사용해야 합니다. 그 대신에 가능하면 url 특성을 사용하여 메모 첨부의 링크를 제공하십시오. |
| URL | 내장된 포털 주석 첨부 핸들러를 위한 URL 경로를 반환합니다. 사용자에게 권한이 있고 메모에 첨부 파일이 있는 경우, 이 URL 요청은 메모 파일 첨부를 다운로드할 것입니다. |
참고
옵션 집합 값
옵션 설정/픽리스트 특성 값은 다음 특성을 가진 연관된 테이블 참조 개체로 반환됩니다.
| 특성 | 설명 |
|---|---|
| 레이블 | 옵션 설정/픽리스트 특성 값의 현지화된 레이블. 예: 활성 |
| 값 | 옵션 설정/픽리스트 특성 값의 정수 값. 예: 0 |
테이블 사용 권한
테이블 권한 개체는 테이블에 대한 총합 권한 주장 결과에 대한 액세스 권한을 제공합니다.
| 특성 | 설명 |
|---|---|
| can_append | 레코드를 이 레코드 관계에 첨부할 권한이 현재의 사용자에게 있는 경우 true를 반환합니다. 그렇지 않은 경우 false를 반환합니다. |
| can_append_to | 이 레코드를 다른 테이블 관계에 첨부할 권한이 현재의 사용자에게 있는 경우 참을 반환합니다. 그렇지 않은 경우 false를 반환합니다. |
| can_create | 이 테이블 타입의 새 레코드를 생성할 권한이 현재의 사용자에게 있는 경우 참을 반환합니다. 그렇지 않은 경우 false를 반환합니다. |
| can_delete | 이 레코드를 삭제할 권한이 현재의 사용자에게 있는 경우 true를 반환합니다. 그렇지 않은 경우 false를 반환합니다. |
| can_read | 이 레코드를 읽을 권한이 현재의 사용자에게 있는 경우 true를 반환합니다. 그렇지 않은 경우 false를 반환합니다. |
| can_write | 이 레코드를 업데이트할 권한이 현재의 사용자에게 있는 경우 true를 반환합니다. 그렇지 않은 경우 false를 반환합니다. |
| rules_exist | 이 개체가 대표하는 권한 결과가 명시적으로 정의된 권한 규칙의 결과인 경우 true를 반환합니다. 명시적으로 정의된 권한이 없을 때 기본 결과인 경우 false를 반환합니다. |
재귀 관계
엔터티에 대한 재귀(즉, 자가 참조적)인 관계를 로드하려는 시도는 다음 특성을 가진 개체로 반환됩니다.
| 특성 | 설명 |
|---|---|
| is_reflexive | true를 반환합니다. 관계가 반환한 개체가 재귀 관계 개체인 경우인지 테스트하는 데 사용될 수 있습니다. |
| referenced | 특정 관계에 대해 참조된 엔터티 전체를 반환합니다. |
| referencing | 특정 관계에 대해 참조된 테이블을 반환합니다. 참조 테이블이 존재하지 않는 경우 null을 반환합니다. 관계가 다수 대 다수(N:N)인 경우, 참조 엔터티 전체를 반환합니다. |
entitylist
entitylist 객체는 Power Apps Dataverse 테이블 태그 내에서 사용됩니다. 주어진 목록의 모든 특성에 대한 액세스를 제공합니다.
특성
참고
| 특성 | 설명 |
|---|---|
| create_enabled | 목록을 위해 새 레코드 만들기가 구성된 경우 참을 반환합니다. 그렇지 않은 경우 false를 반환합니다. |
| create_url | 목록의 만들기 링크/버튼을 위해 구성된 URL 경로를 반환합니다. |
| detail_enabled | 개별 레코드의 세부 정보 보기가 목록을 위해 구성되어 있는 경우 참을 반환합니다. 그렇지 않은 경우 false를 반환합니다. |
| detail_id_parameter | 레코드 세부 정보 보기 URL을 작성할 때 레코드 ID에 사용할 쿼리 문자열 매개 변수 이름을 반환합니다. 유동 필터를 사용하여 URL을 작성하는 데 대한 자세한 내용은 URL 필터를 참조하십시오. 예: id |
| detail_label | 목록의 세부 정보 보기 링크/버튼을 위해 구성된 지역화된 레이블을 반환합니다. |
| detail_url | 목록의 세부 정보 보기 링크/버튼을 위해 구성된 URL 경로를 반환합니다. |
| empty_list_text | 목록 보기에 결과가 반환되지 않을 때 표시하도록 구성된 지역화된 텍스트를 반환합니다. |
| enable_entity_permissions | 테이블 권한 필터링이 이 엔터티 목록에 사용된 경우 참을 반환합니다. 그렇지 않은 경우 false를 반환합니다. |
| entity_logical_name | 이 목록으로 표시되는 레코드의 Power Apps 테이블 논리 이름을 반환합니다. 예: contact |
| filter_account_attribute_name | 현재 포털 사용자의 상위 계정으로 결과 레코드를 필터링하는 데 사용할 거래처에 대한 조회를 위해 특성 논리 이름을 반환합니다. 예: accountid |
| filter_apply_label | 목록 결과에 고급 특성 필터를 적용하는 링크/버튼에 사용하도록 구성된 지역화된 레이블을 반환합니다. |
| filter_definition | 목록의 JSON 특성 필터 정의를 반환합니다. metafilters 유동 필터를 사용하여 이 정의를 처리하는 방법에 대한 자세한 내용은 엔터티 목록 필터를 참조하세요. |
| filter_enabled | 고급 특성 필터링이 목록에 사용되는 경우 참을 반환합니다. 그렇지 않은 경우 false를 반환합니다. |
| filter_portal_user_attribute_name | 현재 포털 사용자의 거래처로 결과 레코드를 필터링하는 데 사용할 연락처에 대한 조회를 위해 특성 논리 이름을 반환합니다. 예: contactid |
| filter_website_attribute_name | 현재 포털 웹 사이트로 결과 레코드를 필터링하는 데 사용할 adx_website에 대한 조회를 위해 특성 논리 이름을 반환합니다. 예: adx_websiteid |
| language_code | 이 목록의 모든 지역화된 레이블을 선택하는 데 사용될 Power Apps 정수 언어 코드를 반환합니다. |
| page_size | 목록의 구성된 결과 페이지 크기를 반환합니다. |
| primary_key_name | 이 목록으로 표시되는 레코드의 기본 키 특성 논리 이름을 반환합니다. |
| search_enabled | 검색이 이 목록에 사용된 경우 참을 반환합니다. 그렇지 않은 경우 false를 반환합니다. |
| search_placeholder | 목록 검색 필드 자리 표시자를 위해 구성된 지역화된 텍스트를 반환합니다. |
| search_tooltip | 목록 검색 도구 설명을 위해 구성된 지역화된 텍스트를 반환합니다. |
| 보기 | 목록 보기 개체로서 목록에 사용할 수 있는 보기를 반환합니다. |
| [특성 논리적 이름] | 테이블 개체와 동일하게 논리적 이름별로 엔터티 목록(adx_entitylist) Power Apps 레코드의 특성에 액세스할 수 있습니다. 예: {{ entitylist.adx_name }} |
목록 보기 특성
| 특성 | 설명 |
|---|---|
| 열 | 목록 보기 열 개체로서 해당 보기의 열을 반환합니다. |
| entity_logical_name | 보기에 포함된 레코드의 Power Apps 테이블 논리 이름을 반환합니다. 예: contact |
| Id | 보기의 GUID ID를 반환합니다. |
| language_code | 보기에 대해 모든 지역화된 레이블(열 머리글 등)을 선택하는 데 사용될 Power Apps 정수 언어 코드를 반환합니다. |
| 이름 | 보기의 Power Apps 디스플레이 이름을 반환합니다. |
| primary_key_logical_name | 보기에 포함된 레코드의 Power Apps 테이블 기본 키 논리 이름을 반환합니다. 예: contactid |
| sort_expression | 보기의 기본 정렬 식을 반환합니다. 예: name ASC, createdon DESC |
목록 보기 열 특성
| 특성 | 설명 |
|---|---|
| attribute_type | 열의 Power Apps 특성 유형 이름을 문자열로 반환합니다. 예: Lookup, Picklist, String, Boolean, DateTime |
| logical_name | 열의 Power Apps 특성 논리 이름을 반환합니다. 예: createdon |
| 이름 | 열의 지역화된 Power Apps 디스플레이 이름을 반환합니다. 예: Created On |
| sort_ascending | 열을 오름차순으로 정렬하기 위한 정렬 식 문자열을 반환합니다. 예: createdon ASC |
| sort_descending | 열을 내림차순으로 정렬하기 위한 정렬 식 문자열을 반환합니다. 예: createdon DESC |
| sort_disabled | 열에서 정렬을 사용하지 않는 경우 true를 반환합니다. 그렇지 않은 경우 false를 반환합니다. |
| sort_enabled | 열에서 정렬을 사용하는 경우 true를 반환합니다. 그렇지 않은 경우 false를 반환합니다. |
| width | 열의 구성된 너비를 픽셀 단위로 반환합니다. |
entityview
entityview 개체는 엔터티 보기 태그 내에서 사용되며, 결과 레코드 보기를 포함한 보기에 대한 메타데이터에 대한 액세스를 제공합니다.
특성
| 특성 | 설명 |
|---|---|
| 열 | 테이블 보기 열 개체로서 해당 보기에 열을 반환합니다. |
| entity_permission_denied | 현재 사용자에게 충분한 테이블 권한이 없기 때문에 결과 보기에 대한 액세스가 거부된 경우 참을 반환합니다. 결과 보기에 대한 읽기 액세스 권한이 부여되면 false를 반환합니다. |
| entity_logical_name | 결과 보기 레코드의 Power Apps 테이블 논리 이름입니다. 예: contact |
| first_page | 결과 보기 첫 페이지의 페이지 번호입니다. 반환된 결과가 없는 경우 1이며, 이 경우 null입니다. |
| Id | 이 entityview를 정의하는 Power Apps 보기의 GUID ID입니다. |
| language_code | 현재 보기에 대해 현지화된 레이블을 로드하는 데 사용되는 Power Apps 정수 언어 코드입니다. |
| last_page | 결과 보기 마지막 페이지의 페이지 번호입니다. 반환된 결과가 없다면 null입니다. |
| 이름 | 이 entityview를 정의하는 Power Apps 보기의 이름입니다(예: 활성 연락처). |
| next_page | 결과 보기의 다음 페이지의 페이지 번호입니다. 다음 페이지의 결과가 없는 경우 null입니다. |
| 페이지 | 결과 보기의 현재 페이지의 페이지 번호입니다. |
| 모든 페이지 | 현재 보기에 대해 모든 페이지 결과를 포함하는 페이지 번호의 배열을 반환합니다. |
| page_size | 현재 보기에 대해 페이지당 반환되는 결과의 수입니다. |
| previous_page | 결과 보기의 다음 페이지의 페이지 번호입니다. 이전 페이지의 결과가 없는 경우 null입니다. |
| primary_key_logical_name | 이 보기에 대한 결과 테이블의 기본 키 특성의 Power Apps 논리 이름입니다. 예: contactid |
| 레코드 | 테이블 개체로서 해당 보기에 대한 결과 레코드의 현재 페이지입니다. |
| sort_expression | 보기에 대한 기본 정렬 식입니다. 예: nameASC, createdon DESC |
| total_pages | 보기에 대한 총 결과 페이지 수입니다. |
| total_records | (모든 페이지에 걸친) 보기에 대한 총 결과 수입니다. |
events
이벤트에 액세스하고 이벤트를 렌더링하는 기능을 제공합니다. events 개체를 사용하여 특정 이벤트 또는 모든 이벤트를 선택할 수 있습니다.
events 개체
events 개체로 (이벤트에 관계 없이) 포털에서 특정 이벤트 또는 모든 이벤트에 액세스할 수 있습니다.
events 개체에는 다음과 같은 특성이 있습니다.
| 특성 | 설명 |
|---|---|
| occurences | 포털에 모든 이벤트 발생을 포함하는 eventoccurancessobject를 반환 |
| [이벤트 이름 또는 ID] | 이름 또는 ID 속성으로 어떤 이벤트에든 액세스할 수 있습니다. {% assign event = events["이벤트 이름"] %} {% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
event 개체
event 개체를 사용하여 특정 이벤트의 일정 및 항목에 액세스하는 등 단일 이벤트에 대한 조작이 가능합니다.
event 개체에는 다음과 같은 특성이 있습니다.
| 특성 | 설명 |
|---|---|
| 번 발생 | 이벤트에 대한 모든 발생을 포함하는 eventoccurrencesobject를 반환합니다. |
| 이름 | 이벤트의 이름입니다. |
| URL | 이벤트의 URL입니다. |
eventoccurences 개체
eventoccurrences 개체를 사용하여 이벤트 항목 개체의 모음에 액세스할 수 있습니다. 유동 필터를 사용하여 이벤트 항목을 정렬하고, 검색할 항목들에 대한 날짜 범위를 지정하고, 페이지를 찾을 수도 있습니다.
{% assign occurances = event.occurrences.from[today].to[advance_date] %}
다음 사항에 주의하십시오.
{% assign occurances = event.occurrences.min[today].max[advance_date] %}
또한 가능합니다.
다음의 특성들은 eventoccurrences 개체와 연관됩니다.
| 특성 | 설명 |
|---|---|
| 모두 | 컬렉션에 있는 모든 eventoccurance 개체를 반환합니다. |
eventoccurence 개체
단일 이벤트 항목을 나타냅니다. 관련된 특성은 다음과 같습니다.
| 특성 | 설명 |
|---|---|
| URL | 항목의 URL입니다. |
| is_all_day_event | 하루 종일 진행되는 이벤트입니까? |
| start_time | 이벤트의 시작 시간입니다. |
| end_time | 이벤트의 종료 시간입니다. |
forloop
for 루프 블록 내에서 유용하게 사용되는 속성을 포함하고 있습니다.
참고
forloop는 for 태그 내에서만 사용할 수 있습니다.
코드
{% for child in page.children %}
{% if forloop.first %}
This is the first child page!
{% else %}
This is child page number {{ forloop.index }}.
{% endif %}
{% endfor %}
출력
This is the first child page!
This is child page number 2.
This is child page number 3.
특성
| 특성 | 설명 |
|---|---|
| 첫째 | 루프의 첫 번째 반복인 경우 true를 반환합니다. 첫 번째 반복이 아닌 경우 false를 반환합니다. |
| 색인 | 모음에서 현재 항목의 위치, 이 때 첫 번째 항목은 1의 위치를 갖습니다. |
| index0 | 모음에서 현재 항목의 위치, 이 때 첫 번째 항목은 0의 위치를 갖습니다. |
| 마지막 | 루프의 마지막 반복인 경우 true를 반환합니다. 마지막 반복이 아닌 경우 false를 반환합니다. |
| length | 모음에서 반복되고 있는 항목의 수, 즉, 루프에 대한 반복의 수를 반환합니다. |
| rindex | 루프(길이 - 지수)에 남아 있는 항목의 수, 이 때 1은 마지막 항목의 지수입니다. |
| rindex0 | 루프(길이 - 지수)에 남아 있는 항목의 수, 이 때 0은 마지막 항목의 지수입니다. |
forums
포럼 및 포럼 스레드에 액세스하고 렌더링하는 기능을 제공합니다. 유동을 사용하여 포럼 데이터를 렌더링하는 기능을 게시물에도 사용할 수 있지만 새 게시물 또는 스레드를 만들기 위해서는 언급된 내장 기능(기본 포럼 스레드, 포럼 게시 페이지 템플릿 등)이 있는 ASP.NET 다단계 양식 페이지 템플릿을 사용해야 합니다.
포럼 개체를 사용하여 포럼 또는 포럼 스레드를 선택할 수 있습니다.
<div class=content-panel panel panel-default>
<div class=panel-heading>
<h4>
<span class=fa fa-comments aria-hidden=true></span>
{{ snippets[Home Forum Activity Heading] | default: Forum Activity | h }}
</h4>
</div>
{% for forum in website.forums %}
<ul class=list-group>
<li class=list-group-item>
<div class=row>
<div class=col-sm-6>
<h4 class=list-group-item-heading><a href="{{ forum.url | h }}"> {{ forum.name | h }}</a></h4>
<div class=list-group-item-text content-metadata>{{ forum.adx_description | h }}</div>
</div>
<div class=col-sm-3 content-metadata>{{ forum.thread_count }} threads</div>
<div class=col-sm-3 content-metadata>{{ forum.post_count }} posts</div>
</div>
</li>
</ul>
{% endfor %}
</div>
포럼 개체
포럼 개체로 포털의 특정 포럼에 액세스하거나 (이벤트에 관계 없이) 포털의 모든 포럼 스레드에 액세스할 수 있습니다.
forum 개체를 사용하여 단일 포럼에서 작업할 수 있으며 해당 포럼의 스레드에 액세스할 수 있습니다.
forumthreads 개체를 사용하여 forumthread 개체의 모음에 액세스할 수 있습니다. 유동 필터를 사용하여 포럼 스레드를 정렬하고 페이지 번호도 지정할 수 있습니다.
{% assign threads = forum.threads | order_by adx_name, desc | paginate: 0,4 | all %}
단일 포럼 스레드
forumposts 개체를 사용하여 forumpost 개체 컬렉션에 액세스할 수 있습니다.
특성
| 특성 | 설명 |
|---|---|
| threads | 포털의 모든 forumthread 개체를 포함하는 forumthreads 개체를 반환합니다. |
| 모두 | 포털의 모든 forum 개체를 반환합니다. 또한 website.forums도 등가입니다. |
| thread_count | 전체 웹 사이트에 있는 스레드 수의 정수 값을 반환합니다. |
| post_count | 포털에 있는 총 게시물 수의 정수 값을 반환합니다. |
| [포럼 이름 또는 ID] | 이름 또는 ID 속성으로 어떤 포럼에든 액세스할 수 있습니다. `{% assign forum = forums[Forum Name] %} {% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %} |
forum 개체
특성
참고
| 특성 | Description |
|---|---|
| threads | 포럼의 모든 포럼 스레드를 포함하는 forumthreads 개체를 반환합니다. |
| 이름 | 포럼의 이름입니다. |
| thread_count | 포럼에 있는 스레드 수의 정수 값을 반환합니다. |
| post_count | 전체 포럼에 있는 게시물 수의 정수 값을 반환합니다. |
forumthreads 개체
특성
| 특성 | 설명 |
|---|---|
| 모두 | 컬렉션에 있는 모든 forumthread 개체를 반환합니다. |
forumthread 개체
특성
참고
| 특성 | 설명 |
|---|---|
| posts | 스레드의 모든 포럼 게시물을 포함하는 forumposts 개체를 반환합니다. |
| author | 스레드의 작성자(단순히 연락처 테이블 개체)를 반환합니다. |
| latest_post | 스레드의 최신 게시물을 반환합니다. |
| first_post | 스레드의 첫 번째 게시물을 반환합니다. |
| post_count | 스레드에 있는 게시물 수의 정수 값을 반환합니다. |
| is_answered | 스레드가 답변되었습니까? |
| is_sticky | 스레드가 고정 스레드입니까? |
forumposts 개체
특성
| 특성 | 설명 |
|---|---|
| 모두 | 컬렉션에 있는 모든 forumthread 개체를 반환합니다. |
단일 포럼 게시물
특성
참고
| 특성 | 설명 |
|---|---|
| author | 게시물의 작성자(단순히 연락처 테이블 개체)를 반환합니다. |
| content | 게시물의 내용입니다. |
| is_answer | 이 게시물이 스레드에 대한 답입니까? |
지식
Power Apps 참조 자료 및 범주 테이블 레코드에 대한 액세스를 제공하여 포털에서 기사와 범주를 렌더링합니다.
특성
| 특성 | 설명 |
|---|---|
| 기사 | 포털에서 사용할 수 있는 참조 문서 테이블 레코드에 대한 기사 개체가 포함된 기사 개체를 반환합니다. |
| 범주 | 포털에서 사용할 수 있는 범주 테이블 레코드에 대한 범주 개체가 포함된 범주 개체를 반환합니다. |
기사 개체
기사 개체를 사용하여 기사 개체 모음에 액세스할 수 있습니다. 유동 필터를 사용하여 기사를 정렬하고 페이지 번호도 지정할 수 있습니다.
{% assign count = count | default: 3 %}
{% assign languagecode = website.selected_language.code %}
{% assign popular_articles = knowledge.articles | popular: count,languagecode %}
{% if popular_articles %}
<div class=list-group>
{% for article in popular_articles %}
<div class=list-group-item clearfix>
<a class=title href={{ article.url | escape }}>{{ article.title | escape }}</a>
<p class=description>{{ article.description | escape }}</p>
</div>
{% endfor %}
</div>
{% endif %}
특성
| 특성 | 설명 |
|---|---|
| 인기 | 가장 많은 뷰가 포함된 기사 개체의 모음을 반환합니다. {% assign popular_articles = knowledge.articles.popular %} |
| 최근 | 최근 수정일이 포함된 기사 개체의 모음을 반환합니다. {% assign recent_articles = knowledge.articles.recent %} |
| 최고 | 최고 등급이 포함된 기사 개체의 모음을 반환합니다. {% assign top_articles = knowledge.articles.top %} |
필터
다음 필터는 페이지 크기 및 언어에 대한 선택적 항목을 수락할 수 있습니다. 첫 번째 항목은 검색할 숫자 또는 레코드입니다. 기본 페이지 크기는 5입니다. 두 번째 항목은 특정 언어에 대한 기사를 검색하기 위한 언어 코드입니다. 필터는 다른 유동 필터와 결합될 수 있습니다.
{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}
| 특성 | 설명 |
|---|---|
| 인기 | 가장 많은 뷰가 포함된 기사 개체의 모음을 반환합니다. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %} |
| 최근 | 최근 수정일이 포함된 기사 개체의 모음을 반환합니다. {% assign recent_articles = knowledge.articles \| recent: 5 %} |
| 최고 | 최고 등급이 포함된 기사 개체의 모음을 반환합니다. {% assign top_articles = knowledge.articles \| top: 3, en-US %} |
범주 개체
범주 개체를 사용하여 범주 개체 모음에 액세스할 수 있습니다. 유동 필터를 사용하여 범주의 순서를 정하고 페이지를 매길 수도 있습니다.
{% assign category_url = sitemarkers['Category'].url %}
{% assign count = count | default: 0 %}
{% assign categories = knowledge.categories | top_level: count %}
{% if categories %}
<div class=list-group unstyled>
{% for category in categories %}
<a href={{ category_url | add_query: 'id', category.categorynumber }} class=list-group-item>
{{ category.title }}
</a>
{% endfor %}
</div>
{% endif %}
특성
| 특성 | 설명 |
|---|---|
| 최근 | 최근 수정일이 포함된 범주 개체의 모음을 반환합니다. |
| top_level | 상위 범주가 없는 범주 개체의 모음을 반환합니다. |
필터
다음 필터는 페이지 크기를 표시하는 선택적 항목을 수락할 수 있습니다. 기본 페이지 크기는 5입니다. 필터는 다른 유동 필터와 결합될 수 있습니다.
{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
| 특성 | 설명 |
|---|---|
| 최근 | 최근 수정일이 포함된 범주 개체의 모음을 반환합니다. 매개 변수 {% assign recent_categories = knowledge.categories \| recent: 10 %}을(를) 제공할 수 있습니다. |
| top_level | 상위 범주가 없는 범주 개체의 모음을 반환합니다. {% assign root_categories = knowledge.categories \| top_level %} |
기사 개체
기사 개체를 사용하면 단일 참조 자료로 작업하여 포털에서 해당 기사의 세부 사항을 표시할 수 있습니다.
특성
기사는 아래에 나열된 속성 이외에 모두 동일한 속성을 가진 엔터티 개체입니다.
| 특성 | 설명 |
|---|---|
| article_public_number | 기사의 공개 번호. |
| comment_count | 특정 기사에 달린 댓글 수의 정수값을 반환합니다. |
| content | 기사 내용. |
| current_user_can_comment | 현재 사용자가 기사에 대한 코멘트를 추가할 수 있는지의 여부를 나타내는 부울 값을 반환합니다. |
| is_rating_enabled | 기사의 등급이 활성화되는지의 여부를 나타내는 부울 값을 반환합니다. |
| 키워드 | 기사의 키워드. |
| 이름 | 기사의 제목에 대한 대체 별칭. |
| 등급 | 기사의 10진수 등급 값. |
| title | 문서의 제목입니다. |
| view_count | 기사가 열람된 횟수의 정수값. |
범주 개체
범주 개체를 사용하면 단일 범주로 작업하여 포털에서 그 세부 사항을 표시할 수 있습니다.
특성
범주는 아래에 나열된 속성 이외에 모두 동일한 속성을 가진 엔터티 개체입니다.
| 특성 | 설명 |
|---|---|
| 범주 번호 | 범주의 번호. |
| 이름 | 범주의 제목에 대한 대체 별칭. |
| 제목 | 범주의 제목. |
언어
다국어 지원을 사용할 수 있는 경우 현재 언어 이름과 언어 코드를 제공합니다.
특성
| 특성 | 설명 |
|---|---|
| URL | 현재 언어 코드가 앞에 표시된 현재 요청 URL입니다. |
| url_substitution | 페이지 출력 캐시를 우회하는 현재 언어 코드가 앞에 표시된 현재 요청 URL입니다. |
| 이름 | 현재 언어의 제목입니다. |
| 코드 | 언어의 언어 코드입니다. |
예를 들어 언어 드롭 다운 웹 템플릿은 기본적으로 이 유동 개체를 사용하여 여러 언어를 사용할 수 있는 경우 사용 가능한 언어를 나열합니다.
페이지
현재 포털 요청 페이지를 참조합니다. 이 개체는 sitemap과 현재 요청 entities(일반적으로 웹 페이지)의 특성을 결합합니다.
페이지 개체는 현재 페이지의 이동 경로, 현재 페이지의 제목 또는 URL, 그리고 기본 Power Apps 레코드의 기타 특성 또는 관련된 엔터티에 대한 액세스를 제공합니다.
<ul class=breadcrumb>
{% for crumb in page.breadcrumbs %}
<li><a href={{ crumb.url | escape }}>{{ crumb.title | escape }}</a></li>
{% endfor %}
<li class=active>{{ page.title | escape }}</li>
</ul>
<div class=page-header>
<h1>{{ page.title | escape }}</h1>
</div>
<div class=page-copy>
{{ page.adx_copy }}
</div>
<div class=list-group>
{% for child in page.children %}
<a class=list-group-item href={{ child.url | escape }}>
{{ child.title | escape }}
</a>
{% endfor %}
</div>
<!-- Page {{ page.id }} was last modified on {{ page.modifiedon }}. -->
페이지 특성
참고
| 특성 | 설명 |
|---|---|
| breadcrumbs | 사이트 맵 루트 노드에서 시작하여 상위에서 끝나는 페이지에 대한 이동 경로 사이트 맵 노드 개체를 반환합니다. |
| children | 페이지에 대한 하위 사이트 맵 노드 개체를 반환합니다. |
| parent | 페이지에 대한 상위 사이트 맵 노드를 반환합니다. 페이지가 홈 페이지인 경우 상위는 null이 됩니다. |
| title | 페이지의 제목입니다. |
| url | 페이지 URL |
| [특성 또는 관계 이름] | 논리 이름으로 페이지의 기본 Power Apps 레코드의 모든 특성에 액세스할 수 있습니다.{{ page.createdon }}{% assign attribute_name = 'name' %}{{ page[attribute_name] }}대부분의 테이블 특성들의 값은 직접 유동 유형에 매핑됩니다. 두 옵션 필드는 부울에, 텍스트 필드는 문자열에, 숫자/통화 필드는 숫자에, 날짜/시간 필드는 날짜 개체에 매핑됩니다. 그러나 일부 특성 유형은 다음 개체로 반환됩니다.
{{ page.adx_webpage_entitylist.adx_name }}재귀 관계인 경우(즉, 자체 참조) entities 개체가 반환됩니다. (그렇지 않으면, 결과가 애매모호할 것입니다.) {{ page.adx_webpage_webpage.referencing.adx_name }} 참고: 단일 템플릿에서 큰 수의 관련 엔터티를 로드하거나 큰 수의 관계에 액세스하는 것은 템플릿 렌더링 수행에 부정적 영향을 미칠 수 있습니다. 한 루프 내에서 연속으로 각 항목의 관련 엔터티 로드를 피하십시오. 가능하면 엔터티 컬렉션을 로드하기 위해 Power Apps Dataverse 테이블 태그를 사용하세요. |
polls
설문 조사에 액세스하고 렌더링하는 기능을 제공합니다.
polls 개체를 사용하면 특정 설문 조사 또는 설문 조사 배치를 선택할 수 있습니다.
<div>
{% assign poll = polls[Poll Name] %}
<h4>{{ poll.question }}</h4>
{% for option in poll.options %}
<div>
<input type=radio name={{ poll.name }} id={{ option.id }} />
<label for={{ option.id }}>{{ option.answer }}</label>
</div>
{% endfor %}
<button type=button>{{ poll.submit_button_label }}</button>
</div>
설문 조사 특성
| 특성 | 설명 |
|---|---|
| placements | pollplacements 개체를 반환합니다. |
| [설문 조사 이름 또는 ID] | 이름 또는 ID 속성으로 어떤 설문 조사에든 액세스할 수 있습니다. {% assign poll = polls[Poll Name] %}{% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %} |
설문 조사 배치 특성
| 특성 | 설명 |
|---|---|
| [설문 조사 배치 이름 또는 ID] | 이름 또는 ID 속성으로 어느 설문 조사 배치에든 액세스할 수 있습니다.{% assign placement = polls.placements[Placement Name or Id] %}{% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %} |
설문 조사 배치 특성
참고
| 특성 | 설명 |
|---|---|
| 이름 | 설문 조사 배치를 위한 이름 필드를 반환합니다. |
| placement_url | 템플릿으로 완전히 렌더링된 설문 조사 배치를 검색하는 데 사용할 수 있는 URL입니다. |
| 설문 조사 | 배치와 관련된 poll 개체의 컬렉션을 반환합니다. 반복 태그 및 배열 필터는 이 모음과 함께 사용할 수 있습니다. |
| random_url | 템플릿으로 완전히 렌더링된 배치에서 무작위 설문을 검색하는 데 사용할 수 있는 URL입니다. |
| submit_url | 완료된 설문이 전송되는 URL입니다. |
설문 조사 특성
참고
| 특성 | 설명 |
|---|---|
| has_user_voted | 현재 사용자(로그인했거나 익명)가 이미 이 설문 조사에 투표한 경우 true를 반환합니다. |
| 이름 | 설문 조사의 이름 필드를 반환합니다. |
| options | 설문 조사와 관련된 설문 조사 옵션 개체의 컬렉션을 반환합니다. 반복 태그 및 entities는 이 모음과 함께 사용할 수 있습니다. |
| poll_url | 템플릿으로 완전히 렌더링된 설문 조사를 검색하는 데 사용할 수 있는 URL입니다. |
| 질문 | 설문 조사를 위한 질문 필드를 반환합니다. |
| submit_button_label | 설문 조사를 위한 제출 단추 레이블을 다시 정의하는 데 사용할 수 있는 문자열을 반환합니다. |
| submit_url | 완료된 설문이 전송되는 URL입니다. |
| user_selected_option | (이미 투표한 경우)사용자가 선택한 polloption 개체를 반환합니다. |
| votes | 설문 조사를 위해 표로 만들어진 투표의 수를 반환합니다. |
설문 조사 옵션 특성
참고
| 특성 | 설명 |
|---|---|
| answer | 설문 조사를 위한 답변 필드를 반환합니다. |
| percentage | 옵션에 대한 설문 조사에서 투표의 비율을 0~100의 10진수로 반환합니다. |
| votes | 옵션을 위해 표로 만들어진 투표의 수를 반환합니다. |
요청
현재 HTTP 요청에 대한 정보가 담겨 있습니다.
{% assign id = request.params['id'] | escape %}
<a href={{ request.url | add_query: 'foo', 1 | escape }}>Link</a>
참고
- URL 필터를 이용하여 동적으로 유동 URL을 구축할 수 있습니다.
- request.url에 사용된 URL은 요청된 값이 될 수 있으며 후속 요청에 대해 캐시됩니다. request.url의 올바른 값을 보장하려면 대체 태그, ~{WebFile 경로}와 같은 부분 URL을 사용하거나 사이트 설정에 포털 URL을 저장하십시오.
- Power Apps 포털 릴리스 버전 9.3.8.x 이상에는 기본적으로 escape Liquid가 있습니다. 사용자 및 요구 Liquid 개체에 필터가 적용되었습니다. 이 기본 구성을 사용 중지하고 이 유동적 개체를 이스케이프 유동 필터 없이 허용하려면 포털 사이트 설정 - 사이트/EnableDefaultHtmlEncoding를 참조하십시오.
특성
| 특성 | 설명 |
|---|---|
| params | 현재 요청에 대한 명명된 매개 변수 값입니다. params는 URL 쿼리 연산자 매개 변수, 양식 게시물 매개 변수, 그리고 쿠키의 조합입니다. |
| 경로 | 현재 요청 URL의 경로입니다. /profile/ |
| path_and_query | 현재 요청 URL의 경로 및 쿼리입니다. /profile/?foo=1&bar=something |
| 쿼리 | 현재 요청 URL의 쿼리 일부입니다. ?foo=1&bar=something |
| URL | 현재 요청의 전체 URL입니다. https://www.example.com/profile/?foo=1&bar=something |
색인 검색
searchindex 개체는 Power Apps Dataverse 테이블 태그 내에서 사용되며, 쿼리 결과 접근권을 제공합니다.
{% searchindex query: 'support', page: params.page, page_size: 10 %}
{% if searchindex.results.size > 0 %}
<p>Found about {{ searchindex.approximate_total_hits }} matches:</p>
<ul>
{% for result in searchindex.results %}
<li>
<h3><a href={{ result.url | escape }}>{{ result.title | escape }}</a></h3>
<p>{{ result.fragment }}</p>
</li>
{% endfor %}
</ul>
{% else %}
<p>Your query returned no results.</p>
{% endif %}
{% endsearchindex %}
특성
| 특성 | 설명 |
|---|---|
| approximate_total_hits | 색인 쿼리에 일치하는 총 적중의 대략 수를 반환합니다. 보안 필터링 및 기타 설계 요인과 관련하여 검색 색인이 작동하는 방식으로 인해, 이 숫자는 근사치일 뿐이며 일부 상황에서는 현재 사용자에게 제공되는 결과의 총 수와 정확하게 일치하지 않을 수 있습니다. |
| 페이지 | 현재 쿼리의 페이지 수를 반환합니다. |
| page_size | 현재 쿼리의 최대 페이지 크기를 반환합니다. 현재 페이지에 대해 반환된 결과의 실제 수를 원하는 경우(이것이 표시된 최대 페이지 크기보다 작을 수 있으므로) results.size를 사용하십시오. |
| 결과 | 검색 색인 결과 개체로서의 쿼리 결과 페이지를 반환합니다. |
검색 색인 결과
| 특성 | 설명 |
|---|---|
| 엔터티 | 결과의 기저 entities. |
| fragment | <em> HTML 태그를 사용하여 강조 표시된 지정된 쿼리와 일치하는 조건을 포함한 결과에 대한 관련 짧은 텍스트 조각. 퍼지 쿼리(~) 및 와일드카드 쿼리(*)와 같은 특정 타입의 쿼리는 강조 표시된 조각을 지원하지 않습니다. 그러한 경우에 이 속성은 널값입니다. |
| ID | 문자열로서의 결과를 위한 기저 레코드의 Power Apps 테이블 ID입니다. 예: 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| logical_name | 결과를 위한 기저 레코드의 Power Apps 테이블 논리적 이름입니다. 예: adx_webpage |
| 번호 | 모든 결과 페이지에 걸친 결과의 수, 1에서 시작. 예컨대, 페이지 크기가 10인 결과의 두 번째 페이지의 첫 번째 결과의 경우, 이 값은 11입니다. |
| score | 부동점 값으로서의 결과의 루씬 점수. 결과는 이 값 순서로 반환됩니다. |
| title | 결과의 제목. |
| URL | 결과의 URL. 이는 전체 URL이기 보다는 일반적으로 현재 응용 프로그램의 절대 경로이지만—반드시 그렇지는 않습니다—. 예: /articles/article1/ |
설정
이름을 사용하여 모든 사이트 설정을 로드할 수 있습니다. 주어진 이름의 설정을 찾지 못한 경우 null 이 반환됩니다.
{{ settings[My Setting] }}
{% assign search_enabled = settings[Search/Enabled] | boolean %}
{% if search_enabled %}
Search is enabled.
{% endif %}
{% assign pagesize = settings['page size'] | integer | default: 10 %}
{% if pagesize > 10 %}
Page size is greater than 10.
{% endif %}
sitemap
포털 사이트 맵에 대한 액세스를 허용합니다.
<h1>{{ sitemap.root.title }}</h1>
<ul class=breadcrumb>
{% for crumb in sitemap.current.breadcrumbs %}
<li><a href={{ crumb.title }}>{{ crumb.title }}</a></li>
{% endfor %}
<li class=active>{{ sitemap.current.title }}</li>
</ul>
{% for child in sitemap.current.children %}
<a href={{ child.url }}>{{ child.title }}</a>
{% endfor %}
It's also possible to load a site map node by URL path:
{% assign node = sitemap[/content/page1/] %}
{% if node %}
{% for child in node.children %}
<a href={{ child.url }}>{{ child.title }}</a>
{% endfor %}
{% endif %}
사이트 맵 특성
| 특성 | 설명 |
|---|---|
| 현재 | 현재 페이지에 대한 사이트 맵 노드 개체를 반환합니다. |
| 루트 | 웹 사이트의 루트(홈) 페이지에 대한 사이트 맵 노드 개체를 반환합니다. |
사이트 맵 노드 특성
| 특성 | 설명 |
|---|---|
| 이동 경로 | 사이트 맵 루트 노드에서 시작하여 상위에서 끝나는 노드에 대한 이동 경로 사이트 맵 노드 개체를 반환합니다. |
| 하위 | 노드에 대한 하위 사이트 맵 노드 개체를 반환합니다. |
| 설명 | 노드에 대한 설명/요약 내용입니다. (이 필드는 HTML을 포함할 수 있습니다.) |
| 엔터티 | 노드의 기본 entities를 반환합니다. 노드에 기본 테이블이 없는 경우, 이 값은 null입니다. |
| is_sitemap_ancestor | 사이트 맵 노드가 현재 노드의 상위인 경우 true를 반환합니다. 그렇지 않은 경우 false를 반환합니다. |
| is_sitemap_current | 사이트 맵 노드가 현재 노드인 경우 true를 반환합니다. 그렇지 않은 경우 false를 반환합니다. |
| 상위 | 노드에 대한 상위 사이트 맵 노드를 반환합니다. 노드가 루트 노드인 경우 상위는 null입니다. |
| 직책 | 노드의 제목입니다. |
| URL | 노드의 URL입니다. |
사이트 마커
이름을 사용하여 모든 사이트 마커를 로드할 수 있습니다. 사이트 마커가 존재하는 경우 사이트 마커 개체가 반환됩니다. 주어진 이름의 사이트 마커를 찾지 못한 경우 null 이 반환됩니다.
{{ sitemarkers[Login].url }}
{% assign my_sitemarker = sitemarkers["My Site Marker"] %}
{% if my_sitemarker %}
<a href={{ my_sitemarker.url }}>{{ my_sitemarker.adx_name }}</a>
{% else %}
Site marker My Site Marker does not exist.
{% endif %}
사이트 마커 특성
| 특성 | 설명 |
|---|---|
| URL | 사이트 마커 대상의 URL입니다. |
| [특성 논리적 이름] | 논리 이름을 사요아여 사이트 마커 대상 Power Apps 레코드의 모든 특성에 액세스할 수 있습니다. 예: {{ sitemarker.adx_name }} |
조각
콘텐츠 조각을 이름에 의해 로드할 수 있습니다. 주어진 이름의 코드 조각을 찾지 못한 경우 null이 반환됩니다.
{{ snippets[Header] }}
{% assign footer = snippets[Footer] %}
{% if footer %}
{{ footer }}
{% else %}
No footer snippet was found.
{% endif %}
tablerowloop
반복 태그 루프 블록 내에서 유용하게 사용되는 속성을 포함하고 있습니다.
참고
tablerowloop는 반복 태그 태그 내에서만 사용할 수 있습니다.
특성
| 특성 | 설명 |
|---|---|
| col | 1에서 시작하여 현재 행의 색인을 반환합니다. |
| col0 | 0에서 시작하여 현재 행의 색인을 반환합니다. |
| col_first | 현재 열이 행의 첫 번째 열인 경우 true를 반환하고, 그렇지 않은 경우에는 false를 반환합니다. |
| col_last | 현재 열이 행의 마지막 열인 경우 true를 반환하고, 그렇지 않은 경우에는 false를 반환합니다. |
| 처음 | 루프의 첫 번째 반복인 경우 true를 반환합니다. 첫 번째 반복이 아닌 경우 false를 반환합니다. |
| 인덱스 | 모음에서 현재 항목의 위치, 이 때 첫 번째 항목은 1의 위치를 갖습니다. |
| index0 | 모음에서 현재 항목의 위치, 이 때 첫 번째 항목은 0의 위치를 갖습니다. |
| 마지막 | 루프의 마지막 반복인 경우 true를 반환합니다. 마지막 반복이 아닌 경우 false를 반환합니다. |
| 길이 | 모음에서 반복되고 있는 항목의 수, 즉, 루프에 대한 반복의 수를 반환합니다. |
| rindex | 루프(길이 - 지수)에 남아 있는 항목의 수, 이 때 1은 마지막 항목의 지수입니다. |
| rindex0 | 루프(길이 - 지수)에 남아 있는 항목의 수, 이 때 0은 마지막 항목의 지수입니다. |
user
현재 포털 사용자를 참조하여 기본 Power Apps 연락처 레코드의 모든 특성에 액세스할 수 있습니다. 로그인한 사용자가 없으면 이 변수는 null입니다.
사용자가 엔터티 개체입니다.
{% if user %}
Hello, {{ user.fullname | escape }}!
{% else %}
Hello, anonymous user!
{% endif %}
참고
Power Apps 포털 릴리스 버전 9.3.8.x 이상에는 기본적으로 escape Liquid가 있습니다. 사용자 및 요구 Liquid 개체에 필터가 적용되었습니다. 이 기본 구성을 사용 중지하고 이 유동적 개체를 이스케이프 유동 필터 없이 허용하려면 포털 사이트 설정 - 사이트/EnableDefaultHtmlEncoding를 참조하십시오.
특성
entity 개체의 모든 특성 외에도 user에는 다음과 같은 특성이 있습니다.
| 특성 | 설명 |
|---|---|
| 역할 | 사용자가 속한 역할을 배열로 반환합니다.{% if user.roles contains 'Administrators' %} User is an administrator. {% endif %}참고: has_role 필터를 사용하여 개별 역할 구성원 자격을 테스트할 수도 있습니다. |
| basic_badges_url | 사용자의 배지를 검색하는 서비스 url을 반환합니다. 사용자에 대 한 배지를 렌더링하려면 "데이터-배지" 및 "데이터-uri" 특성을 가진 태그를 포함해야 합니다. 현재 사용자의 배지를 렌더링하려면 다음을 수행합니다. <div data-badge data-uri='{{user.basic_badges_url }}'></div>id(가변 userid)별로 사용자 배치를 렌더링하려면: `<div data-badge data-uri='{{user.basic_badges_url |
웹 링크
이름 또는 ID로 모든 웹 링크를 로드할 수 있습니다.
웹 링크 세트가 존재하는 경우, 웹 링크 세트 개체가 반환될 것입니다. 주어진 이름 또는 ID의 웹 링크 세트를 찾지 못한 경우 null이 반환됩니다.
<!-- Load web link set by ID -->
{{ weblinks[page.adx_navigation.id].name }}
<!-- Load web link set by name -->
{% assign nav = weblinks[Primary Navigation] %}
{% if nav %}
<h1>{{ nav.title | escape }}</h1>
<ul>
{% for link in nav.weblinks %}
<li>
<a href={{ link.url | escape }} title={{ link.tooltip | escape }}>
{% if link.image %}
<img src={{ link.image.url | escape }} alt={{ link.image.alternate_text | escape }} />
{% endif %}
{{ link.name | escape }}
</a>
</li>
{% endfor %}
</ul>
{% endif %}
웹 링크 세트 특성
참고
웹 링크는 아래에 나열된 속성 이외에 모두 동일한 속성을 가진 엔터티 개체입니다.
| 특성 | 설명 |
|---|---|
| 복사 | 웹 링크 세트의 HTML 사본. |
| 이름 | 웹 링크 세트의 이름. |
| 직책 | 웹 링크 세트의 제목. |
| 웹 링크 | 웹 링크 세트와 연계된 웹 링크 개체군. |
| [특성 논리적 이름] | 논리적 이름으로 웹 링크 세트 Power Apps 레코드의 특성에 액세스할 수 있습니다. {{ weblinkset.createdon }}을 예로 들 수 있습니다. |
웹 링크 특성
참고
웹 링크는 아래에 나열된 속성 이외에 모두 동일한 속성을 가진 엔터티 개체입니다.
| 특성 | 설명 |
|---|---|
| 설명 | 웹 링크의 HTML 설명. |
| display_image_only | 웹 링크를 링크 텍스트 없이 이미지로서만 표시해야 하는지의 여부를 나타내는 부울 특성. |
| display_page_child_links | 웹 링크가 하위 링크로서의 링크된 페이지의 사이트 맵 하위 페이지에 대한 링크를 표시해야 하는지의 여부를 나타내는 부울 특성. |
| 이미지 | 이 링크를 위한 웹 링크 이미지 개체. 이미지가 존재하지 않는 경우 이 특성은 널값입니다. |
| is_external | 웹 링크의 목표 URL이 (내부 포털 페이지에 대한 것이 아닌) 외부 사이트에 대한 것인지의 여부를 나타내는 부울 특성. |
| is_sitemap_ancestor | 웹 링크의 URL이 현재 사이트 맵 노드의 상위를 참조하는 경우 true를 반환하고, 그렇지 않으면 false를 반환합니다. |
| is_sitemap_current | 웹 링크의 URL이 현재 사이트 맵 노드를 참조하는 경우 true를 반환하고, 그렇지 않으면 false를 반환합니다. |
| 이름 | 웹 링크의 이름/제목. |
| nofollow | 웹 링크를 rel=nofollow로 표시해야 하는지의 여부를 나타내는 부울 특성. |
| open_in_new_window | 웹 링크를 선택했을 때 새 브라우저 창/탭에서 열지 여부를 나타내는 부울 특성. |
| 도구 설명 | 웹 링크의 툴팁 제목. |
| URL | 웹 링크의 URL. |
| 웹 링크 | 웹 링크와 연계된 하위 웹 링크 개체군. |
| [특성 논리적 이름] | 논리적 이름으로 웹 링크 Power Apps 레코드의 특성에 액세스할 수 있습니다. {{ weblink.createdon }}을 예로 들 수 있습니다. |
웹 링크 이미지 특성
| alternate_text | 이미지에 대한 대체 텍스트. |
|---|---|
| 높이 | 이미지의 지정된 높이를 포함하는 정수. 높이 값이 제공되지 않은 경우, 이 특성은 널값입니다. |
| URL | 이미지의 URL. |
| 너비 | 이미지의 지정된 너비를 포함하는 정수. 너비 값이 제공되지 않은 경우, 이 특성은 널값입니다. |
웹 사이트
포털 웹 사이트를 참조하여 포털에 대한 Power Apps 웹 사이트(adx_website) 레코드의 모든 특성에 액세스할 수 있습니다.
참고
웹 사이트는 동일한 특성을 가진 엔터티 개체입니다.
코드
{{ website.adx_name }} ({{ website.id }})
출력
Community Portal (936DA01F-9ABD-4d9d-80C7-02AF85C822A8)
특성
다음 테이블에는 캐싱을 피하기 위해 기본값을 대체하는 데 사용할 수 있는 이 태그의 특성이 나열되어 있습니다.
| 기본 | 대체(캐싱 방지) | 예제 |
|---|---|---|
| sign_in_url | sign_in_url_substitution | 기본: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F 대체(캐싱 방지): website.sign_in_url_substitution: /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F (이 예에서 "대체 페이지"는 기본 캐시된 URL을 대체합니다.) |
| sign_out_url | sign_out_url_substitution | 기본: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F 대체(캐싱 방지): website.sign_out_url_substitution: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F (이 예에서 "대체 페이지"는 기본 캐시된 URL을 대체합니다.) |
참조
참고
귀사의 설명서 언어 기본 설정에 대해 말씀해 주시겠습니까? 간단한 설문 조사에 응해주세요. (이 설문 조사는 영어로 되어 있습니다.)
이 설문 조사는 약 7분 정도 걸립니다. 개인 데이터는 수집되지 않습니다(개인정보처리방침).
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기