Macro's

Macro's zorgen voor een interface naar externe insteekmodules om de functionaliteit van Designer te vergroten. U kunt bijvoorbeeld een macro uitvoeren om de naam van een veld te wijzigen en alle scriptverwijzingen bij te werken, of om te zoeken naar scripts die volledig uit opmerkingen bestaan.

Opmerking: Voer een macro alleen uit als u de auteur van het script vertrouwt.

Een macro is een JavaScript-bestand (JS). U maakt JavaScript-bestanden in een JavaScript-editor en voert de scripts in Designer uit. Het JavaScript in het macro heeft volledige toegang tot het sjabloonmodel. Naast de sjabloon DOM is er een object in de basisnaamruimte met de naam designer. Het object designer beschikt over methoden waarmee u direct kunt communiceren met Designer. Er is bijvoorbeeld een methode waarmee u een SWF-dialoogvenster opstart en tekenreeksen kunt vervangen om een aangepaste gebruikersinterface te maken.

Zie voor meer informatie over beschikbare scriptmethoden de Scriptreferentie.

Als u macro's wilt instellen voor Designer, maakt u submappen voor de JavaScript-bestanden in de installatiemap van Designer en voert u de JavaScript-bestanden uit vanuit het menu Macro's (Opties > Macro's).

Macro's instellen voor gebruik in Designer

  1. Voer een van de volgende handelingen uit:

    • Voor algemene macro's (alle talen) maakt u in de installatiemap van Designer een submap met de naam macros. Bijvoorbeeld: <InstallatiemapVanDesigner>\macros.

    • Voor taalspecifieke macro's maakt u in de installatiemap van Designer een submap voor elke taal (landinstelling), en maakt u vervolgens de map 'macros' in elke submap. Bijvoorbeeld <InstallatiemapVanDesigner>\NL\macros.

  2. In elke map 'macros' maakt u een of meer submappen voor JavaScript- (JS) en macro.xml-bestanden.

  3. Sla de JavaScript- en macro.xml-bestanden op in de juiste submappen. Plaats eventuele SWF-bestanden die in de macro-JavaScript-bestanden gebruikt worden in dezelfde submap.

  4. Klik in Designer op Opties > Macro's. In het menu Macro's krijgt u een overzicht van de macro's (algemeen en taalspecifiek).

Over de macro.xml-configuratiebestanden

U kunt een macro.xml-configuratiebestand maken om de naam te wijzigen van de opdracht die voor elk JavaScript-bestand in een submap verschijnt in het menu Macros. U kunt één macro.xml-bestand toevoegen aan elke submap met een of meer JavaScript-bestanden.

Let op de label- en scripttags in het volgende macro.xml-bestand. De labeltag bevat de naam van de opdracht (Samenvoegen) die verschijnt in het menu Macros. De scripttag bevat de naam van het bijbehorende JavaScript-bestand (mergenodes.js).

Voorbeeld-macro.xml-bestand:

<?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>

Het gebruik van de macro.xml-configuratiebestanden is optioneel. Als de lijst met macros wordt vernieuwd in Designer, wordt in de submappen met macro's gezocht naar macro.xml-bestanden. Als Designer geen macro.xml-bestand in een submap vindt, worden de namen van de JavaScript-bestanden weergegeven in het menu Macro's.

De submap voor macro's ordenen

Maak ten minste één submap onder de map 'macros' voor de JavaScript-bestanden. Als u JavaScript-bestanden direct in de map 'macros' opslaat, worden ze niet weergegeven in het menu Macro's in Designer.

U kunt de submappen met macro's op verschillende manieren ordenen. Welke methode u kiest, is afhankelijk van uw behoeften. Houd rekening met het aantal JavaScript-bestanden waarover u beschikt, het aantal macro.xml-bestanden dat u moet maken, en de volgorde van de opdrachten in het menu Macro's.

U kunt de submappen voor macro's ordenen door alle JavaScript-bestanden op te slaan in één submap. Op deze manier kunt u één macro.xml-bestand gebruiken om de namen van alle JavaScript-bestanden in de map op te geven en de bijbehorende opdrachten van het menu Macro's een naam geven. De volgorde van de opdrachten in het menu Macro's is gelijk aan de volgorde van de macro's in het bestand macro.xml.

Voorbeeld van het bestand macro.xml met meerdere macro's:

<?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>

U kunt de submappen voor macro's ook ordenen door JavaScript-bestanden op te slaan in aparte submappen. In elke submap legt u in een bestand macro.xml de naam van de JavaScript-bestanden en de bijbehorende opdrachten van het menu Macro's vast. De volgorde van de opdrachten in het menu Macro's is gelijk aan de volgorde van de submappen en de macro's in het bestand macro.xml.

Houd er rekening mee dat alle submappen die u maakt voor JavaScript-bestanden, een onderliggende map moeten zijn van de hoofdmap voor macro's (macros\MyMacros). Designer doorzoekt alleen de submappen direct onder het niveau van de eerste submap. Als u een JavaScript-bestand toevoegt aan een submap voor macro's, verschijnt de naam van het bestand onder de opdracht Macro's van het menu Opties. Als u een andere naam dan de JavaScript-bestandsnaam wilt weergeven, kunt u een XML-configuratiebestand maken met de naam macro.xml om de naam te wijzigen.

Macro's lokaliseren

U maakt een submappenstructuur in de installatiemap van Designer voor de JavaScript-bestanden die zijn gekoppeld aan macro's. Als u de macro's lokaliseert, moet u de submappenstructuur hieraan aanpassen.

Als het niet nodig is om macro's te lokaliseren, bijvoorbeeld omdat ze voor alle talen hetzelfde zijn, maakt u de submap 'macros' in de installatiemap van Designer. Bijvoorbeeld: c:\program files\Adobe\Designer\macros\. Maak vervolgens een of meer submappen in de submap 'macros' voor de JavaScript-bestanden die u wilt uitvoeren. U kunt één submap maken voor alle JavaScript-bestanden of een aparte submap maken voor elk JavaScript-bestand. Designer laadt de JavaScript-bestanden in deze submappen, ongeacht de taal die is geselecteerd in de keuzelijst Landinstelling formulier (dialoogvenster Formuliereigenschappen > deelvenster Standaardwaarden).

Als u macro's moet lokaliseren omdat ze taalspecifiek zijn, maakt u voor elke landinstelling een submap in de installatiemap van Designer. Vervolgens maakt u submappen voor de macro's in de submap van elke landinstelling, en daarna maakt u één of meer submappen in de taalspecifieke submap voor de JavaScript-bestanden. Bijvoorbeeld: c:\program files\Adobe\Designer\NL\macros\. Designer laadt de JavaScript-bestanden in deze mappen op basis van de toepassingstaal van Designer.

Logboekbestand met macro's

Als u niet weet welke macro's Designer laadt, kunt u dit controleren in het logboekbestand met macro's.

Designer maakt het logboekbestand MacrosLog.log in de map met toepassingsgegevens van Designer: C:\Documents and Settings\<gebruikersnaam>\Application Data\Adobe\Designer\<Designer versienummer>.

Het bestand bevat een overzicht van de macro's die zijn geladen in Designer.