Classeur OnSong^®

Le format de fichier OnSong^® Binder est la façon dont OnSong déplace une chanson, un set ou un livre entier entre les bibliothèques. Comme l'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 blob opaque unique, un binder est un dossier de fichiers ordinaires. Cela le rend lisible, inspectable et capable de transporter les médias dont une chanson dépend 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 binder est une archive ZIP. Décompressez-en un 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é qu'OnSong connaît à son 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 dans un binder est simplement ce PDF ou ce MP3.
• Des dossiers pour ses enfants, nommés d'après ce qu'ils sont — songs, attachments — chacun contenant d'autres dossiers de la même forme.

Cette structure se répète tout du long : 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 binder contenant un livre de deux cents chansons utilise le même format qu'un contenant un seul morceau.

À l'intérieur d'un manifeste, les références aux enfants sont marquées avec un préfixe $binder., de sorte qu'un lecteur peut faire la différence entre une valeur qui appartient à l'élément et une qui pointe dans un dossier à côté de celui-ci.

Ce qu'il contient

• Chansons — le diagramme d'accords et tout ce qui y est attaché.
• Sets — les chansons dans leur ordre, avec l'arrangement du set.
• Livres — une collection complète.
• 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.

Binder ou Archive ?

Les deux recréent fidèlement le contenu d'une bibliothèque, le choix dépend donc de ce que 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 d'OnSong.
• OnSong^® Binder est le format actuel. Utilisez-le pour partager avec les versions plus récentes d'OnSong — et quand vous voulez un fichier que vous pouvez ouvrir et examiner.

Importation et exportation

Les binders s'importent comme n'importe quel autre fichier : ouvrez-en un depuis Fichiers, Mail, AirDrop ou un service cloud et choisissez OnSong. L'importation d'un binder 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 binders sont également ce que OnSong Connect envoie entre appareils quand un appareil demande à un autre une chanson ou un set, donc le même format qui se trouve dans votre app Fichiers est celui qui voyage sur le réseau.

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