Nutzung von „ Salesforce “ Commerce Cloud Digital Data mit „ IBM App Connect Enterprise “

Salesforce Commerce Cloud Digital Data (bisher unter der Bezeichnung "Demandware" bekannt) bietet Unternehmen eine Cloud-basierte Lösung zur Schaffung eines einheitlichen Online-Einkaufserlebnisses für ihre Kunden. Die Plattform ermöglicht es Unternehmen, Kundenanforderungen aus gewonnenen Erkenntnissen vorherzusehen, sodass Kunden Produkte durchsuchen und schnell und einfach Einkäufe tätigen können. IBM® App Connect Enterprise bietet die Knoten „ Salesforce -Commerce-Cloud-Digitaldaten-Eingabe“ und „ Salesforce -Commerce-Cloud-Digitaldaten-Anfrage“ an, mit denen Sie mit den digitalen Daten der Salesforce -Commerce-Cloud interagieren können.

Die folgenden Schritte zeigen, wie Sie mithilfe der Connectorerkennung eine Verbindung zu einem Salesforce Commerce Cloud Digital Data -Konto herstellen und einen Salesforce Commerce Cloud Digital Data Request -Knoten konfigurieren. Sie können eine ähnliche Prozedur ausführen, um einen Salesforce Commerce Cloud Digital Data Input -Knoten für die Überwachung von Salesforce Commerce Cloud Digital Data auf neue oder aktualisierte Objekte zu konfigurieren, indem Sie einen Flow erstellen, der einen Salesforce Commerce Cloud Digital Data Input -Knoten enthält, und ihn über die Connectorerkennung konfigurieren.

1. Erstellen Sie im „ IBM App Connect Enterprise “-Toolkit einen Ablauf, der einen Knoten „ Salesforce Commerce Cloud Digital Data Request“ enthält.
2. Wählen Sie den Knoten Salesforce Commerce Cloud Digital Data Request 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 anschließend 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 Salesforce Commerce Cloud Digital Data zu starten.
   Das Fenster Connectorerkennung wird angezeigt. Wenn vorhandene Salesforce Commerce Cloud Digital Data -Verbindungen (Konten) verfügbar sind, wird eine Liste dieser Verbindungen angezeigt. Wenn keine Verbindungen vorhanden sind, wird der Status des Salesforce Commerce Cloud Digital Data -Connectors als Not connectedangezeigt.
   • Wenn Salesforce Commerce Cloud Digital Data -Verbindungen (Konten) verfügbar sind, führen Sie die folgenden Schritte aus:
     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 dann die Aktion aus, die Sie für das Objekt ausführen möchten. Um beispielsweise Kataloge aus Salesforce Commerce Cloud Digital Dataabzurufen, klicken Sie auf Kataloge und anschließend auf Kataloge 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 Kataloge aus Salesforce Commerce Cloud Digital Dataabzurufen, klicken Sie auf Kataloge und anschließend auf Katalog abrufen.
     2. Klicken Sie auf Verbinden.
        Es wird ein Fenster angezeigt, in das Sie die Verbindungsdetails für Ihr Salesforce Commerce Cloud Digital Data -Konto eingeben. Geben Sie die folgenden Informationen ein:

        • Base URL : Die Basis URL (oder Protokoll und Hostname) Ihrer Salesforce Commerce Cloud-Instanz.
        • API-Version: Die API-Version Ihrer Salesforce B2C Commerce-Instanz.
        • Client-ID: Salesforce Commerce Cloud-Client-ID
        • Geheimer Clientschlüssel: Salesforce Commerce Cloud-Client-ID.

        Weitere Informationen zum Abrufen oder Generieren dieser Verbindungsdaten finden Sie im Abschnitt „Verwendung von IBM App Connect mit Salesforce Commerce Cloud Digital Data“ 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.
   Für Abruf-oder Aktualisierungsaktionen können Sie Bedingungen zum Abrufen der Daten hinzufügen, indem Sie auf Bedingung hinzufügen klicken und dann die Eigenschaft auswählen, nach der gefiltert werden soll.

   Wenn Sie Bedingungen für Abruf-oder Aktualisierungsaktionen hinzufügen, können Sie optional die Bedingungsfilterung verwenden, um die angewendeten Bedingungen zu optimieren. Um die Bedingungsfilterung zu verwenden, beenden Sie den Assistenten für die Connectorerkennung, indem Sie auf die Schaltfläche 'Schließen' (X) klicken und anschließend die Anweisungen unter Bedingungsfilterung verwendenausführen.

   Für Erstellungsaktionen können Sie optional den erweiterten Modus verwenden. In der Standardbearbeitungsansicht für eine Aktion haben einige Anwendungen Felder, die ausgeblendet sind, da sie für allgemeine Anwendungsfälle nicht erforderlich sind. Für komplexere Anwendungsfälle können Sie zur Bearbeitung im erweiterten Modus wechseln, die zusätzliche Funktionen für die Bearbeitung von Abläufen bietet. Um den erweiterten Modus zu verwenden, beenden Sie den Assistenten für die Connectorerkennung, indem Sie auf die Schaltfläche 'Schließen' (X) klicken und anschließend die Anweisungen unter Erweiterten Modus verwendenausführen.

   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.
   Die Berechtigungsnachweise, die für die Verbindung zu Salesforce Commerce Cloud Digital Data verwendet werden, werden in der Vault gespeichert und die anderen Verbindungsdetails werden in der Salesforce Commerce Cloud Digital Data-Richtliniegespeichert. Die Werte der Eigenschaften, die Sie im Assistenten festgelegt haben, werden an den Knoten „ Salesforce Commerce Cloud Digital Data Request“ 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. Kehren Sie zur Bearbeitung des Knotens „ Salesforce Commerce Cloud Digital Data Request“ im „ IBM App Connect Enterprise -Toolkit “ zurück.
   Die Connectoreigenschaften, die im Assistenten für die Connectorerkennung (in Schritt 6) festgelegt wurden, sind jetzt im Salesforce Commerce Cloud Digital Data 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 Kataloge > Katalog abrufen im Assistenten ausgewählt haben, werden die folgenden Eigenschaften auf der Registerkarte Basis des Knotens angezeigt:

   • Aktion - RETRIEVEALL
   • Objekt - catalog

   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 Salesforce Commerce Cloud Digital Data -Connector gesendet und empfangen werden. Der Basisname des Schemas wird bei der ersten Ausführung der Erkennung für den Knoten automatisch 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 durchfü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.Salesforce_Commerce_Cloud_Digital_Data_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 Eigenschafteneinstellungen auf dem Salesforce Commerce Cloud Digital Data Request -Knoten korrekt sind, und speichern Sie dann den Nachrichtenfluss.
