---
sourceDocument: Interfaces conversacionais de Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/conversational-interfaces

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Interfaces conversacionais de Yokohama

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Utilitário de ação de script

# Utilitário de ação de script {#ariaid-title1}

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

Use o utilitário Ação de script em um Virtual Agenttópico 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 de tópicos. |
| Expressão da ação | O script que executa uma ação. |
| Avançado ||
| Ocultar este nó ||
| Mostrar condicionalmente este nó 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}

## Utilitário de Ação de script de exemplo {#va-script-action__section_jxd_nh5_tdb}

Figura 1. Propriedades básicas do utilitário de 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;
    })()

Este 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 `. Em seguida, o script coloca os resultados em uma matriz e os armazena em `case_list `variável, acessível por outros nós no mesmo tópico. Porque `VaVars `O script usa somente valores de cadeia de caracteres, números e boolianos `ToString() `para armazenar esses valores como cadeias de caracteres. O código está contido em um `se `, portanto, ela só será executada se `case_number `a variável tem um valor. Isso `se `a declaração impede que o código seja executado se o usuário não tiver inserido um número.

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