Runsub

Esta página de ajuda é para Desktop Studio. Estas informações também estão disponíveis para Studio.

O ícone da ação Runsub, um pedaço de papel curvado com duas setas apontando para a direita ao lado dele, na parte superior e na parte inferior.

Chama um script, que executa e depois usa a Return ação para retornar e continuar executando o script principal. Quando o subscript é executado, ele armazena um valor na propriedade valor de retorno da ação Return e depois passa esse valor de volta para a propriedade variável de retorno na ação Runsub no script principal.

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

Dependências

  • O script subordinado deve estar na mesma pasta que o script principal, ou em uma de suas subpastas.

  • 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 subscrito também deve ser um script de telefone.
  • Se você colocar uma ação Runsub no script principal, o seu subscript DEVE ter uma ação Return.
  • Runsub pode passar múltiplas variáveis do script principal para o subscript, mas o subscript pode retornar somente um valor (na propriedade ReturnVariable) para o script principal.
  • Quaisquer variáveis definidas no subscript não estarão mais disponíveis quando o subscript terminar, a menos que você as declare como globais. 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 An icon of a square with an arrow  pointing from the center out to the upper right corner..
  • Para usar a savetodb() função 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

The icon for a Generic script type - a rectangle with < and > symbols inside it.

The icon for the Email script type - a large @ symbol in a diamond.

O ícone para o tipo de script Chat - um balão de chat com reticências dentro (...), em formato de diamante.

O ícone do tipo de script Telefone - um fone de telefone de estilo antigo com linhas curvas indicando som saindo dele.

O ícone do tipo de script Voicemail - um símbolo que se parece com uma fita cassete - dois círculos em uma linha horizontal.

O ícone do tipo de script Item de trabalho - uma folha de papel com um canto dobrado e uma lista com marcadores.

O ícone do tipo de script SMS - um smartphone com um balão de bate-papo saindo dele.

O ícone do tipo de script Digital - um monitor de computador com um smartphone ao lado.

Genérico

E-mail Chat Telefone Correio de voz Item de trabalho SMS Digital

Comparação para ações similares

As ações a seguir têm funções semelhantes, mas com algumas diferenças chave:

  • 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 em paralelo ao primeiro script. Os scripts gerados não podem retornar dados para o primeiro script, a menos que você inclua uma SIGNAL ação no script gerado.

Propriedades de entrada

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

Propriedade

Descrição

Legenda

Insira uma frase curta que identifique exclusivamente esta ação no script. A legenda aparece na tela do script no ícone da ação. O padrão é o nome da ação.

ScriptName

The script you want to spawn. You can click the Choose Script link at the top of the action's properties box to select a script from your business unit.

ReturnVariable

The value that is returned to the main script is stored in this property. To pass multiple values, use an array as the variable.
Parâmetros

Permite alterar o nome das variáveis padrão que contêm valores para parâmetros que você deseja enviar ao script derivado ou filho. As variáveis padrão são p1 - p9, mas, se você especificar nomes nesta propriedade, esses nomes substituirão os nomes de variáveis padrão nos quais os valores de parâmetro são passados. Se você não alterar os nomes, as variáveis manterão seus nomes pX padrão.

Para alterar os nomes, clique no ícone de elipse no campo e adicione nomes de variáveis para cada parâmetro que você deseja enviar para o script gerado ou filho. Enter até nove nomes, um por linha na janela do editor. Para alterar os nomes, adicione novos nomes para cada parâmetro que você deseja enviar para o script gerado ou filho. Enter até nove nomes de variáveis, um por linha. Os nomes de variáveis não precisam corresponder ao nome da variável correspondente usada no script gerado, mas devem ser significativos. Esses valores são passados como variáveis de parâmetrovariáveis de parâmetro p1 - p9.

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

Condições de Ramificação de resultado

As condições de ramificação de resultado permitem que você crie ramificações no seu script para tratar diferentes resultados quando uma ação é executada.

Condição

Descrição

Padrão

Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the action's other branches are not defined.

OnError

Path taken when the action fails to execute properly. For example, when there is an unexpected problem such as poor connectivity, syntax errors, and so on. The _ERR variable, with a single underscore character, should be populated with a condensed explanation of the problem.

Exemplo de script

Este é um exemplo para mostrar como essa ação pode ser usada em Scripts. Ele não é voltado para um script inteiro. Pode ser necessário um script adicional.

No script principal abaixo (exibido na parte superior), quando o script é acionado, a ação Runsub aciona imediatamente o subscript (exibido na parte inferior). No subscript, Voiceparams define as configurações de Conversão de texto em fala, e a ação Hours define ramificações para aberto, fechado e feriado em 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 então define as ramificações de aberto, fechado e feriado conforme apropriado.

Principal script

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

Você gostaria de fazer o download deste script?

Subscrito

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 valor de retorno para que a ação Case no script principal possa determinar qual ramificação seguir.

Você gostaria de fazer o download deste script?