Microsoft Excel Verbindung

Einführung

Eine Microsoft Excel Verbindung, die mit dem Microsoft Excel Konnektor erstellt wurde, ermöglicht den Zugriff auf Microsoft Excel. Sobald diese Aktivitäten konfiguriert sind, interagieren sie über die Verbindung mit Microsoft Excel.

Erstellen oder Bearbeiten einer Microsoft Excel Verbindung

Eine neue Microsoft Excel Verbindung wird mithilfe des Microsoft Excel Connectors von einem der folgenden Speicherorte aus erstellt:

• Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
• Die Seite Globale Verbindungen (siehe Einen globalen Endpoint erstellen in Globale Verbindungen).

Eine vorhandene Microsoft Excel Verbindung kann von diesen Orten aus bearbeitet werden:

• Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
• Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).
• Die Seite Globale Verbindungen (siehe Einen globalen Endpoint bearbeiten in Globale Verbindungen).

Konfigurieren einer Microsoft Excel Verbindung

Nachfolgend werden die einzelnen Elemente der Benutzeroberfläche des Microsoft Excel Verbindungskonfigurationsbildschirms beschrieben.

• Verbindungsname: Geben Sie einen Namen ein, der zur Identifizierung der Verbindung verwendet werden soll. Der Name muss für jede Microsoft Excel Verbindung eindeutig sein und darf keine Schrägstriche enthalten (/) oder Doppelpunkte (:). Dieser Name wird auch zur Identifizierung des Microsoft Excel Endpoint verwendet, der sich sowohl auf eine bestimmte Verbindung als auch auf ihre Aktivitäten bezieht.

• Authentifizierung: Wenn ausgewählt (Standard), werden zusätzliche Einstellungen angezeigt. Dokumentation finden Sie unter Herstellen einer Verbindung und Zusätzliche Konfigurationseigenschaften:

  • Authentifizierungsschema: Wählen Sie das Autorisierungsschema aus:

    • Keine

    • Grundlegend

    • Auto

    • Zusammenfassung

    • NTLM

    • Verhandeln

    • OAuth

    • OAuthJWT

    • SFTP

    • FTP

    • SSLCertificate

    • AwsRootKeys

    • AwsIAMRoles

    • AwsEC2Roles

    • AwsMFA

    • AwsTempCredentials

    • AwsCredentialsFile

    • AzureAD

    • AzureServicePrincipal

    • AzureMSI

    • OKTA

    • ADFS

    • OneLogin

    • PingFederate

    • HMAC

  • Benutzer: Geben Sie den Benutzer ein.

  • Passwort: Geben Sie das Passwort ein.

  • Share Point Edition: Wählen Sie die SharePoint-Edition aus, eine der folgenden:

    • SharePointOnline

    • SharePointOnPremise

• Verbindung: Wenn ausgewählt, werden zusätzliche Einstellungen angezeigt. Dokumentation finden Sie unter Herstellen einer Verbindung und Zusätzliche Konfigurationseigenschaften:

  • URI: Geben Sie die URI ein.

  • Tabellen definieren: Geben Sie die definierten Tabellen ein.

  • Header: Geben Sie die Header ein.

  • Ausrichtung: Wählen Sie eine der folgenden Ausrichtungen:

    • Horizontal

    • Vertikal

  • Excel Datei: Geben Sie die Excel Datei ein.

  • Änderungen puffern: Wenn ausgewählt (Standard), werden Änderungen gepuffert.

  • Region: Geben Sie die Region ein.

  • Projekt-ID: Geben Sie die Projekt-ID ein.

  • Oracle Namespace: Geben Sie den Oracle-Namespace ein.

  • Speicherbasis URL: Geben Sie die Speicherbasis-URL ein.

  • Virtuelles Hosting verwenden: Wenn ausgewählt (Standard), wird die Verwendung von virtuellem Hosting angegeben.

