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

De LATROMI Manuais
Consulta:Botões
Ir para: navegação, pesquisa
(Init save)
 
(Vários avanços. Salvando antes de incluir imagens)
Linha 1: Linha 1:
 
{{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 '''conexões''' para 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'''. Essas conexões serão abertas em novas janelas.
−
 
 
−
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:
+
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.
 
−
 
 
  
 +
=== 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
 +
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 _varinha mágica_, 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.
  
 +
== Configurações do Conteúdo da Janela ==
  
−
== Tipos de Botões ==
+
=== XXXXXXX ===
−
Existem Botões com diferentes tipos de dados e apresentação. Abaixo, estão descritos cada um deles:
 
  
−
=== Texto ===
 
−
Tipo de Parâmetro que permite a entrada de qualquer caractere.
 
  
−
=== Numérico ===
 
−
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.
 
  
  
−
=== ComboBox ===
 
−
<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
 
−
[[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.]]
 
  
−
=== Lookup ===
 
−
<div class="paragraph">
 
−
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 ==
 
== Utilizando os Botões ==
 
Neste tópico, será explicado como os Botões podem ser utilizados dentro da Consulta:
 
Neste tópico, será explicado como os Botões podem ser utilizados dentro da Consulta:
−
 
 
=== Comandos SQL ===
 
=== Comandos SQL ===
−
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.
+
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 Botão em um Comando SQL, basta posicionar o cursor na parte do comando onde deseja utilizar o Botão, 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 Botão, também é possível selecionar o texto que deseja substituir antes de dar o duplo-clique.
 
[[Arquivo:Client Consulta Substituindo Parametros.png|thumb|none|Substituição dos Botões em Comando SQL da Consulta]]
 
[[Arquivo:Client Consulta Substituindo Parametros.png|thumb|none|Substituição dos Botões em Comando SQL da Consulta]]
−
 
−
 
 
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.
 
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.
−
 
+
Por exemplo, para formatar um Botão do tipo data chamado do '''StartDate''' para o formato brasileiro, ficaria: <code>{?PARAM StartDate|dd/MM/yyyy}</code>.
−
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:
 
Consulte a página abaixo para saber mais sobre os formatos utilizados no sistema:
 
* [[Formatação de Valores]]
 
* [[Formatação de Valores]]
Linha 78: Linha 44:
 
== Ver Também ==
 
== Ver Também ==
 
* [[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 das 17h06min de 7 de fevereiro de 2020

Os Botões da Consulta são utilizados para disponibilizar conexões para 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. Essas conexões serão abertas em novas janelas.

Configuração dos Botões

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 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 _varinha mágica_, 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.

Configurações do Conteúdo da Janela

XXXXXXX

Utilizando os Botões

Neste tópico, será explicado como os Botões podem ser utilizados dentro da Consulta:

Comandos SQL

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 Botão em um Comando SQL, basta posicionar o cursor na parte do comando onde deseja utilizar o Botão, 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 Botão, também é possível selecionar o texto que deseja substituir antes de dar o duplo-clique.

Substituição dos Botões em Comando SQL da Consulta

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. Por exemplo, para formatar um Botão do tipo data chamado do StartDate para o formato brasileiro, ficaria: {?PARAM StartDate|dd/MM/yyyy}. Consulte a página abaixo para saber mais sobre os formatos utilizados no sistema:

Ver Também

Disponível em "http://docs.latromi.com.br/index.php?title=Consulta:Botões&oldid=2375"