Makron

Med makron kan du ansluta ett externt gränssnitt, som utökar funktionaliteten i Designer. Du kan t.ex. köra ett makro för att byta namn på ett fält och uppdatera alla tillhörande skriptreferenser eller för att leta reda på skript som enbart består av kommentarer.

Obs! Du bör endast köra ett makro om du litar på den som skrivit det.

Ett makro är en JavaScript-fil (JS). Du skapar JavaScript-filer in en JavaScript-redigerare och kör skripten i Designer. JavaScript i makrot har full tillgång till mallmodellen. Förutom DOM-mallen finns det ett objekt i rotens namnområde som heter designer. Designerobjektet erbjuder metoder som du kan använda för att kommunicera direkt med Designer. Du kan t.ex. använda en metod för att öppna en SWF-dialogruta och utbyta strängar med hjälp av den, så att du kan skapa ett eget gränssnitt.

Mer information om tillgängliga skriptmetoder finns i Skriptreferens.

Om du vill ställa in makron för användning i Designer kan du skapa en undermappstruktur för JavaScript-filer i installationsmappen för Designer och köra JavaScript-filer från menyn Makron (Verktyg > Makron).

Så här konfigurerar du makron för Designer

  1. Gör något av följande:

    • Skapa en undermapp som heter makron för alla vanliga makron (alla språk) i installationsmappen för Designer. Exempel: <Installationsmapp för Designer>\macros.

    • För språkspecifika makron skapar du en undermapp för respektive språk (nationell inställning) i installationsmappen för Designer och skapar sedan en makromapp i respektive nationella inställningsmapp. Exempel: <Installationsmapp för Designer>\SV\macros.

  2. Skapa en eller flera undermappar för JavaScript- (JS) och macro.xml-filer i respektive makromapp.

  3. Spara JavaScript- och macro.xml-filer i lämpliga undermappar. Placera de SWF-filer som eventuellt används av JavaScript-filerna i samma undermapp.

  4. Klicka på Arkiv > Makron i Designer. Makrona (vanliga och språkspecifika) listas på menyn Makron.

Om macro.xml-konfigurationsfiler

Du skapar en macro.xml-konfigurationsfil för att byta namn på kommandot som visas på menyn Makron för respektive JavaScript-fil i en undermapp Du lägger till en macro.xml-fil i varje undermapp som innehåller en eller flera JavaScript-filer.

Observera etikett- och skripttaggarna i följande macro.xml-exempelfil: Etikettaggen omger namnet på kommandot (Sammanfoga) som visas på menyn Makron. Skripttaggen omger namnet på den tillhörande JavaScript-filen (mergenodes.js).

Exempel på macro.xml-fil:

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

Det är valfritt att använda macro.xml-konfigurationsfiler. När Designer uppdaterar listan med makron söks makroundermapparna igenom efter macro.xml-filer. Om Designer inte hittar någon macro.xml-fil i en undermapp visas namnen på JavaScript-filerna på menyn Makron.

Organisera makroundermappen

Skapa minst en undermapp under makromappen för dina JavaScript-filer. Om du sparar JavaScript-filer direkt i makromappen visas de inte på menyn Makron i Designer.

Du kan organisera makroundermapparna på olika sätt. Vilken metod du väljer beror på dina behov. Fundera på hur många JavaScript-filer du har, hur många macro.xml-filer som du ska skapa och kommandonas ordning på menyn Makron.

Du kan organisera makroundermapparna genom att spara alla JavaScript-filer i en undermapp. På så vis kan du använda en macro.xml-fil för att ange namnen på alla JavaScript-filer i mappen, och namnen på de tillhörande kommandona på menyn Makron. Kommandona på menyn Makron visas i samma ordning som makrona listas i macro.xml-filen.

Exempel på en macro.xml-fil som innehåller flera makron:

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

Ett annat sätt att organisera makroundermapparna är att spara JavaScript-filerna i olika undermappar. Du använder en macro.xml-fil i varje undermapp för att ange namnet på JavaScript-filerna, och namnge de relaterade kommandona på menyn Makron. Kommandona på menyn Makron visas i samma ordning som undermapparna och makrona listas i respektive macro.xml-fil.

Tänk på att alla undermappar som du skapar för JavaScript-filer måste vara underordnade till den överordnade makromappen (macros\MyMacros). Designer skannar inte undermappar under den första undermappsnivån. När du har lagt till en JavaScript-fil i en makroundermapp så visas namnet på filen under kommandot Makron på Verktyg-menyn. Om du vill visa ett annat namn än JavaScript-filnamnet, så kan du skapa en XML-konfigurationsfil som heter macro.xml för att ändra namnet.

Lokalisera makron

Du skapar en undermappsstruktur i installationsmappen för Designer för de JavaScript-filer som är kopplade till makron. Den undermappsstruktur som du skapar är beroende av om du tänker lokalisera makrona eller inte.

Om du inte behöver lokalisera makron eftersom de är gemensamma för alla språk, så skapar du en undermapp som heter makron i installationsmappen för Designer. Exempel: c:\program files\Adobe\Designer\macros\. Sedan skapar du en eller flera undermappar i makroundermappen för de JavaScript-filer som du vill köra. Du kan skapa en undermapp för alla JavaScript-filer eller skapa en separat undermapp för varje JavaScript-fil. Designer laddar JavaScript-filerna i dessa undermappar, oavsett vilket alternativ som valts i listan med nationella inställningar (dialogrutan Formuläregenskaper > Standardvärden).

Om du behöver lokalisera makron eftersom de innehåller specifika nationella inställningar (språk) så skapar du en undermapp i installationsmappen för Designern för varje språkområde. Sedan skapar du en makroundermapp i varje undermapp för nationella inställningar och skapar en eller flera undermappar i undermappen för nationella inställningar för JavaScript-filer. Exempel: c:\program files\Adobe\Designer\SV\macros\. Designer laddar JavaScript-filer i dessa mappar baserat på Designers tillämpningsspråk.

Logga makron

Om du är osäker på vilka makron Designer laddar kan du kontrollera makrologgfilen.

Designer skapar en loggfil som heter MacrosLog.log i programdatamappen i Designer som finns här: C:\Documents and Settings\<användarnamn>\Application Data\Adobe\Designer\<Designer-versionsnummer>.

I filen MacrosLog.log listas de makron som laddas i Designer.