Eseménykezelési webalkalmazás áttekintése

Feljegyzés

2023. szeptember 1-én a Dynamics 365 Marketing és a Dynamics 365 Customer Insights közösen lesz értékesítve egyetlen termékváltozatban, Dynamics 365 Customer Insights néven. Az egyes alkalmazások új neve Dynamics 365 Customer Insights – Utak és Dynamics 365 Customer Insights – Adatok. További információ: Dynamics 365 Customer Insights GYIK

Továbbá 2023. szeptember 1-től az új Dynamics 365 Marketing ügyfelek csak a valós idejű marketinges funkciókat kapják meg. További információk: Alapértelmezett valós idejű marketing telepítés. Számos dokumentációs oldal jelenleg olyan kimenő funkciókra hivatkozik, amelyek nem elérhetők, vagy másképp működnek a valós idejű marketingben. A dokumentáció tartalma szeptemberben frissül, hogy jelezve legyen, hogy a valós idejű vagy kimenő marketingre vonatkozik-e.

A eseménykezelés funkció segít az események szervezésében, kezelésében és feldolgozásában. A eseménykezelés megoldás telepítésekor kap egy eseményportált, amely webalkalmazást biztosít a felhasználóknak, ahol többet tudhatnak meg az esemény részleteiről. További információ: Event Portal.

Az eseményportál két részből áll:

  1. Előtétprogram
  2. REST API háttérprogram

Az előtétprogramot a rendelkezésre álló keretrendszerek bármelyikével megvalósíthatja. Az előtétprogram rész egy egyoldalas alkalmazás, és teljesen testreszabható. A háttérrendszer és a háttérrendszer testreszabása az üzemeltetés típusától függ.

Egyéni eseménywebhelyet kétféleképpen üzemeltethetsz:

  1. Saját üzemeltetésű
  2. Power Apps Portál üzemeltetve

Előfeltételek

Elkészítheti előtétprogramját, vagy testreszabhatja a megadott bemutató esemény webhelyét.

Feljegyzés

A mellékelt demo esemény weboldal egy Angular keretrendszer alapú weboldal. Mivel azonban a háttérprogram nem függ az előtétprogramtól, bármilyen keretrendszert használhat.

A bemutató esemény webhelyének testreszabásának megkezdéséhez kövesse az alábbi lépéseket:

  1. Töltse le a mintaesemény webhelyének forráskódját.

  2. Telepítse a Node.js alkalmazást a 10.x és a 16.x verzió között. Az üzembe helyezés nem fog működni az újabb verziókkal.

  3. Nyissa meg a parancssort vagy a Windows PowerShellt, és futtassa a parancsot annak ellenőrzéséhez, hogy a telepítés sikeres volt-e.

     node -v
    

    Feljegyzés

    Ha már nyitva van egy terminál vagy héj, indítsa újra, mielőtt beírná a parancsot.

  4. Futtassa a parancsot az Angular alkalmazás létrehozásához és futtatásához szükséges Angular CLI (parancssori felület) telepítéséhez. További információ: Angular CLI.

    npm install -g @angular/cli
    
  5. Keresse meg azt a könyvtárat, ahová letöltötte a forráskódot , és futtassa a parancsot a webhely futtatásához szükséges összes csomag lekéréséhez.

    npm install
    

    Feljegyzés

    A parancsot ugyanabban a könyvtárban kell futtatnia, ahol a package.json fájl található.

  6. A háttérszolgáltatásokkal való interakcióhoz tekintse meg a nyilvános API dokumentációját .

  7. Emellett rendelkeznie kell egy Dynamics 365 Customer Insights - Journeys-példánnyal, amelyen telepítve van eseménykezelés megoldás és a portálok megoldás. A telepítéshez lásd: Regisztráció ingyenes Dynamics 365 Customer Insights Journeys-próbaverzióra.

Töltse le a mintaesemény webhelyét

Feljegyzés

A mintaesemény webhelyének újabb verziói az új funkciók és hibajavítások megjelenése után lesznek elérhetők.

Válassza ki a letölteni kívánt verziót az alábbi táblázatból.

