Pular para o conteúdo principal

Filtros e busca

O card Filtros de Pesquisa define o que o calendário vai carregar. O calendário só é montado depois que você clica em Buscar.

Card de filtros: Período (Data Inicial/Final), Nome do Marítimo e Centro de Custo

Período (obrigatório)​

O Período é o único filtro obrigatório — o sistema funciona em formato de calendário e precisa de um intervalo:

  • Data Inicial e Data Final (campos de data).
  • O intervalo pode ter no máximo 2 meses.
  • Por padrão o período já vem preenchido com o último mês (mês anterior até hoje).

Se as datas estiverem incompletas/inválidas, ao buscar aparece a mensagem "Informe a data inicial e a data final do período.". Se o intervalo passar de 2 meses, aparece "O período pode ser de no máximo 2 meses.". O campo fica destacado em vermelho até a correção.

Nome do Marítimo (opcional)​

Filtra por um marítimo específico. É um campo de zoom integrado ao RM (ds_maritimo_rm): clique para abrir a busca, pesquise pelo nome e selecione. A lista mostra Chapa e Nome.

  • Não é obrigatório.
  • Pode ser combinado com o período.
  • Para remover a seleção, use o controle de limpar do próprio campo de zoom (ou o botão Limpar do formulário, que zera todos os filtros).

Centro de Custo (opcional)​

Filtra pelos marítimos vinculados a um centro de custo. Também é um campo de zoom integrado ao RM (ds_centro_custo_rm). Ao selecionar um centro de custo, a busca traz:

  • os marítimos cadastrados nesse centro de custo no RM (consulta INT3, dataset ds_maritimo_centro_custo_rm);
  • os marítimos cujo último Embarque ou Troca de Centro de Custo lançado no sistema, com data até a Data Final do período, foi nesse centro de custo (dataset ds_maritimo_centro_custo_query).

O resultado junta as duas listas, sem repetir marítimo, em ordem alfabética.

Card de filtros com o centro de custo PACIFIC ZIRCON selecionado

:::info Alteração de 05/10/2026: filtro por centro de custo O filtro por centro de custo passou a trazer também os marítimos embarcados no navio pelo sistema. Antes desta alteração, ele trazia só os marítimos cadastrados no centro de custo no RM: um tripulante embarcado no PACIFIC ZIRCON pelo Controle Marítimo, mas com outro centro de custo (ou nenhum) no cadastro do RM, não aparecia no filtro do PACIFIC ZIRCON.

  • Base na MIT041: a página 2 (regra 3) diz que o filtro retorna os marítimos associados ao centro de custo "conforme cadastro no RM". Somar o vínculo pelo sistema é uma extensão acordada em 05/10/2026 (item 10 do relatório do cliente), não prevista na MIT.
  • O cadastro do RM não muda: o sistema não atualiza o centro de custo do marítimo no RM. O Embarque e a Troca de Centro de Custo continuam gravados só no Fluig.
  • Não mudou: o campo Nome do Marítimo continua listando todos os marítimos do RM, e os filtros continuam independentes e combináveis, com o Período obrigatório.

Veja o Cenário 2-A do Roteiro de demonstração. :::

Como o sistema define o centro de custo de um marítimo:

  • Vale o Embarque ou a Troca de Centro de Custo mais recente com data até a Data Final. Se os dois forem no mesmo dia, vale o último lançado.
  • Eventos com data depois da Data Final não contam: num período que termina antes do embarque, o marítimo não aparece no centro de custo desse embarque.
  • O Desembarque não desfaz o vínculo: o marítimo de folga continua no centro de custo do último embarque, até um novo Embarque ou Troca de Centro de Custo em outro centro de custo.
  • Hotel, Curso, ASO, Geral, Férias e Afastamento não mudam o centro de custo do marítimo.
  • Quem está num centro de custo no RM e foi embarcado em outro pelo sistema aparece nos dois filtros.
  • Quem não tem Embarque nem Troca de Centro de Custo lançado e não tem centro de custo no RM continua fora do filtro.

Calendário filtrado por PACIFIC ZIRCON: Bruno Almeida, cadastrado em VINLAND no RM e embarcado no PACIFIC ZIRCON pelo sistema em 10/09, aparece junto dos marítimos do RM

Zoom de Centro de Custo: busca e seleção a partir do RM

  • Não é obrigatório.
  • Pode ser combinado com o período e com o Nome do Marítimo: com os dois, aparece só o marítimo escolhido, se ele estiver no centro de custo pelo RM ou pelo sistema.
  • Se a consulta do vínculo pelo sistema falhar, a busca mostra a mensagem de erro no calendário, como as demais consultas, em vez de listar só os marítimos do RM.

:::note Filtros combinados Os três filtros podem ser usados juntos, mas o Período é sempre obrigatório. Marítimo e Centro de Custo apenas refinam o resultado dentro do período. :::

Buscar e Limpar​

  • Buscar — valida o período e carrega o calendário com os filtros informados.
  • Limpar — zera a seleção de Marítimo e Centro de Custo, limpa a mensagem de erro do período e descarrega o calendário (volta ao estado inicial, pedindo um novo período).

Resultado possivelmente incompleto​

Quando a consulta retorna muitos registros, o sistema mostra um aviso não-bloqueante acima do calendário, indicando que o resultado pode estar truncado:

  • Muitos marítimos: "A consulta retornou o limite de marítimos; o resultado pode estar incompleto. Refine os filtros."
  • Muitos eventos: "A consulta retornou o limite de eventos; o resultado pode estar incompleto. Reduza o período."

Nesses casos, reduza o período ou adicione um filtro (marítimo ou centro de custo) para garantir que todos os dados relevantes apareçam.