Sqlselect

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

Ícone de SQLSelect: três quadrados com setas para baixo abaixo deles

Envia uma instrução SQL (Structured Query Language) para um servidor de banco de dados e retorna um único resultado.

Dependências

  • Use a Sqlcursor ação quando múltiplos resultados de linha forem necessários.
  • Normalmente, uma consulta retorna uma ou mais colunas de dados. Quando NiCE CXone retorna os dados do servidor de banco de dados de volta para o script, cada coluna individual é armazenada em uma variável com o mesmo nome.
  • Você precisará determinar se deseja uma conexão padrão, criptografada ou VPN ao seu provedor de banco de dados.
  • Use a SETDB ação para escolher o grupo DB Connector no qual você deseja fazer consultas. Sem Setdb, o banco de dados NiCE CXone padrão é usado. Esse banco de dados é um dicionário genérico de tabelas fornecidas a todos os clientes.

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

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.

SQLQuery

A Instrução SQL que será enviada ao servidor de banco de dados. É esperado que esta declaração retorne registros.

Variáveis globais

Não utilizado.
Publicar

Publica uma variável e um valor.

Esta propriedade publica tudo no banco de dados associado a um contato.

Se você quiser publicar dados específicos, use a Assign ação.

TimeoutSec

O número de segundos que a ação aguarda para ser executada antes de atingir o tempo limite. O valor deve estar entre 0 e 60.

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.
NoRecords Path taken if there are no values for the specified properties. Isso acontece quando os dados não são retornados do banco de dados.
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.
OnTimeout Path taken if there is no response for the number of seconds specified.

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.

Este exemplo mostra a lógica que pode ser usada com a ação SQLSELECT em seu script. A SETDB ação define o grupo DB Connector que contém o banco de dados que você deseja consultar. SQLSELECT envia uma consulta ou procedimento armazenado. Ele retorna um único registro para o script. Os dados identificados na instrução SELECT são retornados ao script como variáveis e valores individuais.

As ações SNIPPET neste exemplo conteriam lógica para tratar cada ramificação adequadamente. A ramificação NoRecords é usada quando não há resultados retornados pela consulta.

Exemplo de script usando a ação SQL Select

Baixar este script.