Kongsi melalui

XSendAppNotification dan fungsi tindakan yang berkaitan (pratonton)

  • Artikel

Digunakan untuk: Aplikasi kanvas Aplikasi dipacu model

[Artikel ini merupakan dokumentasi prapelancaran dan tertakluk pada perubahan.]

Hantar pemberitahuan dalam apl dengan tindakan pilihan kepada penerima.

Penting

  • Ini adalah ciri pratonton.
  • Ciri pratonton tidak dimaksudkan untuk kegunaan pengeluaran, mungkin mempunyai fungsi terhad dan mungkin berubah dengan ketara sebelum dikeluarkan. Ciri ini tersedia sebelum keluaran rasmi agar pelanggan boleh mendapat akses awal dan memberikan maklum balas.
  • Untuk membantu mengenal pasti ciri ini sebagai ciri pratonton, setiap fungsi diawalkan dengan X. Selepas dikeluarkan, X perlu dialih keluar daripada mana-mana formula yang menggunakan fungsi dan hujah ini dikemas kini untuk sebarang perubahan fungsi.
  • Fungsi ini hanya boleh digunakan dengan Dataverse pemalam kod asas.

Description

Fungsi XSendAppNotification digunakan untuk menghantar pemberitahuan dalam apl kepada penerima. Pemberitahuan ini muncul sama ada sebagai roti bakar atau dalam pusat pemberitahuan untuk pengguna aplikasi. Untuk maklumat lanjut, lihat Hantar pemberitahuan dalam aplikasi dalam aplikasi dipacu model.

Selain itu, pemberitahuan dalam apl boleh menyertakan sifar hingga banyak tindakan pada kad pemberitahuan. Untuk menambah tindakan pada kad pemberitahuan aplikasi, fungsi berikut digunakan sebagai parameter dalam fungsi XSendAppNotification . Untuk mendapatkan maklumat lanjut tentang setiap jenis tindakan, lihat Tindakan pemberitahuan.

  • XCreateUrlAction: Menambah tindakan URL pada kad pemberitahuan.
  • XCreateSidePaneActionForDashboard: Menambah tindakan anak tetingkap sisi yang menavigasi ke halaman dengan jenis dalam dashboard anak tetingkap sisi.
  • XCreateSidePaneActionForEntity: Menambah tindakan anak tetingkap sisi yang menavigasi ke halaman dengan jenis dalam entityrecord anak tetingkap sisi.
  • XCreateSidePaneActionForEntityList: Menambah tindakan anak tetingkap sisi yang menavigasi ke halaman dengan jenis dalam entitylist anak tetingkap sisi.
  • XCreateTeamsChatAction: Menambah tindakan sembang Pasukan pada kad pemberitahuan.

Sintaks

XSendAppNotification

XSendAppNotification (Tajuk , Penerima, Badan , Tindakan , Jenis Ikon, Jenis Roti Bakar, Tamat Tempoh, Keutamaan)

Parameter_ Jenis Wajib Description
Gelaran String Ya Tajuk pemberitahuan aplikasi.
Penerima EntitI Ya Entiti yang systemuser merupakan penerima pemberitahuan.
Isi String No Badan pemberitahuan.
Tindakan Function No Pelbagai fungsi tindakan untuk menambah tindakan pada pemberitahuan.
Jenis Ikon Int No Nilai senarai pilihan untuk jenis ikon (maklumat, kejayaan, kegagalan, amaran, sebutan, tersuai).
Jenis Makluman Int No Nilai senarai pilihan untuk jenis roti bakar (bermasa berbanding tersembunyi).
Tamat Tempoh Int No Bilangan saat dari waktu pemberitahuan itu perlu dipadamkan jika ia belum dibuang.
Keutamaan Int No Nilai senarai pilihan untuk keutamaan pemberitahuan (biasa atau tinggi).

XCreateUrlAction

XCreateUrlAction(Tajuk , URL, Sasaran Navigasi)

