Zum Inhalt springen

Verwandeln Sie Ihre Kontakte in Urlaubsgeld mit unserem neuen Kundenempfehlungsprogramm! Erfahren Sie mehr

✕

Mirakl-Konnektor für Jitterbit Integration Studio

Zusammenfassung

Der Mirakl Konnektor stellt den Zugriff auf Mirakl her.

Der Mirakl Konnektor bietet eine Schnittstelle zum Erstellen einer Mirakl-Verbindung, der Grundlage für die Generierung von Mirakl-Aktivitätsinstanzen. Nach der Konfiguration interagieren diese Aktivitäten ü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 einer Operation) oder Ziele (zum Verbrauchen von Daten in einer Operation) verwendet werden sollen.

Zusammen werden eine bestimmte Mirakl-Verbindung und ihre Aktivitäten 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 Konnektor ist ein Konnektor-SDK-basierter Konnektor, auf den Jitterbit bei der Kommunikation von Änderungen an mit dem Connector SDK erstellten Konnektoren verweisen kann.

Voraussetzungen und unterstützte API Versionen

Der Mirakl Konnektor erfordert die Verwendung einer Agentenversion 10.1 oder höher. Diese Agent-Versionen laden bei Bedarf automatisch die neueste Version des Connectors herunter.

Der Mirakl-Konnektor 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 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 das value als eingestellt auf true.

Einschränkungen des Mirakl-Konnektors

Der Mirakl Konnektor unterstützt derzeit die meisten Objekte und API -Operationen der Mirakl REST- API. Einige Ausnahmen sind unten aufgeführt. Diese API Operationen werden über den Harmony HTTP-Konnektor 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, 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
  • Q01: Erstellen Sie eine oder mehrere Angebotsanfragen.
  • Q05: Fügen Sie einer Shop-Angebotsanfrage eine Nachricht hinzu.
  • S32: Laden Sie Geschäftsdokumente hoch, die einem Shop zugeordnet werden sollen.

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 Protokollierung für Operation (für Cloud-Agenten oder für private Vertreter), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Bei Verwendung privater Agenten können Sie die ausführliche Protokollierung des Connectors aktivieren für diesen Connector unter Verwendung des folgenden Konfigurationseintrags für 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 im Betrieb.