Listas (metaLists) e formulário

As listas (metaLists do Fluig) são a persistência da solução: eventos, períodos, catálogo de status e códigos de evento do RM. O formulário Processar Folha é a interface do processo de geração da folha.

As 4 listas

Cada lista tem um structure.json em lists/<nome>/. Ao publicar, o Fluig cria a tabela física ML001<listId> (MySQL; nomes case-sensitive no Linux).

Lista	listId	Tabela	Conteúdo
controle_maritimo_eventos	26	ML001026	eventos lançados no calendário
controle_maritimo_eventos_rm	—	ML001<id>	códigos de evento de folha do RM (CODIGO, DESCRICAO)
controle_maritimo_periodos	—	ML001<id>	períodos de contabilização
controle_maritimo_status	—	ML001<id>	catálogo de status (CODIGO, DESCRICAO)

Colunas de controle_maritimo_eventos

A lista principal tem 18 colunas (do structure.json):

Coluna	Tipo	Coluna	Tipo
CHAPA	TEXT	VALOR	NUMBER
DATAEVENTO	TEXT	MATRICULA	TEXT
STATUS	TEXT	DATAHORAGRAVACAO	TEXT
OBSERVACAO	TEXTAREA	HORADESEMBARQUE	TEXT
PORTO	TEXT	ALTERADOPOR	TEXT
CENTROCUSTO	TEXT	DATAHORAALTERACAO	TEXT
QTDDIASEMBARQUE	INTEGER	EXCLUIDO	INTEGER
GERARFOLHA	INTEGER	EXCLUIDOPOR	TEXT
EVENTOFOLHARM	TEXT	DATAHORAEXCLUSAO	TEXT

:::warning Instalações existentes: acrescentar as 5 colunas do item 11 (05/10/2026) ALTERADOPOR, DATAHORAALTERACAO (auditoria da alteração), EXCLUIDO, EXCLUIDOPOR e DATAHORAEXCLUSAO (exclusão lógica) foram acrescentadas à lista controle_maritimo_eventos em 05/10/2026. Numa instalação que já tem a lista, acrescente as colunas (pela administração de listas do Fluig ou pelo add-field da ferramenta de listas do projeto; colunas de lista só podem ser acrescentadas, nunca removidas) antes de publicar ds_evento_save, ds_evento_query e ds_maritimo_centro_custo_query, que passam a referenciá-las. As linhas antigas ficam com EXCLUIDO nulo, que os leitores tratam como "não excluído"; nada precisa ser migrado. :::

controle_maritimo_periodos: DATAINICIO, DATAFIM, OBSERVACAO, MATRICULA, DATAHORAGRAVACAO, ABERTO.

Publicar as listas

Publique cada lista no Fluig respeitando o listName, o listId e as colunas do structure.json (nomes e tipos idênticos — os datasets ds_*_query/ds_*_save foram gerados a partir dessas estruturas e esperam exatamente esses nomes de coluna).

:::warning Listas antes dos datasets Publique as listas antes dos datasets de consulta/escrita. Um dataset que aponta para uma lista inexistente retorna vazio ou erro. Veja a página de datasets. :::

O formulário Processar Folha

Em forms/Controle Marítimo - Processar Folha/:

• Controle Marítimo - Processar Folha.html — o formulário;
• main.js, main.css, logo.webp — recursos;
• events/displayFields.js, events/enableFields.js, events/validateForm.js — eventos do formulário Fluig.

Publique como formulário (dataset de formulário) no Fluig, preservando a estrutura de pastas events/ e os recursos. Ele é usado pelo processo processar_folha (ver Workflows e templates).

Verificação

• As 4 listas aparecem e suas tabelas ML001<id> foram criadas.
• Os datasets ds_status_query, ds_evento_rm_query, ds_periodo_query, ds_evento_query retornam (mesmo que vazio, sem erro).
• controle_maritimo_eventos tem as 18 colunas (inclusive EXCLUIDO, EXCLUIDOPOR, DATAHORAEXCLUSAO, ALTERADOPOR, DATAHORAALTERACAO).
• O formulário Processar Folha abre e seus eventos carregam.

Próximos passos

• Workflows e templates — o processo que consome o formulário.
• Datasets — publicar os datasets que leem/escrevem nessas listas.