Parameter_ Jenis Wajib Description
Gelaran String Ya Tajuk yang dipaparkan untuk tindakan.
URL String Ya URL yang akan dibuka apabila tindakan dipilih.
Sasaran navigasi String No Mentakrifkan tempat pautan navigasi dibuka. Pilihannya ialah:
  • dialog: Dibuka dalam dialog tengah.
  • inline:Lalai. Dibuka dalam halaman semasa.
  • newWindow: Dibuka dalam tab penyemak imbas baharu.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (Tajuk,ID Anak Tetingkap,Tajuk Anak Tingkap,ID Papan Pemuka)

Parameter_ Jenis Wajib Description
Gelaran String Ya Tajuk yang dipaparkan untuk tindakan.
ID anak tetingkap String Ya ID anak tetingkap sisi baharu.
Tajuk anak tetingkap String Ya Tajuk yang akan dipaparkan untuk anak tetingkap sisi.
ID Papan Pemuka GUID Ya ID papan pemuka untuk dibuka dalam anak tetingkap sisi.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (Tajuk,ID Anak Tetingkap,Tajuk Anak Tetingkap,Nama Entiti,ID Entiti )

Parameter_ Jenis Wajib Description
Gelaran String Ya Tajuk yang dipaparkan untuk tindakan.
ID anak tetingkap String Ya ID anak tetingkap sisi baharu.
Tajuk anak tetingkap String Ya Tajuk yang akan dipaparkan untuk anak tetingkap sisi.
Nama Entiti String Ya Nama logik entiti.
ID Entiti String Ya ID rekod entiti untuk dibuka dalam anak tetingkap sisi.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList (Tajuk,ID anak tetingkap,Tajuk anak tetingkap,Nama Entiti )

Parameter_ Taip Wajib Description
Gelaran String Ya Tajuk yang dipaparkan untuk tindakan.
ID anak tetingkap String Ya ID anak tetingkap sisi baharu.
Tajuk anak tetingkap String Ya Tajuk yang akan dipaparkan untuk anak tetingkap sisi.
Nama Entiti String Ya Nama logik entiti untuk dibuka sebagai senarai dalam anak tetingkap sisi.

XCreateTeamsChatAction

XCreateTeamsChatAction (Tajuk, ID Sembang, ID Ahli, ID Rekod, Nama Entiti, Mesej Awal)

Parameter_ Jenis Wajib Description
Gelaran String Ya Tajuk yang dipaparkan untuk tindakan.
ID Sembang String No Jika membuka sembang sedia ada, ID sesi sembang yang akan dibuka.
ID Ahli GUID No Jika membuat sembang baru, pelbagai nilai Microsoft Entra ID Objek peserta yang akan disertakan dalam sembang.
ID Rekod GUID No Jika memaut ke rekod Dynamics 365, ID rekod yang sembang harus dipautkan.
Nama Entiti String No Jika memaut ke rekod Dynamics 365, nama logik entiti rekod yang sembang harus dipautkan.
Mesej Awal String No Mesej pengenalan sembang baharu.

Contoh

Pemberitahuan dalam apl dengan tajuk, penerima dan badan

Perkara berikut menghantar pemberitahuan dalam apl yang mudah kepada penerima dengan tajuk dan isi. Ia tidak termasuk sebarang tindakan dan menggunakan nilai lalai untuk semua parameter lain.

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

Pemberitahuan dalam apl dengan dua tindakan

Contoh formula berikut boleh digunakan dengan pemalam automatik apabila rekod Tugas baharu dicipta. Formula ini direka bentuk untuk menghantar pemberitahuan dalam aplikasi kepada pemilik rekod tugas. Kad pemberitahuan mengandungi dua tindakan yang boleh diambil oleh pemilik:

  • Tindakan anak tetingkap sisi, membuka rekod tugas baharu dalam anak tetingkap sisi.
  • Tindakan sembang Teams, memulakan sembang Teams dengan pemilik rekod akaun yang diperuntukkan sebagai rekod jadual Berkenaan untuk tugas baharu. Adalah penting untuk ambil perhatian bahawa ini mengandaikan rekod akaun telah dipilih dalam medan tugas.
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
		)
	]
)