Fichário OnSong^®

O formato de ficheiro OnSong^® Binder é a forma como o OnSong move uma música, um conjunto ou um livro inteiro entre bibliotecas. Como o OnSong^® Archive, contém tudo o necessário para reconstruir o conteúdo noutro local — o texto da música, anexos, estilos, definições, transposição e anotações — mas enquanto um arquivo é um único bloco opaco, um binder é uma pasta de ficheiros comuns. Isto torna-o legível, inspecionável e capaz de transportar a media de que uma música depende juntamente com a própria música de uma forma independente da plataforma.

O formato de ficheiro OnSong^® Binder tem uma extensão de ficheiro de .onsongbinder ou .binder, e um tipo MIME de application/onsong-binder.

O Que Está Dentro

Um binder é um arquivo ZIP. Descomprima um e encontrará uma pasta nomeada após o identificador do item, contendo:

• manifest.json — o próprio item, serializado. Todas as propriedades que o OnSong conhece sobre ele, na mesma forma que a API web do OnSong utiliza.
• O seu ficheiro, se tiver um. Um anexo mantém o seu nome de ficheiro original, portanto um PDF ou um MP3 dentro de um binder é apenas esse PDF ou MP3.
• Pastas para os seus filhos, nomeadas de acordo com o que são — songs, attachments — cada uma contendo mais pastas exatamente da mesma forma.

Essa estrutura repete-se até ao fim: um conjunto contém músicas, uma música contém anexos, e cada um é uma pasta com seu próprio manifesto ao lado dos seus próprios ficheiros. Um binder contendo um livro de duzentas músicas está no mesmo formato que um que contém um único gráfico.

Dentro de um manifesto, as referências aos filhos são marcadas com um prefixo $binder., para que um leitor possa distinguir entre um valor que pertence ao item e um que aponta para uma pasta ao lado dele.

O Que Transporta

• Músicas — o gráfico de acordes e tudo o que está anexado a ele.
• Conjuntos — as músicas na sua ordem, com o arranjo do próprio conjunto.
• Livros — uma coleção inteira.
• Anexos — PDFs, imagens, áudio e qualquer outro ficheiro associado a uma música. Pode escolher incluir apenas os anexos que estão realmente em uso, em vez de todas as versões já adicionadas.

Binder Ou Arquivo?

Ambos replicam o conteúdo de uma biblioteca fielmente, portanto a escolha é sobre o que precisa do ficheiro:

• OnSong^® Archive é o formato mais antigo e é o que usar para compatibilidade com versões anteriores do OnSong.
• OnSong^® Binder é o atual. Use-o para partilhar com versões mais recentes do OnSong — e quando deseja um ficheiro que possa abrir e examinar.

Importar E Exportar

Os binders importam como qualquer outro ficheiro: abra um de Ficheiros, Mail, AirDrop ou um serviço na nuvem e escolha OnSong. Importar um binder que contém um conjunto recria o conjunto e cada música nele; importar um que contém uma única música adiciona essa música.

Para criar um, use Partilhar e escolha OnSong Binder como o formato.

Os binders são também o que OnSong Connect envia entre dispositivos quando um dispositivo pede a outro uma música ou um conjunto, portanto o mesmo formato que vive na sua aplicação Ficheiros é o que viaja pela rede.

Como um binder é um ZIP de JSON simples e ficheiros media comuns, é o formato correto a escolher quando precisa ver o que o OnSong realmente armazenou — ou quando algo precisa ler o seu conteúdo e não é OnSong.