CONFIG JSON — referência (Crud All Custom)

Objeto gravado na coluna CONFIG de nfs_crud_all_custom. O assistente em /admin/crud-all-custom monta a maior parte; use a aba JSON para chaves avançadas ou cópia entre ambientes.

Esqueleto mínimo (no admin: Aplicar esqueleto vazio ou template minimal via API):

{
  "ui": {
    "enabled": true,
    "mode": "cards",
    "fields_layout": "compact",
    "fields_columns": 2,
    "actions_in_header": true
  },
  "main": {
    "title": "",
    "fields": []
  },
  "children": [],
  "replicate_from_main_enabled": true,
  "replicate_field_pairs": [],
  "replicate_excluded_fields": []
}

Metadados (colunas da tabela, não dentro do JSON)

ui — apresentação

Regras no assistente (crudAllCustomUiRules.js): com mode=classic, fields_layout, fields_columns, actions_in_header, accent, promotedChildTableKeys e fundos de card não aplicam no runtime. Com fields_layout=grid, fields_columns e promotedChildTableKeys também não se aplicam.

main — tabela principal

children[] — tabelas no formulário

Cada item:

{
  "table": "OS_TECNICO",
  "title": "Técnico",
  "icon": "fa-user",
  "header_background": "#e87a6f",
  "fields": ["SEQ_DB_TECNICO", "INI_DH"]
}

Ordem do array = ordem dos cards (childTableOrder).

Filhas do DS não listadas → hidden_children (não aparecem).

promotedChildTableKeys

Tipo: string[] — nomes de tabelas filhas que, no layout cards + compact, ficam na coluna direita quando há conteúdo na principal.

Exemplo: duas filhas OS_TECNICO e EQP_APT, com promotedChildTableKeys: ["OS_TECNICO"] — após preencher a OS, OS_TECNICO tende à coluna direita e EQP_APT abaixo.

Em ui.mode=classic ou ui.fields_layout=grid, esta chave é ignorada no runtime.

Replicação

replicate_mode

Se inválido ou ausente no PHP: auto. Valor inicial no assistente ao criar registro: ask.

FILTRO_VIEW (DS) vs replicate_field_pairs

Não é necessário repetir no JSON um par que já está coberto só pelo FILTRO_VIEW, mas o par pode coexistir (o diálogo no modo ask considera os dois).

replicate_field_pairs

Lista explícita de pares main + childTable + childField:

"replicate_field_pairs": [
  { "main": "DESCRICAO", "childTable": "EQP_APT", "childField": "INI_DH_ONLINE" }
]

Somente os pares listados participam da cópia. Campos com mesmo nome não são pareados automaticamente.

replicate_field_map (retrocompat)

Objeto legado: chave = campo na principal, valor = campo na filha.

"replicate_field_map": {
  "DESCRICAO": "INI_DH_ONLINE"
}

Ao abrir no manager, esse formato é convertido para replicate_field_pairs.

replicate_field_map_scope (retrocompat)

Limita um par a filhas específicas (chave CAMPO_MAIN:CAMPO_FILHA):

"replicate_field_map_scope": {
  "DESCRICAO:INI_DH_ONLINE": ["EQP_APT"]
}

Filhas fora da lista não recebem aquele mapeamento, mesmo tendo o campo destino. No manager, o escopo é representado após conversão para pares explícitos.

replicate_excluded_fields

Lista de nomes homônimos que não devem replicar.

Outras chaves

Chaves ignoradas (aviso na validação)

• workflow
• child_relations

Não são lidas pelo runtime; a validação pode emitir aviso.

Exemplo completo (cards + duas filhas)

{
  "ui": {
    "enabled": true,
    "mode": "cards",
    "fields_layout": "compact",
    "fields_columns": 2,
    "actions_in_header": true,
    "page": { "accent": "#1ab7bc", "meta_icon": "fa-wrench" }
  },
  "main": {
    "title": "Ordem de serviço",
    "icon": "fa-wrench",
    "header_background": "#f0ad4e",
    "fields": ["DESCRICAO", "STATUS"]
  },
  "children": [
    {
      "table": "OS_TECNICO",
      "title": "Técnico",
      "icon": "fa-user",
      "header_background": "#5bc0de",
      "fields": []
    },
    {
      "table": "EQP_APT",
      "title": "Equipamento",
      "fields": ["EQP_SEQ_DB"]
    }
  ],
  "promotedChildTableKeys": ["OS_TECNICO"],
  "replicate_from_main_enabled": true,
  "replicate_mode": "ask",
  "replicate_field_pairs": [
    {
      "main": "DESCRICAO",
      "childTable": "EQP_APT",
      "childField": "INI_DH_ONLINE"
    }
  ],
  "replicate_excluded_fields": [],
  "replicate_field_map_scope": {}
}

Equivalência com Entry Point CrudAll

Conversão de nfs_entry_point (CrudAll) para CONFIG:

Validação

POST /admin/crud-all-custom/validate retorna:

Alertas abaixo do editor após Validar CONFIG. Com errors, corrija antes de usar no runtime.