Ikhtisar aplikasi web manajemen acara

Catatan

Pada tanggal 1 September 2023, Dynamics 365 Marketing dan Dynamics 365 Customer Insights akan dijual bersama dalam satu SKU produk bernama Dynamics 365 Customer Insights. Aplikasi individual akan diubah namanya menjadi Dynamics 365 Customer Insights - Perjalanan dan Dynamics 365 Customer Insights - Data. Untuk informasi selengkapnya, lihat Tanya Jawab Umum Dynamics 365 Customer Insights

Selain itu, pada 1 September 2023, pelanggan Dynamics 365 Marketing baru hanya akan menerima fitur pemasaran real-time. Untuk informasi selengkapnya, lihat Penginstalan pemasaran real-time default. Banyak halaman dokumentasi saat ini mengacu pada fitur keluar yang mungkin tidak tersedia atau mungkin berfungsi dalam cara yang berbeda dalam pemasaran real-time. Konten dokumentasi akan diperbarui pada bulan September untuk menunjukkan apakah konten tersebut berlaku untuk pemasaran real-time atau pemasaran keluar.

Fitur manajemen acara membantu Anda mengatur, mengelola, dan memproses acara. Saat Anda menginstal solusi manajemen acara, Anda mendapatkan portal aktivitas yang memberi pengguna aplikasi web tempat mereka dapat mengetahui lebih banyak tentang detail aktivitas. Informasi selengkapnya: Portal Acara.

Portal acara terdiri dari dua bagian:

1. Ujung depan
2. REST API backend

Anda dapat mengimplementasikan frontend menggunakan salah satu kerangka kerja yang tersedia. Bagian frontend adalah aplikasi satu halaman dan sepenuhnya dapat disesuaikan. Backend dan kustomisasi backend tergantung pada jenis hosting.

Anda dapat menghosting situs web acara kustom dengan dua cara:

1. Dihosting sendiri
2. Power Apps Portal dihosting

Prasyarat

Anda dapat membangun frontend Anda atau menyesuaikan situs web acara demo yang disediakan.

Catatan

Situs web acara demo yang disediakan adalah situs web berbasis kerangka kerja Angular. Namun, karena backend tidak bergantung pada frontend, Anda dapat menggunakan kerangka kerja pilihan Anda.

Untuk memulai dengan menyesuaikan situs web acara demo, Anda harus mengikuti langkah-langkah berikut:

1. Unduh kode sumber untuk situs web contoh peristiwa.

2. Instal Node.js antara versi 10.x dan versi 16.x. Penyebaran tidak akan berfungsi dengan versi yang lebih baru.

3. Buka Command Prompt atau Windows PowerShell dan jalankan perintah untuk memeriksa apakah penginstalan berhasil.

    node -v
   

   Catatan

   Jika Anda memiliki terminal atau shell yang sudah terbuka, mulai ulang sebelum mengetik perintah.

4. Jalankan perintah untuk menginstal Angular CLI (antarmuka baris perintah) yang diperlukan untuk membangun dan menjalankan aplikasi Angular. Informasi lebih lanjut: Angular CLI.

   npm install -g @angular/cli
   

5. Arahkan ke direktori tempat Anda mengunduh kode sumber dan jalankan perintah untuk mengambil semua paket yang diperlukan untuk menjalankan situs web.

   npm install
   

   Catatan

   Anda perlu menjalankan perintah di direktori yang sama tempat file tersebut package.json berada.

6. Lihat dokumentasi API publik untuk berinteraksi dengan layanan backend.

7. Anda juga harus memiliki Dynamics 365 Customer Insights instans Perjalanan dengan solusi manajemen acara dan solusi Portal diinstal. Untuk menginstal, lihat Mendaftar untuk uji coba Dynamics 365 Customer Insights Perjalanan gratis.

Unduh contoh situs web acara

Catatan

Versi yang lebih baru dari situs web contoh peristiwa akan tersedia setelah fitur baru dan perbaikan bug dirilis.

Pilih versi yang ingin Anda unduh dari tabel di bawah ini.

