แท็กของเอนทิตี Dataverse

หมายเหตุ

พอร์ทัล Power Apps คือ Power Pages โดยมีผลในวันที่ 12 ตุลาคม 2022 ข้อมูลเพิ่มเติม: Microsoft Power Pages มีให้ใช้งานทั่วไป (บล็อก)
ในไม่ช้าเราจะย้ายและรวมคู่มือพอร์ทัล Power Apps เข้ากับ คู่มือ Power Pages

แท็กของเอนทิตี Microsoft Dataverse ใช้เพื่อโหลด และแสดงข้อมูล Dataverse หรือใช้บริการในกรอบอื่น ๆ ของพอร์ทัล Power Apps แท็กเหล่านี้เป็นส่วนขยายเฉพาะของ Dataverse-ไปยังภาษาสภาพคล่อง

แผนภูมิ

เพิ่มแผนภูมิ Power Apps ไปที่หน้าเว็บ คุณสามารถเพิ่มแท็กแผนภูมิลงในฟิลด์คัดลอกบนหน้าเว็บหรือในฟิลด์แหล่งที่มาเทมเพลตเว็บ สำหรับขั้นตอนในการเพิ่มแผนภูมิ Power Apps ไปที่หน้าเว็บ ดูที่ เพิ่มแผนภูมิไปที่เว็บเพจในพอร์ทัล

{% chart id:"EE3C733D-5693-DE11-97D4-00155DA3B01E" viewid:"00000000-0000-0000-00AA-000010001006" %}

พารามิเตอร์

มีพารามิเตอร์สองอย่างในที่จะได้รับพร้อมแท็กแผนภูมิ: ID แผนภูมิและ ID มุมมอง

ID แผนภูมิ

การจัดรูปแบบการแสดง ID ของแผนภูมิ คุณสามารถหา ID แผนภูมิได้จากการส่งออกแผนภูมิ

ID มุมมอง

รหัสของตารางขณะเปิดในตัวแก้ไขมุมมอง

powerbi

เพิ่มแดชบอร์ด Power BI และรายงานภายในเพจ คุณสามารถเพิ่มแท็กในฟิลด์ คัดลอก บนหน้าเว็บ หรือในฟิลด์ แหล่งที่มา บนเท็มเพลตเว็บได้ สำหรับขั้นตอนในการเพิ่มรายงาน Power BI หรือแดชบอร์ดลงในเว็บเพจในพอร์ทัล ดูที่ เพิ่มรายงาน Power BI หรือแดชบอร์ดลงในเว็บเพจในพอร์ทัล

หมายเหตุ

ในการที่จะให้แท็กทำงาน คุณต้อง เปิดใช้งานการรวม Power BI จากศูนย์การจัดการพอร์ทัล Power Apps ถ้าไม่ได้เปิดการใช้งานการรวม Power BI แดชบอร์ดหรือรายงานจะไม่แสดงขึ้น

พารามิเตอร์

แท็ก powerbi ยอมรับพารามิเตอร์ต่อไปนี้:

พาธ

พาธของแดชบอร์ดหรือรายงาน Power BI ถ้ารายงาน Power BI หรือแดชบอร์ดมีความปลอดภัย คุณต้องระบุชนิดของการรับรองความถูกต้อง

{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}

authentication_type

ชนิดของการรับรองความถูกต้องที่จำเป็นสำหรับรายงาน Power BI หรือแดชบอร์ด ค่าที่ถูกต้องสำหรับพารามิเตอร์คือ:

• ไม่ระบุชื่อ ช่วยให้คุณสามารถฝังการเผยแพร่ไปยังรายงาน Power BI เว็บ ชนิดการรับรองความถูกต้องค่าเริ่มต้นคือไม่ระบุชื่อ เมื่อใช้ขนิดการรับรองความถูกต้องเป็นแบบไม่ระบุชื่อ คุณต้องรับURL รายงาน Power BI ตามที่อธิบายไว้ที่: เผยแพร่สู่เว็บจาก Power BI

• AAD : ช่วยให้คุณใช้รายงาน Power BI ที่มีความปลอดภัยหรือแดชบอร์ดไปที่ Power BI ผู้ใช้ที่ได้การรับรองความถูกต้องของ Azure Active Directory

