Zum Inhalt springen

Microsoft Excel v2-Connector in Jitterbit Studio

Zusammenfassung

Der Microsoft Excel v2-Connector stellt Zugriff auf Microsoft Excel her.

Der Microsoft Excel v2-Connector bietet eine Schnittstelle zum Erstellen einer Microsoft Excel v2-Verbindung, die Grundlage für die Generierung von Instanzen von Microsoft Excel v2-Aktivitäten. Diese Aktivitäten interagieren nach der Konfiguration mit Microsoft Excel über die Verbindung.

Man greift auf den Microsoft Excel v2-Connector über die Registerkarte Projektendpunkte und Connectors der Designkomponentenpalette zu (siehe Designkomponentenpalette).

WARNUNG: Während der Connector über seine Query-Aktivität Daten aus Excel-Dateien abrufen kann, die auf verschiedenen Cloud-Datenspeichern gehostet werden, werden die Aktivitäten Create, Update und Delete in diesem Connector nur für lokale Dateien unterstützt. Weitere Informationen finden Sie unter Verbindung herstellen.

Bekanntes Problem

Die Excel- und Excel v2-Connectors sind nicht mit Private Agent Version 12.x kompatibel. Nach dem Upgrade auf einen 12.x-Agent schlagen Verbindungstests und Operationen mit der Fehlermeldung HttpErrorResponse: This connector was not found on the Jitterbit Agent. Please be patient with us while the connector is downloaded across the agents. This may take up to several minutes. fehl. Zur Wiederherstellung führen Sie ein Downgrade auf Private Agent Version 11.59 oder früher durch. Ein Fix ist für eine zukünftige Version geplant. Weitere Informationen finden Sie unter Private Agent – bekannte Probleme.

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

Verbindungsdokumentation

Zusätzlich zur Microsoft Excel v2-Verbindung siehe die umfassende Seite Microsoft Excel v2-Verbindungsdetails. Konfigurationsdetails wie diese sind auf dieser Seite enthalten:

  • Erste Schritte: Erste Schritte zum Herstellen einer Verbindung.
  • Erweiterte Funktionen: Benutzerdefinierte Ansichten und SSL-Konfiguration.
  • Datenmodell: Das Datenmodell, das der Connector zur Darstellung des Endpunkts verwendet.
  • Erweiterte Konfigurationseigenschaften: Eigenschaften, die definiert werden können, um eine Verbindung für grundlegende und erweiterte Konfigurationen zu konfigurieren.

Aktivitätsdokumentation

Eine bestimmte Microsoft Excel v2-Verbindung und ihre Aktivitäten werden zusammen als Microsoft Excel-Endpunkt bezeichnet:

Microsoft Excel V2-Aktivitätstypen

  • Query: Ruft Datensätze aus einer Tabelle in Microsoft Excel ab und ist für die Verwendung als Quelle in einer Operation vorgesehen.

  • Create: Fügt einen Datensatz in eine Tabelle in Microsoft Excel ein und ist für die Verwendung als Ziel in einer Operation vorgesehen.

  • Update: Aktualisiert einen Datensatz in einer Tabelle in Microsoft Excel und ist für die Verwendung als Ziel in einer Operation vorgesehen.

  • Delete: Löscht einen Datensatz aus einer Tabelle in Microsoft Excel und ist für die Verwendung als Ziel in einer Operation vorgesehen.

  • Execute: Führt eine Prozedur in Microsoft Excel aus und ist für die Verwendung als Ziel in einer Operation vorgesehen.

Voraussetzungen und unterstützte API-Versionen

Dieser Connector kann nur mit 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 aussetzen.

Informationen zu den Schemaknoten und Feldern finden Sie in der Endpoint-Dokumentation.

OAuth-Authentifizierung

Die OAuth-Authentifizierung wird wie unter OAuth-Verbindungen konfigurieren beschrieben unterstützt.

Fehlerbehebung

Bei Problemen mit dem Microsoft Excel v2 Connector werden folgende 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 Disable Auto Connector Update verwendet wird).

  2. Stellen Sie sicher, dass alle Microsoft Entra ID-App-Registrierungen, die der Verbindung zugeordnet sind, nicht die veraltete Azure AD Graph verwenden.

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

  4. Aktivieren Sie Operation Debug Logging für private Agenten, um zusätzliche Protokolldateien und Daten zu generieren.

  5. Aktivieren Sie Connector Verbose Logging für diesen Connector, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agenten einfügen:

    <logger name="org.jitterbit.connector.verbose.logging.Excel" level="TRACE"/>

    Weitere Informationen zum Connector Verbose Logging finden Sie unter Verbose Logging für Connectors mit Jitterbit Private Agents.

  6. Überprüfen Sie die Agent-Protokolle für weitere Informationen.

  7. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Operation Troubleshooting.