XSendAppNotification và các hàm hành động liên quan (bản xem trước)

Áp dụng cho: Ứng dụng canvas Ứng dụng dựa trên mô hình

[Bài viết này là tài liệu trước khi phát hành và có thể thay đổi.]

Gửi thông báo trong ứng dụng với các hành động tùy chọn cho người nhận.

Quan trọng

• Đây là một tính năng xem trước.
• Các tính năng bản xem trước không dành cho mục đích sử dụng sản xuất, có thể có chức năng hạn chế và có thể thay đổi đáng kể trước khi phát hành. Những tính năng này khả dụng trước khi có bản phát hành chính thức để khách hàng có thể truy cập sớm và cung cấp phản hồi.
• Để giúp xác định đây là các tính năng bản xem trước, mỗi hàm đều có tiền tố là một X. Sau khi phát hành, X sẽ cần phải được xóa khỏi mọi công thức sử dụng các hàm này và các đối số được cập nhật cho bất kỳ thay đổi nào về hàm.
• Những chức năng này chỉ có thể được sử dụng với các plug-in Dataverse ít viết mã.

Description

Hàm XSendAppNotification được sử dụng để gửi thông báo trong ứng dụng tới người nhận. Các thông báo này xuất hiện dưới dạng bánh mì nướng hoặc trong trung tâm thông báo cho người dùng ứng dụng. Để biết thêm thông tin, hãy xem Gửi thông báo trong ứng dụng trong các ứng dụng dựa trên mô hình.

Ngoài ra, thông báo trong ứng dụng có thể bao gồm từ 0 đến nhiều hành động trên thông báo thẻ. Để thêm hành động vào thông báo ứng dụng thẻ, các hàm sau được sử dụng làm tham số trong hàm XSendAppNotification . Để biết thêm thông tin về từng loại hành động, hãy xem Hành động thông báo.

• XCreateUrlAction: Thêm hành động URL vào thông báo thẻ.
• XCreateSidePaneActionForDashboard: Thêm một hành động ở khung bên để điều hướng đến một trang có loại dashboard trong khung bên.
• XCreateSidePaneActionForEntity: Thêm một hành động ở khung bên để điều hướng đến một trang có loại entityrecord trong khung bên.
• XCreateSidePaneActionForEntityList: Thêm một hành động ở khung bên để điều hướng đến một trang có loại entitylist trong khung bên.
• XCreateTeamsChatAction: Thêm hành động trò chuyện Nhóm vào thông báo thẻ.

Cú pháp

XSendAppThông báo

XSendAppNotification (Tiêu đề, Người nhận, Nội dung, Hành động, Loại biểu tượng, Loại bánh mì nướng, Hết hạn, Ưu tiên)

Tham số	Loại	Bắt buộc	Description
Title	String	Có	Tiêu đề của thông báo ứng dụng.
Người nhận	Thực thể	Có	Một thực thể systemuser là người nhận thông báo.
Phần nội dung	String	No	Cơ quan thông báo.
Tác vụ	Hàm	No	Một mảng các chức năng hành động để thêm các hành động vào thông báo.
Loại biểu tượng	Int	No	Giá trị danh sách chọn cho loại biểu tượng (thông tin, thành công, thất bại, cảnh báo, đề cập, tùy chỉnh).
Loại thông báo ngắn	Int	No	Giá trị danh sách chọn cho loại thông báo (được tính giờ so với ẩn).
Hết hạn	Int	No	Số giây hiển thị thông báo trước khi xóa (nếu người dùng chưa đóng thông báo).
Mức độ ưu tiên	Int	No	Giá trị danh sách chọn cho mức độ ưu tiên của thông báo (bình thường hoặc cao).

XCreateUrlHành động

XCreateUrlAction (Tiêu đề, URL, Mục tiêu điều hướng )

