Makros

Makros stellen eine externe Zusatzmodulschnittstelle für die Erweiterung der Funktionalität von Designer dar. Führen Sie beispielsweise Makros aus, um ein Feld umzubenennen und alle verknüpften Skriptverweise zu aktualisieren oder um Skripts zu suchen, die vollständig aus Kommentaren bestehen.

Hinweis: Sie sollten ein Makro nur ausführen, wenn Sie dem Autor des Skripts vertrauen.

Ein Makro ist eine JavaScript-Datei (JS). Sie erstellen JavaScript-Dateien in einem JavaScript-Editor und führen die Skripten dann in Designer aus. Das im Makro enthaltene JavaScript hat vollen Zugriff auf das Vorlagenmodell. Neben dem Vorlage-DOM gibt es im Stamm-Namespace ein Objekt namens „designer“. Das Objekt „designer“ stellt Methoden bereit, mit denen Sie direkt mit Designer kommunizieren können. Beispiel: Eine Methode erlaubt es Ihnen, ein SWF-Dialogfeld aufzurufen und Zeichenfolgen mit diesem auszutauschen. Auf diese Weise können Sie eine benutzerdefinierte Benutzeroberfläche erstellen.

Weitere Informationen zu den verfügbaren Skriptmethoden finden Sie in der Skriptreferenz.

Um Makros für die Verwendung in Designer einzurichten, erstellen Sie eine Unterordnerstruktur für JavaScript-Dateien im Installationsordner von Designer und führen Sie die JavaScript-Dateien über das Menü „Makros“ aus („Extras“ > „Makros“).

So richten Sie Makros für die Verwendung in Designer ein

  1. Führen Sie einen der folgenden Schritte aus:

    • Erstellen Sie für allgemeine Makros (alle Sprachen) im Installationsordner von Designer einen Unterordner mit dem Namen „macros“. Beispiel: <DesignerInstallationsordner>\macros.

    • Erstellen Sie für sprachspezifische Makros im Installationsordner von Designer einen Unterordner für jede Sprache (Gebietsschema) und erstellen Sie anschließend einen Ordner mit dem Namen „macros“ in jedem Gebietsschema-Ordner. Beispiel: <DesignerInstallationsordner>\DE\macros.

  2. Erstellen Sie in jedem Ordner „macros“ einen oder mehrere Unterordner für JavaScript- (JS) und „macro.xml“-Dateien.

  3. Speichern Sie die JavaScript- und „macro.xml“-Dateien in den entsprechenden Unterordnern. Legen Sie ggf. alle SWF-Dateien, die von den JavaScript-Makrodateien verwendet werden, in demselben Unterordner ab.

  4. Wählen Sie in Designer „Extras“ > „Makros“. Die Makros (allgemeine und sprachspezifische Makros) werden im Menü „Makros“ aufgeführt.

Grundlagen zu „macro.xml“-Konfigurationsdateien

Sie erstellen eine „macro.xml“-Konfigurationsdatei, um den Befehl umzubenennen, der im Menü „Makros“ für jede JavaScript-Datei in einem Unterordner angezeigt wird. Sie fügen eine „macro.xml“-Datei zu jedem Unterordner hinzu, der eine oder mehrere JavaScript-Dateien enthält.

Sehen Sie sich die label- und script-Tags in der folgenden „macro.xml“-Beispieldatei an. Das label-Tag umschließt den Namen des Befehls (Zusammenführen), der im Menü „Makros“ angezeigt wird. Der script-Tag umschließt den Namen der verknüpften JavaScript-Datei (mergenodes.js).

Beispiel für eine „macro.xml“-Datei:

<?xml version="1.0" encoding="UTF-8"?> 
<designerMacros> 
<!-- one or more macros that are in the same directory can be specified in the same macro.xml config file --> 
<macro> 
    <!-- used as menu command text --> 
    <label>Merge</label> 
    <!-- A macro key can refer to only one script file --> 
    <script>mergenodes.js</script> 
</macro> 
</designerMacros>

Die Verwendung von „macro.xml“-Konfigurationsdateien ist optional. Beim Aktualisieren der Liste der Makros in Designer wird in den „macros“-Unterordnern nach „macro.xml“-Dateien gesucht. Wenn Designer keine „macro.xml“-Datei in einem Unterordner findet, werden die Namen der JavaScript-Dateien im Menü „Makros“ angezeigt.

Organisieren des Unterordners „macros“

Erstellen Sie mindestens einen Unterordner für JavaScript-Dateien im Ordner „macros“. Wenn Sie JavaScript-Dateien direkt im Ordner „macros“ speichern, werden sie nicht im Menü „Makros“ in Designer angezeigt.

Sie haben verschiedene Möglichkeiten, die Unterordner des Ordners „macros“ zu organisieren. Die gewählte Methode ist von Ihren Anforderungen abhängig. Prüfen Sie die Anzahl der vorhandenen JavaScript-Dateien, die Anzahl der zu erstellenden „macro.xml“-Dateien sowie die Reihenfolge der Befehle im Menü „Makros“.

