---
sourceDocument: Interfaces conversacionais do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/conversational-interfaces

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Interfaces conversacionais do Xanadu

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Utilitário Ação de script

# Utilitário Ação de script {#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

Use o utilitário Ação de script em um tópico Virtual Agent para executar um script.

## Propriedades do utilitário Ação de script {#va-script-action__section_xwb_mgn_pdb}

{#va-script-action__table_nff_y1b_3db__entry__2}

| Propriedade | Descrição |
|-|-|
| Nome do nó | O nome que identifica este nó de Ação de script no fluxo do tópico. |
| Expressão da ação | O script que executa uma ação. |
| Avançado ||
| Ocultar este nó ||
| Mostrar este nó condicionalmente se | Uma declaração de condição sem código ou script de baixo código que especifica uma condição para apresentar este nó na conversa. A condição deve ser avaliada como verdadeira. |
[ ]

{#va-script-action__table_nff_y1b_3db}

## Exemplo do utilitário Ação de script {#va-script-action__section_jxd_nh5_tdb}

Figura 1. Propriedades básicas do utilitário Ação de script

## Exemplo de ação de script {#va-script-action__section_uns_jkm_vdb}

    (function execute() {
        var list = [];
        if (vaInputs.case_number != "") {
            var gr = new GlideRecord("sn_customerservice_case");
            gr.addQuery("number", "CONTAINS", vaInputs.case_number);
            gr.addQuery("active", "true");
            gr.orderBy("number");
            gr.query();
            while (gr.hasNext()) {
                gr.next();
                list.push(gr.getUniqueValue().toString());
            }
        }
        vaVars.case_list = list;
    })()

Esse exemplo executa uma pesquisa na tabela \[sn_customerservice_case\] para um número de caso específico com base na entrada de outro controle chamado `case_number`. O script coloca os resultados em uma matriz e os armazena na variável `case_list`, que pode ser acessada por outros nós no mesmo tópico. Como `vaVars` só oferece suporte a valores de cadeia de caracteres, número e Boolianos, o script usa `toString()` para armazenar esses valores como cadeias de caracteres. O código está contido em uma declaração de `if`, portanto, ele só será executado se a variável `case_number` tiver um valor. Esta declaração de `if` impede que o código seja executado se o usuário não tiver inserido um número.

Para mais informações sobre escrever scripts para Virtual Agent, consulte [Scripts Virtual Agent](https://servicenow-prod.fluidtopics.net/_zNKHyhzS4jqqcnQ~mt_rw "Use os métodos e variáveis de script ServiceNow Virtual Agent para escrever scripts de bate-papo, como resposta, gatilho e scripts de fluxo. As variáveis também podem fornecer contexto para seus tópicos e conversas de suporte ao vivo.").