Classeur OnSong^®

Le format de fichier OnSong^® Binder est la façon dont OnSong transfère une chanson, un set ou un livre entier entre les bibliothèques. Comme l'Archive OnSong^®, 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 là où une archive est un seul blob opaque, un classeur est un dossier de fichiers ordinaires. Cela le rend lisible, inspectable et capable de transporter les médias dont dépend une chanson aux côtés de la chanson elle-même de manière indépendante de la plateforme.

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

Contenu

Un classeur est une archive ZIP. Décompressez-le 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, sous 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 original, donc un PDF ou un MP3 dans un classeur est simplement ce PDF ou MP3.
• Dossiers pour ses enfants, nommés d'après ce qu'ils sont — songs, attachments — contenant chacun d'autres dossiers exactement de la même forme.

Cette structure se répète jusqu'au bout : un set contient des chansons, une chanson contient des pièces jointes, et chacun est un dossier avec son propre manifeste à côté de ses propres fichiers. Un classeur contenant un livre de deux cents chansons a le même format qu'un contenant un seul arrangement.

Dans un manifeste, 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é de lui.

Ce qu'il contient

• Chansons — l'arrangement d'accords et tout ce qui y est attaché.
• Sets — les chansons dans leur ordre, avec l'arrangement propre du set.
• Livres — une collection entière.
• Pièces jointes — PDFs, images, 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.

Classeur ou Archive ?

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

• Archive OnSong^® est le format plus ancien et est ce qu'il faut utiliser pour la compatibilité avec les versions antérieures de OnSong.
• OnSong^® Binder est le format actuel. Utilisez-le pour partager avec les versions plus récentes de OnSong — et lorsque vous voulez un fichier que vous pouvez ouvrir et consulter.

Importation et exportation

Les classeurs s'importent comme n'importe quel autre fichier : ouvrez-en un à partir de Fichiers, Mail, AirDrop ou un service cloud et choisissez OnSong. L'importation d'un classeur contenant un set recrée le set et chaque chanson qu'il contient ; 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 classeurs sont aussi ce que OnSong Connect envoie entre les appareils lorsqu'un appareil demande à un autre une chanson ou un set, donc le même format qui réside dans votre app Fichiers est celui qui voyage sur le réseau.

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