document

Documentos

Explorador de ficheiros sobre uma feature: árvore de agrupamento à esquerda, pré-visualização, e encaminhamento do upload para uma automação.

• Kind: view
• Key: document
• Categoria: ficheiros
• Envelope: lista de um só elemento (a config vive em config[0])

Envelope de um só elemento

View.config é uma lista com um único elemento: a configuração vive em config[0], não em config. Uma config escrita como mapa cru é lida de qualquer maneira, mas entra nos relatórios como desvio de envelope.

Campos

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
documentColumnId	uuid	não	-	Coluna de ficheiro que a vista explora. Sem ela a vista não tem nada para mostrar.	coluna (uuid)
displayMode	enumeration	não	"list"	Como os ficheiros se arrumam: lista, grelha ou largura inteira.	-
itemsPerRow	integer	não	3	Quantos ficheiros por linha no modo de grelha.	-
showFileSize	boolean	não	true	Mostra o tamanho do ficheiro.	-
showUploadDate	boolean	não	true	Mostra a data do carregamento.	-
showUploadedBy	boolean	não	false	Mostra quem carregou o ficheiro.	-
enablePreview	boolean	não	true	Deixa pré-visualizar o ficheiro sem o descarregar.	-
enableDownload	boolean	não	true	Deixa descarregar o ficheiro.	-
enableDelete	boolean	não	false	Deixa apagar o ficheiro.	-
sortBy	enumeration	não	"date"	Por que atributo do ficheiro se ordena.	-
sortAscending	boolean	não	false	Ordem crescente; por omissão mostra os mais recentes primeiro.	-
filterGroup	map	não	-	Grupo de filtros aplicado às linhas da vista.	-
filters	json	não	-	Descontinuado. Filtro de base no formato legado: nome da coluna → valor escolhido (operador equals). Só lido, e só quando não há filterGroup. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-
allowedExtensions	list de string	não	[]	Extensões admitidas no carregamento; vazio = todas. Valores, não referências.	-
titleColumnId	uuid	não	-	Coluna que dá o título do cartão.	coluna (uuid)
subtitleColumnId	uuid	não	-	Coluna que dá o subtítulo do cartão.	coluna (uuid)
additionalColumnIds	list de string	não	[]	Colunas extra mostradas no cabeçalho de cada ficheiro.	-
groupingColumnIds	list de string	não	[]	Até três colunas que formam a árvore da esquerda, por ordem; vazio = descoberta automática.	-
groupingColumnId	uuid	não	-	Descontinuado. Nome antigo, de uma só coluna, do groupingColumnIds; ainda lido, já não escrito pela app.	coluna (uuid)
aiWorkflowId	uuid	não	-	Automação da primeira geração (com uma ação de ingestão por IA) que os botões "Processar com AI" correm; nula esconde-os.	workflow (uuid)
workflowV2Id	uuid	não	-	Automação WorkflowV2 para onde o carregamento encaminha os ficheiros (gatilho file.upload); nula = só a linha nova.	workflow V2 (uuid)
uploadPathColumnId	uuid	não	-	Coluna de texto onde o carregamento carimba o caminho do ficheiro. É a chave que deixa a automação PREENCHER a linha criada pelo upload em vez de criar uma segunda.	coluna (uuid)

filterGroup

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
combinator	enumeration	não	"and"	Como se combinam as regras do grupo: and exige todas, or basta uma.	-
rules	list de map	não	-	As regras do grupo.	-
groups	list de map	não	-	Subgrupos aninhados, com a mesma forma.	-

filterGroup.rules[]

Cada elemento de filterGroup.rules é um objeto:

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
id	string	não	-	Identificador da regra, gerado pela app. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-
columnName	string	não	-	Coluna desta tabela, POR NOME.	coluna (nome)
operator	string	não	-	Operador da comparação.	-
value	string	não	-	Valor da comparação: dado de utilizador. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-
secondValue	string	não	-	Segundo valor, usado pelos operadores de intervalo. Só aparece no JSON quando não é nulo. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-

filterGroup.groups[]

Cada elemento de filterGroup.groups é um objeto:

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
combinator	enumeration	não	"and"	Como se combinam as regras do subgrupo.	-
rules	list de map	não	-	As regras do grupo.	-
groups	list	não	-	Subgrupos de terceiro nível: varrem-se às cegas (uma FieldDecl const não se pode referir a si própria).	-

filterGroup.groups[].rules[]

Cada elemento de filterGroup.groups[].rules é um objeto:

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
id	string	não	-	Identificador da regra, gerado pela app. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-
columnName	string	não	-	Coluna desta tabela, POR NOME.	coluna (nome)
operator	string	não	-	Operador da comparação.	-
value	string	não	-	Valor da comparação: dado de utilizador. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-
secondValue	string	não	-	Segundo valor, usado pelos operadores de intervalo. Só aparece no JSON quando não é nulo. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-

Exemplo JSON

[
  {
    "displayMode": "list",
    "itemsPerRow": 3,
    "showFileSize": true,
    "showUploadDate": true,
    "showUploadedBy": false,
    "enablePreview": true,
    "enableDownload": true,
    "enableDelete": false,
    "sortBy": "date",
    "sortAscending": false,
    "allowedExtensions": [],
    "additionalColumnIds": [],
    "groupingColumnIds": []
  }
]

---

Gerado de definitions.json versão 17f3e0bc59d9. Esta página nasce no build: não se edita à mão.