Manuell einen benutzerdefinierten Kanal hinzufügen
Dynamics 365 Customer Insights - Journeys unterstützt E-Mail-, Push- und SMS-Kanäle systemintern. Um einen Kanaltyp oder einen SMS-Anbieter zu verwenden, der nicht systemintern unterstützt wird, können Sie einen benutzerdefinierten Kanal installieren. Wenn der Kanal nicht bereits in AppSource bereitgestellt wird, können Sie ihn manuell erstellen und installieren.
Benutzerdefinierte Kanalstruktur
Benutzerdefinierte Kanäle können als Teil einer Dataverse Lösung implementiert werden. Die folgenden Schritte und Aktionen sind zum Erstellen eines benutzerdefinierten Kanals erforderlich:
- Eine erweiterte Konfigurationsentität für die Kanalinstanz definieren
- Eine erweiterte Konfigurationsentität für das Kanalinstanzkonto definieren (nur SMS)
- Die Nachrichtenteile definieren (lösungsfähige Komponente)
- Die Lokalisierung für die Administratoroberfläche definieren (optional)
- Die Nachrichteneditor-Schnittstelle definieren (optional)
- Benutzerdefinierte APIs definieren
- Den benutzerdefinierten Kanal definieren (lösungsfähige Komponente)
Customer Insights - Journeys stellt Basiskomponenten für die benutzerdefinierte Kanalerstellung bereit, darunter benutzerdefinierte APIs und die erforderlichen Entitäten wie msdyn_channeldefinition, msdyn_channelmessagepart, msdyn_channellocale, msdyn_channelinstanceaccount und msdyn_channelinstance.
Das folgende Diagramm veranschaulicht die Hauptkomponenten eines systeminternen Customer Insights - Journeys-Kanals und einer benutzerdefinierten Kanallösung:
Die folgende Tabelle beschreibt die Implementierungsanforderungen für SMS- und benutzerdefinierte Kanäle.
| Komponente | SMS | Benutzerdefiniert |
|---|---|---|
| Erweiterte Konfigurationsentität für die Kanalinstanz | Erforderlich | Erforderlich |
| Erweiterte Konfigurationsentität für das Kanalinstanzkonto | Erforderlich | Nicht unterstützt |
| Nachrichtenteile | Erforderlich, sollte nur einen einzigen Nachrichtenteil mit „msdyn_name“ = „Text“ enthalten | Erforderlich |
| Lokalisierung für die Admininistratorbenutzeroberfläche | Optional | Optional |
| Benutzeroberfläche Nachrichten-Editor | Nicht zulässig, systeminterner Customer Insights - Journeys-SMS-Editor wird verwendet | Optional; falls nicht definiert, wird der allgemeine Customer Insights - Journeys-Editor verwendet |
| Benutzerdefinierte APIs | Erforderlich | Erforderlich |
| Kanaldefinition | Erforderlich | Erforderlich |
Beispiellösungen
Die folgenden Beispiele enthalten unverpackte Lösungen für Dataverse und Plugin-Projekte. Um die Lösungen zu packen und zu importieren, erstellen Sie zuerst das Plugin-Projekt. Das Projekt kopiert dann die Assembly in das Lösungsprojekt. Dann verpacken Sie die Lösung mit dem Lösungspaket-Tool.
So wird das Plugin-Projekt erstellt und die Lösung verpackt
Erstellen Sie das Plug-In-Projekt mit MSBuild oder Visual Studio.
Beim Erstellen des Projekts entsteht eine DLL im Ordner „PluginAssemblies“ innerhalb des Dataverse-Lösungsordners.
Packen Sie den nicht verwalteten Ordner mit dem Solution Packager mit einer der folgenden Methoden:
- PAC CLI (bevorzugt)
- Lösungspacker
pac solution pack --zipfile C:\tmp\SampleCustomChannelSolution.zip -f src\Solutions\Samples\SampleCustomChannel\SampleCustomChannel.Solution\unmanaged --packagetype Both