Feedback Imprimir

Filtro

Configuração

Através do quadro abaixo podemos definir todas as opções que farão parte do Filtro do Formulário.

Interface de configuração do Filtro. Interface de configuração do Filtro.

  • Atributos

  • Filtro Vazio : Se o usuário escolher Sim, serão apresentados todos os registros, caso os campos do filtro estejam em branco. Se a opção for Não nenhum registro é exibido.
  • Condição do Filtro : Permite selecionar o comando SQL AND (e) ou OR (ou) para definir os critérios de pesquisa a serem utilizados;
  • Exibir Condição : Exibir condição do filtro para que o usuário possa escolher sua opção. Nesse caso “AND” (e) ou “OR” (ou) aparecerão no Formulário de Filtro para que o usuário selecione a opção desejada.
  • Usar Autocomplete nos Campos : Campo vira autocomplete automaticamente de acordo com os valores existentes no banco de dados, Se o usuário escolher Sim, o autocomplete será habilitado de forma automatica em todos os campos que possuirem relacionamento. Se a opção for Não nenhum autocomplete será exibido. Caso a opção selecionada seja Defino por campo será respeitada a configuração individual de cada campo.

Condições do Filtro

Interface Configuração do Filtro. Interface Configuração do Filtro.

Nesta interface podemos configurar quais as condições de filtragem (SQL) para cada campo que faz parte do filtro, no combo da esquerda é exibido o campo. No Combobox a direita ficam as opções de filtro relacionadas ao campo, para selecionar as opções clique na opção desejada (Exatamente igual, Início igual, Qualquer parte e etc) e no botão Liga / Desliga. As setas a direita servem para alterar a ordem dos campos.

Para campo do tipo Data você pode definir condições especiais de pesquisa, acessando diretamente o campo e editando a guia de edição Condições Especiais.

Abaixo e ao lado da lista existem os botões padrão das demais listas descritas:

  • Botão Liga/Desliga : Ativa ou desativa o campo ou opção selecionado.
  • Botão Todos : Marca todos os campos ou opções.
  • Nenhum : Demarca todos os campos ou opções.

Filtro Avançado

Configuração

Através do quadro abaixo podemos definir todas as opções que farão parte do Filtro da aplicação de Consulta.

Interface Configuração do Filtro Avançado.

  • Margens : Permite definir o posicionamento (margens) do form de filtro.
  • Manter valores : Quando Ativado os valores do último filtro são mantidos e exibidos quando o usuário retorna à tela de filtro.
  • Preservar Colunas e Ordenação : permite determinar se, a cada filtro, devem ser preservados os valores selecionados para os campos da consulta e ordenação, ou seja, a cada filtro, estes valores retornam a condição original.
  • Usar tecla enter para : Permite definir a ação que a tecla enter terá na tela de filtro. Tabular Permite navegar entre os campos e submeter realiza a busca(ativa o botão Pesquisar)
  • Exibir etiquetas : Permite exibir os filtros utilizados para a consulta em forma de etiquetas.
  • Exibir após filtrado: Esta opção define o momento de exibição das etiquetas. Ao habilitar as etiquetas serão exibidas após realizar um busca avançada, se desabilitada as etiquetas serão sempre exibidas independente da realização de uma busca avançada prévia.
  • Agrupar resultados : Define a quantidade de caracteres para agrupar o resultado das tags. Opção deve ser utilizada para uso quando o campo é de múltipla seleção.
  • Treeview nas tags : Define a utilização ou não do treeview nas tags.
  • Estado inicial do treeview : Esta opção funciona apenas se o treeview estiver sendo utilizado e define o estado inicial do treeview.
    • Aberto: exibindo as tags Etiquetas com treeview aberto.
    • Fechado: mostrando a descrição completa como texto Etiquetas com treeview fechado.

Selecionar Campos

Interface de seleção dos campos do filtro. Interface de seleção dos campos do filtro.

Obrigatórios

Define quais campos da aplicação serão de preenchimento obrigatório.

Interface campos Obrigatórios. Interface campos Obrigatórios.

