Mit FinaleScript arbeiten

Noteman sagt: Wenn Sie eine neue Version von Finale auf Ihrem Computer installieren, werden FinaleScript -Skripte und -Optionen nicht aus der alten Finale-Version übernommen. Um diese Dateien in Ihr neues Finale zu migrieren, lesen Sie bitte Wie Sie Einstellungen und Zubehördateien aus einer Finale-Version in eine andere migrieren.

Viele Befehle in FinaleScript beziehen sich auf globale Einstellungen, die in den FinaleScript-Optionen vorgenommen wurden. Bevor Sie also ein Skript ablaufen lassen, müssen Sie sicherstellen, dass die FinaleScript-Optionen so eingestellt sind, dass das Skript Ihren Wünschen entsprechend ausgeführt wird.

1. Wählen Sie Plug-ins > FinaleScript > Optionen. Die Dialogbox FinaleScript-Optionen öffnet sich.

   Wenn Sie sich schon in der FinaleScript-Palette befinden, klicken Sie die Taste Optionen .

2. Wählen Sie die Optionen an oder ab.
3. Klicken Sie OK.

1. Wählen Sie Plug-ins > FinaleScript > FinaleScript- Palette. Die FinaleScript-Palette öffnet sich.
2. Wählen Sie das Skript, das Sie ausführen wollen.
3. Wählen Sie die Art, auf die Sie das Skript ausführen wollen:
   • Wenn Sie ein Skript ausführen wollen, ohne es vorher anzusehen oder zu bearbeiten, klicken Sie die Taste Spielen oder CTRL-klicken Sie das Skript und wählen Sie Ausführen.
   • Wenn Sie das Skript ansehen oder bearbeiten wollen, bevor Sie es ausführen, klicken Sie die Bearbeiten-Taste (oder doppelklicken Sie das Skript). Die Dialogbox FinaleScript-Editor öffnet sich. Führen Sie alle notwendigen Anpassungen durch und klicken Sie dann Skript ausführen.

   Das Skript wird ausgeführt. Kommentare zu jeder Befehlszeile erscheinen in der FinaleScript-Palette.

4. Wenn Sie ein Skript abbrechen möchten, bevor es fertig ist, klicken Sie die Taste Stopp.

Jedesmal wenn Sie ein Skript ausführen, erstellt FinaleScript einen Bericht, in dem aufgelistet wird, ob die Befehle korrekt ausgeführt werden konnten, oder nicht, und außerdem wird aufgelistet, welche Ordner und Unterordner geöffnet wurden.

1. Klicken Sie die Bericht-Taste in der FinaleScript-Palette. Die Dialogbox FinaleScript - Bericht öffnet sich.
2. Wenn Sie den Bericht an anderer Stelle verwenden möchten, klicken Sie In die Zwischenablage kopieren.

   Gehen Sie zu Ihrem Textbearbeitungsprogramm, wählen Sie Bearbeiten > Einfügen (oder tippen Sie Befehlstaste+V).

3. Klicken Sie Schließen.

Bevor Sie ein neues Skript erzeugen, empfehlen wir Ihnen unbedingt, unten die Abschnitte FinaleScript-Struktur und FinaleScript-Befehle-Referenz anzusehen.

Sie können natürlich auch ein existierendes Skript duplizieren und verändern. Um dies zu tun, wählen Sie das Skript aus der Palette FinaleScript und klicken Sie die Taste Skript duplizieren oder CTRL-klicken Sie das Skript und wählen Sie Duplizieren).

1. Wählen Sie Plug-ins > FinaleScript > FinaleScript Palette. Die FinaleScript-Palette öffnet sich.
2. Wenn Sie möchten, dass das Skript in einen bestimmten Ordner geschoben wird, wählen Sie diesen Ordner aus. Ansonsten wird das Skript in den Hauptordner platziert.
3. Klicken Sie die Taste Neues Script (oder CTRL-klicken Sie ins Fenster mit der Skriptliste und wählen Sie Neues Script einfügen). Ein neues Skript mit dem Titel Unbenanntes Script erscheint in dem Ordner, den Sie ausgewählt haben, oder, wenn Sie keinen ausgewählt haben, erscheint es ganz oben in der Liste der FinaleScripte.

Noteman sagt: Bevor Sie ein neues Script erzeugen, empfehlen wir Ihnen unbedingt, unten die Abschnitte FinaleScript-Struktur und FinaleScript-Befehle-Referenz anzusehen.

Sie können natürlich auch ein existierendes Script duplizieren und verändern. Um dies zu tun, wählen Sie das Script aus der Palette FinaleScript und klicken Sie die Taste Script duplizieren oder CTRL-klicken Sie das Skript und wählen Sie Duplizieren).

1. Wählen Sie Plug-ins > FinaleScript > FinaleScript Palette. Die FinaleScript-Palette öffnet sich.
2. Wählen Sie das Skript, dass Sie bearbeiten wollen und klicken Sie die Taste Bearbeiten (oder doppelklicken Sie das Skript). Die Dialogbox FinaleScript-Editor erscheint.

   Sie können das Skript auch CTRL-klicken und dann Bearbeiten klicken.

3. Nehmen Sie alle notwendigen Bearbeitungsschritte vor.
   • Tippen Sie Befehle in das Bearbeitungsfenster. Während Sie tippen, färbt FinaleScript den Text entsprechend eines automatisierten Farbschemas, um die Funktion des Scripttextes anzuzeigen.
     Über das automatisierte Farbschema

     FinaleScript zeigt die Funktion von Skripttext mit einem automatischen Farbschema an. Während Sie tippen, aktualisiert FinaleScript automatisch die Farbe der Wörter. Eine Erläuterung zu den Stichworttypen finden Sie unter Mit FinaleScript arbeiten - Die Struktur von FinaleScript.

     • Grün für Befehle;
     • Lila für Attribute;
     • Blau für Ziffern;
     • Orange für Zeichenketten (in "Anführungszeichen")
     • Rot für Zeichensatznamen (in [eckigen Klammern])
     • Hellgrau für Kommentare
     • Dunkelgrau für unbekannte Wörter (werden von FinaleScript ignoriert)

     ---

   • In der Textbox Skriptname, bearbeiten Sie den Namen Ihres Skripts.
   • Wählen Sie Im Menü zeigen, wenn Sie möchten, dass Ihr Skript im Untermenü Plug-ins > FinaleScript erscheint.
   • Klicken Sie Anwählen neben Tastenkürzel verwenden, wenn Sie Ihrem Skript ein Tastenkürzel zuordnen wollen.

   Wenn Sie Ihr Skript bearbeiten möchten, denken Sie daran, immer mal wieder die Speichern-Taste zu klicken, so dass Sie keine Arbeit umsonst machen.