Zum einen haben Sie die Möglichkeit, sämtliche JavaScript-Dateien in nur einem Unterordner des Ordners „macros“ zu speichern. Sie können dann eine „macro.xml“-Datei verwenden, um die Namen aller JavaScript-Dateien in dem Ordner sowie die Namen der verknüpften Befehle im Menü „Makros“ festzulegen. Die Reihenfolge der Befehle im Menü „Makros“ stimmt mit der Reihenfolge der Makros in der Datei „macro.xml“ überein.

Beispiel für eine „macro.xml“-Datei mit mehreren Makros:

<?xml version="1.0" encoding="UTF-8"?> 
<designerMacros> 
<macro> 
    <label>Get Designer Locale</label> 
    <!-- Description - Get Designer locale --> 
    <script>getLocale.js</script> 
</macro> 
<macro> 
    <label>Hello World</label> 
    <!-- Description - Display Hello World --> 
    <script>helloWorld.js</script> 
</macro> 
<macro> 
    <label>Highlight Text</label> 
    <!-- Description - Highlight text areas --> 
    <script>HighlightFields.js</script> 
</macro> 
<macro> 
    <label>Refactor</label> 
    <!-- Description - Refactor --> 
    <script>refactor.js</script> 
</macro> 
<macro> 
    <label>Show Flex Sample</label> 
    <!-- Description - Show Flex Sample --> 
    <script>showFlexSample.js</script> 
</macro> 
</designerMacros>

Zum anderen können Sie die JavaScript-Dateien in separaten Unterordnern des Ordners „macros“ speichern. Sie verwenden eine „macro.xml“-Datei in jedem Unterordner, um die Namen der JavaScript-Dateien anzugeben und die dazugehörigen Befehle im Menü „Makros“ zu benennen. Die Reihenfolge der Befehle im Menü „Makros“ entspricht der Reihenfolge der Unterordner und der Reihenfolge der in den einzelnen „macro.xml“-Dateien aufgeführten Makros.

Beachten Sie, dass alle Unterordner, die Sie für JavaScript-Dateien erstellen, dem übergeordneten Ordner „macros“ (macros\MeineMakros) untergeordnet sein müssen. Designer überprüft keine Unterordner, die sich unterhalb der Ebene des ersten Unterordners befinden. Nachdem Sie eine JavaScript-Datei zu einem Unterordner des Ordners „macros“ hinzugefügt haben, wird der Name der Datei unter dem Befehl „Makros“ im Menü „Extras“ angezeigt. Wenn Sie einen anderen Namen als den JavaScript-Dateinamen anzeigen möchten, können Sie eine XML-Konfigurationsdatei namens „macro.xml“ erstellen, um den Namen zu ändern.

Lokalisieren von Makros

Sie erstellen eine Unterordnerstruktur im Installationsordner von Designer für die mit Makros verknüpften JavaScript-Dateien. Die von Ihnen erstellte Unterordnerstruktur ist davon abhängig, ob Sie Makros lokalisieren möchten oder nicht.

Wenn keine Lokalisierung von Makros erforderlich ist, da die Makros für alle Sprachen gleich sind, erstellen Sie einen Unterordner namens „macros“ im Installationsordner von Designer. Beispiel: C:\Programme\Adobe\Designer\macros\. Erstellen Sie anschließend im Unterordner „macros“ einen oder mehrere Unterordner für die JavaScript-Dateien, die Sie ausführen möchten. Sie können einen Unterordner für alle JavaScript-Dateien oder einen eigenen Unterordner für jede JavaScript-Datei erstellen. Designer lädt die JavaScript-Dateien in diesen Unterordnern unabhängig von der in der Liste „Sprache für Formulare“ (Dialogfeld „Formulareigenschaften“ > Bereich „Standard“) ausgewählten Sprachoption.

Wenn Sie Makros lokalisieren müssen, da sie sprachspezifisch sind, erstellen Sie im Installationsordner von Designer einen Unterordner für jedes Gebietsschema. Erstellen Sie anschließend einen Unterordner namens „macros“ im jeweiligen Gebietsschema-Unterordner und erstellen Sie im Gebietsschema-Unterordner einen oder mehrere Unterordner für die JavaScript-Dateien. Beispiel: C:\Programme\Adobe\Designer\DE\macros\. Designer lädt die JavaScript-Dateien in diesen Ordnern in Abhängigkeit von der Anwendungssprache von Designer.

Protokollierung von Makros

Wenn Sie nicht sicher sind, welche Makros von Designer geladen werden, können Sie sich die Makro-Protokolldatei ansehen.

Designer erstellt eine Protokolldatei namens „MacrosLog.log“ im Ordner für Anwendungsdaten von Designer: C:\Dokumente und Einstellungen\<Benutzername>\Anwendungsdaten\Adobe\Designer\<Designer-Versionsnummer>.

In der Datei „MacrosLog.log“ werden die in Designer geladenen Makros aufgeführt.