Wie man App Connect mit Salesforce Commerce Cloud Digitale Daten
Salesforce Commerce Cloud Digital Data (ehemals Demandware) bietet Unternehmen eine Cloud-basierte Lösung, um ein einheitliches Online-Einkaufserlebnis für ihre Kunden zu schaffen. Die Plattform ermöglicht es Unternehmen, Kundenbedürfnisse zu antizipieren und wertvolle Erkenntnisse zu gewinnen, so dass Kunden schnell und einfach Produkte durchsuchen und Einkäufe tätigen können.
- Die Shop-API dient der Interaktion auf der Website, z. B. dem Durchsuchen von Produkten und dem Abschluss von Einkäufen.
- Die Daten-API ist für Backend-Systemressourcen wie Ihren Produktbestand und Ihre Kundenlisten gedacht.
- Die Meta-API enthält Einzelheiten zu den Ressourcen und Dokumenten, die von der offenen Commerce-API bereitgestellt werden, einschließlich benutzerdefinierter Attribute.
App Connect unterstützt derzeit die Daten-API mit der Anwendung Salesforce Commerce Cloud Digital Data.
Die folgenden Informationen beschreiben, wie Sie mit App Connect um Salesforce Commerce Cloud Digital Data mit Ihren anderen Anwendungen zu verbinden.
Unterstützte Produkt- und API-Versionen
Um herauszufinden, welche Produkt- und API-Versionen dieser Konnektor unterstützt, siehe Detaillierte Systemanforderungen auf der Seite IBM Support.
Verbindung zu Salesforce Commerce Cloud Digital Data
Zum Verbinden App Connect mit einem Salesforce Commerce Cloud Digital Data-Konto zu verbinden, benötigen Sie die folgenden Verbindungsdetails:
- Basis-URL
- API-Version
- Client-ID
- Geheimer Clientschlüssel
Die Werte, die Sie für diese Einstellungen eingeben müssen, finden Sie in der folgenden Tabelle.
| Ihren Namen | Informationen |
|---|---|
| Basis-URL | Die Basis URL (oder Protokoll und Hostname) Ihrer Salesforce Commerce Cloud Digital Data-Instanz. Wenn zum Beispiel die URL Ihrer Instanz https://mysite.demandware.net/on/demandware.store/Sites-Site/default/ViewApplication-DisplayWelcomePage ist, geben Sie die Basis URL als https://mysite.demandware.net an. Dieser Wert wird normalerweise auch als Business Manager-Hostname in der Benutzeroberfläche von Salesforce Commerce Cloud Digital Data unter angezeigt. |
| API-Version | Die API-Version Ihrer Salesforce B2C Commerce-Instanz. App Connect unterstützt die Versionen 18.3 und 21.3. Standardmäßig ist die Version 21.3 ausgewählt. Wenn Sie sich nicht sicher sind, wie Sie Ihre API-Version erhalten, fragen Sie Ihren Salesforce Commerce Cloud Digital Data Administrator oder führen Sie die folgenden Schritte aus.
|
| Client-ID |
Alternativ können Sie sich auch bei Ihrem Salesforce Commerce Cloud Digital Data Business Manager-Konto ( Tipp: Wenn Sie eine Sandbox- oder Testumgebung verwenden, können Sie einen Demo-Wert für die Client-ID von
aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa verwenden. |
| Geheimer Clientschlüssel | Wenn Sie eine Client-ID haben, müssen Sie ein Zugriffstoken vom digitalen Autorisierungsserver anfordern. Wenn die Anfrage erfolgreich ist, gibt der digitale Autorisierungsserver ein Zugriffstoken zurück. Wenden Sie sich an Ihren Salesforce Commerce Cloud Digital Data-Kontoverwalter, um ein Client-Geheimnis für den OCAPI-Client zu erhalten. Tipp: Wenn Sie eine Sandbox- oder Testumgebung verwenden, können Sie einen Demo-Wert für das Client-Geheimnis von
aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa verwenden. |
Um zum ersten Mal eine Verbindung zu einem Salesforce Commerce Cloud Digitale Daten Endpunkt von App Connect Designer seite (früher die Seite Katalog ) aus herzustellen, erweitern Sie Salesforce Commerce Cloud Digitale Daten und klicken Sie dann auf Verbinden Sie. Weitere Informationen finden Sie unter Verwalten von Konten.
Bevor Sie das Konto, das in App Connect erstellte Konto in einer Bewegung verwenden, benennen Sie es in einen aussagekräftigen Namen um, der Ihnen hilft, es zu identifizieren. Um das Konto auf der Seite Anwendungen und APIs umzubenennen, wählen Sie das Konto aus, öffnen das Optionsmenü (⋮) und klicken auf Konto umbenennen.
Was ist zuerst zu beachten?
Bevor Sie App Connect mit Salesforce Commerce Cloud Digital Data verwenden, beachten Sie bitte die folgenden Punkte.
- (Allgemeine Überlegungen) Eine Liste der verfügbaren Trigger-Ereignisse und Aktionen finden Sie auf der Seite Anwendungen und APIs des App Connect Designers.
Bei einigen Anwendungen hängen die Ereignisse und Aktionen von der Umgebung ab und davon, ob der Konnektor konfigurierbare Ereignisse und eine dynamische Ermittlung von Aktionen unterstützt. Wenn die Anwendung konfigurierbare Ereignisse unterstützt, wird ein Link Weitere konfigurierbare Ereignisse anzeigen unter der Ereignisliste angezeigt. Wenn die Anwendung die dynamische Erkennung von Aktionen unterstützt, sehen Sie unter der Liste der Aktionen einen Link Mehr anzeigen.
- (Allgemeine Überlegung) Wenn Sie mehrere Konten für eine Anwendung verwenden, kann die Menge der Felder, die angezeigt wird, wenn Sie eine Aktion für diese Anwendung auswählen, für verschiedene Konten unterschiedlich sein. Im Ablaufeditor stellen einige Anwendungen immer einen kuratierten Satz von statischen Feldern für eine Aktion bereit. Andere Anwendungen verwenden die dynamische Suche, um die Felder abzurufen, die auf der Instanz, mit der Sie verbunden sind, konfiguriert sind. Wenn Sie zum Beispiel zwei Konten für zwei Instanzen einer Anwendung haben, kann das erste Konto Einstellungen verwenden, die sofort verwendet werden können. Das zweite Konto kann jedoch mit zusätzlichen benutzerdefinierten Feldern konfiguriert sein.
Ereignisse und Aktionen
Salesforce Commerce Cloud Digitale Datenveranstaltungen
Diese Ereignisse beziehen sich auf Änderungen in dieser Anwendung, die einen Ablauf auslösen, um die Aktionen im Ablauf zu vollenden.
Mehr konfigurierbare Ereignisse anzeigen : Die Ereignisse, die standardmäßig angezeigt werden, sind durch optimierte Konnektivität vorkonfiguriert. Weitere Elemente sind verfügbar, nachdem Sie Ereignisse konfiguriert haben, die einen Fluss auslösen können, indem sie diese Anwendung nach neuen oder aktualisierten Objekten abfragen.
Salesforce Commerce Cloud Digitale Datenaktionen
Ihr Arbeitsablauf vervollständigt diese Aktionen in dieser Anwendung.
| Objekt | Aktion | Beschreibung |
|---|---|---|
| Adressen | Adresse erstellen | Erstellt eine neue Kundenadresse mit den angegebenen Adressdaten |
| Adresse löschen | Löscht eine Kundenadresse | |
| Adressen abrufen | Ruft die Adresse eines Kunden ab | |
| Adresse aktualisieren | Aktualisiert die Adresse eines Kunden mit den angegebenen Adressinformationen | |
| Adresse aktualisieren oder erstellen | Aktualisiert oder erstellt die Adresse | |
| Kampagnen | Kampagne erstellen | Erstellt eine Kampagne unter Verwendung der bereitgestellten Informationen |
| Kampagne löschen | Löscht die Kampagne anhand der ID | |
| Kampagnen abrufen | Ruft die Kampagneninformationen ab | |
| Aktualisierung der Kampagne | Aktualisiert die Kampagne mit den angegebenen Informationen | |
| Kampagne aktualisieren oder erstellen | Kampagne aktualisieren oder erstellen | |
| Kataloge | Kataloge abrufen | Ruft die Kataloge ab |
| Katalog aktualisieren | Aktualisiert den Katalog anhand der bereitgestellten Informationen | |
| Kategorien | Kategorie erstellen | Erstellt anhand der bereitgestellten Informationen eine Katalogkategorie. |
| Kategorie löschen | Löscht die Kategorie anhand der Katalog-ID und der Kategorie-ID | |
| Kategorien abrufen | ||
| Kategorie aktualisieren | Aktualisiert eine Katalogkategorie anhand der bereitgestellten Informationen | |
| Kategorien aktualisieren oder erstellen | Kategorien aktualisieren oder erstellen | |
| Kunden | Kunde erstellen | Erstellt einen neuen Kunden. Der Kunde wird unter Verwendung der angegebenen Kundennummer, Anmeldedaten und Kundeninformationen angelegt. Diese Aktion überprüft die Anmeldeakzeptanzkriterien sowie die Eindeutigkeit und obligatorischen Kundeneigenschaften. Wenn die Aktion den Kunden nicht erstellen kann, gibt sie einen 400-Fehlercode mit einer entsprechenden Meldung zurück. |
| Kunden löschen | Löscht den Kunden und die zugehörigen Informationen wie Kundenadressen | |
| Kunden abrufen | Ruft die Kundeninformationen ab | |
| Kunden aktualisieren | Informiert den Kunden über die angegebenen Informationen. Die Kundennummer kann aktualisiert werden, führt jedoch zu einem Fehler „ CustomerNumberAlreadyInUseException “, wenn bereits ein anderer Kunde mit derselben Kundennummer vorhanden ist. | |
| Kunden aktualisieren oder anlegen | Aktualisiert oder erstellt die Kunden | |
| Bestandslisten | Inventarliste erstellen | Erstellt anhand der bereitgestellten Informationen eine Bestandsliste |
| Bestandsliste löschen | Löscht die Inventarliste anhand der ID | |
| Bestandslisten abrufen | Ruft die Informationen zur Bestandsliste ab | |
| Bestandsliste aktualisieren | Aktualisiert die Bestandsliste mit den angegebenen Informationen | |
| Bestandsliste aktualisieren oder erstellen | Aktualisiert oder erstellt Inventarliste | |
| Produktbestandsaufzeichnungen | Produktbestandsdatensatz erstellen | Erstellt anhand der bereitgestellten Informationen einen Produktbestandssatz |
| Produktbestandsdatensatz löschen | Löscht einen Produktbestandseintrag anhand der ID | |
| Produktbestandsdaten abrufen | Ruft einen Produktbestandssatz ab | |
| Produktbestandsdaten aktualisieren | Aktualisiert den Produktbestand mit den angegebenen Informationen | |
| Produktbestandsdatensatz aktualisieren oder erstellen | Aktualisiert oder erstellt Produktbestandsdatensatz | |
| Produkte | Produkt erstellen | Erstellt ein Produkt anhand der bereitgestellten Informationen. Wenn ein Produkt mit derselben eindeutigen Kennung vorhanden ist, wird es bereinigt und überschrieben, es sei denn, der Header x-dw-validate-existing=true wird mit der Anfrage übergeben. |
| Produkt löschen | Löscht das Produkt anhand der ID | |
| Produkte abrufen | Ruft die Produktinformationen ab | |
| Produkt aktualisieren | Aktualisiert ein Produkt anhand der bereitgestellten Informationen. Die Felder, die aktualisiert werden können, sind Name, Seitenbeschreibung, lange Beschreibung, Seitentitel, Seiten-Keywords, Marke, EAN, UPC, Hersteller-SKU, Herstellername, durchsuchbar, Einheit, durchsuchbar, Online-Flag und Standard-Varianten-ID. | |
| Produkt aktualisieren oder erstellen | Produkt aktualisiert oder erstellt | |
| Gutscheine für die Website | Gutschein für Website erstellen | Erstellt einen Gutschein anhand der angegebenen Informationen. Wenn ein Gutschein mit derselben eindeutigen Kennung existiert, wird der Gutschein vollständig ersetzt. |
| Gutschein für Website löschen | Löscht einen Gutschein anhand seiner ID | |
| Websites nach Gutscheinen durchsuchen | Ruft die Coupon-Informationen ab. Die folgenden Felder werden im Coupon-Dokument zurückgegeben, wenn die Statistik-Erweiterung angegeben wird, z. B. exported_code_count, redemption_count, total_codes_count. | |
| Website-Gutschein aktualisieren | Aktualisiert den Gutschein mit den angegebenen Informationen | |
| Website-Gutschein aktualisieren oder erstellen | Aktualisiert oder erstellt Websites-Gutscheine | |
| Standortwerbung | Website-Werbung erstellen | Erstellt eine Werbeaktion anhand der bereitgestellten Informationen |
| Website-Werbung löschen | Löscht die Aktion anhand der ID | |
| Website-Werbeaktionen abrufen | Maßnahmen zum Erhalt von Werbeinformationen | |
| Website-Promotion aktualisieren | Aktualisiert die Werbeaktion mit den angegebenen Informationen | |
| Website-Werbung aktualisieren oder erstellen | Aktualisiert oder erstellt Website-Werbung | |
| Standorte | Websites abrufen | Ruft eine vorhandene Website ab |
| Läden | Geschäft erstellen | Erstellt einen Shop anhand der bereitgestellten Informationen |
| Laden löschen | Löscht den Speicher anhand der ID | |
| Geschäfte abrufen | Ruft die Shop-Informationen ab | |
| Shop aktualisieren | Aktualisiert den Shop mit den angegebenen Informationen | |
| Geschäft aktualisieren oder erstellen | Aktualisiert oder erstellt Speicher |