Definindo Combos | Início Anterior Próximo

O primeiro componente que iremos definir para o nosso projeto será uma combo. Componentes do tipo combo são definidos no escopo do projeto permitindo assim que sejam reutilizados em mais de uma página. Os valores de um componente combo são sempre populados a partir do resultado de uma consulta feita ao banco de dados e tem como saída uma série de tags OPTION para serem usadas em conjunto com a tag SELECT.
A sintaxe que segue seria a forma padrão para referenciar um componente combo numa página WSP, o sinal de reticências indica os possíveis parâmetros da tag SELECT e <identificador-da-combo> seria o identificador de um componente combo que tenha sido definido no WI_Builder.
<select ...>|combo.<identificador-da-combo>|</select>
A primeira combo que iremos criar deverá ser populada com os possíveis ramos de atividade a que uma empresa pode pertencer. No banco de dados do nosso projeto a informação dos possíveis ramos de atividades de uma empresa encontram-se cadastrados na tabela ramosatividade. Para saber qual o conteúdo dessa tabela, você poderá usar o utilitário "Explorar BD" do WI_Builder, identificado pelo ícone , escolher a opção TABLE da combo Opções Especiais e clicar no link Visualizar, da coluna Conteúdo respectivo à tabela ramosatividade.
Para criarmos a combo com os ramos de atividade siga os passos abaixo:

| ·

No menu Projeto (treeview), que fica no canto superior esquerdo da tela principal do seu projeto WI, clique na opção Combos. Em seguida clique na subopção Combos, que aparece na parte inferior esquerda da tela do seu projeto WI.

| ·

No campo Descrição entre com uma breve descrição informando a funcionalidade dessa combo, por exemplo: Combo que exibe os possíveis ramos de atividade de uma empresa.

| ·

No campo Identificador digite ramosatividade. Este campo indica qual o identificador que será criado para esse componente e que irá identificar unicamente essa combo dentro desse projeto, será através desse identificador que nós faremos referência a essa combo em nossas páginas do projeto.

| ·

No campo SQL digite a instrução de consulta que será enviada ao banco de dados. Para ajudar na construção do comando SQL de consulta vamos utilizar o WIzard SQL identificado pelo ícone que aparece no lado direito do rótulo SQL. O comando SQL que iremos construir deverá retornar todos os possíveis ramos de atividade ordenados ascendemente pela descrição.

| ·

Clique no ícone .

| ·

Na primeira tela do WIzard SQL são exibidas todas as tabelas que fazem parte do banco de dados com o qual estamos trabalhando. Marque a caixa correspondente à tabela ramosatividade.

| ·

Clique na opção Campos da barra superior que aparece na janela do WIzard SQL e depois clique na opção (Todos) para que todos os campos da tabela ramosatividade sejam selecionados.

| ·

Clique na opção Filtros da barra superior que aparece na janela do WIzard SQL. Em Campos escolha o item "ramosatividade.Descricao" , no campo Ordem escolha a opção "Ascendente" e por fim clique no botão "gravar".

| ·

Clique na opção SQL da barra superior que aparece na janela do WIzard SQL, para visualizar o comando gerado e o resultado obtido com a execução dele. Se tudo estiver correto clique no botão "copiar" para que o comando SQL gerado seja copiado para o campo SQL da definição da combo.

| ·

A janela do WIzard SQL fechará automáticamente e, na tela de definição da combo ramosatividade, clique no botão "gravar".

Note que ao salvar a definição da combo os campos Chave e Texto foram preenchidos com |1| e |2| fazendo referência respectivamente à primeira e segunda colunas que são retornadas pela consulta SQL que foi digitada no campo SQL. Normalmente o campo Chave referenciará a coluna que representa a chave primária da tabela e o campo Texto a coluna ou uma combinação de colunas que ofereça uma descrição para essa chave. A figura a seguir exibe como ficará a definição dos campos da combo:
Seguindo a mesma idéia dos passos descritos anteriormente crie mais um componente combo que irá listar os estados ordenados ascendentemente por nome. A tabela a ser usada será uf e como identificador para a combo a ser criada coloque também uf.