Skip to main content

calendar

Calendário

Registos dispostos num calendário pelas suas datas.

  • Kind: view
  • Key: calendar
  • Categoria: tempo
  • 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

ChaveTipoObrigatórioOmissãoDescriçãoReferência
startDateFieldstringnão-Coluna da data de início do evento.coluna (nome)
endDateFieldstringnão-Coluna da data de fim do evento.coluna (nome)
titleFieldstringnão-Coluna do título do evento.coluna (nome)
labelFieldstringnão-Descontinuado. Nome antigo do titleField; ainda lido como recurso, já não escrito pela app.coluna (nome)
subtitleFieldstringnão-Coluna do subtítulo do evento.coluna (nome)
notesFieldstringnão-Coluna das notas do evento.coluna (nome)
defaultViewModeenumerationnão"week"Modo em que o calendário abre.-
timeScalemapnão{"endHour":18,"intervalMinutes":30,"startHour":8}Faixa de horas desenhada e o passo da grelha.-
weekStartsOnintegernão1Primeiro dia da semana, 1 = segunda-feira.-
defaultEventDurationMinutesintegernão60Duração dada a um evento novo criado por toque no calendário.-
filterGroupmapnão-Grupo de filtros aplicado às linhas da vista.-
baseFiltersjsonnão-Descontinuado. Filtros de base 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.-
baseFilterTypesjsonnão-Descontinuado. Operadores dos filtros de base no formato legado: nome da coluna → operador. Só lido, a par de baseFilters. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.-
sortRuleslist de mapnão[]Ordenação dos eventos do mesmo intervalo, por prioridade.-
searchableColumnslist de stringnão-Colunas onde a pesquisa do calendário procura.-
quickCreateFieldslist de stringnão-Colunas mostradas na criação rápida, abaixo das datas.-
disabledViewModeslist de enumerationnão[]Modos escondidos do selector. Guarda-se o conjunto DESLIGADO (e não o permitido) para um modo novo da app ficar disponível sem tocar nas configs antigas.-
allDayEventsbooleannãofalseDesenha todos os eventos na faixa de dia inteiro.-
dynamicRenderConfigjsonnão-Configuração livre do desenho dinâmico do evento.-

timeScale

ChaveTipoObrigatórioOmissãoDescriçãoReferência
startHourintegersim-Primeira hora desenhada (omissão de leitura: 8).-
endHourintegersim-Última hora desenhada (omissão de leitura: 18).-
intervalMinutesintegersim-Minutos de cada linha da grelha (omissão de leitura: 30).-

filterGroup

ChaveTipoObrigatórioOmissãoDescriçãoReferência
combinatorenumerationnão"and"Como se combinam as regras do grupo: and exige todas, or basta uma.-
ruleslist de mapnão-As regras do grupo.-
groupslist de mapnão-Subgrupos aninhados, com a mesma forma.-

filterGroup.rules[]

Cada elemento de filterGroup.rules é um objeto:

ChaveTipoObrigatórioOmissãoDescriçãoReferência
idstringnão-Identificador da regra, gerado pela app. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.-
columnNamestringnão-Coluna desta tabela, POR NOME.coluna (nome)
operatorstringnão-Operador da comparação.-
valuestringnão-Valor da comparação: dado de utilizador. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.-
secondValuestringnã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:

ChaveTipoObrigatórioOmissãoDescriçãoReferência
combinatorenumerationnão"and"Como se combinam as regras do subgrupo.-
ruleslist de mapnão-As regras do grupo.-
groupslistnã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:

ChaveTipoObrigatórioOmissãoDescriçãoReferência
idstringnão-Identificador da regra, gerado pela app. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.-
columnNamestringnão-Coluna desta tabela, POR NOME.coluna (nome)
operatorstringnão-Operador da comparação.-
valuestringnão-Valor da comparação: dado de utilizador. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.-
secondValuestringnã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.-

sortRules[]

Cada elemento de sortRules é um objeto:

ChaveTipoObrigatórioOmissãoDescriçãoReferência
columnNamestringsim-Coluna por que se ordena, POR NOME.coluna (nome)
ascendingbooleansim-Sentido da ordenação (omissão de leitura: true).-
priorityintegersim-Ordem de aplicação da regra, do menor para o maior.-

Exemplo JSON

[
{
"defaultViewMode": "week",
"timeScale": {
"endHour": 18,
"intervalMinutes": 30,
"startHour": 8
},
"weekStartsOn": 1,
"defaultEventDurationMinutes": 60,
"sortRules": [],
"disabledViewModes": [],
"allDayEvents": false
}
]

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