Nama	Lepaskan	Perubahan	Diunggah
Contoh Situs Web Acara	1.46.0 (rilis September)	- Memperbaiki masalah aksesibilitas. - Perbaikan kecil dan perbaikan bug.	Mengunduh
Contoh Situs Web Acara	1.34.0 (rilis April)	- Perbaikan kecil dan perbaikan bug.	Mengunduh
Contoh Situs Web Acara	1.30.0 (rilis Desember)	- Perbaikan kecil dan perbaikan bug.	Mengunduh
Contoh Situs Web Acara	1.28.0 (rilis Oktober)	- Ditambahkan kemungkinan untuk memilih konversi tanggal lokal. - Menambahkan konfigurasi bahasa situs web tambahan.	Mengunduh
Contoh Situs Web Acara	1.27.0 (rilis September)	- Ditambahkan kemungkinan untuk mengkonfigurasi tampilan tanggal. - Perbaikan kecil dan perbaikan bug.	Mengunduh
Contoh Situs Web Acara	1.24.0 (rilis Juni)	- Skrip penyebaran yang diperbarui untuk memungkinkan penyebaran file tunggal untuk Portal. - Perbaikan kecil dan perbaikan bug.	Mengunduh
Contoh Situs Web Acara	1.23.0 (Rilis Mei)	- Memperbaiki masalah aksesibilitas. - Perbaikan kecil dan perbaikan bug.	Mengunduh
Contoh Situs Web Acara	1.22.0 (rilis April)	- Memperbaiki masalah aksesibilitas. - Perbaikan kecil dan perbaikan bug.	Mengunduh
Contoh Situs Web Acara	1.21.0 (rilis Maret)	- Menambahkan berhenti pendaftaran untuk acara. - Perbaikan kecil dan perbaikan bug.	Mengunduh
Contoh Situs Web Acara	1.20.0 (rilis Februari)	- Mengintegrasikan formulir pemasaran untuk pendaftaran acara. - Perbaikan kecil dan perbaikan bug.	Mengunduh
Contoh Situs Web Acara	1.19.0 (rilis Desember)	- Memperbaiki masalah aksesibilitas. - Perbarui bahasa situs web. - Meningkatkan halaman speaker. - Perbaikan kecil dan perbaikan bug.	Mengunduh
Contoh Situs Web Acara	1.18.0 (rilis Oktober)	- Perbaikan kecil dan perbaikan bug.	Mengunduh
Contoh Situs Web Acara	1.17.0 (rilis September)	- Meningkatkan alur kerja untuk acara berbayar. - Memperbaiki masalah kompatibilitas untuk IE11. - Meningkatkan halaman detail acara. - Perbaikan kecil dan perbaikan bug.	Mengunduh
Contoh Situs Web Acara	1.16.0 (rilis Agustus)	- Meningkatkan perilaku pemuatan halaman acara. - Meningkatkan UI / UX bidang pendaftaran kustom jenis boolean. - Perbaikan kecil dan perbaikan bug.	Mengunduh
Contoh Situs Web Acara	1.15.0 (rilis Juli)	- Tambahkan informasi ke tampilan daftar sesi, jika sesi penuh. - Tambahkan validasi ke bidang pendaftaran khusus. - Meningkatkan terjemahan. - Memperbaiki ikon font-awesome yang hilang setelah menyebarkan ke Portal. - Perbaikan kecil dan perbaikan bug.	Mengunduh
Contoh Situs Web Acara	1.14.0 (rilis Juni)	Tingkatkan ke Angular 7, tingkatkan UI & UX halaman checkout, perbarui dan tingkatkan terjemahan, tingkatkan skrip DeployToD365Instance.ps1, tingkatkan validasi bidang pendaftaran kustom, perbaikan bug lainnya	Mengunduh
Contoh Situs Web Acara	1.13.0 (rilis April)	Fungsi daftar tunggu pada tingkat sesi, pemolesan UI, perbaikan bug	Mengunduh
Contoh Situs Web Acara	1.12.2 (rilis Maret)	Peningkatan UI & UX, perbaikan bug	Mengunduh

Parameter Konfigurasi Lingkungan

Folder src\environments berisi file konfigurasi sampel untuk lingkungan yang berbeda (self-hosted, portal hosted, pengembangan). Konfigurasi yang disiapkan untuk situs web peristiwa kustom dibuat dengan membuat environment.ts file di \src\environments dalam folder. Anda dapat menemukan petunjuk tentang cara mengubah konfigurasi di artikel terkait Konfigurasi lingkungan untuk dihost sendiri dan Konfigurasi lingkungan untuk host Portal.

Beberapa parameter yang perlu Anda pahami sebelum mulai mengonfigurasi situs web peristiwa kustom Anda:

