Microsoft Excel Verbindungsdetails

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 21.0.8662 des Connectors.

Erste Schritte

Excel Versionsunterstützung

Der Connector unterstützt die Office Open XML-Tabellen, die von Excel 2007 und höher verwendet werden.

Anzeigen von Remote Excel Metadaten

Der Jitterbit-Connector für Excel ist nur für das Streamen von Excel konzipiert.

Dieser gestreamte Dateiinhalt enthält nicht alle Metadaten, die mit remote gespeicherten Excel Dateien verknüpft sind, wie etwa Datei- und Ordnernamen.

Wenn Zugriff sowohl auf die Dateimetadaten als auch auf den eigentlichen Dateiinhalt erforderlich ist, muss der Jitterbit Connector für Excel zusammen mit den zugehörigen Treiber für den Dienst verwendet werden, in dem die Excel Dateien remote gespeichert sind.

Die folgenden Dateisystemtreiber sind verfügbar:

AmazonS3 - Box - Dropbox - FTP Google Cloud Storage - IBM Cloud Object Storage Eine Fahrt - SFTP

Eine Konfigurationsanleitung zum Herstellen einer Verbindung mit gespeicherten Excel Dateimetadaten finden Sie in der Dokumentation des entsprechenden Dateisystemtreibers.

Herstellen einer Verbindung

Herstellen einer Verbindung zu Excel Datenquellen

Der Jitterbit Connector für Excel ermöglicht die Verbindung zu lokalen und Remote Excel Ressourcen. Setzen Sie den URI-Eigenschaft zum Excel Ressourcenspeicherort, zusätzlich zu allen anderen Eigenschaften, die für die Verbindung mit Ihrer Datenquelle erforderlich sind.

Mit Cloud-Dateien verbinden

Während der Connector Daten aus Excel Dateien abrufen kann, die in einer Vielzahl von Cloud-Datenspeichern gehostet werden, können INSERT, UPDATE und DELETE are not supported außerhalb lokaler Dateien in diesem Connector.

Wenn Sie Cloud-Dateien zum Einfügen/Aktualisieren/Löschen benötigen, können Sie den entsprechenden Connector für diesen Cloud-Host herunterladen (unterstützt durch gespeicherte Prozeduren), Änderungen mit dem entsprechenden Connector der lokalen Datei vornehmen und die Datei dann mithilfe der gespeicherten Prozeduren der Cloud-Quelle hochladen.

Wenn Sie beispielsweise eine auf SharePoint gespeicherte CSV-Datei aktualisieren möchten, können Sie die CSV-Datei mit dem DownloadDocument-Verfahren des SharePoint-Konnektors herunterladen, die lokale CSV-Datei mit dem CSV-Konnektor aktualisieren und anschließend die geänderte Datei mit dem UploadDocument-Verfahren des SharePoint-Konnektors auf SharePoint hochladen.

Herstellen einer Verbindung mit einer Arbeitsmappe

Der URI muss im Abschnitt „Verbindung“ auf eine gültige Excel Datei (einschließlich Dateipfad) eingestellt werden. Der Connector unterstützt das Office Open XML-Format, das von Excel 2007 und höher verwendet wird.

Abfragen einer Arbeitsmappe

Anschließend können Sie SELECT-, INSERT-, UPDATE- und DELETE-Anweisungen für Tabellen und Bereiche in der Arbeitsmappe ausführen. Siehe Excel Operationen für Einzelheiten zum Abfragen von Tabellenkalkulationsdaten als Tabellen.

Herstellen einer Verbindung mit Amazon S3

Setzen Sie die URI an eine Excel Datei in einem Bucket. Legen Sie außerdem die folgenden Eigenschaften zur Authentifizierung fest:

• AWSAccessKey: Legen Sie hier einen Amazon Web Services-Zugriffsschlüssel (einen Benutzernamen) fest.
• AWSSecretKey: Setzen Sie dies auf einen geheimen Amazon Web Services-Schlüssel.

Beispiel:

URI=s3://bucket1/folder1/file.xlsx; AWSAccessKey=token1; AWSSecretKey=secret1; AWSRegion=OHIO;

Optional angeben AWSRegion Zusätzlich.

Wenn beispielsweise StorageBaseURL conn prp ist eingestellt auf http://s3.%region%.myservice.com Und Region ist Region-1, dann generieren wir Anfrage-URLs wie https://s3.region-1.myservice.com/bucket/... (oder wie https://bucket.s3.region-1.myservice.com/..., wenn die UseVirtualHosting Eigenschaft ist wahr).

Herstellen einer Verbindung zu Oracle Cloud Object Storage

Setzen Sie die URI an eine Excel Datei in einem Bucket. Legen Sie außerdem die folgenden Eigenschaften zur Authentifizierung fest:

• AccessKey: Legen Sie dies auf einen Oracle Cloud-Zugriffsschlüssel fest.
• SecretKey: Legen Sie hier einen geheimen Oracle Cloud-Schlüssel fest.
• OracleNamespace: Legen Sie dies auf einen Oracle Cloud-Namespace fest.

Zum Beispiel:

URI=os://bucket/remotePath/; AccessKey=token1; SecretKey=secret1; OracleNamespace=myNamespace; Region=us-ashburn-1;

Optional angeben Region Zusätzlich.

Verbinde dich mit Wasabi

Setzen Sie die URI an eine Excel Datei in einem Bucket. Legen Sie außerdem die folgenden Eigenschaften zur Authentifizierung fest:

• AccessKey: Legen Sie hier einen Wasabi-Zugriffsschlüssel (einen Benutzernamen) fest
• SecretKey: Legen Sie hier einen geheimen Wasabi-Schlüssel fest.

Geben Sie optional an Region zusätzlich.

Beispiel:

URI=wasabi://bucket1/folder1/file.xlsx; AccessKey=token1; SecretKey=secret1; Region=OHIO;

Herstellen einer Verbindung mit Azure Blob Storage

Setzen Sie die URI auf den Namen Ihres Containers und den Namen des Blobs. Legen Sie außerdem die folgenden Eigenschaften zur Authentifizierung fest:

• AzureStorageAccount: Legen Sie dies auf das mit dem Azure Blob verknüpfte Konto fest.
• AzureAccessKey: Legen Sie dies auf den Zugriffsschlüssel fest, der dem Azure-Blob zugeordnet ist.

Zum Beispiel:

URI=azureblob://mycontainer/myblob/; AzureStorageAccount=myAccount; AzureAccessKey=myKey;

Sie können auch die OAuth-Authentifizierung verwenden, um eine Verbindung mit Azure Blob Storage herzustellen. Beispiel:

URI=azureblob://mycontainer/myblob/; AzureStorageAccount=myAccount; AuthScheme=AzureAD; InitiateOAuth=GETANDREFRESH;

Wenn Sie eine Verbindung von einer Azure-VM mit Berechtigungen für Azure Blob Storage herstellen, können Sie einfach AzureMSI verwenden AuthScheme Zum Beispiel:

URI=azureblob://mycontainer/myblob/; AzureStorageAccount=myAccount; AuthScheme=AzureMSI;

Wenn Sie sich mit einem Service Principal statt mit einem Client Secret authentifizieren möchten, ist die Authentifizierung auch mit einem Client-Zertifikat möglich.

• InitiateOAuth: Setzen Sie dies auf GETANDREFRESH. Sie können InitiateOAuth verwenden, um die Wiederholung des OAuth-Austauschs und das manuelle Setzen von zu vermeiden OAuthAccessToken.
• AzureTenant: Stellen Sie dies auf den Mandanten ein, mit dem Sie sich verbinden möchten.
• OAuthGrantType: Setzen Sie dies auf CLIENT.
• OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf die Client-ID fest.
• OAuthJWTCert: Legen Sie dies auf den JWT-Zertifikatspeicher fest.
• OAuthJWTCertType: Setzen Sie dies auf den Typ des Zertifikatspeichers, der durch angegeben ist OAuthJWTCert.

Zum Beispiel:

AuthScheme=AzureServicePrincipal;InitiateOAuth=GETANDREFRESH;OAuthClientId=MyClientId;;AzureTenant=MyAzureTenant;OAuthJWTCert=MyOAuthJWTCert;OAuthJWTCertType=PFXFile

Herstellen einer Verbindung mit Azure Data Lake Store Gen 2

Setzen Sie die URI auf den Namen des Dateisystems, den Namen des Ordners, der Ihre Excel Dateien kontaktiert, und den Namen einer Excel Datei. Legen Sie außerdem die folgenden Eigenschaften zur Authentifizierung fest:

• AzureStorageAccount: Legen Sie dies auf das Konto fest, das mit dem Azure Data Lake Store verknüpft ist.
• AzureAccessKey: Legen Sie dies auf den Zugriffsschlüssel fest, der dem Azure Data Lake Store zugeordnet ist.

Zum Beispiel:

URI=abfs://myfilesystem/folder1/file.xlsx; AzureStorageAccount=myAccount; AzureAccessKey=myKey;
URI=abfss://myfilesystem/folder1/file.xlsx; AzureStorageAccount=myAccount; AzureAccessKey=myKey;

Sie können auch die OAuth-Authentifizierung verwenden, um eine Verbindung mit Azure Data Lake Store Gen 2 herzustellen. Beispiel:

URI=abfss://myfilesystem/folder1; AzureStorageAccount=myAccount; AuthScheme=AzureAD; InitiateOAuth=GETANDREFRESH;

Wenn Sie eine Verbindung von einer Azure-VM mit Berechtigungen zum Herstellen einer Verbindung mit Azure Data Lake Store Gen 2 herstellen, können Sie AuthScheme einfach auf AzureMSI festlegen. Beispiel:

URI=abfss://myfilesystem/folder1; AzureStorageAccount=myAccount; AuthScheme=AzureMSI;

Wenn Sie sich mit einem Service Principal statt mit einem Client Secret authentifizieren möchten, ist die Authentifizierung auch mit einem Client-Zertifikat möglich.

• InitiateOAuth: Setzen Sie dies auf GETANDREFRESH. Sie können InitiateOAuth verwenden, um die Wiederholung des OAuth-Austauschs und das manuelle Setzen von zu vermeiden OAuthAccessToken.
• AzureTenant: Stellen Sie dies auf den Mandanten ein, mit dem Sie sich verbinden möchten.
• OAuthGrantType: Setzen Sie dies auf CLIENT.
• OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf die Client-ID fest.
• OAuthJWTCert: Legen Sie dies auf den JWT-Zertifikatspeicher fest.
• OAuthJWTCertType: Setzen Sie dies auf den Typ des Zertifikatspeichers, der durch angegeben ist OAuthJWTCert.

Zum Beispiel:

AuthScheme=AzureServicePrincipal;InitiateOAuth=GETANDREFRESH;OAuthClientId=MyClientId;;AzureTenant=MyAzureTenant;OAuthJWTCert=MyOAuthJWTCert;OAuthJWTCertType=PFXFile

Herstellen einer Verbindung mit Azure File Storage

Setzen Sie die URI auf den Namen Ihrer Azure-Dateifreigabe und den Namen der Ressource. Legen Sie außerdem die folgenden Eigenschaften zur Authentifizierung fest:

• AzureStorageAccount (Erforderlich): Legen Sie dies auf das mit der Azure-Datei verknüpfte Konto fest.
• AzureAccessKey: Legen Sie dies auf den Zugriffsschlüssel fest, der mit der Azure-Datei verknüpft ist.
• AzureSharedAccessSignature: Legen Sie dies auf die mit der Azure-Datei verknüpfte gemeinsame Zugriffssignatur fest.

Zum Beispiel:

URI=azurefile://fileShare/remotePath/file.xlsx; AzureStorageAccount=myAccount; AzureAccessKey=myAccessKey;

URI=azurefile://fileShare/remotePath/file.xlsx; AzureStorageAccount=myAccount; AzureSharedAccessSignature=mySharedSignature;

Mit Box verbinden

Setzen Sie die URI zum Pfad zu einer Excel Datei. Um sich bei Box zu authentifizieren, verwenden Sie den OAuth-Authentifizierungsstandard. Siehe Herstellen einer Verbindung zu Box für eine Anleitung zur Authentifizierung.

Beispiel:

URI=box://folder1/file.xlsx; InitiateOAuth=GETANDREFRESH; OAuthClientId=oauthclientid1; OAuthClientSecret=oauthcliensecret1; CallbackUrl=http://localhost:12345;

Mit Dropbox verbinden

Setzen Sie die URI zum Pfad zu einer Excel Datei. Um sich bei Dropbox zu authentifizieren, verwenden Sie den OAuth-Authentifizierungsstandard. Siehe Mit Dropbox verbinden für eine Anleitung zur Authentifizierung. Sie können sich mit einem Benutzerkonto oder einem Dienstkonto authentifizieren. Im Benutzerkonto-Flow müssen Sie keine Verbindungseigenschaften für Ihre Benutzeranmeldeinformationen festlegen, wie in der folgenden Verbindungszeichenfolge gezeigt:

URI=dropbox://folder1/file.xlsx; InitiateOAuth=GETANDREFRESH; OAuthClientId=oauthclientid1; OAuthClientSecret=oauthcliensecret1; CallbackUrl=http://localhost:12345;

Mit Google Drive verbinden

Setzen Sie die URI zum Pfad zum Namen des Dateisystems, zum Namen des Ordners, der Ihre Excel Dateien enthält, und zum Namen einer Excel-Datei. Um auf freigegebene Dateien zuzugreifen, legen Sie SharedWithMe als Namen des Ordners fest, der Ihre Excel Dateien enthält. Beispiel: URI=gdrive://SharedWithMe/remotePath. Verwenden Sie zur Authentifizierung bei Google APIs den OAuth-Authentifizierungsstandard.

Sie können den Connector autorisieren, im Namen einzelner Benutzer oder im Namen einer Domäne eine Verbindung zu Google APIs herzustellen. Siehe Herstellen einer Verbindung zu Google Drive als Leitfaden.

Beispiel:

URI=gdrive://folder1/file.xlsx;InitiateOAuth=GETANDREFRESH;

Herstellen einer Verbindung zur IBM Object Storage-Quelle

Setzen Sie die URI an eine Excel Datei in einem Bucket. Legen Sie außerdem die folgenden Eigenschaften zur Authentifizierung fest:

• AccessKey: Legen Sie hier einen IBM-Zugriffsschlüssel (einen Benutzernamen) fest.
• SecretKey: Setzen Sie dies auf einen geheimen IBM-Schlüssel.

Beispiel:

URI=ibmobjectstorage://bucket1/folder1; AccessKey=token1; SecretKey=secret1; Region=eu-gb;

Optional angeben Region zusätzlich.

Sie können sich bei Ihrer IBM Object Storage-Instanz auch mit OAuth authentifizieren AuthScheme:

• AuthScheme: Stellen Sie dies auf OAuth ein.
• ApiKey: Setzen Sie dies auf Ihren IBM API Schlüssel.
• Region: Legen Sie diese Eigenschaft auf die Region Ihrer IBM-Instanz fest.

Beispiel:

URI=ibmobjectstorage://bucket1/folder1; ApiKey=key1; Region=eu-gb; AuthScheme=OAuth; InitiateOAuth=GETANDREFRESH;

Herstellen einer Verbindung mit HDFS

Für die Verbindung mit der HDFS Datenquelle stehen zwei Authentifizierungsmethoden zur Verfügung: anonyme Authentifizierung und Negotiate-Authentifizierung (Kerberos).

Anonyme Authentifizierung

In einigen Situationen können Sie eine Verbindung zu HDFS herstellen, ohne dass Authentifizierungsverbindungseigenschaften erforderlich sind. Legen Sie dazu die AuthScheme-Eigenschaft auf Keine (Standard).

Authentifizierung mit Kerberos

Wenn Authentifizierungsdaten erforderlich sind, können Sie Kerberos zur Authentifizierung verwenden. Siehe Verwenden von Kerberos für Einzelheiten zur Authentifizierung mit Kerberos.

Herstellen einer Verbindung mit SharePoint Online SOAP

Setzen Sie die URI zu einer Dokumentbibliothek mit Excel Dateien. Zur Authentifizierung setzen Sie User Und Password Und StorageBaseURL.

Zum Beispiel:

URI=sp://Documents/folder1; User=user1; Password=password1; StorageBaseURL=https://subdomain.sharepoint.com;

Beachten Sie, dass diese Verbindungsmethode möglicherweise nicht funktioniert, wenn StorageBaseURL endet mit "-my.sharepoint.com". Sie sollten den onedrive:// Schema beim Herstellen einer Verbindung zu diesen Sites, da sie die Komponenten von SharePoint, die der Connector zum Herunterladen von Dateien benötigt, nicht unterstützen.

Herstellen einer Verbindung mit SharePoint Online REST

Setzen Sie die URI zu einer Dokumentbibliothek mit Excel Dateien. StorageBaseURL ist optional. Wenn nicht angegeben, funktioniert der Treiber mit dem Stammlaufwerk. Verwenden Sie zur Authentifizierung den OAuth-Authentifizierungsstandard.

Zum Beispiel:

URI=sp://Documents/folder1; InitiateOAuth=GETANDREFRESH; StorageBaseURL=https://subdomain.sharepoint.com;

Beachten Sie, dass diese Verbindungsmethode möglicherweise nicht funktioniert, wenn StorageBaseURL endet mit "-my.sharepoint.com". Sie sollten den onedrive:// Schema beim Herstellen einer Verbindung zu diesen Sites, da sie die Komponenten von SharePoint, die der Connector zum Herunterladen von Dateien benötigt, nicht unterstützen.

Mit FTP verbinden

Setzen Sie die URI an die Adresse des Servers, gefolgt vom Pfad zur Excel Datei. Zur Authentifizierung setzen Sie User Und Password.

Zum Beispiel:

URI=ftps://localhost:990/folder1/file.xlsx; User=user1; Password=password1;

Mit Google Cloud Storage verbinden

Setzen Sie die URI zum Pfad zum Namen des Dateisystems, dem Namen des Ordners, der Ihre Excel Dateien enthält, und dem Namen einer Excel Datei. Um sich bei Google APIs zu authentifizieren, geben Sie ein ProjectId.

Zum Beispiel:

URI=gs://bucket/remotePath/; ProjectId=PROJECT_ID;

Mit Google Drive verbinden

Der Connector ermöglicht die folgenden OAuth-Authentifizierungsabläufe:

• Der Benutzereinwilligungsablauf ermöglicht einzelnen Benutzern die Verbindung mit ihren eigenen Daten.
• Der Servicekontoablauf ermöglicht den Zugriff auf domänenweite Daten.

Verwenden Sie ein Benutzerkonto, um eine Verbindung zu Google herzustellen

