Mirakl-Connector für Jitterbit Studio

Zusammenfassung

Der Mirakl-Connector stellt den Zugriff auf Mirakl her.

Der Mirakl-Connector bietet eine Schnittstelle zur Erstellung einer Mirakl-Verbindung, die als Grundlage für die Generierung von Instanzen von Mirakl-Aktivitäten dient. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit Mirakl.

Der Mirakl-Connector wird über die Registerkarte Projektendpunkte und -connectoren in der Designkomponenten-Palette aufgerufen (siehe Designkomponenten-Palette).

Übersicht über den Connector

Dieser Connector wird zunächst verwendet, um eine Mirakl-Verbindung zu konfigurieren. Die mit dieser Verbindung verbundenen Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (um Daten in einem Vorgang bereitzustellen) oder Ziele (um Daten in einem Vorgang zu konsumieren) gedacht sind.

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

Mirakl-Aktivitätstypen

Lesen: Ruft Objektdaten von Mirakl ab und ist als Quelle in einem Vorgang gedacht.
Erstellen: Erstellt Objektdaten in Mirakl und ist als Ziel in einem Vorgang gedacht.
Aktualisieren: Aktualisiert Objektdaten in Mirakl und ist als Ziel in einem Vorgang gedacht.
Löschen: Löscht Objektdaten von Mirakl und ist als Ziel in einem Vorgang gedacht.

Hinweis

Dieser Connector ist ein Connector SDK-basierter Connector, auf den Jitterbit verweisen kann, wenn Änderungen an mit dem Connector SDK erstellten Connectors kommuniziert werden.

Endpunkte, die mit diesem Connector erstellt wurden, sind in Endpunktnutzungsberichten enthalten und zählen zu Ihrer Lizenz.

Voraussetzungen und unterstützte API-Versionen

Der Mirakl-Connector erfordert die Verwendung einer Agentenversion 10.1 oder höher. Diese Agentenversionen laden automatisch die neueste Version des Connectors herunter, wenn dies erforderlich ist.

Der Mirakl-Connector verwendet die Mirakl REST API, die über die benutzerdefinierte URL Ihrer Instanz im Format https://marketplace.{environment}.{customerName}.com.br zugänglich ist. Weitere Informationen zu den Schema-Knoten und -Feldern finden Sie in der API-Dokumentation.

Einschränkungen

Einschränkungen der Mirakl API

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

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

Einschränkungen des Mirakl-Connectors

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: Geschäftsinformationen abrufen.
Nachrichten	M12: Auf einen Thread antworten. OR43: Eine Nachricht zu einer Bestellung erstellen.
Bestellungen	OR74: Dokumente hochladen, die an eine Bestellung angehängt werden sollen.
Produkte	CA01: Marktplatzkategorien aus dem Informationssystem des Betreibers mit Mirakl synchronisieren. H01: Eine Datei importieren, um die Katalogkategorien des Betreibers zu Mirakl hinzuzufügen. P21: Produkte aus dem Informationssystem des Betreibers mit Mirakl synchronisieren. P41: Produkte in das Informationssystem des Betreibers importieren. P43: Produktintegrations- und Fehlerberichte aus dem Informationssystem des Betreibers hochladen. VL01: Eine Datei senden, um Wertelisten zu erstellen, zu aktualisieren oder zu löschen.
Angebote	Q01: Eine oder mehrere Angebotsanfragen erstellen. Q05: Eine Nachricht zu einer Angebotsanfrage des Shops hinzufügen. S32: Geschäftsdokumente hochladen, die mit einem Shop verknüpft werden sollen.

Fehlerbehebung

Wenn Sie Probleme mit dem Mirakl-Connector haben, werden die folgenden Schritte zur Fehlerbehebung empfohlen:

Klicken Sie auf die Test-Schaltfläche in der Verbindungs-Konfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agenten heruntergeladen wird (es sei denn, Sie verwenden die Organisationsrichtlinie Auto Connector Update deaktivieren).
Überprüfen Sie die Betriebsprotokolle auf Informationen, die während der Ausführung des Vorgangs geschrieben wurden.
Aktivieren Sie das Debug-Protokoll für den Betrieb (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.
Wenn Sie private Agenten verwenden, können Sie das ausführliche Protokollieren des Connectors für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agenten hinzufügen:
```
<logger name="org.jitterbit.connector.verbose.logging.mirakl" level="DEBUG"/>
```
Weitere Informationen zum ausführlichen Protokollieren des Connectors finden Sie unter Ausführliches Protokollieren für Connectoren, die Jitterbit private Agenten verwenden.
Wenn Sie private Agenten verwenden, können Sie die Agentenprotokolle auf weitere Informationen überprüfen.
Für zusätzliche Überlegungen zur Fehlerbehebung siehe Fehlerbehebung bei Operationen.