Tham số	Loại	Bắt buộc	Description
Title	String	Có	Tiêu đề hiển thị cho hành động.
URL	String	Có	URL sẽ được mở khi hành động được chọn.
Mục tiêu điều hướng	String	No	Xác định nơi mở điều hướng liên kết. Các tùy chọn là: dialog: Mở trong hộp thoại ở giữa. inline: Mặc định. Mở trong trang hiện tại. newWindow: Mở trong tab trình duyệt mới.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (Tiêu đề, ID ngăn, Ngăn Tiêu đề, ID trang tổng quan)

Tham số	Loại	Bắt buộc	Description
Title	String	Có	Tiêu đề hiển thị cho hành động.
ID ngăn	String	Có	ID của khung bên mới.
Tiêu đề ngăn	String	Có	Tiêu đề hiển thị cho khung bên.
ID bảng thông tin	GUID	Có	ID của trang tổng quan sẽ mở ở khung bên.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (Tiêu đề, ID ngăn, Ngăn Tiêu đề, Tên thực thể, ID thực thể)

Tham số	Loại	Bắt buộc	Description
Title	String	Có	Tiêu đề hiển thị cho hành động.
ID ngăn	String	Có	ID của khung bên mới.
Tiêu đề ngăn	String	Có	Tiêu đề hiển thị cho khung bên.
Tên thực thể	String	Có	Tên logic của thực thể.
ID thực thể	String	Có	ID của bản ghi thực thể sẽ mở trong ngăn bên.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList (Tiêu đề, ID ngăn, Ngăn Tiêu đề, Tên thực thể)

Tham số	Loại	Bắt buộc	Description
Title	String	Có	Tiêu đề hiển thị cho hành động.
ID ngăn	String	Có	ID của khung bên mới.
Tiêu đề ngăn	String	Có	Tiêu đề hiển thị cho khung bên.
Tên thực thể	String	Có	Tên logic của thực thể sẽ mở dưới dạng danh sách trong ngăn bên.

XCreateTeamsChatHành động

XCreateTeamsChatAction (Tiêu đề, ID trò chuyện, Thành viên ID, ID bản ghi, Tên thực thể, Tin nhắn ban đầu)

Tham số	Loại	Bắt buộc	Description
Title	String	Có	Tiêu đề hiển thị cho hành động.
ID trò chuyện	String	No	Nếu mở một cuộc trò chuyện hiện có, ID của phiên trò chuyện sẽ được mở.
ID Thành viên	GUID	No	Nếu tạo một cuộc trò chuyện mới, một mảng Microsoft Entra giá trị ID đối tượng của những người tham gia sẽ được đưa vào cuộc trò chuyện.
ID Bản ghi	GUID	No	Nếu liên kết với bản ghi Dynamics 365, ID của bản ghi mà cuộc trò chuyện sẽ được liên kết.
Tên thực thể	String	No	Nếu liên kết với bản ghi Dynamics 365, tên logic của thực thể của bản ghi mà cuộc trò chuyện sẽ được liên kết.
Tin nhắn ban đầu	String	No	Một tin nhắn giới thiệu về cuộc trò chuyện mới.

Ví dụ

Thông báo trong ứng dụng có tiêu đề, người nhận và nội dung

Phần sau đây sẽ gửi một thông báo trong ứng dụng đơn giản tới người nhận có tiêu đề và nội dung. Nó không bao gồm bất kỳ hành động nào và sử dụng các giá trị mặc định cho tất cả các tham số khác.

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

Thông báo trong ứng dụng với hai hành động

Bạn có thể sử dụng công thức mẫu sau đây với plugin tự động khi tạo bản ghi Tác vụ mới. Công thức được thiết kế để gửi thông báo trong ứng dụng tới chủ sở hữu bản ghi nhiệm vụ. Thông báo thẻ chứa hai hành động mà chủ sở hữu có thể thực hiện:

• Hành động ngăn bên , mở bản ghi tác vụ mới trong ngăn bên.
• Hành động Trò chuyện nhóm , bắt đầu cuộc trò chuyện Nhóm với chủ sở hữu bản ghi tài khoản được chỉ định là Về bản ghi bảng cho nhiệm vụ mới. Điều quan trọng cần lưu ý là điều này giả định rằng bản ghi tài khoản đã được chọn trong trường nhiệm vụ.

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
		)
	]
)