Telefone é a coleção de dados que registra os telefones dos seguintes atores do sistema: Cliente (Locador), Locatário, Fiador e Representante Legal.
Utilizaremos para construção deste tutorial o formulário de cadastro de Clientes (Locadores), mas, o comportamento é similar nos formulários dos demais atores.
O acesso ao formulário de 'Telefones' (FRM_TELEFONE) ocorre percorrendo-se o seguinte roteiro:
No Menu Principal, clicar na opção 'Cliente (Locador)'
ou... no Menu Principal, clicar na opção 'Locatário'
ou... no Menu Tabelas de apoio, clicar na opção 'Fiador'
ou... no Menu Tabelas de apoio, clicar na opção 'Representante Legal'
Na guia 'Lista', selecionar um dos itens relacionados
Na guia 'Dados', pressionar o botão de ação - Vincular telefone: símbolo de um 'telefone na cor vermelha'
Veja a imagem demonstrada a seguir o destaque para o ator utilizado como exemplo neste tutorial: (1) Cliente (Locador) e o (2) botão de ação.
Imagem: Formulário com a guia 'Dados' de um Cliente (Locador) com destaque para o botão 'Vincular telefones'
(informações protegidas visando a privacidade dos Titulares dos Dados em conformidade à Lei 13709 - LGPD)
2. Objetos da guia 'Lista'
O sistema apresenta a guia 'Lista' com a relação de todos os os telefones eventualmente já vinculados ao Ator, conforme pode ser observado na imagem a seguir.
Imagem: A guia 'Lista' do formulário de vinculação de telefones
(informações protegidas visando a privacidade dos Titulares dos Dados em conformidade à Lei 13709 - LGPD)
(1) Link: 'Limpar filtros' com a função de limpar os campos destinados ao filtro, o que fará a guia 'Lista' apresentar todos os registros da coleção de dados.
(2) Informação: No lado direito do formulário, poderá ser observada a quantidade de registros desta coleção de dados, de acordo com o filtro aplicado.
(3) Bloco do formulário - Campos filtro: Campos destinados a filtragem de dados. Eles se comportam de forma cumulativa, ou seja, um dado digitado na primeira coluna soma-se ao da segunda,
e assim por diante, aproximando-se ao máximo possível do item pretendido.
(4) Botão de ação - Exportar: símbolo de uma 'pasta com seta para baixo' com a função de exportar toda a coleção de dados para planilha no formato '*.xlsx'.
A planilha será gravada na pasta 'exportação'.
(5) Botão de ação - Adicionar: símbolo de 'sinal matemático de adição' com a função de apresentar a guia 'Dados' e os campos desta coleção de dados para serem preenchidos.
(6) Botão de ação - Tutorial: símbolo do 'sinal gráfico de interrogação' com a função de apresentar o tutorial relacionado à esta coleção de dados.
(7) Botão de ação - Fechar: símbolo da 'letra X em um círculo vermelho' podendo ter dois comportamentos quando o formulário é requisitado:
pelo Menu de Opções: o símbolo apresentado é uma 'letra X em um círculo vermelho' com a função de fechar o formulário;
por outro procedimento: assume o 'modo de seleção', retornando o item selecionado ao procedimento origem. Neste caso, se um item for selecionado, o ícone é modificado para
o símbolo de uma 'mão simulando seleção' e, no caso contrário, o ícone original é mantido e nada é retornado ao procedimento origem.
(8) Bloco do formulário - Lista de itens: ao efetuar dois cliques em um dos itens, a guia 'Dados' é apresentada com todos os campos preenchidos para visualização/edição do item selecionado.
3. Objetos da guia 'Dados'
Imagem: Guia 'Dados' com campos em branco para inserção de telefone
(informações protegidas visando a privacidade dos Titulares dos Dados em conformidade à Lei 13709 - LGPD)
Campo - Código: Sequencial atribuído automaticamente pelo sistema que identifica, unívocamente, um item da coleção de dados.
(1) Campo - Tipo do ator: Será preenchido automaticamente de acordo com o formulário pelo qual se iniciou o acesso: Cliente (Locador), Locatário, Fiador ou Representante Legal
Campo - DDI: Código DDI (Discagem Direta Internacional)
Campo - DDD: Código DDD (Discagem Direta a Distância)
Campo - Telefone: Número do telefone
Campo - Ramal: Número do ramal
Campo - Tipo: Tipo do telefone: Residêncial, Celular, Trabalho ou Recado
Campo - Falar com: Pessoa que costuma atender o número cadastrado
(2) Controle CheckBox: Define o telefone principal, se assinalado.
(3) Botão de ação - Atualizar: símbolo de 'setas circulares' com a função de atualizar as informações da coleção de dados.
Ao clicar neste botão de ação, o sistema emitirá uma mensagem de alerta para os campos obrigatórios que não tenham sido preenchidos adequadamente.
(4) Botão de ação - Excluir: símbolo de uma 'lixeira' com a função de excluir o item da coleção de dados.
O sistema emitirá um alerta, caso seja detectado que o item está vinculado a outras coleções de dados e a exclusão não será permitida.
(5) Botão de ação - Voltar: símbolo de uma 'seta apontando para a esquerda' com a função de retornar para a guia 'Lista'.
Caso alguma informação tenha sido digitada ou alterada, o sistema informará que elas não serão efetivadas no banco dados, se o retorno à guia 'Lista' for confirmado.