ใช้พจนานุกรมระบบอัตโนมัติเพื่อส่งผ่านคีย์พารามิเตอร์
พจนานุกรมการทำให้เป็นอัตโนมัติจะเก็บรักษาข้อมูลตามบริบทสำหรับเซสชัน ท่านสามารถใช้คีย์จากพจนานุกรมอัตโนมัติเพื่อส่งผ่านพารามิเตอร์ในการดำเนินการ
ขณะสร้างเทมเพลตและมาโครในแอปผู้ดูแลระบบ คุณสามารถส่งผ่านคีย์พารามิเตอร์ เช่น ชื่อของเซสชัน ชื่อการแจ้งเตือน ชื่อของเทมเพลตแท็บแอปพลิเคชัน และค่าพารามิเตอร์ที่กำหนดเองสำหรับชนิดแท็บแอปพลิเคชัน คีย์เหล่านี้จะถูกแทนที่ตามข้อมูลบริบทที่มีอยู่ในเวลาของการดำเนินการ
ส่งผ่านพารามิเตอร์ข้อมูลในเทมเพลต
ลองทำสถานการณ์สำหรับเทมเพลตด้วยการแจ้งเตือน
การแจ้งเตือนแสดงฟิลด์และค่าบางอย่างที่เรียกว่า ส่วนหัวของฟิลด์ และ ค่า ตามลำดับ
Kenny Smith ซึ่งเป็นลูกค้า ได้เริ่มต้นการสนทนาและเมื่อเจ้าหน้าที่เห็นการแจ้งเตือน จะปรากฏ ชื่อลูกค้า เป็น Kenny Smith
ที่นี่ ส่วนหัวของฟิลด์ คือ ชื่อลูกค้า และ ค่า คือ Kenny Smith
สำหรับเทมเพลตที่จะระบุชื่อของลูกค้าเป็น Kenny Smith คุณ (ผู้ดูแลระบบ) จะต้องส่งผ่านพารามิเตอร์เป็นคีย์
ในทำนองเดียวกัน สำหรับชื่อเซสชันและการแจ้งเตือน คุณสามารถส่งผ่านพารามิเตอร์ข้อมูลได้ ข้อมูลเพิ่มเติม: รูปแบบพจนานุกรมอัตโนมัติไปยังคีย์พารามิเตอร์ข้อมูล
ระบบจะแทนที่คีย์พารามิเตอร์เหล่านี้ด้วยค่าจริงตามบริบทของเซสชัน ผู้ให้บริการช่องทาง Microsoft Dataverse และการกระทำของผู้ใช้ ข้อมูลเพิ่มเติม: ชนิดของพารามิเตอร์ข้อมูลบริบท
ส่งผ่านพารามิเตอร์ข้อมูลในแมโครและสคริปต์ของเจ้าหน้าที่
มาโครเป็นชุดของการดำเนินการตามลำดับที่กำหนดค่าที่เรียกใช้ตามความต้องการโดยผู้ใช้ ในฐานะผู้ดูแลระบบ คุณต้องกำหนดค่าการกระทำที่มาโครต้องดำเนินการ การกำหนดค่าการกระทำ คุณจะต้องส่งผ่านพารามิเตอร์ข้อมูล ข้อมูลเพิ่มเติม: รูปแบบพจนานุกรมอัตโนมัติเพื่อส่งผ่านคีย์พารามิเตอร์ข้อมูล
เมื่อเจ้าหน้าที่เรียกใช้มาโคร ระบบจะแทนที่คีย์พารามิเตอร์เหล่านี้ด้วยค่าจริงตามบริบทของเซสชัน ผู้ให้บริการช่องทาง Dataverse และการกระทำของผู้ใช้
เมื่อบริบทมาจากเซสชัน การทำงานของแมโครจะดำเนินการตามข้อมูลสำหรับเซสชันปัจจุบัน ซึ่งได้รับข้อมูลจากแท็บจุดยึดหรือแท็บปัจจุบันที่อยู่ในโฟกัส ตัวอย่างเช่น ในการสร้างกรณี คุณต้องกำหนดการดำเนินการที่มีฟอร์มเอนทิตีของเหตุการณ์และ GUID ของฟอร์ม (ทางเลือก) ข้อมูลเพิ่มเติม: ชนิดของพารามิเตอร์ข้อมูลบริบท
ประเภทของพารามิเตอร์ข้อมูลบริบท
พจนานุกรมอัตโนมัติใช้พารามิเตอร์ข้อมูลบริบทที่มีอยู่จากแหล่งต่อไปนี้:
- ข้อมูลบริบทจากผู้ให้บริการช่องทาง
- ข้อมูลบริบทจากการดำเนินการของผู้ใช้
- ข้อมูลบริบทจาก Dataverse
- ข้อมูลบริบทจากการกระทำของมาโครอื่น
ข้อมูลบริบทจากผู้ให้บริการช่องทาง
ข้อมูลบริบทนี้มาจากผู้ให้บริการช่องทางฝ่ายหลัก เช่น ช่องทาง Omni สำหรับ Customer Service หรือผู้ให้บริการช่องทางบุคคลที่สามที่ใช้วิดเจ็ตที่เปิดเผยโดยกรอบงานการรวมของช่องทาง Dynamics 365 ข้อมูลบริบทจากช่องทาง Omni สำหรับ Customer Service คือการสำรวจก่อนการสนทนา การนำทางพอร์ทัลผู้เยี่ยมชม และอื่นๆ
ข้อมูลบริบทจากการดำเนินการของผู้ใช้
ข้อมูลนี้ถูกเติมเป็นและเมื่อเอเจนต์ดำเนินกิจกรรมบางอย่างในเซสชัน ตัวอย่างกำลังเปิดเร็กคอร์ดลูกค้าใหม่ กรณี และอื่น ๆ
ข้อมูลบริบทจาก Dataverse
ข้อมูลองค์กรถูกเก็บไว้ใน Dataverse และคุณสามารถดึงข้อมูลด้วยการใช้แบบสอบถาม OData ข้อมูลเพิ่มเติม: การสอบถาม OData
ข้อมูลบริบทจากการกระทำของมาโครอื่น
การดำเนินการ ในแมโครสร้างข้อมูลบริบทที่ใช้โดยการดำเนินการอื่นๆ ในแมโครนั้น
ตัวอย่างเช่น มีขั้นตอนการดำเนินการสองขั้นตอนในลำดับต่อไปนี้:
- เปิดฟอร์มใหม่เพื่อสร้างเรกคอร์ด
- เปิดฟอร์มอีเมลด้วยเทมเพลตที่กำหนดไว้ล่วงหน้า
ในขณะที่สร้างการดำเนินการ เปิดฟอร์มอีเมล์ด้วยเทมเพลตที่กำหนดไว้ล่วงหน้า คุณสามารถรับคีย์พารามิเตอร์ข้อมูลบริบทได้จากขึ้นตอนการดำเนินการมาโคร เปิดฟอร์มใหม่เพื่อสร้างเรกคอร์ด
พารามิเตอร์ข้อมูลบริบทจากการดำเนินการมาโครแรกมีดังนี้:
- ชื่อตรรกะของเอนทิตี
- ชนิดเพจ
- รหัสแท็บ
หมายเหตุ
พารามิเตอร์ข้อมูลบริบทจากการดำเนินการแมโครอื่นๆ นั้นใช้เฉพาะกับมาโคร และไม่สามารถใช้ได้กับเทมเพลต
รูปแบบพจนานุกรมอัตโนมัติเพื่อส่งผ่านคีย์พารามิเตอร์ข้อมูล
พจนานุกรมการทำให้เป็นอัตโนมัติจะเก็บรักษาข้อมูลตามบริบทสำหรับเซสชัน คีย์ในพจนานุกรมอัตโนมัติสามารถส่งผ่านพารามิเตอร์ไปยังการดำเนินการในมาโคร ระบบจะแทนที่คีย์พารามิเตอร์เหล่านี้ด้วยค่าจริงตามบริบทของเซสชัน ผู้ให้บริการช่องทาง Dataverse และการกระทำของผู้ใช้
พจนานุกรมอัตโนมัติรองรับรูปแบบต่อไปนี้:
Slugs
slug เป็นพารามิเตอร์การแทนที่ที่ระบบจะเติมข้อมูลที่รันไทม์ตามบริบท ใช้รายการของ slug ต่อไปนี้สำหรับมาโครและสคริปต์ของเจ้าหน้าที่เท่านั้น และเพื่อตั้งค่าสคริปต์ของเจ้าหน้าที่เป็นค่าเริ่มต้นโดยใช้ตัวสร้างนิพจน์สคริปต์ของเจ้าหน้าที่ ข้อมูลเพิ่มเติม: เครื่องมือเพิ่มประสิทธิภาพ
Slugs สำหรับเครื่องมือเพิ่มประสิทธิภาพ (แมโครและสคริปต์ของเจ้าหน้าที่)
แมโครและสคริปต์สำหรับเจ้าหน้าที่สนับสนุน slug ต่อไปนี้:
Slug | คำอธิบาย |
---|---|
${customerName} |
ชื่อของลูกค้าที่เริ่มต้นการสนทนา |
${caseId} |
รหัสเฉพาะของกรณี ระบบแสดงรหัสของกรณี ก็ต่อเมื่อกรณีเชื่อมโยงกับการสนทนา |
${caseTitle} |
ชื่อของกรณี ระบบแสดงชื่อของกรณี ก็ต่อเมื่อกรณีเชื่อมโยงกับการสนทนา |
${LiveWorkItemId} |
รหัสเฉพาะของการสนทนา |
${queueId} |
รหัสเฉพาะของคิว สตริงตัวอักษรผสมตัวเลขนี้ แสดงใน URL ของหน้าคิว |
${visitorLanguage} |
ภาษาของลูกค้าผู้เริ่มต้นการสนทนา |
${visitorDevice} |
อุปกรณ์ของลูกค้าผู้เริ่มต้นการสนทนา |
${entityRoutingLogicalName} |
ชื่อของเอนทิตี หากการแจ้งเตือนนั้นใช้สำหรับเรกคอร์ดเอนทิตี |
${customerEntityName} |
ชื่อของเอนทิตี (ผู้ติดต่อ หรือลูกค้าองค์กร) ถ้าลูกค้าได้รับการรับรองความถูกต้อง |
${customerRecordId} |
รหัสเฉพาะของเอนทิตี (ผู้ติดต่อ หรือลูกค้าองค์กร) ถ้าลูกค้าได้รับการรับรองความถูกต้อง |
${<name of the pre-conversation survey questions>} |
คำถามแบบสำรวจก่อนการสนทนาทั้งหมดที่กำหนดค่าสำหรับเวิร์กโฟลว์จะมีชื่อ Slug เป็นชื่อของคำถาม |
หมายเหตุ
มีเพียง slug ${anchor.<attribute_name>}
เท่านั้นที่ได้รับการสนับสนุนในมาโครและสคริปต์สำหรับ Customer Service workspace
Slug สำหรับลิงก์การเชื่อมต่อใหม่
Slug ต่อไปนี้ใช้เพื่อสร้างลิงก์การเชื่อมต่อใหม่ที่สามารถแชร์กับลูกค้า เพื่อเชื่อมต่อกลับไปยังเจ้าหน้าที่และการสนทนาเดียวกัน ข้อมูลเพิ่มเติม: กำหนดค่าการเชื่อมต่อใหม่ไปยังการสนทนาเดิม
Slug | คำอธิบาย |
---|---|
{ReconnectUrl{ReconnectID}} |
ใช้ในการตอบกลับด่วนเพื่อสร้างลิงก์การเชื่อมต่อใหม่ |
รูปแบบสำหรับ slug สำหรับเครื่องมือเพิ่มประสิทธิภาพ
รูปแบบพารามิเตอร์ ${Slug}
ที่ดึงบริบทจากผู้ให้บริการช่องทาง เซสชันผู้ใช้ปัจจุบัน เอาต์พุตของการดำเนินการของแมโครอื่นๆ หรือ Dataverse
บริบทระบบอัตโนมัติของประสิทธิภาพการทำงาน
เมื่อคุณต้องการดำเนินการกับ slug ในบริบทระบบอัตโนมัติของประสิทธิภาพการทำงาน ซึ่งใช้ในการดำเนินการที่เกี่ยวข้องกับแอปแบบจำลองใน Dynamics 365 ให้ใช้รูปแบบ ${</slug/>} ตัวอย่าง: ${customerName}
บริบทตัวเชื่อมต่อเซสชัน
เมื่อคุณต้องการดำเนิน slug ในบริบทเซสชัน คุณต้องใช้รูปแบบ ${$session.<slug>}
ตัวอย่าง: ${$session.customerName}
Slug ที่พร้อมใช้งานสำหรับบริบทเซสชัน ได้แก่:
${$session.visitorDevice}
${$session.visitorDevice}
${$session.entityRoutingLogicalName}
${$session.entityRoutingRecordId}
${$session.<name of the pre-chat survey questions>
บริบทตัวเชื่อมต่อช่องทาง Omni
เมื่อคุณต้องการดำเนินการ slug ในบริบทช่องทาง Omni สำหรับ Customer Service คุณต้องใช้รูปแบบ ${$oc.<slug>}
ตัวอย่าง: ${$oc.customerName}
พารามิเตอร์ Session.CurrentTab.<Attribute>
และ Session.AnchorTab.<Attribute>
ให้ข้อมูลบริบทตามเซสชันปัจจุบันและแท็บจุดยึดหรือแท็บปัจจุบันในโฟกัส ต่อไปนี้เป็นชนิดแอตทริบิวต์ที่สนับสนุน:
- EntityName
- EntityId
ตัวอย่าง:
Session.CurrentTab.<EntityName>
Session.CurrentTab.<EntityId>
Session.AnchorTab.<EntityName>
Session.AnchorTab.<EntityId>
หมายเหตุ
พารามิเตอร์ Session.CurrentTab.<Attribute>
และ Session.AnchorTab.<Attribute>
สามารถใช้ได้กับมาโครเท่านั้น และไม่สามารถใช้ได้กับเทมเพลต
Slugs สำหรับเทมเพลต
รายชื่อ Slug ที่สนับสนุนมีดังนี้:
บุ้ง | คำอธิบาย |
---|---|
{anchor.<attribute_name>} |
ใช้เพื่อเข้าถึงแอตทริบิวต์ของเรกคอร์ดที่โหลดในแท็บจุดยึด |
{customerName} |
ชื่อของลูกค้าที่เริ่มต้นการสนทนา |
{caseId} |
รหัสเฉพาะของกรณี ระบบแสดงรหัสของกรณี ก็ต่อเมื่อกรณีเชื่อมโยงกับการสนทนา |
{caseTitle} |
ชื่อของกรณี ระบบแสดงชื่อของกรณี ก็ต่อเมื่อกรณีเชื่อมโยงกับการสนทนา |
{queueId} |
รหัสเฉพาะของคิว สตริงตัวอักษรผสมตัวเลขนี้ แสดงใน URL ของหน้าคิว |
{visitorLanguage} |
ภาษาของลูกค้าผู้เริ่มต้นการสนทนา |
{visitorDevice} |
อุปกรณ์ของลูกค้าผู้เริ่มต้นการสนทนา |
{entityRoutingLogicalName} |
ชื่อของเอนทิตี หากการแจ้งเตือนนั้นใช้สำหรับเรกคอร์ดเอนทิตี |
{entityRoutingRecordId} |
รหัสเฉพาะของเรกคอร์ดเอนทิตี หากการแจ้งเตือนนั้นใช้สำหรับเรกคอร์ดเอนทิตี |
{customerRecordId} |
รหัสเฉพาะของเอนทิตี (ผู้ติดต่อ หรือลูกค้าองค์กร) ถ้าลูกค้าได้รับการรับรองความถูกต้อง |
{<name of the pre-chat survey questions>} |
คำถามแบบสำรวจก่อนการแชททั้งหมดที่กำหนดค่าสำหรับเวิร์กโฟลว์จะมีชื่อ Slug เป็นชื่อของคำถาม |
รูปแบบสำหรับ slug สำหรับเทมเพลต
รูปแบบพารามิเตอร์ {Slug}
ที่ดึงบริบทเทมเพลตจากผู้ให้บริการช่องทาง เซสชันผู้ใช้ปัจจุบัน หรือ Dataverse ตัวอย่าง: {caseId}
แบบสอบถาม OData
คุณสามารถใช้แบบสอบถาม OData เพื่อรับบริบทที่มีอยู่จาก Dataverse
รูปแบบการสอบถาม OData คือ:
{$odata.<entityName>.<entityAttributeName>.<?options>}
ตัวอย่าง:
{$odata.account.name.?$filter=accountid eq '{customerRecordId}'}
{$odata.incident.prioritycode.?$filter=incidentid eq '{caseId}'&$select=prioritycode}
{$odata.incident.title.?$filter=incidentid eq '{caseId}'&$select=title}
ค่าคงที่
รายการเหล่านี้เป็นค่าที่กำหนดค่าตายตัวที่ให้คุณปรับปรุงตามความต้องการทางธุรกิจของคุณ สำหรับแอตทริบิวต์ที่กำหนดค่าตายตัวทุกรายการที่คุณเลือก ให้ทำตามประเภทรูปแบบสำหรับแอตทริบิวต์เฉพาะ
ตัวอย่าง (แมโคร):
คุณต้องการให้ชื่อเรื่องของกรณีผนวกกับ Contoso - เสมอ คุณใช้การดำเนินการ เปิดฟอร์มใหม่เพื่อสร้างเรกคอร์ด ด้วยฟิลด์ต่อไปนี้
พารามิเตอร์ | ค่า |
---|---|
ชื่อตรรกะของเอนทิตี | incident |
ชื่อแอตทริบิวต์ | ชื่อของกรณี |
ค่าแอตทริบิวต์ | Contoso - {caseTitle} |
ที่นี่ Contoso - เป็นค่าคงที่ตายตัว
ตัวอย่าง (เทมเพลต)
สำหรับคำขอแชทขาเข้า คุณต้องการให้ชื่อคงที่กับเซสชันและเทมเพลตการแจ้งเตือนที่เจ้าหน้าที่มองเห็นที่รันไทม์
หัวข้อการแจ้งเตือน = New chat request
หัวข้อเซสชัน = Chat conversation
ข้อมูลที่เกี่ยวข้อง
จัดการเทมเพลตเซสชัน
จัดการเทมเพลตแท็บแอปพลิเคชัน
จัดการเทมเพลตการแจ้งเตือน
เชื่อมโยงเทมเพลตกับสตรีมงาน