Putvalue

This help page is for Desktop Studio. This information is also available for CXone Studio.

Armazena e recupera dados em uma tabela de banco de dados NICE CXone para torná-los acessíveis a outros scripts e contatos. Esses dados podem ser recuperados com a GETvalueactionaçã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 do Studio adequadas: Getvalue, Remvalue, Getlist, and Clearlist.
  • Quando a propriedade Persistent é 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 primário precisa acompanhar os scripts secundários gerados. Cada script secundário vai Putvalue com a propriedade Name como "{MasterID}List" e um valor de {ContactID}. Como a "{MasterID} List" é pública, o script primário pode executar periodicamente Getlist para descobrir quantos scripts secundários estão em execução no momento. Em virtude da propriedade Persistent=false, o valor público do script secundário será removido automaticamente quando liberado. Nenhum trabalho extra é necessário para manter uma contagem precisa de scripts secundários.
  • Variáveis públicas não persistentes podem ser compartilhadas por outros scripts/contatos ao longo da vida do script que define essas variáveis. As variáveis são limpas automaticamente ao serem liberadas.
  • Variáveis Persistent devem ser removidas manualmente executando Getvalue (com a propriedade Remover definida como true), Remvalue ou Clearlist. Não é recomendado usar Putvalue para grandes quantidades de dados ou dados necessários por longos períodos de tempo. Se precisar salvar dados, é recomendável usar o Conector DB e se conectar a um banco de dados que você controla.

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.

The icon for the Chat script type - a chat bubble with an ellipsis inside (...), in a diamond shape.

The icon for the Phone script type - an old-style phone handset with curved lines indicating sound coming out of it.

The icon for the Voicemail script type - a symbol that looks like a cassette tape - two circles sitting on a horizontal line.

The icon for the Work Item script type-a piece of paper with one corner folded down and a bullet list on it.

The icon for the SMS script type - a smart phone with a chat bubble coming out of it.

The icon for the Digital script type - a computer monitor with a smartphone next to it.

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; ela se comporta como uma lista de campos ou valores. Use-as para armazenar vários valores ou valores necessários posteriormente em outros scripts. A lista completa de ações, incluindo esta ação, é: Putvalue, Getvalue, Remvalue, Getlist, and 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 TTL hrs 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 tempo de TTL. Isso lhe dá controle total sobre os dados em seus scripts.

Notas:

  • 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úblicas não persistentes podem ser compartilhadas por outros scripts ou contatos ao longo da vida do script que define essas variáveis. As variáveis são limpas automaticamente ao serem 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 identifica exclusivamente esta ação no script. A legenda aparece na tela do script no ícone da ação. The default is the action name.

Scope

Selecione o nível em que os valores atendidos por essa ação ficam visíveis para outros contatos. Somente contatos que compartilham o mesmo escopo poderão acessar os mesmos dados. As opções são:

O Scope que você selecionar deve corresponder ao Scope definido em todas as outras ações de lista que você incluir em seu script. As ações da lista são Putvalue, Getvalue, Remvalue, Getlist, and Clearlist. Mesmo quando o Name da lista for o mesmo, eles não serão reconhecidos se as configurações do Scope não corresponderem.

Name

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, o Name deve ser o mesmo. Se a propriedade Name não corresponder, elas não se reconhecerão, mesmo que a configuração Scope seja a mesma.

Value

O valor ou dados a serem armazenados.

Method

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á selecionado automaticamente.
  • Append: Coloca o novo valor no final da lista. Ao anexar valores, se o número exceder 1.000 anexos em menos de 24 horas, ele não será mais anexado até que alguns dos anexos sejam apagados (após 24 horas).
  • Insert: Coloca o valor no início da lista. Chamadas subsequentes para Getvalue recuperarão dados do início da lista.
Persistent

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

TTL (hrs)

Configure esta propriedade para o período em horas as quais você deseja que os dados estejam disponíveis. Quando o TTL (Time to Live) é atingido, os dados são apagados. O tempo real em que os dados são apagados pode ser de 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 expirar às 10h03, o processo que verifica a expiração do TTL não será executado até as 11h, o que significa que os dados continuarão existindo até as 11h.

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

Condições dos ramais resultantes

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.