---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# ArrayUtil : Global

# ArrayUtil : Global {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 Minuten Lesedauer

Die ArrayUtil-Skripteinbindung stellt Methoden zum Arbeiten mit JavaScript-Arrays bereit.

Diese Methoden stehen jedem serverseitigen Skript zur Verfügung.

## ArrayUtil -- concat(Array parent, Array child) {#ariaid-title2}

Führt zwei Arrays zusammen.
{#r_AU-concat_A_A__table_ny5_yxz_nt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| parent | Array | Ein zusammenzuführendes Array |
| child | Array | Ein zusammenzuführendes Array |
[Tabelle : 1. Parameter]

{#r_AU-concat_A_A__table_ny5_yxz_nt} {#r_AU-concat_A_A__table_oy5_yxz_nt__entry__2}

| Typ | Beschreibung |
|-|-|
| Array | Ein Array von Elementen aus beiden Eingabearrays. Duplikate werden nicht entfernt. |
[Tabelle : 2. Ergebnisse]

{#r_AU-concat_A_A__table_oy5_yxz_nt}  

    var arrayUtil = new ArrayUtil();
    var a1 = new Array("a", "b", "c");
    var a2 = new Array("c", "d", "e");
     
    gs.print("concat a1, a2: " + arrayUtil.concat(a1, a2));

Ausgabe: concat a1, a2: a,b,c,c,d,e

## ArrayUtil -- contains(Array array, Object element) {#ariaid-title3}

Durchsucht das Array nach dem angegebenen Element. Gibt „true" zurück, wenn das Element im Array vorhanden ist. Andernfalls wird „false" zurückgegeben.
{#r_AU-contains_A_O__table_zbc_w5z_nt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| array | Array | Zu durchsuchendes Array. |
| Element | Objekt | Element, nach dem gesucht werden soll. |
[Tabelle : 3. Parameter]

{#r_AU-contains_A_O__table_zbc_w5z_nt} {#r_AU-contains_A_O__table_acc_w5z_nt__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob das Element im Array gefunden wurde. Mögliche Werte: * true: Element in Array gefunden. * false: Element im Array nicht gefunden. {#r_AU-contains_A_O__ul_k2b_r45_knb} |
[Tabelle : 4. Ergebnisse]

{#r_AU-contains_A_O__table_acc_w5z_nt}  

    var arrayUtil = new ArrayUtil();
    var a1 = new Array("a", "b", "c");
     
    gs.print("Contains b: " + arrayUtil.contains(a1, "b"));
    gs.print("Contains x: " + arrayUtil.contains(a1, "x"));

Ausgabe:

    Contains b: true
    Contains x: false

## ArrayUtil -- convertArray(Object a) {#ariaid-title4}

Konvertiert ein Java-Objekt in ein Array.
{#r_AU-convertArray_O__table_m5s_mb1_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| a | Objekt | Zu konvertierendes Objekt. |
[Tabelle : 5. Parameter]

{#r_AU-convertArray_O__table_m5s_mb1_4t} {#r_AU-convertArray_O__table_n5s_mb1_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Array | Aus dem Objekt erstelltes Array. |
[Tabelle : 6. Ergebnisse]

{#r_AU-convertArray_O__table_n5s_mb1_4t}  
In diesem Beispiel wird ein Java-Objekt in ein Array konvertiert.

    var arrayUtil = new ArrayUtil();
    // Returns a JavaObject with the logged in user's groups
    var groupObj = gs.getUser().getMyGroups();
    gs.print('groupObj: ' + Object.prototype.toString.call(groupObj));

    var groupArr = arrayUtil.convertArray(groupObj);
    gs.print('groupArr: ' + Object.prototype.toString.call(groupArr));

Ausgabe:

    groupObj: [object JavaObject]
    groupArr: [object Array]

## ArrayUtil -- diff(Array a, Array b) {#ariaid-title5}

Findet die Unterschiede zwischen zwei oder mehr Arrays.
Als Parameter können beliebig viele Arrays angegeben werden.
{#r_AU-diff_A_A__table_pgr_xb1_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| a | Array | Ein Array |
| b | Array | Ein Array |
[Tabelle : 7. Parameter]

{#r_AU-diff_A_A__table_pgr_xb1_4t} {#r_AU-diff_A_A__table_qgr_xb1_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Array | Gibt ein Array von Elementen aus Array a zurück, die weder in Array b oder c noch in anderen Eingabearrays gefunden wurden. Duplikate werden aus dem Ergebnis entfernt. |
[Tabelle : 8. Ergebnisse]

{#r_AU-diff_A_A__table_qgr_xb1_4t}  

    var arrayUtil = new ArrayUtil();
    var a1 = new Array("a", "b", "c");
    var a2 = new Array("c", "d", "e");
    gs.print(arrayUtil.diff(a1, a2));

Ausgabe: a, b

## ArrayUtil -- ensureArray(Object object) {#ariaid-title6}

Gibt ein Array aus dem angegebenen Objekt zurück.
{#r_AU-ensureArray_O__table_wh1_hxz_nt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| object | Objekt | Objekt, aus dem ein Array erstellt werden soll. |
[Tabelle : 9. Parameter]

{#r_AU-ensureArray_O__table_wh1_hxz_nt} {#r_AU-ensureArray_O__table_xh1_hxz_nt__entry__2}

| Typ | Beschreibung |
|-|-|
| Array | Aus dem Objekt erstelltes Array. |
[Tabelle : 10. Ergebnisse]

{#r_AU-ensureArray_O__table_xh1_hxz_nt}  
Das folgende Beispiel zeigt, wie Sie ein Array aus einem Objekt erstellen und das erstellte Array anzeigen.

    var arrayUtil = new ArrayUtil();
    var o1 = {a:"1",b:"2",c:"3"};
    gs.print('o1 is array: ' + Array.isArray(o1));
    gs.print('o1 stringified: ' + JSON.stringify(o1));

    var a1 = arrayUtil.ensureArray(o1);
    gs.print('a1 is array: ' + Array.isArray(a1));
    gs.print('a1 stringified: ' + JSON.stringify(a1));

Ausgabe:

    o1 is array: false
    o1 stringified: {"a":"1","b":"2","c":"3"}
    a1 is array: true
    a1 stringified: [{"a":"1","b":"2","c":"3"}]

Das folgende Beispiel zeigt, wie Sie ein Array aus einem Objekt erstellen und den Inhalt des Arrays anzeigen.

    var stock = { 'name': 'Servicenow', 'sym': 'NOW' };

    var arr = new ArrayUtil();
    var stArray = arr.ensureArray(stock);

    gs.info("Name is " + stArray[0]['name']);
    gs.info("Symbol is " + stArray[0]['sym']);

Ausgabe:

    Name is Servicenow
    Symbol is NOW

## ArrayUtil -- indexOf(Array array, Object element) {#ariaid-title7}

Durchsucht das Array nach dem Element. Gibt den Elementindex oder -1 zurück, falls nicht gefunden.
{#r_AU-indexOf_A_O__table_igr_nwz_nt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| array | Array | Zu durchsuchendes Array. |
| Element | Objekt | Element, nach dem gesucht werden soll. |
[Tabelle : 11. Parameter]

{#r_AU-indexOf_A_O__table_igr_nwz_nt} {#r_AU-indexOf_A_O__table_jgr_nwz_nt__entry__2}

| Typ | Beschreibung |
|-|-|
| Nummer | Position des Elements im Array oder -1, wenn das Element nicht gefunden wird. |
[Tabelle : 12. Ergebnisse]

{#r_AU-indexOf_A_O__table_jgr_nwz_nt}  

    var arrayUtil = new ArrayUtil();
    var arr = new Array("a", "b", "c", "x", "y", "z");
    gs.print("Array: " + arr);

    gs.print("Index of a: " + arrayUtil.indexOf(arr, "a"));
    gs.print("Index of a starting at 2: " + arrayUtil.indexOf(arr, "a", 2));

    gs.print("Index of c: " + arrayUtil.indexOf(arr, "c"));
    gs.print("Index of c starting at 1: " + arrayUtil.indexOf(arr, "c", 1));

    gs.print("Index of z: " + arrayUtil.indexOf(arr, "z"));
    gs.print("Index of z starting at 4: " + arrayUtil.indexOf(arr, "z", 4));

    // If negative value is sent as startIndex then (startIndex + length of array ) is considered as start index.

    // startIndex = -1+(6); startIndex is considered as 5 in this case
    gs.print("Index of c starting at -1 (Re-Calculated to 5): " + arrayUtil.indexOf(arr, "c", -1)); 

    // startIndex = -10+(6) which is -4,if negative value again then startIndex is considered as 0
    gs.print("Index of c starting at -10 (Re-Calculated to 0): " + arrayUtil.indexOf(arr, "c", -10)); 

Ausgabe:

    Array: a,b,c,x,y,z
    Index of a: 0
    Index of a starting at 2: -1
    Index of c: 2
    Index of c starting at 1: 2
    Index of z: 5
    Index of z starting at 4: 5
    Index of c starting at -1 (Re-Calculated to 5): -1
    Index of c starting at -10 (Re-Calculated to 0): 2

## ArrayUtil -- indexOf(Array array, Object element, Number startIndex) {#ariaid-title8}

Durchsucht das Array nach dem Element ab dem angegebenen Index. Gibt den Elementindex oder -1 zurück, falls nicht gefunden.
{#r_AU-indexOf_A_O_N__table_xmd_rvz_nt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| array | Array | Zu durchsuchendes Array. |
| Element | Objekt | Element, nach dem gesucht werden soll. |
| startIndex | Nummer | Index, ab dem die Suche gestartet werden soll. |
[Tabelle : 13. Parameter]

{#r_AU-indexOf_A_O_N__table_xmd_rvz_nt} {#r_AU-indexOf_A_O_N__table_ymd_rvz_nt__entry__2}

| Typ | Beschreibung |
|-|-|
| Nummer | Position des Elements im Array oder -1, wenn das Element nicht gefunden wird. |
[Tabelle : 14. Ergebnisse]

{#r_AU-indexOf_A_O_N__table_ymd_rvz_nt}  

    var arrayUtil = new ArrayUtil();
    var arr = new Array("a", "b", "c", "x", "y", "z");
    gs.print("Array: " + arr);

    gs.print("Index of a: " + arrayUtil.indexOf(arr, "a"));
    gs.print("Index of a starting at 2: " + arrayUtil.indexOf(arr, "a", 2));

    gs.print("Index of c: " + arrayUtil.indexOf(arr, "c"));
    gs.print("Index of c starting at 1: " + arrayUtil.indexOf(arr, "c", 1));

    gs.print("Index of z: " + arrayUtil.indexOf(arr, "z"));
    gs.print("Index of z starting at 4: " + arrayUtil.indexOf(arr, "z", 4));

    // If negative value is sent as startIndex then (startIndex + length of array ) is considered as start index.

    // startIndex = -1+(6); startIndex is considered as 5 in this case
    gs.print("Index of c starting at -1 (Re-Calculated to 5): " + arrayUtil.indexOf(arr, "c", -1)); 

    // startIndex = -10+(6) which is -4,if negative value again then startIndex is considered as 0
    gs.print("Index of c starting at -10 (Re-Calculated to 0): " + arrayUtil.indexOf(arr, "c", -10)); 

Ausgabe:

    Array: a,b,c,x,y,z
    Index of a: 0
    Index of a starting at 2: -1
    Index of c: 2
    Index of c starting at 1: 2
    Index of z: 5
    Index of z starting at 4: 5
    Index of c starting at -1 (Re-Calculated to 5): -1
    Index of c starting at -10 (Re-Calculated to 0): 2

## ArrayUtil -- intersect(Array a, Array b) {#ariaid-title9}

Findet die Elemente, die in allen Arrays vorhanden sind.
Als Parameter können beliebig viele Arrays angegeben werden.
{#r_AU-intersect_A_A__table_v5v_4c1_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| a | Array | Ein Array |
| b | Array | Ein Array |
[Tabelle : 15. Parameter]

{#r_AU-intersect_A_A__table_v5v_4c1_4t} {#r_AU-intersect_A_A__table_w5v_4c1_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Array | Ein Array von Elementen aus Array a, die in allen anderen Eingabearrays gefunden wurden. Duplikate werden entfernt. |
[Tabelle : 16. Ergebnisse]

{#r_AU-intersect_A_A__table_w5v_4c1_4t}  

    var arrayUtil = new ArrayUtil();
    var a1 = new Array("a", "b", "c");
    var a2 = new Array("c", "d", "e");
    gs.print(arrayUtil.intersect(a1, a2));

Ausgabe: c

## ArrayUtil -- union(Array a, Array b) {#ariaid-title10}

Verbindet zwei oder mehr Arrays.
Als Parameter können beliebig viele Arrays angegeben werden.
{#r_AU-union_A_A__table_xvq_2d1_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| a | Array | Ein Array |
| b | Array | Ein Array |
[Tabelle : 17. Parameter]

{#r_AU-union_A_A__table_xvq_2d1_4t} {#r_AU-union_A_A__table_yvq_2d1_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Array | Ein Array von Elementen aus allen Eingabearrays. Duplikate werden entfernt. |
[Tabelle : 18. Ergebnisse]

{#r_AU-union_A_A__table_yvq_2d1_4t}  

    var arrayUtil = new ArrayUtil();
    var a1 = new Array("a", "b", "c");
    var a2 = new Array("c", "d", "e");
    gs.print(arrayUtil.union(a1, a2));

Ausgabe: a, b, c, d, e

## ArrayUtil -- unique(Array a) {#ariaid-title11}

Entfernt doppelte Elemente aus einem Array.
{#r_AU-unique_A__table_zqw_td1_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| a | Array | Das auf doppelte Elemente zu überprüfende Array. |
[Tabelle : 19. Parameter]

{#r_AU-unique_A__table_zqw_td1_4t} {#r_AU-unique_A__table_arw_td1_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Array | Ein Array eindeutiger Elemente aus dem Eingabearray. |
[Tabelle : 20. Ergebnisse]

{#r_AU-unique_A__table_arw_td1_4t}  

    var arrayUtil = new ArrayUtil();
    var a1 = new Array("a", "b", "c", "c", "b");
    gs.print(arrayUtil.unique(a1));

Ausgabe: a, c, b