WRCAD082 – Relatório de contatos
WRCAD082 – Relatório de contatos — Cadastro Geral (ERPAtak)
O relatório WRCAD082 – Relatório de contatos, do módulo Cadastro Geral (menu Relatórios), lista os contatos cadastrados nos cadastros gerais (clientes, fornecedores e demais tipos de cadastro), mostrando para cada contato o nome, a data de nascimento, os telefones, o celular e o e-mail, junto com a identificação do cadastro, o tipo de cadastro, a UF e o município.
Visão Geral
O relatório WRCAD082 – Relatório de contatos, do módulo Cadastro Geral (menu Relatórios), lista os contatos cadastrados nos cadastros gerais (clientes, fornecedores e demais tipos de cadastro), mostrando para cada contato o nome, a data de nascimento, os telefones, o celular e o e-mail, junto com a identificação do cadastro, o tipo de cadastro, a UF e o município. Serve às áreas comercial e de relacionamento para localizar pessoas de contato por tipo de cadastro, UF, cidade e período de nascimento. Os dados vêm do cadastro geral, dos contatos de cada cadastro, do endereço de faturamento (município) e da tabela de estados. O cabeçalho do relatório usa a filial em que o usuário está logado.
Pré-requisitos
- Contatos cadastrados com data de nascimento: o relatório WRCAD082 só traz contatos que tenham data de nascimento informada, porque a Data nascimento inicial é sempre aplicada (ver Regras de Negócio).
- Acesso ao recurso 50582: o usuário precisa ter o relatório liberado (ver Permissões e Acesso).
- Parâmetros obrigatórios na tela: Tipo cadastro, UF, Data nascimento inicial e Data nascimento final precisam estar preenchidos.
Permissões e Acesso
Recurso do WRCAD082 e acesso por perfil
O relatório WRCAD082 – Relatório de contatos é o recurso 50582 do módulo Cadastro Geral e fica no menu Cadastro Geral > Relatórios. Ao dar duplo clique no relatório na aba “Lista de Relatórios de Cadastro Geral”, a tela registra a navegação e pergunta ao sistema se o usuário pode acessá-lo. O usuário administrador sempre acessa. Para os demais, o acesso depende de o recurso estar liberado para o perfil ou para o usuário.
Relatório WRCAD082 bloqueado a todos os usuários
Quando o recurso 50582 do relatório WRCAD082 está bloqueado a todos os usuários, só o administrador consegue abrir o relatório e os demais recebem a mensagem de bloqueio descrita no Troubleshooting (T-05). O desbloqueio é feito pelo administrador do sistema.
Acesso negado ao WRCAD082
Quando o usuário não tem o recurso 50582 liberado, a tela do relatório WRCAD082 mostra o diálogo “Acesso Negado” com o texto “Você não tem permissão para acessar este recurso. <br /> Recurso acessado :WRCAD082/Acesso”. Se a negativa vier durante a emissão do relatório, a janela do relatório mostra o diálogo “Acesso Negado” com o texto “Você não tem permissão para acessar este recurso <br /> Recurso: WRCAD082/Acesso”.
Botão Download do WRCAD082
O botão Download (Ctrl + Y) da tela do relatório WRCAD082 só funciona para usuários cujo código começa com “@” (usuários de suporte). Para os demais, a tela mostra “Acesso Negado” com o texto “Você não tem permissão para acessar este recurso.”.
Fluxo Operacional
Fluxo de emissão do WRCAD082
- O usuário abre Cadastro Geral > Relatórios e dá duplo clique em “WRCAD082 – Relatório de contatos” na aba “Lista de Relatórios de Cadastro Geral” (a caixa Pesquisar ajuda a localizar o relatório pelo nome).
- A tela confere o acesso ao recurso 50582 e, com acesso, abre a aba “WRCAD082 – Relatório de contatos”.
- O usuário escolhe o Tipo cadastro e a UF, informa o período de nascimento (Data nascimento inicial e final) e, se quiser, restringe por Cidade inicial, Cidade final e Cód. situação.
- O usuário aciona Gerar PDF, Exportar Excel ou Exportar Word.
- O sistema lê os contatos que atendem aos parâmetros e entrega o relatório, ou mostra o aviso de relatório sem registros.
Fluxo de reutilização de parâmetros do WRCAD082
O usuário preenche os parâmetros, digita um apelido em Apelido para configuração e aciona Salvar configuração. Depois, na lista de configurações salvas, o duplo clique no apelido preenche de novo os parâmetros.
Interface e Comportamentos da Tela
Parâmetros do WRCAD082
A tela do relatório WRCAD082 – Relatório de contatos tem um grupo de parâmetros com o título “WRCAD082 – Relatório de contatos”.
| Parâmetro | Tipo de campo | Obrigatório | Observação |
|---|---|---|---|
| Tipo cadastro | Lista de seleção múltipla (código e nome do tipo de cadastro) | Sim | Permite escolher vários tipos; só aceita valores da lista |
| UF | Pesquisa de estados com seleção múltipla (código e nome) | Sim | Permite escolher várias UFs; só aceita valores da lista |
| Cidade inicial | Pesquisa (lookup) de município | Não | Início da faixa alfabética de cidades; vazio não limita |
| Cidade final | Pesquisa (lookup) de município | Não | Fim da faixa alfabética de cidades; vazio não limita |
| Data nascimento inicial | Data (dd/mm/aaaa) | Sim | Início do período de nascimento do contato |
| Data nascimento final | Data (dd/mm/aaaa) | Sim | Fim do período de nascimento do contato |
| Cód. situação | Lista de seleção múltipla (código e nome da situação do cadastro) | Não | Permite escolher várias situações; vazio traz todas |
Comportamentos de tela do WRCAD082
A tela do WRCAD082 não esconde nem habilita campos conforme outros campos: os campos ficam sempre visíveis, independentes entre si e sem valor padrão. Cidade inicial e Cidade final ficam lado a lado, assim como Data nascimento inicial e Data nascimento final.
Configuração de parâmetro do WRCAD082
O grupo Configuração de parâmetro da tela do relatório WRCAD082 permite guardar os valores digitados nos parâmetros para reutilizá-los depois.
| Campo | Tipo de campo | Obrigatório | Observação |
|---|---|---|---|
| Apelido para configuração | Texto | Não | Identifica a configuração salva; não pode conter espaços em branco; é obrigatório só para salvar a configuração |
| Lista de configurações salvas | Lista | Não | Mostra as configurações já salvas do WRCAD082; o duplo clique numa configuração preenche os parâmetros na tela |
O grupo exibe o texto fixo: “Para a configuração ficar salva, digite um apelido e utilize o botão “Salvar configuração” na parte superior da tela.” seguido, em outra linha, de “O apelido da configuração não pode conter espaços em branco.”.
Barra de ferramentas do WRCAD082
A barra de ferramentas da tela do relatório WRCAD082 oferece:
- Gerar PDF (Ctrl + P): emite o relatório em PDF.
- Exportar Excel (Ctrl + E): abre a janela “Opções de exportação para Excel” com “Arquivo Excel” (padrão), “Arquivo Excel – Somente dados” e “Somente dados de pasta de trabalho(.xlsx)”.
- Exportar Word (Ctrl + W): emite o relatório em Word.
- Salvar configuração (Ctrl + S) e Excluir configuração (Ctrl + Del): gravam ou apagam a configuração de parâmetros pelo apelido.
- Download (Ctrl + Y): restrito a usuários de suporte, conforme Permissões e Acesso.
- Fechar Aba (Ctrl + O).
Feedbacks ao Usuário
Feedbacks — emissão do WRCAD082
| Situação | Título | Mensagem |
|---|---|---|
| Relatório WRCAD082 sem dados para os parâmetros | Relatório não possui registros | “Nenhum registro foi encontrado, verifique se os parâmetros foram digitados corretamente.” |
| Usuário sem acesso ao recurso, ao abrir o relatório | Acesso Negado | “Você não tem permissão para acessar este recurso. <br /> Recurso acessado :WRCAD082/Acesso” |
| Usuário sem acesso ao recurso, durante a emissão | Acesso Negado | “Você não tem permissão para acessar este recurso <br /> Recurso: WRCAD082/Acesso” |
| Usuário que não é de suporte aciona Download | Acesso Negado | “Você não tem permissão para acessar este recurso.” |
| Recurso bloqueado a todos | (mensagem do sistema) | Ver T-05 |
Quando um campo obrigatório está vazio, a tela do WRCAD082 não emite o relatório e marca o campo como inválido.
Feedbacks — configuração de parâmetros do WRCAD082
| Situação | Título | Mensagem |
|---|---|---|
| Salvar sem apelido | Configuração de parâmetros | “Informe um apelido para a configuração.” |
| Configuração salva | (confirmação) | “A configuração de parâmetros foi salva com sucesso.” |
| Falha ao salvar | (aviso) | “A configuração de parâmetros não foi salva com sucesso.” ou a mensagem devolvida pelo sistema |
| Configuração excluída | CONFIGURAÇÃO DE PARÂMETROS!!! | “A configuração de parâmetros foi excluída com sucesso.” |
| Falha ao excluir | CONFIGURAÇÃO DE PARÂMETROS!!! | “A configuração de parâmetros não foi excluída com sucesso.” |
Regras de Negócio
Filtro de tipo de cadastro do WRCAD082
O relatório WRCAD082 filtra os contatos pelos tipos de cadastro escolhidos em Tipo cadastro. Na tela o campo é obrigatório; no sistema ele é opcional e, vazio, traz todos os tipos. Os cadastros que não têm tipo de cadastro informado entram no relatório mesmo quando um tipo é escolhido.
Filtro de UF do WRCAD082
O relatório WRCAD082 filtra os contatos pela UF do cadastro geral (estado do cadastro, e não o estado do endereço de faturamento), com as UFs escolhidas em UF. Na tela o campo é obrigatório; no sistema ele é opcional e, vazio, traz todas as UFs.
Filtro de cidade do WRCAD082
O relatório WRCAD082 compara a Cidade inicial e a Cidade final com o nome do município do endereço de faturamento do cadastro, em ordem alfabética: Cidade inicial traz os municípios de nome igual ou posterior e Cidade final os de nome igual ou anterior. Os dois campos são opcionais, na tela e no sistema, e vazios não limitam. Cadastros sem endereço de faturamento ou sem município ficam com a cidade em branco: eles saem do relatório quando a Cidade inicial é informada e permanecem quando só a Cidade final é informada.
Filtro de data de nascimento do WRCAD082
O relatório WRCAD082 filtra os contatos pela data de nascimento do contato, entre Data nascimento inicial e Data nascimento final, ambas inclusas. Na tela as duas datas são obrigatórias; no sistema são opcionais, e data vazia ou inválida vale 01/01/0001. A Data nascimento inicial é sempre aplicada na leitura dos dados, mesmo vazia: com isso, o contato sem data de nascimento nunca aparece no relatório, e o cadastro que não tem nenhum contato também não. A Data nascimento final só limita quando for posterior a 01/01/0001.
Filtro de situação do cadastro do WRCAD082
O relatório WRCAD082 filtra os contatos pelas situações escolhidas em Cód. situação (situação do cadastro geral). O campo é opcional, na tela e no sistema, e vazio traz todas as situações. Os cadastros sem situação informada entram no relatório mesmo quando uma situação é escolhida.
Ordenação e agrupamento do WRCAD082
O sistema entrega as linhas ordenadas pelo código do tipo de cadastro, depois pela UF (texto “código – nome” do estado do cadastro), pelo município (texto “código – nome”, portanto na ordem do código do município) e pelo nome do contato. Agrupamentos e totais do impresso ficam no layout e não podem ser afirmados a partir do código.
Contatos repetidos no WRCAD082
Quando o cadastro tem mais de um endereço de faturamento, cada contato aparece uma vez para cada endereço, porque a leitura junta contatos e endereços sem eliminar repetições.
Cabeçalho do WRCAD082
O cabeçalho do relatório WRCAD082 traz os dados da filial logada e o título “WRCAD082 – RELATÓRIO DE CONTATOS”; com o idioma diferente de português, o título é traduzido. O relatório não tem parâmetro de filial.
Relatórios e Exportações
Saída do WRCAD082
O relatório WRCAD082 – Relatório de contatos sai em PDF (Gerar PDF), em Excel nas três opções (“Arquivo Excel”, “Arquivo Excel – Somente dados” e “Somente dados de pasta de trabalho(.xlsx)”) e em Word. Cada linha entrega o tipo de cadastro (código e nome), o cadastro (código, apelido e nome), a UF (código e nome), o município (código e nome), o nome do contato, a data de nascimento do contato, o telefone com ramal, o telefone comercial com ramal, o celular e o e-mail. A data de nascimento ausente é entregue como 01/01/0001. A disposição das colunas, os agrupamentos e os totais do impresso estão apenas no arquivo de layout e não são descritos aqui.
Troubleshooting
Relatório WRCAD082 sem registros
Mensagem exibida: título “Relatório não possui registros”, texto “Nenhum registro foi encontrado, verifique se os parâmetros foram digitados corretamente.”
Cenário: nenhum contato atende aos parâmetros informados.
O que fazer: ampliar o período de nascimento, esvaziar Cidade inicial, Cidade final e Cód. situação e voltar a restringir um a um; conferir se os cadastros do tipo e da UF escolhidos têm contatos com data de nascimento preenchida.
Relatório WRCAD082 sem os contatos sem data de nascimento
Mensagem exibida: nenhuma; o relatório sai, mas sem os contatos que não têm data de nascimento.
Cenário: o relatório WRCAD082 só traz contatos com data de nascimento informada, e os cadastros sem nenhum contato também não aparecem, mesmo com o período de nascimento bem amplo.
O que fazer: preencher a data de nascimento dos contatos no cadastro geral para que eles passem a sair no relatório.
Relatório WRCAD082 sem os cadastros sem cidade
Mensagem exibida: nenhuma; o relatório sai sem os cadastros que não têm município.
Cenário: a cidade vem do endereço de faturamento do cadastro. Com a Cidade inicial informada, os cadastros sem endereço de faturamento ou sem município ficam de fora.
O que fazer: deixar Cidade inicial vazia para incluir esses cadastros, ou completar o endereço de faturamento no cadastro geral.
Contato repetido no relatório WRCAD082
Mensagem exibida: nenhuma; o mesmo contato aparece em mais de uma linha.
Cenário: o cadastro tem mais de um endereço de faturamento, e o contato é repetido para cada um.
O que fazer: conferir os endereços de faturamento do cadastro e considerar as linhas repetidas como uma só ao ler o relatório.
Relatório WRCAD082 bloqueado a todos os usuários
Mensagem exibida: Erro “Recurso : {relatório}* “, Motivo “Mensagem : Você não tem permissão para acessar este recurso”, Solução “Obs.: Este recurso está bloqueado a todos os usuários. Para desbloqueá-lo entre em contato com o administrador do sistema.”
Cenário: o recurso 50582 do WRCAD082 foi bloqueado a todos os usuários; só o administrador acessa.
O que fazer: pedir ao administrador do sistema que desbloqueie o recurso, se o uso do relatório for legítimo.
Acesso negado ao relatório WRCAD082
Mensagem exibida: título “Acesso Negado”, texto “Você não tem permissão para acessar este recurso. <br /> Recurso acessado :WRCAD082/Acesso” (ou, durante a emissão, “Você não tem permissão para acessar este recurso <br /> Recurso: WRCAD082/Acesso”).
Cenário: o perfil ou o usuário não tem o recurso 50582 liberado.
O que fazer: pedir ao administrador que libere o recurso 50582 para o perfil ou para o usuário.
Configuração do WRCAD082 não é salva por falta de apelido
Mensagem exibida: título “Configuração de parâmetros”, texto “Informe um apelido para a configuração.”
Cenário: o usuário acionou Salvar configuração com o campo Apelido para configuração vazio.
O que fazer: digitar um apelido sem espaços em branco e salvar de novo.
Configuração de parâmetros do WRCAD082 não foi salva ou excluída
Mensagem exibida: “A configuração de parâmetros não foi salva com sucesso.” ou “A configuração de parâmetros não foi excluída com sucesso.” (ou a mensagem devolvida pelo sistema).
Cenário: o sistema recusou a gravação ou a exclusão da configuração.
O que fazer: conferir o apelido (sem espaços) e repetir; persistindo, avisar o suporte com o texto exibido.
Botão Download recusado no WRCAD082
Mensagem exibida: título “Acesso Negado”, texto “Você não tem permissão para acessar este recurso.”
Cenário: o usuário não é de suporte (código de usuário não começa com “@”).
O que fazer: usar Gerar PDF, Exportar Excel ou Exportar Word; o Download é exclusivo do suporte.
Campo obrigatório vazio no WRCAD082
Mensagem exibida: nenhuma mensagem de texto; a tela não emite o relatório e marca o campo como inválido.
Cenário: Tipo cadastro, UF, Data nascimento inicial ou Data nascimento final ficaram vazios.
O que fazer: preencher os quatro campos obrigatórios e emitir de novo.
Cabeçalho do WRCAD082 mostra a filial logada
Mensagem exibida: nenhuma; o cabeçalho do relatório sai com os dados da filial em que o usuário está logado.
Cenário: o relatório WRCAD082 não tem parâmetro de filial, então o cabeçalho é sempre o da filial logada.
O que fazer: entrar no sistema na filial desejada antes de emitir, se o cabeçalho precisar de outra filial.
Casos de Uso
Caso 1 — Contatos de clientes de uma UF
O usuário abre o WRCAD082, escolhe o Tipo cadastro 1 – Cliente, a UF SP, informa Data nascimento inicial 01/01/1950 e Data nascimento final 31/12/2005 e aciona Gerar PDF. Recebe os contatos com data de nascimento nesse período, ordenados por tipo de cadastro, UF, município e nome do contato.
Caso 2 — Contatos de uma faixa de cidades
O usuário escolhe dois tipos de cadastro, as UFs PR e SC, informa Cidade inicial Curitiba e Cidade final Joinville, período de nascimento de 01/01/1940 a 31/12/2010 e emite em Excel. O relatório traz os contatos cujo município, pela ordem alfabética, está entre as duas cidades.
Caso 3 — Reutilizar a seleção
O usuário preenche os parâmetros do Caso 1, digita o apelido contatossp em Apelido para configuração e aciona Salvar configuração. Na próxima emissão, dá duplo clique em contatossp na lista de configurações salvas e os parâmetros voltam preenchidos.