• powerbiembedded ช่วยให้คุณสามารถใช้รายงาน Power BI ที่มีความปลอดภัยหรือแดชบอร์ดร่วมกันกับผู้ใช้ภายนอกที่ไม่มีสิทธิ์การใช้งาน Power BI หรือการตั้งค่าการรับรองความถูกต้องของ Azure Active Directory สำหรับข้อมูลเกี่ยวกับการตั้งค่าบริการของ Power BI Embedded ดูที่ เปิดใช้บริการ Power BI Embedded

ในขณะที่เพิ่มรายงาน Power BI หรือแดชบอร์ดที่ปลอดภัย ให้แน่ใจว่ามีการใช้ร่วมกับบริการของพอร์ทัล Azure Active Directory หรือ Power BI Embedded

หมายเหตุ

ค่าสำหรับพารามิเตอร์ authentication_type ต้องตรงตามตัวพิมพ์ใหญ่-เล็ก

{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}

คุณยังสามารถกรองรายงานในค่าอย่างน้อยหนึ่งค่าได้ ไวยากรณ์ที่จะกรองรายงานคือ:

URL?ตัวกรอง =ตาราง/ฟิลด์ eq 'ค่า'

ตัวอย่างเช่น สมมติว่าคุณต้องการกรองข้อมูลรายงานเมื่อต้องการดูข้อมูลสำหรับผู้ติดต่อที่มีชื่อว่า Bert Hair คุณต้องผนวก URL กับข้อมูลต่อไปนี้:

?ตัวกรอง = ผู้บริหาร/ผู้บริหาร eq 'Bert Hair'

รหัสเสร็จสมบูรณ์จะเป็น:

