Square-Connector in Jitterbit Studio

Zusammenfassung

Der Square-Connector bietet eine Schnittstelle zur Eingabe von benutzerdefinierten Informationen wie Anmeldedaten, um eine authentifizierte Square-Verbindung zu erstellen. Diese Verbindung bildet die Grundlage für die Konfiguration zugehöriger Square-Connector-Aktivitäten, die mit der Verbindung interagieren. Eine bestimmte Square-Verbindung und ihre Aktivitäten werden zusammen als Square-Endpunkt bezeichnet.

Voraussetzungen und unterstützte API-Versionen

Dieser Connector kann mit Cloud-Agenten und privaten Agenten verwendet werden.

Agenten laden automatisch die neueste Version dieses Connectors herunter, wenn erforderlich. Bei privaten Agenten können Sie diese Updates mit der Organisationsrichtlinie Disable Auto Connector Update organization policy aussetzen.

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

Connector-Übersicht

Dieser Connector wird zunächst zur Konfiguration einer Square-Verbindung verwendet, um den Zugriff auf Square herzustellen, und dann zur Konfiguration einer oder mehrerer Square-Aktivitäten, die dieser Verbindung zugeordnet sind, als Quelle oder Ziel innerhalb eines Vorgangs:

• Query Activity: Ruft Kunden aus einer Square-Verbindung ab und wird als Quelle in einem Vorgang verwendet.

• Create Activity: Erstellt neue Kunden in einer Square-Verbindung und wird als Ziel in einem Vorgang verwendet.

• Update Activity: Aktualisiert vorhandene Kunden in einer Square-Verbindung und wird als Ziel in einem Vorgang verwendet.

• Delete Activity: Löscht vorhandene Kunden aus einer Square-Verbindung und wird als Ziel in einem Vorgang verwendet.

Eine bestimmte Square-Verbindung und ihre Aktivitäten werden zusammen als Square-Endpunkt bezeichnet. Nach der Konfiguration einer Verbindung sind die dem Endpunkt zugeordneten Aktivitäten über den Filter Endpoints verfügbar:

Mit diesem Connector erstellte Endpunkte sind in der Endpunkt-Nutzungsberichterstattung enthalten und werden auf Ihre Lizenz angerechnet.

Square-Registrierung

Da die Verbindung eine Anwendung ist, die mit Square interagiert, benötigen Sie ein Personal Access Token, um auf den Square-Server zuzugreifen. Weitere Informationen finden Sie unter Square-Registrierung.

Zugriff auf den Connector

Der Square-Connector wird über die Registerkarte Project endpoints and connectors der Palette der Designkomponenten aufgerufen (siehe Design component palette).

Fehlerbehebung

Falls Sie Probleme mit dem Square-Connector haben, werden diese Schritte zur Fehlerbehebung 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 Agent heruntergeladen wird (sofern nicht die Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren verwendet wird).

2. Überprüfen Sie die Operationsprotokolle auf Informationen, die während der Ausführung der Operation geschrieben wurden.

3. Aktivieren Sie das Debug-Logging für Operationen (für Cloud-Agents oder für private Agents), um zusätzliche Protokolldateien und Daten zu generieren.

4. Wenn Sie private Agents verwenden, können Sie das ausführliche Connector-Logging für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag zur Datei logback.xml Ihres privaten Agents hinzufügen:

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

   Weitere Informationen zum ausführlichen Connector-Logging finden Sie unter Ausführliches Logging für Connectors mit privaten Jitterbit-Agents.

5. Wenn Sie private Agents verwenden, können Sie die Agent-Protokolle auf weitere Informationen überprüfen.

6. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Operationen.