Caderneta OnSong^®

O formato de ficheiro OnSong^® Binder é como o OnSong move uma canção, um conjunto ou um livro inteiro entre bibliotecas. Como o Arquivo OnSong^®, ele transporta tudo o que é necessário para reconstruir o conteúdo noutro local — o texto da canção, anexos, estilos, definições, transposição e anotações — mas enquanto um arquivo é um blob opaco único, um binder é uma pasta de ficheiros ordinários. Isso o torna legível, inspeccionável e capaz de transportar a mídia de que uma canção depende juntamente com a canção em si de forma independente da plataforma.

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

O Que Está Dentro

Um binder é um arquivo ZIP. Descompacte um e encontrará uma pasta com o nome do identificador do item, contendo:

• manifest.json — o item em si, serializado. Cada propriedade 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 da mesma forma.

Essa estrutura repete-se até ao final: um conjunto contém canções, uma canção contém anexos, e cada um é uma pasta com o seu próprio manifesto ao lado dos seus próprios ficheiros. Um binder que contém um livro de duzentas canções tem o mesmo formato que um que contém um único tema.

Dentro de um manifesto, as referências a 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.

O Que Transporta

• Canções — a pauta de acordes e tudo o que está anexado a ela.
• Conjuntos — as canções na sua ordem, com o arranjo do próprio conjunto.
• Livros — uma colecção inteira.
• Anexos — PDFs, imagens, áudio e qualquer outro ficheiro associado a uma canção. Pode optar por incluir apenas os anexos que estão realmente em uso em vez de cada versão jamais adicionada.

Binder Ou Arquivo?

Ambos fazem o round-trip do conteúdo de uma biblioteca fielmente, portanto a escolha depende do que precisa do ficheiro:

• Arquivo OnSong^® é o formato mais antigo e é o que deve utilizar para compatibilidade com versões anteriores do OnSong.
• OnSong^® Binder é o actual. Utilize-o para partilhar com versões mais recentes do OnSong — e quando pretender um ficheiro que possa abrir e examinar.

Importação E Exportação

Os binders importam-se da mesma forma que 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 todas as canções nele; importar um que contém uma única canção adiciona essa canção.

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

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

Como um binder é um ZIP de JSON simples e ficheiros de mídia ordinários, é o formato certo a escolher quando precisa de ver o que o OnSong realmente armazenou — ou quando algo precisa de ler o seu conteúdo e não é OnSong.