Excel-Anwendungsbereich (Excel Application Scope)

UiPath.Excel.Activities.ExcelApplicationScope

Öffnet eine Excel-Arbeitsmappe und bietet einen Bereich für Excel-Aktivitäten. Wenn die Ausführung dieser Aktivität endet, werden die Arbeitsmappe und die Excel-Anwendung geschlossen. Wenn eine Variable WorkbookApplication im Feld > Workbook bereitgestellt wird, wird die Arbeitsmappe nicht geschlossen, nachdem die Aktivität beendet wurde. Wenn die angegebene Datei nicht vorhanden ist, wird eine neue Excel-Datei erstellt. Diese Aktivität kann nur verwendet werden, wenn Microsoft Excel auf Ihrem Computer installiert ist.

Eigenschaften

Hinweis:

• Alle Zeichenfolgen müssen in Anführungsstriche gesetzt werden.
• Bei Verwendung von Office 365 öffnet die Aktivität Excel-Dateien in einer neuen Instanz, wenn Excel Application Scope ausgeführt wird, bevor die Excel-Dateien manuell geöffnet werden.

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.

Datei

• PasswortBearbeiten (EditPassword) - Das erforderliche Passwort zum Bearbeiten von passwortgeschützten Excel-Arbeitsmappen, falls erforderlich. Nur Variablen vom Typ Zeichenfolge (String) und Zeichenfolgen werden unterstützt.
• Passwort (Password) - Das erforderliche Passwort zum Öffnen von passwortgeschützten Excel-Arbeitsmappen, falls erforderlich. Nur Variablen vom Typ Zeichenfolge (String) und Zeichenfolgen werden unterstützt.
• DateiPfad (WorkbookPath) - Der vollständige Pfad der zu verwendenden Excel-Tabellenkalkulation. Wenn die zu verwendende Excel-Datei in einem Projektordner liegt, wird der relative Pfad verwendet. Nur Variablen vom Typ Zeichenfolge (String) und Zeichenfolgen werden unterstützt.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Optionen

• Erstellen, wenn nicht vorhanden – Wenn die Arbeitsmappe beim angegebenen Pfad nicht gefunden wird, wird eine neue Excel-Arbeitsmappe mit dem Namen erstellt, der im Eigenschaftsfeld „Arbeitsmappenpfad“ angegeben ist. Wenn diese Option deaktiviert ist, wird eine Ausnahme ausgelöst, die den Benutzer darüber informiert, wenn die Arbeitsmappe unter dem angegebenen Pfad nicht gefunden werden kann. Standardmäßig ist dieses Kontrollkästchen aktiviert.

• Zeitraum des Instanz-Caches – So lange soll der Excel-Prozess nach der Ausführung aller untergeordneten Aktivitäten weiterlaufen. Der Standardwert beträgt 3.000 ms. Wenn die Aktivität innerhalb einer Schleife verwendet wird (z. B. in einer For Each-Aktivität) oder wenn mehrere „Excel Application Scope“-Aktivitäten hintereinander verwendet werden, verhindert dies Fehler, die durch das Beenden des Excel-Prozesses beim Öffnen der nächsten Datei verursacht werden können. Um Excel so schnell wie möglich herunterzufahren, legen Sie den Wert auf 0 fest.

  Hinweis: Wenn Sie mit mehreren Dateien arbeiten, besteht die Möglichkeit, dass diese Racebedingung einen Fehler verursacht, wenn Sie UiPath die Verwaltung der Lebensdauer des Excel-Prozesses überlassen. Um dies zu verhindern, empfehlen wir, eine übergeordnete Excel Application Scope-Aktivität zu erstellen, die Ausgabe -Arbeitsmappe als Variable zu speichern, alle anderen Excel Application Scope-Aktivitäten in dieser übergeordneten Aktivität zu platzieren und die WorkbookApplication-Variable als Eingabe für die ExistingWorkbook -Eigenschaft in allen untergeordneten Scope-Aktivitäten wiederzuverwenden . Dadurch wird sichergestellt, dass Excel so lange ausgeführt wird, wie die Automatisierung Excel verwendet.

• Makroeinstellung – Gibt die Makroebene für die aktuelle Excel-Datei an. Standardmäßig ist AlleAktivieren ausgewählt. Die Dropdownliste enthält die folgenden drei Optionen:

  • EnableAll (EnableAll) – Alle Makros sind aktiviert und können ausgeführt werden.
  • Alle deaktivieren (DisableAll) – Alle Makros sind in der angegebenen Excel-Datei deaktiviert. Es können keine Makros ausgeführt werden.
  • ReadFromExcelSettings – Liest die aktuellen Excel-Makroeinstellungen.
• Schreibgeschützt (Read-Only) - öffnet die angegebene Arbeitsmappe im schreibgeschützten Modus. Durch Markieren dieses Kontrollfeldes können Sie Datenextraktions-Operationen in einer Excel-Datei durchführen, die zum Bearbeiten gesperrt ist oder ein Bearbeitungspasswort hat. Standardmäßig ist dieses Kontrollfeld nicht markiert.
• Änderungen speichern – Speichert automatisch die Arbeitsmappe bei jeder von einer Aktivität verursachten Änderung. Falls ausgeschaltet, werden Änderungen nach Ausführung des Excel Application Scope nicht gespeichert. Standardmäßig ist dieses Kontrollkästchen aktiviert.
• Als Prozess starten – Bei „true“ wird Excel als neuer Prozess geöffnet.
• Sichtbar (Visible) - Bei Auswahl wird die Excel-Datei beim Ausführen von Aktionen im Vordergrund geöffnet. Wenn die Datei geleert wird, werden alle Vorgänge im Hintergrund ausgeführt.

Ausgabe

• Arbeitsmappe (Workbook) - Die gesamten Informationen aus einer Excel-Tabellenkalkulation, die in einer Variablen vom Typ AnwendungArbeitsmappe (WorkbookApplication) gespeichert werden. Diese Variable kann nur in einer anderen Aktivität vom Typ Excel-Anwendungsumfang (Excel Application Scope) verwendet werden. Nur Variablen vom Typ AnwendungArbeitsmappe (WorkbookApplication) werden unterstützt.

Bestehende Arbeitsmappe verwenden (Use Existing Workbook)

• BestehendeArbeitsmappe (ExistingWorkbook) - Verwendet die Daten aus einer Excel-Datei, die vorher in einer Variablen vom Typ AnwendungArbeitsmappe (WorkbookApplication) gespeichert war. Nur Variablen vom Typ AnwendungArbeitsmappe (WorkbookApplication) werden unterstützt.

Verwendungsbeispiel der Aktivität „Excel Application Scope“

Um die Verwendung dieser Aktivität zu veranschaulichen, haben wir ein Automatisierungsprojekt erstellt, das unter anderem eine „ Excel Application Scope “-Aktivität enthält. Sie können den Workflow hierherunterladen.