Oficina: Tipos de arquivos, Atributos, Indexação e Consultas

Esta é uma oficina para mostrar o uso dos Atributos, Consultas, a Indexação e Tipos de arquivos personalizados. Como um exemplo, vamos construír uma base de dados para para acmpanhar a nossa biblioteca de DVDs.

Preparativos

Vamos primeiro decidir que tipo de arquivo e atributos servirão às nossas necessidades. Originalmente, planejei usar um arquivo de marcador com um vínculo à página de filmes IMdB, mas uma vez que o Haiku não tem um navegador "marcável" como o NetPositive do BeOS no momento, vim com essa: o arquivo em si será uma imagem JPEG para a capa do filme.
Com o WebPositive, o Haiku agora tem novamente um navegador usando arquivos de marcador, então poderia muito bem utilizar um arquivo de marcador ao invés de uma imagem como tipo de arquivo básico para nossos arquivos de base de dados.
Em qualquer caso, para estes arquivos adicionamos um par de atributos. Aqui temos que decidir se queremos consultá-lo mais tarde (então temos que adicioná-lo ao indexador) e sendo assim, que tipo de atributo deveria ser. Números (int, float) podem ser avaliados diferentemente de texto (</=/> versus é/contém/começa com).

Eis os atributos que gostaria de ver para meus DVDs:

• Título do filme
• Gênero
• URL para, por exemplo, IMdB
• Diretor/Elenco
• Enredo
• Minha cotação de 1 a 10
• Coordenadas em minha prateleira, por exemplo A2, B3, então encontro o DVD também na vida real :)
• Se for o caso, a quem o disco está emprestado...

Criando um tipo de arquivo personalizado

Inicie as preferências dos Tipos de arquivos e clique no botão Adicionar... abaixo da lista hierárquica na esquerda. Um pequeno diálogo abre e pode-se especificar em qual Grupo MIME seu novo tipo de arquivo residirá. Pode-se também criar um grupo completamente novo. Vamos colocá-lo dentro de "aplicativos" e definir o "Nome Interno" como DVDdb.

Agora, uma caixa de diálogo para seu novo tipo de arquivo DVDdb se abre:

Ícone

Clique duas vezes na área do ícone para abrir o Icon-O-Mático e desenhar um ícone para seu tipo de arquivo. Pode-se também arrastar e soltar um ícone da área de ícone de outro tipo de arquivo, talvez como ponto de partida para uma versão modificada.

Reconhecimento de arquivo

Pode-se adicionar sufixos como .txt, .jpg, .mp3 para reconhecer arquivos por sua extensão. Útil ao trabalhar com arquivos de sistemas sem tipagem MIME. Nós não precisamos disso para nosso exemplo.

Descrição

• Nome do tipo - Aparece, por exemplo, no menu de Atributo da janela do Rastreador e a "Espécie de" atributo de um arquivo.
• Descrição - Uma descrição um pouco mais detalhada.

Aplicativo Preferido

Este menu pop-up mostra uma lista de todos os aplicativos que podem manipular este tipo de arquivo em particular. Aqui pode-se escolher qual programa deve abrir este arquivo específico quando lhe damos duplo clique.

Atributos Extra

Here we enter all the custom attributes we decided on in our preparations. Clicking the Add… button opens a panel to enter all the data for the new attribute. You can edit an existing attribute with a double-click.

• Nome do atributo - Aparece, por exemplo, como o título da coluna na janela do Rastreador.

• Nome interno - É utilizado para indexar e consultar o atributo.

• Type - Defines the value the attribute can hold and therefore how it can be queried.
  • String for normal text
  • Boolean for binary data: 0 (false) or >=1 (true)
  • Integer for integer numbers with different ranges:
    • 8 bit: -128 to 127
    • 16 bit: -32,768 to 32,767
    • 32 bit: -2,147,483,648 to 2,147,483,647
    • 64 bit: -9,223,372,036,854,775,808 to 9,223,372,036,854,775,807
  • Float for floating-point numbers, single precision
  • Double for floating-point numbers, double precision
  • Time for time and date format