• AWS-Authentifizierung: Wenn ausgewählt, werden zusätzliche Einstellungen angezeigt. Dokumentation finden Sie unter Herstellen einer Verbindung und Zusätzliche Konfigurationseigenschaften:

  • AWS-Zugriffsschlüssel: Geben Sie den AWS-Zugriffsschlüssel ein.

  • Geheimer AWS-Schlüssel: Geben Sie den geheimen AWS-Schlüssel ein.

  • AWS-Rollen-ARN: Geben Sie die AWS Rolle-ARN ein.

  • AWS-Haupt-ARN: Geben Sie die AWS-Haupt-ARN ein.

  • AWS-Region: Wählen Sie die AWS-Region aus, eine der folgenden:

    • OHIO

    • NORDVIRGINIA

    • NORDKALIFORNIEN

    • OREGON

    • KAPSTADT

    • HONGKONG

    • MUMBAI

    • OSAKA

    • SEOUL

    • SINGAPUR

    • SYDNEY

    • TOKIO

    • ZENTRAL

    • PEKING

    • NINGXIA

    • FRANKFURT

    • IRLAND

    • LONDON

    • MAILAND

    • PARIS

    • STOCKHOLM

    • BAHRAIN

    • SAOPAULO

    • GOVCLOUDEAST

    • GOVCLOUDWEST

  • AWS-Sitzungstoken: Geben Sie das AWS-Sitzungstoken ein.

  • MFA-Seriennummer: Geben Sie die MFA-Seriennummer ein.

  • MFA-Token: Geben Sie das MFA-Token ein.

• Azure-Authentifizierung: Wenn ausgewählt, werden zusätzliche Einstellungen angezeigt. Die Dokumentation finden Sie unter Herstellen einer Verbindung und Zusätzliche Konfigurationseigenschaften:

  • Azure-Speicherkonto: Geben Sie das Azure-Speicherkonto ein.

  • Azure Zugriffsschlüssel: Geben Sie den Azure Zugriffsschlüssel ein.

  • Azure Shared Access Signature: Geben Sie die Azure Shared Access Signature ein.

  • Azure-Mandant: Geben Sie den Azure Mandanten ein.

  • Azure-Umgebung: Wählen Sie die Azure Umfeld aus, eine der folgenden:

    • GLOBAL

    • CHINA

DEUTSCHLAND**

    - **USGOVT**

    - **USGOVTDOD**

• SSO: Wenn ausgewählt, werden zusätzliche Einstellungen angezeigt. Dokumentation finden Sie unter Herstellen einer Verbindung und Zusätzliche Konfigurationseigenschaften:

  • SSO-Anmelde URL: Geben Sie die SSO-Anmelde-URL ein.

  • SSO-Eigenschaften: Geben Sie die SSO-Eigenschaften ein.

