Putvalue

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

Ícone de PUTVALUE: seta apontando para a direita em um banco de dados

Armazena dados em uma matriz em uma tabela de banco de dados NiCE CXone para torná-los acessíveis a outros Scripts e contatos. Você pode usar a propriedade Method desta ação para definir se os dados são adicionados ao início ou ao final da matriz. Os dados podem ser recuperados de PUTVALUE com a GETList ação ou a GETvalue ação.

Se várias variáveis precisarem ser acessadas por outros Scripts ou contatos, um banco de dados geralmente é a melhor solução.

Dependências

  • Putvalue usa um tipo de dados exclusivo que deve ser acessado usando as ações Studio apropriadas: Getvalue, Remvalue, Getlist, e Clearlist.
  • Quando a propriedade Persistente é definida como False, todos os valores públicos que foram adicionados por um contato específico são removidos automaticamente quando o contato é liberado. Esse recurso é comumente usado quando um script pai precisa acompanhar os scripts filhos gerados. Cada script filho irá Putvalue com a propriedade Name, como "{MasterID}List", e um valor de {ContactID}. Como a "{MasterID}List" é pública, o script pai pode executar periodicamente Getlist para descobrir quantos scripts filhos estão em execução atualmente. Em virtude da propriedade Persistent=false, o valor público do script filho será automaticamente removido quando liberado. Nenhum trabalho extra é necessário para manter uma contagem Precisa de scripts filhos.
  • As variáveis públicas não persistentes podem ser compartilhadas por outros scripts/contatos durante toda a vida do script que define essas variáveis. As variáveis são automaticamente limpas depois que são liberadas.
  • PersistenteAs variáveis devem ser removidas manualmente executando Getvalue (com a propriedade Remover definida como true), Remvalue, ou Clearlist. Não é recomendável usar Putvalue para grandes quantidades de dados ou dados que você precisará por longos períodos de tempo. Se você precisar salvar dados, é recomendável que você use DB Connector e se conecte a um banco de dados que você controle.

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

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.

Valor

O valor ou dados a serem armazenados.

Método

Quando vários valores com o mesmo nome são armazenados, eles são colocados em uma lista. Selecione um dos seguintes métodos:

  • ReplaceAll: Este é o valor padrão e será automaticamente selecionada(s).
  • Acrescentar: Coloca o novo valor no final da lista. Ao acrescentar valores, se o número exceder 1.000 acréscimos em menos de 24 horas, ele não será mais acrescentado até que alguns dos acréscimos sejam eliminados (após 24 horas).
  • Inserir: Coloca o valor no início da lista. chamadas subsequentes a Getvalue irão recuperar dados a partir do início da lista.
Persistente

Selecione Verdadeiro se desejar que os dados armazenados por um determinado contato permaneçam após a liberação do contato. O padrão é que os dados sejam removidos quando o contato for liberado (False).

TTL (horas)

Defina essa propriedade para a quantidade de tempo em horas que você deseja que os dados fiquem disponíveis. Quando o TTL (Time to Live) é atingido, os dados são apagados.

O valor mínimo para esta propriedade é de 1 hora e o máximo de 168 horas (sete dias). O padrão é 24 horas. Definir valores fora dos limites permitidos faz com que a ação use o valor permitido mais próximo.

Importante O horário real em que os dados são apagados pode ser até uma hora após a expiração do TTL. Isso ocorre porque o processo que verifica o TTL é executado uma vez por hora, no início da hora. Por exemplo, se o TTL expira às 10:03, o processo que verifica a expiração do TTL não vai executar até às 11:00, o que significa que os dados vão continuar a existir até às 11:00.

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.