4. Klicken Sie Speichern und schließen.

1. Öffnen Sie die Dialogbox FinaleScript Shortcut Editor
   
   • Wenn Sie Ihr Skript schon in Dialogbox FinaleScript -Editor sehen, klicken Sie neben Tastenkürzel verwenden, klicken Sie Anwählen.
   • Wenn die FinaleScript Palette angezeigt wird, CTRL-klicken Sie Ihr Skript und wählen Sie Tastaturkürzel bearbeiten.
2. Wählen Sie eine Option für Ihr Tastenkürzel:
   • Tippen Sie gleichzeitig eine Kombination aus Tasten auf Ihrer Computertastatur. Die Kombination erscheint in der Dialogbox.
   • Klicken Sie Kürzel finden!, damit FinaleScript ein noch zur Verfügung stehendes Tastaturkürzel vorschlägt.
   • Klicken Sie Keins um das existierende Tastaturkürzel zu entfernen.
3. Klicken Sie OK, um die Änderungen zu speichern oder Abbrechen, um sie zu verwerfen.

1. Wählen Sie Plug-ins > FinaleScript > FinaleScript- Palette. Die Palette FinaleScript erscheint.
2. Wählen Sie das Skript, das Sie bearbeiten wollen, und klicken Sie Bearbeiten (oder doppelklicken Sie das Skript). Die Dialogbox FinaleScript-Editor öffnet sich.

   Sie können das Skript auch CTRL-klicken und dann Bearbeiten klicken.

3. Wählen Sie Im Menü zeigen.
4. Klicken Sie Speichern und schließen. Ihr Skript erscheint jetzt im Plug-ins > FinaleScript-Untermenü.

Jedes Skript ist eine separate XML-Datei. Wenn Sie Ihre Skripte außerhalb von Finale verwalten wollen, gehen zum FinaleScript-Ordner in Ihrem Finale-Anwender-Ordner (siehe Finale- Installation-Details).

Noteman sagt: Jedes Skript und jeder Ordner, den Sie löschen, wird in den Papierkorb verschoben. Gelöschte Objekte können aus dem Papierkorb wiederhergestellt werden.

1. Wählen Sie Plug-Ins > FinaleScript > FinaleScript Palette. Die Palette FinaleScript erscheint.
2. Wenn Sie ein bestimmtes Skript verwalten wollen, wählen Sie es an und wählen eine Aktion:
   • Ein Skript umbenennen CTRL-klicken Sie das Skript und wählen dann Umbenennen. Geben Sie jetzt den neuen Namen in die Dialogbox FinaleScript - Umbenennen ein und klicken Sie OK.
   • Um ein Duplikat des Skripts zu erzeugen, klicken Sie die Taste Dupliziere aktuelles Skript (oder CTRL-klicken Sie das Skript und wählen Sie Duplizieren).
   • Um ein Skript in einen anderen Ordner zu bewegen, ziehen Sie es einfach dorthin.
   • Um ein Skript zu löschen, klicken Sie die Taste Löschen (oder CTRL-klicken Sie das Skript und wählen Sie Löschen)und bestätigen Sie dann mit Ja.
3. Wenn Sie einen ganzen Ordner mit Skripten verwalten wollen, wählen Sie diesen Ordner an und wählen Sie eine der folgenden Optionen.
   
   • Um einen Ordner zu erzeugen, klicken Sie die Taste Neuen Ordner erzeugen (oder CTRL-klicken Sie das Skript und wählen Sie neuen Ordner einfügen)
   • Um einen Ordner umzubenennen, CTRL-klicken Sie den Ordner und wählen Sie Umbenennen. Geben Sie den neuen Ordnernamen in der Dialogbox FinaleScript - Umbenennen ein und klicken Sie OK.
   • Um einen Ordner in einen anderen zu verschieben, ziehen Sie ihn einfach in den anderen Ordner.
   • Um einen Ordner zu löschen, klicken Sie die Skript Löschen und dann klicken Sie im folgenden Fenster Ja .

Jedes Skript ist eine separate XML-Datei. Wie jede andere Dokument-Datei, können Sie diese Teilen, wie Sie möchten, z. B. per E-Mail oder FTP).

1. Schreiben und speichern Sie Ihr Skript in der FinaleScript- Palette, und schließen Sie Finale.
2. Gehen Sie im Finder zum FinaleScript-Ordner in Ihrem Finale-Anwender-Ordner (siehe Finale -Installation (Details)).

   Der FinaleScript-Ordner hat die gleiche Ordnerstruktur wie die Skripte in der FinaleScript-Palette.

3. Finden Sie Ihr Skript. Der Dateiname Ihres Skriptes ist derselbe, der unter Skriptname in die Dialogbox FinaleScript-Editor eingegeben wurde, Leerzeichen werden allerdings ausgelassen und alle Buchstaben erscheinen als Kleinbuchstaben.

   Optional können Sie eine Kopie des Skriptes erzeugen und es an einen Ort kopieren, an dem Sie es schnell wiederfinden, wie z.B. Ihren Dokumentenordner oder Ihren Schreibtisch.

4. Versenden Sie die Datei, wie Sie möchten.

Jede Zeile des Skriptes kann nur einen Befehl enthalten, und alle Schlüsselwörter (inklusive Parametern) müssen durch ein Leerzeichen getrennt sein. Lassen Sie uns ein Beispiel anschauen:

create staff

Dies ist die einfachste Variante des Befehls create staff, er besteht aus den Schlüsselwörtern create und staff. FinaleScript wird beauftragt, am Ende der Partitur ein einzelnes Notensystem hinzuzufügen und alle bestehenden Voreinstellungen auf dieses Notensystem anzuwenden. Jetzt können wir ein paar Parameter hinzufügen:

