Configurando o gadget de consulta JDBC

O gadget de consulta JDBC exibe uma consulta do banco de dados JDBC pré-configurada para os usuários. As configurações estão disponíveis para especificar o nome do driver JDBC, as strings de conexão com o banco de dados e a instrução da consulta do banco de dados. Um assistente de configuração é fornecido para personalizar como os resultados da consulta serão exibidos, permitindo que você configure totalmente a instrução da consulta por meio de uma série de menus. Isso inclui a escolha de quais tabelas e campos serão incluídos, filtros para limitar a pesquisa e opções de classificação de coluna. Os filtros têm recursos para incluir condições SQL comuns. Eles também incluem macros de critérios do NDS que usarão os valores de atributo do NDS.

A seguir, um exemplo de consulta:

selecione Nome do funcionário,Sobrenome do funcionário,Telefone residencial de funcionários cujo nome seja = '~Nome~'

Essa consulta retornará o número de telefone residencial da tabela de funcionários para a entrada cujo nome seja igual ao valor Nome do NDS referente ao usuário. O gadget automaticamente substituirá ~Nome~ pelo valor NDS do atributo 'Nome' do usuário.

Use as informações contidas nas seções a seguir como diretrizes para configurar o gadget de consulta JDBC.

Assistente de Configuração da Atribuição do Gadget

Esta seção descreve os campos e as configurações contidos nas quatro páginas do Assistente de Configuração da Atribuição do Gadget. Para obter instruções sobre como configurar uma consulta do banco de dados, consulte Configurando uma consulta do banco de dados.

• Assistente para personalizar consulta JDBC. Permite que você personalize a consulta e as opções de exibição.
• Nome da Classe JDBC. Classe do driver JDBC fornecido ao banco de dados que você deseja usar. Com exceção do JdbcOdbcDriver (JDBC-ODBC bridge driver), essa informação deverá ser indicada pelo fornecedor do banco de dados que você utiliza. Isso também deve ser incluído no caminho de classe (CLASSPATH).
• String necessária para conectar ao banco de dados. String de conexão (URL) necessária para se conectar ao banco de dados. Essa string é específica ao banco de dados. Por exemplo, o ODBC requer o seguinte valor de URL:
  
  jdbc:odbc:fonte_de_dados
  Ondefonte_de_dados é o nome do banco de dados ODBC. Para o banco de dados My SQL, o seguinte URL é necessário:
  
  jdbc:mysql://end_ip/nome_do_banco_de_dados?user=usuário&password=senha
  
  No URL, end_ip é o endereço IP do servidor que hospeda o banco de dados, nome_do_banco_de_dados é o nome do banco de dados, usuário é um nome de usuário opcional usado para se conectar ao banco de dados e senha é a uma senha opcional usada para se conectar ao banco de dados.
• Nome de usuário do banco de dados. Um nome de usuário opcional a ser usado quando se conectar ao banco de dados. Isso é necessário somente para conexões a bancos de dados que não permitem incluir o nome de usuário no URL de conexão.
• Senha do banco de dados. Uma senha opcional a ser usada quando se conectar ao banco de dados. Isso é necessário somente para conexões a bancos de dados que não permitem incluir a senha no URL de conexão.
• Consulta do banco de dados. Uma string de consulta usada para recuperar informações do banco de dados. Por exemplo, SELECT * FROM Clientes.

Configurando uma consulta do banco de dados

Todas as páginas de configuração do assistente são divididas em duas seções. A seção na parte superior fornece informações de configuração, e a na parte inferior fornece os resultados das configurações atuais. Qualquer botão nessas páginas atualizará os resultados. O botão Atualizar Resultados da Consulta é exibido para que se possa atualizar os resultados após a modificação de uma caixa de edição.

Você pode modificar as configurações de Classe JDBC, JDBCConnect, DVUsername e DCPassword na página de configuração.

1. Modifique as configurações de Classe JDBC, JDBCConnect, DVUsername e DCPassword de acordo com suas informações específicas.

2. Clique em Conectar.

   Se os valores de conexão na Passo 1 estiverem corretos, é exibida uma mensagem indicando êxito na conexão.

3. Selecione as opções para modificar a forma como o gadget exibirá os resultados da consulta.

   Após mudar uma opção, clique no botão Atualizar Resultados da Consulta para exibir os resultados com as novas configurações.

4. Clique em Terminar para gravar as modificações e sair do assistente.

   Para obter instruções sobre como criar uma consulta do banco de dados, continue com a próxima seção.

Criando uma instrução da consulta

Você pode criar uma instrução da consulta apenas depois de se conectar ao banco de dados.

1. Clique em Criar Instrução da Consulta.

2. Selecione uma tabela da lista e clique em Mudar Tabela.

3. Selecione um dos campos disponíveis na lista e execute uma das opções a seguir:

   • Para adicionar um outro campo, clique em Adicionar Selecionado.
   • Para adicionar todos os campos à tabela, clique em Adicionar Todos.
   • Para remover um campo específico, clique em Remover.
   • Para remover todos os campos da tabela, clique em Remover Todos.

   Você pode selecionar quantos campos desejar para incluir em sua consulta.

Criando filtros de consulta

1. Clique no Assistente Criar Instrução da Consulta.

2. Clique em Adicionar/Editar.

3. Selecione a coluna que deseja filtrar e clique em Adicionar Filtro.

4. (Opcional) Repita a Passo 3 para obter parâmetros adicionais a serem filtrados.

   Você pode criar filtros de consulta mais complexos usando AND e OR na instrução da consulta.

5. Clique em Terminar > OK > Gravar > Fechar.