Verwendung von „ MailChimp “ mit „ IBM App Connect Enterprise “

MailChimp ist ein E-Mail-Marketing-Service, mit dem Sie E-Mail-Newsletter, Einladungen, Erinnerungen usw. an Listen von Abonnenten entwerfen und senden können. IBM® App Connect Enterprise bietet die Knoten „ MailChimp -Eingabe“ und „ MailChimp -Anfrage“, mit denen Sie mit MailChimp interagieren können.

Die folgenden Schritte zeigen, wie eine Verbindung zu einem MailChimp -Konto hergestellt und ein MailChimp Request -Knoten mithilfe der Connector-Erkennung konfiguriert wird. Sie können ein ähnliches Verfahren verwenden, um einen MailChimp Input -Knoten für die Überwachung von MailChimp auf neue oder aktualisierte Objekte zu konfigurieren, indem Sie einen Nachrichtenfluss erstellen, der einen MailChimp Input -Knoten enthält, und ihn über die Connectorerkennung konfigurieren.

1. Erstellen Sie im „ IBM App Connect Enterprise “-Toolkit einen Ablauf, der einen Knoten vom Typ „ MailChimp -Anfrage“ enthält.
2. Wählen Sie den MailChimp Request -Knoten im Flow aus, damit die Knoteneigenschaften im Editor angezeigt werden.
3. Klicken Sie auf der Registerkarte Basis auf Connectorerkennung starten.
   Es erscheint eine Anzeige, in der Sie den Namen des Richtlinienprojekts und die Vaultdetails angeben können, die während der Connectorerkennung verwendet werden.
4. Geben Sie die Details des Richtlinienprojekts und der Vault an, die während der Connectorerkennung verwendet werden sollen:
   1. Geben Sie im Feld Richtlinienprojekt das Richtlinienprojekt an, in dem die Richtlinien gespeichert werden, die während der Connectorerkennung erstellt werden.
      Alternativ können Sie ein neues Richtlinienprojekt erstellen, indem Sie auf Neu klicken und dann den Namen des neuen Richtlinienprojekts angeben. Klicken Sie anschließend auf Fertigstellen.
   2. Geben Sie die Vault an, die während der Connectorerkennung verwendet wird. Berechtigungsnachweise, die während der Connector-Erkennung verwendet werden, werden standardmäßig in einer externen Verzeichnisvaultgespeichert. Dies ist eine App Connect Enterprise -Vault, die von jedem Integrationsserver verwendet werden kann. Alternativ können Sie die Berechtigungsnachweise in einer Integrationsserver-Vault speichern, die im Arbeitsverzeichnis des Integrationsservers erstellt und nur von diesem Integrationsserver verwendet werden kann.
      Um die Vault anzugeben, die zum Speichern der Berechtigungsnachweise verwendet werden soll, führen Sie die Schritte im Abschnitt Connectorerkennungsassistenten verwenden in einem der folgenden Abschnitte aus:

      • Konfigurieren eines externen Verzeichnistresors
      • Vault für Integrationsserver konfigurieren
   3. Geben Sie im Feld Vaultschlüssel den Vaultschlüssel ein, der für den Zugriff auf die in der Vault gespeicherten Berechtigungsnachweise verwendet wird. Der Vaultschlüssel muss mindestens 8 Zeichen lang sein.
   4. Optional: Standardmäßig werden die angegebene Vaultposition und der angegebene Vaultschlüssel als Vorgaben im Toolkit gespeichert, sodass die Werte beim Starten der Connectorerkennung voreingestellt sind. Wenn Sie die Vorgaben nicht sichern wollen, wählen Sie In Vaultvorgaben speichernab.