Na aplicação gerada é exibido um marcador (*) ao lado do campo e é gerada uma crítica caso não seja atribuído nenhum valor.

Interface de configuração do posicionamento do marcador. Interface de configuração do posicionamento do marcador.

  • Posição do marcador : Posição do marcador em relação ao campo.
  • Mostrar mensagem : Exibe ou não a mensagem de erro na validação.

Barra de ferramentas

Salvar Filtro

Eventos

Nos blocos de eventos podem ser utilziadas variáveis globais, locais, códigos JavaScript, códigos CSS e macros.

onScriptInit

Este evento ocorre no momento de inicialização dos scripts da aplicação. É executado antes do evento OnLoad ( quando presente ), porém, sempre é executado ao executar, recarregar ou navegar na aplicação.

onRefresh

Este evento ocorre no momento que o refresh da aplicação é ativado.

onSave

Este evento ocorre no momento de salvamento da aplicação.

onValidate

Este evento ocorre no momento de validação das informações dos campos, ao submeter o formulário.

Layout

Neste módulo estão disponíveis recursos de edição, atributos e visualização da aplicação, de forma que podemos atribuir esquemas de visualização, organizar os campos em blocos, definir os valores e o formato do cabeçalho entre outros.

Blocos

Conceitualmente um bloco é um “container” onde posicionamos nossos campos de uma Aplicação de Formulário, Controle ou Consulta com orientação Slide.

Por padrão as aplicações criadas no Scriptcase são constituídas de um único bloco, este com o mesmo nome da aplicação. Podemos adicionar quantos novos blocos quisermos e organizá-los da maneira que nos for mais conveniente. Na tela abaixo observe que há uma coluna chamada ORGANIZAÇÃO , é lá que definimos se o próximo bloco virá ao lado ou abaixo do corrente.

Configuração dos blocos da aplicação Configuração dos blocos da aplicação