Name Felszabadítás Módosítások Feltöltve
Minta esemény webhelye 1.46.0 (szeptemberi kiadás) - Javítsa ki a hozzáférhetőségi problémákat.
- Kisebb fejlesztések és hibajavítások.
Letöltés
Minta esemény webhelye 1.34.0 (áprilisi kiadás) - Kisebb fejlesztések és hibajavítások. Letöltés
Minta esemény webhelye 1.30.0 (decemberi kiadás) - Kisebb fejlesztések és hibajavítások. Letöltés
Minta esemény webhelye 1.28.0 (októberi kiadás) - Hozzáadásra került a helyi dátumkonverzió engedélyezésének lehetősége.
- További webhelynyelvi konfigurációk hozzáadása.
Letöltés
Minta esemény webhelye 1.27.0 (szeptemberi kiadás) - Hozzáadott lehetőség a dátumok megjelenítésének konfigurálására.
- Kisebb fejlesztések és hibajavítások.
Letöltés
Minta esemény webhelye 1.24.0 (júniusi kiadás) - Frissített telepítési szkript, hogy lehetővé tegye az egyetlen fájl telepítését a portálok számára.
- Kisebb fejlesztések és hibajavítások.
Letöltés
Minta esemény webhelye 1.23.0 (májusi kiadás) - Javítsa ki a hozzáférhetőségi problémákat.
- Kisebb fejlesztések és hibajavítások.
Letöltés
Minta esemény webhelye 1.22.0 (áprilisi kiadás) - Javítsa ki a hozzáférhetőségi problémákat.
- Kisebb fejlesztések és hibajavítások.
Letöltés
Minta esemény webhelye 1.21.0 (márciusi kiadás) - Stop-regisztrációk hozzáadva az eseményekhez.
- Kisebb fejlesztések és hibajavítások.
Letöltés
Minta esemény webhelye 1.20.0 (februári kiadás) - Integrálja a marketing űrlapokat az események regisztrációjához.
- Kisebb fejlesztések és hibajavítások.
Letöltés
Minta esemény webhelye 1.19.0 (decemberi kiadás) - Javítsa ki a hozzáférhetőségi problémákat.
- Frissítse a webhely nyelvét.
- A hangszóró oldalának javítása.
- Kisebb fejlesztések és hibajavítások.
Letöltés
Minta esemény webhelye 1.18.0 (októberi kiadás) - Kisebb fejlesztések és hibajavítások. Letöltés
Minta esemény webhelye 1.17.0 (szeptemberi kiadás) - A fizetett események munkafolyamatának javítása.
- Javítsa ki az IE11 kompatibilitási problémáit.
- Az esemény részleteinek javítása.
- Kisebb fejlesztések és hibajavítások.
Letöltés
Minta esemény webhelye 1.16.0 (augusztusi kiadás) - Az eseményoldal betöltési viselkedésének javítása.
- A logikai típusú egyéni regisztrációs mező felhasználói felületének/felhasználói felületének javítása.
- Kisebb fejlesztések és hibajavítások.
Letöltés
Minta esemény webhelye 1.15.0 (júliusi kiadás) - Információk hozzáadása a munkamenet-lista nézethez, ha a munkamenet megtelt.
- Érvényesítés hozzáadása az egyéni regisztrációs mezőkhöz.
- A fordítások javítása.
- A hiányzó betűtípus-félelmetes ikonok javítása a portálokra való telepítés után.
- Kisebb fejlesztések és hibajavítások.
Letöltés
Minta esemény webhelye 1.14.0 (júniusi kiadás) Frissítés az Angular 7-re, a fizetési oldal felhasználói felületének & javítása, fordítások frissítése és javítása, a DeployToD365Instance.ps1 parancsfájl javítása, az egyéni regisztrációs mezők érvényesítésének javítása, egyéb hibajavítások Letöltés
Minta esemény webhelye 1.13.0 (áprilisi kiadás) Várólista funkció munkamenet szinten, UI polírozás, hibajavítások Letöltés
Minta esemény webhelye 1.12.2 (márciusi kiadás) & UI UX fejlesztések, hibajavítások Letöltés

Környezeti konfigurációs paraméterek

Az src\environments mappa konfigurációs mintafájlokat tartalmaz különböző környezetekhez (saját, portálon üzemeltetett, fejlesztési). Az egyéni eseménywebhely konfigurációja egy environment.ts fájl létrehozásával történik a \src\environments mappában. A konfiguráció módosítására vonatkozó utasításokat a kapcsolódó cikkekben találja: Környezeti konfiguráció saját üzemeltetéshez és Környezet konfigurálása a portálon üzemeltetetthez.

Néhány paraméter, amelyet meg kell értenie az egyéni eseménywebhely konfigurálásának megkezdése előtt:

