Pular para o conteúdo principal

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).

ListalistIdTabelaConteúdo
controle_maritimo_eventos26ML001026eventos lançados no calendário
controle_maritimo_eventos_rmML001<id>códigos de evento de folha do RM (CODIGO, DESCRICAO)
controle_maritimo_periodosML001<id>períodos de contabilização
controle_maritimo_statusML001<id>catálogo de status (CODIGO, DESCRICAO)

Colunas de controle_maritimo_eventos

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

ColunaTipoColunaTipo
CHAPATEXTQTDDIASEMBARQUEINTEGER
DATAEVENTOTEXTGERARFOLHAINTEGER
STATUSTEXTEVENTOFOLHARMTEXT
OBSERVACAOTEXTAREAVALORNUMBER
PORTOTEXTMATRICULATEXT
CENTROCUSTOTEXTDATAHORAGRAVACAOTEXT
HORADESEMBARQUETEXT

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).
  • O formulário Processar Folha abre e seus eventos carregam.

Próximos passos