Parameter	Description
produksi	Mengaktifkan atau menonaktifkan mode produksi aplikasi Angular. Informasi selengkapnya: Dokumentasi Angular.
buildVersion	Bidang ini tertaut ke versi yang ditentukan dalam file secara package.json default. Properti ini tidak perlu diubah. Namun, jika Anda memilih untuk tidak mengekspos versi aplikasi, Anda dapat mengaturnya null.
apiTitik akhir	URL yang mengarah ke API manajemen acara titik akhir (yang digunakan untuk mengambil informasi peristiwa dan melakukan pendaftaran).
localizationEndpoint	Menunjuk ke URL tempat file pelokalan disimpan (secara default disimpan di direktori root).
imagesEndpoint	Menentukan URL dasar dari mana gambar disajikan. Konfigurasi ini memungkinkan Anda menayangkan gambar dari lokasi yang berbeda, yang mungkin diperlukan jika Anda ingin menggunakan jaringan pengiriman konten atau layanan pemrosesan gambar.
useRestStack	Pengaturan ini menentukan API mana yang digunakan. Jika diatur ke true, maka API publik manajemen acara baru digunakan. Jika diatur ke false, maka API Portal manajemen acara yang tidak digunakan lagi akan digunakan. API ini hanya dapat digunakan jika Anda menghosting situs web peristiwa kustom di Portal. Untuk menggunakan API publik manajemen acara baru, Anda perlu mendaftarkan aplikasi web.
emApplicationtoken	Token ini mengautentikasi aplikasi web Anda terhadap API publik manajemen acara. Anda dapat mengambil token aplikasi dengan mendaftarkan aplikasi web baru di instans Customer Insights - Journeys. Token ini tidak diperlukan jika Anda menggunakan API Portal manajemen acara yang tidak digunakan lagi.
isAuthenticationEnabled	Bendera ini menentukan apakah otentikasi pengguna didukung atau tidak (yaitu, pengguna dapat mendaftar atau masuk). Jika diatur ke false, maka aplikasi tidak menampilkan cara untuk masuk atau mendaftar.
useAadB2C	Menentukan apakah Anda ingin menggunakan Azure Active Directory manajemen identitas B2C untuk autentikasi. Jika Anda ingin menggunakan Power Apps manajemen identitas portal, bendera ini harus diatur ke false. Jika AAD B2C diaktifkan, maka Anda perlu mengkonfigurasi aadB2CConfig variabel.
aadB2CConfig	Objek konfigurasi manajemen acara digunakan oleh aplikasi saat manajemen identitas AAD B2C diaktifkan.
useMockData	Pengaturan ini dapat digunakan untuk mengembalikan objek tiruan alih-alih melakukan panggilan API nyata.
dateSettings	Pengaturan ini dapat digunakan untuk mengkonfigurasi bagaimana tanggal akan diformat di situs web. Jika convertToLocalDate bendera diatur ke true, semua tanggal secara otomatis dikonversi ke waktu lokal pengguna akhir.
languageSettings	Pengaturan ini dapat digunakan untuk mengkonfigurasi bagaimana bahasa akan dimuat di situs web. Jika forceSingleLanguage bendera diatur ke true, situs web akan dimuat dalam bahasa yang ditentukan dalam websiteLanguageLcid. Bendera showLanguageDropdown memungkinkan untuk menampilkan atau menyembunyikan dropdown bahasa. Secara default, dropdown bahasa terlihat dan situs web akan menggunakan bahasa browser pengguna akhir.

Kustomisasi backend

Penyesuai sistem ingin menambahkan bidang baru ke entitas manajemen acara yang ada dan ingin melihat bidang tersebut di situs web aktivitas. Misalnya, jika bidang custom_new_field ditambahkan ke entitas evtmgmt_pass . Pass untuk peristiwa dapat diambil menggunakan API titik akhir api/v2.0/events/{readableEventId}/passes, tetapi hasilnya tidak berisi bidang yang baru ditambahkan.

Untuk mengekspos bidang baru agar terlihat di API, ikuti langkah-langkah di bawah ini:

1. Buka instans Customer Insights - Journeys Anda.
2. Buka Pencarian Lanjutan.
3. Pilih entitas Konfigurasi tabel situs web dari menu dropdown dan pilih Hasil.
4. Pilih Konfigurasi tabel Situs Web Baru untuk membuat rekaman baru.
5. Masukkan nama pilihan Anda di bidang Nama .
6. Pilih entitas yang Anda inginkan bidang tambahan terlihat di bidang Entitas yang Dipilih .
7. Tulis array JSON yang berisi bidang kustom baru yang harus terlihat melalui API di bidang yang Dipilih. Ini mengekspos bidang kustom baru melalui API, dan Anda dapat menggunakannya di frontend.