kanban

Kanban

Cartões em colunas por estado, movidos por arrastar.

• Kind: view
• Key: kanban
• Categoria: quadro
• 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
groupBy	string	não	-	Coluna cujos valores fazem as colunas do quadro.	coluna (nome)
swimlaneBy	string	não	-	Segundo eixo: coluna cujos valores fazem as faixas horizontais. Vazio dá o quadro clássico de um só eixo.	coluna (nome)
groupType	enumeration	não	"field"	Se as colunas saem dos valores de uma coluna (field) ou dos dias da semana (weekdays).	-
dateField	string	não	-	Coluna de data que posiciona o cartão quando o agrupamento é por dias da semana.	coluna (nome)
weekRange	enumeration	não	"both"	Semanas mostradas no agrupamento por dias da semana; custom usa customStartDate/customEndDate.	-
customStartDate	string	não	-	Início do intervalo quando weekRange é custom, em ISO-8601 (o modelo escreve toIso8601String()).	-
customEndDate	string	não	-	Fim do intervalo quando weekRange é custom, em ISO-8601.	-
collapsedGroups	list	não	[]	Grupos fechados, pelos VALORES da coluna de agrupamento: dado de utilizador, não referência. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-
groupOrder	list	não	[]	Ordem manual das colunas do quadro, pelos VALORES da coluna de agrupamento. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-
swimlaneOrder	list	não	[]	Ordem manual das faixas, pelos VALORES da coluna de swimlaneBy; vazio ordena por alfabeto. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-
hideEmptyGroups	boolean	não	false	Esconde as colunas sem cartões.	-
filterGroup	map	não	-	Grupo de filtros aplicado às linhas da vista.	-
filters	json	não	-	Descontinuado. Filtros no formato legado: nome da coluna → valor escolhido. Só lido, e só quando não há filterGroup. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-
filterTypes	json	não	-	Descontinuado. Operadores do formato legado: nome da coluna → operador. Só lido, a par de filters. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-
displayFields	list de string	não	-	Colunas desenhadas dentro do cartão.	-
predefinedFilters	list	não	-	Filtros guardados no formato legado (mapas por chave de coluna com valores escolhidos): dado de utilizador. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-
sortedColumns	list de string	não	-	Colunas por que se ordenam os cartões dentro de cada coluna do quadro, por ordem.	-
sortWithinGroups	string	não	-	Descontinuado. Nome antigo, de uma só coluna e sem sentido, do sortedColumns; ainda lido, já não escrito pela app.	coluna (nome)
sortDirections	map	não	-	Nome da coluna → sentido da ordenação.	chave: coluna (nome)
columnSize	enumeration	não	"m"	Largura das colunas do quadro; resolve-se em pixels por kanbanColumnWidthFor.	-
allowAdd	boolean	não	true	Permite acrescentar linhas.	-
allowSelection	boolean	não	true	Permite selecionar cartões.	-
showSearchButton	boolean	não	true	Mostra o botão de pesquisa.	-
showFilterButton	boolean	não	true	Mostra o botão de filtros.	-
showGroupButton	boolean	não	true	Mostra o botão de agrupamento.	-
showExportButton	boolean	não	true	Mostra o botão de exportação.	-
showCollapseButton	boolean	não	true	Mostra o botão de fechar as colunas.	-
facetPanelState	json	não	-	Estado do painel de filtros facetados, por utilizador. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-
colorConditions	list de map	não	-	Regras que pintam a linha segundo o valor de uma coluna.	-

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

colorConditions[]

Cada elemento de colorConditions é um objeto:

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
columnName	string	não	-	Coluna avaliada, POR NOME.	coluna (nome)
operator	string	não	-	Operador da comparação.	-
value	string	não	-	Valor da comparação. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-
secondValue	string	não	-	Segundo valor, nos operadores de intervalo. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-
color	integer	não	-	Cor aplicada à linha, em ARGB de 32 bits.	-

Exemplo JSON

[
  {
    "groupType": "field",
    "weekRange": "both",
    "collapsedGroups": [],
    "groupOrder": [],
    "swimlaneOrder": [],
    "hideEmptyGroups": false,
    "columnSize": "m",
    "allowAdd": true,
    "allowSelection": true,
    "showSearchButton": true,
    "showFilterButton": true,
    "showGroupButton": true,
    "showExportButton": true,
    "showCollapseButton": true
  }
]

---

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