Zum Inhalt springen

Microsoft Excel-Connector in Jitterbit Studio

Zusammenfassung

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

Wichtig

Wir empfehlen die Verwendung des Microsoft Excel v2-Connectors, um sich mit Microsoft Excel zu verbinden, da dieser zusätzliche Konfigurationseigenschaften ermöglicht.

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

Der Microsoft Excel-Connector wird über die Registerkarte Projektendpunkte und Connectors der Palette der Designkomponenten aufgerufen (siehe Palette der Designkomponenten).

WARNUNG: Während der Connector Daten aus Excel-Dateien abrufen kann, die auf verschiedenen Cloud-Datenspeichern gehostet werden, indem er seine Query-Aktivität verwendet, werden die Aktivitäten Create, Update und Delete in diesem Connector nur außerhalb lokaler Dateien nicht 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 ein Downgrade auf Private Agent Version 11.59 oder früher durchführen. Eine Behebung 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-Verbindung siehe die umfassende Seite Microsoft Excel-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

Zusammen werden eine bestimmte Microsoft Excel-Verbindung und ihre Aktivitäten als Microsoft Excel-Endpunkt bezeichnet:

Microsoft Excel-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.

  • Ausführen: Führt eine Prozedur in Microsoft Excel aus und ist als Ziel in einem Vorgang 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 Automatische Connector-Aktualisierung deaktivieren organization policy aussetzen.

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

OAuth-Authentifizierung

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

Fehlerbehebung

Bei Problemen mit dem Microsoft Excel-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 Automatische Connector-Aktualisierung deaktivieren organization policy 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 Vorgangsprotokolle auf Informationen, die während der Ausführung des Vorgangs geschrieben wurden.

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

  5. Aktivieren Sie ausführliches Connector-Protokollieren 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 ausführlichen Connector-Protokollieren finden Sie unter Ausführliches Protokollieren für Connectors mit Jitterbit-Privatagenten.

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

  7. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Vorgängen.