Microsoft Excel Online-Verbindung
Einführung
Eine Microsoft Excel Online-Verbindung, die mit dem Microsoft Excel Online-Connector erstellt wurde, ermöglicht den Zugriff auf Microsoft Excel Online. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit Microsoft Excel Online.
Erstellen oder Bearbeiten einer Microsoft Excel Online-Verbindung
Eine neue Microsoft Excel Online-Verbindung wird mit dem Microsoft Excel Online-Connector an einem dieser Orte erstellt:
- Der Projektendpunkte und -connectoren-Registerkarte der Designkomponentenpalette (siehe Designkomponentenpalette).
- Der Global Endpoints-Seite (siehe Erstellen eines globalen Endpunkts in Global Endpoints).
Eine vorhandene Microsoft Excel Online-Verbindung kann an diesen Orten bearbeitet werden:
- Der Projektendpunkte und -connectoren-Registerkarte der Designkomponentenpalette (siehe Designkomponentenpalette).
- Der Komponenten-Registerkarte im Projektbereich (siehe Aktionenmenü für Komponenten in Projektbereich Komponenten-Registerkarte).
- Der Global Endpoints-Seite (siehe Bearbeiten eines globalen Endpunkts in Global Endpoints).
Konfigurieren einer Microsoft Excel Online-Verbindung
Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Microsoft Excel Online-Verbindung wird im Folgenden beschrieben.
Tipp
Felder mit einem Variablen-Icon unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [
in das Feld eingeben, oder indem Sie auf das Variablen-Icon klicken, um eine Liste der vorhandenen Variablen anzuzeigen, aus der Sie auswählen können.
-
Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Microsoft Excel Online-Verbindung eindeutig sein und darf keine Schrägstriche (
/
) oder Doppelpunkte (:
) enthalten. Dieser Name wird auch verwendet, um den Microsoft Excel Online-Endpunkt zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf deren Aktivitäten bezieht. -
Authentifizierungsschema: Wählen Sie das Authentifizierungsschema, eines von:
-
AzureAD
-
OAuth initiieren: Wählen Sie die OAuth-Einstellung, eine von:
-
AUS
- OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
-
GETANDREFRESH
-
AKTUALISIEREN
- OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
-
-
OAuth-Aktualisierungstoken: Geben Sie das OAuth-Aktualisierungstoken ein.
-
-
AzureMSI
-
AzureServicePrincipal
-
Azure-Mandant: Geben Sie den Azure-Mandanten ein.
-
OAuth initiieren: Wählen Sie die OAuth-Einstellung, eine von:
-
AUS
- OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
-
GETANDREFRESH
-
AKTUALISIEREN
- OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
-
-
OAuth-Client-ID: Geben Sie die OAuth-Client-ID ein.
-
OAuth-Client-Geheimnis: Geben Sie das OAuth-Client-Geheimnis ein.
-
OAuth-Aktualisierungstoken: Geben Sie das OAuth-Aktualisierungstoken ein.
-
-
AzureServicePrincipalCert
-
Azure-Mandant: Geben Sie den Azure-Mandanten ein.
-
OAuth initiieren: Wählen Sie die OAuth-Einstellung, eine von:
-
AUS
- OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
-
GETANDREFRESH
-
AKTUALISIEREN
- OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
-
-
OAuth-Client-ID: Geben Sie die OAuth-Client-ID ein.
-
OAuth-Aktualisierungstoken: Geben Sie das OAuth-Aktualisierungstoken ein.
-
OAuth-JWT-Zertifikat: Geben Sie das OAuth-JWT-Zertifikat ein.
-
OAuth-JWT-Zertifikatstyp: Wählen Sie den OAuth-JWT-Zertifikatstyp, einen von:
-
BENUTZER
-
MASCHINE
-
PFXDATEI
-
PFXBLOB
-
JKSDATEI
-
JKSBLOB
-
PEMKEY_DATEI
-
PEMKEY_BLOB
-
ÖFFENTLICHE_KEY_DATEI
-
ÖFFENTLICHE_KEY_BLOB
-
SSHPUBLIC_KEY_DATEI
-
SSHPUBLIC_KEY_BLOB
-
P7BDATEI
-
PPKDATEI
-
XMLDATEI
-
XMLBLOB
-
-
OAuth JWT Zertifikat Passwort: Geben Sie das Passwort für das OAuth JWT-Zertifikat ein.
-
OAuth JWT Zertifikat Betreff: Geben Sie den Betreff des OAuth JWT-Zertifikats ein.
-
-
-
Arbeitsmappe: Geben Sie die Arbeitsmappe ein.
-
Laufwerk: Geben Sie das Laufwerk ein.
-
SharePoint-Websites einbeziehen: Wenn ausgewählt, wird angegeben, dass SharePoint-Websites einbezogen werden sollen.
-
Geteilte Dokumente anzeigen: Wenn ausgewählt, wird angegeben, dass geteilte Dokumente angezeigt werden sollen.
-
Proxy-Einstellungen verwenden: Wählen Sie, um die Proxy-Einstellungen des privaten Agenten zu verwenden.
-
Erweiterte Konfigurationen: Wenn ausgewählt, wird die Tabelle Eigenschaften der erweiterten Konfigurationen angezeigt, die verwendet wird, um zusätzliche Konfigurationseigenschaften als Schlüssel-Wert-Paare hinzuzufügen.
- Hinzufügen: Fügt der Tabelle eine Zeile hinzu. Geben Sie ein Schlüssel-Wert-Paar für jede Eigenschaft ein.
- Einreichen: Speichert das Schlüssel-Wert-Paar in der Tabelle. Sichtbar, wenn Sie mit der Maus über eine Zeile im Bearbeitungsmodus fahren.
- Verwerfen: Verwirft eine neue Zeile oder alle Änderungen an einer vorhandenen Zeile. Sichtbar, wenn Sie mit der Maus über eine Zeile im Bearbeitungsmodus fahren.
- Bearbeiten: Ermöglicht das Bearbeiten eines vorhandenen Schlüssel-Wert-Paares. Sichtbar, wenn Sie mit der Maus über eine vorhandene Zeile fahren.
- Löschen: Löscht die Zeile aus der Tabelle. Sichtbar, wenn Sie mit der Maus über eine vorhandene Zeile fahren.
- Alle löschen: Löscht alle Zeilen aus der Tabelle.
Hinweis
Microsoft Excel Online-Spalten- und Tabellennamen können Sonderzeichen enthalten, die von anderen Diensten nicht unterstützt werden. Fügen Sie die Konfigurationseigenschaft
UseSimpleNames
hinzu und setzen Sie sie auftrue
, um ein Benennungsschema durchzusetzen, das auf alphanumerische und Unterstrichzeichen für Spalten und Tabellen beschränkt ist. Nicht-alphanumerische Zeichen werden bei Aktivierung in Unterstriche umgewandelt.Wichtig
Felder in der Tabelle der erweiterten Konfigurationsparameter zeigen das Variablen-Symbol nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit befüllt werden, muss die Agenten-Version mindestens 10.75 / 11.13 sein.
Felder in der Tabelle der erweiterten Konfigurationsparameter unterstützen nicht die Verwendung von Variablen, um rohes JSON zu übergeben. Wenn Ihr Anwendungsfall nicht unterstützt, rohes JSON direkt in den Feldern zu definieren, entkommen Sie den JSON-Inhalt, bevor Sie ihn mit einer Variablen übergeben. Zum Beispiel wird das Entkommen von
{"success": "true"};
zu{\"success\": \"true\"};
. -
Test: Klicken Sie, 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 mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Deaktivieren Sie die automatische Connector-Aktualisierung Organisationsrichtlinie.
-
Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.
-
Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.
-
Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung löschen möchten.
OAuth-Verbindungen konfigurieren
Dieser Connector unterstützt eine Verbindung über OAuth, indem spezifische Konfigurationsparameter verwendet werden. Nachdem Sie ein Authentifizierungsschema ausgewählt haben, das OAuth initiieren umfasst, können Sie die Konfiguration in den angezeigten Feldern angeben.
Hinweis
Zusätzliche IDs, Geheimnisse, Scopes und andere Authentifizierungstoken können erforderlich sein, um die OAuth-Authentifizierung erfolgreich abzuschließen. Überprüfen Sie die Dokumentation des Endpunkts für weitere Informationen zu den Anforderungen.
Für diesen Connector werden zwei Szenarien unterstützt. In beiden Szenarien müssen Sie ein Drittanbieter-Tool (wie Postman oder ein ähnliches Tool) verwenden, um das erforderliche Zugriffs-Token oder die Tokens vom beteiligten Endpunkt zu erhalten. Beide Szenarien funktionieren nur für Einzel-Agenten-Gruppen. Dies sind Agentengruppen, die aus einem einzelnen Agenten bestehen.
-
Szenario 1: Verwendung eines OAuth-Zugriffs-Tokens, das nach einer festgelegten Zeit abläuft.
Mit dieser Konfiguration geben Sie ein OAuth-Zugriffs-Token an, das für einen festgelegten Zeitraum gültig ist, wie vom jeweiligen Endpunkt bestimmt. Der Connector verwendet das Token, um die Verbindung herzustellen. Die Verbindung funktioniert jedoch nicht mehr, sobald das Zugriffs-Token abläuft. Sie würden den Connector so konfigurieren, dass er das Token verwendet, indem Sie diese Eigenschaften festlegen:
Konfigurationseigenschaft Wert OAuth initiieren AUS
OAuth-Zugriffs-Token Auf den Wert des vom Endpunkt erhaltenen OAuth-Zugriffs-Tokens setzen -
Szenario 2: Verwendung eines OAuth-Zugriffs-Tokens in Kombination mit einem OAuth-Refresh-Token, um eine automatische Aktualisierung des Zugriffs zu ermöglichen.
Mit dieser Konfiguration verwendet der Connector ein Refresh-Token, um ein neues Zugriffs-Token zu erhalten, sobald das aktuelle Zugriffs-Token abgelaufen ist. Dies ist im Allgemeinen die beste Methode zur Konfiguration von OAuth.
Sie geben ein OAuth-Zugriffs-Token und ein OAuth-Refresh-Token an, wie vom jeweiligen Endpunkt bestimmt. Sie würden den Connector so konfigurieren, dass er diese Tokens verwendet, indem Sie diese Eigenschaften festlegen:
Konfigurationseigenschaft Wert OAuth initiieren AKTUALISIEREN
OAuth-Zugriffs-Token Auf den Wert des vom Endpunkt erhaltenen OAuth-Zugriffs-Tokens setzen OAuth-Refresh-Token Auf den Wert des vom Endpunkt erhaltenen OAuth-Refresh-Tokens setzen
Hinweis
Wenn mehrere OAuth-basierte Microsoft Excel Online-Verbindungen auf demselben privaten Agenten verwendet werden, setzen Sie die Konfigurationseigenschaft OAuthSettingsLocation
auf einen eindeutigen beschreibbaren Agentenpfad für jede Verbindung. In der jitterbit.conf
-Datei für den Agenten setzen Sie EnableLocalFileLocation=true
. Wenn Sie diese beiden Schritte nicht ausführen, verwenden die mehreren Verbindungen denselben Standardpfad und überschreiben sich gegenseitig.
Nächste Schritte
Nachdem eine Verbindung zu einem Microsoft Excel Online-Connector hergestellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfskanvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.
Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Palette der Entwurfskomponenten zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.
Diese Aktivitätstypen sind verfügbar:
-
Abfrage: Ruft Datensätze aus einer Tabelle in Microsoft Excel Online ab und ist als Quelle in einem Vorgang vorgesehen.
-
Erstellen: Fügt einen Datensatz in eine Tabelle in Microsoft Excel Online ein und ist als Ziel in einem Vorgang vorgesehen.
-
Aktualisieren: Aktualisiert einen Datensatz in einer Tabelle in Microsoft Excel Online und ist als Ziel in einem Vorgang vorgesehen.
-
Löschen: Löscht einen Datensatz aus einer Tabelle in Microsoft Excel Online und ist als Ziel in einem Vorgang vorgesehen.
-
Ausführen: Führt ein Verfahren in Microsoft Excel Online aus und ist als Ziel in einem Vorgang vorgesehen.
It seems there was no Markdown content provided for translation. Please provide the text you would like me to translate into German.