Dieser OAuth-Flow erfordert, dass der authentifizierende Benutzer über den Browser mit Google interagiert. Der Connector erleichtert dies auf verschiedene Weise, wie unten beschrieben.

Authentifizieren bei Google

Nach dem Setzen von InitiateOAuth zu GETANDREFRESH, Sie sind bereit zur Verbindung. Sie können verwenden InitiateOAuth um den OAuth-Austausch und das manuelle Setzen der zu vermeiden OAuthAccessToken Verbindungseigenschaft. Wenn Sie eine Verbindung herstellen, öffnet der Connector den OAuth-Endpoint in Ihrem Standardbrowser. Melden Sie sich an und erteilen Sie der Anwendung Berechtigungen. Der Connector schließt dann den OAuth-Prozess ab:

1. Extrahiert das Zugriffstoken aus der Rückruf URL und authentifiziert Anfragen.
2. Aktualisiert den Zugriffstoken, wenn er abläuft.
3. Speichert OAuth-Werte, die über mehrere Verbindungen hinweg bestehen bleiben. Diese Datei kann in konfiguriert werden OAuthSettingsLocation.

Verwenden eines Dienstkontos zum Herstellen einer Verbindung zu domänenweiten Daten

Sie können in diesem OAuth-Flow ein Dienstkonto verwenden, um im Namen von Benutzern in einer Domäne auf Google APIs zuzugreifen. Ein Domänenadministrator kann domänenweiten Zugriff an das Dienstkonto delegieren.

Um den Servicekonto-Flow abzuschließen, generieren Sie einen privaten Schlüssel in der Google APIs Konsole. Im Servicekonto-Flow tauscht der Connector ein JSON Web Token (JWT) gegen das OAuthAccessToken. Der private Schlüssel wird zum Signieren des JWT benötigt. Der OAuthAccessToken authentifiziert, dass der Connector über dieselben Berechtigungen verfügt wie das Servicekonto.

Generieren eines privaten Schlüssels

Führen Sie die folgenden Schritte aus, um einen privaten Schlüssel zu generieren und die Anmeldeinformationen für Ihre Anwendung zu erhalten:

1. Melden Sie sich bei der Google API Konsole an.
2. Klicken Sie auf „Projekt erstellen“ oder wählen Sie ein vorhandenes Projekt aus.
3. Klicken Sie im API-Manager auf Anmeldeinformationen -> Anmeldeinformationen erstellen -> Dienstkontoschlüssel. Wählen Sie im Menü Dienstkonto die Option Neues Dienstkonto oder ein vorhandenes Dienstkonto aus. Wählen Sie im Abschnitt Schlüsseltyp den Schlüsseltyp P12 aus.
4. Klicken Sie auf Erstellen, um das Schlüsselpaar herunterzuladen. Das Passwort des privaten Schlüssels wird angezeigt: Legen Sie dieses in fest OAuthJWTCertPassword.
5. Klicken Sie im Abschnitt „Dienstkontoschlüssel“ auf der Seite „Anmeldeinformationen“ auf „Dienstkonten verwalten“ und legen Sie fest OAuthJWTIssuer an die in der Servicekonto-ID angezeigte Email Adresse.
6. Klicken Sie auf Bibliothek -> Google Drive API -> API aktivieren.
7. Wenn Sie die domänenweite Delegierung verwenden, müssen Sie der Client-ID des Dienstkontos in der Google Admin-Konsole die folgenden Bereiche hinzufügen. Gehen Sie in der Admin-Konsole zu Sicherheit -> API Steuerelemente -> domänenweite Delegierung -> domänenweite Delegierung verwalten. Fügen Sie die ID des Dienstkontos hinzu und geben Sie die folgenden Bereiche ein: https://www.googleapis.com/auth/drive, https://www.googleapis.com/auth/devstorage.read_write

Authentifizieren mit einem Dienstkonto

Nachdem Sie die folgenden Verbindungseigenschaften festgelegt haben, können Sie eine Verbindung herstellen:

• InitiateOAuth: Setzen Sie dies auf GETANDREFRESH. Sie können verwenden InitiateOAuth um den OAuth-Austausch und das manuelle Setzen der zu vermeiden OAuthAccessToken Verbindungseigenschaft.
• OAuthJWTCertType: Setzen Sie dies auf „PFXFILE“.
• OAuthJWTCertPassword: Setzen Sie dies auf das Passwort der .p12-Datei.
• OAuthJWTCertSubject: Setzen Sie dies auf "*", um das erste Zertifikat im Zertifikatsspeicher auszuwählen.
• OAuthJWTIssuer: Legen Sie hier die Email Adresse des Servicekontos fest.
• OAuthJWTCert: Setzen Sie dies auf den Pfad zur .p12-Datei.
• OAuthJWTSubject: Legen Sie hier die Email-Adresse des Benutzers fest, für den die Anwendung delegierten Zugriff anfordert.

Wenn Sie eine Verbindung herstellen, schließt der Connector den OAuth-Flow für ein Dienstkonto ab:

1. Erstellt und signiert das JWT mit dem vom Connector benötigten Anspruchssatz.
2. Tauscht das JWT gegen das Zugriffstoken aus.
3. Sendet das JWT für ein neues Zugriffstoken, wenn das Token abläuft.

Mit Box verbinden

Verwenden Sie den OAuth-Authentifizierungsstandard, um eine Verbindung mit Excel herzustellen. Sie können die Verbindung mit Ihrem Benutzerkonto herstellen oder ein Dienstkonto verwenden. Der Connector ermöglicht diese OAuth-Flows wie unten beschrieben.

Authentifizieren mit einem Benutzerkonto

Der Benutzerkontofluss erfordert, dass der authentifizierende Benutzer über den Browser mit Excel interagiert.

Sie können eine Verbindung herstellen, ohne Verbindungseigenschaften für Ihre Benutzeranmeldeinformationen festzulegen. Nach dem Festlegen von InitiateOAuth auf GETANDREFRESH, Sie sind bereit zur Verbindung. Wenn Sie die Verbindung herstellen, öffnet der Connector den OAuth-Endpoint in Ihrem Standardbrowser. Melden Sie sich an und erteilen Sie der Anwendung Berechtigungen. Der Connector schließt dann den OAuth-Prozess ab.

1. Extrahiert das Zugriffstoken aus der Rückruf URL und authentifiziert Anfragen.
2. Erhält einen neuen Zugriffstoken, wenn der alte abläuft.
3. Speichert OAuth-Werte in OAuthSettingsLocation soll über mehrere Verbindungen hinweg bestehen bleiben.

Hinweis: Der Connector ist bereits bei Excel als OAuth-Anwendung registriert und verwendet automatisch seine eingebetteten OAuth-Anmeldeinformationen zum Herstellen einer Verbindung.

Authentifizieren mit einem Dienstkonto

Dienstkonten verfügen über eine stille Authentifizierung, ohne Benutzerauthentifizierung im Browser. Sie müssen in diesem Flow eine OAuth-Anwendung erstellen. Sie können dann eine Verbindung zu Excel Daten herstellen, auf die das Dienstkonto Zugriffsberechtigung hat.

Nachdem Sie die folgenden Verbindungseigenschaften festgelegt haben, können Sie eine Verbindung herstellen:

• InitiateOAuth: Setzen Sie dies auf GETANDREFRESH.
• OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf die Client-ID fest.
• OAuthClientSecret: Legen Sie dies in Ihren App-Einstellungen auf das Client-Geheimnis fest.
• OAuthJWTCertType: Setzen Sie dies auf „PEMKEY_FILE“.
• OAuthJWTCert: Legen Sie hier den Pfad zur von Ihnen generierten PEM-Datei fest.
• OAuthJWTCertPassword: Setzen Sie dies auf das Passwort der .pem-Datei.
• OAuthJWTCertSubject: Setzen Sie dies auf "*", um das erste Zertifikat im Zertifikatsspeicher auszuwählen.
• OAuthJWTSubjectType: Stellen Sie dies auf „Enterprise“ oder „Benutzer“ ein, je nachdem, welchen Tokentyp Sie anfordern möchten. Sie müssen außerdem den Wert „Anwendungszugriff“ in Ihren App-Einstellungen auf den entsprechenden Betrefftyp einstellen. Der Standardwert dieser Verbindungseigenschaft ist „Enterprise“.
• OAuthJWTSubject: Legen Sie hier Ihre Unternehmens-ID fest, wenn Ihr Betrefftyp auf „Unternehmen“ eingestellt ist, oder Ihre App-Benutzer-ID, wenn Ihr Betrefftyp auf „Benutzer“ eingestellt ist.
• OAuthJWTPublicKeyId: Legen Sie dies in Ihren App-Einstellungen auf die ID Ihres öffentlichen Schlüssels fest.

Wenn Sie eine Verbindung herstellen, schließt der Connector den OAuth-Flow für ein Servicekonto ab.

1. Erstellt und signiert das JWT mit dem vom Connector benötigten Anspruchssatz.
2. Tauscht das JWT gegen das Zugriffstoken aus.
3. Speichert OAuth-Werte in OAuthSettingsLocation soll über mehrere Verbindungen hinweg bestehen bleiben.
4. Sendet das JWT für ein neues Zugriffstoken, wenn das Token abläuft.

Mit Dropbox verbinden

OAuth erfordert, dass der authentifizierende Benutzer über den Browser mit Excel interagiert. Der Connector erleichtert dies auf verschiedene Weise, wie unten beschrieben.

Sie können eine Verbindung herstellen, ohne Verbindungseigenschaften für Ihre Benutzeranmeldeinformationen festzulegen. Nach dem Festlegen von InitiateOAuth auf GETANDREFRESH, Sie sind bereit zur Verbindung. Wenn Sie die Verbindung herstellen, öffnet der Connector den OAuth-Endpoint in Ihrem Standardbrowser. Melden Sie sich an und erteilen Sie der Anwendung Berechtigungen. Der Connector schließt dann den OAuth-Prozess ab.

1. Extrahiert das Zugriffstoken aus der Rückruf URL und authentifiziert Anfragen.
2. Erhält einen neuen Zugriffstoken, wenn der alte abläuft.
3. Speichert OAuth-Werte in OAuthSettingsLocation soll über mehrere Verbindungen hinweg bestehen bleiben.

Hinweis: Der Connector ist bereits bei Excel als OAuth-Anwendung registriert und verwendet automatisch die eingebetteten OAuth-Anmeldeinformationen für die Verbindung. Wenn Sie Ihre eigene benutzerdefinierte OAuth-App verwenden möchten, lesen Sie Erstellen einer benutzerdefinierten OAuth-App.

SSO-Verbindungen

Authentifizieren mit SSO

Microsoft Entra ID

Entra-ID-Konfiguration

Das Hauptthema dieser Konfiguration ist der OAuth 2.0 On-Behalf-Of-Flow. Es sind zwei Entra ID-Anwendungen erforderlich:

1. Eine Anwendung für den Single-Sign-On-Prozess bei einem bestimmten Dienstanbieter.

   • Amazon S3: Bitte folgen Sie diesem Link für detaillierte Anweisungen zum Erstellen dieser Anwendung. Stellen Sie sicher, dass Sie die Verbindung testen und sich über die Entra-ID bei der AWS-Konsole anmelden können.

     Speichern Sie den Schritt „Microsoft Entra ID Testbenutzer zuweisen“ bis nach der Provisionierung, damit Sie bei der Benutzerzuweisung die AWS-Rollen auswählen können.

2. Eine „Connector“-Anwendung mit user_impersonation-Berechtigung für die SSO-Anwendung, die Sie im vorherigen Schritt erstellt haben.

   Gehen Sie zu Microsoft Entra ID --> App-Registrierungen und registrieren Sie eine neue Anwendung. Nachdem Sie diese Anwendung registriert haben, müssen Sie ihr erlauben, API Aufrufe an die SSO-Anwendung zu tätigen. Gehen Sie zum Abschnitt API Berechtigungen der App, die Sie registriert haben, und klicken Sie auf das Feld „Berechtigung hinzufügen“. Wählen Sie die API Ihrer SSO-Anwendung aus, indem Sie den API Namen oder die Anwendungs-ID angeben, und fügen Sie die Berechtigung user_impersonation hinzu.

Gemeinsame Treibereigenschaften

Die folgende SSOProperties werden zur Authentifizierung gegenüber der Microsoft Entra ID benötigt und müssen bei jedem Dienstanbieter angegeben werden.

• Ressource: Die Anwendungs-ID-URI der SSO-Anwendung, die im Abschnitt „Übersicht“ der App-Registrierung aufgeführt ist.
• Mandant: Die ID des Microsoft Entra ID Mandanten, bei dem die Anwendungen registriert sind. Sie können diesen Wert mithilfe der hier zu findenden Anweisungen finden.

Wir werden die SSO- SAML Antwort aus einem OAuth 2.0 On-Behalf-Of-Flow abrufen, daher müssen die folgenden OAuth-Verbindungseigenschaften angegeben werden:

• OAuthClientId: Die Anwendungs-ID der Connector-Anwendung, die im Abschnitt „Übersicht“ der App-Registrierung aufgeführt ist.
• OAuthClientSecret: Der Client-Geheimniswert der Connector-Anwendung. Microsoft Entra ID zeigt diesen an, wenn Sie ein neues Client-Geheimnis erstellen (Abschnitt „Zertifikate und Geheimnisse“).

Amazon S3

Zusätzlich zu den allgemeinen Eigenschaften müssen beim Herstellen einer Verbindung zum Amazon S3 Dienstanbieter die folgenden Eigenschaften angegeben werden:

• AuthScheme: Setzen Sie die AuthScheme zur Microsoft Entra ID.
• AWSRoleARN: Die ARN der IAM- Rolle. Diese finden Sie auf der Übersichtsseite der IAM Rolle.
• AWSPrincipalARN: Die ARN des Identitätsanbieters. Diese finden Sie auf der Übersichtsseite des Identitätsanbieters.

Nachfolgend sehen Sie ein Beispiel für eine Verbindungszeichenfolge:

AuthScheme=AzureAD;InitiateOAuth=GETANDREFRESH;OAuthClientId=d593a1d-ad89-4457-872d-8d7443aaa655;OauthClientSecret=g9-oy5D_rl9YEKfN-45~3Wm8FgVa2F;SSOProperties='Tenant=94be7-edb4-4fda-ab12-95bfc22b232f;Resource=https://signin.aws.amazon.com/saml;';AWSRoleARN=arn:aws:iam:2153385180:role/AWS_AzureAD;AWSPrincipalARN=arn:aws:iam:215515180:saml-provider/AzureAD;

OneLogin

OneLogin-Konfiguration

Sie müssen eine Anwendung erstellen, die für den Single-Sign-On-Prozess bei einem bestimmten Anbieter verwendet wird.

• Sharepoint SOAP: Bitte folgen Sie diesem Link für detaillierte Anweisungen zum Erstellen dieser Anwendung. Stellen Sie sicher, dass Sie die Verbindung testen und sich von OneLogin aus bei Office 365 anmelden können. Stellen Sie sicher, dass Sie WS-TRUST in Ihrer Anwendung aktiviert haben, da der Treiber sonst keine Verbindung herstellen kann.

Sharepoint-SOAP

Beim Herstellen einer Verbindung zum Sharepoint-SOAP Dienstanbieter müssen die folgenden Eigenschaften angegeben werden:

• AuthScheme: Setzen Sie die AuthScheme zu OneLogin.
• User: Der Benutzername des OneLogin-Kontos.
• Password: Das Passwort des OneLogin-Kontos.
• SSOProperties:
  • Domäne (optional): Diese Angabe kann erforderlich sein, wenn die in der SSO-Domäne konfigurierte Domäne sich von der Domäne des unterscheidet User.

Nachfolgend sehen Sie ein Beispiel für eine Verbindungszeichenfolge:

AuthScheme='OneLogin';User=test;Password=test;SSOProperties='Domain=test.cdata;';

Okta

Okta-Konfiguration

Sie müssen eine Anwendung erstellen, die für den Single-Sign-On-Prozess bei einem bestimmten Anbieter verwendet wird.

• Sharepoint SOAP: Bitte folgen Sie diesem Link für detaillierte Anweisungen zum Erstellen dieser Anwendung und Konfigurieren von SSO. Stellen Sie sicher, dass Sie die Verbindung testen und sich von Okta aus bei Office 365 anmelden können. Stellen Sie sicher, dass Sie SSO mit WS-Federation in Ihrer Anwendung konfiguriert haben, da der Treiber sonst keine Verbindung herstellen kann.
• Amazon S3: Bitte folgen Sie diesem Link für detaillierte Anweisungen zum Erstellen dieser Anwendung und Konfigurieren von SSO. Stellen Sie sicher, dass Sie die Verbindung testen und sich von Okta aus bei AWS anmelden können. Stellen Sie sicher, dass Sie SSO mit SAML 2.0 in Ihrer Anwendung konfiguriert haben, da der Treiber sonst keine Verbindung herstellen kann. Stellen Sie sicher, dass die zugewiesene AWS- Rolle in der OKTA-App Zugriff auf den S3-Bucket hat, den Sie verbinden möchten.

Sharepoint-SOAP

Beim Herstellen einer Verbindung zum Sharepoint-SOAP Dienstanbieter müssen die folgenden Eigenschaften angegeben werden:

• AuthScheme: Setzen Sie die AuthScheme zu Okta.
• User: Der Benutzername des Okta-Kontos.
• Password: Das Passwort des Okta-Kontos.
• SSOProperties:
  • Domäne (optional): Diese Angabe kann erforderlich sein, wenn die in der SSO-Domäne konfigurierte Domäne sich von der Domäne des unterscheidet User.

Nachfolgend sehen Sie ein Beispiel für eine Verbindungszeichenfolge:

AuthScheme='Okta';User=test;Password=test;SSOProperties='Domain=test.cdata;';

Amazon S3

Beim Herstellen einer Verbindung zum Amazon S3 Dienstanbieter müssen die folgenden Eigenschaften angegeben werden:

• AuthScheme: Setzen Sie die AuthScheme zu Okta.
• User: Der Benutzername des Okta-Kontos.
• Password: Das Passwort des Okta-Kontos.
• SSOLoginURL: Legen Sie dies auf die eingebettete URL Ihrer AWS OKTA SSO-App fest.
• AWSRoleARN (optional): Die ARN der IAM- Rolle. Diese finden Sie auf der Übersichtsseite der IAM- Rolle.
• AWSPrincipalARN (optional): Die ARN des Identitätsanbieters. Diese finden Sie auf der Übersichtsseite des Identitätsanbieters.
• SSOProperties:
  • APIToken (optional): Legen Sie hier das API Token fest, das der Kunde aus der Okta-Organisation erstellt hat. Es sollte verwendet werden, wenn ein Benutzer über eine vertrauenswürdige Anwendung oder einen Proxy authentifiziert wird, der den OKTA-Client-Anforderungskontext überschreibt.

