Dienstprogramme – Transformationsfunktionen

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 von Dienstprogrammen erfordern eine Array-, Name-Wert-Paar-, Zeichenfolge-, Ganzzahl- oder Auswahleingabedatenpille. Stellen Sie sicher, dass Sie die richtige Eingabe verwenden Datenpillentyp Beim Anwenden von Dienstprogrammen Transformationsfunktionen. Wenn eine Utility-Transformationsfunktion auf einen falschen Datentyp angewendet wird, werden die Daten zur Laufzeit nicht umgewandelt, und stattdessen wird der Eingabewert zurückgegeben. Weitere Informationen zum Bestätigen Ihrer Flow-Laufzeitwerte finden Sie unter Testen Sie einen Flow .

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 gefunden

Element aus Array abrufen

Gibt ein komplexes Objekt aus dem Eingabe-Array zurück. Geben Sie einen Wert für ein Nth ItemIm Eingabe-Array, das Sie zurückgeben möchten. Die Nth ItemStellt 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 Wert, der zurückgegeben wird, wenn kein übereinstimmender Schlüssel vorhanden ist	Zeichenfolge, die dem übereinstimmenden Schlüssel zugeordnet ist

Hinweis:

Beachten Sie beim Anwenden der Transformationsfunktion „Element aus Name/Werte abrufen“, dass der Laufzeitwert möglicherweise der Systemwert und nicht der Anzeigewert sein kann. Beispiel: Wenn Sie zuordnen Priorität Feld in der Incident-Tabelle wie ein ähnliches Feld in einer Remote-Tabelle. Der zurückgegebene Laufzeitwert kann 2 sein, nicht 2 – hoch.

Beispielverwendung:

• Eingabe: „Anwendername“:„abel.tuter“
• Schlüssel: Anwendername
• Standard: example.username
• Ausgabe: abel.tuter

In diesem Beispiel führt eine Aktion einen REST-Aufruf an ein Drittparteisystem durch und ruft Ticketdaten als Zuordnung von Name-Wert-Paaren ab. 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 zugeordnet ist Ticket_ID Schlüssel oder Ticket-ID nicht gefunden .

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 gefunden

Ist Leer

Gibt Zurück Wahr 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 ist Falsch .

Hinweis:

Diese Transformationsfunktion unterstützt keine Referenzeingaben.

Eingabedatenpille	Ausgabe
Beliebig	Gibt Zurück Wahr Oder Falsch

Beispielverwendung:

• Eingabe: Eine Ganzzahldatenpille mit 0
• Ausgabe: Wahr

Ist Falsch

Gibt Zurück Wahr 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 ist Falsch .

Eingabedatenpille	Ausgabedatenpille
Beliebig	Gibt Zurück Wahr Oder Falsch

Beispielverwendung:

• Eingabe: Eine Ganzzahldatenpille mit 13
• Ausgabe: Falsch

Ist Nicht Leer

Gibt Zurück Wahr Wenn die Eingabe nicht leer ist. Eine Zeichenfolge ist nicht leer, wenn sie keine leere Zeichenfolge ist. Eine Ganzzahl ist nicht leer, wenn sie nur Null ist. Eine boolesche Eingabe ist nicht leer, wenn sie ist Wahr .

Hinweis:

Diese Transformationsfunktion unterstützt keine Referenzeingaben.

Eingabedatenpille	Ausgabedatenpille
Beliebig	Gibt Zurück Wahr Oder Falsch

Beispielverwendung:

• Eingabe: Eine Ganzzahldatenpille mit 13
• Ausgabe: Wahr

Ist Null

Gibt Zurück Wahr Wenn der Eingabewert null ist. Eine Eingabe ist null, wenn sie nicht initialisiert wurde oder wenn es sich um ein Null-Objekt oder eine Null-Referenz handelt.

Eingabedatenpille	Ausgabe
Beliebig	Gibt Zurück Wahr Oder Falsch

Beispielverwendung:

• Eingabe: Eine Ganzzahldatenpille mit 725
• Ausgabe: Falsch

Ist „Wahr“

Gibt Zurück Wahr Wenn die Eingabe „wahr“ ist. Eine Zeichenfolge ist „wahr“, wenn sie keine leere Zeichenfolge ist. Eine Ganzzahl ist „wahr“, wenn sie nichts als null ist. Eine boolesche Eingabe ist „wahr“, wenn sie ist Wahr .

Eingabedatenpille	Ausgabedatenpille
Beliebig	Gibt Zurück Wahr Oder Falsch

Beispielverwendung:

• Eingabe: Eine Ganzzahldatenpille mit 13
• Ausgabe: Wahr

Schlüsselwertzuordnung

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

Eingabedatenpille	Parameter	Ausgabedatenpille
Zeichenfolge oder Ganzzahl	Name – Der Schlüssel, der zum Suchen des entsprechenden Werts verwendet wird Value – Der Wert, der mit einem bestimmten Schlüssel übereinstimmt Default – Der Wert, der zurückgegeben wird, wenn kein übereinstimmender Name vorhanden ist	Zeichenfolge, die dem übereinstimmenden Schlüssel zugeordnet ist

Beispielverwendung:

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

Sortieren

Sortiert das angegebene Array in aufsteigender oder absteigender Reihenfolge.

Eingabedatenpille	Parameter	Ausgabedatenpille
Array.Zeichenfolge, Array.Integer, Array.Boolean oder Array.Datetime. – Nicht sortiertes Array	Sort Order – Aufsteigend oder absteigend	Array: Sortiertes Array

Hinweis:

Bei der Sortierfunktion wird die Groß-/Kleinschreibung für Array.Zeichenfolgen beachtet.

Beispielverwendung:

• Eingabe: [7, 2, 3, 1, 7, 9]
• Parameter: Aufsteigend
• Ausgabe: [1, 2, 3, 7, 7, 7, 9]

Eindeutig

Entfernt die doppelten Elemente aus dem angegebenen Array.

Eingabedatenpille	Ausgabedatenpille
Array.Zeichenfolge, Array.Integer, Array.Boolean oder Array.Datetime.	Array: Nachdem duplizierte Elemente entfernt wurden

Beispielverwendung:

• 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.Zeichenfolge, 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.

Beispielverwendung:

• Eingabe: [1, 2, 3]
• Parameter: <
• Ausgabe: 1<2<3