> For the complete documentation index, see [llms.txt](https://gogest.gitbook.io/gogest-web-mobile/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gogest.gitbook.io/gogest-web-mobile/configuracoes/interface.md).
# Interface
## Listagem de ecrã
Nesta secção são representadas todas as listagens de todas as entidades. Aqui é permitido personalizar a forma como a listagem é apresentada, a ordenação das colunas, dar uma limitação aos campos e atribuir-lhes uma formatação.
Para verificar a listagem na imagem abaixo, tem de se selecionar nas configurações de administração a seção **Interface** e de seguida **Listagens de Ecrã**.
Selecionando uma das listagens entrará numa seção onde pode efetuar as alterações acima referidas.
Algumas informações que podem ser encontradas nas listagens de ecrã:
## **Dados Principais**
* `Nome`Nome da listagem**.**
* `Disponível`Para disponibilizar a respetiva listagem nos dispositivos pretendidos**.**
* `Entidade`Representa a entidade em letras **maiúsculas.**
* `Descrição`Descrição da listagem.
* `Número de registos por omissão`Número de linhas apresentados na visualização das listagens**.**
* `Inactivo`Activação ou desativação da listagem .
### **Listagem**
* `Campo`Campo a mostrar na listagem**.**
* `Nome/Descrição`Nomes que irão representar o campo nas colunas da listagem**.**
* `Tamanho`Tamanho do campo na listagem**.**
* `Formatação`Tipo do campo.
* `Ordem`Número que representa o valor de ordem da coluna representada**.**
### **Ordenação**
Campo pela qual quer a listagem ordenada e qual a ordem.
### **Pesquisa**
Para efetuar pesquisas por campo. A ordem significa a posição representada na ordem ao selecionar os campos. Exemplo completo nas imagens abaixo.
Na ordenação dos campos, o **nome** como pode ser observado é o primeiro elemento da lista, logo recebe o valor **1** na configuração da ordem.
### **Caracterização**
A caracterização serve para criar uma filtragem dos elementos da listagem**.**
* `Largura da Caracterização`Valor da largura da filtragem no ecrã **.**
* `Localização`Localização da filtragem (Lateral ou Superior)**.**
* `Tipo`Representa o tipo da filtragem (Normal ou Prestashop)**.**
* `Carregamento`Forma como a filtragem é expandida na altura.
* `Expandido`Para aparecer ou não de forma expandida (Collapse)**.**
* `Título`Título da filtragem .
* `Ordem`Ordem da filtragem**.**
1. **Chave -** Chave que vai ser usada para fazer filtragem na tabela (Se não for colocado ***valor*** faz filtragem apenas pela ***chave***).
2. **Valor -** Descrição da filtragem.
3. **Imagem -** Imagem representante do valor.
### **Grid Template**
Para representar uma listagem em formato de grelha.
Para ver a listagem em modo normal, por omissão, basta selecionar a outra opção em ***ver como***.
Para configurar esta opção de modo grelha só tem de seguir os seguintes passos..
Pode selecionar a listagem em grid **por defeito** e será representada imediatamente assim que abrir a listagem.
Pode adicionar um campo à sua grelha através do template HTML, tais como os elementos representados na imagem.
### **GPS Template**
GPS Template serve para personalizar a informação que aparece no marcador da dispersão GPS.
Na imagem abaixo temos um exemplo de como podemos configurar os campos que queremos representar na dispersão GPS.
{% hint style="info" %}
**Observação:** Caso não sejam indicados campos no template html, aparecerão os campos da listagem padrão nos marcadores.
{% endhint %}
Para perceber melhor a diferença, vamos distinguir entre dispersão GPS com template e sem template.
Toda esta configuração é efetuada nas configurações de **interface** nas **listagens de ecrã.**
Neste caso apresentamos o **nome** e o **saldo.** A representação é feita utilizando código HTML.
**Configurações de longitude e latitude.**
Para aceder a este espaço de configuração teremos de ir a **configurações**, selecionar **catálogos** e escolher o separador **dispersão gps**.
Segue-nos esta lista com as entidades base e só temos selecionar e entidade base pretendida..
Selecionando a entidade base, teremos de proceder às seguintes configurações.
Aqui podemos definir os campos respetivos à longitude e à latitude, tal como segue no exemplo abaixo..
**Dispersão GPS com Template**
Para usarmos os campos referenciados acima temos de aceder à página da dispersão GPS.
Neste caso, vamos em busca dos clientes com saldo maior que zero.
Estes clientes são representados com um marcador com uma cor específica tendo em conta a sua condição.
Neste momento, observamos dois marcadores no mapa apresentado, se carregarmos em cima de um dos marcadores, podemos verificar que são representados o **nome** e o **saldo**, que foram configurados previamente.
* **Dispersão GPS sem Template**
Caso os campos da configuração do template HMTL estejam vazios, os campos na dispersão GPS surgirão da seguinte forma..
Como podemos observar aparecem os campos que são referentes aos diversos clientes, na dispersão clientes.
Ao clicarmos em cima de um marcador temos então acesso a essa lista completa de informação.
### **Fluxo Template**
O fluxo template serve para usar a funcionalidade de painéis para representar o fluxo de ações e o seu respetivo estado atual.
Para acedermos a este espaço de configuração teremos de ir às configurações de **listagens de ecrã**.
Seguimos com o seguinte exemplo de configuração de um fluxo template..
**Configuração do fluxo template**
* `Tem template fluxo`Para indicar que existe um template definido para o fluxo**.**
* `Listagem em fluxo por defeito`Para aparecer o fluxo por definição.
* `Campo fluxo`Campo que vai representar o fluxo template**.**
* `Template (HTML)`Estrutura que representa os componentes que iremos visualizar no fluxo template. Neste caso serão representados 4 campos: O nome, resumo, status e o valor.
* `Campo totalizador de totais`Campo que representa o valor total**.**
***Status***
O ***status*** vai representar cada um dos painéis do fluxo template.
Neste caso, teremos:
* `Em estudo`
* `Pendente`
* `Fechado`
* `Contrato fechado`
* `1º Contacto`
* `Em negociação`
Cada um destes estados tem uma cor associada e uma ordem, que será atribuída no momento em que se consultar o fluxo template.
Na imagem abaixo segue uma demostração de um fluxo template com os parâmetros indicados e com as configurações acima concluídas.
## Impressões ERP
Para efetuar impressões, conversões de documentos para PDF e enviar informação para os clientes ou outros intervenientes, teremos de seguir certos passos.
Para começar teremos de aceder às configurações das **impressões ERP**, que se encontram nas configurações de **interface**.
Neste caso vamos usar o exemplo dos clientes para demonstração.
### Dados Principais
Acedendo às entidades selecionamos a pretendida, que neste caso será a dos **clientes**.
* `Nome`Nome da impressão/template.
* `Nome do Ficheiro`Nome do ficheiro pdf.
* `Entidade`Nome da entidade referente.
* `Tamanho`Tamanho da página.
* `Margem(Esquerda/Direita/Topo/Baixo)`Margens a dar à página.
* `Tamanho da fonte por defeito`Tamanho da fonte.
* `Tamanho Personalizado`Tamanho personalizado da página.
* `Tipo`Tipo da página (Página ou Contínuo).
* `Largura/Altura`Largura e altura.
### Ligações
Nas ligações definimos qual a impressão à qual queremos anexar a presente impressão e qual a ordem.
{% hint style="info" %}
**Observação:** Para editar as ligações basta entrar no modo *Editar Registo* através do ícone 
{% endhint %}
### Cabeçalho
Para acrescentar um cabeçalho à impressão apenas temos de editar o nosso registo.
{% hint style="info" %}
**Observação:** Para editar um campo de cabeçalho basta entrar no modo *Editar Registo* através do ícone
{% endhint %}
### Corpo
Para acrescentar um novo corpo à mensagem da impressão apenas temos de editar o nosso registo.
{% hint style="info" %}
**Observação:** Para editar o corpo da mensagem basta entrar no modo *Editar Registo* através do ícone
{% endhint %}
### Rodapé
Para acrescentar um novo rodapé à impressão apenas temos de editar o nosso registo.
{% hint style="info" %}
**Observação:** Para editar o rodapé da à impressão basta entrar no modo *Editar Registo* através do ícone
{% endhint %}
### CSS
No separador CSS pode acrescentar o código CSS para personalizar a sua impressão.
{% hint style="info" %}
**Observação:** Para editar um campo de CSS basta entrar no modo *Editar Registo* através do ícone
{% endhint %}
### Email
Para acrescentar mensagens e enviar um email podemos adaptar no nosso código para ter algumas mensagens programadas e que encaixam em todos os emails.
Desta forma podemos personalizar o nosso código efetuando as alterações seguintes, como podemos observar na mensagem seguinte..
**Campos**
* `Destinatário(DE)`Email do emissor da mensagem.
* `Destinatário(PARA)`Email do destinatário da mensagem.
* `Destinatário(CC)`Email do destinatário anexado.
* `Destinatário(BCC)`Email do destinatário anexado.
* `Template para Assunto de Email`Template do assunto da mensagem.
* `Template para Mensagem de Email`Template da mensagem.
{% hint style="info" %}
**Observação:** Para editar um campo de Email basta entrar no modo *Editar Registo* através do ícone
{% endhint %}
### SMS
Se pretender enviar uma mensagem por SMS recorremos à seguinte configuração.
***Campos***
* `Destinatário(DE)`Email do emissor da mensagem.
* `Destinatário(PARA)`Email do destinatário da mensagem.
* `Destinatário(indicativo)`Indicativo de destinatário.
* `SMS`Mensagem a enviar.
{% hint style="info" %}
**Observação:** Para editar um campo de SMS basta entrar no modo *Editar Registo* através do ícone
{% endhint %}
* **Impressão**
Para efetuar a impressão e verificar-mos na prática o envio de Email e de SMS, acedemos primeiramente à listagem de clientes no separador de **Gestão**.
Selecionando um elemento da lista teremos acesso aos dados principais do respetivo cliente.
{% hint style="info" %}
**Observação:** Para efetuar a impressão basta entrar no modo *Imprimir* através do ícone 
{% endhint %}
Agora teremos três opções como demonstra a seguinte imagem**..**
### Impressão
Para efetuar uma impressão teremos de selecionar a Impressão/Template correta e pressionar **Imprimir**.
Desta forma será criado um ficheiro *PDF*.
Neste caso temos o PDF com a informação do cliente, juntamente com as configurações elaboradas anteriormente.
Informamos na primeira página, o Nome, o NIB e o Saldo que foram campos do utilizador configurados anteriormente.
### Envio por Email
Para enviar um email para o destinatário pretendido preenchemos os seguintes campos..
***Campos***
* `Impressão/Template`Template a ser usado.
* `Nome Ficheiro`Ficheiro a ser enviado.
* `De`Email do emissor do email.
* `Para`Email do destinatário do email.
* `CC`Utilizador anexado que recebe cópia da mensagem (Com conhecimento).
* `BCC`Utilizador anexado que recebe cópia da mensagem (Com conhecimento).
* `Assunto`Assunto da mensagem.
* `Mensagem`Mensagem a enviar.
Caso a mensagem esteja vazia..
{% hint style="danger" %}
#### Mensagem de erro! Campo da mensagem não pode estar vazio para poder enviar um email.
{% endhint %}
### Envio por SMS
Para enviar um SMS para o destinatário pretendido preenchemos os seguintes campos..
***Campos***
* `Impressão/Template`Template a ser usado.
* `De`Email do emissor do email.
* `Para`Email do destinatário do email.
* `Mensagem`Mensagem a enviar.
* `Encoding`Para permitir caracteres especiais.