Runsub

Esta página de ajuda é para CXone Studio. Esta informação também está disponível para Desktop Studio.

Convoca um subscript, que é executado e depois usa Return action para retornar e continuar executando o script principal. Quando o subscript é executado, ele armazena um valor na propriedade ReturnValue da ação Return e, em seguida, passa esse valor de volta para a propriedade ReturnVariable na ação Runsub no script principal.

Esta ação pode ser especialmente útil se você tiver um ou mais scripts maiores que prefere dividir em scripts menores.

Dependências

  • O script principal e o subscript devem estar na mesma pasta.

  • O tipo de script principal e o tipo de subscript devem ser iguais. Por exemplo, se o script principal for um script de telefone, o subscript também deve ser um script de telefone.
  • Se você colocar uma ação Runsub no script principal, seu subscript DEVE ter uma ação Return.
  • Runsub pode passar várias variáveis do script principal para o subscript, mas o subscript pode retornar apenas um valor (na propriedade ReturnVariable) para o script principal.
  • Todas as variáveis definidas no subscript não estarão mais disponíveis quando o subscript terminar, a não ser que você as tenha declarado como global. Você pode fazer isso em uma ação SNIPPET adicionando global: antes do nome da variável. Por exemplo, ASSIGN global:varName = value. Outra opção para acessar dados em um subscript é usar a API GET /contacts/{contactId}/custom-data Um ícone de um quadrado com uma seta apontando do centro para o canto superior direito..
  • Para usar a função savetodb() em uma variável em um subscript Runsub, ela deve ser uma variável global.
  • Todos os scripts chamados por RunScript , Spawn, Runsub ou scripts semelhantes devem ser válidos e ativos. Durante o processo de salvamento, Studio valida todos os scripts chamados por ações. Se algum deles for inválido ou inativo, Studio exibe um erro e você não poderá salvar.

Tipos de script suportados

Um quadrado com uma linha saindo dele e indo em direção a três outros quadrados.

Genérico

E-mail Chat Telefone Correio de Voz Item de Trabalho SMS Digital

Comparação de ações similares

As ações a seguir têm funções semelhantes, mas com algumas diferença importantes.

  • Runscript: quando Runscript aciona outro script, ele não retorna ao primeiro script a partir do segundo script.
  • Runsub: quando Runsub aciona um subscript, o script pode retornar ao primeiro script desde que o subscript tenha uma ação Return. A ação Return fornece um valor de volta para a ação Runsub quando o subscript é concluído.
  • SPAWN: inicia um segundo script que é executado de forma paralela ao primeiro script. Scripts gerados não podem passar dados de volta ao primeiro script a não ser que você inclua uma ação SIGNAL no script gerado.

Propriedades de entrada

Estas propriedades definem dados que a ação usa durante a execução.

Propriedade

Descrição

Adicionar legenda

Insira uma frase curta que identifica exclusivamente esta ação no script. A legenda aparece na tela do script no ícone da ação.

Script Name

O script que você deseja gerar. Você pode clicar no link Choose Script na parte superior da caixa de propriedades da ação para selecionar um script da sua unidade de negócios.

Return Variable

O valor retornado para o script principal é armazenado nesta propriedade. Para passar vários valores, use uma matriz como variável.
Parameters

Clique no ícone de reticências no campo e adicione uma variável para cada parâmetro que você deseja enviar para o script gerado. Insira uma variável por linha na janela do editor. Use nomes de variáveis com significado. Os nomes das variáveis não precisam corresponder ao nome da variável correspondente usada no script gerado.

Os parâmetros que são passados para um script aparecem na saída de rastreamento desse script na ação Begin.

Condições de ramal resultante

Condições de ramal resultante permitem que você crie ramais no seu script para atender diferentes resultados quando uma ação é executada.

Condição

Descrição

Default

Caminho percorrido, a menos que o script atenda a uma condição que exige que ele percorra um dos outros ramais. Também é percorrido se os outros ramais da ação não estiverem definidos.

Erro

Caminho tomado quando a ação não é executada corretamente. Por exemplo, quando há um problema inesperado como conectividade ruim, erros de sintaxe e assim por diante. A variável _ERR, com o caractere sublinhado, deve ser preenchida com uma explicação condensada do problema.

Exemplo de script

Este é um exemplo para mostrar como esta ação pode ser usada em scripts. Ele não é voltado para um script inteiro. Criação de script adicional pode ser necessária.

No script principal abaixo (mostrado na parte superior), quando o script é acionado, a ação Runsub aciona imediatamente o subscript (mostrado abaixo). No subscript, Voiceparams define as configurações Texto a fala, e a ação Hours define ramais para abertura, fechamento e feriado para três ações Return diferentes. Quando o subscript é concluído, os valores na propriedade ReturnValues (na ação Return) são armazenados no campo ReturnVariable (ação Runsub no script principal). A ação Case define os ramais abertos, fechados e de férias conforme apropriado.

Script principal

Um exemplo de script, mostrando as ações do Studio com setas conectando-as. Cada ação possui um rótulo abaixo dela para indicar o que a ação faz no script.

Quer baixar este script?

Subscript

Um exemplo de script, mostrando as ações do Studio com setas conectando-as. Cada ação possui um rótulo abaixo dela para indicar o que a ação faz no script.

As três ações Return fornecem valores na propriedade ReturnValue para que a ação Case no script principal possa determinar qual ramal seguir.

Quer baixar este script?