{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01?filter=Executives/Executive eq 'Bert Hair'" %}

ข้อมูลเพิ่มเติมเกี่ยวกับการกรองข้อมูลรายงาน: กรองรายงานโดยใช้พารามิเตอร์สตริงของแบบสอบถามใน URL

หมายเหตุ

รายงานแบบไม่ระบุชื่อไม่สนับสนุนการกรอง

คุณยังสามารถสร้างพาธแบบไดนามิกได้โดยใช้ capture ตัวแปรแบบไม่ตายตัวดังด้านล่าง:

{% capture pbi_path %}https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01?filter=Executives/Executive eq '{{user.id}}'{% endcapture %}
{% powerbi authentication_type:"AAD" path:pbi_path %}

ข้อมูลเพิ่มเติมเกี่ยวกับตัวแปรแบบไม่ตายตัว: แท็กตัวแปร

tileid

แสดงไทล์ที่ระบุของแดชบอร์ด คุณต้องระบุ ID ของไทล์

{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/dashboards/00000000-0000-0000-0000-000000000001" tileid:"00000000-0000-0000-0000-000000000002" %}

บทบาท

บทบาทที่ได้รับมอบหมายไปยังรายงาน Power BI พารามิเตอร์นี้ใช้งานได้เฉพาะเมื่อ authentication_type ของพารามิเตอร์ถูกตั้งค่าเป็น powerbiembedded

หากคุณได้กำหนดบทบาทไว้ใน Power BI และกำหนดให้กับรายงาน คุณต้องระบุบทบาทที่เหมาะสมในแท็ก Liquid ของ powerbi บทบาทช่วยให้คุณกรองข้อมูลที่จะแสดงในรายงาน คุณสามารถระบุได้หลายบทบาท โดยคั่นด้วยเครื่องหมายจุลภาค สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดบทบาทใน Power BI ให้ดู การรักษาความปลอดภัยระดับแถว (RLS) ด้วย Power BI

{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000000/ReportSection2" roles:"Region_East,Region_West" %}

หากคุณได้กำหนดบทบาทให้กับรายงาน Power BI และไม่ได้ระบุ บทบาท พารามิเตอร์ในแท็ก Liquid หรือไม่ได้ระบุบทบาทในพารามิเตอร์ ข้อผิดพลาดจะปรากฏขึ้น

เคล็ดลับ

หากคุณต้องการใช้บทบาทเว็บที่กำหนดไว้ในพอร์ทัลของคุณเป็นบทบาท Power BI คุณสามารถกำหนดตัวแปรและมอบหมายบทบาทเว็บให้กับมัน จากนั้นคุณสามารถใช้ตัวแปรที่กำหนดในแท็ก Liquid

สมมติว่าคุณได้กำหนดบทบาทเว็บสองบทบาทเป็น Region_East และ Region_West ในพอร์ทัลของคุณ คุณสามารถเข้าร่วมได้โดยใช้รหัส: {% assign webroles = user.roles | join: ", " %}

ในตัวอย่างรหัส snippet ข้างต้น webroles เป็นตัวแปรและบทบาทเว็บของ Region_East และ Region_West จะถูกเก็บไว้ในนั้น

ใช้ตัวแปร webroles ดังต่อไปนี้ในแท็ก Liquid

{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000000/ReportSection2" roles:webroles%}

สามารถแก้ไขได้

กำหนดออบเจ็กต์ CMS ของพอร์ทัล Power Apps เป็นสามารถแก้ไขได้บนพอร์ทัล สำหรับผู้ใช้ที่มีสิทธิ์แก้ไขเนื้อหาสำหรับออบเจ็กต์นั้น วัตถุที่สามารถแก้ไขได้รวมถึง เพจ, Snippet และ ลิงก์เว็บ

{% editable page 'adx_copy' type: 'html', title: 'Page Copy', escape: false, liquid: true %}

{% editable snippets Header type: 'html' %}

<!--

An editable web link set required a specific DOM structure, with

certain classes on the containing element, as demonstrated here.

-->

{% assign primary_nav = weblinks[Primary Navigation] %}

{% if primary_nav %}

<div {% if primary_nav.editable %}class=xrm-entity xrm-editable-adx_weblinkset{% endif %}>

<ul>

<!-- Render weblinks... -->

</ul>

{% editable primary_nav %}

</div>

{% endif %}

พารามิเตอร์

พารามิเตอร์แรกที่กำหนดให้แก้ไขได้คือ ออบเจ็กต์ที่แก้ไขได้ เช่น ชุดเว็บลิงก์ ส่วนย่อย หรือหน้าปัจจุบัน พารามิเตอร์ตัวเลือกลำดับที่สองมีไว้เพื่อระบุชื่อของแอตทริบิวต์หรือคีย์ภายในวัตถุนั้นที่จะสามารถถูกแสดง และแก้ไข ค่านี้อาจเป็นชื่อของแอตทริบิวต์ของตาราง หรือชื่อของส่วนย่อย เป็นต้น

หลังจากพารามิเตอร์เริ่มต้นเหล่านี้ แท็กสนับสนุนตัวเลือกพารามิเตอร์ที่ตั้งชื่อจำนวนมาก

คลาส

ระบุค่าแอตทริบิวต์ คลาส สำหรับองค์ประกอบรากที่แสดงตามแท็กนี้

ค่าเริ่มต้น

ค่าเริ่มต้นสามารถถูกแสดงในกรณีที่สินค้าที่แก้ไขได้ไม่มีค่า

Escape

ค่า Boolean ที่บ่งชี้ว่า ค่าที่แสดงตามแท็กนี้จะเข้ารหัส HTML หรือไม่ ค่านี้คือ เท็จ ตามค่าเริ่มต้น

ไม่ตายตัว

ค่า Boolean ที่บ่งชี้ว่า รหัสสภาพคล่องเทมเพลตใด ๆ ที่พบภายในค่าข้อความที่ถูกแสดงตามแท็กนี้จะสามารถถูกประมวลผลหรือไม่ ค่านี้คือ จริง ตามค่าเริ่มต้น

แท็ก

ชื่อของคอนเทนเนอร์แท็ก HTML ที่จะถูกแสดงตามแท็กนี้ แท็กนี้จะแสดงองค์ประกอบ div ตามค่าเริ่มต้น แนะนำให้คุณเลือกระหว่าง div หรือ span เป็นค่าสำหรับพารามิเตอร์นี้

ชื่อเรื่อง

ระบุป้ายชื่อสำหรับรายการที่สามารถแก้ไขได้นี้ภายในอินเทอร์เฟซการแก้ไขเนื้อหา ถ้าไม่มีการระบุใดๆ ป้ายชื่อที่เรียกใช้ง่ายจะถูกสร้างขึ้นโดยอัตโนมัติ

ชนิด

ค่าสตริงที่ระบุชนิดของอินเทอร์เฟซการแก้ไขจะถูกนำเสนอ สำหรับค่าข้อความที่สามารถแก้ไข ค่าที่ถูกต้องสำหรับพารามิเตอร์คือ html หรือ text html คือค่าเริ่มต้น

รายการเอนทิตี

โหลดรายการที่ได้ระบุไว้ ตามชื่อหรือรหัส จากนั้น คุณสมบัติของรายการสามารถถูกเข้าถึงได้โดยการใช้ ออบเจ็กต์รายการเอนทิตี ที่จะพร้อมใช้งานภายในบล็อกแท็ก ในการแสดงเรกคอร์ดผลลัพธ์ที่เกิดขึ้นจริงของรายการ ใช้แท็ก มุมมองเอนทิตี ภายในบล็อก

ถ้ารายการถูกโหลดเสร็จเรียบร้อยแล้ว เนื้อหาภายในบล็อกนี้จะถูกแสดง ถ้ารายการไม่ถูกพบ จะไม่สามารถแสดงเนื้อหาของบล็อกนี้

{% entitylist name:My List %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

โดยค่าเริ่มต้น วัตถุรายการเอนทิตีจะได้รับชื่อตัวแปร รายการเอนทิตี อีกทางหนึ่ง ชื่อตัวแปรที่แตกต่างกันสามารถถูกแสดง

{% entitylist my_list = name:My List %}

Loaded list {{ my_list.adx_name }}.

{% endentitylist %}

พารามิเตอร์

ให้ เพียงหนึ่งรายการ ของรหัส ชื่อ หรือ คีย์ เพื่อเลือกรายการเพื่อโหลด

รหัส

โหลดรายการโดยรหัส GUID id ต้องเป็นสตริงที่สามารถแยกวิเคราะห์เป็นแบบ GUID

{% entitylist id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

โดยทั่วไปแล้ว สตริง GUID สัญพจน์จะไม่สามารถใช้ได้ id จะถูกระบุโดยการใช้คุณสมบัติ GUID ของตัวแปรอื่นแทน

{% entitylist id:page.adx_entitylist.id %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

ชื่อ

โหลดรายการโดยชื่อ

{% entitylist name:My List %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

คีย์

โหลดรายการโดยรหัส หรือ ชื่อ ถ้าสามารถแยกวิเคราะห์ค่าคีย์ที่ถูกระบุไว้เป็นแบบ GUID ได้ รายการจะถูกโหลดโดยรหัส มิฉะนั้น จะถูกโหลดตามชื่อ

<!-- key_variable can hold an ID or name -->

{% entitylist key:key_variable %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

ภาษา_รหัส

รหัสภาษาจำนวนเต็ม Power Apps เพื่อเลือกรายการแปลป้ายเป็นภาษาท้องถิ่นเพื่อถูกโหลด ถ้าไม่มี ภาษา_รหัส จัดเตรียมไว้ จะใช้ภาษาเริ่มต้นของการเชื่อมต่อแอปพลิเคชันของพอร์ทัล Power Apps

{% entitylist name:"My List", language_code:1033 %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

มุมมองเอนทิตี

โหลดมุมมอง Power Apps ที่ได้ระบุไว้ ตามชื่อหรือรหัส คุณสมบัติของมุมมอง ߝ ดูเมตาดาต้าของคอลัมน์ เรกคอร์ดผลลัพธ์แบบแบ่งหน้า เป็นต้น จะสามารถได้รับการเข้าถึงโดยใช้ ออบเจ็กต์มุมมองเอนทิตี ที่จะพร้อมใช้งานภายในบล็อกแท็ก

ถ้ามุมมองถูกโหลดเสร็จเรียบร้อยแล้ว เนื้อหาภายในบล็อกนี้จะถูกแสดง ถ้าไม่พบมุมมอง จะไม่สามารถแสดงเนื้อหาของบล็อกนี้

{% entityview logical_name:'contact', name:"Active Contacts" %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

โดยค่าเริ่มต้น วัตถุรายการมุมมองเอนทิตีจะได้รับชื่อตัวแปร มุมมองเอนทิตี อีกทางหนึ่ง ชื่อตัวแปรที่แตกต่างกันสามารถถูกแสดง

{% entityview my_view = logical_name:'contact', name:"Active Contacts" %}

Loaded entity view with {{ my_view.total_records }} total records.

{% endentityview %}

ถ้า มุมมองเอนทิตี ซ้อนอยู่ภายในบล็อกรายการเอนทิตี จะสืบทอดการตั้งค่าคอนฟิกเริ่มต้น (ขนาดหน้าผลลัพธ์ ตัวกรอง ตัวเลือก เป็นต้น) จากรายการ ถ้าพารามิเตอร์ id หรือ ชื่อมุมมองไม่ถูกแสดงให้กับ มุมมองเอนทิตี จะโหลดมุมมองเริ่มต้นจากสิ่งที่ล้อมรอบ รายการเอนทิตี

{% entitylist id:page.adx_entitylist.id %}

{% entityview %}

Loaded default view of the list associated with the current page, with {{ entityview.total_records }} total records.

{% endentityview %}

{% endentitylist %}

พารามิเตอร์

ให้ อย่างใดอย่างหนึ่ง รหัส หรือ ทางตรรกะ_ชื่อ ที่มีชื่อ เพื่อเลือกมุมมอง Power Apps ที่จะโหลด ถ้าไม่แสดงให้ทั้งสองอย่าง และแท็กมุมมองเอนทิตีซ้อนอยู่ภายในแท็กรายการเอนทิตี มุมมองเริ่มต้นของสิ่งที่ล้อมรอบรายการเอนทิตีจะถูกโหลด

รหัส

id ต้องเป็นสตริงที่สามารถแยกวิเคราะห์เป็นแบบ GUID

{% entityview id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}

Loaded entity view {{ entityview.name }}.

{% endentityview %}

โดยทั่วไปแล้ว สตริง GUID สัญพจน์จะไม่สามารถใช้ได้ id จะถูกระบุโดยการใช้คุณสมบัติ GUID ของตัวแปรอื่นแทน

{% entityview id:request.params.view %}

Loaded entity view {{ entityview.name }} using view query string request parameter.

{% endentityview %}

ชื่อ_ตรรกะ

ชื่อตรรกะของ Power Apps เอนทิตีของมุมมองเพื่อถูกโหลด ต้องใช้ร่วมกับ ชื่อ

{% entityview logical_name:'contact', name:"Active Contacts" %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

ชื่อ

ชื่อของ Power Apps ของมุมมองเพื่อถูกโหลด ต้องใช้ร่วมกับ ตรรกะ_ชื่อ

{% entityview logical_name:'contact', name:"Active Contacts" %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

ตัวกรอง

ระบุว่า จะกรองมุมมองผลลัพธ์ โดยผู้ใช้หรือบัญชี ต้องมีค่าสตริงของผู้ใช้หรือบัญชี

{% entityview id:request.params.view, filter:'user' %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

กรณีการใช้ทั่วไปคือ การตั้งค่าพารามิเตอร์นี้ตาม คำขอ

{% entityview id:request.params.view, filter:request.params.filter %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

metafilter

ระบุนิพจน์ตัวกรองเมตาดาต้าของรายการเพื่อกรองมุมมองผลลัพธ์ พารามิเตอร์นี้จะใช้ได้เฉพาะเมื่อ มุมมองเอนทิตี ถูกใช้ร่วมกับรายการเอนทิตี ในกรณีส่วนใหญ่ พารามิเตอร์นี้ถูกตั้งค่าโดยยึดตาม คำขอ

{% entitylist id:page.adx_entitylist.id %}

{% entityview id:request.params.view, metafilter:request.params.mf %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

{% endentitylist %}

ใบสั่ง

ระบุนิพจน์การเรียงลำดับสำหรับการเรียงลำดับมุมมองผลลัพธ์ นิพจน์การเรียงลำดับสามารถประกอบด้วยแอตทริบิวต์ชื่อตรรกะหนึ่งชื่อขึ้นไป ตามด้วยทิศทางการเรียงลำดับอย่างใดอย่างหนึ่งระหว่าง ASC หรือ DESC

{% entityview id:request.params.view, order:'name ASC, createdon DESC' %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

กรณีการใช้ทั่วไปคือ การตั้งค่าพารามิเตอร์นี้ตาม คำขอ

{% entityview id:request.params.view, order:request.params.order %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

เพจ

ระบุหน้ามุมมองผลลัพธ์เพื่อโหลด ถ้าไม่ได้ระบุพารามิเตอร์นี้ จะมีการโหลดหน้าแรกของผลลัพธ์

พารามิเตอร์นี้ต้องถูกส่งผ่าน ค่าจำนวนเต็ม หรือไม่ก็สตริงที่สามารถแยกวิเคราะห์เป็นจำนวนเต็ม ถ้ามีให้ค่าสำหรับพารามิเตอร์นี้ แต่ค่าเป็น ไม่มีค่า หรือไม่สามารถแยกวิเคราะห์เป็นจำนวนเต็ม จะมีการโหลดหน้าแรกของผลลัพธ์

{% entityview id:request.params.view, page:2 %}

Loaded page {{ entityview.page }} of entity view with {{ entityview.total_records }} total records.

{% endentityview %}

กรณีการใช้ทั่วไปคือ การตั้งค่าพารามิเตอร์นี้ตาม คำขอ

{% entityview id:request.params.view, page:request.params.page %}

Loaded page {{ entityview.page }} of entity view with {{ entityview.total_records }} total records.

{% endentityview %}

ขนาด_เพจ

ระบุจำนวนผลลัพธ์ที่สามารถโหลดสำหรับหน้าผลลัพธ์ปัจจุบัน ถ้าไม่มีค่าให้ไว้สำหรับพารามิเตอร์นี้ และมุมมองเอนทิตีถูกใช้ภายในบล็อก รายการเอนทิตี ขนาดหน้ารายการจะถูกใช้ ถ้าไม่ใช่ภายในบล็อกรายการเอนทิตี ค่าเริ่มต้นของ 10 จะถูกใช้

พารามิเตอร์นี้ต้องถูกส่งผ่าน ค่าจำนวนเต็ม หรือไม่ก็สตริงที่สามารถแยกวิเคราะห์เป็นจำนวนเต็ม ถ้ามีให้ค่าสำหรับพารามิเตอร์นี้ แต่ค่าเป็น ไม่มีค่า หรือไม่สามารถแยกวิเคราะห์เป็นจำนวนเต็ม ค่าเริ่มต้นของขนาดหน้าจะถูกใช้

{% entityview id:request.params.view, page_size:20 %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

กรณีการใช้ทั่วไปคือ การตั้งค่าพารามิเตอร์นี้ตาม คำขอ

{% entityview id:request.params.view, page_size:request.params.pagesize %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

ค้นหา

ระบุนิพจน์การค้นหาเพื่อกรองมุมมองผลลัพธ์ นิพจน์การค้นหาคำสำคัญอย่างง่ายจะกรองด้วยว่าแอตทริบิวต์เริ่มต้นด้วยคำสำคัญหรือไม่ อักขระตัวแทน * สามารถจะรวมอยู่ในนิพจน์ได้

{% entityview id:request.params.view, search:'John\*' %}

Loaded entity view with {{ entityview.total_records }} total matching records.

{% endentityview %}

กรณีการใช้ทั่วไปคือ การตั้งค่าพารามิเตอร์นี้ตาม คำขอ เพื่อให้ตัวกรองการค้นหาสามารถถูกตั้งค่าได้โดยยึดตามข้อมูลป้อนเข้าของผู้ใช้

{% entityview id:request.params.view, search:request.params.search %}

Loaded entity view with {{ entityview.total_records }} total matching records.

{% endentityview %}

ภาษา_รหัส

รหัสภาษาจำนวนเต็ม Power Apps เพื่อเลือกมุมมองเอนทิตีป้ายชื่อที่เป็นภาษาท้องถิ่น (ป้ายชื่อส่วนหัวของคอลัมน์ เป็นต้น) ที่จะโหลด ถ้าไม่มี ภาษา_รหัส จัดเตรียมไว้ จะใช้ภาษาเริ่มต้นของการเชื่อมต่อแอปพลิเคชันของพอร์ทัล Power Apps

ถ้ามีการใช้มุมมองเอนทิตีภายในบล็อกรายการเอนทิตี มุมมองเอนทิตีจะสืบทอดการตั้งค่าคอนฟิกรหัสภาษาจากรายการเอนทิตี

{% entityview logical_name:'contact', name:"Active Contacts", language_code:1033 %}

Loaded entity view {{ entityview.name }}.

{% endentitylist %}

ดัชนีการค้นหา

ดำเนินการสอบถามต่อดัชนีค้นหาการค้นหาพอร์ทัล จากนั้น ผลลัพธ์ที่ตรงกันสามารถถูกเข้าถึงโดยการใช้ ดัชนีการค้นหา ที่จะพร้อมใช้งานภายในบล็อกแท็กได้

{% 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 %}

<style>

    .highlight {background-color: #FFFCAC;}

</style>

โดยค่าเริ่มต้น วัตถุดัชนีการค้นหาจะได้รับชื่อตัวแปร ดัชนีการค้นหา อีกทางหนึ่ง ชื่อตัวแปรที่แตกต่างกันสามารถถูกแสดง

{% searchindex liquid_search = query: 'support', page: params.page, page_size: 10 %}

{% if liquid_search.results.size > 0 %}

...

{% endif %}

{% endsearchindex %}

พารามิเตอร์

แท็ก ดัชนีการค้นหา ยอมรับพารามิเตอร์ต่อไปนี้

การสอบถาม

การสอบถามที่ใช้เพื่อให้ตรงกับผลลัพธ์ พารามิเตอร์นี้มีจุดมุ่งหมายเพื่อยอมรับส่วนผู้ใช้ที่ได้รับการระบุของดัชนีการสอบถาม (ถ้ามี)

{% searchindex query: 'support' %}

...

{% endsearchindex %}

กรณีการใช้ทั่วไปคือ การตั้งค่าพารามิเตอร์นี้ตาม คำขอ

{% searchindex query: request.params.query %}

...

{% endsearchindex %}

พารามิเตอร์นี้สนับสนุน ไวยากรณ์ตัวแยกวิเคราะห์แบบสอบถาม Lucene

ตัวกรอง

การสอบถามเพิ่มเติมที่ใช้เพื่อให้ตรงกับผลลัพธ์ พารามิเตอร์นี้มีจุดมุ่งหมายเพื่อยอมรับตัวกรองที่ระบุโดยนักพัฒนาเพื่อให้ได้ผลลัพธ์ตามต้องการ

{% searchindex query: request.params.query, filter: '+statecode:0' %}

...

{% endsearchindex %}

พารามิเตอร์นี้สนับสนุน ไวยากรณ์ตัวแยกวิเคราะห์แบบสอบถาม Lucene

หมายเหตุ

ความแตกต่างระหว่าง ตัวกรอง และ การสอบถาม คือในขณะที่ทั้งสองจะยอมรับไวยากรณ์ตัวแยกวิเคราะห์แบบสอบถาม Lucene การสอบถามมุ่งหวังที่จะยืดหยุ่นกว่าเกี่ยวกับวิธีการที่ไวยากรณ์นี้เป็นߝแยกวิเคราะห์ ตามที่คาดไว้ว่า ผู้ใช้ส่วนใหญ่จะไม่ตระหนักถึงไวยากรณ์นี้ ดังนั้น ในกรณีการแยกวิเคราะห์ การสอบถาม ตามที่ไวยากรณ์นี้ล้มเหลว การสอบถามทั้งหมดจะหายไปและส่งไปเป็นข้อความการสอบถาม ในทางตรงข้าม ตัวกรองจะแยกวิเคราะห์เคร่งครัด และส่งกลับข้อผิดพลาดถ้ากรณีของไวยากรณ์ที่ไม่ถูกต้อง

ชื่อ_ตรรกะ

ชื่อตรรกะเอนทิตี Power Apps ที่ผลลัพธ์ที่ตรงกันจะถูกจำกัด เป็นสตริงที่คั่นด้วยจุลภาค ถ้าไม่ได้ระบุ เอนทิตีที่ตรงกันทั้งหมดจะถูกส่งกลับ

{% searchindex query: request.params.query, logical_names: 'kbarticle,incident' %}

...
>
{% endsearchindex %}

เพจ

หน้าผลลัพธ์การค้นหาจะถูกส่งคืน ถ้าไม่ได้ระบุ หน้าแรก (1) จะถูกส่งกลับ

{% searchindex query: request.params.query, page: 2 %}

...

{% endsearchindex %}

กรณีการใช้ทั่วไปคือ การตั้งค่าพารามิเตอร์นี้ตาม คำขอ

{% searchindex query: request.params.query, page: request.params.page %}

...

{% endsearchindex %}

ขนาด_เพจ

ขนาดของหน้าผลลัพธ์จะถูกส่งคืน ถ้าไม่ได้ระบุ จะใช้ขนาดเริ่มต้นเป็น 10

{% searchindex query: request.params.query, page_size: 20 %}

...

{% endsearchindex %}

ฟอร์มเอนทิตี

แสดงฟอร์มพื้นฐานที่กำหนดค่า Power Apps ทั้งหมด ตามชื่อ หรือรหัส

หมายเหตุ

แท็ก ฟอร์มเอนทิตี พร้อมใช้งานสำหรับใช้ในเนื้อหาที่แสดงภายใน เทมเพลตเว็บ– เท่านั้น ตามเทมเพลตของหน้า การพยายามที่จะใช้แท็กภายในเท็มเพลตของหน้าที่ขึ้นกับการเขียนซ้ำจะไม่แสดงข้อมูลใด ๆ คุณสามารถแสดงแท็ก ฟอร์มเอนทิตี หรือ เว็บฟอร์ม ได้เพียงแท็กเดียวสำหรับแต่ละหน้า ฟอร์มเอนทิตี หรือ เว็บฟอร์ม แท็กหลังจากตัวแรกจะไม่สามารถแสดง

{% entityform name: 'My Basic Form' %}

พารามิเตอร์

ชื่อ

ชื่อของฟอร์มพื้นฐานที่คุณต้องการจะโหลด

{% entityform name:My Basic Form %}

เว็บฟอร์ม

แสดง Power Apps ที่กำหนดค่าทั้งหมดในฟอร์มแบบหลายขั้นตอนตามชื่อหรือรหัส แท็กเว็บฟอร์มพร้อมใช้งานเฉพาะสำหรับการใช้ในเนื้อหาที่แสดงภายใน เท็มเพลตเว็บ ตามเท็มเพลตของหน้า การพยายามใช้แท็กภายในเทมเพลตของหน้าที่ขึ้นกับการเขียนซ้ำจะไม่แสดงข้อมูลใด ๆ คุณสามารถแสดงแท็ก ฟอร์มเอนทิตี หรือ เว็บฟอร์ม ได้เพียงแท็กเดียวสำหรับแต่ละหน้า ฟอร์มเอนทิตีหรือเว็บฟอร์มจะแท็กหลังจากรายการแรกไม่สามารถแสดง

{% webform name: 'My Multistep Form' %}

พารามิเตอร์

ชื่อ

ชื่อของฟอร์มแบบหลายขั้นตอนที่คุณต้องการจะโหลด

{% webform name:My Multistep Form %}

codecomponent

อนุญาตให้คุณฝังส่วนประกอบของโค้ดโดยใช้แท็ก Liquid ตัวอย่างเช่น การเพิ่มการควบคุมการแสดงแผนที่แบบกำหนดเองไปยังหน้าเว็บ

ข้อสำคัญ

• นี่คือคุณลักษณะการแสดงตัวอย่าง
• คุณลักษณะตัวอย่างไม่ได้มีไว้สำหรับการนำไปใช้งานจริงและอาจมีการจำกัดฟังก์ชันการทำงาน คุณลักษณะเหล่านี้สามารถใช้ได้ก่อนการเปิดตัวอย่างเป็นทางการเพื่อให้ลูกค้าสามารถเข้าใช้งานได้ก่อนเวลาและให้ข้อคิดเห็น

พารามิเตอร์

ชื่อ

รหัสหรือชื่อของส่วนประกอบของโค้ด

คุณสมบัติ

ค่าของคุณสมบัติที่ส่วนประกอบของโค้ดคาดว่าจะต้องถูกส่งผ่านเป็นคู่คีย์/ค่าที่คั่นด้วย ":" (เครื่องหมายทวิภาค) โดยที่คีย์คือชื่อคุณสมบัติ และค่าคือค่าสตริง JSON

{% codecomponent name:abc\_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value> %}

หมายเหตุ

คุณสมบัติที่ต้องการอาจแตกต่างกันไปขึ้นอยู่กับส่วนประกอบที่คุณเลือก

ดูที่ ใช้แท็กเทมเพลต Liquid ของส่วนประกอบของโค้ด

ดูเพิ่มเติม

แท็กโฟลว์การควบคุม
แท็กการทำซ้ำ
แท็กตัวแปร
แท็กเทมเพลต

หมายเหตุ

บอกให้เราทราบเกี่ยวกับภาษาที่คุณต้องการในคู่มือ ทำแบบสำรวจสั้นๆ (โปรดทราบว่าแบบสำรวจนี้เป็นภาษาอังกฤษ)

แบบสำรวจนี้ใช้เวลาทำประมาณเจ็ดนาที ไม่มีการเก็บข้อมูลส่วนบุคคล (คำชี้แจงสิทธิ์ส่วนบุคคล)