• Visible - This checkbox determines if the attribute is visible in a Tracker window at all. Since the Tracker will be the interface to our DVD database, we check it and define its appearance with:
  • Display as - Leave on "Default" if the values are to be displayed according to the attribute's "Type" (e.g. string/integer/float etc.). The other options are:
    • Checkbox - Can be used to show either one of two symbols, see Special below.
    • Duration - Shows an integer as 1/60, e.g. "90" becomes "1:30".
    • Rating - Shows a rating between 0 and 10 as star symbols.
  • Editable - Determines if the attribute shall be editable in Tracker.
  • Special - Defines the two symbols used for a checkbox display. For example, "xo" will show a "x" for all values >0 and "o" for 0.
  • Width - The default width of that attributes column in a Tracker window.
  • Alignment - The attribute can be displayed left, center, or right aligned.

Agora, insira todas as informações para nossos atributos:

Indexação

Antes de começarmos a inserir dados em nossa pequena base de dados de DVD, nós devemos adicionar certos atributos ao Indexador. Apenas atributos indexados podem utilizar Consultas rápidas do Haiku.
Então, o que iremos procurar no futuro? Nós provavelmente não perguntaremos "O que está na coordenada B4 em minha prateleira?" ou "A URL do IMdB ou o enredo do filme contém a palavra 'pope-shenooda'?".

Isso nos deixa estes atributos:

Para indexá-los, nós abrimos um Terminal e simplesmente adicionamos um atributo após o outro:

mkindex -t string DVDdb:titulo
mkindex -t string DVDdb:genero
mkindex -t string DVDdb:elenco
mkindex -t int DVDdb:avaliacao

A opção -t define o tipo de atributo, o qual é "sequência" para todos menos a avaliação, a qual é um número inteiro.

Preenchimento dos dados

Agora, tudo está definido e nós podemos começar a colocar alguns dados na nossa base.
Uma vez que nosso arquivo básico é uma imagem de capa, vamos a alguma fonte online como o IMdB, procurar por nosso primeiro filme e salvar a capa ou poster do filme em uma nova pasta onde queremos manter nossos arquivos DVDdb.

Abrindo aquela pasta vemos uma janela típica do Rastreador com uma JPEG nela. Clicando com o botão direito nela, alteramos seu tipo de arquivo para application/DVDdb com o Adicional de Tipo de Arquivo. Existe mais informação sobre isso no documento Tipos de Arquivo.

Agora, ativamos todos os nossos atributos DVDdb a partir do menu Atributos da janela do Rastreador menu of the Tracker window e rearranjamos as colunas a nosso gosto:

Ao clicar num atributo ainda vazio (ou pressionando ALT E) entramos no modo de edição e preenchemos cada atributo. Com TAB and SHIFT TAB podemos navegar entre os atributos.

No nosso exemplo, nós começamos com uma capa JPG baixada e mudamos seu tipo para applications/DVDdb. Existe outra forma elegante de produzir um arquivo para trabalhar com ele. Apenas copie um arquivo vazio de seu tipo de arquivo para /boot/home/config/settings/Tracker/Tracker New Templates e renomeie-o para DVDdb.

Clicando com o botão direito dentro da janela do Rastreador, encontraremos uma nova entrada sob Novo... além do padrão "Nova pasta".

Consultando a base de dados

Muitas horas de trabalho barulhento depois, temos um pequeno e belo banco de dados que pode ser consultado para encontrar todos os seus filmes de Christina Ricci que possuam nota 7+... :)

Pode-se atribuir uma disposição de atributo sensível para resultados de consulta de um tipo de arquivo específico.
Abra a pasta contendo seus arquivos DVDdb e arrume os atributos da forma como gostaria de ter apresentados os resultados de consulta. Copie esta disposição com Atributos | Copiar disposição.

Open /boot/home/config/settings/Tracker/DefaultQueryTemplates, create a new folder and rename it to group/filetype, replacing slashes with underscores; in our case "application_DVDdb".

Abra a nova pasta e cole dentro a disposição com Atributos | Colar disposição. Voilà: