---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Fila - Global

# Fila - Global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

A API de fila (Atribuição avançada de trabalho) fornece métodos para rotear um documento para uma fila.

Esta API é fornecida no namespace `sn_awa`.  
Requer o seguinte:

* Plug-in Advanced Work Assignment (com.glide.awa)
* Função: awa_integration_user ou administrador
{#c_QueueAPI__ul_mxn_2kp_2gb}

## Fila - get(cadeia de caracteres queue_id) {#ariaid-title2}

Obtém um registro de fila por sys_id.
{#r_queue_get__table_t4k_y54_3gb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| queue_id | Cadeia de caracteres | Representa o sys_id do registro de fila da tabela awa_queue |
[Tabela 1. Parâmetros]

{#r_queue_get__table_t4k_y54_3gb} {#r_queue_get__table_u4k_y54_3gb__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se o registro de fila existir, caso contrário, falso. |
[Tabela 2. Retorna]

{#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>"
    });

## Fila -- rota (opções de objeto) {#ariaid-title3}

Roteia um item de trabalho ativo para o objeto de fila.
Se não existir um item de trabalho ativo para o documento especificado, este método criará um item de trabalho e definirá seus campos de acordo.
{#r_QueueAWA_route__table_hqw_pbm_yfb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| opções | Objeto | Contém o documento sys_id e a tabela associada ao item de trabalho: * `document_sys_id: "<sys_id> "` * `document_table: "<table>"`, por exemplo, interação {#r_QueueAWA_route__ul_xjk_4qv_dgb} |
[Tabela 3. Parâmetros]

{#r_QueueAWA_route__table_hqw_pbm_yfb} {#r_QueueAWA_route__table_iqw_pbm_yfb__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se for bem-sucedido, mensagem de erro caso contrário. |
[Tabela 4. Retorna]

{#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>"
    });