Zum Inhalt springen

Mirakl Konnektor für Jitterbit Integration Studio

Zusammenfassung

Der Mirakl Konnektor ermöglicht den Zugriff auf Mirakl.

Der Mirakl-Connector bietet eine Schnittstelle zum Erstellen einer Mirakl-Verbindung, der Grundlage für die Generierung von Instanzen von Mirakl-Aktivitäten. Sobald diese Aktivitäten konfiguriert sind, interagieren sie über die Verbindung mit Mirakl.

Der Zugriff auf den Mirakl Konnektor erfolgt über die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).

Connector-Übersicht

Dieser Connector wird verwendet, um zunächst eine Mirakl-Verbindung zu konfigurieren. Mit dieser Verbindung verknüpfte Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (zum Bereitstellen von Daten in einem Operation) oder Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden sollen.

Eine bestimmte Mirakl-Verbindung und ihre Aktivitäten werden zusammen als Mirakl Endpoint bezeichnet:

Mirakl Aktivitätstypen

  • Lesen: Ruft Objektdaten von Mirakl ab und ist zur Verwendung als Quelle in einer Operation vorgesehen.

  • Erstellen: Erstellt Objektdaten in Mirakl und ist zur Verwendung als Ziel in einer Operation vorgesehen.

  • Aktualisieren: Aktualisiert Objektdaten in Mirakl und ist zur Verwendung als Ziel in einer Operation vorgesehen.

  • Löschen: Löscht Objektdaten aus Mirakl und ist zur Verwendung als Ziel in einer Operation vorgesehen.

Hinweis

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

Voraussetzungen und unterstützte API Versionen

Der Mirakl-Connector erfordert die Verwendung eines Agenten der Version 10.1 oder höher. Diese Agentversionen laden bei Bedarf automatisch die neueste Version des Connectors herunter.

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

Einschränkungen

Einschränkungen der Mirakl API

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

  • Das Mirakl Lesen-Aktivität kann keine Objektdatensätze abrufen, wenn die paginate ist eingestellt auf false im Schema. Um Objektdatensätze erfolgreich abzurufen, paginate muss eingestellt werden auf true im Schema.

  • Das Mirakl Erstellen Aktivität behält nicht die value Feld für die shop_additional_fields Knoten in seinem Schema. Wenn value ist eingestellt auf false im Schema gibt die Ausgabe die value als eingestellt auf true.

Einschränkungen des Mirakl Konnektors

Der Mirakl-Connector unterstützt derzeit die meisten Objekte und API Operationen in der Mirakl REST- API. Einige Ausnahmen sind unten aufgeführt. Diese API Operationen werden durch 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: Laden Sie Dokumente hoch, die einer Bestellung beigefügt werden sollen.
Produkte
  • CA01: Marketplace aus dem Betreiberinformationssystem mit Mirakl synchronisieren.
  • H01: Eine Datei importieren, um die Katalogkategorien des Betreibers zu Mirakl hinzuzufügen.
  • P21: Produkte aus dem Betreiberinformationssystem mit Mirakl synchronisieren.
  • P41: Produkte in das Betreiberinformationssystem importieren.
  • P43: Produktintegrations- und Fehlerberichte aus dem Betreiberinformationssystem hochladen.
  • VL01: Eine Datei senden, um Wertelisten zu erstellen, zu aktualisieren oder zu löschen.
Angebote
  • F01: Erstellen Sie eine oder mehrere Angebotsanfragen.
  • F05: Fügen Sie einer Shop-Angebotsanfrage eine Nachricht hinzu.
  • S32: Laden Sie Geschäftsdokumente hoch, um sie einem Shop zuzuordnen.

Fehlerbehebung

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

  1. Klicken Sie in der Verbindungskonfiguration auf die Schaltfläche Test, 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 Automatische Connector-Aktualisierung deaktivieren).

  2. Überprüfen Sie die Operation für alle Informationen, die während der Ausführung der Operation geschrieben werden.

  3. Aktivieren Sie die debuggen für Operation (für Cloud-Agenten oder für private Vertreter), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Wenn Sie private Agenten verwenden, können Sie Connector Verbose Logging aktivieren für diesen Connector unter Verwendung dieses spezifischen Konfigurationseintrags mit Loggername und -ebene:

    <logger name="org.jitterbit.connector.verbose.logging.mirakl" level="DEBUG"/>

  5. Wenn Sie private Agenten verwenden, können Sie die Agentenprotokolle überprüfen für weitere Informationen.

  6. Weitere Hinweise zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Vorgängen.