แท็กเทมเพลต

แท็กเทมเพลตควบคุมการแสดงผลของเท็มเพลตในลักษณะต่างๆ และอนุญาตให้มีการรวมกันของเท็มเพลตที่หลากหลายให้เป็นผลลัพธ์เดี่ยว

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 เป็นจริง เมื่อมีการดำเนินการการสอบถาม

• TotalRecordCountLimitExceeded

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

แอตทริบิวต์ XML

แอตทริบิวต์ XML ในตัวแปรที่ให้ไว้ (เช่น 'resultVariable' ในตัวอย่างก่อนหน้า) เก็บการสอบถามผลลัพธ์ซึ่งสามารถใช้เพื่อรับข้อมูลจาก Microsoft Dataverse แอตทริบิวต์นี้มีประโยชน์สำหรับวัตถุประสงค์ในการดีบักเมื่อคุณต้องการทำความเข้าใจว่าสิทธิ์ตารางถูกนำไปใช้กับแท็ก fetchxml นี้อย่างไร

องค์ประกอบและแอตทริบิวต์ที่รองรับอื่น ๆ

แท็ก Liquid ของ Fetchxml รองรับแอตทริบิวต์ต่อไปนี้ และองค์ประกอบรอง

องค์ประกอบ/องค์ประกอบรอง	แอตทริบิวต์	องค์ประกอบรอง
Fetch	การแมป เวอร์ชัน จำนวน หน้า paging-cookie utc-offset aggregate distinct min-active-row-version output-format returntotalrecordcount no-lock	ใบสั่ง เอนทิตี
ลำดับ	แอตทริบิวต์ นามแฝง จากมากไปน้อย
เอนทิตี	ชื่อ all-attributes no-attrs แอตทริบิวต์	ใบสั่ง กรอง ลิงก์-เอนทิตี
ตัวกรอง	ชนิด hint isquickfindfields	เงื่อนไข ตัวกรอง
ลิงก์-เอนทิตี	ชื่อ จาก ถึง นามแฝง link-type Visible ตัดกัน all-attributes no-attrs แอตทริบิวต์	ใบสั่ง กรอง ลิงก์-เอนทิตี
เงื่อนไข	คอลัมน์ entityname แอตทริบิวต์ ตัวดำเนินการ aggregate นามแฝง uiname uitype uihidden value	value

รวม

รวมเนื้อหาของเท็มเพลตหนึ่งในอีกเท็มเพลตหนึ่ง ตามชื่อ ใน Power Pages แหล่งมาของเทมเพลตอื่นๆ นี้ โดยทั่วไปจะเป็นเทมเพลตเว็บ ตัวดำเนินการนี้ช่วยให้สามารถนำส่วนย่อยของเท็มเพลตทั่วไปในตำแหน่งที่หลากหลายมาใช้ใหม่

เมื่อเทมเพลตถูกรวมอยู่ในอีกเทมเพลตหนึ่ง เทมเพลตที่รวมจะสามารถเข้าถึงตัวแปรใดๆ ที่กำหนดไว้ในเทมเพลตหลัก

{% include 'My Template' %}

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

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

block

ใช้กับขยายเพื่อให้มีการส่งต่อเทมเพลต ดู ขยาย สำหรับการใช้งาน

ขยาย

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

ใน Power Pages ชื่อเท็มเพลตหลักซึ่งกำหนดให้กับแท็กโดยทั่วไปจะอ้างถึงชื่อของเท็มเพลตเว็บ

เมื่อ ขยาย ถูกใช้ ขยาย จะต้องเป็นเนื้อหาแรกในเทมเพลต และสามารถถูกตามด้วยแท็ก บล็อก อย่างน้อยหนึ่งแท็กเท่านั้น

ถ้าบล็อกในเท็มเพลตหลักไม่ได้ถูกแทนที่ เนื้อหาในเท็มเพลตหลัก (ถ้ามี) จะถูกแสดง

ข้อคิดเห็น

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

รหัส

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

เอาท์พุท

Hello. My name is Charles.

ดิบ

คุณลักษณะนี้ช่วยให้คุณแสดงโค้ด Liquid บนหน้าโดยไม่ต้องแยกวิเคราะห์หรือดำเนินการ

เอาท์พุท

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

การแทนที่

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

เคล็ดลับ

URL ที่ใช้ใน request.url สามารถเป็นค่าที่ร้องขอและรับ ที่แคชไว้ สำหรับคำขอที่ตามมา เพื่อให้แน่ใจว่าค่าใน request.url ถูกต้อง ให้พิจารณาใช้แท็กการทดแทน URL บางส่วน เช่น ~{เส้นทาง WebFile} หรือจัดเก็บ URL พอร์ทัลใน การตั้งค่าไซต์

codecomponent

ดู ทำความเข้าใจแท็กเอนทิตี Dataverse ของส่วนประกอบรหัส, ใช้แท็กเทมเพลต Liquid ของส่วนประกอบโค้ด

(ดูเพิ่มเติม )

แท็กโฟลว์การควบคุม
แท็กการทำซ้ำ
แท็กตัวแปร
แท็ก Liquid ของ Dataverse
ใช้แท็กเทมเพลต Liquid ของส่วนประกอบของโค้ด