Carpeta OnSong^®

El formato de archivo OnSong^® Binder es cómo OnSong mueve una canción, un conjunto o un libro completo entre bibliotecas. Como el Archivo OnSong^®, contiene todo lo necesario para reconstruir el contenido en otro lugar — el texto de la canción, adjuntos, estilos, configuración, transposición y anotaciones — pero mientras que un archivo es un blob opaco único, un binder es una carpeta de archivos ordinarios. Esto lo hace legible, inspeccionar y capaz de llevar los medios de los que depende una canción junto a la canción misma de una manera independiente de la plataforma.

El formato de archivo OnSong^® Binder tiene una extensión de archivo de .onsongbinder o .binder, y un tipo MIME de application/onsong-binder.

Qué hay dentro

Un binder es un archivo ZIP. Descomprímelo y encontrarás una carpeta nombrada según el identificador del elemento, conteniendo:

• manifest.json — el elemento en sí, serializado. Cada propiedad que OnSong conoce sobre él, en la misma forma que usa la API web de OnSong.
• Su archivo, si tiene uno. Un adjunto conserva su nombre de archivo original, así que un PDF o un MP3 dentro de un binder es solo ese PDF o MP3.
• Carpetas para sus elementos secundarios, nombradas según lo que son — songs, attachments — cada una con más carpetas de exactamente la misma forma.

Esa estructura se repite todo el camino hacia abajo: un conjunto contiene canciones, una canción contiene adjuntos, y cada uno es una carpeta con su propio manifiesto junto a sus propios archivos. Un binder que contiene un libro de doscientas canciones tiene el mismo formato que uno que contiene una sola hoja de acordes.

Dentro de un manifiesto, las referencias a elementos secundarios se marcan con un prefijo $binder., así que un lector puede diferenciar entre un valor que pertenece al elemento y uno que apunta a una carpeta al lado.

Lo que lleva

• Canciones — la hoja de acordes y todo lo adjunto a ella.
• Conjuntos — las canciones en su orden, con el arreglo del conjunto.
• Libros — una colección completa.
• Adjuntos — PDFs, imágenes, audio y cualquier otro archivo asociado con una canción. Puedes elegir incluir solo los adjuntos que están realmente en uso en lugar de cada versión jamás agregada.

¿Binder o Archivo?

Ambos hacen un recorrido fiel del contenido de una biblioteca, así que la elección es sobre lo que necesitas del archivo:

• Archivo OnSong^® es el formato anterior, y es lo que debes usar para compatibilidad con versiones anteriores de OnSong.
• OnSong^® Binder es el actual. Úsalo para compartir con versiones más nuevas de OnSong — y cuando quieras un archivo que puedas abrir y mirar dentro.

Importar y exportar

Los binders se importan como lo hace cualquier otro archivo: abre uno desde Archivos, Correo, AirDrop o un servicio en la nube y elige OnSong. Importar un binder que contiene un conjunto recrea el conjunto y cada canción en él; importar uno que contiene una sola canción agrega esa canción.

Para crear uno, usa Compartir y elige OnSong Binder como formato.

Los binders también son lo que OnSong Connect envía entre dispositivos cuando un dispositivo le pide a otro una canción o un conjunto, así que el mismo formato que vive en tu app Archivos es el que viaja por la red.

Porque un binder es un ZIP de JSON plano y archivos de medios ordinarios, es el formato correcto cuando necesitas ver qué almacenó realmente OnSong — o cuando algo necesita leer tu contenido y no es OnSong.