Getvalue

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

Ícone de GetValue: banco de dados com uma seta apontando para a esquerda

Recupera o primeiro valor da matriz que a Putvalue ação criou. Você pode configurar esta ação para remover o valor da matriz ou mantê-lo nela, usando a propriedade Escopo.

Para recuperar a matriz inteira, use a GETLIST ação.

Tipos de script compatíveis

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

Ações Relacionadas

Esta ação é uma das várias ações que armazenam e recuperam dados de uma tabela de banco de dados para tornar os dados acessíveis a outros scripts; ele se comporta como uma lista de campos ou valores. Use-os para armazenar múltiplos valores ou valores necessários mais adiante em outros Scripts. A lista completa de ações, incluindo esta ação, é: Putvalue, Getvalue, Remvalue, Getlist, e Clearlist.

Essas ações usam um tipo de dados exclusivo que só pode ser acessado usando esse conjunto de ações Studio. Os dados não são acessíveis de outra forma. Os usuários não podem acessar esse banco de dados e usá-lo, independentemente de suas permissões.

Os valores são listados em uma tabela de banco de dados por um período de tempo limitado, conforme configurado na propriedade Horas de TTL da ação Putvalue .O padrão é 24 horas, mas varia de uma hora a 168 horas (sete dias). Você pode usar a ação Remvalue para excluir dados antes do horário do TTL.Isso oferece a você controle total sobre os dados dentro de seus Scripts.

Observações:

  • Se várias variáveis precisarem ser acessadas por outros Scripts ou contatos, um banco de dados geralmente é a melhor solução.
  • variáveis público não persistentes podem ser compartilhadas por outros Scripts ou contatos durante toda a vida do script que define essas variáveis. As variáveis são automaticamente limpas quando são liberadas.

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.

Escopo

Selecione o nível no qual os valores que esta ação processa são visíveis para outros contatos. Somente contatos que compartilham o mesmo escopo poderão acessar os mesmos dados. As Opções são:

Importante O Escopo selecionado deve corresponder ao Escopo definido em todas as outras ações de lista incluídas no seu script. As ações de lista são Putvalue, Getvalue, Remvalue, Getlist, e Clearlist. Mesmo quando o Nome da lista for o mesmo, elas não serão reconhecidas se as configurações de Escopo não corresponderem.

Nome Usado para identificar o valor. Pode ser qualquer nome ou número. Os nomes não diferenciam maiúsculas de minúsculas. Quando o valor é recuperado usando Getvalue, Name deve ser o mesmo. Se a propriedade Name não corresponder, eles não reconhecerão um ao outro, mesmo que a configuração Escopo seja a mesma.
Variable The name of the variable that you want to hold the retrieved values.
DefaultValue The value you would provide to any record without a matching mapping. Cannot exceed 200 characters.
Remover True (the default) causes the value to be removed from the Scope property after it is retrieved. False allows repetitive access to the same value.

Condições do ramo 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.

NoData

Path taken if there are no values for the specified properties.

Dicas e truques

  • Uma lista armazena temporariamente mais de um item com base em um determinado nome. Para recuperar todos os itens da lista, use chamadas repetitivas para Getvalue ou uma única chamada para Getlist.
  • Ao usar Getvalue para recuperar múltiplos valores, defina a propriedade Remover como True. Depois que o último valor for recuperado, as chamadas subsequentes acionarão a condição de ramificação No Data.
  • Um exemplo de uso das ações Getvalue e Putvalue é um script de conferência. Para criar um script desse tipo, a parte que inicia a conferência deve salvar seu ID de conferência usando Putvalue. Os Chamadores que seguirem podem entrar na conferência depois de recuperar o ID de conferência usando Getvalue.