Εγχειρίδιο Χρήστη
Δεσμευτικό OnSong®
Η μορφή αρχείου OnSong® Binder είναι ο τρόπος με τον οποίο το OnSong μετακινεί ένα κομμάτι, ένα σετ ή ένα ολόκληρο βιβλίο μεταξύ βιβλιοθηκών. Όπως το OnSong® Archive, περιέχει όλα τα απαραίτητα για την ανοικοδόμηση του περιεχομένου κάπου αλλού — το κείμενο του κομματιού, τα συνημμένα, τα στυλ, τις ρυθμίσεις, τη μεταφορά και τις σημειώσεις — αλλά ενώ ένα αρχείο είναι ένα μόνο αδιαφανές blob, ένα binder είναι ένας φάκελος συνηθισμένων αρχείων. Αυτό το κάνει αναγνώσιμο, επιθεωρήσιμο και ικανό να μεταφέρει τα μέσα από τα οποία εξαρτάται ένα κομμάτι δίπλα στο ίδιο το κομμάτι με τρόπο ανεξάρτητο από την πλατφόρμα.
Η μορφή αρχείου OnSong® Binder έχει επέκταση αρχείου είτε .onsongbinder είτε .binder, και έναν τύπο MIME application/onsong-binder.
Τι περιέχει
Ένα binder είναι ένα αρχείο ZIP. Αποσυμπιέστε ένα και θα βρείτε ένα φάκελο με όνομα βάσει του αναγνωριστικού του στοιχείου, που περιέχει:
manifest.json— το ίδιο το στοιχείο, σειριοποιημένο. Κάθε ιδιότητα που γνωρίζει το OnSong, στο ίδιο σχήμα που χρησιμοποιεί το OnSong web API.- Το αρχείο του, αν έχει ένα. Ένα συνημμένο διατηρεί το αρχικό του όνομα αρχείου, επομένως ένα PDF ή ένα MP3 σε ένα binder είναι απλώς αυτό το PDF ή MP3.
- Φάκελοι για τα παιδιά του, με ονόματα ανάλογα με το τι είναι —
songs,attachments— ο καθένας περιέχει περισσότερους φακέλους ακριβώς της ίδιας μορφής.
Αυτή η δομή επαναλαμβάνεται όλη την αποστολή: ένα σετ περιέχει κομμάτια, ένα κομμάτι περιέχει συνημμένα, και το καθένα είναι ένας φάκελος με το δικό του manifest δίπλα στα δικά του αρχεία. Ένα binder που περιέχει ένα βιβλίο διακοσίων κομματιών είναι το ίδιο μορφή με ένα που περιέχει ένα μόνο chart.
Μέσα σε ένα manifest, οι αναφορές στα παιδιά σημειώνονται με πρόθεμα $binder., επομένως ένας αναγνώστης μπορεί να διακρίνει τη διαφορά μεταξύ μιας τιμής που ανήκει στο στοιχείο και μιας που δείχνει σε έναν φάκελο δίπλα του.
Τι μεταφέρει
- Κομμάτια — το chord chart και όλα τα συνημμένα του.
- Σετ — τα κομμάτια με τη σειρά τους, με τη δική της διάταξη του σετ.
- Βιβλία — ολόκληρη η συλλογή.
- Συνημμένα — PDFs, εικόνες, ήχος και οποιοδήποτε άλλο αρχείο σχετικό με ένα κομμάτι. Μπορείτε να επιλέξετε να συμπεριλάβετε μόνο τα συνημμένα που είναι πραγματικά σε χρήση αντί για κάθε έκδοση που προστέθηκε ποτέ.
Binder ή Archive;
Και τα δύο μετάφερουν το περιεχόμενο μιας βιβλιοθήκης πιστά, επομένως η επιλογή αφορά αυτό που χρειάζεστε από το αρχείο:
- OnSong® Archive είναι η παλαιότερη μορφή, και είναι αυτό που θα χρησιμοποιήσετε για συμβατότητα με παλαιότερες εκδόσεις του OnSong.
- OnSong® Binder είναι η τρέχουσα. Χρησιμοποιήστε το για κοινή χρήση με νεότερες εκδόσεις του OnSong — και όταν θέλετε ένα αρχείο που μπορείτε να ανοίξετε και να κοιτάξετε μέσα.
Εισαγωγή και εξαγωγή
Τα binders εισάγονται με τον τρόπο που γίνεται οποιοδήποτε άλλο αρχείο: ανοίξτε ένα από τα Files, Mail, AirDrop, ή μια υπηρεσία cloud και επιλέξτε OnSong. Η εισαγωγή ενός binder που περιέχει ένα σετ ξαναδημιουργεί το σετ και κάθε κομμάτι σε αυτό· η εισαγωγή ενός που περιέχει ένα μόνο κομμάτι προσθέτει αυτό το κομμάτι.
Για να δημιουργήσετε ένα, χρησιμοποιήστε Κοινή χρήση και επιλέξτε OnSong Binder ως τη μορφή.
Τα binders είναι επίσης αυτό που το OnSong Connect στέλνει μεταξύ συσκευών όταν μια συσκευή ζητά από μια άλλη ένα κομμάτι ή ένα σετ, επομένως η ίδια μορφή που ζει στην εφαρμογή Files είναι αυτή που ταξιδεύει στο δίκτυο.
Επειδή ένα binder είναι ένα ZIP απλού JSON και συνηθισμένων αρχείων μέσων, είναι η σωστή μορφή για όταν χρειάζεστε να δείτε τι αποθήκευσε πραγματικά το OnSong — ή όταν κάτι χρειάζεται να διαβάσει το περιεχόμενό σας και δεν είναι OnSong.