Nachfolgend sehen Sie ein Beispiel für eine Verbindungszeichenfolge:

AuthScheme=Okta;User=OktaUser;Password=OktaPassword;SSOLoginURL='https://{subdomain}.okta.com/home/amazon_aws/0oan2hZLgQiy5d6/272';

ADFS

ADFS-Konfiguration

Sie müssen eine Anwendung erstellen, die für den Single-Sign-On-Prozess bei einem bestimmten Anbieter verwendet wird.

• Sharepoint SOAP: Bitte folgen Sie diesem Link für detaillierte Anweisungen zum Einrichten von ADFS für Office 365 für Single Sign-On. Stellen Sie sicher, dass Sie die Verbindung testen und sich von ADFS aus bei Office 365 anmelden können.
• Amazon S3: Bitte folgen Sie diesem Link für detaillierte Anweisungen zum Einrichten von ADFS für AWS Single Sign-On. Stellen Sie sicher, dass Sie die Verbindung testen und sich von ADFS aus bei AWS anmelden können.

Sharepoint-SOAP

Beim Herstellen einer Verbindung zum Sharepoint-SOAP Dienstanbieter müssen die folgenden Eigenschaften angegeben werden:

• AuthScheme: Setzen Sie die AuthScheme zu ADFS.
• User: Der Benutzername des ADFS-Kontos.
• Password: Das Passwort des ADFS-Kontos.
• SSOProperties:
  • Domäne (optional): Diese Angabe kann erforderlich sein, wenn die in der SSO-Domäne konfigurierte Domäne sich von der Domäne des unterscheidet User.

Nachfolgend sehen Sie ein Beispiel für eine Verbindungszeichenfolge:

AuthScheme='ADFS';User=test;Password=test;SSOProperties='Domain=test.cdata;';

Amazon S3

Beim Herstellen einer Verbindung zum Sharepoint-SOAP Dienstanbieter müssen die folgenden Eigenschaften angegeben werden:

• AuthScheme: Setzen Sie die AuthScheme zu ADFS.
• SSOLoginURL: Legen Sie dies auf die URL Ihrer ADFS-Instanz fest.
• User: Der Benutzername des ADFS-Kontos.
• Password: Das Passwort des ADFS-Kontos.
• AWSRoleARN (optional): Die ARN der IAM- Rolle. Diese finden Sie auf der Übersichtsseite der IAM- Rolle.
• AWSPrincipalARN (optional): Die ARN des Identitätsanbieters. Diese finden Sie auf der Übersichtsseite des Identitätsanbieters.

Nachfolgend sehen Sie ein Beispiel für eine Verbindungszeichenfolge:

AuthScheme=ADFS;User=username;Password=password;SSOLoginURL='https://sts.company.com';

ADFS integriert

Der ADFS-integrierte Fluss zeigt an, dass Sie eine Verbindung mit herstellen currently logged in Windows user credentials. Um den integrierten ADFS-Flow zu verwenden, geben Sie einfach nicht die User Und Password, aber befolgen Sie ansonsten die gleichen Schritte wie in der ADFS-Anleitung oben.

Optimieren des Datenzugriffs

Erweiterte Datenmodellierungseinstellungen

Verwenden Sie die folgenden Eigenschaften, um die vom Connector erkannten Tabellen, Rückgabewerte und andere Aspekte des Datenzugriffs zu steuern.

Schemaerkennung

• Orientation: Modelltabellen, die der Ausrichtung Ihrer Tabelle entsprechen: Stellen Sie dies auf Horizontal oder Vertikal ein.

• DefineTables: Geben Sie die Bereiche, auf die Sie zugreifen möchten, explizit als Tabellen an. Verwenden Sie dazu das standardmäßige Excel Bereichsformat: [Tabellenname]=[Tabellenblattname]![Bereich]. Geben Sie mehrere Tabellen in einer durch Semikolon getrennten Liste an:

    DefineTables="Table1=Sheet1!A1:N25,Table2=Sheet2!C3:M53"
  

  Beachten Sie, dass der Connector die benannten Bereiche in einem Blatt automatisch erkennt und sie als Tabellen meldet. Sie können auch einen Bereich in der FROM-Klausel angeben:

   SELECT * FROM Excel_Sheet#A5:F*
  

Spaltenermittlung

• Header: Wenn wahr, werden Spaltennamen aus der ersten Zeile ermittelt. Andernfalls werden die Pseudospaltennamen A, B, C usw. verwendet.
• TypeDetectionScheme: Bestimmt, wie der Connector die Datentypen von Spalten erkennt.
• RowScanDepth: Wenn Sie das Zeilenscan-Typerkennungsschema verwenden, legen Sie diese Eigenschaft auf die Anzahl der zu scannenden Zeilen fest, um Spaltendatentypen zu bestimmen.

Erweiterte Excel Integration

Formeln

• AllowFormula: Ob das Formelergebnis oder der Formelausdruck eingefügt oder aktualisiert werden soll.
• Recalculate: Formeln neu berechnen, wenn sich die Daten ändern.
• IgnoreCalcError: Ignoriere Fehler, die beim Berechnen von Formeln auftreten.
• HasCrossSheetReferences: Formeln in allen Arbeitsblättern neu berechnen, wenn die Daten geändert werden; der Connector folgt blattübergreifenden Verweisen, dies geht jedoch zu Lasten der Leistung.

Verschiedenes

• EmptyValueMode: Konfigurieren Sie, wie mit leeren Zellen umgegangen werden soll. Eine leere Zelle ist eine Zelle, die eine leere Zeichenfolge enthält (z. B. =""). Sie können eine leere Zelle als leere Zeichenfolge oder als Nullzeichenfolge zurückgeben (Standard: gibt eine leere Zeichenfolge zurück.)
• NullValueMode: Konfigurieren Sie, wie mit Zellen verfahren werden soll, die nicht festgelegt wurden. Eine nicht festgelegte Zelle unterscheidet sich von einer leeren Zelle. Nicht festgelegte Zellen enthalten eine Nullzeichenfolge. Sie können eine nicht festgelegte Zelle als leere Zeichenfolge oder als Nullzeichenfolge zurückgeben (Standard: gibt NULL zurück).
• BufferChanges: Gibt an, ob Änderungen an den Daten im Speicher gehalten werden sollen, bis die Verbindung geschlossen wird.

Kerberos verwenden

In diesem Abschnitt wird gezeigt, wie Sie den Connector zur Authentifizierung bei Excel mittels Kerberos verwenden.

Authentifizieren mit Kerberos

Um sich mit Kerberos bei Excel zu authentifizieren, legen Sie die folgenden Eigenschaften fest:

• AuthScheme: Setzen Sie dies auf NEGOTIATE.
• KerberosKDC: Setzen Sie dies auf host name or IP Address Ihrer Kerberos-KDC-Maschine.
• KerberosRealm: Setzen Sie dies auf the realm of the Excel Kerberos principal. Dies ist der Wert nach dem '@'-Symbol (z. B. EXAMPLE.COM) des principal value (zum Beispiel ServiceName/MyHost@EXAMPLE.COM).
• KerberosSPN: Setzen Sie dies auf service and host of the Excel Kerberos Principal. Dies ist der Wert vor dem '@'-Symbol (z. B. ServiceName/MyHost) des principal value (zum Beispiel ServiceName/MyHost@EXAMPLE.COM).

Abrufen des Kerberos-Tickets

Sie können eine der folgenden Optionen verwenden, um das erforderliche Kerberos-Ticket abzurufen.

MIT Kerberos-Anmeldeinformations-Cache-Datei

Mit dieser Option können Sie den MIT Kerberos Ticket Manager oder den Befehl kinit verwenden, um Tickets abzurufen. Beachten Sie, dass Sie nicht das User oder Password Verbindungseigenschaften mit dieser Option.

1. Stellen Sie sicher, dass Sie eine Umfeld mit dem Namen erstellt haben KRB5CCNAME.
2. Setzen Sie die KRB5CCNAME Umfeld auf einen Pfad, der auf Ihr verweist credential cache file (zum Beispiel C:\krb_cache\krb5cc_0 oder /tmp/krb5cc_0). Diese Datei wird erstellt, wenn Sie Ihr Ticket mit MIT Kerberos Ticket Manager erstellen.
3. Um ein Ticket zu erhalten, öffnen Sie die Anwendung MIT Kerberos Ticket Manager und klicken Sie auf Get Ticket, enter your principal name and password, then click OK. Bei Erfolg werden die Ticketinformationen im Kerberos Ticket Manager angezeigt und nun in der Anmeldeinformationscachedatei gespeichert.
4. Nachdem die Cache-Datei mit den Anmeldeinformationen erstellt wurde, verwendet der Connector die Cache-Datei, um das Kerberos-Ticket für die Verbindung mit Excel abzurufen.

Als Alternative zum Setzen des KRB5CCNAME Umfeld können Sie den Dateipfad direkt mit der festlegen KerberosTicketCache-Eigenschaft. Wenn diese Eigenschaft festgelegt ist, verwendet der Connector die angegebene Cache-Datei, um das Kerberos-Ticket für die Verbindung mit Excel abzurufen.

Keytab-Datei

Wenn die KRB5CCNAME environment variable has not been set, Sie können ein Kerberos-Ticket abrufen mit einem Keytab File. Setzen Sie dazu die User Eigenschaft auf den gewünschten Benutzernamen und setzen Sie die KerberosKeytabFile-Eigenschaft zu einem Dateipfad, der auf die dem Benutzer zugeordnete Keytab-Datei verweist.

Benutzer und Passwort

Wenn beide the KRB5CCNAME environment variable and the _KerberosKeytabFile_ property have not been set, Sie können ein Ticket abrufen mit einem User and Password combination. Setzen Sie dazu die User Und PasswordEigenschaften für die Benutzer-/Passwortkombination, die Sie zur Authentifizierung bei Excel verwenden.

Cross-Realm-Authentifizierung

Komplexere Kerberos-Umgebungen erfordern möglicherweise eine bereichsübergreifende Authentifizierung, wenn mehrere Bereiche und KDC-Server verwendet werden (z. B. wenn ein Bereich/KDC für die Benutzerauthentifizierung und ein anderer Bereich/KDC zum Abrufen des Servicetickets verwendet wird).

In einer solchen Umfeld ist die KerberosRealm Und KerberosKDC Eigenschaften können auf die für die Benutzerauthentifizierung erforderlichen Werte gesetzt werden. Die KerberosServiceRealm Und KerberosServiceKDC Eigenschaften können auf die Werte gesetzt werden, die zum Erhalt des Servicetickets erforderlich sind.

Wichtige Hinweise

Konfigurationsdateien und ihre Pfade

• Alle Verweise auf das Hinzufügen von Konfigurationsdateien und deren Pfaden beziehen sich auf Dateien und Speicherorte auf dem Jitterbit-Agenten, auf dem der Connector installiert ist. Diese Pfade sind je nach Agent und Operationssystem entsprechend anzupassen. Wenn mehrere Agenten in einer Agentengruppe verwendet werden, werden auf jedem Agenten identische Dateien benötigt.

Excel Operationen

Mit dem Jitterbit Connector für Excel können Sie Excel Dateien auf verschiedene Weise bearbeiten. Der Connector unterstützt das vertikale und horizontale Lesen von Daten sowie aus benutzerdefinierten Bereichen und benannten Bereichen. Siehe Daten auswählen und Daten ändern für Beispiele verschiedener Möglichkeiten zum Abfragen und Ändern von Tabellendaten.

Daten auswählen

Excel Arbeitsblätter können auf verschiedene Arten organisiert werden. Der Connector bietet Einstellungen zur Auswahl von Daten basierend auf verschiedenen Organisationsmethoden.

Mit Überschriftenzellen

Wenn eine Tabelle Spaltenüberschriften hat, kann der Connector diese verwenden, um die Spaltennamen der Arbeitsblatttabelle darzustellen. Um Header zu verwenden, setzen Sie den Header-Eigenschaft auf True. Dann können Sie wie folgt Abfrage:

SELECT RowId, Name, Item, Quantity, Amount FROM Sheet1 WHERE Amount > '50'

Die obige Abfrage geht davon aus, dass die erste Zeile der Tabelle die Spaltennamen RowId, Name, Quantity und Amount enthält. Die Tabelle kann mehr Spalten enthalten als ausgewählt wurden und die Reihenfolge kann beliebig sein.

Ohne Kopfzellen

Wenn eine Tabelle keine Header hat oder Sie die Header ignorieren möchten, können Sie den Header-Eigenschaft auf „false“. In diesem Fall wird jede Spalte durch den Spaltennamen in Excel dargestellt, also A, B, C, …

SELECT A, B, C, D FROM Sheet1 WHERE D > '50'

Orientierung

Wenn eine Tabelle horizontal angeordnet ist (d. h. die Spaltennamen sind vertikal in der ersten Spalte angeordnet), können Sie die Orientation-Eigenschaft auf Horizontal, um jede Spalte als Zeile in der Tabelle zu lesen. Die Orientation Eigenschaft kann in Verbindung mit verwendet werden Header Verbindungseigenschaft und die unten beschriebene Bereichssyntax.

Wenn keine Header festgelegt sind und die Ausrichtung horizontal ist, lauten die Spaltennamen R1, R2, R3, …

SELECT R1, R2, R3 FROM Sheet1 WHERE R2 > '50'

Reichweite

Mit der Bereichsfunktion können Sie Daten aus einem bestimmten Teil der Tabelle auswählen, z. B. wenn Sie eine spärlich gefüllte Tabelle haben, die nicht oben links ausgerichtet ist, oder wenn die relevanten Daten irgendwo in der Mitte der Tabelle liegen. Der Bereich wird als Teil des Tabellennamens angegeben. Mit dem folgenden Befehl wird beispielsweise der Zellbereich zwischen A1 und E5 ausgewählt:

SELECT * FROM Excel_Sheet#A1:E5

Falls der Blattname ein Anführungszeichen enthält und Sie nur einen Bereich auswählen möchten, besteht die korrekte Excel Syntax darin, ein zusätzliches Anführungszeichen als Escape-Zeichen zu verwenden und den vollständigen Blattnamen in Anführungszeichen einzuschließen. Beispielsweise wählt der folgende Befehl den Zellbereich zwischen A1 und E5 für das Blatt mit dem Namen „Excel-Tabelle“ aus:

