Wert formatieren (Format Value)

UiPath.Core.Activities.FormatValue

Weist einem generischen Wert ein bestimmtes Format zu, das mit den Vorgängen .ToString und Parse verwendet werden kann. Die verfügbaren Formate sind Zahl, Datum/Uhrzeit, Währung und Prozent.

Eigenschaften

An (To)

• Wert (Value) - Der zu formatierende Wert. Das Feld unterstützt nur Variablen vom Typ GenerischerWert (GenericValue).

Eingabe

• Format (Format) - Gibt das auf den Wert anzuwendende Format an.

Allgemein

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

Sonstiges

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

Beispiel für die Verwendung der Aktivität „Format Value“

Im folgenden Beispiel wird erläutert, wie Format Value verwendet wird, indem zugewiesene Werte verarbeitet und wie gewünscht formatiert werden.

So kann der Automatisierungsprozess erstellt werden:

1. Öffnen Sie Studio und erstellen Sie einen neuen Prozess.

2. Ziehen Sie einen Sequence-Container in den Workflow-Designer.

   • Erstellen Sie die folgende Variable:

     Variablenname	Variablentyp	Standardwert
     formattedValue	GenericValue

3. Ziehen Sie eine Assign-Aktivität in den Sequence-Container.

   • Fügen Sie die Variable formattedValue im Feld An hinzu.
   • Fügen Sie den Ausdruck DateTime.Now im Feld Wert hinzu, um das tatsächliche Datum zu erhalten.

4. Ziehen Sie eine Format Value-Aktivität unter die Assign-Aktivität.

   • Fügen Sie die Variable formattedValue im Feld Wert hinzu.

5. Klicken Sie in der Aktivität Format Value auf die Schaltfläche Format festlegen, um das Datenformat zu konfigurieren.

   • Wählen Sie die Option String in der Dropdownliste Formattyp aus.
   • Wählen Sie die gewünschte Art der Datumsanzeige in der Dropdownliste Muster aus.
   • Klicken Sie auf die Schaltfläche OK, um den Konfigurator zu schließen.

6. Platzieren Sie eine Log Message-Aktivität unter der Format Value-Aktivität.

   • Wählen Sie die Option Info aus der Dropdown-Schaltfläche Stufe aus.
   • Fügen Sie den Ausdruck "Today is: "+formattedValue im Feld Nachricht hinzu. Dadurch werden die Meldung Heute ist und das tatsächliche Datum im zuvor ausgewählten Format angezeigt.

7. Ziehen Sie eine Assign-Aktivität unter die Log Message-Aktivität.

   • Fügen Sie die Variable formattedValue im Feld An hinzu.
   • Fügen Sie den Wert 19000.1234 im Feld Wert hinzu. Dies stellt den tatsächlichen Wert dar, der für die Formatierung verwendet wird.

8. Ziehen Sie eine Format Value-Aktivität unter die Assign-Aktivität.

   • Fügen Sie die Variable formattedValue im Feld Wert hinzu.

9. Klicken Sie in der Aktivität Format Value auf die Schaltfläche Format festlegen, um das Datenformat zu konfigurieren. Dadurch wird der in der vorherigen Assign-Aktivität hinzugefügte Wert formatiert und die verwendete Anzahl der Dezimalstellen bestimmt.

   • Wählen Sie Option Zahl in der Dropdownliste Formattyp aus.
   • Fügen Sie den Wert 2 im Feld Dezimalstellen hinzu.
   • Wählen Sie die Option . in der Dropdownliste Dezimaltrennzeichen aus.
   • Fügen Sie den Wert , im Feld Gruppentrennzeichen hinzu.
   • Klicken Sie auf die Schaltfläche OK, um den Konfigurator zu schließen.

10. Platzieren Sie eine Log Message-Aktivität unter der Format Value-Aktivität.

    • Wählen Sie die Option Info in der Dropdownliste Stufe aus.
    • Fügen Sie den Ausdruck "This decimal number is: "+formattedValue in das Feld Nachricht ein. Dies zeigt die Meldung Diese Dezimalzahl ist und die tatsächliche Zahl an.

11. Ziehen Sie eine Assign-Aktivität unter die Log Message-Aktivität.

    • Fügen Sie die Variable formattedValue im Feld An hinzu.
    • Fügen Sie den Wert 1.142 in das Feld Wert ein. Dieser Wert stellt die heutige Parität zwischen Euro und Dollar dar.

12. Ziehen Sie eine Format Value-Aktivität unter die Assign-Aktivität.

    • Fügen Sie die Variable formattedValue im Feld Wert hinzu.

13. Klicken Sie in der Aktivität Format Value auf die Schaltfläche Format festlegen, um das Datenformat zu konfigurieren.

    • Wählen Sie Option Währung in der Dropdownliste Formattyp aus.
    • Fügen Sie den Wert 3 im Feld Dezimalstellen hinzu.
    • Wählen Sie die Option . in der Dropdownliste Dezimaltrennzeichen aus.
    • Wählen Sie die Option $ in der Dropdownliste Symbol aus.
    • Fügen Sie den Wert , im Feld Gruppentrennzeichen hinzu.
    • Klicken Sie auf die Schaltfläche OK, um den Konfigurator zu schließen.

14. Platzieren Sie eine Log Message-Aktivität unter der Format Value-Aktivität.

    • Wählen Sie die Option Info aus der Dropdown-Schaltfläche Stufe aus.
    • Fügen Sie den Ausdruck "1 euro is: "+formattedValue in das Feld Nachricht ein. Dies zeigt die Meldung 1 Euro ist und den tatsächlichen Wert von einem Euro, umgerechnet in Dollar, an.

15. Ziehen Sie eine Assign-Aktivität unter die Log Message-Aktivität.

    • Fügen Sie die Variable formattedValue im Feld An hinzu.
    • Fügen Sie den Wert 0.6666 in das Feld Wert ein. Dieser Wert wird verwendet, um den Prozentsatz anzuzeigen, nachdem die Daten formatiert wurden.

16. Ziehen Sie eine Format Value-Aktivität unter die Assign-Aktivität.

    • Fügen Sie die Variable formattedValue im Feld Wert hinzu.

17. Klicken Sie in der Aktivität Format Value auf die Schaltfläche Format festlegen, um das Datenformat zu konfigurieren.

    • Wählen Sie Option Prozent in der Dropdownliste Formattyp aus.
    • Fügen Sie den Wert 2 im Feld Dezimalstellen hinzu.
    • Wählen Sie die Option . in der Dropdownliste Dezimaltrennzeichen aus.
    • Fügen Sie den Ausdruck % in das Feld Symbol ein.
    • Fügen Sie den Ausdruck , in das Feld Gruppentrennzeichen ein.
    • Klicken Sie auf die Schaltfläche OK, um den Konfigurator zu schließen.

18. Platzieren Sie eine Log Message-Aktivität unter der Format Value-Aktivität.

    • Wählen Sie die Option Info in der Dropdownliste Stufe aus.
    • Fügen Sie den Ausdruck "2/3 is: "+formattedValue in das Feld Nachricht ein. Dies zeigt die Meldung 2/3 is und die entsprechende Prozentzahl an.

    • So sollte Ihr Workflow aussehen:

      
      

      

      
      

19. Führen Sie den Automatisierungsprozess aus. Die bereitgestellten Daten werden gemäß den Spezifikationen verarbeitet und im Ausgabebereich angezeigt.

    Beispiel herunterladen