Microsoft Excel-Connector für Jitterbit Studio

Zusammenfassung

Der Microsoft Excel-Connector ermöglicht den Zugriff auf Microsoft Excel.

Wichtig

Wir empfehlen die Verwendung des Microsoft Excel v2 Connectors, um eine Verbindung zu Microsoft Excel herzustellen, da er zusätzliche Konfigurationseigenschaften ermöglicht.

Der Microsoft Excel-Connector bietet eine Schnittstelle zur Erstellung einer Microsoft Excel-Verbindung, die als Grundlage für die Generierung von Instanzen von Microsoft Excel-Aktivitäten dient. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit Microsoft Excel.

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

WARNUNG: Während der Connector in der Lage ist, Daten aus Excel-Dateien, die in verschiedenen Cloud-Datenspeichern gehostet werden, über seine Abfrage-Aktivität abzurufen, werden die Aktivitäten Erstellen, Aktualisieren und Löschen außerhalb von lokalen Dateien in diesem Connector nicht unterstützt. Siehe Herstellen einer Verbindung für Details.

Bekanntes Problem

Die Excel- und Excel v2-Connectoren sind nicht mit der privaten Agentenversion 12.x kompatibel. Nach dem Upgrade auf einen 12.x-Agenten schlagen Verbindungstests und -operationen mit dem Fehler HttpErrorResponse: Dieser Connector wurde nicht auf dem Jitterbit-Agenten gefunden. Bitte haben Sie Geduld, während der Connector über die Agenten heruntergeladen wird. Dies kann mehrere Minuten dauern. fehl. Um wiederherzustellen, downgraden Sie auf die private Agentenversion 11.59 oder früher. Ein Fix ist für eine zukünftige Version geplant. Für Details siehe Bekannte Probleme mit dem privaten Agenten.

Hinweis

Dieser Connector kann nur mit privaten Agenten verwendet werden. Darüber hinaus handelt es sich um einen auf dem Connector SDK-basierten 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 Endpunktnutzungsberichten enthalten und zählen zu Ihrer Lizenz.

Connection documentation "Verbindungsdokumentation"

Neben der Microsoft Excel-Verbindung finden Sie auf der umfassenden Seite Microsoft Excel-Verbindungsdetails Konfigurationsdetails wie diese:

Getting Started: Erste Schritte zur Herstellung einer Verbindung.
Advanced Features: Benutzerdefinierte Ansichten und SSL-Konfiguration.
Data Model: Das Datenmodell, das der Connector verwendet, um den Endpunkt darzustellen.
Advanced Configurations Properties: Eigenschaften, die definiert werden können, um eine Verbindung für sowohl grundlegende als auch erweiterte Konfigurationen zu konfigurieren.

Activity documentation "Aktivitätsdokumentation"

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

Microsoft Excel activity types

Query: Ruft Datensätze aus einer Tabelle in Microsoft Excel ab und ist als Quelle in einem Vorgang vorgesehen.
Create: Fügt einen Datensatz in eine Tabelle in Microsoft Excel ein und ist als Ziel in einem Vorgang vorgesehen.
Update: Aktualisiert einen Datensatz in einer Tabelle in Microsoft Excel und ist als Ziel in einem Vorgang vorgesehen.
Löschen: Löscht einen Datensatz aus einer Tabelle in Microsoft Excel und ist als Ziel in einer Operation vorgesehen.
Ausführen: Führt ein Verfahren in Microsoft Excel aus und ist als Ziel in einer Operation vorgesehen.

Voraussetzungen und unterstützte API-Versionen

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

Dieser Connector erfordert die Verwendung eines privaten Agenten.

Siehe die Dokumentation zu Endpunkten für Informationen zu den Schema-Knoten und -Feldern.

OAuth-Authentifizierung

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

Fehlersuche

Wenn Sie Probleme mit dem Microsoft Excel-Connector haben, werden die folgenden Schritte zur Fehlersuche empfohlen:

Klicken Sie auf die Test-Schaltfläche in der Verbindungs-Konfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agenten heruntergeladen wird (es sei denn, Sie verwenden die Organisation Richtlinie Automatische Connector-Aktualisierung deaktivieren).
Stellen Sie sicher, dass keine Microsoft Entra ID-App-Registrierungen, die mit der Verbindung verbunden sind, die veraltete Azure AD Graph verwenden.
Überprüfen Sie die Betriebsprotokolle auf Informationen, die während der Ausführung der Operation geschrieben wurden.
Aktivieren Sie die Protokollierung des Betriebs-Debugs für private Agenten, um zusätzliche Protokolldateien und Daten zu generieren.
Aktivieren Sie die ausführliche Protokollierung des Connectors für diesen Connector, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agenten hinzufügen:
```
<logger name="org.jitterbit.connector.verbose.logging.Excel" level="TRACE"/>
```
Weitere Informationen zur ausführlichen Protokollierung von Connectors finden Sie unter Ausführliche Protokollierung für Connectors, die Jitterbit-private Agenten verwenden.
Überprüfen Sie die Agentenprotokolle für weitere Informationen.
Für zusätzliche Überlegungen zur Fehlersuche siehe Fehlerbehebung bei Operationen.