• OAuth: Wenn ausgewählt, werden zusätzliche Einstellungen angezeigt. Dokumentation finden Sie unter Herstellen einer Verbindung und Zusätzliche Konfigurationseigenschaften:

  • OAuth initiieren: Wählen Sie die OAuth-Einstellung, eine der folgenden:

    • AUS

    • GETANDREFRESH

    • AKTUALISIEREN

  • OAuth-Version: Wählen Sie die OAuth-Version, eine der folgenden:

    • Deaktiviert

    • 1,0

    • 2,0

  • OAuth-Client-ID: Geben Sie die OAuth-Client-ID ein.

  • OAuth-Client-Geheimnis: Geben Sie das OAuth-Client-Geheimnis ein.

  • OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.

  • Geheimnis des OAuth-Zugriffstokens: Geben Sie das Geheimnis des OAuth-Zugriffstokens ein.

  • Rückruf URL: Geben Sie die Rückruf-URL ein.

  • OAuth-Grant-Typ: Wählen Sie den OAuth-Grant-Typ aus, einen der folgenden:

    • CODE

    • KUNDE

    • PASSWORT

  • OAuth-Passwort-Gewährungsmodus: Wählen Sie den OAuth-Passwort-Gewährungsmodus aus, einen der folgenden:

    • Beitrag

    • Grundlegend

  • OAuth-Rückruf-URL einschließen: Wenn ausgewählt (Standard), wird angegeben, dass die OAuth-Rückruf URL eingeschlossen werden soll.

  • OAuth-Autorisierungs URL: Geben Sie die OAuth-Autorisierungs URL ein.

  • URL des OAuth-Zugriffstokens: Geben Sie die URL des OAuth-Zugriffstokens ein.

  • URL des OAuth-Aktualisierungstokens: Geben Sie die URL des OAuth-Aktualisierungstokens ein.

  • URL des OAuth-Anforderungstokens: Geben Sie die URL des OAuth-Anforderungstokens ein.

  • OAuth-Verifier: Geben Sie den OAuth-Verifier ein.

  • Authentifizierungstoken: Geben Sie das Authentifizierungstoken ein.

  • Authentifizierungsschlüssel: Geben Sie den Authentifizierungsschlüssel ein.

  • OAuth-Parameter: Geben Sie die OAuth-Parameter ein.

  • OAuth-Aktualisierungstoken: Geben Sie das OAuth-Aktualisierungstoken ein.

  • OAuth läuft ab in: Geben Sie die Zeit in Sekunden ein, nach der das OAuth-Token abläuft.

  • OAuth-Token-Zeitstempel: Geben Sie den OAuth-Token-Zeitstempel ein.

• JWT OAuth: Wenn ausgewählt, werden zusätzliche Einstellungen angezeigt. Dokumentation finden Sie unter Herstellen einer Verbindung und Zusätzliche Konfigurationseigenschaften:

  • OAuth JWT Cert: Geben Sie das OAuth JWT-Zertifikat ein.

  • OAuth JWT-Zertifikatstyp: Wählen Sie den OAuth JWT-Zertifikatstyp aus, einen der folgenden:

    • BENUTZER

    • MASCHINE

    • PFXDATEI

    • PFXBLOB

    • JKSDATEI

    • JKSBLOB

    • PEMKEY_FILE

    • PEMKEY_BLOB

    • PUBLIC_KEY_FILE

    • PUBLIC_KEY_BLOB

    • SSHPUBLIC_KEY_FILE

    • SSHPUBLIC_KEY_BLOB

    • P7BFILE

    • PPKFILE

    • XMLFILE

    • XMLBLOB

    • GOOGLEJSON

    • GOOGLEJSONBLOB

  • OAuth JWT Cert-Passwort: Geben Sie das OAuth JWT-Zertifikat ein Passwort.

  • OAuth JWT Cert Subject: Geben Sie das OAuth JWT-Zertifikatssubjekt ein.

  • OAuth JWT Issuer: Geben Sie den OAuth JWT-Aussteller ein.

  • OAuth JWT Subject: Geben Sie das OAuth JWT-Subjekt ein.

• Kerberos: Wenn ausgewählt, werden zusätzliche Einstellungen angezeigt. Dokumentation finden Sie unter Herstellen einer Verbindung und Zusätzliche Konfigurationseigenschaften:

  • Kerberos KDC: Geben Sie das Kerberos KDC ein.

  • Kerberos Realm: Geben Sie das Kerberos-Realm ein.

  • Kerberos SPN: Geben Sie den Kerberos SPN ein.

  • Kerberos Keytab File: Geben Sie die Kerberos Keytab-Datei ein.

  • Kerberos Service Realm: Geben Sie das Kerberos Service Realm ein.

  • Kerberos Service KDC: Geben Sie das Kerberos Service KDC ein.

  • Kerberos Ticket Cache: Geben Sie den Kerberos Ticket Cache ein.

