แท็ก Liquid ของ Dataverse
แท็ก Liquid ของ Microsoft Dataverse ใช้เพื่อโหลด และแสดงข้อมูล Dataverse หรือใช้บริการในกรอบอื่น ๆ ของ Power Pages แท็กเหล่านี้เป็นส่วนขยายเฉพาะของ Dataverse-ไปยังภาษาสภาพคล่อง
แผนภูมิ
เพิ่มแผนภูมิแอปแบบจำลอง Power Apps ในเว็บเพจ คุณสามารถเพิ่มแท็กแผนภูมิลงในฟิลด์ คัดลอก บนหน้าเว็บหรือในฟิลด์ แหล่งที่มา บนเทมเพลตเว็บ สำหรับขั้นตอนในการเพิ่มแผนภูมิแอปแบบจำลอง Power Apps ไปที่หน้าเว็บ ดูที่ เพิ่มแผนภูมิไปที่เว็บเพจใน Power Pages
{% 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 Pages ดูที่ เพิ่มรายงาน Power BI หรือแดชบอร์ดลงในเว็บเพจใน Power Pages
หมายเหตุ
ในการที่จะให้แท็กทำงาน คุณต้อง เปิดใช้งานการรวม Power BI จากฮับ Power Pages ในศูนย์การจัดการ Power Platform ถ้าไม่ได้เปิดการใช้งานการรวม 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 ID ผู้ใช้ที่ได้การรับรองความถูกต้องของ Microsoft Entra
powerbiembedded ช่วยให้คุณสามารถใช้รายงาน Power BI ที่มีความปลอดภัยหรือแดชบอร์ดร่วมกันกับผู้ใช้ภายนอกที่ไม่มีสิทธิ์การใช้งาน Power BI หรือการตั้งค่าการรับรองความถูกต้องของ Microsoft Entra สำหรับข้อมูลเกี่ยวกับการตั้งค่าบริการของ Power BI Embedded ดูที่ เปิดใช้บริการ Power BI Embedded
ในขณะที่เพิ่มรายงาน Power BI หรือแดชบอร์ดที่ปลอดภัย ให้แน่ใจว่ามีการใช้ร่วมกับบริการของ Power Pages Microsoft Entra หรือ 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 Pages เป็นสามารถแก้ไขได้บนไซต์ สำหรับผู้ใช้ที่มีสิทธิ์แก้ไขเนื้อหาสำหรับออบเจ็กต์นั้น วัตถุที่สามารถแก้ไขได้รวมถึง เพจ, 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
ค่าแบบบูลีน ที่บ่งชี้ว่า ค่าที่แสดงตามแท็กนี้จะเข้ารหัสข้อความ HTML หรือไม่ คือ HTML-encoded ค่านี้คือ เท็จ ตามค่าเริ่มต้น
ไม่ตายตัว
ค่าแบบบูลีนที่บ่งชี้ว่า รหัสสภาพคล่องเทมเพลตใด ๆ ที่พบภายในค่าข้อความที่ถูกแสดงตามแท็กนี้จะสามารถถูกประมวลผลหรือไม่ ค่านี้คือ จริง ตามค่าเริ่มต้น
แท็ก
ชื่อของคอนเทนเนอร์แท็ก HTML ที่จะถูกแสดงโดยแท็กนี้ แท็กนี้จะแสดงองค์ประกอบ div ตามค่าเริ่มต้น แนะนำให้คุณเลือกระหว่าง div หรือ span เป็นค่าสำหรับพารามิเตอร์นี้
ชื่อเรื่อง
ระบุป้ายชื่อสำหรับรายการที่สามารถแก้ไขได้นี้ภายในอินเทอร์เฟซการแก้ไขเนื้อหา ถ้าไม่มีการระบุใดๆ ป้ายกำกับที่เรียกใช้ง่ายจะถูกสร้างขึ้นโดยอัตโนมัติ
ชนิด
ค่าสตริงที่ระบุชนิดของอินเทอร์เฟซการแก้ไขจะถูกนำเสนอ สำหรับค่าข้อความที่สามารถแก้ไข ค่าที่ถูกต้องสำหรับพารามิเตอร์นี้คือ html หรือข้อความ 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 รหัสต้องเป็นสตริงที่สามารถแยกวิเคราะห์เป็นแบบ 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 ได้ รายการจะถูกโหลดโดย ID มิฉะนั้น จะถูกโหลดตามชื่อ
<!-- key_variable can hold an ID or name -->
{% entitylist key:key_variable %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
language_code
รหัสภาษาจำนวนเต็ม Dataverse เพื่อเลือกรายการแปลป้ายเป็นภาษาท้องถิ่นเพื่อถูกโหลด ถ้าไม่มีภาษารหัสจัดเตรียมไว้ จะใช้ภาษาเริ่มต้นของการเชื่อมต่อไซต์แอปพลิเคชันของ Dataverse
{% entitylist name:"My List", language_code:1033 %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
มุมมองเอนทิตี:
โหลดมุมมอง Dataverse ที่ได้ระบุไว้ ตามชื่อหรือรหัส คุณสมบัติของมุมมอง ߝ ดูเมตาดาต้าของคอลัมน์ เรกคอร์ดผลลัพธ์แบบแบ่งหน้า เป็นต้น จะสามารถได้รับการเข้าถึงโดยใช้ ออบเจ็กต์มุมมองเอนทิตี ที่จะพร้อมใช้งานภายในบล็อกแท็ก
ถ้ามุมมองถูกโหลดเสร็จเรียบร้อยแล้ว เนื้อหาภายในบล็อกนี้จะถูกแสดง ถ้ารายการไม่ถูกพบ เนื้อหาของบล็อกนี้จะไม่สามารถถูกแสดง
{% 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 %}
พารามิเตอร์
ให้รหัส อย่างใดอย่างหนึ่ง หรือ ตรรกะชื่อที่มีชื่อ เพื่อเลือกมุมมอง Dataverse ที่จะโหลด ถ้าไม่แสดงให้ทั้งสองอย่าง และแท็กมุมมองเอนทิตีซ้อนอยู่ภายในแท็กรายการเอนทิตี มุมมองเริ่มต้นของสิ่งที่ล้อมรอบรายการเอนทิตีจะถูกโหลด
รหัส
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 %}
logical_name
ชื่อตรรกะของ Dataverse เอนทิตีของมุมมองเพื่อถูกโหลด ต้องใช้ร่วมกับ ชื่อ
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
ชื่อ
ชื่อของ Dataverse ของมุมมองเพื่อถูกโหลด ต้องใช้ร่วมกับ logical_name
{% 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 %}
เพจ
ระบุหน้ามุมมองผลลัพธ์เพื่อโหลด ถ้าไม่ได้ระบุพารามิเตอร์นี้ หน้าแรกของผลลัพธ์จะถูกโหลด
พารามิเตอร์นี้ต้องถูกส่งผ่าน ค่าจำนวนเต็ม หรือไม่ก็สตริงที่สามารถแยกวิเคราะห์เป็นจำนวนเต็ม ถ้ามีการให้ค่าสำหรับพารามิเตอร์นี้ แต่ค่าเป็น null หรือไม่สามารถแยกวิเคราะห์เป็นจำนวนเต็ม หน้าแรกของผลลัพธ์จะถูกโหลด
{% 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 %}
page_size
ระบุจำนวนผลลัพธ์ที่สามารถโหลดสำหรับหน้าผลลัพธ์ปัจจุบัน ถ้าไม่มีค่าให้ไว้สำหรับพารามิเตอร์นี้ และมุมมองเอนทิตีถูกใช้ภายในบล็อก รายการเอนทิตี ขนาดหน้ากระดาษจะถูกใช้ ถ้าไม่ใช่ภายในบล็อกรายการเอนทิตี ค่าเริ่มต้นของ 10 จะถูกใช้
พารามิเตอร์นี้ต้องถูกส่งผ่าน ค่าจำนวนเต็ม หรือไม่ก็สตริงที่สามารถแยกวิเคราะห์เป็นจำนวนเต็ม ถ้ามีการให้ค่าสำหรับพารามิเตอร์นี้ แต่ค่าเป็น null หรือไม่สามารถแยกวิเคราะห์เป็นจำนวนเต็ม ค่าเริ่มต้นของขนาดหน้ากระดาษจะถูกใช้
{% 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 %}
language_code
รหัสภาษาจำนวนเต็ม Dataverse เพื่อเลือกมุมมองเอนทิตีป้ายชื่อที่เป็นภาษาท้องถิ่น (ป้ายชื่อส่วนหัวของคอลัมน์ เป็นต้น) ที่จะโหลด ถ้าไม่มีภาษารหัสจัดเตรียมไว้ จะใช้ภาษาเริ่มต้นของการเชื่อมต่อเว็บไซต์แอปพลิเคชันของ Dataverse
ถ้ามีการใช้มุมมองเอนทิตีภายในบล็อกรายการเอนทิตี มุมมองเอนทิตีจะสืบทอดการตั้งค่าคอนฟิกรหัสภาษาจากรายการเอนทิตี
{% 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 การสอบถามมุ่งหวังที่จะยืดหยุ่นกว่าเกี่ยวกับวิธีการที่ไวยากรณ์นี้เป็นߝแยกวิเคราะห์ ตามที่คาดไว้ว่า ผู้ใช้ส่วนใหญ่จะไม่ตระหนักถึงไวยากรณ์นี้ ดังนั้น ในกรณีการแยกวิเคราะห์ การสอบถาม ตามที่ไวยากรณ์นี้ล้มเหลว การสอบถามทั้งหมดจะหายไปและส่งไปเป็นข้อความการสอบถาม ในทางตรงข้าม ตัวกรองจะแยกวิเคราะห์เคร่งครัด และส่งกลับข้อผิดพลาดถ้ากรณีของไวยากรณ์ที่ไม่ถูกต้อง
logical_names
ชื่อตรรกะเอนทิตี Dataverse ที่ผลลัพธ์ที่ตรงกันจะถูกจำกัด เป็นสตริงที่คั่นด้วยจุลภาค ถ้าไม่ได้ระบุ เอนทิตีที่ตรงกันทั้งหมดจะถูกส่งกลับ
{% 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 %}
page_size
ขนาดของหน้าผลลัพธ์จะถูกส่งคืน ถ้าไม่ได้ระบุจะใช้ขนาดเริ่มต้นเป็น 10
{% searchindex query: request.params.query, page_size: 20 %}
...
{% endsearchindex %}
ฟอร์มเอนทิตี
แสดง ฟอร์ม ทั้งหมดตามชื่อหรือรหัส
หมายเหตุ
แท็ก ฟอร์มเอนทิตี พร้อมใช้งานสำหรับใช้ในเนื้อหาที่แสดงภายใน เทมเพลตเว็บ– เท่านั้น ตามเทมเพลตของหน้า การพยายามที่จะใช้แท็กภายในเท็มเพลตของหน้าที่ขึ้นกับการเขียนซ้ำจะไม่แสดงข้อมูลใด ๆ คุณสามารถแสดงแท็ก ฟอร์มเอนทิตี หรือ เว็บฟอร์ม ได้เพียงแท็กเดียวสำหรับแต่ละหน้า ฟอร์มเอนทิตี หรือ เว็บฟอร์ม แท็กหลังจากตัวแรกจะไม่สามารถแสดง
{% entityform name: 'My Basic Form' %}
พารามิเตอร์
ชื่อ
ชื่อของฟอร์มพื้นฐานที่คุณต้องการจะโหลด
{% entityform name:My Basic Form %}
เว็บฟอร์ม
แสดง ฟอร์มแบบหลายขั้นตอน ทั้งหมดตามชื่อหรือรหัส แท็กเว็บฟอร์มพร้อมใช้งานเฉพาะสำหรับการใช้ในเนื้อหาที่แสดงภายใน เท็มเพลตเว็บ ตามเท็มเพลตของหน้า การพยายามใช้แท็กภายในเทมเพลตของหน้าที่ขึ้นกับการเขียนซ้ำจะไม่แสดงข้อมูลใด ๆ คุณสามารถแสดงแท็ก ฟอร์มเอนทิตี หรือ เว็บฟอร์ม ได้เพียงแท็กเดียวสำหรับแต่ละหน้า ฟอร์มเอนทิตีหรือเว็บฟอร์มจะแท็กหลังจากรายการแรกไม่สามารถแสดง
{% webform name: 'My Multistep Form' %}
พารามิเตอร์
ชื่อ
ชื่อของฟอร์มแบบหลายขั้นตอนที่คุณต้องการจะโหลด
{% webform name:My Multistep Form %}
codecomponent
อนุญาตให้คุณฝังส่วนประกอบของโค้ดโดยใช้แท็ก Liquid ตัวอย่างเช่น การเพิ่มการควบคุมการแสดงแผนที่แบบกำหนดเองไปยังหน้าเว็บ
พารามิเตอร์
ชื่อ
ID หรือชื่อของส่วนประกอบของโค้ด
คุณสมบัติ
ค่าของคุณสมบัติที่ส่วนประกอบของโค้ดคาดว่าจะต้องถูกส่งผ่านเป็นคู่คีย์/ค่าที่คั่นด้วย ":" (เครื่องหมายทวิภาค) โดยที่คีย์คือชื่อคุณสมบัติ และค่าคือค่าสตริง JSON
{% codecomponent name:abc\_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value> %}
หมายเหตุ
คุณสมบัติที่ต้องการอาจแตกต่างกันไปขึ้นอยู่กับส่วนประกอบที่คุณเลือก
ดูที่ ใช้แท็กเทมเพลต Liquid ของส่วนประกอบของโค้ด