A tela de Setor, no módulo de Gestão de Documentos, é onde o usuário cadastra e mantém a lista de setores da empresa que serão usados para classificar os documentos do processo de gestão da qualidade. Ela não trata documentos diretamente: parametriza um dos atributos usados mais tarde pela Criação de Documento, que consulta os setores cadastrados aqui através de uma seleção (lookup) para vincular cada documento ao setor responsável. Sem um setor cadastrado e ativo, a tela de Criação de Documento não tem o que oferecer nesse campo.

Não há cadastro obrigatório anterior para criar um setor: Nome, Sigla e Situação são informados livremente pelo próprio usuário no formulário, sem vínculo com empresa, local, turno ou qualquer outro cadastro. O único pré-requisito é de permissão: o usuário precisa ter o perfil de acesso adequado (ver Permissões e Perfis de Acesso) para abrir a listagem, cadastrar ou editar um setor.

Para que um setor apareça como opção na seleção (lookup) da tela de Criação de Documento, ele precisa estar com a Situação Ativo — o lookup padrão dessa integração não traz setores Inativos (ver Regras de Negócio).

A tela de Setor é controlada por permissões de papel, uma para cada operação: abrir a listagem exige o perfil de permissão de listar setores; abrir o formulário de novo cadastro e gravá-lo exige o perfil de permissão de cadastrar setores; abrir o formulário de edição de um setor existente e gravar a alteração exige o perfil de permissão de editar setores.

A listagem de setores também não é filtrada por empresa, local ou grupo: todos os setores cadastrados no sistema aparecem para qualquer usuário com permissão de listar, independentemente da empresa à qual o usuário está vinculado.

Perfil fiscal: não tem acesso à tela, ou seja, não pode adicionar novo, editar e nem excluir.

1. O usuário acessa Gestão de Documentos > Setor no menu do portal e abre a listagem de setores.
2. Opcionalmente, ajusta o filtro de Situação (por padrão, já vem com “Ativo” marcado) e confirma no botão Filtrar, ou digita um termo na busca textual da grid.
3. Para cadastrar, clica em Novo; para editar, seleciona um registro na grid e clica em Editar, ou dá duplo clique diretamente na linha.
4. No formulário, preenche ou altera Nome, Sigla e Situação e clica em Salvar — ou clica em Cancelar para desistir sem gravar.
5. Ao salvar com sucesso, o portal retorna para a listagem de setores com o filtro de Situação anterior preservado.

Grid de listagem de setores

A grid de setores exibe 30 registros por página, com ordenação inicial pela coluna Id em ordem decrescente. As colunas exibidas são Id, Nome (descrição), Sigla e Situação; a coluna Situação mostra o texto “Ativo” ou “Inativo” conforme a situação gravada do setor.

O botão Novo da listagem leva direto para o formulário de cadastro de um novo setor. O botão Editar exige que ao menos um registro esteja selecionado na grid. Se mais de um registro estiver selecionado, o botão Editar considera apenas o primeiro registro selecionado — os demais são ignorados silenciosamente, sem aviso ao usuário. Um duplo clique em qualquer linha da grid abre diretamente o formulário de edição daquele registro.

Filtro de Situação na listagem de setores

O painel de filtros da listagem de setores tem apenas o campo Situação, de múltipla escolha entre Ativo e Inativo; ao abrir a tela, a opção “Ativo” já vem pré-selecionada. O filtro começa recolhido e só é aplicado à grid quando o usuário confirma no botão Filtrar.

Ao sair da tela de edição de um setor, salvando ou cancelando, e retornar para a listagem, o portal recupera automaticamente o último valor de filtro de Situação aplicado antes de sair, sem exigir que o usuário refiltre.

Busca textual na listagem de setores

A caixa de busca por texto da grid, padrão de toda listagem deste portal, só dispara a pesquisa automaticamente a partir de 3 caracteres digitados; com menos que isso, a busca só ocorre se o campo for esvaziado ou se o usuário pressionar Enter.

Formulário de cadastro e edição de setor

O formulário de setor exige o preenchimento de Nome (até 100 caracteres), Sigla (até 10 caracteres) e Situação. O preenchimento é validado antes de salvar; se algum campo obrigatório estiver inválido, o salvamento é interrompido e nada é gravado.

Quando é um cadastro novo, o campo Situação já vem marcado como Ativo; quando é edição, o campo vem com a situação atualmente gravada do registro.

O botão Cancelar volta para a listagem imediatamente, sem confirmar e sem gravar nada.

Situação do setor

A situação de um setor tem apenas dois valores possíveis: Ativo e Inativo.

Normalização de Nome e Sigla do setor ao gravar

Tanto no cadastro quanto na edição de um setor, o Nome e a Sigla são gravados sem espaços nas extremidades, mesmo que o usuário digite com espaços a mais.

Regra de comparação da busca textual da listagem de setores

Na busca textual da listagem de setores, o texto digitado é comparado, sem diferenciar maiúsculas de minúsculas, contra a Descrição e a Sigla do setor. Se o texto digitado for um número, ele também é comparado contra o Id do setor.

Regra de filtro por situação na listagem de setores

Quando a tela envia uma lista de situações no filtro, a listagem de setores retorna somente os registros cuja situação esteja nessa lista. Sem esse filtro, todos os setores aparecem, tanto Ativos quanto Inativos.

Ordenação e paginação da listagem de setores

A listagem de setores ordena pela coluna solicitada: a 1ª coluna corresponde a Id, a 2ª a Descrição, a 3ª a Sigla e a 4ª a Situação (pelo texto exibido). A direção “desc” ordena de forma decrescente; qualquer outro valor ordena de forma crescente. Se a coluna informada não corresponder a nenhuma dessas quatro posições, a ordenação cai para Id em ordem crescente.

Listagem de setores em lookup (seleção por outras telas)

Na listagem de setores usada para seleção (lookup) por outra tela do sistema — a Criação de Documento —, por padrão só aparecem setores com situação Ativo. A tela solicitante pode pedir para “apresentar todos”, o que inclui também os Inativos. Quando informada, a busca textual desse lookup compara o texto, sem diferenciar maiúsculas de minúsculas, apenas contra o Nome do setor — não contra a Sigla nem contra o Id, diferente da busca da listagem principal.

A listagem de lookup ordena pela coluna solicitada: a 1ª posição corresponde a Id e a 2ª a Nome, com a mesma regra de direção da listagem principal (desc = decrescente, qualquer outro valor = crescente). Se a coluna não corresponder a nenhuma das duas, a ordenação cai para Nome em ordem crescente.

Consulta de sigla de setor

Consultar a sigla de um setor a partir de outra tela devolve apenas o Id e a Sigla do setor, nenhum outro dado. Se o setor consultado não existir, o servidor responde “não encontrado”.