create grand staff "Calliope"

Noteman sagt: Die Attribut grand erzeugt zwei Notensysteme, das obere mit Violinschlüssel und das untere mit Bassschlüssel. Dann wird ein Gruppentitel namens Calliope erzeugt und der Gruppe eine Schweifklammer hinzugefügt. Dies ist genau das Ergebnis, das Sie erwarten würden, wenn sie ein Klaviersystem in der Partiturverwaltung erzeugen würden.

In diesem Beispiel haben wir zwei Parameter hinzugefügtIn diesem Beispiel gibt es zwei Parameter: das Attribut grand, um ein Klaviersystem zu erzeugen, und die Zeichenkette "Calliope", um die Partitur mit Calliope zu bezeichnen. Dieses Beispiel zeigt, dass FinaleScript den Befehl auch dann lesen kann, wenn er nicht in der logischen Reihenfolge steht. Denn eigentlich müsste der Befehl create staff grand "Calliope" heißen, was aber nicht ganz so angenehm zu lesen wäre.

So, weiter geht´s:

create 2 bass staves "Trombone" "Tbn."

Jetzt haben wir zwei unabhängige Notensysteme erzeugt, jedem einen Bassschlüssel hinzugefügt und beiden einen Notensystemnamen „Trombone“ und eine Abkürzung „Tbn.“ gegeben. Das Schlüsselwort staff wurde durch staves ersetzt. (Wir werden später noch genauer auf Synonyme eingehen). FinaleSript begreift das. Wäre das nicht der Fall, müsste die Befehlszeile create staff 2 bass "Trombone" "Tbn." lauten, was ebenfalls deutlich schwerer zu lesen ist, als die Zeile oben.

Wie wir gesehen haben, beinhalten die Parameter die variablen Informationen in den Befehlen. Es gibt vier Parametertypen.

Noteman sagt: Zusätzlich zu diesen vier Parametern, gibt es diverse andere, die mit Finales verborgener Architektur zusammenhängen. Eine Liste der vier Typen sollte aber in nahezu allen Fällen ausreichen.

• Ziffern. Diese Variablen (num1, num2) sind nummerische Werte, die in der Regel bestimmte Elemente in einem Dokument spezifizieren, wie z. B. Takte, Ebenen oder Seiten. Bezieht sich eine Ziffer auf eine Maßeinheit, wird zunächst die aktuell eingestellte Maßeinheit verwendet; es kann aber auch noch ein Attribut für die Maßeinheit angegeben werden (wie z. B. in, cm, picas usw.). Ziffern werden nicht in irgendwelche Klammern oder sonstige Zeichen gesetzt.
• Zeichenfolgen. Diese Variablen (string1, string2) sind alphanumerische Werte, die in der Regel Folgendes beschreiben:
  • den Namen eines Elements in einem Dokument, wie z. B. den Notensystemnamen.
  • den Inhalt eines Textfeldes, wie z. B. der Titel oder der Komponist.
  • der Name eines Bestandteils von Finale, wie z. B. der Name einer Dialogbox.
  Zeichenfolgen stehen immer in Anführungszeichen.
• Zeichensatznamen. Diese Variablen (font1, font2) sind alphanumerische Werte, die den Namen eines Zeichensatzes angeben, wenn Sie z. B. „Text suchen und ersetzen“ anwenden. Zeichensatznamen werden in eckige Klammern gesetzt.
• Attribute. Wie Schlüsselworte, die Befehle enthalten, sind Attribute definierte Begriffe, die entweder einen Befehl modifizieren, oder die durch den Befehl auszuführende Aufgabe verändern. Da Attribute vordefiniert sind, müssen sie nicht durch Anführungszeichen oder ähnliches kenntlich gemacht werden.

Für einige Befehle sind Parameter optional, für andere zwingend notwendig. Im vorherigen Beispiel ist der Parameter bassoptional: während der Befehl create staff ohne ihn Bestand hat, sprezifiziert das Attribut bass den Befehl: Erzeuge Notensysteme mit Bassschlüssel. In dem Beispiel unten werden die Parameter 1 und 2 dringend benötigt: ohne sie ergibt der Befehl keinen Sinn.

move layer 1 to 2

In einigen Fällen ändert das Hinzufügen eines Parameters den kompletten Sinn des Befehls. Mit dem Befehl unten wählen Sie das Anwahlwerkzeug aus...

select

…während der folgende Befehl das Notensystemwerkzeug und das Notensystems namens „ Horn in F“ auswählt:

select "Horn in F"

Es ist wichtig zu wissen, dass viele Befehle ein unterschiedliches Verhalten zeigen, je nachdem, welches Element im Dokument gerade ausgewählt ist. Der Befehl wird sich entweder auf den angewählten Bereich beziehen, oder, wenn nichts angewählt ist, auf das gesamte Dokument. Sie können die Anwahl wie einen weiteren Parameter betrachten, da die Anwahl das Verhalten des Befehls verändert.

FinaleScript ist so konzipiert, dass die Skripte sofort verständlich sind. Hierfür sind eine Menge Synonyme vorhanden, also unterschiedliche Wörter, die dieselbe Bedeutung haben. Sie können jedes dieser Wörter verwenden, um dieselbe Aufgabe auszuführen. Zum Beispiel werden auf jeden der folgenden Befehle alle Elemente in einem bestimmten Bereich gelöscht (es wird Bearbeiten > Alle Objekte löschen ausgeführt):

clear
reset
delete music
remove music

Es gibt drei Arten von Synonymen:

• Befehlssynonyme. Ein ganzer Befehl kann häufig durch ein Synonym ersetzt werden. Im Beispiel oben kann der aus zwei Wörtern bestehende Befehl delete music als Synonym für den aus einem Wort bestehenden Befehl clear verwendet werden.
• Synonyme für einzelne Schlüsselwörter Die Wörter aus denen ein Befehl besteht, können oft durch ein Synonym ersetzt werden. In den Beispielen oben ist das Schlüsselwort reset ein Synonym für clear und das Schlüsselwort remove ist ein Synonym für delete.
• Attributsynonyme. Die vordefinierten Begriffe, die einen Befehl verändern, können manchmal durch ein Synonym ersetzt werden. In vielen Fällen machen Attributsynonyme einen Befehl weniger klar. Die folgenden vier Befehle wählen alle den dritten bis zum letzten Takt in einem Dokument aus:
  
  select measure 3 to end
