Zum Inhalt springen

Square Anschluss für Jitterbit Integration Studio

Zusammenfassung

Der Square Connector bietet eine Schnittstelle zur Eingabe benutzerdefinierter Eingaben wie Anmeldeinformationen, um eine authentifizierte Square-Verbindung herzustellen. Diese Verbindung bietet die Grundlage zum Konfigurieren zugehöriger Square Connector-Aktivitäten, die mit der Verbindung interagieren. Eine bestimmte Square Verbindung und ihre Aktivitäten werden zusammen als Square Endpoint bezeichnet.

Hinweis

Dieser Connector unterstützt die Kunden Objekt in der Square API. Zur Interaktion mit zusätzlichen Objekten, wie dem Katalog, Kunden, Inventar, Rechnungen, Bestellungen, Zahlungen, Abonnements und Terminal Objekte, verwenden Sie den Square v2 Connector.

Unterstützte API Versionen und Voraussetzungen

Der Square Konnektor verwendet die Square REST API. Weitere Informationen finden Sie in der API Informationen zu den Schema finden Sie in der Dokumentation.

Der Square Connector erfordert die Verwendung einer Agentenversion 10.1 oder höher. Diese Agentenversionen laden bei Bedarf automatisch die neueste Version des Connectors herunter.

Connector-Übersicht

Dieser Anschluss wird verwendet, um zunächst eine Square-Verbindung zu konfigurieren, die den Zugang zu Square und wird dann verwendet, um eine oder mehrere Square-Aktivitäten zu konfigurieren, die mit diese Verbindung als Quelle oder Ziel innerhalb einer Operation:

  • Abfrageaktivität: Ruft Kunden von einer Square-Verbindung ab und wird verwendet als Quelle in einer Operation.

  • Aktivität erstellen: Erstellt neue Kunden bei einer Square Anbindung und wird verwendet als Ziel einer Operation.

  • Aktivität aktualisieren: Aktualisiert bestehende Kunden bei einer Square-Verbindung und ist als Ziel bei einer Operation verwendet.

  • Aktivität löschen: Löscht bestehende Kunden aus einer Square-Verbindung und ist als Ziel bei einer Operation verwendet.

Der Square Konnektor verwendet die Square REST API. Informationen zu den Schema finden Sie in der API Dokumentation.

Der Square Connector erfordert die Verwendung eines Agenten der Version 10.1 oder später.

Zusammen werden eine bestimmte Square Verbindung und ihre Aktivitäten als Square Endpoint bezeichnet. Sobald Wenn eine Verbindung konfiguriert ist, sind mit dem Endpoint verknüpfte Aktivitäten über den Filter Endpoints verfügbar:

Tab „Verbindungen“

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.

Square Registrierung

Da die Verbindung eine Anwendung ist, die mit Square interagiert, benötigen Sie einen persönlichen Zugriffstoken, um auf den Square-Server zugreifen. Siehe Square Registrierung für Einzelheiten.

Zugriff auf den Connector

Der Square Konnektor wird über die Tab Endpoints und -konnektoren der Designkomponentenpalette aufgerufen (siehe Komponentenpalette).

Aktivitäten

Fehlerbehebung

Wenn Sie Probleme mit dem Square-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.square" 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.