Im Power Apps Portal im Outbound-Marketing gehostet

Anmerkung

Dynamics 365 Marketing und Dynamics 365 Customer Insights sind jetzt Customer Insights - Journeys und Customer Insights - Data. Weitere Informationen finden Sie in den FAQs zu Dynamics 365 Customer Insights

Neue Kunden von Customer Insights - Journeys erhalten ausschließlich Echtzeitmarketingfunktionen. Zusätzliche Informationen finden Sie in Echtzeitkontaktverläufe – Standardinstallation.

Wichtig

Dieser Artikel gilt nur für Outbound-Marketing.

Bevor Sie eine selbst gehostete benutzerdefiniertes Ereigniswebsite starten, schließen Sie die Aktionen ab, die im Thema Voraussetzungen beschrieben werden. Die angepasste Ereigniswebsite für die Ereignisverwaltung wird als eine Power Apps-Portal-gehostete Webanwendung bereitgestellt, wenn Sie die Ereignisverwaltungslösung installieren.

Der vordere Teil der Anwendung ist in zwei Ressourcendateien zusammengefasst, die für Power Apps-Portal Internet-Dateien gespeichert werden. Der einzelne Hauptseiten-Anwendungseintrittspunkt wird als Power Apps-Portal Internet-Vorlage gespeichert.

Obwohl die Frontend-Definition auf Power Apps-Portal gehostet wird, können Sie sie dennoch vollständig anpassen. Der Backend-Teil der Webanwendung kann nicht angepasst werden, da die REST-API-Endpunkte im Power Apps-Portal als ein Set von Webseiten gehostet werden. Der Code, der die die Geschäftslogik dahinter enthält, befindet sich in Veranstaltungsmanagement-Plug-Ins, die nicht angepasst werden können.

Zusätzliche Projekteinrichtung

Umgebungskonfiguration

1. Duplizieren Sie die environment.d365.ts-Konfigurationsdatei, die sich im Ordner \src\environments befindet, und nennen Sie sie environment.ts.

2. Öffnen Sie die environment.ts-Konfigurationsdatei in der Entwicklerumgebung Ihrer Wahl.

3. Ändern Sie die Variable apiEndpoint so, dass sie auf den Wert Websitebindungen zeigt.

   

   Anmerkung

   Sie müssen einen nachfolgenden Schrägstrich am Ende der URL hinzufügen.

4. Stellen Sie sicher, dass die Variable useRestStack auf „false“ festgelegt ist.

Lokale Entwicklung

CSRF umgehen

Sie müssen das Anti-CSRF-Token für lokale Entwicklung umgehen. Navigieren Sie dafür zu Dynamics 365 > Portale > Webvorlagen und öffnen Sie die Webvorlage PortalAPI und ändern Sie das Flag bypassTokenVerification auf true. Starten Sie Portale neu, um sicherzustellen, dass die Einstellungen übernommen werden.

Notiz

Die Webvorlage PortalAPI wird standardmäßig hinzugefügt, wenn Sie die Ereignisverwaltungsdaten installieren.

Seite lokal bereitstellen

Um die Anwendung lokal bereitzustellen, müssen Sie den Anweisungen unten folgen:

1. Öffnen Sie die Eingabeaufforderung oder Windows PowerShell.

2. Führen Sie den Befehl aus, um alle Abhängigkeiten zu installieren.

   npm install
   

3. Befehl ausführen, um die style.css-Datei zu generieren

   ng build --prod --output-hashing none
   

4. Führen Sie den Befehl aus, um den lokalen Entwicklungsserver zu starten und die Änderungen sofort anzuzeigen.

   ng serve
   

   Notiz

   Weitere Informationen zum lokalen Bereitstellen einer Angular-Anwendung finden Sie hier: Lokales Bereitstellen einer Angular-Anwendung

Bereitstellung

Um Ihre Anpassungen in der Ereigniswebsite sichtbar zu machen, aktualisieren Sie die Internet-Dateien in Portalen. Dies kann mithilfe des bereitgestellten Skripts automatisch erfolgen DeployToDynamics365Instance.ps1.

Automatische Bereitstellung

Um die benutzerdefinierte Angular-Anwendung bereitzustellen, führen Sie das PowerShell-Skript DeployToDynamics365Instance.ps1 im Verzeichnis Skripte aus. Durch das Skript wird die Angular-Anwendung erstellt und die Ausgabedateien werden für das Hosting unter der Power Apps-Portalinstanz vorbereitet. Sie nimmt die Lokalisierungsdateien im Ordner Localization und bereitet sie für das Hosten vor.

Nachdem alle Dateien erstellt wurden, werden Sie gebeten, sich in Ihrer Dynamics 365 Customer Insights - Journeys-Instanz anzumelden, die Sie verwenden möchten, um die Anwendung zu hosten. Nachdem Sie sich angemeldet haben, werden die Dateien an die Instanz weitergeleitet. Wenn Sie die Änderungen nicht angezeigt sehen, löschen Sie den Browsercache und starten Sie Ihre Portale.

Wenn Sie bestimmte Dateien anstelle aller Dateien gleichzeitig bereitstellen möchten, können Sie die Liste der Dateien als Parameter für das Skript angeben: .\DeployToDynamics365Instance.ps1 -inputFiles main.es. Sie finden die Liste mit allen unterstützten Dateien im Skriptinhalt.

Notiz

• Wenn Sie das PowerShell-Skript wegen Ihrer Ausführungsrichtlinie nicht ausführen können, dann müssen Sie deaktivieren oder die Ausführungsrichtlinie umgehen.
• Es wird empfohlen, Dateien aufgrund von Problemen mit der Barrierefreiheit nicht manuell hochzuladen. Verwenden Sie das Skript DeployToDynamics365Instance.ps1, um Ihre Anpassungen automatisch in Ihre Instanz zu übernehmen.

Cross Origin Resource Sharing (CORS) konfigurieren

Wenn Sie die benutzerdefinierte Ereigniswebsite über eine benutzerdefinierte Domäne bereitstellen möchten, müssen Sie CORS konfigurieren, um diese Aktion der benutzerdefinierten Domäne zu erlauben:

1. Gehen Sie zu Dynamics 365-angepasst>Portale>Site-Einstellungen und wählen Sie Neu, um einen Datensatz für Site-Einstellungen zu erstellen.

2. Geben Sie HTTP/Access-Control-Allow-Origin in das Namensfeld ein.

3. Wählen Sie Ihre Website aus.

4. Fügen Sie den benutzerdefinierten Ursprung hinzu, der zulässig sein soll. Wenn die benutzerdefinierte Ereigniswebsite beispielsweise auf der benutzerdefinierter Domäne https://contoso.com/ gehostet wird, muss das Wertfeld auf https://contoso.com/ festgelegt werden.

5. Wählen Sie Speichern aus.

6. Starten Sie Portale neu, um sicherzustellen, dass die Einstellungen übernommen werden.

   

   Anmerkung

   Weitere Informationen über CORS finden Sie hier CORSAccess-Control-Allow-Origin

Beispielwebsite manuell überschreiben

Wenn Sie die Beispielwebsite überschreiben möchten, damit sie mit Ihrer aktuellen Version der Ereignisverwaltung übereinstimmt, finden Sie weitere Informationen unter Beispielwebsite manuell überschreiben