Erweiterter Empfängerlisten-Konnektor

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
  1. Öffnen Sie die Eingabeaufforderung als Administrator.
  2. Führen Sie das Konfigurationsprogramm netsh aus.
  3. Reservieren Sie den Port mit der Aufforderung add urlacl url=http://+:20000/ user=domain\username.

     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

1. Entpacken Sie die Installationsdatei, die Sie von der Kundenbetreuung erhalten haben.
2. Öffnen Sie die Datei IntegrationService.exe.config in einem Texteditor.
3. 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= />

   Die Konfiguration ersetzt nicht die Proxy-Konfiguration für das CRM. Diese ist weiterhin notwendig für Funktionen wie Double Opt-in Verfahren, bei dem der Empfänger vor dem Erhalt von Werbe-Mailings seine Einwilligung zum Empfang von E-Mails gibt. Der Empfänger erhält daraufhin eine E-Mail mit Double-Opt-In-Link, den er als Bestätigung klicken muss. oder Transaktions-Mails Eine E-Mail, die im Anschluss an eine bestimmte Aktion des Empfängers (z. B., wenn er etwas bestellt oder kauft) oder an ein bestimmtes Ereignis (z. B. ein Jahrestag) versendet wird..

4. 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)
5. Speichern Sie die Datei IntegrationService.exe.config.
6. Öffnen Sie die Eingabeaufforderung als Administrator.
7. Geben Sie den Konnektor-Pfad ein und installieren Sie die Datei Integrationservice.exe mit der Aufforderung integrationservice.exe install.

   

8. Öffnen Sie Windows-Dienste und starten Sie Episerver Campaign Integration Service.

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 Ausführungsstrang oder Ausführungsreihenfolge von Prozessen wie beispielsweise API-Anfragen. bei der Übertragung mittels API. Die maximale Anzahl beträgt 6.	5

Konfiguration in Microsoft Dynamics CRM

1. Wählen Sie in Microsoft Dynamics CRM unter Einstellungen > Konfigurationen.

   

2. Klicken Sie auf Neu.
3. Geben Sie als Namen Use Windows Service ein.

   

   Sie können das Feld Wert frei lassen. Es ist keine Definition erforderlich.

4. 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:

1. Öffnen Sie die Eingabeaufforderung als Administrator.
2. Geben Sie den Konnektor-Pfad ein und deinstallieren Sie die Datei Integrationservice.exe mit der Aufforderung integrationservice.exe uninstall.

   

   Das Installationsverzeichnis bleibt weiterhin bestehen. Löschen Sie das Verzeichnis inklusive der Protokolldaten.

3. Wählen Sie in Microsoft Dynamics CRM unter Einstellungen > Konfigurationen.

   

4. Wählen Sie den Konfigurationsdatensatz Use Windows Service aus und klicken Sie auf Löschen.