XSendAppNotification และฟังก์ชันการดำเนินการที่เกี่ยวข้อง (พรีวิว)

ใช้กับ: แอปพื้นที่ทำงาน แอปแบบจำลอง

[บทความนี้เป็นคู่มือรุ่นก่อนวางจำหน่าย และอาจจะมีการเปลี่ยนแปลงในอนาคต]

ส่งการแจ้งเตือนในแอปพร้อมการดำเนินการเพิ่มเติมไปยังผู้รับ

สำคัญ

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

รายละเอียด

ฟังก์ชัน XSendAppNotification ใช้เพื่อส่งการแจ้งเตือนภายในแอปไปยังผู้รับ การแจ้งเตือนเหล่านี้จะปรากฏเป็นป็อปอัพหรือภายในศูนย์การแจ้งเตือนสำหรับผู้ใช้แอป สำหรับข้อมูลเพิ่มเติม โปรดดู ส่งการแจ้งเตือนในแอปภายในแอปแบบจำลอง

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

• XCreateUrlAction: เพิ่มการดำเนินการ URL ลงในการแจ้งเตือน การ์ด
• XCreateSidePaneActionForDashboard: เพิ่มการดำเนินการบานหน้าต่างด้านข้างที่นำทางไปยังเพจที่มีประเภท dashboard ภายในบานหน้าต่างด้านข้าง
• XCreateSidePaneActionForEntity: เพิ่มการดำเนินการบานหน้าต่างด้านข้างที่นำทางไปยังเพจที่มีประเภท entityrecord ภายในบานหน้าต่างด้านข้าง
• XCreateSidePaneActionForEntityList: เพิ่มการดำเนินการบานหน้าต่างด้านข้างที่นำทางไปยังเพจที่มีประเภท entitylist ภายในบานหน้าต่างด้านข้าง
• XCreateTeamsChatAction: เพิ่มการดำเนินการแชทใน Teams ลงในการแจ้งเตือน การ์ด

ไวยากรณ์

XSendAppNotification

XSendAppNotification (ชื่อ, ผู้รับ, เนื้อหา, การดำเนินการ, ประเภทไอคอน, ประเภทโทสต์, วันหมดอายุ, ลำดับความสำคัญ)

พารามิเตอร์	ชนิด	ต้องมี	รายละเอียด
Title	สตริง	ใช่	ชื่อเรื่องของการแจ้งเตือนแอป
ผู้รับ	เอนทิตี้	ใช่	เอนทิตีของ systemuser ซึ่งเป็นผู้รับการแจ้งเตือน
Body	สตริง	ไม่	เนื้อความของการแจ้งเตือน
แอคชัน	Function	ไม่	อาร์เรย์ของฟังก์ชันการดำเนินการเพื่อเพิ่มการดำเนินการจากการแจ้งเตือน
ชนิดไอคอน	Int	ไม่	ค่ารายการให้เลือกสำหรับชนิดของไอคอน (ข้อมูล สำเร็จ ล้มเหลว คำเตือน การอ้างถึง กำหนดเอง)
ชนิดข้อความป็อปอัพ	Int	ไม่	รายการตัวเลือกสำหรับชนิดข้อความป็อปอัพ (แบบตั้งเวลาเทียบกับแบบซ่อน)
หมดอายุ	Int	ไม่	จำนวนวินาทีนับจากตอนที่ควรลบการแจ้งเตือนหากยังไม่ได้ปิดใช้งาน
ลำดับความสำคัญ	Int	ไม่	ค่ารายการให้เลือกสำหรับลำดับความสำคัญของการแจ้งเตือน (ปกติหรือสูง)

XCreateUrlAction

XCreateUrlAction (ชื่อ, URL, เป้าหมายการนำทาง )

