Carpeta OnSong^®

El formato de archivo OnSong^® Binder es la forma en que 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, archivos 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, inspectable y capaz de transportar los medios de los que depende una canción junto con la canción misma de una manera agnóstica con respecto a 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 después del identificador del elemento, que contiene:

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

Esa estructura se repite todo el camino: un conjunto contiene canciones, una canción contiene archivos 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 un solo gráfico.

Dentro de un manifiesto, las referencias a elementos secundarios se marcan con un prefijo $binder., por lo que un lector puede diferenciar entre un valor que pertenece al elemento y uno que apunta a una carpeta junto a él.

Qué transporta

• Canciones — el gráfico de acordes y todo lo que se adjunta a él.
• Conjuntos — las canciones en su orden, con el arreglo propio del conjunto.
• Libros — una colección completa.
• Archivos adjuntos — PDF, imágenes, audio y cualquier otro archivo asociado con una canción. Puedes elegir incluir solo los archivos adjuntos que realmente se están utilizando en lugar de cada versión que se haya agregado.

¿Binder o Archivo?

Ambos transportan fielmente el contenido de una biblioteca, por lo que la elección se trata de lo que necesitas del archivo:

• Archivo OnSong^® es el formato más antiguo, 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 e inspeccionar.

Importar y exportar

Los binders se importan como 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 solicita a otro una canción o un conjunto, por lo que el mismo formato que vive en tu aplicación Archivos es el que viaja por la red.

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