• SSL: Wenn ausgewählt, werden zusätzliche Einstellungen angezeigt. Dokumentation finden Sie unter Herstellen einer Verbindung und Zusätzliche Konfigurationseigenschaften:

  • SSL-Client-Zertifikat: Geben Sie das SSL-Client-Zertifikat ein.

  • SSL-Client-Zertifikattyp: Wählen Sie den SSL-Client-Zertifikattyp aus, einen der folgenden:

    • BENUTZER

    • MASCHINE

    • PFXFILE

    • PFXBLOB

    • JKSFILE

    • JKSBLOB

    • PEMKEY_FILE

    • PEMKEY_BLOB

    • PUBLIC_KEY_FILE

    • PUBLIC_KEY_BLOB

    • SSHPUBLIC_KEY_FILE

    • SSHPUBLIC_KEY_BLOB

    • P7BFILE

    • PPKFILE

    • XMLFILE

    • XMLBLOB

  • SSL-Client-Zertifikat-Passwort: Geben Sie das SSL-Client-Zertifikat-Passwort ein.

  • SSL-Client-Zertifikat-Betreff: Geben Sie den Betreff des SSL-Client-Zertifikats ein.

  • SSL-Modus: Wählen Sie den SSL-Modus, einen der folgenden:

    • AUTOMATISCH

    • KEINE

    • IMPLICIT

    • EXPLICIT

  • SSL-Server-Zertifikat: Geben Sie das SSL-Server-Zertifikat ein.

• SSH: Wenn ausgewählt, werden zusätzliche Einstellungen angezeigt. Dokumentation finden Sie unter Verbindung herstellen und Zusätzliche Konfigurationseigenschaften:

  • SSH-Authentifizierungsmodus: Wählen Sie den SSH-Authentifizierungsmodus, einen der folgenden:

    • Keine

    • Passwort

    • Öffentlicher Schlüssel

  • SSH-Client-Zertifikat: Geben Sie das SSH-Client-Zertifikat ein.

  • SSH-Client-Zertifikat-Passwort: Geben Sie das SSH-Client-Zertifikat-Passwort ein.

  • SSH-Client-Zertifikattyp: Wählen Sie den SSH-Client-Zertifikattyp aus, einen der folgenden:

    • BENUTZER

    • MASCHINE

    • 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

• Proxy-Einstellungen verwenden: Wählen Sie diese Option aus, um Proxy-Einstellungen des privaten Agenten zu verwenden.

• Erweiterte Konfigurationen: Wenn ausgewählt, wird die Tabelle Erweiterte Konfigurationseigenschaften angezeigt, die zum Hinzufügen zusätzlicher Konfigurationseigenschaften verwendet wird als Key-Value Paare.

  • Hinzufügen: Fügt der Tabelle eine Zeile hinzu. Geben Sie für jede Eigenschaft ein Key-Value Paar ein.
  • Senden: Speichert das Key-Value Paar in der Tabelle. Sichtbar, wenn Sie im Bearbeitungsmodus mit der Maus über eine Zeile fahren.
  • Verwerfen: Verwirft eine neue Zeile oder alle Änderungen an einer vorhandenen Zeile. Sichtbar, wenn Sie im Bearbeitungsmodus mit der Maus über eine Zeile fahren.
  • Bearbeiten: Ermöglicht Ihnen, ein vorhandenes Key-Value Paar zu bearbeiten. Sichtbar, wenn Sie mit der Maus über eine vorhandene Zeile fahren.
  • Löschen: Löscht die Zeile aus der Tabelle. Sichtbar, wenn der Mauszeiger über eine vorhandene Zeile fährt.
  • Alles löschen: Löscht alle Zeilen aus der Tabelle.

  Wichtig

  Felder in der Tabelle Erweiterte Konfigurationen zeigen das variable Symbol nur im Bearbeitungsmodus. Damit die Variablenwerte dieser Felder zur Laufzeit ausgefüllt werden, muss die Agentenversion mindestens 10.75 / 11.13 sein.