11. Auf der Registerkarte Verbindung des Salesforce Commerce Cloud Digital Data Request zeigt die Eigenschaft Richtlinie den Namen der Richtlinie an, die die Details der Sicherheitsidentität enthält, die für die Verbindung verwendet werden soll. Die Richtlinie hat den Typ Salesforce Commerce Cloud Digital Data.
    Weitere Informationen finden Sie unter Salesforce Commerce Cloud Digital Data policy.
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 Salesforce Commerce Cloud Digital Data wartet.
13. Die Registerkarte Filter des Salesforce Commerce Cloud Digital Data 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 Salesforce Commerce Cloud Digital Data 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 Salesforce Commerce Cloud Digital Data 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 neben dem Wert, den Sie ändern möchten, im Abschnitt Filteroptionen auf Bearbeiten klicken und 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 bei der Ausführung an den Salesforce Commerce Cloud Digital Data Request -Knoten ü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 Salesforce Commerce Cloud Digital Dataerstellt werden sollen. Diese Daten bilden die Anforderung, die vom Salesforce Commerce Cloud Digital Data Request -Knoten an Salesforce Commerce Cloud Digital Datagesendet 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 Salesforce Commerce Cloud Digital Dataerstellten Datensatzes enthält.
16. Standardmäßig werden Anforderungsnachrichten anhand des Anforderungsschemas validiert, das während der Connectorerkennung generiert wurde. Sie können die Anforderungsprüfung inaktivieren oder die Validierungseinstellungen ändern, indem Sie die Validierungseigenschaften des Salesforce Commerce Cloud Digital Data Request -Knotens verwenden.
17. Speichern Sie den Nachrichtenfluss.