---
sourceDocument: Xanadu-Build-Workflows
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/build-workflows

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-Build-Workflows

ft:clusterId :

    - crworkflow

bundleId :

    - crworkflow

workflow :

    - Creator


---

# Mit Dienstprogrammen werden Funktionen transformiert

# Mit Dienstprogrammen werden Funktionen transformiert {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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,](https://servicenow-prod.fluidtopics.net/mibKO7y~Yy5KMvU9QjZQUA "Aktionen und Subflows verwenden Variablen zum Speichern von Eingabe- und Ausgabedaten. Der Datentyp der Variable bestimmt, welche Art von Daten gespeichert werden und welche erweiterten Konfigurationsoptionen sie hat.") 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](https://servicenow-prod.fluidtopics.net/qmlOq7vvK6cXTUIFfxbBFw "Bevor Sie einen Ablauf aktivieren, damit andere Benutzer darauf zugreifen können, testen Sie, ob er so funktioniert, wie Sie es erwarten.").

## Erstes Element aus dem Array abrufen {#utilities-transform-functions__section_o45_hr4_mpb}

Gibt das erste Element aus dem Eingabe-Array als komplexes Objekt zurück.  
{#utilities-transform-functions__table_ldp_nr4_mpb__entry__2}

| Eingabedatenpille | Ausgabedatenpille |
|-|-|
| Array | Complex Object Erstes Element im Eingabe-Array |
[ ]

{#utilities-transform-functions__table_ldp_nr4_mpb}

## Element aus Array abrufen {#utilities-transform-functions__section_gzk_jvz_jjb}

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.  
{#utilities-transform-functions__table_psj_ddn_mkb__entry__3}

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

{#utilities-transform-functions__table_psj_ddn_mkb}

## Element aus Name/Werte abrufen {#utilities-transform-functions__section_ljc_xdn_mkb}

Gibt einen Wert zurück, der einem übereinstimmenden Schlüssel aus einer Zuordnung von Name-Wert-Paaren zugeordnet ist.  
{#utilities-transform-functions__table_mjc_xdn_mkb__entry__3}

| 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 {#utilities-transform-functions__ul_njc_xdn_mkb} | Zeichenfolge, die dem übereinstimmenden Schlüssel zugeordnet ist |
[ ]

{#utilities-transform-functions__table_mjc_xdn_mkb}  
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`

{#utilities-transform-functions__ul_ojc_xdn_mkb}

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`.

## Letztes Element aus dem Array abrufen {#utilities-transform-functions__section_gjx_3r4_mpb}

Gibt das letzte Element aus dem Eingabe-Array als komplexes Objekt zurück.  
{#utilities-transform-functions__table_ln2_xr4_mpb__entry__2}

| Eingabedatenpille | Ausgabedatenpille |
|-|-|
| Array | Complex Object Letztes Element im Eingabe-Array |
[ ]

{#utilities-transform-functions__table_ln2_xr4_mpb}

## Ist leer {#utilities-transform-functions__section_ttk_fqd_qnb}

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.  
{#utilities-transform-functions__table_zg3_lqd_qnb__entry__2}

| Eingabedatenpille | Ausgabe |
|-|-|
| Beliebig | Gibt „ true " oder „false"zurück |
[ ]

{#utilities-transform-functions__table_zg3_lqd_qnb}  
Abbildung : 2. Beispiel

* Eingabe: eine ganzzahlige Datenpille mit `0`
* Ausgabe: `true`
{#utilities-transform-functions__ul_rp1_4qd_qnb}

## Ist „Falsch". {#utilities-transform-functions__section_gx5_jr4_mpb}

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.  
{#utilities-transform-functions__table_qjg_c54_mpb__entry__2}

| Eingabedatenpille | Ausgabedatenpille |
|-|-|
| Beliebig | Gibt „ true " oder „false"zurück |
[ ]

{#utilities-transform-functions__table_qjg_c54_mpb}  
Abbildung : 3. Beispiel

* Eingabe: eine ganzzahlige Datenpille mit `13`
* Ausgabe: `false `
{#utilities-transform-functions__ul_sjg_c54_mpb}

## Ist nicht leer {#utilities-transform-functions__section_kxk_kr4_mpb}

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.  
{#utilities-transform-functions__table_n4k_js4_mpb__entry__2}

| Eingabedatenpille | Ausgabedatenpille |
|-|-|
| Beliebig | Gibt „ true " oder „false"zurück |
[ ]

{#utilities-transform-functions__table_n4k_js4_mpb}  
Abbildung : 4. Beispiel

* Eingabe: eine ganzzahlige Datenpille mit `13`
* Ausgabe: `true`
{#utilities-transform-functions__ul_u35_ms4_mpb}

## Ist Null {#utilities-transform-functions__section_k3b_gqd_qnb}

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.  
{#utilities-transform-functions__table_wrn_rqd_qnb__entry__2}

| Eingabedatenpille | Ausgabe |
|-|-|
| Beliebig | Gibt „ true " oder „false"zurück |
[ ]

{#utilities-transform-functions__table_wrn_rqd_qnb}  
Abbildung : 5. Beispiel

* Eingabe: eine Ganzzahl-Datenpille mit `725`
* Ausgabe: `false `
{#utilities-transform-functions__ul_t1k_tqd_qnb}

## Ist „Wahr". {#utilities-transform-functions__section_krb_lr4_mpb}

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.  
{#utilities-transform-functions__table_amb_wt4_mpb__entry__2}

| Eingabedatenpille | Ausgabedatenpille |
|-|-|
| Beliebig | Gibt „ true " oder „false"zurück |
[ ]

{#utilities-transform-functions__table_amb_wt4_mpb}  
Abbildung : 6. Beispiel

* Eingabe: eine ganzzahlige Datenpille mit `13`
* Ausgabe: `true`
{#utilities-transform-functions__ul_m55_yt4_mpb}

## Schlüsselwertzuordnung {#utilities-transform-functions__section_irr_r4g_ykb}

Gibt einen Wert zurück, der einem übereinstimmenden Schlüssel zugeordnet ist, oder einen Standardwert, wenn keine Übereinstimmung vorliegt.  
{#utilities-transform-functions__table_qqy_yqg_ykb__entry__3}

| 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 {#utilities-transform-functions__ul_pw3_psg_ykb} | Zeichenfolge, die dem übereinstimmenden Schlüssel zugeordnet ist |
[ ]

{#utilities-transform-functions__table_qqy_yqg_ykb}  
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.

## Sortieren {#utilities-transform-functions__section_sgj_wvj_hrb}

Sortiert das angegebene Array in aufsteigender oder absteigender Reihenfolge.
{#utilities-transform-functions__table_y4r_fwj_hrb__entry__3}

| Eingabedatenpille | Parameter | Ausgabedatenpille |
|-|-|-|
| Array.String, Array.Integer, Array.Boolean oder Array.Datetime Unsortiertes Array | Sort Order Aufsteigend oder absteigend | Array: Sortiertes Array |
[ ]

{#utilities-transform-functions__table_y4r_fwj_hrb}  
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]`
{#utilities-transform-functions__ul_rx1_xwj_hrb}

## Eindeutig {#utilities-transform-functions__section_wkn_f1k_hrb}

Entfernt die doppelten Elemente aus dem angegebenen Array.{#utilities-transform-functions__table_lww_m1k_hrb__entry__2}

| Eingabedatenpille | Ausgabedatenpille |
|-|-|
| Array.String, Array.Integer, Array.Boolean oder Array.Datetime | Array: Nachdem duplizierte Elemente entfernt wurden |
[ ]

{#utilities-transform-functions__table_lww_m1k_hrb}
Abbildung : 9. Beispiel

* Eingabe: `[7, 2, 3, 2, 7, 9]`
* Ausgabe: `[7, 2, 3, 9]`
{#utilities-transform-functions__ul_uhx_w1k_hrb}

## Teilnehmen {#utilities-transform-functions__section_ns2_4bk_hrb}

Verkettet die einzelnen Elemente des angegebenen Arrays mit dem angegebenen Trennzeichen und gibt die verkettete Zeichenfolge zurück.
{#utilities-transform-functions__table_zyq_rbk_hrb__entry__3}

| 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. |
[ ]

{#utilities-transform-functions__table_zyq_rbk_hrb} Abbildung : 10. Beispiel

* Eingabe: `[1, 2, 3]`
* Parameter: `<`
* Ausgabe: `1<2<3`
{#utilities-transform-functions__ul_hqh_3ck_hrb}