.Zellfarbe abrufen (Get Cell Color)

UiPath.MicrosoftOffice365.Activities.Excel.GetCellColorConnections

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 | Plattformübergreifend

Konfiguration

• Microsoft OneDrive und SharePoint – Die Verbindung für das Microsoft 365-Konto, das in der Aktivität verwendet werden soll.
• Arbeitsmappe - Das Drive-Element des Excel-Dokuments, aus dem Daten gelesen werden.
• Arbeitsmappenbeispiel – Wählen Sie eine Datei mit den gleichen Bereichen wie die Variablendatei aus. Dieses Feld wird sichtbar, wenn Sie Arbeitsmappenvorlage verwenden auswählen.
• Blattname - Der Name des Blatts, aus dem Daten gelesen werden. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.
• Zelladresse – Die Adresse der Zelle. Geben Sie die Adresse einer einzelnen Zelle in A1-Notation ein. Diese Eigenschaft unterstützt keinen Zellbereich (z. B. "A1:A5"). Diese Eigenschaft unterstützt String -Variablen und stringformatierte Werte.
• 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 Ihrem Projekt die Aktivität Microsoft Office 365 Scope hinzu.
3. Fügen Sie eine Aktivität hinzu, oder führen Sie einen externen Prozess aus, der ein DriveItem -Objekt ausgibt (z. B. Dateien und Ordner suchen, Arbeitsmappe erstellen, Element kopieren).
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.