Mirakl-Connector in Jitterbit Studio

Zusammenfassung

Der Mirakl-Connector stellt Zugriff auf Mirakl bereit.

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

Der Mirakl-Connector wird über die Registerkarte Project endpoints and connectors (Projektendpunkte und Connectoren) der Designkomponentenpalette aufgerufen (siehe Design component palette).

Connector-Übersicht

Dieser Connector wird zunächst zum Konfigurieren einer Mirakl-Verbindung verwendet. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann zum Erstellen von Aktivitätsinstanzen verwendet, die als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder Ziele (zum Verarbeiten von Daten in einem Vorgang) dienen sollen.

Zusammen werden eine bestimmte Mirakl-Verbindung und ihre Aktivitäten als Mirakl-Endpunkt bezeichnet:

Mirakl-Aktivitätstypen

Read: Ruft Objektdaten aus Mirakl ab und soll als Quelle in einem Vorgang verwendet werden.
Create: Erstellt Objektdaten in Mirakl und soll als Ziel in einem Vorgang verwendet werden.
Update: Aktualisiert Objektdaten in Mirakl und soll als Ziel in einem Vorgang verwendet werden.
Delete: Löscht Objektdaten aus Mirakl und soll als Ziel in einem Vorgang verwendet werden.

Mit diesem Connector erstellte Endpunkte sind in der Endpunktnutzungsberichterstellung enthalten und werden auf die 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 diese Updates mit der Organisationsrichtlinie Disable Auto Connector Update ausgesetzt werden.

Der Mirakl-Connector verwendet die Mirakl REST API, auf die über eine benutzerdefinierte URL im Format https://marketplace.{environment}.{customerName}.com.br zugegriffen wird. Informationen zu Schemaknoten und Feldern finden Sie in der API-Dokumentation.

Einschränkungen

Mirakl API-Einschränkungen

Der Mirakl-Connector weist diese Probleme aufgrund von Einschränkungen in der Mirakl REST API auf:

Die Mirakl-Aktivität Read kann keine Objektdatensätze abrufen, wenn das Feld paginate im Anforderungsschema auf false gesetzt ist. Um Objektdatensätze erfolgreich abzurufen, muss paginate im Anforderungsschema auf true gesetzt sein.
Die Mirakl-Aktivität Create behält das Feld value für den Knoten shop_additional_fields im Anforderungsschema nicht bei. Wenn value im Anforderungsschema auf false gesetzt ist, gibt die Ausgabe value als auf true gesetzt zurück.

Mirakl-Connector-Einschränkungen

Der Mirakl-Connector unterstützt derzeit die meisten Objekte und API-Operationen in der Mirakl REST API. Mehrere Ausnahmen sind unten aufgeführt. Diese API-Operationen werden über den Harmony HTTP-Connector unterstützt:

Objekt	API-Operation
Business Intelligence	BI01: Business Intelligence abrufen.
Nachrichten	M12: Auf einen Thread antworten. OR43: Eine Nachricht zu einer Bestellung erstellen.
Bestellungen	OR74: Dokumente hochladen, um sie an eine Bestellung anzuhängen.
Produkte	CA01: Marketplace-Kategorien aus dem Betreiber-Informationssystem mit Mirakl synchronisieren. H01: Eine Datei importieren, um die Katalogkategorien des Betreibers zu Mirakl hinzuzufügen. P21: Produkte aus dem Betreiber-Informationssystem mit Mirakl synchronisieren. P41: Produkte in das Betreiber-Informationssystem importieren. P43: Produktintegrations- und Fehlerberichte aus dem Betreiber-Informationssystem hochladen. VL01: Eine Datei senden, um Wertelisten zu erstellen, zu aktualisieren oder zu löschen.
Angebote	Q01: Ein oder mehrere Angebotsanfragen erstellen. Q05: Eine Nachricht zu einer Shop-Angebotsanfrage hinzufügen. S32: Geschäftsdokumente hochladen, um sie einem Shop zuzuordnen.

Fehlerbehebung

Falls Probleme mit dem Mirakl-Connector auftreten, werden folgende Schritte zur Fehlerbehebung empfohlen:

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).
Überprüfen Sie die Operationsprotokolle auf Informationen, die während der Ausführung der Operation geschrieben wurden.
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.
Bei Verwendung von privaten Agents können Sie das ausführliche Connector-Logging für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag zur logback.xml-Datei Ihres privaten Agents hinzufügen:
```
<logger name="org.jitterbit.connector.verbose.logging.mirakl" level="DEBUG"/>
```
Weitere Informationen zum ausführlichen Connector-Logging finden Sie unter Ausführliches Logging für Connectors mit privaten Jitterbit-Agents.
Bei Verwendung von privaten Agents können Sie die Agent-Protokolle auf weitere Informationen überprüfen.
Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Operationen.