Mudanças entre as edições de "Consulta:Botões"

De LATROMI Manuais
Consulta:Botões
Ir para: navegação, pesquisa
(Init save)
 
m (Conteúdo da Janela: Ícone linde)
 
(7 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 1: Linha 1:
 +
[[Arquivo:Client Consulta Botao lista.png|miniaturadaimagem|Lista de Botões da Consulta]]
 +
[[Arquivo:Web Consulta Botao.png|miniaturadaimagem|Botões da Consulta exibidos no LATROMI Web]]
 
{{DISPLAYTITLE:Botões da Consulta}}
 
{{DISPLAYTITLE:Botões da Consulta}}
Os Botões da Consulta são utilizados para disponibilizar '''conexões''' para consultas, formulários dinâmicos ou referências internas, possivelmente . Eles são utilizados na composição dos Comandos SQL, mas também podem ser usados para compor o título da Consulta e para serem passados como parâmetro para objetos que venham a ser chamados de dentro da Consulta.
+
Os Botões da Consulta são utilizados para disponibilizar '''chamadas''' de outros objetos, sendo esses consultas, formulários dinâmicos ou referências internas, possivelmente representando '''ações''' que não dependem das informações retornadas na Consulta no '''LATROMI Web'''. O conteúdo será aberto em uma nova janela.
 
 
Ao contrários do que acontece com os outros objetos, os Botões da Consulta são únicos que podem ser preenchidos manualmente pelo usuário durante o acesso no '''LATROMI Web'''.
 
  
 
== Configuração dos Botões ==
 
== Configuração dos Botões ==
Na tela de modificação de parâmetro, estão uma série de campos de configuração, os quais serão descritos abaixo:
+
[[Arquivo:Client Consulta Botao configuracao .png|miniaturadaimagem|none|Tela de Configuração dos Botões da Consulta]]
 +
Na tela de modificação de Botão, estão uma série de campos de configuração, os quais serão descritos abaixo:
  
 
=== Nome ===
 
=== Nome ===
Nome do Parâmetro. É um campo chave, usado para identificar o parâmetro dentro do sistema. Ele deve ser único dentro da Consulta.
+
Nome do Botão. É um campo chave, usado para identificar o Botão dentro do sistema. Ele deve ser único dentro da Consulta. Esse nome também é o texto que será exibido no '''LATROMI Web''' para o usuário.
É permitida apenas a entrada de letras sem acentuação, números e o caractere "_" (underline).
 
 
 
=== Descrição ===
 
Descrição do Parâmetro. É o texto que será exibido no '''LATROMI Web''' para apresentar o campo ao usuário. Se não for preenchido, o sistema usará o nome do parâmetro.
 
 
 
=== Tooltip ===
 
Texto do balão de ajuda, que é mostrado no navegador ao posicionar o cursor do mouse sobre o parâmetro.
 
 
 
=== Tipo ===
 
Tipo do Parâmetro. Cadas tipo possui diferentes apresentações e tipos de dados. Veja mais no tópico [[#Tipos de Botões]].
 
 
 
=== Valor Padrão ===
 
Valor inicial do Parâmetro. Se for especificado, o parâmetro será preenchido automaticamente com este valor ao abrir a Consulta no LATROMI Web.
 
 
 
=== Largura ===
 
Largura do Parâmetro em pixels.
 
 
 
=== Preenchimento Obrigatório ===
 
Se estiver marcado, será obrigatório o preenchimento do Parâmetro antes de efetuar a Consulta.
 
Quando a Consulta está com a configuração "''Executar consulta ao iniciar''" habilitada, a validação dos Botões é ignorada.
 
 
 
=== Visível ===
 
Se estiver marcado, o Parâmetro não será exibido no LATROMI Web para o usuário.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
== Tipos de Botões ==
 
Existem Botões com diferentes tipos de dados e apresentação. Abaixo, estão descritos cada um deles:
 
  
=== Texto ===
+
=== Balão de Ajuda ===
Tipo de Parâmetro que permite a entrada de qualquer caractere.
+
Texto do balão de ajuda, que é mostrado no navegador ao posicionar o cursor do mouse sobre o Botão. Esse campo pode ser deixado em branco.
  
=== Numérico ===
+
=== Ícone ===
Tipo de Parâmetro que permite apenas a entrada de números. Quando este tipo é selecionado, o campo para configurar as '''Casas Decimais''' é exibido na tela de Configuração de Botões.
+
Imagem que aparecerá à esquerda do nome do Botão. Pode ser um símbolo [[Font Awesome]] ou uma imagem adicionada ao sistema de arquivos do '''LATROMI Client'''. Para saber mais, veja [[Ícones]].
 +
O ícone é opcional e, se não for usado, o Botão será representado no '''LATROMI Web''' apenas com o seu nome.
  
 +
=== Conteúdo da Janela ===
 +
Objeto que será aberto na nova janela quando o Botão for pressionado no '''LATROMI Web'''. Pode ser de um dos seguintes três tipos: Referência Interna, Fomulário Dinâmico ou Consulta. Em todos os casos, é permitida a passagem de parâmetros para o objeto e a configuração da janela.
 +
Para escolher o conteúdo da janela, clique no ícone [[Arquivo:Client Geral Icone Varinha Magica.png]], escolha o tipo do objeto e depois escolha o objeto desejado.
  
=== ComboBox ===
+
=== Parâmetros do Conteúdo da Janela ===
<div class="paragraph">Tipo de Parâmetro que restringe a entrada de dados à opções pré-definidas em forma de lista. Para adicionar ou modificar as opções clique no botão
+
Permite o preenchimento dos Parâmetros do objeto escolhido. Os valores podem ser selecionados ou preenchidos manualmente.
[[Arquivo:Client Consulta Buttons ComboBoxItems.png|Botão para adicionar ou modificar as opções dos Botões do tipo ComboBox da Consulta]], que fica ao lado do campo '''Tipo'''.</div>
 
  
[[Arquivo:Client Consulta ParametroComboBox.png|miniaturadaimagem|nenhum|Modificando as opções de um parâmetro de Consulta do tipo ComboBox.]]
+
=== Configurações do Conteúdo da Janela ===
 +
[[Arquivo:Client Consulta Botao configuracao configuracoes.png|miniaturadaimagem|none|Configurações do Conteúdo da Janela na Tela de Configuração dos Botões da Consulta]]
  
=== Lookup ===
+
==== Título da Janela ====
<div class="paragraph">
+
Título mostrado na janela. Se não for informado, será usada a descrição do objeto selecionado.
Este tipo de Parâmetro exibe um conjunto de opções provenientes do banco de dados para o usuário selecionar uma delas. Para isso, é necessário vincular um [[Browser Dinâmico:Visão Geral|Browser Dinâmico]] ao Parâmetro. Para fazer este vínculo, clique no botão [[Arquivo:Client Consulta Buttons LookupLink.png|Botão para configurar o vínculo entre Lookup e Browser Dinâmico]].
 
</div>
 
Para obter maiores informações, acessa a página de [[Configuração de Lookup]].
 
  
== Utilizando os Botões ==
+
==== Habilitar Modal ====
Neste tópico, será explicado como os Botões podem ser utilizados dentro da Consulta:
+
Se habilitado, a janela abrirá em modo Modal, ou seja, qualquer objeto que esteja abaixo da janela só poderá ser acessado quando a mesma for fechada.
  
=== Comandos SQL ===
+
==== Dimensões da Janela ====
A função principal dos Botões é servir de '''filtro''' para os dados que serão retornados para geração da Consulta. Para usar um parâmetro em um Comando SQL, basta posicionar o cursor na parte do comando onde deseja utilizar o parâmetro, localiza-lo na arvore a direita e dar um duplo-clique com o botão esquerdo do mouse. Se quiser substituir uma parte do comando por um parâmetro, também é possível selecionar o texto que deseja substituir antes de dar o duplo-clique.
+
Altura e largura da janela. Se não forem especificadas, serão usados os valores padrão conforme o tipo de objeto.
[[Arquivo:Client Consulta Substituindo Parametros.png|thumb|none|Substituição dos Botões em Comando SQL da Consulta]]
 
  
 +
==== Estado da Janela ====
 +
Estado de tamanho inicial da janela.
  
Quando as marcações são utilizadas para compor o título, é possível especificar o formato a ser utilizado. Para isso, basta adicionar um "|" (pipe) antes de fechar a marcação e em seguida o formato.
+
==== Atualizar a Janela Pai ====
 +
Se habilitado, a janela pai será atualizada quando a janela filha for fechada. Se a janela filha for um Formulário Dinâmico, a janela pai só será atualizada se o botão 'OK' do Formulário for pressionado ao menos uma vez.
  
Por exemplo, para formatar um parâmetro do tipo data chamado do '''StartDate''' para o formato brasileiro, ficaria: <code>{?PARAM StartDate|dd/MM/yyyy}</code>.
 
  
Consulte a página abaixo para saber mais sobre os formatos utilizados no sistema:
 
* [[Formatação de Valores]]
 
  
 
== Ver Também ==
 
== Ver Também ==
 +
* [[Consulta:Formulários Dinâmicos|Formulários Dinâmicos]]
 
* [[Consulta:Visão Geral|Visão Geral da Consulta]]
 
* [[Consulta:Visão Geral|Visão Geral da Consulta]]
 +
* [[Consulta:Parâmetros|Parâmetros]]

Edição atual tal como às 18h36min de 11 de fevereiro de 2020

Lista de Botões da Consulta
Botões da Consulta exibidos no LATROMI Web

Os Botões da Consulta são utilizados para disponibilizar chamadas de outros objetos, sendo esses consultas, formulários dinâmicos ou referências internas, possivelmente representando ações que não dependem das informações retornadas na Consulta no LATROMI Web. O conteúdo será aberto em uma nova janela.

Configuração dos Botões

Tela de Configuração dos Botões da Consulta

Na tela de modificação de Botão, estão uma série de campos de configuração, os quais serão descritos abaixo:

Nome

Nome do Botão. É um campo chave, usado para identificar o Botão dentro do sistema. Ele deve ser único dentro da Consulta. Esse nome também é o texto que será exibido no LATROMI Web para o usuário.

Balão de Ajuda

Texto do balão de ajuda, que é mostrado no navegador ao posicionar o cursor do mouse sobre o Botão. Esse campo pode ser deixado em branco.

Ícone

Imagem que aparecerá à esquerda do nome do Botão. Pode ser um símbolo Font Awesome ou uma imagem adicionada ao sistema de arquivos do LATROMI Client. Para saber mais, veja Ícones. O ícone é opcional e, se não for usado, o Botão será representado no LATROMI Web apenas com o seu nome.

Conteúdo da Janela

Objeto que será aberto na nova janela quando o Botão for pressionado no LATROMI Web. Pode ser de um dos seguintes três tipos: Referência Interna, Fomulário Dinâmico ou Consulta. Em todos os casos, é permitida a passagem de parâmetros para o objeto e a configuração da janela. Para escolher o conteúdo da janela, clique no ícone Client Geral Icone Varinha Magica.png, escolha o tipo do objeto e depois escolha o objeto desejado.

Parâmetros do Conteúdo da Janela

Permite o preenchimento dos Parâmetros do objeto escolhido. Os valores podem ser selecionados ou preenchidos manualmente.

Configurações do Conteúdo da Janela

Configurações do Conteúdo da Janela na Tela de Configuração dos Botões da Consulta

Título da Janela

Título mostrado na janela. Se não for informado, será usada a descrição do objeto selecionado.

Habilitar Modal

Se habilitado, a janela abrirá em modo Modal, ou seja, qualquer objeto que esteja abaixo da janela só poderá ser acessado quando a mesma for fechada.

Dimensões da Janela

Altura e largura da janela. Se não forem especificadas, serão usados os valores padrão conforme o tipo de objeto.

Estado da Janela

Estado de tamanho inicial da janela.

Atualizar a Janela Pai

Se habilitado, a janela pai será atualizada quando a janela filha for fechada. Se a janela filha for um Formulário Dinâmico, a janela pai só será atualizada se o botão 'OK' do Formulário for pressionado ao menos uma vez.


Ver Também