Tipos de campo e definições
Que tipos de campos personalizados existem, que definições tem cada tipo e que limites se aplicam
Última atualização em
Ao criar um campo, escolhe um tipo. Depois já não pode alterar o tipo. Em 2. Definições estão as opções desse tipo. Todas as opções são facultativas, salvo indicação em contrário abaixo.
Em quase todos os tipos pode também preencher uma Mensagem de erro. Esta substitui a mensagem padrão quando um valor não está correto. Com Texto de exemplo define o que aparece no campo de introdução vazio.
Texto e Texto longo
Texto é uma linha, Texto longo várias linhas.
| Definição | O que faz |
|---|---|
| Comprimento mínimo e Comprimento máximo | O número de carateres. Sem máximo, aplicam-se 1.000 carateres em Texto e 10.000 em Texto longo |
| Formato | Texto livre, Endereço de e-mail, Número de telefone, Endereço web, IBAN, Código postal, Apenas dígitos ou Padrão personalizado |
| Padrão (expressão regular) | Em Padrão personalizado. O valor inteiro tem de corresponder. O Tillor recusa padrões com repetições aninhadas ou retrorreferências e padrões com mais de 200 carateres |
Número e Montante
Montante utiliza a moeda da sua organização.
| Definição | Aplica-se a | O que faz |
|---|---|---|
| Mínimo e Máximo | Número, Montante | Limite inferior e limite superior |
| Apenas números inteiros | Número | Não são permitidas casas decimais |
| Aparência | Número, só em números inteiros | Campo de entrada ou Contador (− / +) com botões |
| Incremento | Número | O valor tem de ser o mínimo (ou 0) mais um número inteiro de passos |
| Casas decimais máximas | Número | Limita as casas decimais |
Sim / não
Um interruptor de ligar/desligar. Com Deve estar marcada, o registo só pode ser guardado com a caixa marcada. Útil para um consentimento.
Data
| Definição | O que faz |
|---|---|
| Data mais cedo e Data mais tarde | Limites fixos |
| Não no passado e Não no futuro | Comparado com hoje no fuso horário da sua organização |
| A até dias de hoje | No máximo tantos dias antes ou depois de hoje |
Escolha e Escolha múltipla
Escolhe uma lista de escolha. Escolha guarda uma opção, Escolha múltipla várias. Em Escolha múltipla define Mínimo selecionado e Máximo selecionado. Uma lista tem no máximo 200 opções.
Ligação a registo
O campo aponta para outro registo no Tillor.
| Definição | O que faz |
|---|---|
| Liga a | Cliente, Parcela, Ocupação, Contador, Tarefa, Fatura, Reserva, Relatório de pagamentos, Chamada telefónica, Pessoa de contacto, Produto, Armário de contadores, Pagamento, Documento, Etiqueta NFC ou Método de acesso |
| Vários registos | Permite mais do que um registo ligado. Pode então definir também um mínimo e um máximo |
| Aparência | Lista de escolha ou Menu suspenso (uma lista única com pesquisa) |
| Apenas os registos deste cliente | Limita as opções aos registos do cliente que está a editar. Só em Pessoa de contacto, Fatura, Reserva, Ocupação, Pagamento, Documento, Etiqueta NFC e Método de acesso |
| Apenas registos do terreno | Limita as opções aos contadores da parcela: numa ocupação, a parcela dessa ocupação, numa parcela, a própria parcela. Só em Contador. Não pode guardar um contador de outra parcela |
| Filtrar opções | TypeScript opcional que decide, para cada opção, se entra na lista, veja Filtrar opções. Em Pessoa de contacto, Produto, Armário de contadores, Pagamento, Documento, Etiqueta NFC, Método de acesso, Fatura, Reserva, Ocupação, Contador e Parcela |
Se um registo ligado for eliminado mais tarde, o campo mostra Eliminado.
Se houver pelo menos 50 registos para escolher, escreve primeiro 2 carateres para pesquisar. Se forem menos, como os contadores de uma parcela, vê-los todos logo.
Filtrar opções
Com Filtrar opções decide você mesmo que registos o campo oferece. Escreve TypeScript, tal como a fórmula de tarifa, que o Tillor executa para cada opção. Se devolver true, a opção entra na lista; caso contrário, não.
No filtro lê campos com chavetas. O menu Variável mostra o que existe, incluindo campos personalizados:
| Variável | O que é |
|---|---|
{option.…} | O registo que poderia escolher, por exemplo {option.type} ou {option.terrainId} num contador |
{occupation.…}, {terrain.…}, … | O registo que está a editar, com o nome do seu tipo, com customFields para os seus próprios campos |
Exemplo: apenas contadores de eletricidade da parcela da ocupação.
return {option.type} === "ELECTRICITY" && {option.terrainId} === {occupation.terrainId};Etiquetas próprias
O mesmo filtro também pode decidir como uma opção se chama na lista. O que devolve determina o resultado:
| O que devolve | Resultado |
|---|---|
true | A opção está na lista com o seu próprio nome |
false, null ou um texto vazio | A opção não está na lista |
| Um texto | A opção está na lista com esse texto |
{ label, group } | A opção recebe essa etiqueta e fica sob o título group. Ambos são facultativos |
Exemplo: apenas contadores da ICY e da Hydrodigit, com o tipo indicado e agrupados por fornecedor.
if (!["ICY", "TILLOR_HYDRODIGIT"].includes({option.provider})) return false;
return { label: {option.name} + " · " + {option.type}, group: {option.provider} };A etiqueta aplica-se na lista de escolha e nas etiquetas escolhidas no formulário. Nos sítios que só mostram o valor, como a página de detalhe ou uma exportação, aparece o nome próprio do registo.
Inserir exemplo por baixo do campo dá um ponto de partida. Não pode guardar um filtro que não compila; a mensagem por baixo do campo diz o que está errado.
O filtro não limita apenas a lista. Se escolher, através da API ou de um formulário antigo, um registo que o filtro exclui, o Tillor recusa guardar indicando o nome do campo. As automatizações e as importações não são verificadas, tal como podem preencher campos ocultos.
Grupo de campos
Um conjunto fixo de subcampos que estão juntos no formulário, como Cães e Outros animais em Animais.
| Definição | O que faz |
|---|---|
| Adicionar subcampo | Cada subcampo tem uma etiqueta, tipo e definições próprias. Clique em Mais para a chave, a largura e as condições. Um grupo pode ter no máximo 30 subcampos |
| Aparência | Moldura (com contorno) ou Em linha (os campos continuam no formulário) |
| Colunas | 1 a 4 |
| Largura no grupo | Quantas colunas ocupa cada subcampo |
Linhas repetidas
Uma tabela a que acrescenta linhas com Adicionar linha, por exemplo vários veículos. Define os subcampos como num grupo. Com Linhas mínimas e Máximo de linhas limita a lista. Sem máximo aplicam-se 100 linhas, e mais de 500 não é possível.
Um grupo ou linha repetida pode conter, um nível abaixo, outro grupo ou linha repetida, mas não mais do que isso.
Ficheiros
Para documentos e fotografias. Um ficheiro que carrega só pode ser aberto por quem pode ver o campo.
| Definição | O que faz |
|---|---|
| Vários arquivos | Permite mais do que um ficheiro |
| Arquivos mínimos e Arquivos máximos | Sem máximo aplicam-se 20 ficheiros, e mais de 50 não é possível |
| Tamanho máximo por arquivo (MB) | No máximo 50 MB por ficheiro, mesmo que queira um valor mais alto |
| Tipos de arquivo permitidos | Qualquer arquivo, Imagens, PDF, Documentos do Office, ou uma extensão própria como .dwg ou um tipo MIME como application/zip |
O Tillor verifica o tipo com base no conteúdo do ficheiro, e não apenas no nome.
JSON
Destinado a dados estruturados que uma ligação a outro sistema fornece. Os colegas raramente o preenchem no formulário. Com Tamanho máximo (KB) define um limite, por defeito 64 KB e no máximo 256 KB.
Definições para todos os tipos
| Definição | O que faz |
|---|---|
| Criptografar este valor | Guarda o valor cifrado. Um campo cifrado não pode ser pesquisado, filtrado nem ordenado e não está disponível como variável nas automatizações. Só para campos de nível superior, ou seja, não para subcampos. Todos os campos personalizados são de qualquer forma guardados cifrados, quer ative isto ou não |
| Apenas API | Oculta o campo em formulários e vistas de detalhe. Uma ligação preenche-o através da API. Um campo assim não pode ser obrigatório |
| Apenas API, só de leitura | Mostra o campo, mas desativado, para que os colegas vejam o valor mas não o alterem |
| Regras de validação | Compare uma data, um número ou um montante com outro campo (Antes, Em ou antes de, Após, Em ou depois de, com um deslocamento em dias, semanas ou meses), ou verifique o valor com uma expressão. No máximo 10 regras por campo |
Um limite alterado não se aplica retroativamente. Um valor que não ajusta não bloqueia a gravação do registo, mesmo que já não cumpra a nova regra.