Cadastrar conjunto de dados
Pré-requisitos
- Acesso ao menu Configuração > Tipo de conjunto de dados (FO011).
- Acesso ao menu Cadastro > Conjunto de dados (FO009).
- Fonte de dados configurada no SoftExpert Administração.
Apresentação
Um conjunto de dados é uma coleção de dados construída a partir de um comando SQL, com dados provenientes de fontes de dados e bases externas.
Os conjuntos de dados são associados aos formulários por meio de listas de valores que exibem dados externos ao sistema. Sendo assim, os SQLs dos conjuntos de dados devem ser configurados para exibir as informações necessárias para os formulários.
Veja como configurar os conjuntos de dados:
Cadastrar tipo de conjunto de dados
Antes de cadastrar os conjuntos de dados, é necessário configurar os tipos utilizados para classificá-los.
Tais tipos facilitam a organização dos registros no sistema e permitem criar uma hierarquia entre eles.
Para cadastrar um tipo de conjunto de dados, execute os seguintes passos:
1. Acesse o menu Configuração > Tipo de conjunto de dados (FO011).
2. Clique no botão 
.
3. Inclua um identificador e um nome para o conjunto.
4. Se desejar que o tipo seja incluído hierarquicamente abaixo de outro tipo de conjunto de dados, preencha o campo Tipo superior.
5. Clique no botão 
.
Cadastrar conjunto de dados
Informações extras
• Na etapa Construção da Query, deve ser informado o comando SQL que irá definir os critérios de busca e os dados que serão utilizados no conjunto de dados que está sendo configurado.
• A Fonte de dados estabelece a conexão com o banco de dados e deve estar previamente configurada no SoftExpert Administração. Se o usuário possuir permissão, o botão 
será apresentado ao lado do campo, possibilitando a inclusão de uma nova fonte de dados.
• Após informar o comando SQL no campo Construção da Query, alguns botões estarão disponíveis para utilização:
| Executar (Ctrl + Enter) | Clique neste botão para testar a query inserida no campo Construção da Query. Caso ocorra algum erro de comando, será apresentado na tela. |
| Editar parâmetros | Este botão ficará habilitado somente quando houver alguma condição na query cujo valor seja variável. Para isso, é necessário utilizar o ":" após a atribuição para identificar que o valor deve ser um parâmetro. Por exemplo: SELECT IDLOGIN, NMUSER FROM ADUSER WHERE IDLOGIN =:ParamLogin Onde 'ParamLogin' é um parâmetro do formulário. Quando houver parâmetros na query, ao clicar no botão Executar, o sistema irá exibir automaticamente a tela de parâmetros, onde deverão ser informados os valores para a simulação da execução da query. |
| Ordenar dados | Ao clicar neste botão, será apresentada a tela para definir os parâmetros de ordenação. Na seção Campo, selecione a coluna (da query) pela qual os dados serão ordenados e, na seção Orientação, defina se a ordenação será ascendente ou descendente. Caso seja necessário ordenar os dados por meio de uma segunda coluna, clique em Incluir novo e insira a coluna e a orientação da ordenação. Em seguida, clique em Aplicar para que a ordenação seja aplicada no resultado da query. Obs.: somente será possível ordenar os dados por meio das colunas retornadas na query (definidas no SELECT). Caso o comando SQL esteja mostrando todas as colunas (SELECT * FROM TABLE), serão apresentadas todas as colunas na seção Campo. |
| Formatar | Clique neste botão para que o sistema aplique uma formatação (indentação) no comando SQL, tornando-o mais legível para futuras alterações. |
• Para adicionar um usuário, equipe, área ou função à lista de Segurança, basta digitar o nome desejado no campo disponível e selecionar a opção correspondente na lista que será apresentada ou pressionar a tecla "Enter" do teclado. Para excluir, clique no botão 
localizado ao lado do registro desejado.
• Utilize o botão 
, da barra de ferramentas do menu de cadastro de conjunto de dados, para simular o conjunto de dados. Ao clicar no botão, será exibida uma tela contendo os valores dos parâmetros do conjunto.
Conclusão
Com o conjunto de dados configurado, é possível configurar um campo do formulário para buscar dados externos via conjunto de dados.