select measure 3 to bottom
select measure 3 end
select measure 3 0
  
  Das Wort bottom im zweiten Befehl ist ein gültiges Synonym für end, aber seine Bedeutung ist nicht unbedingt sofort verständlich. Im dritten Befehl wurde das Schlüsselwort to entfernt, was eine gültige Auslassung ist, da to keine Funktion in diesem Befehl hat. Aber hier macht die Streichung den Befehl eher schwerer verständlich. Im vierten Befehl wird die 0 von FinaleScript wie „bis zum Ende des Dokuments“ verstanden, auch dies ist nicht unbedingt auf den ersten Blick einleuchtend. Aus diesen Gründen ist der erste Befehl die beste Wahl. Er ist nicht am prägnantesten aber am verständlichsten mit der kleinsten Wahrscheinlichkeit für Missinterpretationen.
  
  
  Attributsynonyme für Maßeinheiten

  Einheit	Synonyme
  EVPU	evpu, evpus
  Punkt	pt, pts, point, points
  Zwischenraum	s, sp, space, spaces
  Pica	pica, picas
  Zentimeter	cm, cent, centimeter, centimeters
  Zoll	i, in, inch, inches

  Eine Liste äquivalenter Werte für Einheiten finden Sie unter Maßeinheiten und Äquivalente.

Falls dies kompliziert erscheint, haben Sie keine Angst! Im FinaleScript-Befehlskatalog finden Sie alle relevanten Synonyme, die Sie für jeden Befehl verwenden können.

Sie können Ihrem Skript auch Kommentare hinzufügen, um Mehrdeutigkeiten für andere Nutzer Ihrer Skripte auszuschließen. Verwenden Sie Kommentare, um in Ihrem Skript „Wegweiser“ zu hinterlassen: geben Sie wichtige Informationen weiter, geben Sie Anweisungen oder erklären Sie, zu welchem Ziel ein Befehl führen soll.

