---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/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


---

# Warteschlange : Global

# Warteschlange : Global {#ariaid-title1}

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

Die Warteschlangen- API (Erweiterte Arbeitszuweisung) bietet Methoden zum Weiterleiten eines Dokuments an eine Warteschlange.

Diese API wird im Namespace `sn_awa` bereitgestellt.  
Folgendes ist erforderlich:

* Plugin „Advanced Work Assignment" (com.glide.awa)
* Rolle: awa_integration_user oder admin
{#c_QueueAPI__ul_mxn_2kp_2gb}

## Queue -- get(String queue_id) {#ariaid-title2}

Ruft einen Warteschlangen-Datensatz nach sys_id ab.
{#r_queue_get__table_t4k_y54_3gb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| queue_id | Zeichenfolge | Stellt die sys_id des Warteschlangendatensatzes aus der Tabelle „awa_queue" dar |
[Tabelle : 1. Parameter]

{#r_queue_get__table_t4k_y54_3gb} {#r_queue_get__table_u4k_y54_3gb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | „Wahr", wenn ein Warteschlangendatensatz vorhanden ist, andernfalls „falsch". |
[Tabelle : 2. Ergebnisse]

{#r_queue_get__table_u4k_y54_3gb}  

    var queue = sn_awa.Queue.get("<queue_id>");
    var workItem = queue.route({ 
        document_sys_id: "<sys_id>",
        document_table: "<table>"
    });

## Warteschlange -- Route(Objektoptionen) {#ariaid-title3}

Leitet ein aktives Arbeitselement an das Warteschlangenobjekt.
Wenn für das angegebene Dokument kein aktives Arbeitselement vorhanden ist, erstellt diese Methode ein Arbeitselement und legt dessen Felder entsprechend fest.
{#r_QueueAWA_route__table_hqw_pbm_yfb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Optionen | Objekt | Enthält die sys_id des Dokuments und die Tabelle, die dem Arbeitselement zugeordnet ist: * `document_sys_id: „<sys_id>"` * `document_table: "<table>"`, z. B. Interaktion {#r_QueueAWA_route__ul_xjk_4qv_dgb} |
[Tabelle : 3. Parameter]

{#r_QueueAWA_route__table_hqw_pbm_yfb} {#r_QueueAWA_route__table_iqw_pbm_yfb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | „True", falls erfolgreich, andernfalls Fehlermeldung. |
[Tabelle : 4. Ergebnisse]

{#r_QueueAWA_route__table_iqw_pbm_yfb}  

    var queue = sn_awa.Queue.get("<queue_id>");
    var workItem = queue.route({ 
        document_sys_id: "<sys_id>",
        document_table: "<table>"
    });