Erweiterter Empfängerlisten-Konnektor
Note
Dieses Kapitel richtet sich an Administratoren und Entwickler mit Administratorrechten in Microsoft Dynamics.
Note
Die Dokumentation bezieht sich auf die Konnektor-Version 1.584 und höher.
Die aktuelle Version von Microsoft Dynamics CRM kann nicht mehr als 100.000 Empfänger je Kampagne adressieren. Der erweiterte Empfängerlisten-Konnektor für Optimizely Campaign ist ein externer Windows-Dienst, der die technische Beschränkung aufhebt und Kampagnen und die Übertragung von Marketinglisten mit mehr als 100.000 Empfängern steuert.
Voraussetzungen
- Installationsdatei. Wenden Sie sich an die Kundenbetreuung.
- Microsoft Dynamics CRM online oder On-Premise (lokal)
- SQL-Datenbank, wie beispielsweise LocalDB oder SQL Express.
- Portreservierung
- Öffnen Sie die Eingabeaufforderung als Administrator.
- Führen Sie das Konfigurationsprogramm netsh aus.
- Reservieren Sie den Port mit der Aufforderung add urlacl url=http://+:20000/ user=domain\\username.
Note
Die Angabe des Ports +:20000 muss mit der späteren Angabe des Ports in der Installationsdatei IntegrationService.exe.config übereinstimmen.
Technische Voraussetzungen
- SQL-Server
- Microsoft SQL Server 2008R2 (alle Versionen mit LocalDB) und neuer
- Microsoft SQL Azure
- Windows Identity Foundation 3.5 (Windows-Funktion)
- .NET Version 4.6.2
Installation
- Entpacken Sie die Installationsdatei, die Sie von der Kundenbetreuung erhalten haben.
- Öffnen Sie die Datei IntegrationService.exe.config in einem Texteditor.
- Optional: Konfigurieren Sie die Proxy-Einstellungen.
<add key="proxy.Domain" value= /><add key="proxy.UserName" value= /><add key="proxy.Password" value= /><add key="proxy.Protocol" value= /><add key="proxy.Host" value= /><add key="proxy.CredentialType" value= /><add key="proxy.Port" value= />Note
Die Konfiguration ersetzt nicht die Proxy-Konfiguration für das CRM. Diese ist weiterhin notwendig für Funktionen wie Double Opt-in oder Transaktions-Mails.
- Passen Sie das Element connectionStrings wie folgt an:
<connectionStrings>
<add name="Hangfire.Storage" connectionString="Server= ; Database= ; Trusted_Connection=True; MultipleActiveResultSets=true" />
<add name="CRM" connectionString="RequireNewInstance=true; Url={https://server/organization/}; Domain= ; Username= ; Password= ;" /></connectionStrings>Microsoft Dynamics CRM online
- Stellen Sie beim Parameter connectionString der URL den Parameter AuthType=Office365; voran:
connectionString="AuthType=Office365;Url={https://server/organization/}; Domain= ; Username= ; Password= ;"- Die Parameter Username und Password sind erforderlich.
Microsoft Dynamics CRM On-Premise
- Wenn Sie sich über die folgenden Windows-Dienste anmelden, sind die Parameter Domain, Username und Password im connectionString nicht notwendig:
- Microsoft Dynamics CRM Asynchronous Processing Service (MSCRMAsyncService)
- Microsoft Dynamics CRM Sandbox Processing Service (MSCRM SandboxService)
- Speichern Sie die Datei IntegrationService.exe.config.
- Öffnen Sie die Eingabeaufforderung als Administrator.
- Geben Sie den Konnektor-Pfad ein und installieren Sie die Datei Integrationservice.exe mit der Aufforderung integrationservice.exe install.
- Öffnen Sie Windows-Dienste und starten Sie Episerver Campaign Integration Service.
Note
Wenn Sie die Konfiguration aktualisieren oder ändern möchten, müssen Sie den Konnektor zuerst über Windows-Dienste stoppen.
Konnektor konfigurieren
In der Datei IntegrationService.exe.config können Sie die folgenden Parameter für die Datenübertragung anpassen.
Parameter | Beschreibung | Standardwert |
|---|---|---|
MaxSendRetries | Anzahl der Versuche, ein Empfängerpaket zu übermitteln, wenn ein Versuch z. B. durch eine Zeitüberschreitung fehlschlägt. | 3 |
TimeoutCrmConnection | Maximale Dauer in Sekunden für die Übermittlung eines Empfängerpakets vom CRM zum Dienst, bevor ein Zeitüberschreitungsfehler auftritt. | 60 |
TimeoutEpiserverConnection | Maximale Dauer in Sekunden für die Übermittlung eines Empfängerpakets vom Dienst zu Optimizely Campaign, bevor ein Zeitüberschreitungsfehler auftritt. | 120 |
UseSoapServiceForRecipientLists | Wahl zwischen Datenübertragung mittels SOAP- oder REST-API. Standardmäßig wird die REST-API verwendet. | false |
BatchSize | Größe des Empfängerpakets bei der Übertragung vom Dienst zu Optimizely Campaign. Bei der Übertragung mittels SOAP-API beträgt der maximale Wert 1000. | 5000 |
CrmBatchSize | Größe des Empfängerpakets bei der Übertragung vom CRM zum Dienst. | 1000 |
MaxThreads | Anzahl der parallelen Threads bei der Übertragung mittels API. Die maximale Anzahl beträgt 6. | 5 |
Konfiguration in Microsoft Dynamics CRM
- Wählen Sie in Microsoft Dynamics CRM unter Einstellungen > Konfigurationen.
- Klicken Sie auf Neu.
- Geben Sie als Namen Use Windows Service ein.
Tip
Sie können das Feld Wert frei lassen. Es ist keine Definition erforderlich.
- Klicken Sie auf Speichern und Schließen.
Wartung und Fehlersuche
Mit dem Tool Hangfire können Sie geplante, laufende und ausgeführte Workflows einsehen und verwalten. Sie installieren Hangfire automatisch mit dem Konnektor und können das Tool im Webbrowser unter der folgenden Adresse aufrufen: http://localhost:20000/hangfire.
Um die Protokolldaten des Dienstes einzusehen, öffnen Sie im Verzeichnis logs die Datei logs.txt. Die Protokolldaten der vergangenen Tage finden Sie im Verzeichnis archives.
Deinstallation
Um den erweiterten Empfängerlisten-Konnektor zu deinstallieren und vollständig zu entfernen, gehen Sie wie folgt vor:
Note
Der erweiterte Empfängerlisten-Konnektor muss inaktiv sein. Öffnen Sie Windows-Dienste und stoppen Sie Episerver Campaign Integration Service.
- Öffnen Sie die Eingabeaufforderung als Administrator.
- Geben Sie den Konnektor-Pfad ein und deinstallieren Sie die Datei Integrationservice.exe mit der Aufforderung integrationservice.exe uninstall.
Tip
Das Installationsverzeichnis bleibt weiterhin bestehen. Löschen Sie das Verzeichnis inklusive der Protokolldaten.
- Wählen Sie in Microsoft Dynamics CRM unter Einstellungen > Konfigurationen.
- Wählen Sie den Konfigurationsdatensatz Use Windows Service aus und klicken Sie auf Löschen.