SELECT * FROM ['Excel''Sheet'#A1:E5]

Sie können auch Platzhalter verwenden (*) in der Endzelle des Bereichs. Bereiche ähnlich wie '#A5:F*', '#A5:*20', Und '#A5:**' werden unterstützt. Beispielsweise wählt der folgende Befehl den Zellbereich zwischen A5 und Spalte F bis zur letzten Zeile in der Tabelle aus:

SELECT * FROM Excel_Sheet#A5:F*

Benannter Bereich

Wenn in einer Kalkulationstabelle ein benannter Bereich definiert ist, können Sie diesen Bereich Abfrage, als wäre er eine Tabelle. Sie können die folgende Abfrage ausführen, um Daten aus dem benannten Bereich SALES auszuwählen.

SELECT * FROM SALES

Daten ändern

Der Jitterbit-Connector für Excel unterstützt INSERT, UPDATE und DELETE; weitere Einzelheiten finden Sie unten.

Aktualisieren und Löschen

Bei Aktualisierungen und Löschungen müssen Sie eine einzelne Zeile eindeutig identifizieren, indem Sie die Spalte RowId angeben.

Siehe Verwenden von Formeln, um Formeln einzufügen.

Einfügen

Sie können überall im Blatt neue Zeilen einfügen, auch in benannte Bereiche.

Hinzufügen einer Zeile

Mit der INSERT-Anweisung können Sie Ihrer Tabelle neue Zeilen hinzufügen. Wenn die Header-Eigenschaft auf True gesetzt ist, können Sie basierend auf den Spaltenüberschriften einfügen. Wenn die Header-Eigenschaft falsch ist, müssen Sie die Zellennamen (A, B, C usw.) verwenden, um eine Zeile einzufügen. Wenn Sie eine Zeile einfügen, wird sie an das Ende des Blatts angehängt. Dieser neuen Zeile wird eine RowId zugewiesen, basierend auf ihrer Position im Excel Blatt.

Es ist auch möglich, eine Zeile am Ende eines Zellbereichs einzufügen. Verwenden Sie dazu beim Einfügen einer Zeile einfach den Bereich im Tabellennamen.

INSERT INTO Sheet1#C1:D5 (A, B) VALUES ('Brian', '30')

Der obige Code fügt Brian und 30 am Ende des Bereichs hinzu, also an den Zellen C6 und D6.

Einfügen einer Zeile

Manchmal möchten Sie vielleicht eine Zeile in der Mitte eines Excel Blattes einfügen. Der Connector unterstützt dies mithilfe des INSERT-Befehls mit der RowId, die die Zeilennummer identifiziert. Wenn die RowId mit der INSERT- Abfrage angegeben wird, fügt der Connector die Zeile an der angegebenen Zeilennummer hinzu. Alle Zeilen an und unter der angegebenen Zeilennummer werden eine Zeile nach unten verschoben und ihre RowId wird um eins erhöht. Beispiel:

INSERT INTO Sheet1 (RowId, A, B) VALUES (5, 'Brian', '30')

Der obige Code fügt die Werte Brian und 30 in die Zellen A5 und B5 ein. Die vorhandenen Daten in Zeile 5 und darunter werden eine Zeile nach unten verschoben.

Hinzufügen einer Zeile zu einem benannten Bereich

Es ist auch möglich, eine Zeile am Ende des benannten Bereichs einzufügen. Fügen Sie dazu einfach eine Zeile ohne RowId in die nach dem Bereich benannte Tabelle ein. Der folgende Code fügt eine neue Zeile an das Ende des benannten Bereichs SALES an. Die Definition des benannten Bereichs wird erweitert, um die gerade eingefügte Zeile einzuschließen.

INSERT INTO SALES (Year, Category, Total) VALUES (1997, 'Beverage', 30000)

Verwenden Sie Formeln

Excel Formeln werden beim Öffnen der Tabelle neu berechnet. Der Connector enthält eine Formel-Engine, die die meisten häufig verwendeten Excel Formeln nativ berechnen kann. Der Connector speichert den Status einer vorherigen Berechnung in der Tabelle und verwendet ihn, um effizient zu entscheiden, wann eine Neuberechnung erforderlich ist.

Formeln neu berechnen

Der Recalculate Mit der-Eigenschaft können Sie steuern, ob Formeln berechnet werden sollen. Sie sollten festlegen Recalculate auf True, wenn Sie Daten aus einer Tabelle mit Formeln lesen möchten und wissen, dass die Formelergebnisse möglicherweise nicht auf dem neuesten Stand sind. Sobald ein Wert für eine Zelle berechnet wurde, wird er auch in der Tabelle aktualisiert. Dadurch können Neuberechnungen vermieden werden.

Das Berechnen von Formelzellen kann die Verarbeitungszeit verlängern. Wenn eine Tabelle seit der letzten Neuberechnung nicht geändert wurde, können Sie die Berechnung auslassen und einfach den zuvor berechneten Wert in der Formelzelle lesen. Um die Neuberechnung zu überspringen, setzen Sie Recalculate auf „False“. Sie können die Formelberechnung auch weglassen, wenn Sie eine Tabelle nur öffnen, um Zellen einzufügen oder zu aktualisieren, und nichts daraus lesen möchten.

Formeln einfügen

Der Connector ermöglicht es Ihnen, Formeln in Zellen einzufügen. Wenn der AllowFormula Verbindungszeichenfolgeneigenschaft auf „true“ gesetzt ist, wird alles, was Sie einfügen, beginnend mit einem Gleichheitszeichen ('='), als Formel behandelt. Beispielsweise fügt das Folgende eine Formel in die Spalte B ein, die die Zellen B1:B5 summiert:

INSERT INTO Excel_Sheet (A, B) VALUES ('Bill', '=SUM(B1:B5)')

Erweiterte Funktionen

In diesem Abschnitt wird eine Auswahl erweiterter Funktionen des Excel Konnektors beschrieben.

Benutzerdefinierte Ansichten

Der Connector ermöglicht Ihnen die Definition virtueller Tabellen, sogenannter benutzerdefinierter Ansichten, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese Ansichten sind nützlich, wenn Sie die an die Treiber gesendeten Abfragen nicht direkt steuern können. Siehe Benutzerdefinierte Ansichten für einen Überblick über das Erstellen und Konfigurieren benutzerdefinierter Ansichten.

SSL-Konfiguration

Verwenden Sie SSL-Konfiguration, um anzupassen, wie der Connector TLS/SSL-Zertifikatsverhandlungen handhabt. Sie können aus verschiedenen Zertifikatsformaten wählen; siehe SSLServerCert-Eigenschaft unter „Verbindungszeichenfolgenoptionen“ für weitere Informationen.

Proxy

So konfigurieren Sie den Connector mit privaten Agent-Proxy-Einstellungen, wählen Sie die Use Proxy Settings Kontrollkästchen auf dem Verbindungskonfigurationsbildschirm.

Benutzerdefinierte Ansichten

Mit dem Jitterbit Connector für Excel können Sie eine virtuelle Tabelle definieren, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese werden als benutzerdefinierte Ansichten bezeichnet und sind in Situationen nützlich, in denen Sie die an den Treiber gesendete Abfrage nicht direkt steuern können, z. B. wenn Sie den Treiber von Jitterbit verwenden. Die benutzerdefinierten Ansichten können verwendet werden, um Prädikate zu definieren, die immer angewendet werden. Wenn Sie in der Abfrage an die Ansicht zusätzliche Prädikate angeben, werden diese mit der bereits als Teil der Ansicht definierten Abfrage kombiniert.

Es gibt zwei Möglichkeiten, benutzerdefinierte Ansichten zu erstellen:

• Erstellen Sie eine Konfigurationsdatei im JSON-Format, die die gewünschten Ansichten definiert.
• DDL-Anweisungen.

Definieren von Ansichten mithilfe einer Konfigurationsdatei

Benutzerdefinierte Ansichten werden in einer JSON-formatierten Konfigurationsdatei namens UserDefinedViews.json. Der Connector erkennt die in dieser Datei angegebenen Ansichten automatisch.

Sie können auch mehrere Ansichtsdefinitionen haben und diese mit steuern UserDefinedViews Verbindungseigenschaft. Wenn Sie diese Eigenschaft verwenden, werden vom Connector nur die angegebenen Ansichten angezeigt.

Diese Konfigurationsdatei für benutzerdefinierte Ansichten ist wie folgt formatiert:

• Jedes Stammelement definiert den Namen einer Ansicht.
• Jedes Stammelement enthält ein untergeordnetes Element namens query, das die benutzerdefinierte SQL- Abfrage für die Ansicht enthält.

Zum Beispiel:

{
    "MyView": {
        "query": "SELECT * FROM Sheet WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Verwenden Sie UserDefinedViews Verbindungseigenschaft zur Angabe des Speicherorts Ihrer JSON-Konfigurationsdatei. Beispiel:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Schema für benutzerdefinierte Ansichten

Benutzerdefinierte Ansichten werden im angezeigt UserViews Schema standardmäßig. Dies geschieht, um zu vermeiden, dass der Name der Ansicht mit einer tatsächlichen Entität im Datenmodell kollidiert. Sie können den Namen des für UserViews verwendeten Schema ändern, indem Sie festlegen UserViewsSchemaName Eigentum.

Arbeiten mit benutzerdefinierten Ansichten

Beispielsweise eine SQL-Anweisung mit einer benutzerdefinierten Ansicht namens UserViews.RCustomers listet nur Kunden in Raleigh auf:

SELECT * FROM Customers WHERE City = 'Raleigh';

Ein Beispiel für eine Abfrage an den Treiber:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Daraus ergibt sich die effektive Abfrage an die Quelle:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Dies ist ein sehr einfaches Beispiel für eine Abfrage an eine benutzerdefinierte Ansicht, die tatsächlich eine Kombination aus der Abfrage und der Ansichtsdefinition ist. Es ist möglich, diese Abfragen in viel komplexeren Mustern zusammenzustellen. Alle SQL-Operationen sind in beiden Abfragen zulässig und werden bei Bedarf kombiniert.

SSL-Konfiguration

Anpassen der SSL-Konfiguration

Standardmäßig versucht der Connector, SSL/TLS auszuhandeln, indem er das Zertifikat des Servers mit dem vertrauenswürdigen Zertifikatspeicher des Systems vergleicht.

Um ein anderes Zertifikat anzugeben, siehe SSLServerCert Eigenschaft für die verfügbaren Formate, um dies zu tun.

Client-SSL-Zertifikate

Der Excel Connector unterstützt auch das Festlegen von Client-Zertifikaten. Legen Sie Folgendes fest, um eine Verbindung mithilfe eines Client-Zertifikats herzustellen.

• SSLClientCert: Der Name des Zertifikatspeichers für das Client-Zertifikat.
• SSLClientCertType: Der Typ des Schlüsselspeichers, der das TLS/SSL-Clientzertifikat enthält.
• SSLClientCertPassword: Das Passwort für das TLS/SSL-Client-Zertifikat.
• SSLClientCertSubject: Der Betreff des TLS/SSL-Client-Zertifikats.

Datenmodell

Der Jitterbit Connector für Excel modelliert Excel-Arbeitsmappen als relationale Datenbanken. Die Tabellen bestehen aus Arbeitsblättern und Bereichen.

SQL in Tabellenkalkulationen ausführen

Excel Operationen zeigt verschiedene Möglichkeiten, mit Tabellendaten zu arbeiten.

Erweiterte Datenmodellierung

Sie können das Datenmodell feinabstimmen, damit es zur Organisation Ihrer Arbeitsmappe passt. Der Connector unterstützt das Lesen von vertikal oder horizontal ausgerichteten Daten sowie von spärlich besetzten Tabellen, die in benutzerdefinierten Bereichen und benannten Bereichen organisiert sind.

Siehe Feinabstimmung des Datenzugriffs, um die Verbindungszeichenfolge zu konfigurieren und so die vom Connector erkannten Tabellen, Rückgabewerte und andere Aspekte des Datenzugriffs zu steuern.

Gespeicherte Prozeduren

Zusätzlich zur Arbeit mit den Daten in der Tabelle können Sie die verfügbaren gespeicherten Prozeduren verwenden, um die Metadaten einer Excel Datei zu ändern.

Gespeicherte Prozeduren

Gespeicherte Prozeduren stehen zur Ergänzung der im Datenmodell verfügbaren Daten zur Verfügung. Es kann erforderlich sein, die in einer Ansicht verfügbaren Daten mithilfe einer gespeicherten Prozedur zu aktualisieren, da die Daten keine direkten, tabellenartigen, bidirektionalen Aktualisierungen ermöglichen. In diesen Situationen erfolgt der Abruf der Daten mithilfe der entsprechenden Ansicht oder Tabelle, während die Aktualisierung durch Aufruf einer gespeicherten Prozedur erfolgt. Gespeicherte Prozeduren verwenden eine Liste von Parametern und geben einen Datensatz zurück, der die Sammlung von Tupeln enthält, die die Antwort bilden.

Jitterbit-Connector für gespeicherte Excel Prozeduren

ArbeitsblattErstellen

Erstellt ein neues Arbeitsblatt in einer Excel-Arbeitsmappe. Wenn die Arbeitsmappe nicht vorhanden ist, wird die Arbeitsmappe ebenfalls erstellt.

Eingang

Ergebnissatzspalten

GetOAuthAccessToken

Erhält den OAuth-Zugriffstoken, der zur Authentifizierung mit Speicherquellen unter Verwendung von OAuth verwendet werden soll.

Eingang

Ergebnissatzspalten

GetOAuthAuthorizationURL

Ruft die OAuth-Autorisierungs URL ab, die für die Authentifizierung bei Speicherquellen unter Verwendung von OAuth verwendet wird.

Eingang

Ergebnissatzspalten

Aktualisieren Sie das OAuthAccessToken

Tauscht ein Aktualisierungstoken gegen ein neues Zugriffstoken aus.

Eingang

Ergebnissatzspalten

Systemtabellen

Sie können die in diesem Abschnitt beschriebenen Systemtabellen Abfrage, um auf Schema, Informationen zur Datenquellenfunktionalität und Statistiken zu Operation Charge.

Schematabellen

Die folgenden Tabellen geben Datenbankmetadaten für Excel zurück:

• sys_catalogs: Listet die verfügbaren Datenbanken auf.
• sys_schemas: Listet die verfügbaren Schemata auf.
• sys_tables: Listet die verfügbaren Tabellen und Ansichten auf.
• sys_tablecolumns: Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.
• sys_procedures: Beschreibt die verfügbaren gespeicherten Prozeduren.
• sys_procedureparameters: Beschreibt Parameter gespeicherter Prozeduren.
• sys_keycolumns: Beschreibt die Primär- und Fremdschlüssel.
• sys_indexes: Beschreibt die verfügbaren Indizes.

Datenquellentabellen

Die folgenden Tabellen enthalten Informationen dazu, wie eine Verbindung zur Datenquelle hergestellt und diese Abfrage wird:

• sys_connection_props: Gibt Informationen zu den verfügbaren Verbindungseigenschaften zurück.
• sys_sqlinfo: Beschreibt die SELECT-Abfragen, die der Connector an die Datenquelle auslagern kann.

Abfrageinformationstabellen

Die folgende Tabelle gibt Abfrage für Datenänderungsabfragen zurück:

• Systemidentität: Gibt Informationen zu Charge oder einzelnen Updates zurück.

Sys_catalogs

Listet die verfügbaren Datenbanken auf.

Die folgende Abfrage ruft alle durch die Verbindungszeichenfolge ermittelten Datenbanken ab:

SELECT * FROM sys_catalogs

Spalten

Sys_schemas

Listet die verfügbaren Schemas auf.

Die folgende Abfrage ruft alle verfügbaren Schemata ab:

SELECT * FROM sys_schemas

Spalten

Sys_tables

Listet die verfügbaren Tabellen auf.

Die folgende Abfrage ruft die verfügbaren Tabellen und Ansichten ab:

SELECT * FROM sys_tables

Spalten

Sys_tablecolumns

Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.

Die folgende Abfrage gibt die Spalten und Datentypen für die Sheet-Tabelle zurück:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Sheet'

Spalten

Sys_procedures

Listet die verfügbaren gespeicherten Prozeduren auf.

Die folgende Abfrage ruft die verfügbaren gespeicherten Prozeduren ab:

SELECT * FROM sys_procedures

Spalten

Sys_procedureparameters

Beschreibt Parameter gespeicherter Prozeduren.

Die folgende Abfrage gibt Informationen zu allen Eingabeparametern für die gespeicherte Prozedur CreateWorksheet zurück:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='CreateWorksheet' AND Direction=1 OR Direction=2

Spalten

Sys_keycolumns

Beschreibt die Primär- und Fremdschlüssel.

Die folgende Abfrage ruft den Primärschlüssel für die Sheet-Tabelle ab:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Sheet'

Spalten

Sys_foreignkeys

Beschreibt die Fremdschlüssel.

Die folgende Abfrage ruft alle Fremdschlüssel ab, die auf andere Tabellen verweisen:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

Spalten

Sys_indexes

Beschreibt die verfügbaren Indizes. Durch das Filtern nach Indizes können Sie selektivere Abfragen mit schnelleren Abfrage schreiben.

Die folgende Abfrage ruft alle Indizes ab, die keine Primärschlüssel sind:

SELECT * FROM sys_indexes WHERE IsPrimary='false'

Spalten

Sys_connection_props

Gibt Informationen zu den verfügbaren Verbindungseigenschaften und den in der Verbindungszeichenfolge festgelegten Eigenschaften zurück.

Bei der Abfrage dieser Tabelle sollte die Konfigurationsverbindungszeichenfolge verwendet werden:

jdbc:cdata:excel:config:

Mit dieser Verbindungszeichenfolge können Sie diese Tabelle ohne eine gültige Verbindung Abfrage.

Die folgende Abfrage ruft alle Verbindungseigenschaften ab, die in der Verbindungszeichenfolge festgelegt oder über einen Standardwert gesetzt wurden:

SELECT * FROM sys_connection_props WHERE Value <> ''

Spalten

Sys_sqlinfo

Beschreibt die SELECT- Abfrage, die der Connector an die Datenquelle auslagern kann.

Gemeinsame Abfrageverarbeitung

Wenn Sie mit Datenquellen arbeiten, die SQL-92 nicht unterstützen, können Sie die Ansicht sys_sqlinfo Abfrage, um die Abfrage der zugrunde liegenden APIs in SQL-Syntax zu ermitteln. Der Connector verlagert so viel wie möglich von der Verarbeitung der SELECT-Anweisung auf den Server und verarbeitet den Rest der Abfrage dann im Speicher.

Entdecken der SELECT-Funktionen der Datenquelle

Nachfolgend sehen Sie einen Beispieldatensatz mit SQL-Funktionen. Der folgende Ergebnissatz zeigt die SELECT-Funktionalität an, die der Connector auf die Datenquelle oder die Prozessclientseite auslagern kann. Ihre Datenquelle unterstützt möglicherweise zusätzliche SQL-Syntax. Einige Aspekte der SELECT-Funktionalität werden in einer durch Kommas getrennten Liste zurückgegeben, sofern sie unterstützt werden; andernfalls enthält die Spalte NO.

Die folgende Abfrage ruft die Operatoren ab, die in der WHERE-Klausel verwendet werden können:

SELECT * FROM sys_sqlinfo WHERE Name='SUPPORTED_OPERATORS'

Beachten Sie, dass einzelne Tabellen unterschiedliche Einschränkungen oder Anforderungen an die WHERE-Klausel haben können; siehe Datenmodell Abschnitt für weitere Informationen.

Spalten

Systemidentität

Gibt Informationen zu versuchten Änderungen zurück.

Die folgende Abfrage ruft die IDs der geänderten Zeilen in einer Operation Charge:

SELECT * FROM sys_identity

Spalten

Erweiterte Konfigurationseigenschaften

Die erweiterten Konfigurationseigenschaften sind die verschiedenen Optionen, die zum Herstellen einer Verbindung verwendet werden können. Dieser Abschnitt enthält eine vollständige Liste der Optionen, die Sie konfigurieren können. Klicken Sie auf die Links, um weitere Einzelheiten zu erfahren.

Authentifizierung

Verbindung

AWS-Authentifizierung

Azure-Authentifizierung

SSO

Daten

OAuth

JWT OAuth

Kerberos

SSL

SSH

Schema

Verschiedenes

Authentifizierung

Dieser Abschnitt enthält eine vollständige Liste der Authentifizierungseigenschaften, die Sie konfigurieren können.

AuthScheme

Die Art der Authentifizierung, die bei der Verbindung mit Remote-Diensten verwendet werden soll.

Mögliche Werte

None, Basic, Auto, Digest, NTLM, Negotiate, OAuth, OAuthJWT, SFTP, FTP, SSLCertificate, AwsRootKeys, AwsIAMRoles, AwsEC2Roles, AwsMFA, AwsTempCredentials, AwsCredentialsFile, AzureAD, AzureServicePrincipal, AzureMSI, OKTA, ADFS, OneLogin, PingFederate, HMAC

Datentyp

string

Standardwert

None

Hinweise

Allgemein

Die folgenden Optionen sind grundsätzlich für alle Verbindungen verfügbar:

• Keine: Verwendet keine Authentifizierung.
• Einfach: Verwendet die einfache Authentifizierung mit Benutzer und Passwort.
• Auto: Bestimmt die richtige Authentifizierungsart basierend auf dem Dienst. Lokale Dateien und HTTP verwenden Keine.

HTTP

Die folgenden Optionen sind verfügbar, wenn URI bezieht sich auf einen Webdienst:

• Digest: Verwendet HTTP-Digest-Authentifizierung mit Benutzer und Passwort.
• NTLM: Verwendet NTLM-Authentifizierung mit Benutzer und Passwort auf Ihre Windows Anmeldeinformationen eingestellt.
• Aushandeln: Verhandelt mit dem Server, um ein Authentifizierungsschema festzulegen. Wird normalerweise mit Kerberos verwendet, was KerberosKDC erfordert, KerberosRealm und KerberosSPN.
• OAuth: Verwendet entweder OAuth1 oder OAuth2, wobei der spezifische Ablauf durch den OAuthGrantType bestimmt wird. OAuthVersion muss festgelegt werden, um zu bestimmen, welche Version von OAuth verwendet wird.
• SSL: Verwendet SSL-Client-Zertifikate zur Authentifizierung. Erfordert, dass URI auf eine HTTPS URL eingestellt sein und dass SSLClientCert und SSLClientCertType eingestellt werden.

AWS

Die folgenden Optionen sind auch verfügbar, wenn URI verweist auf einen Amazon-Dienst:

• AwsRootKeys: Legen Sie dies fest, um den Zugriffsschlüssel und das Geheimnis des Root-Benutzers zu verwenden. Nützlich für schnelle Tests, aber in Produktionsfällen wird empfohlen, etwas mit eingeschränkten Berechtigungen zu verwenden.
• AwsIAMRoles: Eingestellt, um IAM-Rollen für die Verbindung zu verwenden.
• AwsEC2Roles: Legen Sie dies fest, um automatisch IAM-Rollen zu verwenden, die der EC2-Maschine zugewiesen sind, auf der der Jitterbit Connector für Excel derzeit ausgeführt wird.
• AwsMFA: Auf Verwendung der Multi-Faktor-Authentifizierung einstellen.
• OKTA: Eingestellt auf die Verwendung einer Single Sign-On-Verbindung mit OKTA als Identitätsanbieter.
• ADFS: Eingestellt auf die Verwendung einer Single Sign-On-Verbindung mit ADFS als Identitätsanbieter.
• Microsoft Entra ID: Eingestellt auf die Verwendung einer Single Sign-On-Verbindung mit der Microsoft Entra ID als Identitätsanbieter.
• AwsTempCredentials: Legen Sie dies fest, um für die Verbindung temporäre Sicherheitsanmeldeinformationen zusammen mit einem Sitzungstoken zu nutzen.
• AwsCredentialsFile: Einrichten, um eine Anmeldeinformationsdatei für die Authentifizierung zu verwenden.

Azure

Die folgenden Optionen sind auch verfügbar, wenn URI verweist auf einen Azure-Dienst:

• Microsoft Entra ID: Legen Sie dies fest, um die Microsoft Entra ID OAuth-Authentifizierung durchzuführen.
• AzureServicePrincipal: Legen Sie dies fest, um die Authentifizierung als Microsoft Entra-Dienstprinzipal durchzuführen.
• AzureMSI: Legen Sie dies fest, um beim Ausführen auf einer Azure-VM automatisch Anmeldeinformationen für die verwaltete Dienstidentität abzurufen.

SharePoint

Die folgenden Optionen sind auch verfügbar, wenn URI verweist auf einen SharePoint-SOAP Dienst:

• OKTA: Eingestellt auf die Verwendung einer Single Sign-On-Verbindung mit OKTA als Identitätsanbieter.
• ADFS: Eingestellt auf die Verwendung einer Single Sign-On-Verbindung mit ADFS als Identitätsanbieter.
• OneLogin: Eingestellt auf die Verwendung einer Single Sign-On-Verbindung mit OneLogin als Identitätsanbieter.
• PingFederate: Eingestellt auf die Verwendung einer Single Sign-On-Verbindung mit PingFederate als Identitätsanbieter.

IBM Cloud Object Storage

Die folgenden Optionen sind auch verfügbar, wenn URI verweist auf einen IBM Cloud Object Storage-Dienst:

• OAuth: Verwendet entweder OAuth, wobei der spezifische Ablauf durch InitiateOAuth bestimmt wird. ApiKey muss gesetzt sein, um diesen Ablauf erfolgreich abzuschließen.
• HMAC: Verwendet AccessKey und SecretKey, um sich beim IBM Cloud Object Storage Service zu authentifizieren.

Benutzer

Das zur Authentifizierung verwendete Excel Benutzerkonto.

Datentyp

string

Standardwert

""

Hinweise

Zusammen mit Passwort, wird dieses Feld zur Authentifizierung gegenüber dem Excel Server verwendet.

Passwort

Das zur Authentifizierung des Benutzers verwendete Passwort.

Datentyp

string

Standardwert

""

Hinweise

Der Benutzer Und Password werden zusammen zur Authentifizierung beim Server verwendet.

SharePoint-Edition

Die verwendete SharePoint-Edition. Legen Sie entweder SharePointOnline oder SharePointOnPremise fest.

Mögliche Werte

SharePointOnline, SharePointOnPremise

Datentyp

string

Standardwert

SharePointOnline

Hinweise

Die verwendete SharePoint-Edition. Legen Sie entweder SharePointOnline oder SharePointOnPremise fest.

Verbindung

Dieser Abschnitt enthält eine vollständige Liste der Verbindungseigenschaften, die Sie konfigurieren können.

URI

Der Uniform Resource Identifier (URI) für den Excel Ressourcenspeicherort.

Datentyp

string

Standardwert

""

Hinweise

Setzen Sie die URI-Eigenschaft zum Angeben eines Pfads zu einer Datei oder einem Stream.

Nachfolgend finden Sie Beispiele für die URIFormate für die verfügbaren Datenquellen:

Beispiele für Verbindungszeichenfolgen und Abfragen

Nachfolgend finden Sie Beispielverbindungszeichenfolgen für Excel Dateien oder-Streams.

Tabellen definieren

Ordnen Sie Excel Bereiche Tabellennamen zu.

Datentyp

string

Standardwert

""

Hinweise

Mit dieser Eigenschaft können Sie Bereiche in einer Excel Tabelle explizit definieren, die als Tabellen angezeigt werden. Der Connector erkennt Tabellen für Tabellen und benannte Bereiche automatisch.

Zuordnen von Tabellennamen zu Bereichen

Der DefineTablesWert ist eine durch Kommas getrennte Liste von Name-Wert-Paaren in der Form [Tabellenname]=[Blattname]![Bereich]. Tabellenname ist der Name der Tabelle, die Sie für die Daten verwenden möchten und der bei Abfragen verwendet wird. Blattname ist der Name des Blatts in der Excel-Tabelle und Bereich ist der Zellbereich, der die Daten für die Tabelle enthält.

Hier ist ein Beispiel für einen DefineTables-Wert: DefineTables="Table1=Sheet1!A1:N25,Table2=Sheet2!C3:M53"

Kopfbereich

Gibt an, ob die erste Zeile als Header verwendet werden soll.

Datentyp

string

Standardwert

true

Hinweise

Wenn wahr, wird die erste Zeile als Header verwendet. Andernfalls werden die Pseudospaltennamen A, B, C usw. verwendet.

Wenn Sie Blätter von dieser Regel ausschließen möchten, können Sie Folgendes festlegen: Header=True, Blatt1=False (bedeutet, dass die Headern für alle Blätter außer Blatt1 „true“ sind)

Orientierung

Gibt an, ob die Daten in Excel horizontal oder vertikal angeordnet sind.

Mögliche Werte

Horizontal, Vertical

Datentyp

string

Standardwert

Vertical

Hinweise

Standardmäßig modelliert der Connector vertikal ausgerichtete Tabellendaten - Zeilen, die vertikal unter einer Header angeordnet sind.

Stellen Sie dies auf „Horizontal“ ein, wenn die Zeilen von links nach rechts angeordnet sind. Die erste Spalte enthält die Spaltennamen und die nachfolgenden Spalten werden zu Zeilen.

Die Header-Eigenschaft wird in Verbindung mit der Orientation-Eigenschaft verwendet. Wenn Header auf „false“ und Orientation auf „Columns“ eingestellt ist, werden Spaltennamen als R1, R2, R3 usw. gemeldet.

Wenn Sie Blätter von dieser Regel ausschließen möchten, können Sie Folgendes festlegen: Ausrichtung=Horizontal, Blatt1=vertikal (bedeutet, die Ausrichtung ist für alle Blätter außer Blatt1 auf horizontal eingestellt)

ExcelDatei

Der Speicherort einer Excel Datei.

Datentyp

string

Standardwert

""

Hinweise

Diese Eigenschaft ist veraltet und wird durch URI ersetzt.

Ein Pfad, der auf eine Excel Datei verweist. Die Datei muss vorhanden sein. Der Connector implementiert Unterstützung für Office Open XML-Tabellen, die von Excel 2007 und höher verwendet werden.

Pufferänderungen

Gibt an, ob Änderungen an den Daten im Speicher gehalten werden sollen, bis die Verbindung geschlossen wird.

Datentyp

bool

Standardwert

true

Hinweise

Gibt an, ob Änderungen an den Daten im Speicher gehalten werden sollen, bis die Verbindung geschlossen wird. Wenn Sie dies auf „false“ setzen, werden die Änderungen sofort geschrieben, aber bei vielen Anfragen kommt es zu Leistungseinbußen, da die Datei wiederholt geöffnet und geschlossen werden muss.

Region

Die Hosting-Region für Ihre S3-ähnlichen Webdienste.

Datentyp

string

Standardwert

""

Hinweise

Die Hosting-Region für Ihre S3-ähnlichen Webdienste.

Oracle Cloud Object Storage-Regionen

Wasabi-Regionen

ProjektID

Die ID des Projekts, in dem sich Ihre Google Cloud Storage Instanz befindet.

Datentyp

string

Standardwert

""

Hinweise

Die ID des Projekts, in dem sich Ihre Google Cloud Storage Instanz befindet. Sie finden diesen Wert, indem Sie zur Google Cloud Console gehen und oben links auf dem Bildschirm auf den Projektnamen klicken. Die Projekt-ID wird in der ID-Spalte des entsprechenden Projekts angezeigt.

OracleNamespace

Der zu verwendende Oracle Cloud Object Storage-Namespace.

Datentyp

string

Standardwert

""

Hinweise

Der zu verwendende Oracle Cloud Object Storage-Namespace. Diese Einstellung muss auf den Oracle Cloud Object Storage-Namespace gesetzt werden, der dem Oracle Cloud-Konto zugeordnet ist, bevor Anforderungen gestellt werden können. Weitere Informationen finden Sie unter Object Storage-Namespaces verstehen der Oracle Cloud-Dokumentation finden Sie Anweisungen zum Suchen des Object Storage-Namespace Ihres Kontos.

Speicherbasis-URL

Die URL eines Cloud-Speicherdienstanbieters.

Datentyp

string

Standardwert

""

Hinweise

Mit dieser Verbindungseigenschaft können Sie Folgendes angeben:

• Die URL eines benutzerdefinierten S3-Dienstes

• Die für den Sharepoint SOAP /REST-Cloud-Speicherdienstanbieter erforderliche URL.

  Wenn die Domäne für diese Option mit endet -my (Zum Beispiel, https://bigcorp-my.sharepoint.com) dann müssen Sie möglicherweise die onedrive:// Schema anstelle der sp:// oder sprest:// Schema.

UseVirtualHosting

Wenn „true“ (Standard), werden Buckets in der Anfrage mithilfe der gehosteten Anfrage referenziert: http://yourbucket.s3.amazonaws.com/yourobject. Wenn der Wert auf „false“ gesetzt ist, verwendet die Bean die Pfad-Anforderung: http://s3.amazonaws.com/yourbucket/yourobject. Beachten Sie, dass diese Eigenschaft bei einem S3-basierten benutzerdefinierten Dienst auf „false“ gesetzt wird, wenn die CustomURL angegeben ist.

Datentyp

bool

Standardwert

true

Hinweise

Wenn „true“ (Standard), werden Buckets in der Anfrage mithilfe der gehosteten Anfrage referenziert: http://yourbucket.s3.amazonaws.com/yourobject. Wenn der Wert auf „false“ gesetzt ist, verwendet die Bean die Pfad-Anforderung: http://s3.amazonaws.com/yourbucket/yourobject. Beachten Sie, dass diese Eigenschaft bei einem S3-basierten benutzerdefinierten Dienst auf „false“ gesetzt wird, wenn die CustomURL angegeben ist.

AWS-Authentifizierung

Dieser Abschnitt enthält eine vollständige Liste der AWS-Authentifizierungseigenschaften, die Sie konfigurieren können.

AWSAccessKey

Ihr AWS-Kontozugriffsschlüssel. Auf diesen Wert kann über die Seite mit den AWS-Sicherheitsanmeldeinformationen zugegriffen werden.

Datentyp

string

Standardwert

""

Hinweise

Ihr AWS-Kontozugriffsschlüssel. Auf diesen Wert können Sie über Ihre AWS-Sicherheitsanmeldeinformationen-Seite zugreifen:

1. Melden Sie sich mit den Anmeldeinformationen für Ihr Root-Konto bei der AWS-Verwaltungskonsole an.

2. Wählen Sie Ihren Kontonamen oder Ihre Kontonummer und wählen Sie im angezeigten Menü „Meine Sicherheitsanmeldeinformationen“.

3. Klicken Sie auf „Weiter zu Sicherheitsanmeldeinformationen“ und erweitern Sie den Abschnitt „Zugriffsschlüssel“, um Zugriffsschlüssel für Root-Konten zu verwalten oder zu erstellen.

AWSGeheimer Schlüssel

Ihr geheimer AWS-Kontoschlüssel. Auf diesen Wert können Sie über Ihre AWS-Sicherheitsanmeldeinformationenseite zugreifen.

Datentyp

string

Standardwert

""

Hinweise

Ihr geheimer AWS-Kontoschlüssel. Auf diesen Wert können Sie über Ihre AWS-Sicherheitsanmeldeinformationen-Seite zugreifen:

1. Melden Sie sich mit den Anmeldeinformationen für Ihr Root-Konto bei der AWS-Verwaltungskonsole an.

2. Wählen Sie Ihren Kontonamen oder Ihre Kontonummer und wählen Sie im angezeigten Menü „Meine Sicherheitsanmeldeinformationen“.

3. Klicken Sie auf „Weiter zu Sicherheitsanmeldeinformationen“ und erweitern Sie den Abschnitt „Zugriffsschlüssel“, um Zugriffsschlüssel für das Root-Konto zu verwalten oder zu erstellen.

AWSRoleARN

Der Amazon-Ressourcenname der Rolle, die bei der Authentifizierung verwendet werden soll.

Datentyp

string

Standardwert

""

Hinweise

Bei der Authentifizierung außerhalb von AWS ist es üblich, anstelle der direkten AWS-Kontoanmeldeinformationen eine Rolle zur Authentifizierung zu verwenden. Durch Eingabe der AWSRoleARN bewirkt, dass der Jitterbit Connector für Excel eine Rolle Authentifizierung durchführt, anstatt den AWSAccessKey zu verwenden und AWSSecretKey direkt. Der AWSAccessKey und AWSSecretKey muss noch angegeben werden, um diese Authentifizierung durchzuführen. Sie können beim Festlegen von RoleARN nicht die Anmeldeinformationen eines AWS-Root-Benutzers verwenden. Der AWSAccessKey und AWSSecretKey müssen die eines IAM-Benutzers sein.

AWSPrincipalARN

Die ARN des SAML Identitätsanbieters in Ihrem AWS-Konto.

Datentyp

string

Standardwert

""

Hinweise

Die ARN des SAML Identitätsanbieters in Ihrem AWS-Konto.

AWSRegion

Die Hosting-Region für Ihre Amazon Web Services.

Mögliche Werte

OHIO, NORTHERNVIRGINIA, NORTHERNCALIFORNIA, OREGON, CAPETOWN, HONGKONG, MUMBAI, OSAKA, SEOUL, SINGAPORE, SYDNEY, TOKYO, CENTRAL, BEIJING, NINGXIA, FRANKFURT, IRELAND, LONDON, MILAN, PARIS, STOCKHOLM, BAHRAIN, SAOPAULO, GOVCLOUDEAST, GOVCLOUDWEST

Datentyp

string

Standardwert

NORTHERNVIRGINIA

Hinweise

Die Hosting-Region für Ihre Amazon Web Services. Verfügbare Werte sind OHIO, NORTHERNVIRGINIA, NORTHERNCALIFORNIA, OREGON, CAPETOWN, HONGKONG, MUMBAI, OSAKA, SEOUL, SINGAPUR, SYDNEY, TOKIO, CENTRAL, PEKING, NINGXIA, FRANKFURT, IRLAND, LONDON, MAILAND, PARIS, STOCKHOLM, BAHRAIN, SAOPAULO, GOVCLOUDEAST und GOVCLOUDWEST.

AWSSessionToken

Ihr AWS-Sitzungstoken.

Datentyp

string

Standardwert

""

Hinweise

Ihr AWS-Sitzungstoken. Dieser Wert kann auf verschiedene Arten abgerufen werden. Siehe diesen Link für weitere Informationen.

MFASeriennummer

Die Seriennummer des MFA-Geräts, falls eines verwendet wird.

Datentyp

string

Standardwert

""

Hinweise

Sie können das Gerät für einen IAM-Benutzer finden, indem Sie zur AWS Management Console gehen und die Sicherheitsanmeldeinformationen des Benutzers anzeigen. Bei virtuellen Geräten ist dies tatsächlich ein Amazon-Ressourcenname (z. B. arn:aws:iam:123456789012:mfa/user).

MFAToken

Das temporäre Token, das von Ihrem MFA-Gerät verfügbar ist.

Datentyp

string

Standardwert

""

Hinweise

Wenn MFA erforderlich ist, wird dieser Wert zusammen mit der MFASerialNumber verwendet, um temporäre Anmeldeinformationen abzurufen. Die von AWS verfügbaren temporären Anmeldeinformationen sind standardmäßig nur bis zu 1 Stunde gültig (siehe TemporaryTokenDuration). Sobald die Zeit abgelaufen ist, muss die Verbindung aktualisiert werden, um ein neues MFA-Token anzugeben, damit neue Anmeldeinformationen abgerufen werden können. %AWSpSecurityToken; %AWSpTemporaryTokenDuration;

Azure Authentifizierung

Dieser Abschnitt enthält eine vollständige Liste der Azure-Authentifizierungseigenschaften, die Sie konfigurieren können.

AzureStorageAccount

Der Name Ihres Azure-Speicherkontos.

Datentyp

string

Standardwert

""

Hinweise

Der Name Ihres Azure-Speicherkontos.

AzureAccessKey

Der Speicherschlüssel, der Ihrem Excel-Konto zugeordnet ist.

Datentyp

string

Standardwert

""

Hinweise

Der Speicherschlüssel, der mit Ihrem Excel-Konto verknüpft ist. Sie können ihn wie folgt abrufen:

1. Melden Sie sich mit den Anmeldeinformationen für Ihr Root-Konto beim Azure-Portal an. (https://portal.azure.com/ )
2. Klicken Sie auf Speicherkonten und wählen Sie das Speicherkonto aus, das Sie verwenden möchten.
3. Klicken Sie unter „Einstellungen“ auf Zugriffsschlüssel.
4. Der Name und Schlüssel Ihres Speicherkontos werden auf dieser Seite angezeigt.

AzureSharedAccessSignature

Eine gemeinsam genutzte Zugriffsschlüsselsignatur, die zur Authentifizierung verwendet werden kann.

Datentyp

string

Standardwert

""

Hinweise

Eine Shared Access Signature. Sie können eine erstellen, indem Sie die folgenden Schritte ausführen:

1. Melden Sie sich mit den Anmeldeinformationen für Ihr Root-Konto beim Azure-Portal an. (https://portal.azure.com/)
2. Klicken Sie auf Speicherkonten und wählen Sie das Speicherkonto aus, das Sie verwenden möchten.
3. Klicken Sie unter Einstellungen auf Shared Access Signature.
4. Legen Sie die Berechtigungen fest und geben Sie an, wann das Token abläuft.
5. Klicken Sie auf SAS generieren, um das Token zu kopieren.

AzureTenant

Der Microsoft Online-Mandant, der für den Datenzugriff verwendet wird. Wenn nicht angegeben, wird Ihr Standardmandant verwendet.

Datentyp

string

Standardwert

""

Hinweise

Der Microsoft Online-Mandant, der für den Datenzugriff verwendet wird. Beispiel: contoso.onmicrosoft.com. Alternativ können Sie die Mandanten-ID angeben. Dieser Wert ist die Verzeichnis-ID im Azure-Portal > Microsoft Entra ID > Eigenschaften.

Normalerweise ist es nicht notwendig, den Mandanten anzugeben. Dies kann von Microsoft automatisch ermittelt werden, wenn der OAuthGrantType verwendet wird auf CODE (Standard) eingestellt. Es kann jedoch fehlschlagen, wenn der Benutzer mehreren Mandanten angehört. Zum Beispiel, wenn ein Administrator von Domäne A einen Benutzer von Domäne B als Gastbenutzer einlädt. Der Benutzer gehört nun beiden Mandanten an. Es ist eine gute Praxis, den Mandanten anzugeben, obwohl es im Allgemeinen funktionieren sollte, ohne ihn angeben zu müssen.

AzureTenant ist beim Festlegen von OAuthGrantType erforderlich zu CLIENT. Bei der Verwendung von Client-Anmeldeinformationen gibt es keinen Benutzerkontext. Die Anmeldeinformationen werden aus dem Kontext der App selbst übernommen. Microsoft erlaubt zwar weiterhin den Abruf von Client-Anmeldeinformationen ohne Angabe des Mandanten, aber die Wahrscheinlichkeit, den spezifischen Mandanten auszuwählen, mit dem Sie arbeiten möchten, ist viel geringer. Aus diesem Grund benötigen wir AzureTenant muss bei allen Client-Anmeldeinformationen-Verbindungen explizit angegeben werden, um sicherzustellen, dass Sie Anmeldeinformationen erhalten, die für die Domäne gelten, mit der Sie eine Verbindung herstellen möchten.

Azure-Umgebung

Die beim Herstellen einer Verbindung zu verwendende Azure-Umgebung.

Mögliche Werte

GLOBAL, CHINA, GERMANY, USGOVT, USGOVTDOD

Datentyp

string

Standardwert

GLOBAL

Hinweise

In den meisten Fällen funktioniert es, die Umfeld auf global eingestellt zu lassen. Wenn Ihr Azure-Konto jedoch einer anderen Umfeld hinzugefügt wurde, wird die AzureEnvironment kann verwendet werden, um die Umfeld anzugeben. Die verfügbaren Werte sind GLOBAL, CHINA, GERMANY, USGOVT und USGOVTDOD.

SSO

Dieser Abschnitt enthält eine vollständige Liste der SSO-Eigenschaften, die Sie konfigurieren können.

SSOLoginURL

Die Anmelde-URL des Identitätsanbieters.

Datentyp

string

Standardwert

""

Hinweise

Die Anmelde-URL des Identitätsanbieters.

SSO-Eigenschaften

Zusätzliche Eigenschaften, die für die Verbindung mit dem Identitätsanbieter erforderlich sind, in einer durch Semikolon getrennten Liste.

Datentyp

string

Standardwert

""

Hinweise

Zusätzliche Eigenschaften, die für die Verbindung mit dem Identitätsanbieter erforderlich sind, in einer durch Semikolon getrennten Liste. wird in Verbindung mit der SSOLoginURL verwendet.

Die SSO-Konfiguration wird weiter unten erläutert.

Daten

Dieser Abschnitt enthält eine vollständige Liste der Dateneigenschaften, die Sie konfigurieren können.

Formel zulassen

Ob Werte, die mit einem Gleichheitszeichen (=) beginnen, bei Einfügungen und Aktualisierungen als Formeln behandelt werden sollen oder nicht.

Datentyp

bool

Standardwert

true

Hinweise

Setzen Sie diesen Wert auf „true“, um Werte, die mit einem Gleichheitszeichen (=) beginnen, bei Einfügungen und Aktualisierungen als Formeln zu behandeln. Setzen Sie den Wert auf „false“, um alle bei Einfügungen und Aktualisierungen verwendeten Werte als Zeichenfolgen zu behandeln.

LeererWertModus

Gibt an, ob die leeren Werte als leer oder als Null gelesen werden sollen.

Mögliche Werte

ReadAsEmpty, ReadAsNull

Datentyp

string

Standardwert

ReadAsEmpty

Hinweise

Mögliche Werte sind ReadAsEmpty und ReadAsNull. Ein leerer Wert ist eine Zelle, die eine leere Zeichenfolge enthält (z. B. =""), was sich von einer Zelle unterscheidet, die nicht gesetzt wurde und daher eine Nullzeichenfolge enthält.

Nullwerte

Eine durch Kommas getrennte Liste, die durch Nullen ersetzt wird, wenn diese in der CSV-Datei gefunden werden.

Datentyp

string

Standardwert

""

Hinweise

Eine durch Kommas getrennte Liste, die durch Nullen ersetzt wird, wenn sie in der CSV-Datei gefunden werden. Beispiel: „NaN,\N,N/A“. Wenn einer der angegebenen Werte in einer CSV-Zeile gefunden wird, wird er als Null ausgegeben.

Berechnungsfehler ignorieren

Gibt an, ob während der Berechnung aufgetretene Fehler ignoriert werden sollen.

Datentyp

bool

Standardwert

false

Hinweise

IgnoreCalcError ist standardmäßig auf „false“ eingestellt. Wenn IgnoreCalcError auf „true“ gesetzt ist, ignoriert der Anbieter alle Fehler, die aufgrund der Formelberechnung auftreten. In diesem Fall ist das Formelergebnis möglicherweise unzuverlässig, andere Daten sind jedoch korrekt.

NullValueMode

Gibt an, ob leere Zellen als Null oder als leer gelesen werden sollen.

Mögliche Werte

ReadAsNull, ReadAsEmpty

Datentyp

string

Standardwert

ReadAsNull

Hinweise

NullValueMode steuert, wie leere Excel Zellen modelliert werden. Eine leere Zelle ist eine Zelle, die nicht festgelegt wurde und daher eine Nullzeichenfolge enthält. Wenn NullValueMode auf ReadAsNull festgelegt ist, wird für eine leere Zelle NULL gemeldet. Wenn NullValueMode auf ReadAsEmpty festgelegt ist, wird für eine leere Zelle eine leere Zeichenfolge gemeldet.

HatCrossSheetReferences

Gibt an, wie mit blattübergreifenden Verweisen umgegangen wird.

Datentyp

bool

Standardwert

false

Hinweise

HasCrossSheetReferences steuert, wie blattübergreifende Verweise behandelt werden. Wenn blattübergreifende Verweise vorhanden sind, können Änderungen an einem Blatt dazu führen, dass einige andere Formeln in anderen Blättern neu berechnet werden. Wenn HasCrossSheetReferences auf „true“ gesetzt ist, werden alle Blätter in der Arbeitsmappe in den Speicher geladen und die blattübergreifenden Verweise behandelt. Das Setzen der Eigenschaft auf „true“ kann jedoch die Leistung beeinträchtigen, da alle Blätter aus der Excel Datei gelesen werden.

Dieser Wert sollte auf „true“ gesetzt werden, wenn Sie Aktualisierungen am Blatt vornehmen möchten. Wenn diese Option deaktiviert ist, generiert der Connector größere Dateien, da er freigegebene Daten nicht über mehrere Blätter hinweg wiederverwenden kann. Wenn diese Option jedoch deaktiviert ist, kann der Connector Daten über mehrere Blätter hinweg wiederverwenden und kleinere Dateien generieren.

Neu berechnen

Gibt an, ob beim Lesen der Daten alle Formeln neu berechnet werden sollen.

Datentyp

bool

Standardwert

true

Hinweise

Wenn Zellen in einem Excel Blatt geändert werden, ändern die Formelzellen ihren Wert. Wenn „Neu berechnen“ auf „true“ gesetzt ist, erkennt der Anbieter geänderte Zellen und berechnet die Formeln neu. Diese neuen Ergebnisse werden dann wieder in das Excel-Blatt aktualisiert, sodass eine Neuberechnung nicht erforderlich ist.

Leere Zeilen anzeigen

Gibt an, ob die leeren Zeilen verschoben werden sollen oder nicht.

Datentyp

bool

Standardwert

false

Hinweise

Wenn wahr, werden die leeren Zeilen bei der Ausgabe übertragen.

Typerkennungsschema

Bestimmt, wie der Anbieter die Datentypen von Spalten erkennt.

Mögliche Werte

None, RowScan, ColumnFormat, ColumnStyle

Datentyp

string

Standardwert

ColumnFormat

Hinweise

Aktivieren Sie OleDbCompatibility

Gibt an, ob die Daten mit demselben Verhalten wie der Microsoft OleDB Treiber gelesen werden sollen.

Datentyp

bool

Standardwert

false

Hinweise

Gibt an, ob die Daten mit demselben Verhalten wie der Microsoft OleDB Treiber gelesen werden sollen. Beispielsweise würde der Microsoft OleDB- Treiber die neue Zeile als „\n“ statt als „\r\n“ melden.

Verwenden Sie FastInsert

Gibt an, ob beim Ausführen der Insert-Anweisung FastInsert verwendet werden soll.

Datentyp

bool

Standardwert

false

Hinweise

FastInsert hat eine bessere Leistung als das normale Einfügen. FastInsert unterstützte jedoch die Insert-Anweisung mit der angegebenen ROWID nicht und speicherte die Einfügedaten nach der Ausführung der Insert-Anweisung in der Datei.

Überspringentop

Überspringt die angegebene Anzahl Zeilen, beginnend von oben.

Datentyp

int

Standardwert

0

Hinweise

Überspringt die angegebene Anzahl Zeilen, beginnend von oben.

Kundennamen einschließen

Gibt an, ob die definierten Namen gepusht werden sollen oder nicht.

Datentyp

bool

Standardwert

true

Hinweise

Wenn wahr, werden die definierten Namen gepusht.

OAuth

Dieser Abschnitt enthält eine vollständige Liste der OAuth-Eigenschaften, die Sie konfigurieren können.

OAuth initiieren

Legen Sie diese Eigenschaft fest, um den Prozess zum Abrufen oder Aktualisieren des OAuth-Zugriffstokens beim Herstellen einer Verbindung zu starten.

Mögliche Werte

OFF, GETANDREFRESH, REFRESH

Datentyp

string

Standardwert

OFF

Hinweise

Folgende Optionen stehen zur Verfügung:

1. OFF: Gibt an, dass der OAuth-Flow vollständig vom Benutzer gehandhabt wird. Zur Authentifizierung ist ein OAuthAccessToken erforderlich.
2. GETANDREFRESH: Gibt an, dass der gesamte OAuth-Flow vom Connector verarbeitet wird. Wenn derzeit kein Token vorhanden ist, wird es durch eine entsprechende Aufforderung an den Benutzer über den Browser abgerufen. Wenn ein Token vorhanden ist, wird es bei Bedarf aktualisiert.
3. REFRESH: Gibt an, dass der Connector nur das Aktualisieren des OAuthAccessToken übernimmt. Der Benutzer wird vom Connector nie aufgefordert, sich über den Browser zu authentifizieren. Der Benutzer muss zunächst das Abrufen des OAuthAccessToken und des OAuthRefreshToken übernehmen.

OAuthVersion

Die verwendete OAuth-Version.

Mögliche Werte

Disabled, 1.0, 2.0

Datentyp

string

Standardwert

Disabled

Hinweise

Die verwendete OAuth-Version. Folgende Optionen sind verfügbar: Deaktiviert, 1.0, 2.0

OAuthClientId

Die Client-ID, die zugewiesen wird, wenn Sie Ihre Anwendung bei einem OAuth-Autorisierungsserver registrieren.

Datentyp

string

Standardwert

""

Hinweise

Im Rahmen der Registrierung einer OAuth-Anwendung erhalten Sie die OAuthClientId-Wert, manchmal auch Consumer-Schlüssel genannt, und ein Client-Geheimnis, das OAuthClientSecret.

OAuthClientSecret

Das Client-Geheimnis, das zugewiesen wird, wenn Sie Ihre Anwendung bei einem OAuth-Autorisierungsserver registrieren.

Datentyp

string

Standardwert

""

Hinweise

Im Rahmen der Registrierung einer OAuth-Anwendung erhalten Sie die OAuthClientId, auch Consumer-Schlüssel genannt. Sie erhalten außerdem ein Client-Geheimnis, auch Consumer-Geheimnis genannt. Legen Sie das Client-Geheimnis im OAuthClientSecret Eigentum.

OAuth-Zugriffstoken

Der Zugriffstoken für die Verbindung per OAuth.

Datentyp

string

Standardwert

""

Hinweise

Der OAuthAccessToken Eigenschaft wird für die Verbindung über OAuth verwendet. Die OAuthAccessToken wird im Rahmen des Authentifizierungsprozesses vom OAuth-Server abgerufen. Es hat ein serverabhängiges Timeout und kann zwischen Anfragen wiederverwendet werden.

Das Zugriffstoken wird anstelle Ihres Benutzernamens und Passworts verwendet. Das Zugriffstoken schützt Ihre Anmeldeinformationen, indem es sie auf dem Server speichert.

OAuthSettingsLocation

Der Speicherort der Einstellungsdatei, in der OAuth-Werte gespeichert werden, wenn InitiateOAuth auf GETANDREFRESH oder REFRESH eingestellt ist. Alternativ können Sie diesen Speicherort im Speicher halten, indem Sie einen Wert angeben, der mit beginnt 'memory://'.

Datentyp

string

Standardwert

%APPDATA%\CData\Acumatica Data Provider\OAuthSettings.txt

Hinweise

Wenn InitiateOAuth ist auf gesetzt GETANDREFRESH oder REFRESH, der Treiber speichert OAuth-Werte, damit der Benutzer die OAuth-Verbindungseigenschaften nicht manuell eingeben muss und die Anmeldeinformationen über Verbindungen oder Prozesse hinweg gemeinsam genutzt werden können.

Anstatt einen Dateipfad anzugeben, können Sie auch den Speicherort angeben. Speicherorte werden durch einen Wert angegeben, der mit 'memory://' gefolgt von einer eindeutigen Kennung für diesen Satz von Anmeldeinformationen (z. B. memory://user1). Die Kennung können Sie frei wählen, sie sollte jedoch für den Benutzer eindeutig sein. Im Gegensatz zur dateibasierten Speicherung, bei der die Anmeldeinformationen über Verbindungen hinweg bestehen bleiben, werden die Anmeldeinformationen bei der Speicherspeicherung in den statischen Speicher geladen und die Anmeldeinformationen werden für die Dauer des Prozesses unter Verwendung derselben Kennung zwischen Verbindungen geteilt. Um die Anmeldeinformationen außerhalb des aktuellen Prozesses beizubehalten, müssen Sie die Anmeldeinformationen vor dem Schließen der Verbindung manuell speichern. Auf diese Weise können Sie sie in der Verbindung festlegen, wenn der Prozess erneut gestartet wird. Sie können OAuth-Eigenschaftswerte mit einer Abfrage an abrufen sys_connection_propsSystemtabelle. Wenn mehrere Verbindungen mit denselben Anmeldeinformationen bestehen, werden die Eigenschaften aus der zuvor geschlossenen Verbindung gelesen.

Der Standardspeicherort ist „%APPDATA%\CData\ Acumatica Data Provider\OAuthSettings.txt“ mit %APPDATA% auf das Konfigurationsverzeichnis des Benutzers gesetzt. Die Standardwerte sind

• Windows: "register://%DSN"
• Unix: "%AppData%..."

wobei DSN der Name des aktuellen DSN ist, der in der offenen Verbindung verwendet wird.

Die folgende Tabelle listet den Wert von auf %APPDATA% nach Operationssystem:

OAuthAccessTokenSecret

Das OAuth-Zugriffstoken-Geheimnis für die Verbindung über OAuth.

Datentyp

string

Standardwert

""

Hinweise

Der OAuthAccessTokenSecret Eigenschaft wird für die Verbindung und Authentifizierung mit OAuth verwendet. Die OAuthAccessTokenSecret wird im Rahmen des Authentifizierungsprozesses vom OAuth-Server abgerufen. Es wird mit dem OAuthAccessToken verwendet und kann für mehrere Anfragen verwendet werden, bis die Zeit abläuft.

Rückruf-URL

Die OAuth-Rückruf URL, zu der bei der Authentifizierung zurückgekehrt werden soll. Dieser Wert muss mit der Rückruf-URL übereinstimmen, die Sie in Ihren App-Einstellungen angeben.

Datentyp

string

Standardwert

""

Hinweise

Während des Authentifizierungsprozesses leitet der OAuth-Autorisierungsserver den Benutzer an diese URL weiter. Dieser Wert muss mit der Rückruf URL übereinstimmen, die Sie in Ihren App-Einstellungen angeben.

OAuthGrantType

Der Berechtigungstyp für den OAuth-Flow.

Mögliche Werte

CODE, CLIENT, PASSWORD

Datentyp

string

Standardwert

CLIENT

Hinweise

Der Berechtigungstyp für den OAuth-Flow. Folgende Optionen sind verfügbar: CODE,CLIENT,PASSWORT

OAuthPasswordGrantMode

So übergeben Sie Client-ID und Secret, wenn OAuthGrantType auf Passwort eingestellt ist.

Mögliche Werte

Post, Basic

Datentyp

string

Standardwert

Post

Hinweise

Der OAuth RFC spezifiziert zwei Methoden zur Übergabe der OAuthClientId und OAuthClientSecret bei Verwendung des Passworts OAuthGrantType. Am häufigsten werden sie über Post-Daten an den Dienst übergeben. Bei manchen Diensten ist es jedoch erforderlich, dass Sie sie über den Authorize-Header übergeben, damit sie in der BASIC-Autorisierung verwendet werden können. Ändern Sie diese Eigenschaft in „Basic“, um die Parameter als Teil des Authorize Header statt der Post-Daten zu übermitteln.

OAuthIncludeCallbackURL

Ob die Rückruf-URL in eine Zugriffstokenanforderung aufgenommen werden soll.

Datentyp

bool

Standardwert

true

Hinweise

Dies ist standardmäßig auf „true“ eingestellt, da standardkonforme OAuth-Dienste den Parameter „redirect_uri“ für Berechtigungstypen wie CLIENT oder PASSWORD ignorieren, die ihn nicht erfordern.

Diese Option sollte nur für OAuth-Dienste aktiviert werden, die Fehler melden, wenn „redirect_uri“ enthalten ist.

OAuthAuthorizationURL

Die Autorisierungs URL für den OAuth-Dienst.

Datentyp

string

Standardwert

""

Hinweise

Die Autorisierungs-URL für den OAuth-Dienst. Unter dieser URL meldet sich der Benutzer beim Server an und erteilt der Anwendung Berechtigungen. In OAuth 1.0 wird das Anforderungstoken autorisiert, wenn Berechtigungen erteilt werden.

OAuth-ZugriffstokenURL

Die URL, von der das OAuth-Zugriffstoken abgerufen werden soll.

Datentyp

string

Standardwert

""

Hinweise

Die URL, von der der OAuth-Zugriffstoken abgerufen werden soll. In OAuth 1.0 wird unter dieser URL der autorisierte Anforderungstoken gegen den Zugriffstoken ausgetauscht.

OAuthRefreshTokenURL

Die URL, von der das OAuth-Token aktualisiert werden soll.

Datentyp

string

Standardwert

""

Hinweise

Die URL, von der aus das OAuth-Token aktualisiert werden soll. In OAuth 2.0 wird unter dieser URL das Aktualisierungstoken gegen ein neues Zugriffstoken ausgetauscht, wenn das alte Zugriffstoken abläuft.

OAuthRequestTokenURL

Die vom Dienst bereitgestellte URL zum Abrufen von Anforderungstoken. Dies ist in OAuth 1.0 erforderlich.

Datentyp

string

Standardwert

""

Hinweise

Die vom Dienst bereitgestellte URL zum Abrufen von Anforderungstoken. Dies ist in OAuth 1.0 erforderlich. In OAuth 1.0 ist dies die URL, unter der die App eine Anforderung für das Anforderungstoken stellt.

OAuthVerifier

Der von der OAuth-Autorisierungs URL zurückgegebene Prüfcode.

Datentyp

string

Standardwert

""

Hinweise

Der von der OAuth-Autorisierungs URL zurückgegebene Prüfcode. Dieser kann auf Systemen verwendet werden, auf denen kein Browser gestartet werden kann, z. B. auf Headless-Systemen.

Authentifizierung auf Headless-Maschinen

Siehe, um die zu erhalten OAuthVerifier Wert.

OAuthSettingsLocation festlegen zusammen mit OAuthVerifier. Beim Verbinden tauscht der Connector die OAuthVerifier für die OAuth-Authentifizierungstoken und speichert sie verschlüsselt in der angegebenen Datei. Setzen Sie InitiateOAuth, um den Austausch mit GETANDREFRESH zu automatisieren.

Sobald die OAuth-Einstellungsdatei generiert wurde, können Sie entfernen OAuthVerifier aus den Verbindungseigenschaften und verbinden Sie sich mit OAuthSettingsLocation festgelegt.

Um die OAuth-Tokenwerte automatisch zu aktualisieren, legen Sie OAuthSettingsLocation fest und setzen Sie zusätzlich InitiateOAuth zum AKTUALISIEREN.

AuthToken

Das Authentifizierungstoken, das zum Anfordern und Abrufen des OAuth-Zugriffstokens verwendet wird.

Datentyp

string

Standardwert

""

Hinweise

Diese Eigenschaft ist nur erforderlich, wenn eine Headless-Authentifizierung in OAuth 1.0 durchgeführt wird. Sie kann aus der gespeicherten Prozedur GetOAuthAuthorizationUrl abgerufen werden.

Sie kann zusammen mit dem AuthKey bereitgestellt werden in der gespeicherten Prozedur GetOAuthAccessToken, um den OAuthAccessToken abzurufen.

Authentisierungsschlüssel

Das Authentifizierungsgeheimnis, das zum Anfordern und Abrufen des OAuth-Zugriffstokens verwendet wird.

Datentyp

string

Standardwert

""

Hinweise

Diese Eigenschaft ist nur erforderlich, wenn eine Headless-Authentifizierung in OAuth 1.0 durchgeführt wird. Sie kann aus der gespeicherten Prozedur GetOAuthAuthorizationUrl abgerufen werden.

Sie kann zusammen mit dem AuthToken bereitgestellt werden in der gespeicherten Prozedur GetOAuthAccessToken, um den OAuthAccessToken abzurufen.

OAuthParams

Eine durch Kommas getrennte Liste weiterer Parameter, die in der Anfrage für das OAuth-Zugriffstoken im Format Parametername=Wert übermittelt werden sollen.

Datentyp

string

Standardwert

""

Hinweise

Eine durch Kommas getrennte Liste weiterer Parameter, die in der Anfrage für das OAuth-Zugriffstoken im Format Parametername=Wert übermittelt werden sollen.

OAuthRefreshToken

Das OAuth-Aktualisierungstoken für das entsprechende OAuth-Zugriffstoken.

Datentyp

string

Standardwert

""

Hinweise

Der OAuthRefreshToken Eigenschaft wird verwendet, um den OAuthAccessToken zu aktualisieren bei Verwendung der OAuth-Authentifizierung.

OAuthLäuftAbIn

Die Lebensdauer des OAuth AccessToken in Sekunden.

Datentyp

string

Standardwert

""

Hinweise

Mit OAuthTokenTimestamp kombinieren, um zu bestimmen, wann der AccessToken abläuft.

OAuthTokenTimestamp

Der Unix-Epochenzeitstempel in Millisekunden, als das aktuelle Zugriffstoken erstellt wurde.

Datentyp

string

Standardwert

""

Hinweise

Kombinieren Sie es mit OAuthExpiresIn, um zu bestimmen, wann das AccessToken abläuft.

JWT OAuth

Dieser Abschnitt enthält eine vollständige Liste der JWT OAuth-Eigenschaften, die Sie konfigurieren können.

OAuthJWTCert

Der JWT-Zertifikatspeicher.

Datentyp

string

Standardwert

""

Hinweise

Der Name des Zertifikatspeichers für das Client-Zertifikat.

Der OAuthJWTCertType Feld gibt den Typ des durch angegebenen Zertifikatspeichers an OAuthJWTCert. Wenn der Store kennwortgeschützt ist, geben Sie das Kennwort in OAuthJWTCertPassword an.

OAuthJWTCert wird in Verbindung mit OAuthJWTCertSubject verwendet

Feld, um Client-Zertifikate anzugeben. Wenn OAuthJWTCert hat einen Wert und OAuthJWTCertSubject gesetzt ist, wird eine Suche nach einem Zertifikat eingeleitet. Bitte beachten Sie das OAuthJWTCertSubject für weitere Einzelheiten.

Die Bezeichnungen der Zertifikatsspeicher sind plattformabhängig.

Nachfolgend sind die Bezeichnungen der gebräuchlichsten Benutzer- und Maschinen-Zertifikatspeicher in Windows aufgeführt:

In Java ist der Zertifikatsspeicher normalerweise eine Datei, die Zertifikate und optionale private Schlüssel enthält.

Wenn der Zertifikatsspeichertyp PFXFile ist, muss diese Eigenschaft auf den Namen der Datei gesetzt werden. Wenn der Typ PFXBlob ist, muss die Eigenschaft auf den binären Inhalt einer PFX-Datei (d. h. PKCS12-Zertifikatsspeicher) gesetzt werden.

OAuthJWTCertType

Der Typ des Schlüsselspeichers, der das JWT-Zertifikat enthält.

Mögliche Werte

USER, MACHINE, PFXFILE, PFXBLOB, JKSFILE, JKSBLOB, PEMKEY_FILE, PEMKEY_BLOB, PUBLIC_KEY_FILE, PUBLIC_KEY_BLOB, SSHPUBLIC_KEY_FILE, SSHPUBLIC_KEY_BLOB, P7BFILE, PPKFILE, XMLFILE, XMLBLOB, GOOGLEJSON, GOOGLEJSONBLOB

Datentyp

string

Standardwert

USER

Hinweise

Diese Eigenschaft kann einen der folgenden Werte annehmen:

OAuthJWTCertPasswort

Das Passwort für das OAuth JWT-Zertifikat.

Datentyp

string

Standardwert

""

Hinweise

Wenn der Zertifikatspeicher von einem Typ ist, der ein Passwort erfordert, wird diese Eigenschaft verwendet, um dieses Passwort anzugeben, damit der Zertifikatspeicher geöffnet werden kann.

Dies ist nicht erforderlich, wenn GOOGLEJSON OAuthJWTCertType verwendet wird. Google JSON-Schlüssel sind nicht verschlüsselt.

OAuthJWTCertSubject

Der Betreff des OAuth JWT-Zertifikats.

Datentyp

string

Standardwert

*

Hinweise

Beim Laden eines Zertifikats wird der Betreff verwendet, um das Zertifikat im Speicher zu lokalisieren.

Wenn keine genaue Übereinstimmung gefunden wird, wird der Speicher nach Betreffs durchsucht, die den Wert der Eigenschaft enthalten.

Wenn immer noch keine Übereinstimmung gefunden wird, wird die Eigenschaft auf eine leere Zeichenfolge gesetzt und kein Zertifikat ausgewählt.

Der spezielle Wert „*“ wählt das erste Zertifikat im Zertifikatspeicher aus.

Der Betreff des Zertifikats ist eine durch Kommas getrennte Liste von Distinguished Name-Feldern und-Werten. Zum Beispiel „CN=www.server.com, OU=test, C=US, E=example@jbexample.com“. Allgemeine Felder und ihre Bedeutungen werden unten angezeigt.

Wenn ein Feldwert ein Komma enthält, muss es in Anführungszeichen gesetzt werden.

OAuthJWTIssuisse

Der Herausgeber des Java Web Token.

Datentyp

string

Standardwert

""

Hinweise

Der Aussteller des Java Web Token. Dies ist normalerweise entweder die Client-ID oder die Email Adresse der OAuth-Anwendung.

Dies ist bei Verwendung des GOOGLEJSON OAuthJWTCertType nicht erforderlich. Google JSON-Schlüssel enthalten eine Kopie des Ausstellerkontos.

OAuthJWT-Betreff

Das Benutzersubjekt, für das die Anwendung delegierten Zugriff anfordert.

Datentyp

string

Standardwert

""

Hinweise

Der Benutzer, für den die Anwendung delegierten Zugriff anfordert. Normalerweise der Benutzerkontoname oder die Email-Adresse.

Kerberos

Dieser Abschnitt enthält eine vollständige Liste der Kerberos-Eigenschaften, die Sie konfigurieren können.

KerberosKDC

Der Kerberos Key Distribution Center (KDC)-Dienst, der zur Authentifizierung des Benutzers verwendet wird.

Datentyp

string

Standardwert

""

Hinweise

Die Kerberos-Eigenschaften werden bei Verwendung von SPNEGO oder Windows Authentifizierung verwendet. Der Connector fordert Sitzungstickets und temporäre Sitzungsschlüssel vom Kerberos-KDC-Dienst an. Der Kerberos-KDC-Dienst befindet sich üblicherweise am selben Standort wie der Domänencontroller.

Wenn Kerberos KDC nicht angegeben ist, versucht der Connector, diese Eigenschaften automatisch an den folgenden Standorten zu erkennen:

• KRB5 Config File (krb5.ini/krb5.conf): Wenn die Umfeld KRB5_CONFIG gesetzt ist und die Datei existiert, ruft der Connector den KDC aus der angegebenen Datei ab. Andernfalls versucht er, basierend auf dem Operationssystem vom Standard-MIT-Speicherort zu lesen: C:\ProgramData\MIT\Kerberos5\krb5.ini (Windows) oder /etc/krb5.conf (Linux).
• Java System Properties: Verwenden der Systemeigenschaften java.security.krb5.realm und java.security.krb5.kdc.
• Domain Name and Host: Als letzte Möglichkeit leitet der Connector den Kerberos-Bereich und den Kerberos-KDC aus dem konfigurierten Domänennamen und Host ab.

KerberosRealm

Der Kerberos-Bereich, mit dem der Benutzer authentifiziert wird.

Datentyp

string

Standardwert

""

Hinweise

Die Kerberos-Eigenschaften werden bei Verwendung von SPNEGO oder Windows-Authentifizierung verwendet. Der Kerberos-Bereich wird verwendet, um den Benutzer mit dem Kerberos Key Distribution Service (KDC) zu authentifizieren. Der Kerberos-Bereich kann von einem Administrator als beliebige Zeichenfolge konfiguriert werden, basiert jedoch üblicherweise auf dem Domänennamen.

Wenn kein Kerberos-Bereich angegeben ist, versucht der Connector, diese Eigenschaften automatisch an den folgenden Standorten zu erkennen:

• KRB5 Config File (krb5.ini/krb5.conf): Wenn die Umfeld KRB5_CONFIG gesetzt ist und die Datei existiert, ruft der Connector den Standardbereich aus der angegebenen Datei ab. Andernfalls versucht er, basierend auf dem Operationssystem vom Standard-MIT-Speicherort zu lesen: C:\ProgramData\MIT\Kerberos5\krb5.ini (Windows) oder /etc/krb5.conf (Linux).
• Java System Properties: Verwenden der Systemeigenschaften java.security.krb5.realm und java.security.krb5.kdc.
• Domain Name and Host: Als letzte Möglichkeit leitet der Connector den Kerberos Realm und Kerberos KDC aus dem benutzerkonfigurierten Domänennamen und Host ab. Dies könnte in einigen Windows-Umgebungen funktionieren.

KerberosSPN

Der Service Principal Name (SPN) für den Kerberos-Domänencontroller.

Datentyp

string

Standardwert

""

Hinweise

Wenn der SPN auf dem Kerberos-Domänencontroller nicht mit der URL übereinstimmt, bei der Sie sich authentifizieren, verwenden Sie diese Eigenschaft, um den SPN festzulegen.

KerberosKeytabFile

Die Keytab-Datei, die Ihre Paare aus Kerberos-Prinzipalen und verschlüsselten Schlüsseln enthält.

Datentyp

string

Standardwert

""

Hinweise

Die Keytab-Datei mit Ihren Paaren aus Kerberos-Prinzipalen und verschlüsselten Schlüsseln.

Die Keytab-Datei mit Ihren Paaren aus Kerberos-Prinzipalen und verschlüsselten Schlüsseln.

KerberosServiceRealm

Der Kerberos-Bereich des Dienstes.

Datentyp

string

Standardwert

""

Hinweise

Der KerberosServiceRealm ist die Angabe des Service-Kerberos-Realms bei Verwendung einer Cross-Realm-Kerberos-Authentifizierung.

In den meisten Fällen werden ein einzelner Realm und eine KDC-Maschine zur Durchführung der Kerberos-Authentifizierung verwendet und diese Eigenschaft ist nicht erforderlich.

Diese Eigenschaft ist für komplexe Setups verfügbar, bei denen ein anderer Realm und eine andere KDC-Maschine zum Abrufen eines Authentifizierungstickets (AS-Anforderung) und eines Servicetickets (TGS-Anforderung) verwendet werden.

KerberosServiceKDC

Der Kerberos-KDC des Dienstes.

Datentyp

string

Standardwert

""

Hinweise

Der KerberosServiceKDC wird verwendet, um den Dienst Kerberos KDC anzugeben, wenn eine bereichsübergreifende Kerberos-Authentifizierung verwendet wird.

In den meisten Fällen werden ein einzelner Bereich und eine KDC-Maschine verwendet, um die Kerberos-Authentifizierung durchzuführen, und diese Eigenschaft ist nicht erforderlich.

Diese Eigenschaft ist für komplexe Setups verfügbar, bei denen ein anderer Bereich und eine andere KDC-Maschine verwendet werden, um ein Authentifizierungsticket (AS-Anforderung) und ein Dienstticket (TGS-Anforderung) zu erhalten.

KerberosTicketCache

Der vollständige Dateipfad zu einer MIT Kerberos-Anmeldeinformations-Cachedatei.

Datentyp

string

Standardwert

""

Hinweise

Diese Eigenschaft kann festgelegt werden, wenn Sie eine Anmeldeinformationscachedatei verwenden möchten, die mit dem MIT Kerberos Ticket Manager oder dem Befehl kinit erstellt wurde.

SSL

Dieser Abschnitt enthält eine vollständige Liste der SSL-Eigenschaften, die Sie konfigurieren können.

SSLClientCert

Der TLS/SSL-Client-Zertifikatspeicher für die SSL-Client-Authentifizierung (bidirektionales SSL).

Datentyp

string

Standardwert

""

Hinweise

Der Name des Zertifikatspeichers für das Client-Zertifikat.

Der SSLClientCertType Feld gibt den Typ des durch angegebenen Zertifikatspeichers an SSLClientCert. Wenn der Store kennwortgeschützt ist, geben Sie das Kennwort in SSLClientCertPassword an.

SSLClientCert wird in Verbindung mit SSLClientCertSubject verwendet, um Client-Zertifikate anzugeben. Wenn SSLClientCert hat einen Wert und SSLClientCertSubject gesetzt ist, wird eine Suche nach einem Zertifikat eingeleitet. Siehe SSLClientCertSubject für weitere Informationen.

Die Bezeichnungen der Zertifikatsspeicher sind plattformabhängig.

Nachfolgend sind die Bezeichnungen der gebräuchlichsten Benutzer- und Maschinen-Zertifikatspeicher in Windows aufgeführt:

In Java ist der Zertifikatsspeicher normalerweise eine Datei, die Zertifikate und optionale private Schlüssel enthält.

Wenn der Zertifikatsspeichertyp PFXFile ist, muss diese Eigenschaft auf den Namen der Datei gesetzt werden. Wenn der Typ PFXBlob ist, muss die Eigenschaft auf den binären Inhalt einer PFX-Datei gesetzt werden (z. B. PKCS12-Zertifikatsspeicher).

SSLClientCertType

Der Typ des Schlüsselspeichers, der das TLS/SSL-Clientzertifikat enthält.

Mögliche Werte

USER, MACHINE, PFXFILE, PFXBLOB, JKSFILE, JKSBLOB, PEMKEY_FILE, PEMKEY_BLOB, PUBLIC_KEY_FILE, PUBLIC_KEY_BLOB, SSHPUBLIC_KEY_FILE, SSHPUBLIC_KEY_BLOB, P7BFILE, PPKFILE, XMLFILE, XMLBLOB

Datentyp

string

Standardwert

USER

Hinweise

Diese Eigenschaft kann einen der folgenden Werte annehmen:

SSLClientCertPassword

Das Passwort für das TLS/SSL-Client-Zertifikat.

Datentyp

string

Standardwert

""

Hinweise

Wenn der Zertifikatspeicher von einem Typ ist, der ein Passwort erfordert, wird diese Eigenschaft verwendet, um dieses Passwort zum Öffnen des Zertifikatspeichers anzugeben.

SSLClientCertSubject

Der Betreff des TLS/SSL-Client-Zertifikats.

Datentyp

string

Standardwert

*

Hinweise

Beim Laden eines Zertifikats wird der Betreff verwendet, um das Zertifikat im Speicher zu lokalisieren.

Wenn keine genaue Übereinstimmung gefunden wird, wird der Speicher nach Betreffs durchsucht, die den Wert der Eigenschaft enthalten. Wenn immer noch keine Übereinstimmung gefunden wird, wird die Eigenschaft auf eine leere Zeichenfolge gesetzt und kein Zertifikat ausgewählt.

Der spezielle Wert „*“ wählt das erste Zertifikat im Zertifikatspeicher aus.

Der Betreff des Zertifikats ist eine durch Kommas getrennte Liste von Distinguished Name-Feldern und-Werten. Beispiel: „CN=www.server.com, OU=test, C=US, E=support@company.com“. Die allgemeinen Felder und ihre Bedeutungen werden unten angezeigt.

Wenn ein Feldwert ein Komma enthält, muss es in Anführungszeichen gesetzt werden.

SSL-Modus

Der Authentifizierungsmechanismus, der bei der Verbindung mit dem FTP oder FTPS-Server verwendet werden soll.

Mögliche Werte

AUTOMATIC, NONE, IMPLICIT, EXPLICIT

Datentyp

string

Standardwert

AUTOMATIC

Hinweise

Wenn SSLMode auf NONE gesetzt ist, wird die Standard-Klartextauthentifizierung für die Anmeldung beim Server verwendet. Wenn SSLMode auf IMPLICIT gesetzt ist, wird die SSL-Aushandlung sofort nach dem Herstellen der Verbindung gestartet. Wenn SSLMode auf EXPLICIT gesetzt ist, stellt der Connector zunächst eine Verbindung im Klartext her und startet dann explizit die SSL-Verhandlung über einen Protokollbefehl wie STARTTLS. Wenn SSLMode ist auf AUTOMATISCH eingestellt. Wenn der Remote Port auf den Standard-Klartext-Port des Protokolls eingestellt ist (sofern zutreffend), verhält sich die Komponente genauso, als ob SSLMode ist auf EXPLIZIERT eingestellt. In allen anderen Fällen erfolgt die SSL-Aushandlung IMPLIZIT.

• AUTOMATISCH
• KEINE
• IMPLIZIT
• EXPLIZIERT

SSLServerCert

Das vom Server zu akzeptierende Zertifikat bei einer Verbindung über TLS/SSL.

Datentyp

string

Standardwert

""

Hinweise

Bei Verwendung einer TLS/SSL-Verbindung kann diese Eigenschaft verwendet werden, um das vom Server zu akzeptierende TLS/SSL-Zertifikat anzugeben. Jedes andere Zertifikat, dem der Computer nicht vertraut, wird abgelehnt.

Diese Eigenschaft kann folgende Formen annehmen:

Wenn nicht angegeben, wird jedes vom Computer vertrauenswürdige Zertifikat akzeptiert.

Zertifikate werden vom Computer basierend auf dem Trust Store des Systems als vertrauenswürdig validiert. Der verwendete Trust Store ist der für das System angegebene Wert „javax.net.ssl.trustStore“. Wenn für diese Eigenschaft kein Wert angegeben ist, wird der Standard-Trust Store von Java verwendet (z. B. JAVA_HOME\lib\security\cacerts).

Verwenden Sie „*“, um anzugeben, dass alle Zertifikate akzeptiert werden. Beachten Sie, dass dies aus Sicherheitsgründen nicht empfohlen wird.

SSH

Dieser Abschnitt enthält eine vollständige Liste der SSH-Eigenschaften, die Sie konfigurieren können.

SSHAuthMode

Die Authentifizierungsmethode, die für die Anmeldung bei einem SFTP-Server verwendet werden soll.

Mögliche Werte

None, Password, Public_Key

Datentyp

string

Standardwert

Password

Hinweise

• Keine: Es wird keine Authentifizierung durchgeführt. Der aktuelle Benutzer-Wert wird ignoriert und die Verbindung wird als anonym angemeldet.
• Passwort: Der Connector verwendet die Werte von Benutzer und Passwort, um den Benutzer zu authentifizieren.
• Public_Key: Der Connector verwendet die Werte von Benutzer und SSHClientCert, um den Benutzer zu authentifizieren. SSHClientCert muss ein privater Schlüssel verfügbar sein, damit diese Authentifizierungsmethode erfolgreich ist.

SSHClientCert

Ein Zertifikat, das zur Authentifizierung des Benutzers verwendet werden soll.

Datentyp

string

Standardwert

""

Hinweise

Um die Authentifizierung mit öffentlichem Schlüssel zu verwenden, SSHClientCert muss ein Zertifikat mit einem gültigen privaten Schlüssel enthalten. Der öffentliche Schlüsselwert des Zertifikats wird zusammen mit einer mit dem privaten Schlüssel erstellten Signatur an den Server gesendet. Der Server prüft zunächst, ob die öffentlichen Schlüsselwerte mit den dem Benutzer bekannten Werten übereinstimmen, und versucht dann, anhand dieser Werte die Signatur zu verifizieren.

Der SSHClientCertType Feld gibt den Typ des durch angegebenen Zertifikatspeichers an SSHClientCert. Wenn der Store kennwortgeschützt ist, geben Sie das Kennwort in SSHClientCertPassword an.

SSHClientCert wird in Verbindung mit SSHClientCertSubject verwendet

Feld, um Client-Zertifikate anzugeben. Wenn SSHClientCert hat einen Wert und SSHClientCertSubject gesetzt ist, wird eine Suche nach einem Zertifikat eingeleitet. Bitte beachten Sie die SSHClientCertSubject für weitere Einzelheiten.

Die Bezeichnungen der Zertifikatsspeicher sind plattformabhängig.

Nachfolgend sind die Bezeichnungen der gebräuchlichsten Benutzer- und Maschinen-Zertifikatspeicher in Windows aufgeführt:

In Java ist der Zertifikatsspeicher normalerweise eine Datei, die Zertifikate und optionale private Schlüssel enthält.

Wenn der Zertifikatsspeichertyp PFXFile ist, muss diese Eigenschaft auf den Namen der Datei gesetzt werden. Wenn der Typ PFXBlob ist, muss die Eigenschaft auf den binären Inhalt einer PFX-Datei (d. h. PKCS12-Zertifikatsspeicher) gesetzt werden.

SSHClientCertPassword

Das Passwort des SSHClientCert-Zertifikats, falls vorhanden.

Datentyp

string

Standardwert

""

Hinweise

Diese Eigenschaft wird nur bei der Authentifizierung gegenüber SFTP-Servern mit SSHAuthMode verwendet auf PublicKey und SSHClientCert gesetzt auf einen privaten Schlüssel gesetzt.

SSHClientCertType

Der Typ des SSHClientCert-Zertifikats.

Mögliche Werte

USER, MACHINE, PFXFILE, PFXBLOB, JKSFILE, JKSBLOB, PEMKEY_FILE, PEMKEY_BLOB, PUBLIC_KEY_FILE, PUBLIC_KEY_BLOB, SSHPUBLIC_KEY_BLOB, P7BFILE, P7BBLOB, SSHPUBLIC_KEY_FILE, PPKFILE, PPKBLOB, XMLFILE, XMLBLOB

Datentyp

string

Standardwert

PUBLIC_KEY_FILE

Hinweise

Der Typ von SSHClientCert Zertifikat. Diese Eigenschaft kann einen der folgenden Werte annehmen:

Schema

Dieser Abschnitt enthält eine vollständige Liste der Schema, die Sie konfigurieren können.

Standort

Ein Pfad zum Verzeichnis, das die Schema enthält, die Tabellen, Ansichten und gespeicherte Prozeduren definieren.

Datentyp

string

Standardwert

%APPDATA%\Excel Data Provider\Schema

Hinweise

Der Pfad zu einem Verzeichnis, das die Schema für den Connector enthält (.rsd-Dateien für Tabellen und Ansichten, .rsb-Dateien für gespeicherte Prozeduren). Der Ordnerspeicherort kann ein relativer Pfad vom Speicherort der ausführbaren Datei sein. Der Location Die Eigenschaft wird nur benötigt, wenn Sie Definitionen anpassen (z. B. einen Spaltennamen ändern, eine Spalte ignorieren usw.) oder das Datenmodell mit neuen Tabellen, Ansichten oder gespeicherten Prozeduren erweitern möchten.

Wenn nichts angegeben wird, ist der Standardspeicherort "%APPDATA%\ Excel Data Provider\Schema" mit %APPDATA% wird auf das Konfigurationsverzeichnis des Benutzers eingestellt:

DurchsuchbareSchemas

Diese Eigenschaft beschränkt die gemeldeten Schemata auf eine Teilmenge der verfügbaren Schemata. Beispiel: BrowsableSchemas=SchemaA,SchemaB,SchemaC.

Datentyp

string

Standardwert

""

Hinweise

Das Auflisten der Schemata aus Datenbanken kann aufwändig sein. Die Bereitstellung einer Liste von Schemata in der Verbindungszeichenfolge verbessert die Leistung.

Tabellen

Diese Eigenschaft beschränkt die gemeldeten Tabellen auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Tabellen=TabelleA,TabelleB,TabelleC.

Datentyp

string

Standardwert

""

Hinweise

Das Auflisten der Tabellen aus einigen Datenbanken kann teuer sein. Die Bereitstellung einer Liste von Tabellen in der Verbindungszeichenfolge verbessert die Leistung des Connectors.

Diese Eigenschaft kann auch als Alternative zum automatischen Auflisten von Ansichten verwendet werden, wenn Sie bereits wissen, mit welchen Sie arbeiten möchten, und es sonst zu viele wären.

Geben Sie die gewünschten Tabellen in einer durch Kommas getrennten Liste an. Jede Tabelle sollte ein gültiger SQL-Bezeichner sein, wobei alle Sonderzeichen mit eckigen Klammern, Anführungszeichen oder Backticks maskiert werden. Beispiel: Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.

Beachten Sie, dass Sie beim Herstellen einer Verbindung zu einer Datenquelle mit mehreren Schemata oder Katalogen den vollqualifizierten Namen der Tabelle in dieser Eigenschaft angeben müssen, wie im letzten Beispiel hier, um Mehrdeutigkeiten zwischen Tabellen zu vermeiden, die in mehreren Katalogen oder Schemata vorhanden sind.

Ansichten

Beschränkt die gemeldeten Ansichten auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Ansichten=AnsichtA,AnsichtB,AnsichtC.

Datentyp

string

Standardwert

""

Hinweise

Das Auflisten der Ansichten aus einigen Datenbanken kann teuer sein. Die Bereitstellung einer Liste von Ansichten in der Verbindungszeichenfolge verbessert die Leistung des Connectors.

Diese Eigenschaft kann auch als Alternative zum automatischen Auflisten von Ansichten verwendet werden, wenn Sie bereits wissen, mit welchen Sie arbeiten möchten, und es sonst zu viele wären.

Geben Sie die gewünschten Ansichten in einer durch Kommas getrennten Liste an. Jede Ansicht sollte ein gültiger SQL-Bezeichner sein, wobei alle Sonderzeichen mit eckigen Klammern, Anführungszeichen oder Backticks maskiert werden. Beispiel: Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.

Beachten Sie, dass Sie beim Herstellen einer Verbindung zu einer Datenquelle mit mehreren Schemata oder Katalogen den vollqualifizierten Namen der Tabelle in dieser Eigenschaft angeben müssen, wie im letzten Beispiel hier, um Mehrdeutigkeiten zwischen Tabellen zu vermeiden, die in mehreren Katalogen oder Schemata vorhanden sind.

Verschiedenes

Dieser Abschnitt enthält eine vollständige Liste verschiedener Eigenschaften, die Sie konfigurieren können.

Zeichensatz

Gibt den Sitzungszeichensatz zum Kodieren und Dekodieren von Zeichendaten an, die in die und aus der Excel Datei übertragen werden. Der Standardwert ist UTF-8.

Datentyp

string

Standardwert

UTF-8

Hinweise

Gibt den Sitzungszeichensatz zum Kodieren und Dekodieren von Zeichendaten an, die in die und aus der Excel Datei übertragen werden. Der Standardwert ist UTF-8.

Kundenkultur

Mit dieser Eigenschaft können Sie das Datenformat (z. B. Währungswerte) angeben, das von der Clientanwendung akzeptiert wird. Diese Eigenschaft kann verwendet werden, wenn die Clientanwendung die Kultureinstellungen des Computers nicht unterstützt. Beispielsweise erfordert Microsoft Access „en-US“.

Datentyp

string

Standardwert

""

Hinweise

Diese Option wirkt sich auf das Format der Connector-Ausgabe aus. Um das Format anzugeben, das definiert, wie die Eingabe interpretiert werden soll, verwenden Sie die Option Kultur. Standardmäßig verwendet der Connector die aktuellen Gebietsschemaeinstellungen des Computers, um die Eingabe zu interpretieren und die Ausgabe zu formatieren.

Kultur

Mit dieser Einstellung können Sie Kultureinstellungen festlegen, die bestimmen, wie der Anbieter bestimmte Datentypen interpretiert, die an den Anbieter übergeben werden. Wenn Sie beispielsweise Culture='de-DE' festlegen, werden deutsche Formate auch auf einem amerikanischen Computer ausgegeben.

Datentyp

string

Standardwert

""

Hinweise

Diese Eigenschaft wirkt sich auf die Connector-Eingabe aus. Um Werte in einem anderen kulturellen Format zu interpretieren, verwenden Sie die Client-Kultur-Eigenschaft. Standardmäßig verwendet der Connector die aktuellen Gebietsschemaeinstellungen des Computers, um die Eingabe zu interpretieren und die Ausgabe zu formatieren.

BenutzerdefinierteHeader

Andere Header nach Wahl des Benutzers (optional).

Datentyp

string

Standardwert

""

Hinweise

Diese Eigenschaft kann auf eine Zeichenfolge mit Headern festgelegt werden, die an die aus anderen Eigenschaften (wie „ContentType“, „From“ usw.) erstellten HTTP-Anforderungsheader angehängt werden.

Die Header müssen das Format „Header:Wert“ aufweisen, wie in den HTTP-Spezifikationen beschrieben. Headerzeilen sollten durch die Zeichen für Wagenrücklauf und Zeilenvorschub (CRLF) getrennt sein.

Verwenden Sie diese Eigenschaft mit Vorsicht. Wenn diese Eigenschaft ungültige Header enthält, können HTTP-Anforderungen fehlschlagen.

Diese Eigenschaft ist nützlich, um die Funktionalität des Connectors für die Integration mit spezialisierten oder nicht standardmäßigen APIs zu optimieren.

Benutzerdefinierte URL-Parameter

Die benutzerdefinierte Abfrage, die in die Anforderung aufgenommen werden soll.

Datentyp

string

Standardwert

""

Hinweise

Der CustomUrlParams ermöglicht Ihnen die Angabe benutzerdefinierter Abfrage, die in die HTTP-Anforderung eingeschlossen werden. Die Parameter müssen als Abfrage in der Form Feld1=Wert1&Feld2=Wert2&Feld3=Wert3 codiert sein. Die Werte in der Abfrage müssen URL codiert sein.

DropboxTeamResources einschließen

Gibt an, ob Sie Dropbox-Teamdateien und-Ordner einschließen möchten.

Datentyp

bool

Standardwert

false

Hinweise

Um auf Dropbox-Teamordner und-Dateien zuzugreifen, setzen Sie diese Verbindungseigenschaft bitte auf True.

MaxRows

Begrenzt die Anzahl der zurückgegebenen Zeilen, wenn in der Abfrage keine Aggregation oder Gruppierung verwendet wird. Dadurch werden Leistungsprobleme zur Entwurfszeit vermieden.

Datentyp

int

Standardwert

-1

Hinweise

Begrenzt die Anzahl der zurückgegebenen Zeilen, wenn in der Abfrage keine Aggregation oder Gruppierung verwendet wird. Dadurch werden Leistungsprobleme zur Entwurfszeit vermieden.

Andere

Diese versteckten Eigenschaften werden nur in bestimmten Anwendungsfällen verwendet.

Datentyp

string

Standardwert

""

Hinweise

Die unten aufgeführten Eigenschaften sind für bestimmte Anwendungsfälle verfügbar. Für normale Anwendungsfälle und Funktionen von Treiber sollten diese Eigenschaften nicht erforderlich sein.

Geben Sie mehrere Eigenschaften in einer durch Semikolon getrennten Liste an.

Integration und Formatierung

Pseudospalten

Diese Eigenschaft gibt an, ob Pseudospalten als Spalten in die Tabelle aufgenommen werden sollen oder nicht.

Datentyp

string

Standardwert

""

Hinweise

Diese Einstellung ist besonders hilfreich im Entity Framework, da Sie dort keinen Wert für eine Pseudospalte festlegen können, es sei denn, es handelt sich um eine Tabellenspalte. Der Wert dieser Verbindungseinstellung hat das Format „Tabelle1=Spalte1, Tabelle1=Spalte2, Tabelle2=Spalte3“. Sie können das Zeichen „*“ verwenden, um alle Tabellen und alle Spalten einzuschließen, z. B. „*=*“.

Zeilenscantiefe

Die maximale Anzahl zu scannender Zeilen, um nach den in einer Tabelle verfügbaren Spalten zu suchen.

Datentyp

int

Standardwert

15

Hinweise

Die Spalten in einer Tabelle müssen durch das Scannen der Tabellenzeilen ermittelt werden. Dieser Wert bestimmt die maximale Anzahl der zu scannenden Zeilen.

Das Festlegen eines hohen Wertes kann die Leistung beeinträchtigen. Das Festlegen eines niedrigen Wertes kann dazu führen, dass der Datentyp nicht richtig ermittelt wird, insbesondere wenn Nulldaten vorhanden sind.

Zeitüberschreitung

Der Wert in Sekunden, bis der Timeout-Fehler auftritt und der Operation abgebrochen wird.

Datentyp

int

Standardwert

60

Hinweise

Wenn Timeout = 0, Operationen werden nicht abgebrochen. Die Operationen werden ausgeführt, bis sie erfolgreich abgeschlossen sind oder bis ein Fehler auftritt.

Wenn Timeout abläuft und der Operation noch nicht abgeschlossen ist, löst der Connector eine Ausnahme aus.