Paraméter Description
termelés Engedélyezi vagy letiltja az Angular alkalmazás termelési módját. További információ: Angular dokumentáció.
buildVersion Ez a mező alapértelmezés szerint a package.json fájlban megadott verzióra hivatkozik. Ezt a tulajdonságot nem kell módosítani. Ha azonban nem szeretné elérhetővé tenni az alkalmazás verzióját, beállíthatja a következőre null.
apiEndpoint Az eseménykezelés API-végpont mutató URL-cím (amely az események információinak lekérésére és regisztrációkra szolgál).
localizationEndpoint Arra az URL-címre mutat, ahol a honosítási fájlok tárolva vannak (alapértelmezés szerint a gyökérkönyvtárban vannak tárolva).
imagesEndpoint Megadja azt az alap URL-címet, ahonnan a képek megjelennek. Ez a konfiguráció lehetővé teszi, hogy más helyről szolgáltasson ki képeket, amire akkor lehet szükség, ha tartalomkézbesítési hálózatot vagy képfeldolgozó szolgáltatást szeretne használni.
useRestStack Ez a beállítás határozza meg, hogy melyik API-t használja a rendszer. Ha true (igaz) értékre van állítva, akkor a rendszer az új eseménykezelés nyilvános API-t használja. Ha false (hamis) értékre van állítva, akkor a rendszer az elavult eseménykezelés Portal API-t használja. Ez az API csak akkor használható, ha az egyéni esemény webhelyét a portálokon üzemelteti. Az új eseménykezelés nyilvános API használatához regisztrálnia kell a webalkalmazást.
emApplicationtoken Ez a jogkivonat hitelesíti a webalkalmazást a eseménykezelés nyilvános API-n. Az alkalmazás jogkivonatát úgy kérheti le, hogy regisztrál egy új webalkalmazást a Customer Insights – Journeys példányban. Erre a jogkivonatra nincs szükség, ha az elavult eseménykezelés Portal API-t használja.
isAuthenticationEnabled Ez a jelző határozza meg, hogy a felhasználói hitelesítés támogatott-e vagy sem (azaz a felhasználó regisztrálhat vagy bejelentkezhet). Ha false (hamis) értékre van állítva, akkor az alkalmazás nem jeleníti meg a bejelentkezés vagy a regisztráció módját.
useAadB2C Megadja, hogy szeretné-e használni Azure Active Directory a B2C identitáskezelést a hitelesítéshez. Ha portálidentitás-kezelést Power Apps szeretne használni, ezt a jelzőt false (hamis) értékre kell állítani. Ha AAD B2C engedélyezve van, konfigurálnia kell a aadB2CConfig változót.
aadB2CConfig Az alkalmazás által használt konfigurációs objektum eseménykezelés AAD B2C identitáskezelés engedélyezve van.
useMockData Ezzel a beállítással szimulált objektumokat adhat vissza valódi API-hívások helyett.
dateSettings Ezzel a beállítással konfigurálhatja a dátumok formázását a webhelyen. Ha convertToLocalDate a jelző true (igaz) értékre van állítva, a rendszer automatikusan átalakítja az összes dátumot a végfelhasználók helyi idejére.
languageSettings Ezzel a beállítással konfigurálhatja, hogyan töltődjenek be a nyelvek a webhelyen. Ha forceSingleLanguage a jelző true (igaz) értékre van állítva, a webhely a megadott nyelven töltődik be websiteLanguageLcid. A showLanguageDropdown zászló lehetővé teszi a nyelvi legördülő menü megjelenítését vagy elrejtését. Alapértelmezés szerint a nyelv legördülő menüje látható, és a webhely a végfelhasználók böngészőjének nyelvét fogja használni.

Háttérrendszer testreszabása

A rendszertestreszabó új mezőt szeretne hozzáadni a meglévő eseménykezelés entitáshoz, és látni szeretné ezt a mezőt az esemény webhelyén. Ha például a custom_new_field mező hozzá van adva aevtmgmt_pass entitáshoz. Az esemény passzai az API-végpont api/v2.0/events/{readableEventId}/passes használatával kérhetők le, de az eredmény nem tartalmazza az újonnan hozzáadott mezőt.

Ha láthatóvá szeretné tenni az új mezőt az API-ban, kövesse az alábbi lépéseket:

  1. Nyissa meg a Customer Insights – Journeys példányt.
  2. Nyissa meg az Irányított keresés alkalmazást .
  3. Válassza ki a Webhelytábla-konfigurációk entitást a legördülő menüből, majd válassza az Eredmények lehetőséget.
  4. Válassza az Új webhely táblakonfiguráció lehetőséget egy új rekord létrehozásához.
  5. Írja be a kívánt nevet a Név mezőbe.
  6. Válassza ki azt az entitást, amelyet egy további mezővel szeretne láthatóvá tenni a Kijelölt entitás mezőben.
  7. Írjon egy JSON-tömböt, amely tartalmazza az új egyéni mezőt, amelynek láthatónak kell lennie az API-n keresztül a Kiválasztott mezőkben. Ez elérhetővé teszi az új egyéni mezőt az API-n keresztül, és felhasználhatja azt az előtétprogramban.