5. Klicken Sie auf Erkennung starten , um den Connectorerkennungsassistenten für den Connector MailChimp zu starten.
   Das Fenster Connectorerkennung wird angezeigt. Wenn vorhandene MailChimp -Verbindungen (Konten) verfügbar sind, wird eine Liste dieser Verbindungen angezeigt. Wenn keine Verbindungen vorhanden sind, wird der Status des Connectors MailChimp als Not connectedangezeigt.
   • Wenn MailChimp -Verbindungen (Konten) verfügbar sind, führen Sie die folgenden Schritte durch:
     1. Wählen Sie die Verbindung (Konto) aus, die Sie verwenden möchten, indem Sie darauf klicken.
     2. Klicken Sie auf den erforderlichen Objekttyp und wählen Sie die Aktion aus, die Sie für das Objekt ausführen möchten. Um beispielsweise Kampagnen abzurufen von MailChimp, klicken Kampagnen und dann Kampagnen abrufen.
   • Wenn keine Verbindungen (Konten) vorhanden sind, führen Sie die folgenden Schritte aus:
     1. Klicken Sie auf den erforderlichen Objekttyp und wählen Sie dann die Aktion aus, die Sie für dieses Objekt ausführen möchten. Um beispielsweise Kampagnen abzurufen von MailChimp, klicken Kampagnen und dann Kampagnen abrufen.
     2. Klicken Sie auf Verbinden.
        Es wird ein Fenster angezeigt, in das Sie die Verbindungsdetails für Ihr MailChimp -Konto eingeben. Geben Sie die folgenden Informationen ein:

        • Zugriffstoken: Registrieren Sie eine Anwendung in Ihrem MailChimp -Konto, um eine Client-ID und einen geheimen Clientschlüssel zu erstellen. Ein Zugriffstoken wird aus der Client-ID, dem geheimen Clientschlüssel, dem Umleitungs-URI und dem Berechtigungscode generiert, der für die Authentifizierung bei MailChimpverwendet wird.

        Weitere Informationen zum Abrufen dieser Verbindungsdaten finden Sie unter „Verwendung von IBM App Connect mit Mailchimp“ in der Dokumentation zu Continuous Delivery (CD) unter IBM App Connect in containers.

     3. Klicken Sie auf Verbinden.
6. Legen Sie die erforderlichen Connectoreigenschaften im Assistenten fest.
   Sie können auch Bedingungen für den Abruf der Daten festlegen, indem Sie auf Bedingung hinzufügen klicken und dann die Eigenschaft auswählen, die Sie filtern wollen. Wenn Sie beispielsweise Kampagnen und anschließend Kampagnen abrufenausgewählt haben, können Sie Kampagnen mit einer bestimmten Kampagnen-IDangeben. Sie können auch Eigenschaften festlegen, die die maximale Anzahl der abzurufenden Datensätze und die Aktion angeben, die ausgeführt werden soll, wenn dieser Grenzwert überschritten wird.
7. Wenn Sie die Eigenschaften im Connectorerkennungsassistenten angegeben haben, klicken Sie auf Speichern.
   Der Berechtigungsnachweis, der für die Verbindung zu MailChimp verwendet wird, wird im Vault gespeichert und die anderen Verbindungsdetails werden in der MailChimp -Richtlinie gespeichert. Die Werte der Eigenschaften, die Sie im Assistenten festgelegt haben, werden an den Knoten „ MailChimp -Anfrage“ im „ IBM App Connect Enterprise -Toolkit“ zurückgegeben.
8. Wenn Sie die Erkennung abgeschlossen und die Eigenschaftswerte gespeichert haben, verlassen Sie den Connectorerkennungsassistenten, indem Sie auf das X in der rechten oberen Ecke des Fensters klicken oder die Tastenkombination Alt+F4drücken.
9. Zurück zur Bearbeitung des Knotens „ MailChimp -Anfrage“ im „ IBM App Connect Enterprise “-Toolkit.
   Die Connectoreigenschaften, die im Assistenten für die Connectorerkennung (in Schritt 6) festgelegt wurden, sind jetzt im MailChimp Request -Knoten im Eigenschafteneditor sichtbar. Auf der Registerkarte Basis werden die Werte der Eigenschaften Aktion und Objekt angezeigt, die Sie im Assistenten festlegen. Wenn Sie beispielsweise im Assistenten Kampagnen > Kampagnen abrufen ausgewählt haben, sind die folgenden Eigenschaften auf der Registerkarte Basis des Knotens sichtbar:

   • Aktion - RETRIEVEALL
   • Objekt - Campaigns

   Die Werte der Eigenschaften Aktion und Objekt werden schreibgeschützt angezeigt. Wenn Sie diese Werte ändern wollen, können Sie dies tun, indem Sie erneut auf Connectorerkennung starten klicken und im Assistenten für die Connectorerkennung neue Werte festlegen.

   Die Eigenschaft Schemabasisname gibt den Basisnamen der Schemadateien an, die das Format der Anforderungs-und Antwortnachrichten beschreiben, die vom MailChimp -Connector gesendet und empfangen werden. Der Basisname des Schemas wird automatisch bei der ersten Ausführung der Erkennung für den Knoten festgelegt und basiert auf dem aktuellen Flow-Namen und dem Knotennamen. Wenn Sie diese Eigenschaft vor der ersten Ausführung der Erkennung manuell festlegen, wird der von Ihnen festgelegte Wert verwendet. Wenn Sie die Schemas nach der Erkennung umbenennen, müssen Sie diese Eigenschaft so bearbeiten, dass sie dem Schemabasisnamen entspricht, der von den umbenannten Schemas im Projekt verwendet wird. Wenn Sie diese Eigenschaft nach der Erkennung ändern, müssen Sie entweder die Schemanamen umbenennen, damit sie übereinstimmen, oder die Erkennung erneut ausführen.

   Abhängig von der Aktion, die während der Erkennung ausgewählt wurde, generiert der Connectorerkennungsassistent entweder ein Anforderungsschema und ein Antwortschema oder nur ein Antwortschema. Ein Anforderungsschema wird nur generiert, wenn die ausgewählte Aktion und das ausgewählte Objekt eine Anforderungsnachricht erfordern. Das generierte Anforderungsschema wird für die Validierung der Anforderungsnachricht verwendet. Wenn die Aktion RETRIEVE oder DELETEwar, wird nur das Antwortschema vom Connector zurückgegeben.

   Die generierten Schemadateien werden dem Projekt hinzugefügt und können vom Knoten Zuordnung für die Transformation von Eingabe-und Ausgabedaten verwendet werden. Der vollständige Dateiname des Schemas wird aus dem Schemabasisnamen (z. B. gen/MyMessageFlow.Mailchimp_Request) mit dem Suffix response.schema.json oder request.schema.jsonabgeleitet. Sie können das Schema öffnen, indem Sie auf Anforderungsschema öffnen oder Antwortschema öffnenklicken.

