Reliure OnSong^®

Le format de fichier OnSong^® Binder est la façon dont OnSong déplace une chanson, une série ou un livre entier entre les bibliothèques. Comme OnSong^® Archive, il contient tout ce qui est nécessaire pour reconstruire le contenu ailleurs — le texte de la chanson, les pièces jointes, les styles, les paramètres, la transposition et les annotations — mais alors qu'une archive est un seul blob opaque, un binder est un dossier de fichiers ordinaires. Cela le rend lisible, inspectable et capable de transporter les médias sur lesquels une chanson dépend aux côtés de la chanson elle-même d'une manière agnostique à la plateforme.

Le format de fichier OnSong^® Binder a une extension de fichier .onsongbinder ou .binder, et un type MIME de application/onsong-binder.

À l'intérieur

Un binder est une archive ZIP. Dézippez-en une et vous trouverez un dossier nommé d'après l'identifiant de l'élément, contenant :

• manifest.json — l'élément lui-même, sérialisé. Chaque propriété que OnSong connaît à ce sujet, dans la même forme que l'API web OnSong utilise.
• Son fichier, s'il en a un. Une pièce jointe conserve son nom de fichier d'origine, donc un PDF ou un MP3 à l'intérieur d'un binder est juste ce PDF ou MP3.
• Des dossiers pour ses enfants, nommés d'après ce qu'ils sont — songs, attachments — chacun contenant d'autres dossiers exactement de la même forme.

Cette structure se répète tout du long : une série contient des chansons, une chanson contient des pièces jointes, et chacune est un dossier avec son propre manifest à côté de ses propres fichiers. Un binder contenant un livre de deux cents chansons a le même format qu'un binder contenant un seul chart.

À l'intérieur d'un manifest, les références aux enfants sont marquées avec un préfixe $binder., afin qu'un lecteur puisse faire la différence entre une valeur qui appartient à l'élément et une qui pointe vers un dossier à côté.

Ce qu'il contient

• Chansons — le chord chart et tout ce qui y est attaché.
• Séries — les chansons dans leur ordre, avec l'arrangement propre de la série.
• Livres — une collection entière.
• Pièces jointes — des PDF, des images, de l'audio et tout autre fichier associé à une chanson. Vous pouvez choisir d'inclure uniquement les pièces jointes réellement utilisées plutôt que chaque version jamais ajoutée.

Binder ou Archive ?

Les deux font un aller-retour du contenu d'une bibliothèque fidèlement, donc le choix concerne ce dont vous avez besoin du fichier :

• OnSong^® Archive est le format plus ancien, et c'est celui à utiliser pour la compatibilité avec les versions antérieures de OnSong.
• OnSong^® Binder est celui actuel. Utilisez-le pour partager avec les versions plus récentes de OnSong — et quand vous voulez un fichier que vous pouvez ouvrir et regarder à l'intérieur.

Importation et exportation

Les binders s'importent comme tout autre fichier : ouvrez-en un à partir de Fichiers, Mail, AirDrop, ou un service cloud et choisissez OnSong. L'importation d'un binder contenant une série recrée la série et chaque chanson en elle ; l'importation d'un contenant une seule chanson ajoute cette chanson.

Pour en créer un, utilisez Partager et choisissez OnSong Binder comme format.

Les binders sont aussi ce que OnSong Connect envoie entre les appareils quand un appareil demande à un autre une chanson ou une série, donc le même format qui vit dans votre app Fichiers est celui qui voyage sur le réseau.

Parce qu'un binder est un ZIP de JSON simple et de fichiers médias ordinaires, c'est le bon format à utiliser quand vous devez voir ce que OnSong a réellement stocké — ou quand quelque chose d'autre a besoin de lire votre contenu et ce n'est pas OnSong.