Amazon Marketplace v2 Verbindung

Einführung

Eine Amazon Marketplace-Verbindung, die mit dem Amazon Marketplace v2 Connector erstellt wurde, ermöglicht den Zugriff auf Amazon Marketplace. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit dem Amazon Marketplace.

Erstellen oder Bearbeiten einer Amazon Marketplace-Verbindung

Eine neue Amazon Marketplace v2 Verbindung wird mit dem Amazon Marketplace v2 Connector von einem dieser Standorte erstellt:

• Der Projektendpunkte und -connectoren-Registerkarte der Designkomponentenpalette (siehe Designkomponentenpalette).
• Der Global Endpoints-Seite (siehe Erstellen eines globalen Endpunkts in Global Endpoints).

Eine bestehende Amazon Marketplace v2 Verbindung kann von diesen Standorten bearbeitet werden:

• Der Projektendpunkte und -connectoren-Registerkarte der Designkomponentenpalette (siehe Designkomponentenpalette).
• Der Komponenten-Registerkarte im Projektbereich (siehe Aktionenmenü für Komponenten in Projektbereich Komponenten-Registerkarte).
• Der Global Endpoints-Seite (siehe Bearbeiten eines globalen Endpunkts in Global Endpoints).

Konfigurieren einer Amazon Marketplace-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Amazon Marketplace v2 Verbindung wird im Folgenden beschrieben.

• Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Amazon Marketplace v2-Verbindung eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten. Dieser Name wird auch verwendet, um den Amazon Marketplace v2-Endpunkt zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf deren Aktivitäten bezieht.

• Schema: Wählen Sie das Schema aus, eines von:

  • SellerCentral

  • VendorCentral

• Marktplatz: Wählen Sie die Marktplatzregion aus.

• OAuth initiieren: Wählen Sie die OAuth-Einstellung aus, eine von:

  • AUS

    • OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.

  • AKTUALISIEREN

    • OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.

  • HOLENUNDAKTUALISIEREN

• OAuth-Client-ID: Geben Sie die OAuth-Client-ID ein.

• OAuth-Client-Geheimnis: Geben Sie das OAuth-Client-Geheimnis ein.

• OAuth-Aktualisierungstoken: Geben Sie das OAuth-Aktualisierungstoken ein.

• Verkäufer-ID: Geben Sie die Verkäufer-ID ein.

• Berichte einbeziehen: Wenn ausgewählt, wird angegeben, dass Berichte einbezogen werden sollen.

• Proxy-Einstellungen verwenden: Wählen Sie aus, um die Proxy-Einstellungen für private Agenten zu verwenden.