10. Überprüfen Sie, ob die Eigenschaftseinstellungen im MailChimp Request -Knoten korrekt sind, und speichern Sie dann den Nachrichtenfluss.
11. Auf der Registerkarte Connection des MailChimp Request zeigt die Eigenschaft Policy den Namen der Richtlinie an, die die Details der Sicherheitsidentität enthält, die für die Verbindung zu verwenden ist. Die Richtlinie hat den Typ MailChimp. Weitere Informationen finden Sie unter MailChimp -Richtlinie.
12. Optional: Legen Sie die Eigenschaft Zeitlimit auf der Registerkarte Verbindung fest, um die Zeit (in Sekunden) anzugeben, die der Knoten auf die Verarbeitung der Operation durch MailChimp wartet.
13. Die Registerkarte Filter des MailChimp Request -Knotens enthält Eigenschaften, die steuern, wie der Nachrichtenfluss Daten auswählt. Die Anfangswerte dieser Eigenschaften werden aus den Eigenschaftswerten übernommen, die für den Connector MailChimp im Connectorerkennungsassistenten festgelegt wurden, einschließlich der Filteroptionseigenschaften und aller Bedingungen, die angegeben wurden (wie in Schritt 6beschrieben). Wenn Sie anschließend zum Assistenten für Connectorerkennung zurückkehren und die Werte von Eigenschaften ändern (z. B. durch Hinzufügen neuer Bedingungen), werden diese Aktualisierungen in der Eigenschaftengruppe auf dem Knoten widergespiegelt.

    Die Eigenschaften Filteroptionen steuern, welche Objekte bearbeitet werden sollen, wenn der MailChimp Request -Knoten ausgeführt wird. Die Eigenschaften für Filtergrenzwert steuern die maximale Anzahl abzurufender Elemente und die Aktion, die ausgeführt werden soll, wenn der Grenzwert überschritten wird.

    Sie können die Werte ändern, indem Sie auf Bearbeiten neben dem Wert klicken, den Sie im Abschnitt Filteroptionen ändern wollen, und indem Sie die Eigenschaftswerte ändern, die im Abschnitt Filterbegrenzung festgelegt wurden.

    Die Eigenschaftswerte können entweder Textwerte oder ESQL-oder XPATH-Ausdrücke sein, die aus dem Inhalt der Nachricht aufgelöst werden, die während der Ausführung an den MailChimp -Anforderungsknoten übergeben wird.

14. Legen Sie auf der Registerkarte Anforderung die Eigenschaft Datenposition fest, um die Position in der Baumstruktur für eingehende Nachrichten anzugeben, die die Objektdaten enthält, die in MailChimperstellt werden. Diese Daten bilden die Anforderung, die vom Knoten MailChimp Request an das MailChimp -System gesendet wird.
15. Legen Sie auf der Registerkarte Ergebnis die Eigenschaft Position für Ausgabedaten fest, um die Position in der Baumstruktur der Ausgabenachricht anzugeben, die die Daten des in MailChimperstellten Datensatzes enthält.
16. Standardmäßig werden Anforderungsnachrichten anhand des Anforderungsschemas validiert, das während der Connectorerkennung generiert wurde. Sie können die Anforderungsvalidierung inaktivieren oder die Validierungseinstellungen ändern, indem Sie die Validierungseigenschaften des MailChimp Request -Knotens verwenden.
17. Speichern Sie den Nachrichtenfluss.