Mit Dienstprogrammen werden Funktionen transformiert

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 4 Minuten Lesedauer

    • Verwenden Sie die Transformationsfunktionen von Dienstprogrammen, 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 Eingabedatenpille vom Typ Array, Name/Wert-Paar, Zeichenfolge, Ganzzahl oder Auswahl. Stellen Sie sicher, dass Sie den richtigen Eingabedatenpillentyp verwenden, wenn Sie Transformationsfunktionen für Dienstprogramme anwenden. Wenn die Transformationsfunktion eines Dienstprogramms auf einen unzulässigen Datentyp angewendet wird, werden die Daten zur Laufzeit nicht umgewandelt. Stattdessen wird der Eingabewert zurückgegeben. Weitere Informationen zum Bestätigen der Werte für die Flow-Laufzeit finden Sie unter Flow 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 in das Eingabe-Array ein, das 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/Werte 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 übereinstimmender Schlüssel vorhanden ist
    		 Zeichenfolge, die dem übereinstimmenden Schlüssel zugeordnet ist
    Hinweis:
    Beachten Sie bei der Anwendung der Transformationsfunktion „Element aus Name/Werten abrufen“ daran, 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 Remotetabelle zuordnen, lautet der zurückgegebene Laufzeitwert möglicherweise 2 und nicht 2 - Hoch.
    Abbildung : 1. Beispiel
    • Eingabe: „username":"abel.tuter“
    • Schlüssel: username
    • Standard: beispiel.username
    • Ausgabe: abel.tuter

    In diesem Beispiel führt eine Aktion einen REST-Aufruf an ein Drittparteisystem 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/Werte abrufen“ gibt entweder den Wert zurück, der dem Schlüssel „ticket_id“ zugeordnet ist, oder die Ticket-ID wurde nicht gefunden.

    Zugeordneter Wert für Schlüssel „ticket_id“ oder „Ticket-ID nicht gefunden“, der 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 „ wahr “ zurück, wenn die Eingabe leer ist. Eine Zeichenfolgeneingabe ist leer, wenn es sich um eine leere Zeichenfolge handelt. Eine Ganzzahleingabe ist leer, wenn sie Null ist. Eine boolesche Eingabe ist leer, wenn sie auf „ falsch“ festgelegt ist.

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

    Ist „Falsch“.

    Gibt „ wahr “ zurück, wenn die Eingabe „falsch“ ist. Eine Zeichenfolge ist „falsch“, wenn sie eine leere Zeichenfolge ist. Eine Ganzzahl ist „falsch“, wenn sie Null ist. Eine boolesche Eingabe ist „falsch“, wenn sie den Wert „ falsch“ aufweist.

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

    Ist nicht leer

    Gibt „ wahr “ 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 ist 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 Ganzzahl-Datenpille mit 725
    • Ausgabe: false

    Ist „Wahr“.

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

    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 zum Suchen des entsprechenden Werts verwendet wird
    • Value Der Wert, der einem bestimmten Schlüssel entspricht
    • 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ätszahl 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:
    Sortierfunktion berücksichtigt Groß-/Kleinschreibung für array.strings.
    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 duplizierte 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