Macros

Las macros proporcionan una interfaz de complemento externo, para ampliar la funcionalidad de Designer. Por ejemplo, puede ejecutar una macro para cambiar el nombre de un campo y actualizar todas las referencias de secuencias de comandos asociadas, o para encontrar las secuencias de comandos que consten sólo de comentarios.

Nota: sólo debe ejecutar una macro si confía en el autor de la secuencia de comandos.

Una macro es un archivo JavaScript (JS). Los archivos JavaScript se crean en un editor de JavaScript y las secuencias de comandos se ejecutan en Designer. El código JavaScript de la macro tiene acceso total al modelo de plantilla. Además del DOM de plantilla, hay un objeto en el espacio de nombres raíz denominado designer. El objeto designer proporciona métodos que puede utilizar para comunicarse directamente con Designer. Por ejemplo, un método le permite iniciar un cuadro de diálogo SWF e intercambiar cadenas con él, lo que le permite crear una interfaz de usuario personalizada.

Para obtener más información sobre métodos de secuencias de comandos disponibles, consulte la Referencia de secuencias de comandos.

Para configurar macros para utilizarlas en Designer, cree una estructura de subcarpetas de archivos JavaScript en la carpeta de instalación de designer, y ejecute los archivos JavaScript desde el menú Macros (Herramientas > Macros).

Configurar macros para utilizarlas en Designer

  1. Realice alguna de las siguientes acciones:

    • Para macros comunes (todos los idiomas), en la carpeta de instalación de Designer, cree una subcarpeta llamada macros. Por ejemplo, <carpeta de instalación de Designer>\macros.

    • Para macros específicas del idioma, en la carpeta de instalación de Designer, cree una subcarpeta para cada idioma (configuración regional), y a continuación, cree una carpeta macros en cada carpeta de configuración regional. Por ejemplo, macros <carpeta de instalación de Designer>\ES\macros.

  2. En cada carpeta macros, cree una o varias subcarpetas para JavaScript (JS) y archivos macro.xml.

  3. Guarde los archivos JavaScript y macro.xml en las subcarpetas correspondientes. Coloque los archivos SWF utilizados por los archivos JavaScript de macro en la misma subcarpeta.

  4. En Designer, haga clic en Herramientas > Macros. Las macros (comunes y específicas del idioma) se enumeran en el menú Macros.

Acerca de los archivos de configuración macro.xml

Puede crear un archivo de configuración macro.xml para cambiar el nombre del comando que aparece en el menú Macros en cada archivo JavaScript de una subcarpeta. Añada un archivo macro.xml a cada subcarpeta que contenga uno o varios archivos JavaScript.

Observe la etiqueta y las etiquetas de secuencia de comandos en el siguiente ejemplo de archivo macro.xml. La etiqueta incluye el nombre del comando (Combinar) que aparece en el menú Macros. La etiqueta de secuencia de comandos incluye el nombre del archivo JavaScript asociado (mergenodes.js).

Ejemplo de archivo macro.xml:

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

El uso de archivos de configuración macro.xml es opcional. Cuando Designer actualiza la lista de macros, busca archivos macro.xml en la subcarpeta macros. Si Designer no encuentra ningún archivo macro.xml en una subcarpeta, los nombres de los archivos JavaScript aparecen en el menú Macros.

Organización de la subcarpeta macros

Cree al menos una subcarpeta en la carpeta macros para que contenga los archivos JavaScript. Si guarda los archivos JavaScript directamente en la carpeta macros, estos no aparecen en el menú Macros de Designer.

Puede organizar las subcarpetas macros de diferentes maneras. El método que elija dependerá de sus necesidades. Tenga en cuenta el número de archivos JavaScript que tiene, el número de archivos macro.xml que se va a crear, y el orden de los comandos en el menú Macros.

Una forma de organizar las subcarpetas macros consiste en guardar todos los archivos JavaScript en una subcarpeta. De esta manera, puede utilizar un archivo macro.xml para especificar los nombres de todos los archivos JavaScript de la carpeta y los nombres de los comandos del menú Macros asociados. El orden de los comandos del menú Macros, es el mismo que el orden de macros mostrado en el archivo macro.xml.

Ejemplo de archivo macro.xml que contiene varias macros:

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

Otra forma de organizar las subcarpetas macros es guardar archivos JavaScript en subcarpetas independientes. Utilice un archivo macro.xml en cada subcarpeta para especificar el nombre de los archivos JavaScript y asigne un nombre a los comandos del menú Macros relacionados. El orden de los comandos en el menú Macros, es el mismo que el de las subcarpetas y las macros enumeradas en cada archivo macro.xml.

Tenga en cuenta que todas las subcarpetas que cree para los archivos JavaScript deben ser un elemento secundario de la carpeta macros principal (macros\MyMacros). Designer no explora subcarpetas que están por debajo del nivel de la primera subcarpeta. Una vez que añada un archivo JavaScript a una subcarpeta macros, el nombre del archivo aparece en el comando Macros del menú Herramientas. Si desea mostrar un nombre que no sea el nombre del archivo JavaScript, puede crear un archivo de configuración XML denominado macro.xml para cambiar el nombre.

Localización de macros

Puede crear una estructura de subcarpetas en la carpeta de instalación de Designer para los archivos JavaScript asociados con las macros. La estructura de subcarpetas que cree depende de si se van a localizar macros o no.

Si no necesita localizar macros, ya que son comunes a todos los idiomas, cree una subcarpeta llamada macros en la carpeta de instalación de Designer. Por ejemplo, c:\Archivos de programa\Adobe\Designer\macros\. A continuación, puede crear una o varias subcarpetas en la subcarpeta macros para los archivos JavaScript que desee ejecutar. Puede crear una subcarpeta para todos los archivos JavaScript o crear una subcarpeta independiente para cada archivo JavaScript. Designer carga los archivos JavaScript en estas subcarpetas, independientemente de la opción de configuración regional seleccionada en la lista Configuración regional (cuadro de diálogo Propiedades del formulario > panel Predeterminados).

Si necesita localizar macros porque son específicas de la configuración regional (idioma), cree una subcarpeta en la carpeta de instalación de Designer para cada configuración regional. A continuación, cree una subcarpeta macros en cada subcarpeta configuración regional, y cree una o varias subcarpetas en la subcarpeta configuración regional para los archivos Javascript. Por ejemplo: c:\Archivos de programa\Adobe\Designer\ES\macros\. Designer carga los archivos JavaScript en estas carpetas según el idioma de la aplicación de Designer.

Registro de macros

Si no está seguro de qué macros carga Designer, puede consultar el archivo de registro de macros.

Designer crea un archivo de registro llamado MacrosLog.log en la carpeta de datos de aplicaciones de Designer en: C:\Documents and Settings\<nombre de usuario>\Application Data\Adobe\Designer\<número de versión de Designer>.

El archivo MacrosLog.log enumera las macros cargadas en Designer.