.Zellfarbe abrufen (Get Cell Color)

UiPath.MicrosoftOffice365.Activities.Excel.GetCellColor

Beschreibung

Verwendet die Microsoft Graph Get Range Format API, um die Farbeigenschaften der angegebenen Zellen (CellAddress) in einem Arbeitsblatt (Workbook) (SheetName) abzurufen. Nach dem Abrufen der Farbeigenschaften gibt die Aktivität die Zellenfarbe (Color) als Hex-Wert zurück (z. B. # FFFFFF).

Scopes

Diese Aktivität erfordert die folgenden Scopes:

• Files.Read

ODER

• Files.ReadWrite

ODER

• Files.Read.All

ODER

• Files.ReadWrite.All

ODER

• Sites.Read.All

ODER

• Sites.ReadWrite.All

Projektkompatibilität

Windows – Legacy | Windows

Konfiguration

Eigenschaften

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.

Eingabe

• Zellenadresse – Die Adresse der Zelle. Geben Sie die Adresse einer einzelnen Zelle im A1-Stil ein. Diese Eigenschaft unterstützt keinen Zellbereich (z. B. "A1:A5"). Diese Eigenschaft unterstützt String -Variablen und zeichenfolgenformatierte Werte.
• Blattname - Der Name des Blatts, aus dem Daten gelesen werden. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.
• Arbeitsmappe - Das DriveItem , dessen Daten gelesen werden. Dieses Objekt kann mit der Aktivität Find Files And Folders abgerufen werden. Verwenden Sie die Ausgabeeigenschaftsvariable aus den Aktivitäten Find Files and Folders (First oder Results) oder Create Workbook (Workbook). Wenn Sie die Ausgabeeigenschaft Ergebnisse aus der Aktivität Find Files and Folders verwenden, müssen Sie angeben, welches Element im Array Sie verwenden möchten (z. B. myWorkbooks(0)).

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert. Dieses Feld unterstützt nur boolesche Werte.

Ausgabe

• Farbe - Die Farbe der angegebenen Zelle im HEX-Format. Erforderlich, wenn Sie die Ausgabedaten in nachfolgenden Aktivitäten verwenden möchten.

Wie es funktioniert

Die folgenden Schritte und das folgende Nachrichtensequenzdiagramm sind ein Beispiel dafür, wie die Aktivität von der Entwurfszeit (d. h. den Aktivitätsabhängigkeiten und Eingabe-/Ausgabeeigenschaften) bis zur Laufzeit funktioniert.

1. Führen Sie die Schritte aus.
2. Fügen Sie die Aktivität Microsoft Office 365 Scope zu Ihrem Projekt hinzu.
3. Fügen Sie eine Aktivität hinzu, oder führen Sie einen externen Prozess aus, der ein DriveItem -Objekt ausgibt (z. B. Find Files and Folders, Create Workbook, Copy Item).
4. Fügen Sie die Aktivität Get Cell Color innerhalb der Aktivität Microsoft Office 365 Scope hinzu.
5. Geben Sie Werte für die Eingabeeigenschaften ein.
6. Erstellen und geben Sie die Variable String für die Output-Eigenschaft ein.

7. Führen Sie die Aktivität aus.

   • Ihre Eingabeeigenschaftswerte werden an die GetRangeFormat- API gesendet.
   • Die API gibt den Wert String an Ihre Ausgabeeigenschaftsvariable zurück.