Pasta OnSong^®

O formato de ficheiro OnSong^® Binder é a forma como o OnSong move uma canção, um conjunto ou um livro inteiro entre bibliotecas. Como o OnSong^® Archive, 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 único blob opaco, um binder é uma pasta de ficheiros comuns. Isto torna-o legível, inspecionável e capaz de transportar a mídia de que uma canção depende juntamente com a própria canção de forma agnóstica 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. Descompacte um e encontrará uma pasta com o nome do 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 nome de ficheiro original, portanto um PDF ou um MP3 dentro de um binder é simplesmente esse PDF ou MP3.
• Pastas para os seus filhos, com nomes de acordo com o que são — songs, attachments — cada uma contendo mais pastas exatamente da mesma forma.

Essa estrutura repete-se até ao final: um conjunto contém canções, uma canção contém anexos, e cada uma é 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 gráfico.

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

O Que Transporta

• Canções — o gráfico de acordes e tudo o que está anexado a ele.
• Conjuntos — as canções na sua ordem, com o próprio arranjo do conjunto.
• Livros — uma coleçã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 que foi adicionada.

Binder Ou Archive?

Ambos fazem uma viagem de ida e volta do conteúdo da biblioteca fielmente, portanto a escolha é sobre o que precisa do ficheiro:

• OnSong^® Archive é o formato mais antigo, e é o que deve utilizar para compatibilidade com versões anteriores do OnSong.
• OnSong^® Binder é o atual. Utilize-o para partilhar com versões mais recentes do OnSong — e quando deseja um ficheiro que possa abrir e ver dentro.

Importação E Exportação

Os binders importam da mesma forma que qualquer outro ficheiro: abra um a partir de Ficheiros, Mail, AirDrop ou um serviço em nuvem e escolha OnSong. Importar um binder que contém um conjunto recria o conjunto e cada canção nele; importar um que contém uma única canção adiciona essa canção.

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

Os binders são também o que o 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 comuns, é o formato certo a escolher quando precisa de ver o que o OnSong realmente armazenou — ou quando algo necessita de ler o seu conteúdo e não é o OnSong.