• Test: Klicken Sie hier, um die Verbindung mit der angegebenen Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die der aktuellen Umfeld zugeordnet ist. Dieser Connector unterstützt das Anhalten des Downloads der neuesten Connector-Version mithilfe der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

• Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

• Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.

Konfigurieren von OAuth-Verbindungen

Dieser Connector unterstützt eine Verbindung über OAuth durch die Verwendung bestimmter Konfigurationseigenschaften. Nachdem Sie ein Authentifizierungsschema ausgewählt haben, das OAuth initiieren enthält, können Sie die Konfiguration in den angezeigten Feldern angeben.

Für diesen Connector werden zwei Szenarien unterstützt. In beiden Szenarien müssen Sie ein Drittpartei verwenden (z. B. Postman oder ein ähnliches Tool), um das oder die erforderlichen Zugriffstoken vom betreffenden Endpoint abzurufen. Beide Szenarien funktionieren nur für Einzelagentengruppen. Dabei handelt es sich um Agentengruppen, die aus einem einzelnen Agenten bestehen.

• Szenario 1: Verwenden eines OAuth-Zugriffstokens, das nach einer festgelegten Zeit abläuft.

  Mit dieser Konfiguration geben Sie ein OAuth-Zugriffstoken an, das für einen festgelegten Zeitraum gültig ist, der vom jeweiligen Endpoint bestimmt wird. Der Connector verwendet das Token, um die Verbindung herzustellen. Die Verbindung funktioniert jedoch nicht mehr, sobald das Zugriffstoken abläuft. Sie konfigurieren den Connector für die Verwendung des Tokens, indem Sie diese Eigenschaften festlegen:

  Konfigurationseigenschaft	Wert
  OAuth initiieren	OFF
  OAuth-Zugriffstoken	Auf den Wert des vom Endpoint erhaltenen OAuth-Zugriffstokens eingestellt

• Szenario 2: Verwenden eines OAuth-Zugriffstokens in Kombination mit einem OAuth-Aktualisierungstoken, um die automatische Aktualisierung des Zugriffs zu ermöglichen.

  Mit dieser Konfiguration verwendet der Connector ein Aktualisierungstoken, um ein neues Zugriffstoken zu erhalten, sobald das aktuelle Zugriffstoken abgelaufen ist. Dies ist im Allgemeinen die beste Methode zum Konfigurieren von OAuth.

  Sie geben ein OAuth-Zugriffstoken und ein OAuth-Aktualisierungstoken an, je nach dem jeweiligen Endpoint. Sie konfigurieren den Connector für die Verwendung dieser Token, indem Sie die folgenden Eigenschaften festlegen:

  Konfigurationseigenschaft	Wert
  OAuth initiieren	REFRESH
  OAuth-Zugriffstoken	Auf den Wert des vom Endpoint erhaltenen OAuth-Zugriffstokens eingestellt
  OAuth-Aktualisierungstoken	Auf den Wert des vom Endpoint erhaltenen OAuth-Aktualisierungstokens eingestellt

Nächste Schritte

Nachdem eine Microsoft Excel Konnektorverbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Design-Canvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verwenden von Daten in einem Operation) verwendet werden können.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Design-Komponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

• Abfrage: Ruft Datensätze aus einer Tabelle in Microsoft Excel ab und ist zur Verwendung als Quelle in einer Operation vorgesehen.

• Erstellen: Fügt einen Datensatz in eine Tabelle in Microsoft Excel ein und ist zur Verwendung als Ziel in einer Operation vorgesehen.

• Aktualisieren: Aktualisiert einen Datensatz in einer Tabelle in Microsoft Excel und soll als Ziel in einer Operation verwendet werden.

• Löschen: Löscht einen Datensatz aus einer Tabelle in Microsoft Excel und ist als Ziel in einer Operation vorgesehen.

• Ausführen: Führt eine Prozedur in Microsoft Excel aus und ist zur Verwendung als Ziel in einer Operation vorgesehen.