Utilities-Transformationsfunktionen

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 4 Minuten Lesedauer

    • Verwenden Sie Transformationsfunktionen für Dienstprogramme, um ein komplexes Objekt aus einem Array oder einen Wert zurückzugeben, der einem bestimmten Schlüssel zugeordnet ist.

    Transformationsfunktionen für Dienstprogramme erfordern eine Array-, Name-Wert-Paar-, Zeichenfolge-, Ganzzahl- oder Auswahl-Eingabedatenpille. Stellen Sie sicher, dass Sie den richtigen Eingabedatenpillentyp verwenden, wenn Sie Transformationsfunktionen für Dienstprogramme anwenden. Wenn eine Utility-Transformationsfunktion auf einen unzulässigen Datentyp angewendet wird, werden die Daten zur Laufzeit nicht transformiert, und stattdessen wird der Eingabewert zurückgegeben. Weitere Informationen zum Bestätigen der Flow-Laufzeitwerte finden Sie unter Flows testen.

    Erstes Element aus dem Array abrufen

    Gibt das erste Element aus dem Eingabe-Array als komplexes Objekt zurück.

    Eingabedatenpille Ausgabedatenpille
    Array Complex Object – Erstes Element im Eingabe-Array

    Element aus Array abrufen

    Gibt ein komplexes Objekt aus dem Eingabe-Array zurück. Geben Sie einen Wert für Nth Item im Eingabe-Array ein, den Sie zurückgeben möchten. Nth Item stellt den Array-Index dar, beginnend bei 0.

    Eingabedatenpille Parameter Ausgabedatenpille
    Array Nth Item Geben Sie den Index des Zielobjekts im Eingabe-Array ein. Der Array-Index beginnt bei 0. Komplexes Objekt

    Element aus Name/Werten abrufen

    Gibt einen Wert zurück, der einem übereinstimmenden Schlüssel aus einer Zuordnung von Name-Wert-Paaren zugeordnet ist.

    Eingabedatenpille Parameter Ausgabedatenpille
    Name/Wert-Paare
    • Key Name des Schlüssels, der zum Suchen des entsprechenden Werts verwendet wird
    • Default – Der zurückgegebene Wert, wenn kein passender Schlüssel vorhanden ist
    		 Zeichenfolge, die dem übereinstimmenden Schlüssel zugeordnet ist
    Hinweis:
    Berücksichtigen Sie bei der Anwendung der Transformationsfunktion „Element aus Name/Werten abrufen“, dass der Laufzeitwert möglicherweise der Systemwert und nicht der Anzeigewert ist. Wenn Sie beispielsweise das Feld Priorität in der Incident-Tabelle einem ähnlichen Feld in einer Remote-Tabelle zuordnen, lautet der zurückgegebene Laufzeitwert möglicherweise 2 und nicht 2 - Hoch.
    Abbildung : 1. Beispiel
    • Eingabe: "username":"abel.tuter"
    • Schlüssel: Benutzername
    • Standard: beispiel.benutzername
    • Ausgabe: abel.tuter

    In diesem Beispiel führt eine Aktion einen REST-Aufruf bei einem Drittanbietersystem durch und GET-Ticketdaten als Zuordnung von Name-Wert-Paaren. Eine Ticket-ID wird als Ausgabe für diese Aktion bereitgestellt. Die Transformationsfunktion „Element aus Name/Werten abrufen“ gibt entweder den Wert zurück, der dem Schlüssel ticket_id zugeordnet ist, oder Ticket-ID nicht gefunden.

    Zugeordneter Wert für Schlüssel „ticket_id“ oder „Ticket-ID nicht gefunden“, die als Aktionsausgabe zurückgegeben wird.

    Letztes Element aus dem Array abrufen

    Gibt das letzte Element aus dem Eingabe-Array als komplexes Objekt zurück.

    Eingabedatenpille Ausgabedatenpille
    Array Complex Object Letztes Element im Eingabe-Array

    Ist leer

    Gibt „ true “ zurück, wenn die Eingabe leer ist. Eine Zeichenfolgeneingabe ist leer, wenn sie eine leere Zeichenfolge ist. Eine Ganzzahleingabe ist leer, wenn sie Null ist. Eine boolesche Eingabe ist leer, wenn sie „ false“ ist.

    Eingabedatenpille Ausgabe
    Beliebig Gibt „ true “ oder „false“zurück
    Abbildung : 2. Beispiel
    • Eingabe: eine ganzzahlige Datenpille mit 0
    • Ausgabe: true

    Ist „falsch“.

    Gibt „ true “ zurück, wenn die Eingabe „false“ ist. Eine Zeichenfolge ist „false“, wenn sie eine leere Zeichenfolge ist. Eine Ganzzahl ist falsch, wenn sie null ist. Eine boolesche Eingabe ist „false“, wenn sie „ false“ ist.

    Eingabedatenpille Ausgabedatenpille
    Beliebig Gibt „ true “ oder „false“zurück
    Abbildung : 3. Beispiel
    • Eingabe: eine ganzzahlige Datenpille mit 13
    • Ausgabe: false

    Ist nicht leer

    Gibt „ true “ zurück, wenn die Eingabe nicht leer ist. Eine Zeichenfolge ist nicht leer, wenn sie keine leere Zeichenfolge ist. Eine Ganzzahl ist nicht leer, wenn sie etwas anderes als null ist. Eine boolesche Eingabe ist nicht leer, wenn sie trueist.

    Eingabedatenpille Ausgabedatenpille
    Beliebig Gibt „ true “ oder „false“zurück
    Abbildung : 4. Beispiel
    • Eingabe: eine ganzzahlige Datenpille mit 13
    • Ausgabe: true

    Ist null

    Gibt „ true “ zurück, wenn der Eingabewert NULL ist. Eine Eingabe ist NULL, wenn sie nicht initialisiert wurde oder wenn sie ein NULL-Objekt oder eine NULL-Referenz ist.

    Eingabedatenpille Ausgabe
    Beliebig Gibt „ true “ oder „false“zurück
    Abbildung : 5. Beispiel
    • Eingabe: eine ganzzahlige Datenpille mit 725
    • Ausgabe: false

    Ist „Wahr“.

    Gibt „ true “ zurück, wenn die Eingabe „true“ ist. Eine Zeichenfolge ist „true“, wenn sie keine leere Zeichenfolge ist. Eine Ganzzahl ist „true“, wenn sie etwas anderes als Null ist. Eine boolesche Eingabe ist „true“, wenn sie „ true“ ist.

    Eingabedatenpille Ausgabedatenpille
    Beliebig Gibt „ true “ oder „false“zurück
    Abbildung : 6. Beispiel
    • Eingabe: eine ganzzahlige Datenpille mit 13
    • Ausgabe: true

    Schlüsselwertzuordnung

    Gibt einen Wert zurück, der einem übereinstimmenden Schlüssel zugeordnet ist, oder einen Standardwert, wenn keine Übereinstimmung vorliegt.

    Eingabedatenpille Parameter Ausgabedatenpille
    Zeichenfolge oder Ganzzahl
    • Name Schlüssel, der verwendet wird, um den entsprechenden Wert zu finden
    • Value – Der Wert, der mit einem bestimmten Schlüssel übereinstimmt
    • Default – Der zurückgegebene Wert, wenn kein übereinstimmender Name vorhanden ist
    		 Zeichenfolge, die dem übereinstimmenden Schlüssel zugeordnet ist
    Abbildung : 7. Beispiel

    In diesem Beispiel speichert eine Protokollaktion die Priorität eines Datensatzes als Nachricht. Im Abschnitt Name-Values wird jede Priorität einem entsprechenden Zeichenfolgenwert zugeordnet. Wenn der Flow ausgeführt wird, wird die Priorität des Datensatzes in eine Zeichenfolge umgewandelt, und die Zeichenfolge wird in einer Nachricht protokolliert.

    Eine Schlüssel-Wert-Zuordnung wandelt einen Wert von einer Zahl in eine Zeichenfolge um.

    Sortieren

    Sortiert das angegebene Array in aufsteigender oder absteigender Reihenfolge.

    Eingabedatenpille Parameter Ausgabedatenpille
    Array.String, Array.Integer, Array.Boolean oder Array.Datetime. Unsortiertes Array Sort Order - Aufsteigend oder absteigend Array: Sortiertes Array
    Hinweis:
    Bei der Sortierfunktion wird für array.strings zwischen Groß- und Kleinschreibung unterschieden.
    Abbildung : 8. Beispiel
    • Eingabe: [7, 2, 3, 1, 7, 9]
    • Parameter: Aufsteigend
    • Ausgabe: [1, 2, 3, 7, 7, 9]

    Eindeutig

    Entfernt die doppelten Elemente aus dem angegebenen Array.
    Eingabedatenpille Ausgabedatenpille
    Array.String, Array.Integer, Array.Boolean oder Array.Datetime. Array – Nachdem doppelte Elemente entfernt wurden
    Abbildung : 9. Beispiel
    • Eingabe: [7, 2, 3, 2, 7, 9]
    • Ausgabe: [7, 2, 3, 9]

    Teilnehmen

    Verkettet die einzelnen Elemente des angegebenen Arrays mit dem angegebenen Trennzeichen und gibt die verkettete Zeichenfolge zurück.

    Eingabedatenpille Parameter Ausgabedatenpille
    Array.String, Array.Integer, Array.Boolean oder Array.Datetime. Trennzeichen: Zeichen, das die einzelnen Elemente nach der Verkettung trennt. Zeichenfolge: Zeichenfolge, nachdem ein Trennzeichen hinzugefügt wurde.
    Abbildung : 10. Beispiel
    • Eingabe: [1, 2, 3]
    • Parameter: <
    • Ausgabe: 1<2<3