Zum Inhalt springen

Square-Connector für Jitterbit Studio

Zusammenfassung

Der Square-Connector bietet eine Schnittstelle zur Eingabe von benutzereingebenen Daten wie Anmeldeinformationen, um eine authentifizierte Square-Verbindung herzustellen. Diese Verbindung bildet die Basis zur Konfiguration der zugehörigen Aktivitäten des Square-Connectors, die mit der Verbindung interagieren. Zusammen werden eine spezifische Square-Verbindung und ihre Aktivitäten als Square-Endpunkt bezeichnet.

Hinweis

Dieser Connector unterstützt das Customers-Objekt in der Square API. Um mit zusätzlichen Objekten wie dem Catalog, Customers, Inventory, Invoices, Orders, Payments, Subscriptions und Terminal-Objekten zu interagieren, verwenden Sie den Square v2-Connector.

Tipp

Integrationsrezepte sind für diesen Connector über den Jitterbit Marketplace verfügbar.

Unterstützte API-Versionen und Voraussetzungen

Der Square-Connector verwendet die Square REST API. Weitere Informationen zu den Schemafeldern finden Sie in der API-Dokumentation.

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

Connector-Übersicht

Dieser Connector wird verwendet, um zunächst eine Square-Verbindung zu konfigurieren, die den Zugriff auf Square herstellt, und dann, um eine oder mehrere Square-Aktivitäten zu konfigurieren, die mit dieser Verbindung als Quelle oder Ziel innerhalb eines Vorgangs verbunden sind:

  • Abfrage-Aktivität: Ruft Kunden von einer Square-Verbindung ab und wird als Quelle in einem Vorgang verwendet.

  • Erstellungs-Aktivität: Erstellt neue Kunden in einer Square-Verbindung und wird als Ziel in einem Vorgang verwendet.

  • Aktualisierungs-Aktivität: Aktualisiert bestehende Kunden in einer Square-Verbindung und wird als Ziel in einem Vorgang verwendet.

  • Lösch-Aktivität: Löscht bestehende Kunden von einer Square-Verbindung und wird als Ziel in einem Vorgang verwendet.

Der Square-Connector verwendet die Square REST API. Konsultieren Sie die API-Dokumentation für Informationen zu den Schemafeldern.

Der Square-Connector erfordert die Verwendung einer Agenten-Version 10.1 oder höher.

Zusammen werden eine spezifische Square-Verbindung und ihre Aktivitäten als Square-Endpunkt bezeichnet. Sobald eine Verbindung konfiguriert ist, sind die mit dem Endpunkt verbundenen Aktivitäten im Filter Endpunkte verfügbar:

Verbindungen-Tab

Hinweis

Dieser Connector ist ein Connector SDK-basierter Connector, auf den Jitterbit möglicherweise verweist, wenn Änderungen an mit dem Connector SDK erstellten Connectors kommuniziert werden.

Endpunkte, die mit diesem Connector erstellt wurden, sind in Bericht über die Nutzung von Endpunkten enthalten und zählen zu Ihrer Lizenz.

Square-Registrierung

Da die Verbindung eine Anwendung ist, die mit Square kommuniziert, benötigen Sie ein Persönliches Zugriffstoken, um auf den Square-Server zuzugreifen. Siehe Square-Registrierung für Details.

Zugriff auf den Connector

Der Square-Connector wird über die Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette aufgerufen (siehe Designkomponentenpalette).

Aktivitäten

Fehlersuche

Wenn Probleme mit dem Square-Connector auftreten, werden die folgenden Schritte zur Fehlersuche empfohlen:

  1. 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 Agenten heruntergeladen wird (es sei denn, die Automatische Connector-Aktualisierung deaktivieren Organisationsrichtlinie wird verwendet).

  2. Überprüfen Sie die Betriebsprotokolle auf Informationen, die während der Ausführung des Vorgangs geschrieben wurden.

  3. Aktivieren Sie das Debug-Protokoll für den Vorgang (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.

  4. 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.square" level="DEBUG"/>

    Weitere Informationen zum ausführlichen Protokollieren des Connectors finden Sie unter Ausführliches Protokollieren für Connectoren, die Jitterbit-private Agenten verwenden.

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

  6. Für zusätzliche Überlegungen zur Fehlersuche siehe Fehlersuche bei Vorgängen.