Excel-APIs

Mit APIs können Sie auf die Dienste zugreifen und mit ihnen interagieren, die im Menü Pakete verwalten angeboten werden. Sie können diese APIs verwenden, wenn Sie codierte Automatisierungen entwerfen. Unter Codierte Automatisierungen erfahren Sie mehr über codierte Automatisierungen und wie sie mit APIs gestaltet werden können.

Hinweis: Mit Zu Definition wechseln (F12) können Sie auf die Definition von UiPath-APIs für einen bestimmten Dienst zugreifen. Es wird empfohlen, sich beim Implementieren codierter Automatisierungen nur auf die direkt verfügbar gemachten APIs zu verlassen. Andere APIs, die nicht direkt mit einem Dienst verknüpft sind, können ohne vorherige Ankündigung geändert werden.

Überladungen

APIs enthalten oft Überladungen, was bedeutet, dass sie mehrere Versionen der gleichen Methode mit unterschiedlichen Parameteroptionen bereitstellen. Mit Überladungen können Sie das Verhalten der API basierend auf Ihren spezifischen Anforderungen anpassen. Beispielsweise kann eine UI-Automatisierungs-API eine Überladung enthalten, die einen Timeout-Parameter akzeptiert, um die maximale Zeit anzugeben, die gewartet werden soll, bis ein UI-Element angezeigt wird, bevor die Ausführung beendet wird.

Durch die Verwendung der APIs mit ihren jeweiligen Überladungen können Sie ganz einfach die gewünschte Automatisierungslogik und das gewünschte Verhalten erreichen.

Verwenden von APIs

Um die Excel-APIs zu verwenden, führen Sie die folgenden Schritte aus:

1. Laden Sie das Aktivitätspaket herunter.
2. Erstellen Sie einen codierten Workflow.
3. Rufen Sie die Methode excel.UseExcelFile auf, um das Handle einer Excel-Datei abzurufen.
   Hinweis: Standardmäßig verwendet die excel.UseExcelFile-Methode die Excel-Optionen aus den Projekteinstellungen für das resultierende Handle. Sie können das Verhalten jedoch ändern, indem Sie die Standardoptionen mit der excel.ExcelProcessScope-Methode überschreiben.
4. Verwenden Sie das Handle, um Aktionen auszuführen. Mit der codierten Excel-Automatisierung sollten Sie in der Lage sein, die gleichen Vorgänge wie mit den modernen Excel-Aktivitäten in einer .xaml-Datei auszuführen.
   Hinweis: Das zurückgegebene IExcelProcess-Handle kann mit UseExcelFile verwendet werden, um die Excel-Anwendung besser zu steuern. Sie können beispielsweise steuern, wie Excel beim Beenden geöffnet oder geschlossen wird.
5. Bei Arbeitsmappenaktivitäten verwenden Sie die Methode excel.UseWorkBook, um das Handle einer Excel-Datei abzurufen. Die verfügbaren Aktivitäten werden auch als Erweiterungsmethoden für die ExcelOperations-Klasse implementiert.

Hinweis: Die Excel-Aktivitäten sind im codierten Dienst als Erweiterungsmethoden für Handles implementiert. Um alle verfügbaren Erweiterungsmethoden zu überprüfen, geben Sie ExcelOperations. und dann Strg + Leertaste ein.

Beispiele

• UseExcelFile_1.Simple.cs – Überprüfen Sie alle verfügbaren Erweiterungsmethoden für Handles.
• UseExcelFile_2MoreOptions.cs, UseExcelFile_3AllOptions.cs – Verwenden Sie das IExcelProcess-Handle, um die Excel-Anwendung besser zu steuern.
• UseWorkbook_4.cs – So wird ein Excel-Arbeitsmappen-Handle ab gerufen.
• UseExcelFile_Filter.cs – So wird Excel gefiltert.
• UseExcelFile_PivotTable.cs – So wird eine Pivot-Tabelle erstellt und gefiltert.
• UseExcelFile-ExecuteMacro.cs – So wird ein Makro ausgeführt.

Die genannten Beispiele finden Sie im GitHub-Speicherort.