พารามิเตอร์	ชนิด	ต้องมี	รายละเอียด
Title	สตริง	ใช่	ชื่อที่แสดงสำหรับการดำเนินการ
URL	สตริง	ใช่	URL ที่จะเปิดเมื่อเลือกการดำเนินการ
เป้าหมายการนำทาง	สตริง	ไม่	กำหนดตำแหน่งที่ลิงก์การนำทางจะเปิดขึ้น ตัวเลือกคือ: dialog: เปิดขึ้นในกล่องโต้ตอบตรงกลาง inline: ค่าเริ่มต้น. เปิดหน้าปัจจุบัน newWindow: เปิดขึ้นในแท็บเบราว์เซอร์ใหม่

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (ชื่อเรื่อง, รหัสบานหน้าต่าง, ชื่อบานหน้าต่าง, รหัสแผงควบคุม)

พารามิเตอร์	ชนิด	ต้องมี	รายละเอียด
Title	สตริง	ใช่	ชื่อที่แสดงสำหรับการดำเนินการ
รหัสบานหน้าต่าง	สตริง	ใช่	รหัสของบานหน้าต่างด้านข้างใหม่
ชื่อบานหน้าต่าง	สตริง	ใช่	ชื่อเรื่องที่จะแสดงสำหรับบานหน้าต่างด้านข้าง
รหัสแดชบอร์ด	GUID	ใช่	รหัสของแดชบอร์ดที่จะเปิดในบานหน้าต่างด้านข้าง

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (ชื่อเรื่อง, รหัสบานหน้าต่าง, ชื่อบานหน้าต่าง, ชื่อเอนทิตี, รหัสเอนทิตี)

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

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList (ชื่อเรื่อง, ID แผง, ชื่อแผง, ชื่อเอนทิตี)

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

XCreateTeamsChatAction

XCreateTeamsChatAction (ชื่อเรื่อง, รหัสแชท, รหัสสมาชิก, รหัสระเบียน, ชื่อเอนทิตี้, ข้อความเริ่มต้น)

พารามิเตอร์	ชนิด	ต้องมี	รายละเอียด
Title	สตริง	ใช่	ชื่อที่แสดงสำหรับการดำเนินการ
รหัสแชท	สตริง	ไม่	หากเปิดการแชทที่มีอยู่ รหัสของเซสชันการแชทที่จะเปิด
รหัสสมาชิก	GUID	ไม่	หากสร้างการแชทใหม่ อาร์เรย์ของค่า Object ID ของ Microsoft Entra ของผู้เข้าร่วมที่จะรวมในการแชท
รหัสเรกคอร์ด	GUID	ไม่	หากเชื่อมโยงกับเรกคอร์ด Dynamics 365 รหัสของเรกคอร์ดที่ควรเชื่อมโยงการแชท
ชื่อเอนทิตี	สตริง	ไม่	หากเชื่อมโยงกับเรกคอร์ด Dynamics 365 ชื่อตรรกะของเอนทิตีของเรกคอร์ดที่ควรเชื่อมโยงการแชท
ข้อความเริ่มต้น	สตริง	ไม่	ข้อความแนะนำของแชทใหม่

ตัวอย่าง

การแจ้งเตือนในแอปที่มีชื่อ ผู้รับ และเนื้อความ

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

XSendAppNotification(
    "Welcome", 
    LookUp(Users, 'Primary Email'="<User's email address>"), 
    "Welcome to the world of in-app notifications!"
)

การแจ้งเตือนในแอปพร้อมการดำเนินการสองรายการ

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

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

XSendAppNotification(
	"New task assigned",
	AsType(ThisRecord.Owner, Users),
	"A new task has been assigned to you to follow up with your customer",
	[XCreateSidePaneActionForEntity(
		"View task",
		1123,
		"Your task",
		"task",
		ThisRecord.Task    
		),
	XCreateTeamsChatAction(
		"Chat with account manager",
		[AsType(AsType(ThisRecord.Regarding, Accounts).Owner, Users).'Microsoft Entra Object ID'],
		AsType(ThisRecord.Regarding, Accounts).Account, 
		"account", 
		ThisRecord.Description
		)
	]
)