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
| Chave | Tipo | Obrigatório | Omissão | Descrição | Referência |
|---|---|---|---|---|---|
startDateField | string | não | - | Coluna da data de início do evento. | coluna (nome) |
endDateField | string | não | - | Coluna da data de fim do evento. | coluna (nome) |
titleField | string | não | - | Coluna do título do evento. | coluna (nome) |
labelField | string | não | - | Descontinuado. Nome antigo do titleField; ainda lido como recurso, já não escrito pela app. | coluna (nome) |
subtitleField | string | não | - | Coluna do subtítulo do evento. | coluna (nome) |
notesField | string | não | - | Coluna das notas do evento. | coluna (nome) |
defaultViewMode | enumeration | não | "week" | Modo em que o calendário abre. | - |
timeScale | map | não | {"endHour":18,"intervalMinutes":30,"startHour":8} | Faixa de horas desenhada e o passo da grelha. | - |
weekStartsOn | integer | não | 1 | Primeiro dia da semana, 1 = segunda-feira. | - |
defaultEventDurationMinutes | integer | não | 60 | Duração dada a um evento novo criado por toque no calendário. | - |
filterGroup | map | não | - | Grupo de filtros aplicado às linhas da vista. | - |
baseFilters | json | nã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. | - |
baseFilterTypes | json | nã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. | - |
sortRules | list de map | não | [] | Ordenação dos eventos do mesmo intervalo, por prioridade. | - |
searchableColumns | list de string | não | - | Colunas onde a pesquisa do calendário procura. | - |
quickCreateFields | list de string | não | - | Colunas mostradas na criação rápida, abaixo das datas. | - |
disabledViewModes | list de enumeration | nã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. | - |
allDayEvents | boolean | não | false | Desenha todos os eventos na faixa de dia inteiro. | - |
dynamicRenderConfig | json | não | - | Configuração livre do desenho dinâmico do evento. | - |
timeScale
| Chave | Tipo | Obrigatório | Omissão | Descrição | Referência |
|---|---|---|---|---|---|
startHour | integer | sim | - | Primeira hora desenhada (omissão de leitura: 8). | - |
endHour | integer | sim | - | Última hora desenhada (omissão de leitura: 18). | - |
intervalMinutes | integer | sim | - | Minutos de cada linha da grelha (omissão de leitura: 30). | - |
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. | - |
sortRules[]
Cada elemento de sortRules é um objeto:
| Chave | Tipo | Obrigatório | Omissão | Descrição | Referência |
|---|---|---|---|---|---|
columnName | string | sim | - | Coluna por que se ordena, POR NOME. | coluna (nome) |
ascending | boolean | sim | - | Sentido da ordenação (omissão de leitura: true). | - |
priority | integer | sim | - | 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.