Capítulo 3. Detalhes do Tellico

Tipos de Campos

Cada colecção poderá ter um número ilimitado de campos. O Tellico suporta onze tipos de campos, os quais permitem gamas de dados diferentes.

Texto Simples

O tipo de campo mais básico é o Texto Simples. Não são colocadas restrições sobre os valores do campo e o item de introdução de dados é um campo de texto normal. Este tipo é apropriado para os campos que supostamente não terão dados muito extensos, como o autor ou o género.

Número

O tipo Número é idêntico ao Texto Simples, exceptuando que os dados estão restritos a serem numéricos. Os itens serão ordenados de forma numérica na área das colunas, caso seja carregada a coluna de um campo Número. O campo de edição, em conjunto com pequenas setas para aumentar ou diminuir o valor, é usado para a introdução de dados. Não é aplicada nenhuma formatação.

URL

O tipo URL permite ter referências para outros documentos, usando as associações-padrão de tipos de ficheiros do KDE para abrir os documentos referenciados. Não é feita nenhuma validação sobre o valor actual de um campo URL, mas as referências inválidas não são abertas. A introdução de dados é feita através de um campo de texto com um botão para abrir a janela normal da opção 'Ficheiro'->'Abrir', se bem que poderá usar qualquer URL. Os URLs relativos são interpretados em relação à localização do ficheiro de dados, uma vez estando esta gravada.

No Editor de Itens, a legenda torna-se a hiperligação, enquanto no Área de Itens é usada uma hiperligação de facto. Este tipo de dados é conveniente para referenciar ficheiros PDF de elementos bibliográficos ou para revisões de filmes, por exemplo. Não é aplicada nenhuma formatação.

Poderá usar também URL relativos. Estes são interpretados em relação à localização do ficheiro de dados do Tellico. No Editor de Itens, o campo de texto oferece a completação automática para as localizações de ficheiros locais. Se quiser que o URL da Janela de Selecção de Ficheiros do KDE seja interpretada em relação à localização do documento, então deverá definir a propriedade extendida do campo URL como relative : true.

Parágrafo

Para os campos de texto mais extensos, o tipo Parágrafo oferece uma área de texto mais alargada, correspondente a uma categoria própria. O campo Parágrafo não poderá ter vários valores, nem é formatado automaticamente. Não poderá ser usado para agrupamentos. Os resumos, descrições ou revisões deverão ser introduzidos com este tipo de dados.

Escolha

Quando um campo tiver de ser limitado a alguns valores predefinidos, é usado um campo de Escolha. Os valores aceitáveis são apresentados numa lista para posterior selecção. Obviamente, não são aplicáveis vários valores. Os campos como os tipos bibliográficos ou as classificações pessoais são campos do tipo Escolha.

Deverá usar pontos-e-vírgulas (;) para separar os valores permitidos.

Opção

Para os campos que aceita um valor 'sim' ou 'não', está disponível o campo Opção [de marcação]. Por omissão, o campo está desligado. Os campos Opção não são formatados e estão limitados a valores simples. Internamente, os valores dos campos são armazenados como valores true (verdadeiro) ou false (falso). Alguns exemplos são 'oferta' ou 'emprestado'.

Data

Um campo de Data poderá incluir um dia, um mês e um ano. A data é apresentada segundo o formato-padrão AAAA-MM-DD, o qual permite uma ordenação simples. A janela normal de Selecção de Datas do KDE poderá ser usada para escolher a data com o rato, assim como poderá ser introduzida directamente. O campo não é obrigatório ter o ano, o mês e o dia todos preenchidos; poderá preencher apenas o ano, por exemplo. Não são permitidos valores múltiplos.

Tabela

Os campos Tabela contêm uma ou mais colunas de valores. No Editor de Itens, o campo é apresentado com uma vista semelhante a uma folha de cálculo, com linhas numeradas. Quando for seleccionada a última linha, é adicionada uma nova. A completação automática não está disponível. Este campo é útil para uma lista de capítulos de um livro, as cenas de um filme ou as músicas de um álbum. Os campos Tabela são sempre uma categoria por si só.

O número de colunas, até um máximo de dez, é definido ao adicionar uma propriedade columns à definição do campo. As colunas poderão ser legendadas se carregar com o botão direito no cabeçalho, ou definindo uma propriedade do campo chamada column1, etc.

Ao usar o Editor de Itens para os campos Tabela, poderá reorganizar as linhas, arrastando o rato enquanto carrega na tecla Ctrl. Está disponível também um menu de contexto se carregar com o botão direito na tabela, o que permitirá introduzir ou remover linhas.

Imagem

Os campos Imagem guardam uma imagem em qualquer formato suportado pelo KDE. Alguns dos formato típicos incluem o PNG ou o JPEG. A imagem poderá ser gravada dentro do ficheiro de dados do Tellico propriamente dito ou na pasta de dados da aplicação. O Selector de Ficheiros do KDE pode ser usado tanto para um URL qualquer ou para um ficheiro local. As imagens poderão ser arrastadas a partir de um gestor de ficheiros ou um navegador.

Classificação

Os campos de Classificação mostram um número de estrelas que representam uma classificação numérica para um item. Por omissão, a classificação pode ter como máximo o valor 5. Pode contudo definir o valor mínimo e máximo se definir as propriedades minimum e maximum na definição do campo na Janela dos Campos da Colecção.

Campos de Valores Derivados

Os campos com valores derivados são um caso especial. O tipo de campo corresponde ao tipo típico do valor contido no campo, se bem que o valor do campo é construído a partir dos valores de outros campos, usando um texto de formato na descrição do campo. Por exemplo, se um campo Dependente tiver uma descrição igual a %{título} %{ano}, então o valor do campo será o título, seguido do ano. Este tipo de campo é usado, por exemplo, para o campo do título das colecções de moedas, selos, cartões e vinhos. Tanto o nome interno do campo como o seu título poderão ser usados na descrição para a formatação.

Para seleccionar apenas um único valor para um campo de múltiplos valores adicione um índice de posição ao modelo, como por exemplo %{autor:1} para o primeiro autor. A posição poderá ser negativa, onde nesse caso irá contar a partir do fim, pelo que o %{autor:-1} seria o último autor. Poderá usar valores em maiúsculas e minúsculas ao definir as opções do modelo, como por exemplo %{autor:1/l} para o primeiro autor em minúsculas e %{autor:1/u} para maiúsculas.