Zum Inhalt springen

Salesforce Commerce Cloud-Connector in Jitterbit Studio

Zusammenfassung

Der Salesforce Commerce Cloud-Connector stellt Zugriff auf Salesforce Commerce Cloud her.

Der Salesforce Commerce Cloud-Connector bietet eine Schnittstelle zum Erstellen einer Salesforce Commerce Cloud-Verbindung, die Grundlage für die Generierung von Instanzen von Salesforce Commerce Cloud-Aktivitäten. Diese Aktivitäten interagieren nach der Konfiguration mit Salesforce Commerce Cloud über die Verbindung.

Man greift auf den Salesforce Commerce Cloud-Connector über die Registerkarte Project endpoints and connectors (Projekt-Endpunkte und Connectoren) der Palette der Design-Komponenten zu (siehe Design component palette).

Connector-Übersicht

Mit diesem Connector wird zunächst eine Salesforce Commerce Cloud-Verbindung konfiguriert. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (zur Bereitstellung von Daten in einem Vorgang) oder Ziele (zur Verarbeitung von Daten in einem Vorgang) verwendet werden sollen.

Zusammen werden eine bestimmte Salesforce Commerce Cloud-Verbindung und ihre Aktivitäten als Salesforce Commerce Cloud-Endpunkt bezeichnet:

Salesforce Commerce Cloud-Aktivitätstypen

  • Search: Ruft basierend auf einer angegebenen benutzerdefinierten Abfrage einen begrenzten Satz von Customer-, Pricing- oder Product-Objektdaten aus Salesforce Commerce Cloud ab und ist für die Verwendung als Quelle in einem Vorgang vorgesehen.

  • Read: Ruft basierend auf einem angegebenen Kriteriensatz alle Checkout-, Customer- oder Product-Objektdaten aus Salesforce Commerce Cloud ab und ist für die Verwendung als Quelle in einem Vorgang vorgesehen.

  • Get: Ruft basierend auf angegebenen IDs alle Checkout-, Customer-, Pricing- oder Product-Objektdaten aus Salesforce Commerce Cloud ab und ist für die Verwendung als Quelle in einem Vorgang vorgesehen.

  • Create: Erstellt Customer-, Pricing- oder Product-Objektdaten in Salesforce Commerce Cloud und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

  • Update: Aktualisiert Customer-, Pricing- oder Product-Objektdaten in Salesforce Commerce Cloud und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

  • Delete: Löscht oder bricht Customer-, Pricing- oder Product-Objektdaten in Salesforce Commerce Cloud ab und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

Mit diesem Connector erstellte Endpunkte sind in der Endpunkt-Nutzungsberichterstellung enthalten und werden auf Ihre Lizenz angerechnet.

Voraussetzungen und unterstützte API-Versionen

Dieser Connector kann mit Cloud-Agenten und privaten Agenten verwendet werden.

Agenten laden automatisch die neueste Version dieses Connectors herunter, wenn erforderlich. Bei privaten Agenten können Sie diese Updates mit der Organisationsrichtlinie Disable Auto Connector Update aussetzen.

Der Salesforce Commerce Cloud-Connector verwendet die B2C Commerce API. Um damit zu interagieren, müssen Sie einen API-Client für entweder Admin APIs oder Shopper APIs erstellen, je nach Ihren Anforderungen. Informationen zu den Schemaknoten und Feldern finden Sie in der API-Dokumentation.

Der erforderliche Autorisierungsumfang ist mindestens sfcc.products.rw.

Einschränkungen

Dieser Connector unterstützt die Standard-Objekte, die von den B2C Commerce Shopper APIs und Admin APIs bereitgestellt werden. Benutzerdefinierte APIs werden nicht unterstützt.

Fehlerbehebung

Falls Probleme mit dem Salesforce Commerce Cloud Connector auftreten, werden folgende Schritte zur Fehlerbehebung empfohlen:

  1. Klicken Sie auf die Schaltfläche Test in der Verbindungskonfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agent heruntergeladen wird (sofern nicht die Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren verwendet wird). Falls der Test fehlschlägt, stellen Sie sicher, dass Ihre Anmeldedaten einen Autorisierungsumfang von mindestens sfcc.products.rw haben.

  2. Überprüfen Sie die Operationsprotokolle auf Informationen, die während der Ausführung der Operation geschrieben wurden.

  3. Aktivieren Sie das Debug-Logging für Operationen (für Cloud-Agents oder für private Agents), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Bei Verwendung von privaten Agents können Sie das ausführliche Logging für Connectors für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agents einfügen:

    <logger name="org.jitterbit.connector.commercecloud" level="DEBUG"/>

    Weitere Informationen zum ausführlichen Logging für Connectors finden Sie unter Ausführliches Logging für Connectors mit privaten Jitterbit-Agents.

  5. Bei Verwendung von privaten Agents können Sie die Agent-Protokolle auf weitere Informationen überprüfen.

  6. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Operationen.