No lado esquerdo de cada bloco existem dois ícones, o primeiro Configuração dos blocos da aplicação tem a função de editar todas as informações relativas ao bloco e o segundo Configuração dos blocos da aplicação para exclusão do bloco.

  • Organização e Mudança de posição dos Blocos
    • Veja abaixo como alterar a ordem de exibição dos Blocos de uma Página.

    Clique e araste o bloco que deseja alterar para a sua nova posição.

    Configuração de exibição dos blocos da aplicação Configuração de exibição dos blocos da aplicação

    • Veja agora como remover um bloco da exibição

    Clique sobre o bloco desejado e arraste-o até o item “Blocos não exibidos”. Desta forma, assim como você pode remover um bloco arrastando-o até o item “Blocos não exibidos”, para mudar um bloco de página é só arrasta-lo até a página desejada. Veja as imagens abaixo.

    Configuração de exibição dos blocos da aplicação Configuração de exibição dos blocos da aplicação

    Configuração de exibição dos blocos da aplicação Configuração de exibição dos blocos da aplicação

    • Atributos
      • Bloco
        • Nome : Nome do Bloco.
        • Label : Título do bloco que será exibido na aplicação.
      • Titulo
        • Exibir : Flag que controla se o título do bloco será exibido.
      • Label
        • Exibir : Flag que controla se o label dos campos dentro do bloco devem ser exibidos.
        • Posição : Opções de exibição do label :
          • Acima : o label será exibido acima do campo.
          • Ao Lado : o label será exibido ao lado do campo.
          • Abaixo : o label será exibido abaixo do campo.
      • Campos
        • Colunas : Quantidade de colunas a serem exibidas lado a lado dentro do bloco.
        • Posição : De que forma os campos serão exibidos dentro do bloco :
          • Abaixo : Os campos serão exibidos um abaixo do outro respeitando a quantidade de colunas.
          • Ao lado : Os campos serão exibidos ao lado do outro respeitando a quantidade de colunas.
          • Corrido : Os campos serão exibidos lado a lado sem conter tabulação.
      • Organização
        • Próximo : Forma como os blocos ficarão organizados dentro da página:
          • Abaixo : Indica que o próximo bloco será exibido abaixo.
          • Ao lado : Indica que o próximo bloco será exibido ao lado.
        • Largura : Especifica em pixels ou percentual a largura que o bloco deverá ocupar, caso a informação seja em percentual especificar (%).
        • Colapse : Habilta opção de fechar (colapse) o bloco.
  • Inclusção de blocos

    Para incluir novos blocos em uma Aplicação, basta clicar no botão Configuração de criação dos blocos da aplicação. Em seguida, será apresentada a seguinte interface para definição do nome e label do bloco. No fim clique no botão Criar.

    Interface de criação dos blocos da aplicação Interface de criação dos blocos da aplicação

    • Atributos
      • Nome : Nome do bloco.
      • Label : Texto que será que mostrado no bloco da aplicação.
  • Edição dos blocos

    Para editar um bloco basta clicar no ícone Configuração dos blocos da aplicação, que fica do lado esquerdo do bloco. Em seguida, será apresentada a seguinte interface para definição dos parâmentros do bloco. No fim clique no botão Salvar.

    Interface de edição dos blocos da aplicação Interface de edição dos blocos da aplicação

    • Atributos
      • Nome : Nome do bloco.
      • NTítulo : Exibe o título do bloco.
      • Exibir Título : Esta opção, quando ativada, permite exibir o título do bloco.
      • Fonte do Título : Nome da fonte aplicada no título do bloco.
      • Tamanho da Fonte : Tamanho da fonte aplicada ao título do bloco.
      • Cor da Fonte : Cor da fonte do título do bloco.
      • Cor do Fundo : Cor de fundo da linha do título do bloco.
      • Figura de Fundo : Figura de fundo da linha do título do bloco.
      • Altura do Título : Altura em pixels da linha do título do bloco.
      • Alinhamento Horizontal : Alinhamento horizontal do título do bloco (Esquerda, Centro e Direita).
      • Alinhamento Vertical : Alinhamento vertical do título do bloco(Topo, Meio e Baixo).
      • Exibir Label : Exibir os labels dos campos do bloco.
      • Colunas : Quantidade de colunas de campos no bloco.
      • Largura das Colunas : Forma de cálculo das colunas do bloco.
      • Cor do Label : Cor para exibir o label dos campos.
      • Organização dos Campos : Forma de organização dos campos no bloco.
      • Posição do Label : Posicionamento do label dos campos em relação aos dados.
      • Próximo Bloco : Posicionamento do próximo bloco em relação ao atual.
      • Cor da Borda : Cor da borda do bloco.
      • Largura da Borda : Largura da borda do bloco.
      • Largura do Bloco : Largura do bloco (width).
      • Altura do Bloco : Altura do bloco (height).
      • CellSpacing : Espaçamento das células do bloco.
      • Collapse : Habilta opção de fechar (colapse) o bloco.

Visualização

Nesta interface, podemos definir o esquema de visualização de uma aplicação em específico, isto porque o Scriptcase utiliza a definição de Valores Padrões por Projeto, que além do esquema de visualização, permite a definição de valores a outros atributos a nível de Projeto.

Configuração de visualização de temas da aplicação Configuração de visualização de temas da aplicação

  • Configuração de visualização
    • Modelo para o Cabeçalho : Permite a escolha do modelo para compor o cabeçalho da aplicação.
    • Modelo para o Rodapé : Permite a escolha do modelo para compor o rodapé da aplicação.
    • Botão : Permite a escolha do modelo dos botões da aplicação.
    • Temas : Escolhendo um dos temas existentes, será carregado o modo visual (cores,fontes, etc) que irá compor a aplicação.

Cabeçalho e Rodapé

Cabeçalho

Neste bloco é feita a definição dos conteudos variáveis que farão parte do cabeçalho.

Configuração do cabeçalho da aplicação Configuração do cabeçalho da aplicação