Sie können einzeilige Kommentare als eigene Zeile eingeben oder nach einem Befehl anfügen. Ein einzeiliger Kommentar beginnt mit zwei Schrägstrichen (//):

// den markierten Bereich nach F#-Dur transponieren
key f# major

key f# major // den markierten Bereich nach F#-Dur transponieren

oder Sie können mehrzeilige Kommentare hinzufügen, in dem Sie sie zwischen /* und */ schreiben:

                        
                            /* Ändern Sie dieses Skript abhängig davon, in welche Tonart Sie transponieren möchten
    Modus:
        major
        minor
    Tonika:
        c
        c#
        db
        d
        d#s
        ...
        a#
        bb
        b
*/
key c major
                    

Tipp: Sie können in einer einzelnen Zeile zwischen kommentiert und unkommentiert hin und her springen, indem Sie die Zeile CTRL-klicken und Kommentar/kein Kommentar wählen.

Neben direkten Befehlen für die Hauptwerkzeuge, Menüfunktionen und viele spezielle Optionen und Einstellungen, haben Sie mit FinaleScript die Möglichkeit auf beinahe alle Elemente der Bedienoberfläche von Finale zuzugreifen.

Menübefehle

Sie können jeden Menübefehl, den Sie in Finale finden, mit dem Befehl menu item auswählen. Sie können entweder den kompletten Menüpfad angeben oder insofern der Name ausreichend unverwechselbar ist, reicht auch der Menübefehl.

menu item "Datei/Neu/Übung-Assistent"
menu item "Übung-Assistent"

Wenn ein Menübefehl an- und abwählbar ist, verwenden Sie check oder uncheck.

check menu item "Klingend anzeigen"
uncheck menu item "Klingend anzeigen"

Abkürzungszeichen

Der Kürze halber können Sie entweder * oder % verwenden, um lange Menübefehle abzukürzen. Achten Sie aber darauf, dass Ihr Skript trotzdem verständlich bleibt.

Gut: plug-in "Band-in-a-Box*" //anstatt "Band-in-a-Box-Hamonisierung"

Schlecht: menu item "PostScript%" //wählt "PostScript-Liste erstellen", aber das ist nicht offensichtlich

Ganz schlecht: menu item "Alle*" // Alle schließen? Alle speichern? Alles anwählen?

Tipp: Sie können auch dann Abkürzungen verwenden, wenn Sie sich auf andere Elemente der Benutzeroberfläche beziehen (siehe unten).

Anzeigen der Nachbarschaft

Noteman sagt: Genau genommen kennt FinaleScript das Schlüsselwort near gar nicht, darum ist dessen Verwendung nicht nötig. Es ist nur die Zeichenfolge notwendig, die die Bezeichnung enthält. Für die bessere Lesbarkeit empfehlen wir dennoch, near zu verwenden.

Sie werden feststellen, dass es Dialogboxen gibt, die ein Element mit einer Bezeichnung enthält, wie z. B. eine Textbox, oder die Dialogbox enthält mehr als ein Element mit der gleichen Bezeichnung , wie z. B. eine Taste Zeichensatz. In diesen Fällen verwenden Sie near gefolgt von einer Zeichenfolge.

                                
                                    staff tool
menu item "Notensystemattribute bearbeiten"
button "Einstellungen" //wählt die erste Taste „Einstellungen“
button "Einstellungen" near "Spezielle Notenköpfe verwenden" //eine genauere Angabe
                            

Wie bei Menübefehlen, können Sie Abkürzungen verwenden:

                                
                                    document options
list "Noten und Pausen"
button "Anwählen" near "Pause*" //kombiniert mit Abkürzungszeichen
                            

Wenn mehrere Textboxen in einem Raster vorliegen, werden die Bezeichnungen mehrdeutig. Um zwischen den verschieden Feldern zu navigieren, verwenden Sie tab.

                                
                                    select all
menu item "Neue Balken nach Taktart"
button "Bemischt"
type 2 near "Zählzeiten"
tab
type 8
tab
type 3
tab
type 8
button ok
button ok
                            

Tasten

FinaleScript erkennt Tasten basierend auf ihrer Bezeichnung. Die folgenden Tasten können ohne Anführungszeichen in Ihrer englischen Entsprechung angegeben werden (sofern Sie die Nachbarschaft nicht angeben): ok, cancel (Abbrechen), set font(Zeichensatz), save (Speichern), delete (Löschen), select (Anwählen).

button "Gemischt"
button ok
button "Zeichensatz" near "Notation" // Anführungszeichen werden benötigt

Ankreuzfelder

Wie bei den Menübefehlen, die aus- und einschaltbar sind, verwenden Sie check oder uncheck. Zusätzlich können Sie den aktuellen Status des Ankreuzfeldes ändern, indem Sie click checkbox verwenden.

check "Bögen automatisch anpassen" //aktiviert das Ankreuzfeld unabhängig vom vorherigen Zustand
uncheck "Bögen automatisch anpassen" //deaktiviert das Ankreuzfeld unabhängig vom vorherigen Zustand
click checkbox "Bögen automatisch anpassen" //Schaltet den Zustand des Ankreuzfeldes um

Optionsfelder

Mit einem Optionsfeld wählen Sie eine Option aus einem Set von Optionen aus, von denen nur eine aktiv sein kann.

                                
                                    document options
list "Wiederholungen"
select radio button "Nur oberstes Notensystem"
                            

Aufklappmenüs

Mit dem Befehl select popup menu wählen Sie ein ganz bestimmtes Element aus einem Aufklappmenü. Auch wenn es nicht immer nötig ist, geben Sie die Nachbarschaft an, um eindeutiger zu sein.

Gut: select popup menu "Abwärts" near "Noten transponieren"

Nicht so gut: select popup "Abwärts"

Der zweite Befehl ist zwar technisch gültig (da es nur ein Ausklappmenü in der Dialogbox Tonart-Vorzeichen, mit der Option „Abwärts“ gibt), diese Option ist allerdings im Aufklappmenü versteckt, was den Befehl relativ unklar macht. Neben der Angabe dar Nachbarschaft kann auch ein Kommentar die Zeichenfolge verbessern:

Ebenfalls gut: select popup "Abwärts" //Noten transponieren

Listen

Listen verhalten sich ähnlich wie Aufklappmenüs, abgesehen davon, dass ihre Optionen immer sichtbar sind und nicht versteckt werden.

select item from list "Tempoangaben" //Kategorieliste in der Auswahlbox der Vortragsbezeichnungen
select item from list "Linien und Kurven" //Kategorieliste in der in der Dialogbox Dokument-Optionen

Reiter

Einige Dialogboxen enthalten mehrere Reiter, die Einstellungen in logische Kategorien einteilen. Sie können zwischen den Reitern mit select tab wechseln.

                                
                                    expression tool
double click
list "Sonstige"
button "Erzeuge Sonstige*"
type "Nur beim zweiten Mal spielen" near "Beschreibung"
select tab "Wiedergabe"
select popup menu "Anschlagsstärke" near "Modus"
type 0 near "Setzen auf"
check "Nur spielen bei Durchgang"
type 1 near "Nur spielen bei Durchgang"
button ok
button "Anwählen"
                            

Expect (to)

Kombinieren Sie das Attribut expect mit einem Befehl, um FinaleScript anzuweisen, zu warten, bis das festgelegte Ereignis stattgefunden hat.

Noteman sagt: Dialogboxen, die den Ablauf stören werden nicht übergangen.

                                
                                    menu item "Datei/Exportieren/Audiodatei"
expect button save
                            

Tastenkürzel

Sie können das Drücken fast aller Tasten Ihrer Tastatur simulieren, indem Sie press verwenden. Einzelne Buchstaben müssen von Anführungszeichen eingeschlossen werden, Zahlen können ohne stehen.

press "f"
press 4

Sie können auch festlegen, dass die Taste auf dem Ziffernblock getippt werden soll.

press numpad 0

Die folgenden Tasten benötigen keine Anführungszeichen und können auch eine Angabe enthalten, wie oft die Taste gedrückt werden soll:

press up arrow //Aufwärtspfeil, auch down arrow, left arrow, right arrow
press delete
press end
press enter 3 //Drückt 3 Mal die Eingabetaste
press home
press page up
press page down
press return
press spacebar
press tab 4 //Drückt vier Male die Tabulatortaste

Jede Zeichenfolge kann eine oder mehrere Modifikationstasten (ALT, STRG, etc.) enthalten:

press option home
press command control "v"
press shift tab 2

Tipp: Um mehrere Buchstaben einzugeben, lesen Sie type weiter unten.

Textfelder (type und raw)

Wenn Sie Buchstaben in ein Textfeld innerhalb einer Dialogbox eingeben müssen, verwenden Sie type.

                                
                                    menu item "Taktzahlenabschnitte bearbeiten"
button "Entfernen"
button "Hinzufügen"
type 1 near "Enthält Takte"
type 999 near "bis"
uncheck "Taktzahl an jedem Zeilenanfang*"
check "Taktzahl an jedem"
type 5 near "Taktzahl an jedem"
type 5 near ". Takt zeigen, beginnend mit Takt"
check "Rahmen" near "Zeige an jedem"
button ok
                            

Das Attribut raw kann mit Modifikationstasten kombiniert werden, um die Tasten jedem Buchstaben in der type-Zeichenfolge zuzuordnen.

Noteman sagt: In der Vergangenheit wurde raw auch verwendet, um auf dem Macintosh Elemente in Listen, die nicht mit Scripten bearbeitbar waren, anzuwählen, wie z. B. die Anwahl von Zeichensätzen (z. B. type raw "petrucci").

type raw command "ac" //äquivalent zu Befehlstaste+A und Befehlstaste+C

Es kann auch verwendet werden, um Text in auf andere Art unzugängliche Bereiche zu schreiben, wie z. B. in Textrahmen, die mit dem Textblock-Werkzeug erstellt wurden...

                                
                                    text tool
double click
type raw "Copyright "
menu item "Copyright-Sym*" //fügt das Copyright-Symbol ein
type raw command "v"
                            

… oder das Text-Feld in der Dialogbox Design von Vortragsbezeichnungen…

                                
                                    expression tool
double click
list "Sonstige"
button "Erzeuge*"
type raw "Entlasse die Pinguine"
type "Pinguine entlassen" near "Beschreibung"
button ok
button "Anwählen"
                            

… oder ein formatiertes Textfeld in einem der Textbearbeitungsfenster wie Textblock bearbeiten (für Gruppen- oder Notensystemnamen und eigenen Text) oder das Textfenster.

                                
                                    menu item "Partiturverwaltung"
button "Bezeichnung"
type raw "Klarinette in B"
type raw command shift "b" //B-Vorzeichen einfügen
button ok
                            

Es ist wichtig zu beachten, dass raw nur funktioniert, wenn der Cursor im Textfeld steht. Das heißt, zum Beispiel, dass Sie in einer Zeichenfolge nicht rawund neargleichzeitig verwenden können.

Mausposition und Klicks

Verwenden Sie cursor, um den Mauszeiger in einem bestimmten horizontalen und vertikalen Abstand zur oberen linken Ecke des Monitors (in Pixeln) zu positionieren.

cursor 500 250

Der Befehl click unterstützt sowohl das Attribut double als auch Tastenkürzel-Attribute.

double click
control shift click

Fenster und Dialogboxen

Verwenden Sie select window (oder select dialog box) um zu einer geöffneten Dialogbox zu gehen oder zu einem Dokumentfenster. Die Dialogbox darf nicht modal sein, das bedeutet die Dialogbox muss eine Dialogbox sein, die nicht geschlossen werden muss, bevor der Anwender irgendwo anders in Finale hin klicken kann. Allerdings sind die wenigsten Dialogboxen nicht modal.

                                
                                    select window "Partiturverwaltung"
tab "Datei-Info"
type "Fredric Marc Bunbury" near "Arrangeur"
select window "Seitenränder bearbeiten"
type 1.5 near "Unten"
type 1 near "Seite"
button "Anwenden"
                            

Die wahrscheinlich nützlichste Funktion von FinaleScript ist die Fähigkeit, Befehle automatisch auf mehrere Dokumente gleichzeitig anzuwenden. Diese Funktion heißt Stapelverarbeitung. Sie können entweder alle Dokumente, die zur Zeit in Finale geöffnet sind, oder alle Dokumente in einem bestimmten Ordner auf Ihrem Computer bearbeiten.

Alle offenen Dokumente verarbeiten

Weil FinaleScript Befehle der Reihe nach abarbeitet, muss die Anweisung, dass mehr als ein Dokument verarbeitet werden soll, ganz weit vorne in Ihrem Skript stehen, vor den auszuführenden Befehlen.

process all open

Sie können auch festlegen, dass Sie den Befehl/die Befehle auf alle geöffneten Dokumente außer dem aktuellen Dokument anwenden möchten:

don't process active document

Dies ist vor allem dann sinnvoll, wenn Sie Einstellungen aus einem Dokument mit dem Befehl import options in andere Dokumente importieren wollen.

Dokumente in einem Ordner verarbeiten

Genauso, wie Sie mit geöffneten Dokumenten arbeiten, müssen Sie FinaleScript mitteilen, dass es den Ordner verarbeiten soll, bevor Sie die Befehle angeben, die ausgeführt werden sollen. An den Anfang Ihres Skriptes stellen Sie einen der folgenden Befehle:

batch process folder
batch process folder and subfolders

Noteman sagt: Die Quell- und Zielordner betreffen den save-Befehl (mit möglichen Parametern.) Diese Einstellungen gelten nicht für das Exportieren von Grafiken, Audiodateien, MusicXML etc..

Zusätzlich müssen Sie sowohl einen Quell- als auch einen Zielordner festlegen. Dies kann auf drei Arten geschehen. Sie können exakte Pfade in einem Skript unterbringen...

batch process source folder "/Users/main/Desktop/Noten"
batch process destination folder "/Users/main/Desktop/Noten/konvertiert"

… oder Sie können FinaleScript anweisen, einen oder beide Ordner auszuwählen...

ask source folder
ask destination folder

… oder Sie können die Ordner in der Dialogbox FinaleScript-Optionen anwählen, bevor Sie ein Skript laufen lassen.

Wenn Sie einen bestimmten Ort für einen Ordner in einem Skript festlegen wollen, können Sie diesen Ort einfach einfügen, indem Sie in der Dialogbox FinaleScript-Editor CTRL-klicken und dann Pfad einfügen klicken. Es öffnet sich eine Dialogbox, in der Sie gebeten werden, den Ordner auszuwählen. Tun Sie das und klicken Sie OK. Der Pfad zu dem Ordner (eingefasst fasst von Anführungszeichen) ist jetzt in Ihr Skript integriert.

Tipp: Wenn Sie exakte Pfade in einem Skript auf dem Macintosh angeben, können Sie POSIX-, HFS- und Windows-Konventionen verwenden.

                        
                            /* Die Maßeinheit kann mit dem Befehl "Unit" global geändert oder in einer Zeile explizit mit angegeben werden */

unit evpus
staffline thickness 6
page format 21x29.7 cm
//Angabe der Seitengröße explizit in Zentimetern gilt nur für diese Zeile
beam thickness 24
//staffline thickness .02 inch
                    

• Das Skript enthält einen Kommentar.
• Der erste Befehl unit, gefolgt vom Attribut evpus, setzt die globale Maßeinheit auf EVPUEVPU oder ENIGMA Virtual Page Units sind Finales flexible Maßeinheiten zur Berechnung von Größen und Abständen Ihrer Musik, vobei 288 EVPU einem Zoll bzw 4 EVPU einem Punkt entspricht. Sie können diese Werte aber auch in gebräuchlichereren Einheiten wie z. B. Zentimetern oder Zoll anzeigen lassen..
• Die nächste Zeile ergänzt den Befehl thickness um das Attribut staffline: Alle Notensystemlinien in diesem Dokument haben jetzt die Dicke von 6 EVPU. Beachten Sie, dass dieses Attribut vor oder nach dem Befehl stehen kann.
• Jetzt setzen wir die Seitengröße mit dem Befehl page format horizontal auf 21cm und vertikal auf 29.7 cm; hier überschreibt das Schlüsselwort cm die Einstellung der zuvor mit dem unit-Befehl festgelegten globalen Einheit.
• Ein einzeiliger Hinweis erinnert uns daran.
• Der beam thickness-Befehl, stellt die Balkendicke, wie zu erwarten, auf 24 EVPU.
• Eine weitere Funktion des Kommentaranzeigers (//) ist, anzuzeigen, dass ein Befehl jetzt nur noch ein Kommentar ist. Der Befehl ist abgeschaltet, wenn der Kommentaranzeiger davor steht. Ohne den Kommentaranzeiger würde FinaleScript den Befehl thickness ausführen und die Dicke der Notensystemlinien auf .02 inch setzen. So aber wird FinaleScript keine Aktion durchführen.
  
  

                        
                            //batch process folder
//process all open

page format A3
//resize pages to 75%
//resize systems to 80%
//staff height = 82 evpus
reorganize layout
respace all
message "Denken Sie daran, Ihren Drucker auf das neue Format einzustellen."
                    

• Für eine einfachere Bedienung beginnt das Skript mit zwei Ablaufbefehlen, die zur Zeit abgeschaltet sind, aber jederzeit einfach aktiviert werden können.
  
• Der entscheidende Befehl für dieses Skript kommt jetzt: page format mit dem A3-Attribut.
• Drei weitere abgeschaltete Befehle halten Optionen für Größenanpassungen unterschiedlicher Partiturelemente mit nützlichen Voreinstellungen bereit.
• reorganize layout entsperrt die Takte und aktualisiert das Layout, während respace die Musikausrichtung neu durchführt.
• Eine message erscheint, um den Anwender zu warnen, dass vor dem Drucken eine passende Seitengröße gewählt werden muss.

                        
                            //Ihr Mauszeiger sollte sich in der Nähe der oberen linken Ecke der Seite befinden.
//Wenn Sie dem Skript ein Tastaturkürzel zuweisen, ist der Aufruf einfacher.

text tool
double click
menu item "Seitenzahl"
menu item "Rahmenattribute"
dropdown "Seitenbereich" near "Zuordnung"
type 2 near "Seitenbereich"
type 0 near "Horizontal"
type "48evpus" near "Vertikal"
check "Verwende Positionierung für rechte Seiten"
dropdown "Rechts" near "Verwende Positionierung für rechte Seiten"
type "48evpus" near "Abbrechen"
click OK
                    

• Die ersten Kommentare erinnern den Anwender daran, dass der zweite Befehl double click dort ausgeführt wird , wo sich Mauszeiger sich befindet, dies sollte auf einem leeren Abschnitt der Seite sein.
  
• Das Textblock-Werkzeug ist ausgewählt, ein Textrahmen wird erzeugt, indem die Seite doppelgeklickt wird, und eine Seitenzahl wird über Textblock > Einfügen > Seitenzahl eingefügt.
• Die Dialogbox Rahmenattribute wird angezeigt, gefolgt von sechs Befehlen, die die Einstellungen in dieser Dialogbox vornehmen, bevor OK geklickt wird.

                        
                            //Dieses Skript erzeugt aus einer Chorpartitur oder jeder anderen Partitur
//mit 4 Notensystemen einen schnellen Klavierauszug

//process folder
//process all open docs
work on layer 1
add piano staves "Klavier"
select staff 2
copy
select staff 5
paste
move layer 1 to 2
//delete lyrics
select staff 1
copy
select staff 5
paste
//delete lyrics
select staff 4
copy
select staff 6
paste
move layer 1 to 2
//delete lyrics
select staff 3
copy
select staff 6
paste
//delete lyrics

//Optional:
Staff tool
select staves 1 to 4
menu item "Notensysteme entfernen und neu anordnen"

show all layers

select staff 1
Staff Attributes
Uncheck "Abbreviatur:"
Hit "Ok"
select staff 2
Staff Attributes
Uncheck "Abbreviatur:"
Hit "Ok"

//save and append "Klavier"
//close
                    

• Die Länge dieses Skriptes ist ein gutes Beispiel dafür was für komplexe Aufgaben ganz schnell mit FinaleScript automatisiert werden können. Nach den eröffnenden Kommentaren, finden sich hier zwei Ablaufbefehle, die zur Zeit abgeschaltet sind, aber jederzeit einfach aktiviert werden können.
• Ein Klaviersystem mit dem Notensystemnamen "Klavier" wird unten in der Partitur erzeugt.
• Der Befehl work on layer 1, der dem voran geht, stellt sicher, dass das Kopieren von Notensystemen im nächsten Abschnitt keine bestehenden Ebenen überschreibt.
• Vier Befehlssets beziehen sich jeweils auf die vier schon vorher vorhandenen Notensysteme:
  • Das zweite Notensystem (Alt im SATB-Beispiel) wird in das Klaviersystem in das Notensystem mit dem Violinschlüssel kopiert und in Ebene 2 verschoben, optional und zur Zeit abgeschaltet ist der Befehl delete lyrics der auch in den drei folgenden Befehlsets erscheint.
  • Das 1. Notensystem (Sopran) wird in das Klaviersystem in das Notensystem mit dem Violinschlüssel kopiert (in Ebene 1).
  • Das 4. Notensystem (Bass) wird in das Klaviersystem in das Notensystem mit dem Bassschlüssel kopiert und in Ebene 2 verschoben.
  • Das 3. Notensystem (Tenor) wird in das Klaviersystem in das Notensystem mit dem Bassschlüssel kopiert und in Ebene 1 verschoben.
• Die 4 Originalnotensysteme werden gelöscht und das Klaviersystem wird neu positioniert (der Kommentar informiert darüber, dass diese Zeile auch abgeschaltet werden kann, falls gewünscht).
• Dokument > Nur aktive Ebene zeigen wird ausgeschaltet, ebenso wie Abbreviaturen in den Notensystemen des Klaviersystems.
• Abschließende Ablaufkommentare (Speichern und Schließen des Dokuments) werden optional bereitgehalten.

                        
                            Batch Process Folder
//Process all open docs

Graphics tool
Menu item "Seiten exportieren"

Popup "TIFF"
//Popup "PICT"
//Popup "EPS"
//Popup "PDF"

Check "Alle"
Check "Name erzeugen aus:"
Type 1200 near "Auflösung:"

//Check "Zeichensätze einschließen"
//Check "Transparenz ermöglichen"

Press "OK"
//expect to return	//Für Speichern als PDF
Close

End
                    

• Dies ist ein Skript zur Stapelverarbeitung, somit ist der Befehl batch process folderaktiv. Alternativ kann der Anwender aber auch process all open docsaktivieren.
• Das Grafik-Werkzeug wird angewählt und Grafik > Seiten exportieren wird aufgerufen.
• Mehrere Einstellungen werden in der Dialogbox Seiten exportieren vorgenommen:
  • Vier verschiedene Dateiformate werden angeboten.
  • Alle Seiten werden exportiert.
  • Dateiendungen folgen dem Schema "[Dokumentname]#".
  • Die Auflösung wird auf 1200 dpi gesetzt.
  • Für den PostScript-Output kann Zeichensätze einschließen und Transparenz ermöglichen angewählt werden.
• Die Dialogbox wird verlassen und geschlossen.

  Der abgeschaltete Befehl expect to return wird für die PDF-Ausgabe gebraucht.

1. Planen Sie voraus. Bevor Sie ein Skript schreiben, überlegen Sie sich genau, was das Skript für Sie tun soll. Nur dann können Sie die einzelnen Befehlsschritte definieren. Für die Eingabe von komplexeren Skripten kann es sich lohnen, die vorgeschlagene Eingabereihenfolge für Finale-Dokumente zu beachten.

   Verwenden Sie die Kommandozeile der FinaleScript-Palette, um einzelne Befehle an einem Probedokument auszuprobieren. Die Palette zeigt den Namen des aktiven Dokuments direkt oberhalb der Befehlszeile an, sodass Sie jederzeit sehen, welches Dokument bearbeitet wird, wenn Sie einen Befehl ausführen.

2. Erzeugen Sie ein leeres Skript. Geben Sie Ihrem Skript einen beschreibenden Namen, und legen Sie es, wenn Sie möchten, in einem Ordner für Skripte ähnlicher Kategorie ab. Wenn Sie das Skript häufig verwenden werden, wie z. B. eines zur Stapelverarbeitung mehrerer Dokumente, überlegen Sie, ob Sie diesem Skript nicht ein Tastaturkürzel zuweisen, oder es im FinaleScript-Menü aufnehmen möchten.
2. Wenn ein schon existierendes Skript Funktionen enthält, die Sie brauchen können, duplizieren Sie das Skript mit einem neuen Namen und bearbeiten Sie es dann.
3. Geben Sie die Befehle und Attribute ein. Während der Eingabe färbt FinaleScript den Text entsprechend des automatisierten Farbschemas, um die Funktion des Skripttextes anzuzeigen. Nutzen Sie sie die automatisierte Farbanzeige, mit Ihrer Hilfe können Sie sehen, ob die von Ihnen eingegebenen Begriffe tatsächlich in FinaleScripts Vokabular existieren, und dass Sie nicht mehr als einen Befehl pro Zeile eingeben.

Über das automatische Farbschema

FinaleScript zeigt die Funktion von Skripttext mit einem automatischen Farbschema an. Während Sie tippen, aktualisiert FinaleScript automatisch die Farbe der Wörter. Eine Erläuterung zu den Stichworttypen finden Sie unter Mit FinaleScript arbeiten - Die Struktur von FinaleScript.

• Grün für Befehle;
• Lila für Attribute;
• Blau für Ziffern;
• Orange für Zeichenketten (in "Anführungszeichen")
• Rot für Zeichensatznamen (in [eckigen Klammern])
• Hellgrau für Kommentare
• Dunkelgrau für unbekannte Wörter (werden von FinaleScript ignoriert)

---

Prüfen Sie Ihre Arbeit sorgfältig, bevor Sie das Skript laufen lassen: ein falscher Buchstabe kann Ihr Skript völlig verändern.

• Verwenden Sie die Kommentare großzügig. Auch wenn FinaleScript einfach zu lesen ist, ein komplexes Skript kann schnell unverständlich werden. Mit klugen Kommentaren strukturieren Sie Ihr Skript, was Ihnen auch schon beim Schreiben des Skriptes behilflich sein wird. Die Kommentare helfen Ihnen selbst und auch anderen, die mit Ihren Skripten arbeiten werden.

  Kommentare sind besonders dann hilfreich, wenn sie Parameter oder ganze Bereiche hervorheben, die, abhängig von der Situation, geändert werden müssen oder könnten, bevor das Skript gestartet wird, wie z. B. Dateipfade.

• Testen Sie Ihr Skript an einem Probedokument. Wir können das nicht genug betonen. GEHEN SIE NICHT DAVON AUS, DASS IHR SKRIPT FEHLERLOS IST. Erzeugen Sie ein Probedokument mit ähnlicher Notation, wie in dem Dokument, für das Sie das Skript geschrieben haben, und dann probieren Sie es aus.
• Analysieren Sie das Ergebnis, wenn alles zufriedenstellend ausgeführt ist, dann sind Sie fertig. Häufig jedoch muss das Skript überarbeitet werden, oder sogar komplett neu überdacht und umkonzipiert werden. Wenn ein Befehl gar nicht funktioniert, prüfen Sie ihn auf Schreibfehler.
• Probieren Sie es – aber nur mit einem Backup. Bevor Sie das Skript mit Ihrem Originaldokument laufen lassen, machen Sie eine Kopie von Ihrem Dokument, so dass Sie noch eines haben, falls das Undenkbare geschieht. Wenn das Skript funktioniert, umso besser, wenn nicht, haben Sie noch das Original. Überarbeiten Sie es, und versuchen Sie es noch einmal.

  Viel Glück und Happy Scripting!