È necessario creare almeno una sottocartella all'interno della cartella delle macro per inserire i file JavaScript. Se si salvano i file JavaScript direttamente nella cartella delle macro, questi non vengono visualizzati nel menu Macros di Designer.
La cartella delle macro può essere organizzata in diversi modi. Il metodo prescelto deve essere stabilito in base alle esigenze. Considerare il numero di file JavaScript di cui si dispone, il numero di file macro.xml da creare e il numero di comandi del menu Macros.
Un modo per organizzare le sottocartelle delle macro consiste nel salvare tutti i file JavaScript in un'unica sottocartella. In questo modo sarà possibile utilizzare un file macro.xml per specificare tutti i nomi di file JavaScript presenti nella cartella e i nomi dei comandi di menu del menu Macros associati. L'ordine dei comandi nel menu Macros corrisponde all'ordine delle macro elencate nel file macro.xml.
Esempio di un file macro.xml contenente più macro:
<?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>
Un altro modo in cui è possibile organizzare le macro nelle sottocartelle consiste nel salvare i file JavaScript in sottocartelle separate. È possibile utilizzare un file macro.xml in ciascuna sottocartella per specificare il nome dei file JavaScript e il nome dei comandi del menu Macros correlati. L'ordine dei comandi nel menu Macros corrisponde all'ordine delle sottocartelle e delle macro elencate nel file macro.xml.
Tenere presente che tutte le sottocartelle create per i file JavaScript devono essere cartelle figlie della cartella padre (macros\MyMacros). Designer non esegue la scansione delle sottocartelle collocate sotto al livello della prima sottocartella. Dopo aver aggiunto un file JavaScript a una sottocartella delle macro, il nome del file viene visualizzato sotto al comando Macros all'interno del menu Strumenti. Se si desidera visualizzare un nome diverso dal nome del file JavaScript, è possibile creare un file di configurazione XML denominato macro.xml per modificare il nome.