Esta tela pode variar dependendo do formato de cabeçalho escolhido dentro da pasta Visualização.

  • Exibir Cabeçalho : Esta flag determina se o cabeçalho será exibido.
  • Título da Consulta : Permite informar um título para ser exibido na aplicação.
  • Variáveis de Cabeçalho : Os campos variáveis podem ser preenchidos com qualquer um dos tipos exibidos no Combobox. Dependendo do tipo, será necessário associar um conteúdo ao mesmo. Abaixo descrevemos os tipos existentes:
    • Campo : Quando se escolhe a opção do tipo “Campo”, abrirá um Combobox ao lado com os campos que fazem parte do “Select”. Escolhendo um desses campos, estará associando o valor do campo para exibição no cabeçalho.
    • Título : Esta opção quando selecionada exibirá no cabeçalho o valor preenchido no “Título do Filtro”.
    • Data : Quando é selecionado o tipo “Data”, será exibido no cabeçalho da controle a data do sistema no formato dd/mm/aaaa. Existem diversos formatos de exibição utilizando a data e a hora do servidor. O formato poderá ser informado no campo texto que aparece ao lado. Para ter acesso aos formatos existentes clique em e aparecerá uma tela explicativa.
    • Imagem : Quando selecionado o campo tipo imagem, aparece um campo para o preenchimento do nome da imagem existente no servidor. Para localizar as imagens existentes e selecionar uma, clique no ícone “Escolher imagem” e para disponibilizar novas imagens no servidor clique em “Fazer upload de uma imagemConfiguração do rodapé da aplicação.
    • Valor : Quando selecionado o tipo “Valor”, o conteúdo preenchido no campo texto que aparece ao lado será exibido no cabeçalho, pode ser informado textos e “Variáveis globais”. Ex: “Nome do Funcionário: [v_nome]”.
Rodapé

Configuração do rodapé da aplicação Configuração do rodapé da aplicação

Esta tela pode variar dependendo do formato de Rodapé escolhido dentro da pasta Visualização.

  • Exibir Rodapé : Esta flag determina se o Rodapé será exibido na aplicação.
  • Variáveis de Rodapé : Os campos variáveis podem ser preenchidos com qualquer um dos tipos exibidos no Combobox, dependendo do tipo será necessário associar um conteúdo ao mesmo. Abaixo descrevemos os tipos existentes:
    • Campo : Quando se escolhe a opção do tipo “Campo”, abrirá um Combobox ao lado com os campos que fazem parte do “Select”. Escolhendo um desses campos, estará associando o valor do campo para exibição no Rodapé.
    • Data : Quando é selecionado o tipo “Data”, será exibido no Rodapé da aplicação a data do sistema no formato dd/mm/aaaa. Existem diversos formatos de exibição utilizando a data e a hora do servidor. O formato poderá ser informado no campo texto que aparece ao lado. Para ter acesso aos formatos existentes clique em Configuração do rodapé da aplicação e aparecerá uma tela explicativa.
    • Imagem : Quando selecionado o campo tipo imagem, aparece um campo para o preenchimento do nome da imagem existente no servidor. Para localizar as imagens existentes e selecionar uma, clique no ícone “Escolher imagem” e para disponibilizar novas imagens no servidor clique em “Fazer upload de uma imagem”.
    • Valor : Quando selecionado o tipo “Valor”, o conteúdo preenchido no campo texto que aparece ao lado será exibido no Rodapé. Pode ser informado textos e “Variáveis globais”. Ex: “Nome do Funcionário: [v_nome]”.

Filtro dinâmico

Funcionalidade que permite que ao usuário final realizar buscas em sua aplicação sem precisar navegar para outra aplicação, o desenvolvedor precisará indicar quais campos ficarão disponíveis na aplicação.

Configuração

Interface Configuração do Filtro dinâmico. *Interface Configuração do Filtro dinâmico.

  • Usar a tecla ENTER para : Utilize a tecla ENTER para tabular de um campo para o próximo, ou para submeter a pesquisa.

Selecionar Campos

Interface de seleção dos campos do filtro dinâmico. Interface de seleção dos campos do filtro dinâmico.

Campos