• Erweiterte Konfigurationen: Wenn ausgewählt, wird die Tabelle Eigenschaften der erweiterten Konfigurationen angezeigt, die verwendet wird, um zusätzliche Konfigurationseigenschaften als Schlüssel-Wert-Paare hinzuzufügen.

  • Hinzufügen: Fügt eine Zeile zur Tabelle hinzu. Geben Sie ein Schlüssel-Wert-Paar für jede Eigenschaft ein.
  • Einreichen: Speichert das Schlüssel-Wert-Paar in der Tabelle. Sichtbar, wenn Sie mit der Maus über eine Zeile im Bearbeitungsmodus fahren.
  • Verwerfen: Verwirft eine neue Zeile oder alle Änderungen an einer vorhandenen Zeile. Sichtbar, wenn Sie mit der Maus über eine Zeile im Bearbeitungsmodus fahren.
  • Bearbeiten: Ermöglicht das Bearbeiten eines vorhandenen Schlüssel-Wert-Paares. Sichtbar, wenn Sie mit der Maus über eine vorhandene Zeile fahren.
  • Löschen: Löscht die Zeile aus der Tabelle. Sichtbar, wenn Sie mit der Maus über eine vorhandene Zeile fahren.
  • Alle löschen: Löscht alle Zeilen aus der Tabelle.

  Hinweis

  Die Spalten- und Tabellennamen von Amazon Marketplace v2 können Sonderzeichen enthalten, die von anderen Diensten nicht unterstützt werden. Fügen Sie die Konfigurationseigenschaft UseSimpleNames hinzu und setzen Sie sie auf true, um ein Benennungsschema durchzusetzen, das auf alphanumerischen Zeichen und Unterstrichen für Spalten und Tabellen beschränkt ist. Nicht-alphanumerische Zeichen werden bei Aktivierung in Unterstriche umgewandelt.

  Wichtig

  Felder in der Tabelle Erweiterte Konfigurationseigenschaften zeigen das Variablen-Symbol nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit befüllt werden, muss die Agenten-Version mindestens 10.75 / 11.13 sein.

  Felder in der Tabelle Erweiterte Konfigurationseigenschaften unterstützen nicht die Verwendung von Variablen, um rohes JSON zu übergeben. Wenn Ihr Anwendungsfall nicht unterstützt, rohes JSON direkt in den Feldern zu definieren, entkommen Sie den JSON-Inhalt, bevor Sie ihn mit einer Variablen übergeben. Zum Beispiel wird das Entkommen von {"success": "true"}; zu {\"success\": \"true\"};.

• Test: Klicken Sie, um die Verbindung mit der angegebenen Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Organisationsrichtlinie Auto Connector Update deaktivieren.

• Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

• Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.

• Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung löschen möchten.

OAuth-Verbindungen konfigurieren

Dieser Connector unterstützt eine Verbindung über OAuth, indem spezifische Konfigurationseigenschaften verwendet werden. Nachdem Sie ein Authentifizierungsschema ausgewählt haben, das OAuth initiieren umfasst, können Sie die Konfiguration in den angezeigten Feldern angeben.

Für diesen Connector werden zwei Szenarien unterstützt. In beiden Szenarien müssen Sie ein Drittanbieter-Tool (wie Postman oder ein ähnliches Tool) verwenden, um das erforderliche Zugriffstoken oder die Tokens vom beteiligten Endpunkt zu erhalten. Beide Szenarien funktionieren nur für Gruppen mit einem einzelnen Agenten. Dies sind Agentengruppen, die aus einem einzelnen Agenten bestehen.

• Szenario 1: Verwendung eines OAuth-Zugriffstokens, das nach einer festgelegten Zeitspanne abläuft.

  Mit dieser Konfiguration geben Sie ein OAuth-Zugriffstoken an, das für einen festgelegten Zeitraum gültig ist, wie vom jeweiligen Endpunkt bestimmt. Der Connector verwendet das Token, um die Verbindung herzustellen. Die Verbindung funktioniert jedoch nicht mehr, sobald das Zugriffstoken abläuft. Sie würden den Connector so konfigurieren, dass er das Token verwendet, indem Sie diese Eigenschaften festlegen:

  Konfigurationseigenschaft	Wert
  OAuth initiieren	OFF
  OAuth-Zugriffstoken	Auf den Wert des vom Endpunkt erhaltenen OAuth-Zugriffstokens setzen

• Szenario 2: Verwendung eines OAuth-Zugriffstokens in Kombination mit einem OAuth-Refresh-Token, um eine automatische Aktualisierung des Zugriffs zu ermöglichen.

  Mit dieser Konfiguration verwendet der Connector ein Refresh-Token, um ein neues Zugriffstoken zu erhalten, sobald das aktuelle Zugriffstoken abgelaufen ist. Dies ist im Allgemeinen die beste Methode zur Konfiguration von OAuth.

  Sie geben ein OAuth-Zugriffstoken und ein OAuth-Aktualisierungstoken an, wie es der jeweilige Endpunkt bestimmt. Sie konfigurieren den Connector, um diese Tokens zu verwenden, indem Sie diese Eigenschaften festlegen:

  Konfigurationseigenschaft	Wert
  OAuth initiieren	REFRESH
  OAuth-Zugriffstoken	Auf den Wert des vom Endpunkt erhaltenen OAuth-Zugriffstokens setzen
  OAuth-Aktualisierungstoken	Auf den Wert des vom Endpunkt erhaltenen OAuth-Aktualisierungstokens setzen

Nächste Schritte

Nachdem eine Verbindung zum Amazon Marketplace-Connector erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfskanvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Designkomponentenpalette zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

• Abfrage: Ruft Datensätze aus einer Tabelle im Amazon Marketplace ab und ist als Quelle in einem Vorgang gedacht.

• Erstellen: Fügt einen Datensatz in eine Tabelle im Amazon Marketplace ein und ist als Ziel in einem Vorgang gedacht.

• Aktualisieren: Aktualisiert einen Datensatz in einer Tabelle bei Amazon Marketplace und ist als Ziel in einer Operation vorgesehen.

• Löschen: Löscht einen Datensatz aus einer Tabelle bei Amazon Marketplace und ist als Ziel in einer Operation vorgesehen.

• Ausführen: Führt ein Verfahren bei Amazon Marketplace aus und ist als Ziel in einer Operation vorgesehen.