ออบเจ็กต์ Liquid ที่พร้อมใช้งาน
ออบเจ็กต์แบบไม่ตายตัวประกอบด้วย แอททริบิวต์เพื่อแสดงผลลัพธ์ของเนื้อหาแบบไดนามิกไปยังเพจ ตัวอย่างเช่น ออบเจ็กต์เพจมีแอตทริบิวต์ที่เรียกว่าชื่อเรื่อง ซึ่งสามารถใช้เพื่อแสดงผลหัวข้อของเพจปัจจุบันได้
เพื่อเข้าถึงแอตทริบิวต์ของออบเจ็กต์ตามชื่อ ให้ใช้จุด (.) เมื่อต้องการแสดงแอตทริบิวต์ของออบเจ็กต์ในเทมเพลต ให้ครอบใน {{ and }}
สำคัญ
เพื่อหลีกเลี่ยงปัญหาการเขียนสคริปต์ข้ามไซต์ (XSS) ที่อาจเกิดขึ้น ให้ใช้ ตัวกรอง escape เพื่อเข้ารหัสข้อมูล HTML เสมอ เมื่อใดก็ตามที่ใช้ออบเจ็กต์ Liquid เพื่ออ่านข้อมูลที่ไม่น่าเชื่อถือที่ผู้ใช้ให้มา
{{ page.title }}
แอตทริบิวต์ของออบเจ็กต์ยังสามารถถูกเข้าถึงได้โดยใช้ชื่อสตริงและ [] รูปแบบนี้เป็นประโยชน์ในกรณีที่แอตทริบิวต์ที่ต้องการถูกกำหนดแบบไดนามิก หรือชื่อแอตทริบิวต์ประกอบด้วย อักขระ เว้นวรรค อักขระพิเศษ และอื่นๆ ที่จะไม่ถูกต้องเมื่อมีการใช้จุด (.) ในไวยากรณ์
{{ page[title] }}
{% assign attribute_name = Name with spaces %}
{{ object[attribute_name] }}
ออบเจ็กต์ต่อไปนี้สามารถถูกใช้ และถูกเข้าถึงที่ใดก็ได้ในเท็มเพลตใดๆ
| ออบเจ็กต์ | รายละเอียด |
|---|---|
| เอนทิตี | ช่วยให้คุณสามารถโหลดตาราง Microsoft Dataverse ใดๆโดยรหัสได้ ข้อมูลเพิ่มเติม: เอนทิตี |
| ตอนนี้ | ออบเจ็กต์วันที่/เวลาที่อ้างอิงถึงเวลา UTC ปัจจุบัน ณ เวลาที่เท็มเพลตถูกแสดง หมายเหตุ: ค่านี้ถูกแคชโดยแอปพลิเคชันเว็บพอร์ทัล และจะไม่รีเฟรชทุกครั้ง ข้อมูลเพิ่มเติม: ตัวกรองวันที่ |
| หน้า | อ้างอิงไปยังเพจที่ร้องขอพอร์ทัลปัจจุบัน ออบเจ็กต์เพจ ทำให้สามารถเข้าถึงสิ่งต่างๆ เช่น breadcrumbs สำหรับเพจปัจจุบัน หัวข้อหรือ URL ของเพจปัจจุบัน และแอตทริบิวต์อื่นใดหรือเอนทิตีที่เกี่ยวข้องของเรกคอร์ด Dataverse พื้นฐาน ข้อมูลเพิ่มเติม: หน้า |
| พารามิเตอร์ | ทางลัดที่สะดวกสำหรับ request.params ข้อมูลเพิ่มเติม: คำขอ |
| คำขอ | ประกอบด้วยข้อมูลเกี่ยวกับคำขอ HTTP ปัจจุบัน ข้อมูลเพิ่มเติม: คำขอ |
| การตั้งค่า | ช่วยให้คุณสามารถโหลด การตั้งค่าไซต์ ใดๆ ได้โดยชื่อ ข้อมูลเพิ่มเติม: การตั้งค่า |
| แผนผังเว็บไซต์ | อนุญาตให้เข้าถึงแผนผังเว็บไซต์พอร์ทัล ข้อมูลเพิ่มเติม: แผนผังเว็บไซต์ |
| ตัวทำเครื่องหมายไซต์ | ช่วยให้คุณสามารถโหลดตัวทำเครื่องหมายไซต์ใดๆได้โดยชื่อ ข้อมูลเพิ่มเติม: ตัวทำเครื่องหมายไซต์ |
| Snippet | ช่วยให้คุณสามารถโหลด ส่วนย่อยของเนือหา ใดๆ ได้โดยชื่อ ข้อมูลเพิ่มเติม: ส่วนย่อย |
| ผู้ใช้ | อ้างอิงไปยังผู้ใช้พอร์ทัลปัจจุบัน ซึ่งอนุญาตให้เข้าถึงแอตทริบิวต์ทั้งหมดของเรกคอร์ดผู้ติดต่อ Dataverse พื้นฐาน ถ้าไม่มีผู้ใช้ลงชื่อเข้าใช้ ตัวแปรนี้จะเป็น null ข้อมูลเพิ่มเติม: ผู้ใช้ |
| เว็บลิงก์ | ช่วยให้คุณสามารถโหลดชุดเว็บลิงก์ใดๆได้โดยชื่อหรือรหัส ข้อมูลเพิ่มเติม: เว็บลิงก์ |
| เว็บไซต์ | อ้างอิงถึงเรกคอร์ดเว็บไซต์ของพอร์ทัล ซึ่งอนุญาตให้เข้าถึงแอตทริบิวต์ทั้งหมดของเรกคอร์ดเว็บไซต์ Dataverse (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>
แอตทริบิวต์โฆษณา
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| การกำหนดตำแหน่ง | ส่งคืนออบเจ็กต์การกำหนดตำแหน่งโฆษณา |
| [ชื่อหรือรหัสโฆษณา] | คุณสามารถเข้าถึงโฆษณาใดๆ ตามคุณสมบัติของชื่อหรือรหัส {% assign ad = ads[Ad Name] %}{% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
แอตทริบิวต์การกำหนดตำแหน่งโฆษณา
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| [ชื่อหรือรหัสการกำหนดตำแหน่งโฆษณา] | คุณสามารถเข้าถึงการกำหนดตำแหน่งใดๆ ตามคุณสมบัติของชื่อหรือรหัสได้{% assign placement = ads.placements[Placement Name or Id] %}{% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %} |
แอตทริบิวต์การกำหนดตำแหน่งโฆษณา
ตำแหน่งโฆษณาคือออบเจ็กต์ตารางที่มีแอตทริบิวต์ทั่วไปเหมือนกัน และแอตทริบิวต์ที่แสดงด้านล่าง
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| โฆษณา | ส่งคืนชุดออบเจ็กต์โฆษณาที่เกี่ยวข้องกับการจัดวาง แท็กการเกิดซ้ำ และ ตัวกรองอาร์เรย์ อาจใช้กับคอลเลกชันนี้ได้ |
| Name | ส่งคืนชื่อฟิลด์สำหรับการกำหนดตำแหน่งโฆษณา |
| placement_url | URL ที่สามารถถูกใช้เพื่อเรียกการกำหนดตำแหน่งโฆษณาที่แสดงโดยเท็มเพลตอย่างสมบูรณ์ |
| random_url | URL ที่สามารถถูกใช้เพื่อเรียกโฆษณาแบบสุ่มจากการกำหนดตำแหน่งที่แสดงโดยเท็มเพลตอย่างสมบูรณ์ |
แอตทริบิวต์โฆษณา
หมายเหตุ
โฆษณาคือ ออบเจ็กต์ตารางที่มีแอตทริบิวต์เดียวกันทั้งหมด นอกเหนือจากรายการเหล่านั้นที่แสดงด้านล่าง
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| ad_url | URL ที่สามารถถูกใช้เพื่อเรียกโฆษณาที่แสดงโดยเท็มเพลตอย่างสมบูรณ์ |
| คัดลอก | ส่งคืนฟิลด์สำเนาสำหรับโฆษณา |
| รูปภาพ | ส่งคืนออบเจ็กต์รูปภาพ (ถ้ามี) สำหรับโฆษณา |
| Name | ส่งคืนฟิลด์ชื่อสำหรับโฆษณา |
| open_in_new_window | ส่งคืนค่าจริง ถ้า URL ที่ระบุโดย redirect_url ควรเปิดในหน้าต่างใหม่ |
| redirect_url | URL ที่จะเชื่อมโยงโดยตรงไปยังผู้ใช้โดยการเลือกโฆษณา |
แอตทริบิวต์ของรูปโฆษณา
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| alternate_text | ส่งคืนข้อความที่มีวัตถุประสงค์เพื่อให้ปรากฏในแอตทริบิวต์ alt ของแท็ก |
| height | ส่งคืนความสูงเป็นพิกเซลสำหรับรูปภาพ |
| URL | ส่งคืนต้นทาง URL สำหรับรูปภาพ |
| width | ส่งคืนความกว้างเป็นพิกเซลสำหรับรูปภาพ |
บล็อก
ช่วยให้สามารถเข้าถึงและแสดงบล็อกและโพสต์ในบล็อก
ออบเจ็กต์ บล็อก ช่วยให้คุณสามารถเลือกบล็อกหรือโพสต์ในบล็อกเฉพาะได้
{% 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>
ออบเจ็กต์บล็อก
ออบเจ็กต์บล็อกช่วยให้คุณสามารถเข้าถึงบล็อกเฉพาะใด ๆ ในเว็บไซต์ หรือเข้าถึงโพสต์ในบล็อกทั้งหมดในพอร์ทัล
ตารางต่อไปนี้อธิบายแอตทริบิวต์ที่เกี่ยวข้องกับออบเจ็กต์ บล็อก
| แอตทริบิวต์ | คำอธิบาย |
|---|---|
| โพสต์ | ส่งกลับออบเจ็กต์ โพสต์ในบล็อก ที่ประกอบด้วยโพสต์ในบล็อกทั้งหมดในพอร์ทัล |
| [ชื่อหรือรหัสบล็อก] | คุณสามารถเข้าถึงบล็อกใดๆ ตามคุณสมบัติของชื่อหรือรหัส |
{% assign blog = blogs["Blog Name"] %}
{% assign blog = blogs["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
ออบเจ็กต์บล็อก
ออบเจ็กต์ บล็อก ช่วยให้คุณสามารถทำงานกับบล็อกเดียว ซึ่งทำให้คุณสามารถเข้าถึงโพสต์สำหรับบล็อกนั้นๆ
ตารางต่อไปนี้อธิบายแอตทริบิวต์ที่หลากหลายที่เกี่ยวข้องกับออบเจ็กต์ บล็อก
| แอตทริบิวต์ | คำอธิบาย |
|---|---|
| โพสต์ | ส่งกลับออบเจ็กต์ โพสต์ในบล็อก ที่ประกอบด้วยโพสต์ในบล็อกทั้งหมดสำหรับบล็อก |
| ชื่อ | ชื่อของบล็อก |
| ชื่อเรื่อง | ชื่อบล็อก |
| URL | URL ของบล็อก |
ออบเจ็กต์โพสต์ในบล็อก
ออบเจ็กต์โพสต์ในบล็อกช่วยให้คุณสามารถเข้าถึงคอลเลกชันของออบเจ็กต์โพสต์ในบล็อก คุณสามารถสั่งโพสต์ในบล็อกและบรรลุการแบ่งหน้าได้ นอกเหนือจากการใช้ตัวกรองแบบไม่ตายตัว:
{% assign blogposts = blogs.posts | order\_by “adx\_name”, “desc” | paginate: 0,4 | all %}
ตัวเลือกอื่น ๆ ที่เป็นไปได้:
blogs.posts.all(เพื่อรับโพสต์บล็อกทั้งหมด)blogs.posts | from\_index: 0 | take: 2
ตารางต่อไปนี้อธิบายแอตทริบิวต์ที่หลากหลายที่เกี่ยวข้องกับออบเจ็กต์ โพสต์ในบล็อก
| แอตทริบิวต์ | คำอธิบาย |
|---|---|
| ทั้งหมด | ส่งคืนออบเจ็กต์ โพสต์ในบล็อก ทั้งหมดในคอลเลกชัน |
ออบเจ็กต์โพสต์ในบล็อก
อ้างอิงถึงโพสต์ในบล็อกเดียว
ตารางต่อไปนี้อธิบายแอตทริบิวต์ที่หลากหลายที่เกี่ยวข้องกับออบเจ็กต์ โพสต์ในบล็อก
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| url | URL ของโพสต์ |
| เนื้อหา | ส่งกลับฟิลด์เนื้อหาของโพสต์ |
| ผู้สร้าง | ส่งกลับ ผู้สร้าง สำหรับโพสต์ (ซึ่งเป็นเพียงออบเจ็กต์ตารางผู้ติดต่อ) |
| ชื่อ | ชื่อของโพสต์ |
| comment_count | ส่งกลับค่าจำนวนเต็มของจำนวนข้อคิดเห็นสำหรับโพสต์ที่กำหนด |
| publish_date | วันที่ที่สร้างโพสต์ |
เอนทิตี
ข้อควรระวัง
เพื่อหลีกเลี่ยงปัญหาการเขียนสคริปต์ข้ามไซต์ (XSS) ให้ใช้ ตัวกรอง escape กับข้อมูลสตริงการเข้ารหัส HTML ทุกครั้งที่ใช้ออบเจ็กต์ Liquid ของ เอนทิตี เพื่ออ่านข้อมูลที่ผู้ใช้ให้มาซึ่งเชื่อถือไม่ได้
หมายเหตุ
บางส่วนของข้อตกลงการตั้งชื่อของ Dataverse มีการเปลี่ยนแปลง เช่น เอนทิตี Dataverse ปัจจุบันเรียกว่า ตาราง การเปลี่ยนชื่อใช้ไม่ได้กับออบเจ็กต์ Liquid ออบเจ็กต์เอนทิตี Liquid จะยังคงถูกเรียกว่า เอนทิตี
ช่วยให้คุณสามารถโหลดตาราง Dataverse ใดๆโดยรหัสได้ ถ้ามีตารางอยู่ ออบเจ็กต์ตารางจะถูกส่งกลับ ถ้าไม่พบตารางที่มีรหัสที่กำหนด 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
ออบเจ็กต์เอนทิตีให้การเข้าถึงแอตทริบิวต์ของเรกคอร์ดตาราง Dataverse
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| รหัส | รหัส GUID ของตาราง เป็นแบบสตริง ตัวอย่างเช่น 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| logical_name | ชื่อทางตรรกะ Dataverse ของตาราง |
| บันทึกย่อ | โหลดบันทึกย่อใดๆ (คำอธิบายประกอบ) ที่เกี่ยวข้องกับตาราง ซึ่งเรียงลำดับจากเก่าที่สุดไปหาใหม่ที่สุด (สร้างเมื่อ) บันทึกย่อจะถูกส่งกลับเป็นออบเจ็กต์หมายเหตุ |
| สิทธิ์ | โหลดผลลัพธ์การยืนยันสิทธิ์ของตารางสำหรับตาราง มีการส่งกลับผลลัพธ์เป็นออบเจ็กต์สิทธิ์ |
| url | ส่งกลับค่าเส้นทาง URL ของระบบการจัดการเนื้อหา Power Pages สำหรับตาราง ถ้าตารางมี URL ที่ไม่ถูกต้องในเว็บไซต์ปัจจุบัน ให้ส่งกลับ null โดยทั่วไปแล้ว รายการนี้จะเท่านั้นส่งกลับค่าสำหรับตารางบางชนิดที่ได้มีการรวมเข้ากับพอร์ทัล CMS ถ้าคุณไม่มี ที่กำหนดตัวให้บริการ URL ในแอปพลิเคชันของคุณเอง |
| [ชื่อแอตทริบิวต์หรือความสัมพันธ์] | คุณสามารถเข้าถึงแอตทริบิวต์ใด ๆ ของตาราง Dataverse โดยชื่อทางตรรกะ {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }} ค่าของแอตทริบิวต์ของตารางส่วนใหญ่จะแมปโดยตรงไปที่ ชนิดแบบไม่ตายตัว: ฟิลด์ตัวเลือกสองฟิลด์แมปไปที่บูลีน ฟิลด์ข้อความไปที่สตริง ฟิลด์ที่เป็นตัวเลข/สกุลเงินไปที่ตัวเลข ฟิลด์วันที่/เวลาไปที่ออบเจ็กต์วันที่ แต่ชนิดแอตทริบิวต์บางชนิดจะถูกส่งกลับเป็นออบเจ็กต์:
{{ page.adx_webpage_entitylist.adx_name }}ในกรณีที่ความสัมพันธ์เป็นแบบสะท้อนกลับ (นั่นคือ แบบมีข้ออ้างอิงด้วยตนเอง) ออบเจ็กต์ความสัมพันธ์แบบสะท้อนกลับจะถูกส่งกลับ (มิฉะนั้น ผลลัพธ์ที่จะไม่ชัดเจน){{ page.adx_webpage_webpage.referencing.adx_name }} หมายเหตุ: การโหลดเอนทิตีที่เกี่ยวข้องจำนวนมาก หรือการเข้าถึงความสัมพันธ์จำนวนมากในเทมเพลตเดี่ยว สามารถมีผลกระทบเชิงลบต่อประสิทธิภาพการแสดงของเทมเพลต หลีกเลี่ยงการโหลดเอนทิตีที่เกี่ยวข้องสำหรับสินค้าแต่ละรายการในอาร์เรย์ ภายในลูป หากเป็นไปได้ ให้ใช้ แท็กตารางของ Dataverse เพื่อโหลดคอลเลกชันของเอนทิตี |
การอ้างอิงตารางที่เกี่ยวข้อง
ค่าแอตทริบิวต์การค้นหาจะถูกส่งกลับเป็นออบเจ็กต์การอ้างอิงตารางที่เกี่ยวข้อง ที่มีแอตทริบิวต์ดังต่อไปนี้
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| รหัส | รหัส GUID ของตารางอ้างอิง เป็นแบบสตริง ตัวอย่างเช่น 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| logical_name | ชื่อทางตรรกะของ Dataverse ของตารางที่อ้างอิง |
| Name | แอตทริบิวต์ชื่อหลักของตารางที่อ้างอิง |
บันทึกย่อ
บันทึกย่อคือ ออบเจ็กต์ตารางที่ให้การเข้าถึงแอตทริบิวต์และความสัมพันธ์ของเรกคอร์ด คำอธิบายประกอบ นอกเหนือจากแอตทริบิวต์ทั้งหมดของออบเจ็กต์ตาราง บันทึกย่อมีแอตทริบิวต์เพิ่มเติมดังต่อไปนี้
| แอตทริบิวต์ | คำอธิบาย |
|---|---|
| เนื้อหาเอกสาร | โหลดแอตทริบิวต์ เนื้อหาเอกสาร ของเรกคอร์ด คำอธิบายประกอบ ของบันทึกย่อ เป็นแบบสตริงที่เข้ารหัสแบบ Base64 เนื่องจากเนื้อหาของแอตทริบิวต์นี้อาจมีขนาดใหญ่ จะไม่มีการโหลดกับส่วนเหลือของแอททริบิวต์บันทึกย่อ แต่จะโหลดตามความต้องการเท่านั้น หมายเหตุ: ใช้แอตทริบิวต์ เนื้อหาเอกสาร อาจมีผลกระทบเชิงลบต่อประสิทธิภาพการแสดงของเทมเพลต และควรดำเนินการด้วยความระมัดระวัง ใช้แอตทริบิวต์ URL เพื่อให้ลิงก์กับสิ่งที่แนบของบันทึกย่อแทน ถ้าเป็นไปได้ |
| URL | ส่งกลับเส้นทางของ URL สำหรับตัวจัดการสิ่งที่แนบคำอธิบายประกอบของพอร์ทัลแบบภายใน ถ้าผู้ใช้มีสิทธิ์ และบันทึกย่อมีไฟล์ที่แนบมา คำขอไปยัง URL นี้จะดาวน์โหลดไฟล์บันทึกย่อที่แนบมา |
หมายเหตุ
ค่าชุดตัวเลือก
ค่าแอตทริบิวต์ชุดตัวเลือก/รายการให้เลือกจะถูกส่งกลับเป็นออบเจ็กต์การอ้างอิงของตารางที่เกี่ยวข้อง ที่มีแอตทริบิวต์ดังต่อไปนี้
| แอตทริบิวต์ | คำอธิบาย |
|---|---|
| ป้ายชื่อ | ป้ายชื่อที่เป็นภาษาท้องถิ่นของค่าแอททริบิวต์ชุดตัวเลือก/รายการให้เลือก ตัวอย่างเช่น ใช้งานอยู่ |
| มูลค่า | ค่าจำนวนเต็มของค่าแอททริบิวต์ชุดตัวเลือก/รายการให้เลือก ตัวอย่างเช่น 0 |
สิทธิ์อนุญาตใช้ตาราง
ออบเจ็กต์สิทธิ์ของตารางให้เข้าถึงไปยังผลลัพธ์การยืนยันสิทธิ์รวมสำหรับตาราง
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| can_append | ส่งกลับค่า True ถ้าผู้ใช้ปัจจุบันมีสิทธิ์ในการผนวกเรกคอร์ดไปยังความสัมพันธ์ของเรกคอร์ดนี้ มิฉะนั้น ส่งกลับค่า False |
| can_append_to | ส่งกลับค่า True ถ้าผู้ใช้ปัจจุบันมีสิทธิ์ในการผนวกเรกคอร์ดนี้ไปยังความสัมพันธ์ของตารางอีกรายการหนึ่ง มิฉะนั้น ส่งกลับค่า False |
| can_create | ส่งกลับค่า True ถ้าผู้ใช้ปัจจุบันมีสิทธิ์ในการสร้างเรกคอร์ดใหม่ของชนิดตารางนี้ มิฉะนั้น ส่งกลับค่า False |
| can_delete | ส่งกลับค่า True ถ้าผู้ใช้ปัจจุบันมีสิทธิ์ในการลบเรกคอร์ดนี้ มิฉะนั้น ส่งกลับค่า False |
| can_read | ส่งกลับค่า True ถ้าผู้ใช้ปัจจุบันมีสิทธิ์ในการอ่านเรกคอร์ดนี้ มิฉะนั้น ส่งกลับค่า False |
| can_write | ส่งกลับค่า True ถ้าผู้ใช้ปัจจุบันมีสิทธิ์ในการปรับปรุงเรกคอร์ดนี้ มิฉะนั้น ส่งกลับค่า False |
| rules_exist | ส่งกลับค่าจริง ถ้าผลลัพธ์สิทธิ์ที่แสดงโดยออบเจ็กต์นี้ เป็นผลของกฎของสิทธิ์ที่ถูกกำหนดไว้อย่างชัดเจน ส่งกลับค่าเท็จ ถ้าเป็นผลลัพธ์ค่าเริ่มต้นในการขาดหายของสิทธิ์ที่ถูกกำหนดไว้อย่างชัดเจน |
ความสัมพันธ์แบบสะท้อนกลับ
ความพยายามที่จะโหลดความสัมพันธ์แบบสะท้อนกลับ (นั่นคือ แบบมีข้ออ้างอิงด้วยตนเอง) บนเอนทิตี จะถูกส่งกลับเป็นออบเจ็กต์ที่มีแอตทริบิวต์ต่อไปนี้
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| is_reflexive | ส่งกลับค่า True สามารถใช้เพื่อทดสอบว่า ออบเจ็กต์ที่ถูกส่งกลับโดยความสัมพันธ์เป็นออบเจ็กต์ความสัมพันธ์แบบสะท้อนกลับหรือไม่ |
| ที่อ้างอิง | ส่งกลับอาร์เรย์ของเอนทิตีที่อ้างอิงสำหรับความสัมพันธ์ที่กำหนดไว้ |
| การอ้างอิง | ส่งกลับตารางที่อ้างอิงสำหรับความสัมพันธ์ที่กำหนดไว้ ส่งกลับค่า Null ถ้าไม่มีตารางที่อ้างอิง ถ้าความสัมพันธ์เป็นกลุ่มต่อ-กลุ่ม (N:N) ให้ส่งกลับอาร์เรย์ของเอนทิตีที่อ้างอิง |
รายการเอนทิตี
ออบเจกต์รายการเอนทิตีถูกใช้ภายใน แท็กตาราง Dataverse ให้การเข้าถึงแอตทริบิวต์ทั้งหมดของรายการที่กำหนด
หมายเหตุ
แอตทริบิวต์
หมายเหตุ
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| create_enabled | ส่งคืนค่า True ถ้ามีการตั้งค่าคอนฟิกการสร้างเรกคอร์ดใหม่สำหรับรายการ มิฉะนั้น ส่งกลับค่า False |
| create_url | ส่งคืนเส้นทาง URL ที่ตั้งค่าคอนฟิกแล้วสำหรับลิงก์/ปุ่มการสร้าง สำหรับรายการ |
| detail_enabled | ส่งคืน True ถ้ามีการตั้งค่าคอนฟิกมุมมองโดยละเอียดสำหรับเรกคอร์ดแต่ละรายการสำหรับรายการ มิฉะนั้น ส่งกลับค่า False |
| detail_id_parameter | ส่งคืนชื่อพารามิเตอร์สตริงการสอบถามที่จะใช้สำหรับรหัสเรกคอร์ด เมื่อมีการสร้าง URL ของมุมมองโดยละเอียดของเรกคอร์ด ดู ตัวกรอง URL สำหรับรายละเอียดเกี่ยวกับการใช้ตัวกรองแบบไม่ตายตัวเพื่อสร้าง URL ตัวอย่างเช่น id |
| detail_label | ส่งคืนป้ายชื่อที่แปลและตั้งค่าคอนฟิกแล้วสำหรับลิงก์/ปุ่มมุมมองโดยละเอียด สำหรับรายการ |
| detail_url | ส่งคืนเส้นทาง URL ที่ตั้งค่าคอนฟิกแล้วสำหรับลิงก์/ปุ่มมุมมองโดยละเอียด สำหรับรายการ |
| empty_list_text | ส่งคืนข้อความที่แปลและตั้งค่าคอนฟิกแล้วที่จะแสดงเมื่อมุมมองรายการไม่ส่งคืนค่าผลลัพธ์ |
| enable_entity_permissions | ส่งคืน True ถ้าการกรองสิทธิ์ตารางถูกเปิดใช้งานสำหรับรายการนี้ มิฉะนั้น ส่งกลับค่า False |
| entity_logical_name | ส่งคืนชื่อทางตรรกะของตาราง Dataverse สำหรับเรกคอร์ดที่จะถูกแสดงโดยรายการนี้ ตัวอย่างเช่น ผู้ติดต่อ |
| filter_account_attribute_name | ส่งคืนชื่อทางตรรกะของแอตทริบิวต์สำหรับการค้นหาไปยัง บัญชี ที่จะถูกใช้กรองเรกคอร์ดผลลัพธ์โดยลูกค้าองค์กรหลักของผู้ใช้พอร์ทัลปัจจุบัน ตัวอย่างเช่น accountid |
| filter_apply_label | ส่งคืนป้ายชื่อที่ที่แปลและตั้งค่าคอนฟิกแล้วที่จะใช้สำหรับลิงก์/ปุ่ม ที่นำตัวกรองแอตทริบิวต์ขั้นสูงไปใช้กับผลลัพธ์รายการ |
| filter_definition | ส่งคืนข้อกำหนดตัวกรองของแอตทริบิวต์ JSON สำหรับรายการ ดู ตัวกรองรายการ สำหรับรายละเอียดเกี่ยวกับวิธีการใช้ตัวกรองแบบไม่ตายตัว metafilters ในการประมวลผลข้อกำหนดนี้ |
| filter_enabled | ส่งคืน True ถ้าการกรองแอตทริบิวต์ขั้นสูงถูกเปิดใช้งานสำหรับรายการ มิฉะนั้น ส่งกลับค่า False |
| filter_portal_user_attribute_name | ส่งคืนชื่อทางตรรกะของแอตทริบิวต์สำหรับการค้นหาไปยัง ผู้ติดต่อ ที่จะถูกใช้กรองเรกคอร์ดผลลัพธ์โดยผู้ติดต่อของผู้ใช้พอร์ทัลปัจจุบัน ตัวอย่างเช่น contactid |
| filter_website_attribute_name | ส่งคืนชื่อทางตรรกะของแอตทริบิวต์สำหรับการค้นหาไปยัง adx_website ที่จะถูกใช้กรองเรกคอร์ดผลลัพธ์โดยเว็บไซต์พอร์ทัลปัจจุบัน ตัวอย่างเช่น adx_websiteid |
| language_code | ส่งคืนรหัสภาษาแบบจำนวนเต็มของ Dataverse ที่จะถูกใช้เพื่อเลือกป้ายชื่อที่แปลแล้วทั้งหมดสำหรับรายการนี้ |
| page_size | ส่งคืนขนาดของเพจผลลัพธ์ที่ตั้งค่าคอนฟิกไว้สำหรับรายการ |
| primary_key_name | ส่งคืนชื่อทางตรรกะของแอตทริบิวต์ของคีย์หลักสำหรับเรกคอร์ดที่จะถูกแสดงโดยรายการนี้ |
| search_enabled | ส่งคืน True ถ้าการค้นหาถูกเปิดใช้งานสำหรับรายการนี้ มิฉะนั้น ส่งกลับค่า False |
| search_placeholder | ส่งคืนข้อความที่แปลและตั้งค่าคอนฟิกแล้วสำหรับตัวยึดของฟิลด์การค้นหารายการ |
| search_tooltip | ส่งคืนข้อความที่แปลและตั้งค่าคอนฟิกแล้วสำหรับคำแนะนำเครื่องมือของฟิลด์การค้นหารายการ |
| มุมมอง | ส่งคืนมุมมองที่พร้อมใช้งานสำหรับรายการ เป็นออบเจ็กต์มุมมองของรายการ |
| [ชื่อตรรกะของแอตทริบิวต์] | คุณสามารถเข้าถึงแอตทริบิวต์ใด ๆ ของเรกคอร์ด Dataverse (adx_entitylist) ของรายการโดยชื่อทางตรรกะ ในแบบเดียวกับออบเจ็กต์ ตาราง ได้ ตัวอย่างเช่น {{ entitylist.adx_name }} |
แอตทริบิวต์มุมมองของรายการ
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| คอลัมน์ | ส่งคืนคอลัมน์ของมุมมอง เป็นออบเจ็กต์คอลัมน์มุมมองของรายการ |
| entity_logical_name | ส่งคืนชื่อทางตรรกะของตาราง Dataverse สำหรับเรกคอร์ดที่รวมอยู่ในมุมมอง ตัวอย่างเช่น ผู้ติดต่อ |
| รหัส | ส่งคืนรหัส GUID ของมุมมอง |
| language_code | ส่งคืนรหัสภาษาแบบจำนวนเต็มของ Dataverse ที่จะถูกใช้เพื่อเลือกป้ายชื่อที่แปลแล้วทั้งหมด (ส่วนหัวของคอลัมน์ เป็นต้น) สำหรับมุมมอง |
| Name | ส่งคืนชื่อที่แสดงของ Dataverse ของมุมมอง |
| primary_key_logical_name | ส่งคืนชื่อทางตรรกะของคึย์หลักของตาราง Dataverse สำหรับเรกคอร์ดที่รวมอยู่ในมุมมอง ตัวอย่างเช่น contactid |
| sort_expression | ส่งคทนนิพจน์การเรียงลำดับค่าเริ่มต้นสำหรับมุมมอง ตัวอย่างเช่น name ASC, createdon DESC |
แอตทริบิวต์คอลัมน์มุมมองของรายการ
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| attribute_type | ส่งคืนชื่อชนิดของแอตทริบิวต์ Dataverse สำหรับคอลัมน์ เป็นสตริง ตัวอย่างเช่น การค้นหา รายการให้เลือก สตริง บูลีน วันที่และเวลา |
| logical_name | ส่งคืนชื่อทางตรรกะของแอตทริบิวต์ Dataverse สำหรับคอลัมน์ เป็นสตริง ตัวอย่างเช่น createdon |
| ชื่อ | ส่งคืนชื่อที่แสดงของ Dataverse ที่แปลแล้วสำหรับคอลัมน์ ตัวอย่างเช่น Created On |
| sort_ascending | ส่งคืนสตริงนิพจน์การเรียงลำดับสำหรับเรียงลำดับคอลัมน์จากน้อยไปหามาก ตัวอย่างเช่น createdon ASC |
| sort_descending | ส่งคืนสตริงนิพจน์การเรียงลำดับสำหรับเรียงลำดับคอลัมน์จากมากไปหาน้อย ตัวอย่างเช่น createdon DESC |
| sort_disabled | ส่งคืน True ถ้ามีการปิดใช้งานการเรียงลำดับสำหรับคอลัมน์ มิฉะนั้น ส่งกลับค่า False |
| sort_enabled | ส่งคืน True ถ้ามีการเปิดใช้งานการเรียงลำดับสำหรับคอลัมน์ มิฉะนั้น ส่งกลับค่า False |
| width | ส่งคืนความกว้างที่ตั้งค่าคอนฟิกแล้วสำหรับคอลัมน์ เป็นพิกเซล |
มุมมองเอนทิตี:
ออบเจ็กต์ มุมมองเอนทิตี ถูกใช้ภายในแท็กมุมมองเอนทิตี และให้การเข้าถึงเมตาดาต้าสำหรับมุมมอง นอกเหนือจากเรกคอร์ดผลลัพธ์ของมุมมอง
แอตทริบิวต์
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| คอลัมน์ | ส่งคืนคอลัมน์ในมุมมอง เป็น ออบเจ็กต์คอลัมน์มุมมองของรายการตาราง |
| entity_permission_denied | ส่งคืน True ถ้าการเข้าถึงเพื่อดูผลถูกปฏิเสธ เนื่องจากมีสิทธิ์ของตารางไม่เพียงพอสำหรับผู้ใช้ปัจจุบัน ส่งคืน False ถ้าได้รับการเข้าการอ่านในการดูผลลัพธ์ |
| entity_logical_name | ชื่อทางตรรกะของตาราง Dataverse ของเรกคอร์ดผลลัพธ์ของมุมมอง ตัวอย่างเช่น ผู้ติดต่อ |
| first_page | หมายเลขเพจของเพจแรกของผลลัพธ์ของมุมมอง สิ่งนี้จะเป็น 1 เว้นแต่ถ้ามีผลลัพธ์ถูกส่งคืน ในกรณีนี้จะเป็น Null |
| Id | รหัส GUID ของมุมมอง Dataverse ที่กำหนดมุมมองเอนทิตีนี้ |
| language_code | รหัสภาษาแบบจำนวนเต็มของ Dataverse ที่กำลังถูกใช้เพื่อโหลดป้ายชื่อที่เป็นภาษาท้องถิ่นสำหรับมุมมองปัจจุบัน |
| last_page | หมายเลขเพจของเพจสุดท้ายของผลลัพธ์ของมุมมอง ถ้าไม่มีการส่งคืนผลลัพธ์ นี่จะเป็น Null |
| ชื่อ | ชื่อของมุมมอง Dataverse ที่กำหนดมุมมองเอนทิตีนี้ ตัวอย่างเช่น ผู้ติดต่อที่ใช้งานอยู่ |
| next_page | หมายเลขเพจของเพจถัดไปของผลลัพธ์ของมุมมอง ถ้าไม่มีหน้าถัดไปของผลลัพธ์ นี่จะเป็น Null |
| เพจ | หมายเลขเพจของเพจปัจจุบันของผลลัพธ์ของมุมมอง |
| หน้า | ส่งคืนอาร์เรย์ของหมายเลขเพจที่ประกอบด้วย เพจทุกเพจของผลลัพธ์สำหรับมุมมองปัจจุบัน |
| page_size | จำนวนของผลลัพธ์ที่ส่งคืนต่อเพจสำหรับมุมมองปัจจุบัน |
| previous_page | หมายเลขเพจของเพจถัดไปของผลลัพธ์ของมุมมอง ถ้าไม่มีหน้าก่อนหน้าของผลลัพธ์ นี่จะเป็น Null |
| primary_key_logical_name | ชื่อตรรกะ Dataverse ของแอตทริบิวต์คีย์หลักของตารางผลลัพธ์สำหรับมุมมองนี้ ตัวอย่างเช่น รหัสผู้ติดต่อ |
| เรกคอร์ด | เพจปัจจุบันของเรกคอร์ดผลลัพธ์สำหรับมุมมอง เป็นออบเจ็กต์ของตาราง |
| sort_expression | นิพจน์การเรียงลำดับค่าเริ่มต้นสำหรับมุมมอง ตัวอย่างเช่น nameASC, createdon DESC |
| total_pages | จำนวนรวมของเพจผลลัพธ์สำหรับมุมมอง |
| total_records | จำนวนรวมของผลลัพธ์สำหรับมุมมอง (รวมเพจทั้งหมด) |
เหตุการณ์
ให้ความสามารถในการเข้าถึงและแสดงเหตุการณ์ ออบเจ็กต์เหตุการณ์ ช่วยให้คุณสามารถเลือกเหตุการณ์เฉพาะ หรือเหตุการณ์ทั้งหมดได้
ออบเจ็กต์เหตุการณ์
ออบเจ็กต์ เหตุการณ์ ช่วยให้คุณสามารถเข้าถึงเหตุการณ์เฉพาะใดๆในพอร์ทัล หรือในการเข้าถึงเหตุการณ์ทั้งหมดในพอร์ทัล (โดยไม่คำนึงถึงเหตุการณ์)
ออบเจ็กต์ เหตุการณ์ มีแอตทริบิวต์ต่อไปนี้:
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| การเกิดขึ้น | ส่งกลับออบเจ็กต์การเกิดขึ้นของเหตุการณ์ ที่ประกอบด้วยการเกิดขึ้นของเหตุการณ์ทั้งหมดในพอร์ทัล |
| [ชื่อหรือรหัสเหตุการณ์] | คุณสามารถเข้าถึงเหตุการณ์ใดๆ ตามคุณสมบัติของชื่อหรือรหัส {% assign event = events["Event Name"] %} {% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
ออบเจ็กต์เหตุการณ์
ออบเจ็กต์ เหตุการณ์ ช่วยให้คุณสามารถทำงานกับเหตุการณ์เดี่ยวได้ ซึ่งทำให้คุณสามารถเข้าถึงกำหนดการและการเกิดขึ้นสำหรับเหตุการณ์นั้นได้
ออบเจ็กต์ เหตุการณ์ มีแอตทริบิวต์ต่อไปนี้:
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| การเกิดขึ้น | ส่งกลับออบเจ็กต์การเกิดขึ้นของเหตุการณ์ ที่ประกอบด้วยการเกิดขึ้นทั้งหมดของเหตุการณ์ |
| ชื่อ | ชื่อของเหตุการณ์ |
| URL | URL ของเหตุการณ์ |
ออบเจ็กต์การเกิดขึ้นของเหตุการณ์
ออบเจ็กต์การเกิดขึ้นของเหตุการณ์ ช่วยให้คุณสามารถเข้าถึงคอลเลกชันของออบเจ็กต์การเกิดขึ้นของเหตุการณ์ได้ คุณสามารถสั่งการเกิดเหตุการณ์ และระบุช่วงวันที่สำหรับการเกิดขึ้นเพื่อดึงข้อมูล และทำการแบ่งหน้าให้สำเร็จได้ด้วยการใช้ตัวกรองแบบไม่ตายตัว
{% assign occurances = event.occurrences.from[today].to[advance_date] %}
โปรดทราบว่า
{% assign occurances = event.occurrences.min[today].max[advance_date] %}
อาจเป็นไปได้
แอตทริบิวต์ต่อไปนี้เกี่ยวข้องกับออบเจ็กต์การเกิดขึ้นของเหตุการณ์
| แอตทริบิวต์ | คำอธิบาย |
|---|---|
| ทั้งหมด | ส่งคืน ออบเจ็กต์การเกิดขึ้นของเหตุการณ์ ทั้งหมดในคอลเลกชัน |
ออบเจ็กต์การเกิดขึ้นของเหตุการณ์
แสดงถึงการเกิดขึ้นของเหตุการณ์เดี่ยว แอตทริบิวต์ที่เกี่ยวข้องจะถูกแสดงด้านล่างนี้:
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| 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 ถ้าไม่ใช่การเกิดซ้ำครั้งสุดท้าย |
| ความยาว | ส่งกลับจำนวนการเกิดซ้ำสำหรับลูป ߝ หมายเลขของรายการในคอลเลกชันที่กำลังถูกทำซ้ำ |
| ดัชนี | จำนวนของรายการที่คงเหลือในลูป (ความยาว - ดัชนี) ที่ 1 เป็นดัชนีของรายการสุดท้าย |
| ดัชนี0 | จำนวนของรายการที่คงเหลือในลูป (ความยาว - ดัชนี) ที่ 0 เป็นดัชนีของรายการสุดท้าย |
ฟอรั่ม
ให้สามารถเข้าถึงและแสดงฟอรั่มและเธรดฟอรั่มได้ ความสามารถในการใช้แบบไม่ตายตัวเพื่อแสดงข้อมูลฟอรั่มขยายไปยังโพสต์ แต่เพื่อที่จะสร้างโพสต์หรือเธรดใหม่ คุณต้องใช้เทมเพลตหน้าฟอร์มแบบหลายขั้นตอน 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>
ออบเจ็กต์ฟอรั่ม
ออบเจ็กต์ฟอรั่มช่วยให้คุณสามารถเข้าถึงฟอรั่มเฉพาะใดๆในพอร์ทัล หรือเข้าถึงเธรดฟอรั่มทั้งหมดในพอร์ทัล (โดยไม่คำนึงถึงฟอรั่ม)
ออบเจ็กต์ ฟอรั่ม ช่วยให้คุณสามารถทำงานกับฟอรั่มเดี่ยวได้ ซึ่งอนุญาตให้คุณสามารถเข้าถึงชุดกิจกรรมที่เกิดขึ้นสำหรับฟอรั่มนั้นๆ
ออบเจ็กต์เธรดฟอรั่มช่วยให้คุณสามารถเข้าถึงคอลเลกชันของออบเจ็กต์เธรดฟอรั่มได้ คุณสามารถเรียงลำดับชุดกิจกรรมที่เกิดขึ้นฟอรั่ม และบรรลุการแบ่งหน้าด้วยการใช้ตัวกรองแบบไม่ตายตัว:
{% assign threads = forum.threads | order_by adx_name, desc | paginate: 0,4 | all %}
เธรดฟอรัมแบบเดี่ยว
ออบเจ็กต์โพสต์ในฟอรั่มช่วยให้คุณสามารถเข้าถึงคอลเลกชันของออบเจ็กต์โพสต์ในฟอรั่มได้
แอตทริบิวต์
| แอตทริบิวต์ | คำอธิบาย |
|---|---|
| ชุดกิจกรรมที่เกิดขึ้น | ส่งกลับออบเจ็กต์ ชุดกิจกรรมที่เกิดขึ้นในฟอรั่ม ที่ประกอบด้วย ออบเจ็กต์ชุดกิจกรรมที่เกิดขึ้นในฟอรั่ม ทั้งหมดในพอร์ทัล |
| ทั้งหมด | ส่งคืน ออบเจ็กต์ฟอรั่ม ทั้งหมดในพอร์ทัล หมายเหตุว่า website.forums มีค่าเท่ากันด้วยเหมือนกัน |
| thread_count | ส่งคืนค่าจำนวนเต็มของการตรวจนับของจำนวนชุดกิจกรรมที่เกิดขึ้นที่มีอยู่ในเว็บไซต์ทั้งหมด |
| post_count | ส่งกลับค่าจำนวนเต็มของจำนวนทั้งหมดของการโพสต์ในพอร์ทัล |
| [ชื่อหรือรหัสฟอรั่ม] | คุณสามารถเข้าถึงฟอรั่มใดๆ ตามคุณสมบัติของชื่อหรือรหัส `{% assign forum = forums[Forum Name] %} {% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %} |
ออบเจ็กต์ฟอรั่ม
แอตทริบิวต์
หมายเหตุ
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| ชุดกิจกรรมที่เกิดขึ้น | ส่งคืนออบเจ็กต์ ชุดกิจกรรมที่เกิดขึ้นในฟอรั่ม ที่ประกอบด้วยฟอรั่มชุดกิจกรรมที่เกิดขึ้นทั้งหมดสำหรับฟอรั่ม |
| Name | ชื่อของฟอรั่ม |
| thread_count | ส่งคืนค่าจำนวนเต็มของการตรวจนับของจำนวนชุดกิจกรรมที่เกิดขึ้นที่มีอยู่ในฟอรั่ม |
| post_count | ส่งคืนค่าจำนวนเต็มของการตรวจนับของจำนวนโพสต์ที่มีอยู่ในฟอรั่มทั้งหมด |
ออบเจ็กต์ชุดกิจกรรมที่เกิดขึ้นในฟอรั่ม
แอตทริบิวต์
| แอตทริบิวต์ | คำอธิบาย |
|---|---|
| ทั้งหมด | ส่งคืน ออบเจ็กต์ชุดกิจกรรมที่เกิดขึ้นในฟอรั่ม ทั้งหมดในคอลเลกชัน |
ออบเจ็กต์ชุดกิจกรรมที่เกิดขึ้นในฟอรั่ม
แอตทริบิวต์
หมายเหตุ
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| โพสต์ | ส่งคืนออบเจ็กต์ โพสต์ฟอรั่ม ที่ประกอบด้วยโพสต์ฟอรั่มทั้งหมดสำหรับชุดกิจกรรมที่เกิดขึ้น |
| ผู้สร้าง | ส่งกลับ ผู้สร้าง สำหรับชุดกิจกรรมที่เกิดขึ้น (ซึ่งเป็นเพียงออบเจ็กต์ตารางผู้ติดต่อ) |
| latest_post | ส่งคืนโพสต์ล่าสุดในเธรด |
| first_post | ส่งคืนโพสต์แรกในเธรด |
| post_count | ส่งคืนค่าจำนวนเต็มของการตรวจนับของจำนวนโพสต์ที่มีอยู่ในชุดกิจกรรมที่เกิดขึ้น |
| is_answered | เธรดได้รับการตอบแล้วหรือไม่ |
| is_sticky | เธรดเป็นเธรดแบบตรึงหรือไม่ |
ออบเจ็กต์โพสต์ฟอรั่ม
แอตทริบิวต์
| แอตทริบิวต์ | คำอธิบาย |
|---|---|
| ทั้งหมด | ส่งคืน ออบเจ็กต์ชุดกิจกรรมที่เกิดขึ้นในฟอรั่ม ทั้งหมดในคอลเลกชัน |
โพสต์ฟอรัมแบบเดี่ยว
แอตทริบิวต์
หมายเหตุ
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| ผู้สร้าง | ส่งกลับ ผู้สร้าง สำหรับโพสต์ (ซึ่งเป็นเพียงออบเจ็กต์ตารางผู้ติดต่อ) |
| เนื้อหา | เนื้อหาของโพสต์ |
| is_answer | โพสต์นี้เป็นคำตอบให้กับชุดกิจกรรมที่เกิดขึ้นหรือไม่ |
ความรู้
ให้การเข้าถึงเรกคอร์ด Dataverse knowledgearticle และตารางประเภทเพื่อแสดงบทความและประเภทในพอร์ทัล
แอตทริบิวต์
| แอตทริบิวต์ | คำอธิบาย |
|---|---|
| บทความ | ส่งกลับวัตถุของบทความที่ประกอบด้วยวัตถุของบทความสำหรับเรกคอร์ดตาราง knowledgearticle ที่พร้อมใช้งานในพอร์ทัล |
| ประเภท | ส่งกลับวัตถุของประเภทที่ประกอบด้วยวัตถุของประเภทสำหรับเรกคอร์ดตารางประเภทที่พร้อมใช้งานในพอร์ทัล |
วัตถุของบทความ
วัตถุของบทความช่วยให้คุณสามารถเข้าถึงคอลเลกชันของวัตถุของบทความได้ คุณสามารถเรียงลำดับบทความ และบรรลุการแบ่งหน้าด้วยการใช้ตัวกรองแบบไม่ตายตัว
{% 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 %} |
วัตถุของบทความ
วัตถุของบทความช่วยให้คุณทำงานกับ knowledgearticle เดียวเพื่อแสดงรายละเอียดของบทความนั้นในพอร์ทัล
แอตทริบิวต์
บทความคือวัตถุของ เอนทิตี ที่มีแอตทริบิวต์เดียวกันทั้งหมด นอกเหนือจากรายการเหล่านั้นด้านล่าง
| แอตทริบิวต์ | คำอธิบาย |
|---|---|
| article_public_number | หมายเลขบทความสาธารณะของบทความ |
| comment_count | ค่าจำนวนเต็มของจำนวนข้อคิดเห็นสำหรับบทความที่กำหนด |
| เนื้อหา | เนื้อหาของบทความ |
| current_user_can_comment | ส่งกลับค่าบูลีนที่บ่งชี้ว่าผู้ใช้ปัจจุบันสามารถเพิ่มข้อคิดเห็นในบทความได้หรือไม่ |
| is_rating_enabled | ส่งกลับค่าบูลีนที่บ่งชี้ว่าการจัดอันดับสำหรับบทความมีการเปิดใช้งานอยู่หรือไม่ |
| คำสำคัญ | คำสำคัญในบทความ |
| ชื่อ | นามแฝงอื่นสำหรับชื่อเรื่องของบทความ |
| การจัดอันดับ | ค่าการจัดอันดับฐานสิบในบทความ |
| ชื่อเรื่อง | ชื่อของบทความ |
| view_count | ค่าจำนวนเต็มของจำนวนครั้งที่มีการดูบทความ |
วัตถุของประเภท
วัตถุของประเภทช่วยให้คุณทำงานกับประเภทเดียวเพื่อแสดงรายละเอียดของบทความนั้นในพอร์ทัล
แอตทริบิวต์
ประเภทคือวัตถุของ เอนทิตี ที่มีแอตทริบิวต์เดียวกันทั้งหมด นอกเหนือจากรายการเหล่านั้นด้านล่าง
| แอตทริบิวต์ | คำอธิบาย |
|---|---|
| categorynumber | หมายเลขประเภทของประเภท |
| ชื่อ | นามแฝงอื่นสำหรับชื่อเรื่องของประเภท |
| ตำแหน่ง | ชื่อของประเภท |
ภาษา
ระบุชื่อภาษาปัจจุบันและรหัสภาษา หากเปิดใช้งาน รองรับหลายภาษา
แอตทริบิวต์
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| url | URL คำขอปัจจุบันขึ้นต้นด้วยรหัสภาษาปัจจุบัน |
| url_substitution | URL คำขอปัจจุบันที่นำหน้าด้วยรหัสภาษาปัจจุบันโดยข้ามแคชผลลัพธ์ของเพจ |
| ชื่อ | ชื่อของภาษาปัจจุบัน |
| รหัส | รหัสภาษาของภาษา |
ตัวอย่างเช่น เทมเพลตเว็บ รายการภาษาแบบเลื่อนลง โดยค่าเริ่มต้นใช้วัตถุเหลวนี้เพื่อแสดงรายการภาษาที่มีให้ใช้งานเมื่อมีหลายภาษา
หน้า
อ้างอิงไปยังเพจที่ร้องขอพอร์ทัลปัจจุบัน ออบเจ็กต์นี้เชื่ิอมแอตทริบิวต์ของ แผนผังเว็บไซต์ และคำขอปัจจุบัน เอนทิตี (โดยปกติจะเป็นเว็บเพจ)
ออบเจ็กต์เพจ ทำให้สามารถเข้าถึงสิ่งต่างๆ เช่น breadcrumbs สำหรับเพจปัจจุบัน หัวข้อหรือ URL ของเพจปัจจุบัน และแอตทริบิวต์อื่นใดหรือเอนทิตีที่เกี่ยวข้องของเรกคอร์ด Dataverse พื้นฐาน
<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 | ส่งกลับวัตถุโหนดแผนผังเว็บไซต์แบบ breadcrumb สำหรับเพจ ซึ่งเริ่มต้นจากโหนดรากของแผนผังเว็บไซต์ และสิ้นสุดที่ หลัก |
| รอง | ส่งกลับออบเจ็กต์โหนดแผนผังเว็บไซต์รองของเพจ |
| หลัก | ส่งกลับโหนดแผนผังเว็บไซต์หลักของเพจ ถ้าเพจเป็นโฮมเพจ หลัก จะเป็น Null |
| ชื่อ | หัวข้อของเพจ |
| url | URL ของเพจ |
| [ชื่อแอตทริบิวต์หรือความสัมพันธ์] | คุณสามารถเข้าถึงแอตทริบิวต์ใดๆของเรกคอร์ด Dataverse พื้นฐานของเพจโดยชื่อทางตรรกะ{{ page.createdon }}{% assign attribute_name = 'name' %}{{ page[attribute_name] }}ค่าของแอตทริบิวต์ของตารางส่วนใหญ่จะแมปโดยตรงไปที่ ชนิดแบบไม่ตายตัว: ฟิลด์ตัวเลือกสองฟิลด์แมปไปที่บูลีน ฟิลด์ข้อความไปที่สตริง ฟิลด์ที่เป็นตัวเลข/สกุลเงินไปที่ตัวเลข ฟิลด์วันที่/เวลาไปที่ออบเจ็กต์วันที่ แต่ชนิดแอตทริบิวต์บางชนิดจะถูกส่งกลับเป็นออบเจ็กต์:
{{ page.adx_webpage_entitylist.adx_name }}ในกรณีที่ความสัมพันธ์เป็นแบบสะท้อนกลับ (นั่นคือ แบบมีข้ออ้างอิงด้วยตนเอง) ออบเจ็กต์ เอนทิตี จะถูกส่งกลับ (มิฉะนั้น ผลลัพธ์ที่จะไม่ชัดเจน) {{ page.adx_webpage_webpage.referencing.adx_name }} หมายเหตุ: การโหลดเอนทิตีที่เกี่ยวข้องจำนวนมาก หรือการเข้าถึงความสัมพันธ์จำนวนมากในเทมเพลตเดี่ยว สามารถมีผลกระทบเชิงลบต่อประสิทธิภาพการแสดงของเทมเพลต หลีกเลี่ยงการโหลดเอนทิตีที่เกี่ยวข้องสำหรับสินค้าแต่ละรายการในอาร์เรย์ ภายในลูป หากเป็นไปได้ ให้ใช้ ให้เลือกการใช้งาน แท็กตาราง Dataverse เพื่อโหลดคอลเลกชันของเอนทิตี |
การสำรวจ
ให้ความสามารถในการเข้าถึงและการแสดงการสำรวจ
ออบเจ็กต์ การสำรวจ ช่วยให้คุณสามารถเลือกการสำรวจเฉพาะ หรือการจัดวางการสำรวจ
<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>
แอตทริบิวต์การสำรวจ
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| การกำหนดตำแหน่ง | ส่งคืนออบเจ็กต์การกำหนดตำแหน่งการสำรวจ |
| [ชื่อหรือรหัสการสำรวจ] | คุณสามารถเข้าถึงการสำรวจใดๆ ตามคุณสมบัติของชื่อหรือรหัส {% assign poll = polls[Poll Name] %}{% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %} |
แอตทริบิวต์การกำหนดตำแหน่งการสำรวจ
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| [ชื่อหรือรหัสการกำหนดตำแหน่งการสำรวจ] | คุณสามารถเข้าถึงการกำหนดตำแหน่งการสำรวจใดๆ ตามคุณสมบัติของชื่อหรือรหัสได้{% assign placement = polls.placements[Placement Name or Id] %}{% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %} |
แอตทริบิวต์การกำหนดตำแหน่งการสำรวจ
หมายเหตุ
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| Name | ส่งคืนชื่อฟิลด์สำหรับการกำหนดตำแหน่งการสำรวจ |
| placement_url | URL ที่สามารถถูกใช้เพื่อเรียกการกำหนดตำแหน่งการสำรวจที่แสดงโดยเท็มเพลตอย่างสมบูรณ์ |
| การสำรวจ | ส่งคืนชุดออบเจ็กต์การสำรวจที่เกี่ยวข้องกับการจัดวาง แท็กการเกิดซ้ำ และ ตัวกรองอาร์เรย์ อาจใช้กับคอลเลกชันนี้ได้ |
| random_url | URL ที่สามารถถูกใช้เพื่อเรียกการสำรวจแบบสุ่มจากการกำหนดตำแหน่งที่แสดงโดยเท็มเพลตอย่างสมบูรณ์ |
| submit_url | URL ที่ส่งแบบสำรวจความคิดเห็นที่เสร็จสมบูรณ์แล้ว |
แอตทริบิวต์การสำรวจ
หมายเหตุ
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| has_user_voted | ส่งคืนค่าจริง ถ้าผู้ใช้ปัจจุบัน (ลงชื่อเข้าใช้หรือเข้าใช้แบบไม่ระบุชื่อ) ได้ลงคะแนนในการสำรวจความคิดเห็นนี้เรียบร้อยแล้ว |
| ชื่อ | ส่งคืนชื่อฟิลด์สำหรับการสำรวจ |
| ตัวเลือก | ส่งคืนชุดออบเจ็กต์ ตัวเลือกการสำรวจ ที่เกี่ยวข้องกับการสำรวจ แท็กการเกิดซ้ำ และ เอนทิตี อาจใช้กับคอลเลกชันนี้ได้ |
| poll_url | URL ที่สามารถถูกใช้เพื่อเรียกการสำรวจที่ถูกแสดงโดยเท็มเพลตอย่างสมบูรณ์ |
| คำถาม | ส่งคืนฟิลด์คำถามสำหรับการสำรวจ |
| submit_button_label | ส่งคืนสตริงที่สามารถใช้เพื่อแทนที่ป้ายชื่อของปุ่มการส่งสำหรับการสำรวจความคิดเห็น |
| submit_url | URL ที่ส่งแบบสำรวจความคิดเห็นที่เสร็จสมบูรณ์แล้ว |
| user_selected_option | ส่งคืนออบเจ็กต์ polloption ที่เลือกโดยผู้ใช้ (ถ้าพวกเขาได้ลงคะแนนแล้ว) |
| การลงคะแนน | ส่งคืนจำนวนของการลงคะแนนที่ถูกจัดทำเป็นตารางสำหรับการสำรวจความคิดเห็น |
แอตทริบิวต์ตัวเลือกการสำรวจ
หมายเหตุ
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| คำตอบ | ส่งคืนฟิลด์คำตอบสำหรับการสำรวจ |
| เปอร์เซ็นต์ | ส่งคืนค่าเปอร์เซ็นต์ของการลงคะแนนในการสำรวจความคิดเห็นสำหรับตัวเลือก ให้เป็นตัวเลขฐานสิบจาก 0 ถึง 100 |
| การลงคะแนน | ส่งคืนจำนวนของการลงคะแนนที่ถูกจัดทำเป็นตารางสำหรับตัวเลือก |
คำขอ
ประกอบด้วยข้อมูลเกี่ยวกับคำขอ HTTP ปัจจุบัน
{% assign id = request.params['id'] | escape %}
<a href={{ request.url | add_query: 'foo', 1 | escape }}>Link</a>
หมายเหตุ
- คุณสามารถสร้าง URL แบบไดนามิกในแบบที่ไม่ตายตัวได้โดยใช้ตัวกรอง URL
- URL ที่ใช้ใน request.url สามารถเป็นค่าที่ร้องขอและรับ ที่แคชไว้ สำหรับคำขอที่ตามมา เพื่อให้แน่ใจว่าค่าใน request.url ถูกต้อง ให้พิจารณาใช้ แท็กการทดแทน URL บางส่วน เช่น ~{เส้นทาง WebFile} หรือจัดเก็บ URL พอร์ทัลใน การตั้งค่าไซต์
- Power Pages รุ่น 9.3.8.x หรือหลังจากนั้นโดยปริยายจะมีตัวกรอง Liquid หลีก บังคับใช้สำหรับออบเจ็กต์ Liquid ผู้ใช้ และ คำขอ หากต้องการปิดใช้งานการกำหนดค่าเริ่มต้นนี้และอนุญาตให้ออบเจ็กต์ Liquid เหล่านี้ไม่มีตัวกรอง Liquid หลีก ดูที่ การตั้งค่าไซต์พอร์ทัล - Site/EnableDefaultHtmlEncoding
แอตทริบิวต์
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| พารามิเตอร์ | ค่าพารามิเตอร์ที่ตั้งชื่อไว้สำหรับคำขอปัจจุบัน พารามิเตอร์เป็นการรวมกันของพารามิเตอร์สตริงของแบบสอบถาม URL พารามิเตอร์การลงรายการบัญชีแบบฟอร์ม และคุกกี้ |
| Path | เส้นทางของ 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 |
ดัชนีการค้นหา
ออบเจ็กต์ดัชนีการค้นหาถูกใช้ภายใน แท็กตาราง 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 |
| ผลลัพธ์ | ส่งคืนเพจผลลัพธ์แบบสอบถาม เป็นออบเจ็กต์ผลลัพธ์ดัชนีการค้นหา |
ค้นหาผลลัพธ์ดัชนี
| แอตทริบิวต์ | คำอธิบาย |
|---|---|
| เอนทิตี | เอนทิตี พื้นฐานสำหรับผลลัพธ์ |
| ส่วนย่อย | ส่วนย่อยข้อความสั้นๆที่เกี่ยวข้องสำหรับผลลัพธ์ ที่มีเงื่อนไขที่ตรงกับแบบสอบถามที่ระบุซึ่งถูกเน้นโดยใช้แท็ก HTML <em> ชนิดของแบบสอบถามบางชนิดไม่สนับสนุนส่วนย่อยที่ถูกเน้น เช่น แบบสอบถามที่คลุมเครือ (~) และแบบสอบถามที่ใช้อักขระตัวแทน (*) คุณสมบัตินี้จะเป็น null ในกรณีดังกล่าว |
| รหัส | รหัสตาราง Dataverse ของเรกคอร์ดพื้นฐานสำหรับผลลัพธ์ เป็นสตริง ตัวอย่างเช่น 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| logical_name | ชื่อทางตรรกะตาราง Dataverse ของเรกคอร์ดพื้นฐานสำหรับผลลัพธ์ ตัวอย่างเช่น adx_webpage |
| ตัวเลข | จำนวนผลลัพธ์ ทั่วเพจผลลัพธ์ทั้งหมด ซึ่งเริ่มต้นจาก 1 ตัวอย่างเช่น สำหรับผลลัพธ์แรกในเพจที่สองของผลลัพธ์ที่มีขนาดเพจเป็น 10 ค่านี้จะเป็น 11 |
| คะแนน | คะแนน Lucene ของผลลัพธ์ เป็นค่าตัวเลขที่มีจุดทศนิยมลอยตัว ผลลัพธ์จะถูกส่งคืนซึ่งถูกเรียงลำดับโดยค่านี้ |
| ชื่อเรื่อง | หัวข้อของผลลัพธ์ |
| 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 %}
แผนผังเว็บไซต์
อนุญาตให้เข้าถึงแผนผังเว็บไซต์พอร์ทัล
<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 %}
แอตทริบิวต์แผนผังเว็บไซต์
| แอตทริบิวต์ | คำอธิบาย |
|---|---|
| ปัจจุบัน | ส่งกลับวัตถุโหนดแผนผังเว็บไซต์สำหรับเพจปัจจุบัน |
| ราก | ส่งกลับวัตถุโหนดแผนผังเว็บไซต์สำหรับเพจราก (บ้าน) ของเว็บไซต์ |
แอตทริบิวต์โหนดแผนผังเว็บไซต์
| แอตทริบิวต์ | คำอธิบาย |
|---|---|
| Breadcrumbs | ส่งกลับวัตถุโหนดแผนผังเว็บไซต์แบบ breadcrumb สำหรับโหนด ซึ่งเริ่มต้นจากโหนดรากของแผนผังเว็บไซต์ และสิ้นสุดที่ หลัก |
| รายการรอง | ส่งกลับออบเจ็กต์โหนดแผนผังเว็บไซต์รองของโหนด |
| คำอธิบาย | เนื้อหาของคำอธิบาย/ข้อมูลสรุปสำหรับโหนด (ฟิลด์นี้อาจประกอบด้วย HTML) |
| เอนทิตี | ส่งกลับ เอนทิตี พื้นฐานของโหนด ถ้าโหนดไม่มีตารางพื้นฐาน ค่านี้จะเป็น 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 ของเป้าหมายตัวทำเครื่องหมายไซต์ |
| [ชื่อตรรกะของแอตทริบิวต์] | คุณสามารถเข้าถึงแอตทริบิวต์ใดๆของเรกคอร์ด Dataverse ของเป้าหมายตัวทำเครื่องหมายไซต์โดยชื่อทางตรรกะ ตัวอย่างเช่น {{ sitemarker.adx_name }} |
Snippet
ช่วยให้คุณสามารถโหลด snippet ของเนือหาใดๆได้โดยชื่อ ถ้าไม่พบส่วนย่อยที่มีชื่อที่กำหนด null จะถูกส่งคืน
{{ snippets[Header] }}
{% assign footer = snippets[Footer] %}
{% if footer %}
{{ footer }}
{% else %}
No footer snippet was found.
{% endif %}
tablerowloop
ประกอบด้วยคุณสมบัติที่มีประโยชน์ภายใน แท็กการเกิดซ้ำ บล็อกลูป
หมายเหตุ
สามารถใช้ tablerowloop ได้ภายในแท็ก แท็กการเกิดซ้ำ เท่านั้น
แอตทริบิวต์
| แอตทริบิวต์ | คำอธิบาย |
|---|---|
| คอลัมน์ | ส่งคืนค่าดัชนีของแถวปัจจุบัน ซึ่งเริ่มต้นที่ 1 |
| col0 | ส่งคืนค่าดัชนีของแถวปัจจุบัน ซึ่งเริ่มต้นที่ 0 |
| col_first | ส่งคืน True ถ้าคอลัมน์ปัจจุบันเป็นคอลัมน์แรกในแถว ส่งคืน False ถ้าไม่ใช่ |
| col_last | ส่งคืน True ถ้าคอลัมน์ปัจจุบันเป็นคอลัมน์แรกในแถว ส่งคืน False ถ้าไม่ใช่ |
| แรก | ส่งกลับค่า True ถ้าเป็นการเกิดซ้ำครั้งแรกของลูป ส่งกลับค่า False ถ้าไม่ใช่การเกิดซ้ำครั้งแรก |
| ดัชนี | ตำแหน่งของรายการปัจจุบันในคอลเลกชัน ซึ่งรายการแรกมีตำแหน่งของ 1 |
| index0 | ตำแหน่งของรายการปัจจุบันในคอลเลกชัน ซึ่งรายการแรกมีตำแหน่งของ 0 |
| หน้าสุดท้าย | ส่งกลับค่า True ถ้าเป็นการเกิดซ้ำครั้งสุดท้ายของลูป ส่งกลับค่า False ถ้าไม่ใช่การเกิดซ้ำครั้งสุดท้าย |
| ความยาว | ส่งกลับจำนวนการเกิดซ้ำสำหรับลูป ߝ หมายเลขของรายการในคอลเลกชันที่กำลังถูกทำซ้ำ |
| ดัชนี | จำนวนของรายการที่คงเหลือในลูป (ความยาว - ดัชนี) ที่ 1 เป็นดัชนีของรายการสุดท้าย |
| ดัชนี0 | จำนวนของรายการที่คงเหลือในลูป (ความยาว - ดัชนี) ที่ 0 เป็นดัชนีของรายการสุดท้าย |
ผู้ใช้
อ้างอิงไปยังผู้ใช้พอร์ทัลปัจจุบัน ซึ่งอนุญาตให้เข้าถึงแอตทริบิวต์ทั้งหมดของเรกคอร์ดผู้ติดต่อ Dataverse พื้นฐาน ถ้าไม่มีผู้ใช้ลงชื่อเข้าใช้ ตัวแปรนี้จะเป็น null
ผู้ใช้เป็นออบเจ็กต์ เอนทิตี
{% if user %}
Hello, {{ user.fullname | escape }}!
{% else %}
Hello, anonymous user!
{% endif %}
หมายเหตุ
Power Pages รุ่น 9.3.8.x หรือหลังจากนั้นโดยปริยายจะมีตัวกรอง Liquid หลีก บังคับใช้สำหรับออบเจ็กต์ Liquid ผู้ใช้ และ คำขอ หากต้องการปิดใช้งานการกำหนดค่าเริ่มต้นนี้และอนุญาตให้ออบเจ็กต์ Liquid เหล่านี้ไม่มีตัวกรอง Liquid หลีก ดูที่ การตั้งค่าไซต์พอร์ทัล - Site/EnableDefaultHtmlEncoding
แอตทริบิวต์
นอกเหนือจากการมีแอตทริบิวต์ทั้งหมดของออบเจ็กต์ เอนทิตี ผู้ใช้มีแอตทริบิวต์ต่อไปนี้
| แอตทริบิวต์ | คำอธิบาย |
|---|---|
| บทบาท | ส่งกลับค่าบทบาทไปยังที่ผู้ใช้ที่เป็นสมาชิก เป็น อาร์เรย์{% 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 |
เว็บลิงก์
ช่วยให้คุณสามารถโหลดเว็บลิงก์ใดๆ ได้ โดยชื่อหรือรหัส
ถ้ามีชุดลิงก์เว็บอยู่ ออบเจ็กต์ชุดลิงก์เว็บ จะถูกส่งกลับ ถ้าไม่พบชุดลิงก์เว็บทีมีชื่อหรือรหัสที่กำหนด 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 ของชุดลิงก์เว็บ |
| ชื่อ | ชื่อของชุดลิงก์เว็บ |
| ตำแหน่ง | หัวข้อของชุดลิงก์เว็บ |
| เว็บลิงก์ | อาร์เรย์ของออบเจ็กต์ชุดลิงก์เว็บที่เกี่ยวข้องกับชุดลิงก์เว็บ |
| [ชื่อตรรกะของแอตทริบิวต์] | คุณสามารถเข้าถึงแอตทริบิวต์ใดๆของเรกคอร์ด Dataverse ของชุดเว็บลิงก์โดยชื่อทางตรรกะ ตัวอย่างเช่น {{ weblinkset.createdon }} |
แอตทริบิวต์ลิงก์เว็บ
หมายเหตุ
ลิงก์เว็บคือ ออบเจ็กต์ของ เอนทิตี ที่มีแอตทริบิวต์เดียวกันทั้งหมด นอกเหนือจากที่แสดงรายการด้านล่างเหล่านั้น
| แอตทริบิวต์ | รายละเอียด |
|---|---|
| รายละเอียด | คำอธิบาย HTML ของลิงก์เว็บ |
| display_image_only | แอตทริบิวต์บูลีนบ่งชี้ว่า ลิงก์เว็บควรถูกแสดงเป็นรูปเท่านั้นโดยไม่มีข้อความลิงก์หรือไม่ |
| display_page_child_links | แอตทริบิวต์บูลีนที่บ่งชี้ว่า เว็บลิงก์ควรแสดงลิงก์ไปยังเพจรอง แผนผังเว็บไซต์ ของเพจที่ถูกลิงก์ เป็นลิงก์ย่อย หรือไม่ |
| รูปภาพ | ออบเจ็กต์รูปภาพลิงก์เว็บสำหรับลิงก์นี้ แอตทริบิวต์นี้จะว่างถ้าไม่มีรูปแสดงอยู่ |
| is_external | แอตทริบิวต์บูลีนที่บ่งชี้ว่า URL เป้าหมายของลิงก์เว็บไปยังไซต์ภายนอกหรือไม่ (แทนที่จะไปยังเพจพอร์ทัลภายใน) |
| is_sitemap_ancestor | ส่งกลับ True ถ้า URL ของเว็บลิงก์อ้างอิงต้นกำเนิดของโหนดแผนผังเว็บไซต์ปัจจุบัน มิฉะนั้น False |
| is_sitemap_current | ส่งกลับ True ถ้า URL ของเว็บลิงก์อ้างอิงโหนดแผนผังเว็บไซต์ปัจจุบัน มิฉะนั้น False |
| ชื่อ | ชื่อ/หัวข้อของลิงก์เว็บ |
| Nofollow | แอตทริบิวต์บูลีนที่บ่งชี้ว่า เว็บลิงก์ควรถูกทำเครื่องหมายเป็น rel=nofollow หรือไม่ |
| open_in_new_window | แอตทริบิวต์บูลีนที่บ่งชี้ว่า ลิงก์เว็บควรถูกเปิดในหน้าต่างเบราว์เซอร์/แท็บใหม่เมื่อเลือกหรือไม่ |
| คำแนะนำเครื่องมือ | ข้อความคำแนะนำเครื่องมือสำหรับลิงก์เว็บ |
| URL | URL ของลิงก์เว็บ |
| เว็บลิงก์ | อาร์เรย์ของออบเจ็กต์ลิงก์เว็บรองที่เกี่ยวข้องกับลิงก์เว็บ |
| [ชื่อตรรกะของแอตทริบิวต์] | คุณสามารถเข้าถึงแอตทริบิวต์ใดๆของเรกคอร์ด Dataverse ของเว็บลิงก์โดยชื่อทางตรรกะ ตัวอย่างเช่น {{ weblink.createdon }} |
แอตทริบิวต์รูปภาพเว็บลิงก์
| alternate_text | สลับข้อความสำหรับรูปภาพ |
|---|---|
| Height | จำนวนเต็มที่ประกอบด้วยความสูงของรูปที่ระบุ ถ้าไม่มีค่าความสูงให้ไว้ แอตทริบิวต์นี้จะเป็น null |
| URL | URL ของรูปภาพ |
| ความกว้าง | จำนวนเต็มที่ประกอบด้วยความกว้างของรูปที่ระบุ ถ้าไม่มีค่าความกว้างให้ไว้ แอตทริบิวต์นี้จะเป็น null |
เว็บไซต์
อ้างอิงถึงเว็บไซต์ของพอร์ทัล ซึ่งอนุญาตให้เข้าถึงแอตทริบิวต์ทั้งหมดของเรกคอร์ดเว็บไซต์ Dataverse (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 แคชเริ่มต้น) |