Macros

As macros fornecem uma interface de plug-in externo, para estender a funcionalidade do Designer. Por exemplo, você pode executar uma macro para renomear um campo e atualizar todas as referências de scripts associadas ou localizar scripts que consistam totalmente em comentários.

Nota: Você somente deve executar a macro se confiar no autor do script.

Uma macro é um arquivo JavaScript (JS). Você cria arquivos JavaScript em um editor JavaScript e executa os scripts no Designer. O JavaScript na macro tem total acesso ao modelo de modelo. Além do DOM de modelo, há um objeto no espaço de nome raiz denominado designer. O objeto do designer fornece métodos que você pode usar para se comunicar diretamente com o Designer. Por exemplo, um método permite que você inicie uma caixa de diálogo do SWF e troque strings com ele, o que permite que você crie uma interface de usuário personalizada.

Para obter mais informações sobre métodos de scripts disponíveis, consulte a Referência de scripts

Para configurar macros para uso no Designer, crie uma estrutura de subpasta para arquivos JavaScript na pasta de instalação do Designer e execute os arquivos JavaScript no menu Macros (Ferramentas > Macros).

Configuração de macros para usar no Designer

  1. Conclua uma destas ações:

    • Para macros comuns (todos os idiomas), na pasta de instalação do Designer, crie uma subpasta denominada macros. Por exemplo, <DesignerInstallationFolder>\macros.

    • Para macros específicas por idioma, na pasta de instalação do Designer, crie uma subpasta para cada idioma (localidade) e então crie uma pasta de macros na pasta de cada localidade. Por exemplo, <DesignerInstallationFolder>\EN\macros.

  2. Em cada pasta de macros, crie uma ou mais subpastas para arquivos JavaScript (JS) e macro.xml.

  3. Salve os arquivos JavaScript e macro.xml nas subpastas apropriadas. Coloque todo arquivo SWF usado pelos arquivos JavaScript da macro na mesma subpasta.

  4. No Designer, clique em Ferramentas > Macros. As macros (comuns e específicas por idioma) são relacionadas no menu Macros.

Sobre arquivos de configuração macro.xml

Crie um arquivo de configuração macro.xml para renomear o comando exibido no menu Macros para cada arquivo JavaScript em uma subpasta. Adicione um arquivo macro.xml a cada subpasta contendo um ou mais arquivos JavaScript.

Observe as marcas de rótulo e script no arquivo macro.xml de exemplo a seguir. A marca de rótulo delimita o nome do comando (Merge) exibido no menu Macros. A marca de script delimita o nome do arquivo JavaScript associado (mergenodes.js).

Exemplo de arquivo 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>

O uso de arquivos de configuração macro.xml é opcional. Quando o Designer atualiza a lista de macros, ele pesquisa arquivos macro.xml nas subpastas de macros. Se o Designer não localizar um arquivo macro.xml em uma subpasta, os nomes dos arquivos JavaScript serão exibidos no menu Macros.

Organização da subpasta de macros

Crie, pelo menos, uma subpasta na pasta de macros para conter seus arquivos JavaScript. Se você salvar arquivos JavaScript diretamente na pasta de macros, eles não serão exibidos no menu Macros no Designer.

Você pode organizar as subpastas de macros de maneiras diferentes. O método que você escolher dependerá de suas necessidades. Considere o número de arquivos JavaScript que você tem, o número de arquivos macro.xml a serem criados e a ordem de comandos no menu Macros.

Uma forma de organizar as subpastas de macros é salvar todos os arquivos JavaScript em uma subpasta. Dessa maneira, você pode usar um arquivo macro.xml para especificar os nomes de todos os arquivos JavaScript na pasta e nomear os comandos do menu Macros associados. A ordem dos comandos no menu Macros é a mesma ordem de macros relacionadas no arquivo macro.xml.

Exemplo de arquivo macro.xml contendo várias 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>

Outra forma de organizar as subpastas de macros é salvar arquivos JavaScript em subpastas separadas. Use um arquivo macro.xml em cada subpasta para especificar o nome dos arquivos JavaScript, e nomear os comandos relacionados do menu Macros. A ordem dos comandos no menu Macros é a mesma ordem de subpastas e macros relacionadas no arquivo macro.xml.

Lembre-se de que todas as subpastas que você criar para arquivos JavaScript devem ser um filho da pasta pai de macros (macros\MyMacros). O Designer não verifica subpastas abaixo do nível da primeira subpasta. Depois que você adicionar um arquivo JavaScript a uma subpasta de macros, o nome do arquivo será exibido sob o comando Macros no menu Ferramentas. Se você quiser exibir um nome que não seja o nome de arquivo JavaScript, você poderá criar um arquivo de configuração XML denominado macro.xml para alterar o nome.

Localização de macros

Crie uma estrutura de subpastas na pasta de instalação do Designer para os arquivos JavaScript associados a macros. A estrutura de subpastas que você criar dependerá se você pretende ou não localizar macros.

Se você não precisar localizar macros, em virtude de serem comuns para todos os idiomas, crie uma subpasta nomeada macros na pasta de instalação do Designer. Por exemplo, c:\program files\Adobe\Designer\macros\. Em seguida, crie uma ou mais subpastas na subpasta de macros para os arquivos JavaScript que deseja executar. Você pode criar uma subpasta para todos os arquivos JavaScript ou criar uma subpasta separada para cada arquivo JavaScript. O Designer carrega os arquivos JavaScript nessas subpastas, independentemente da opção de localidade selecionada na lista Local dos formulários (caixa de diálogo Propriedades do formulário> painel Padrões).

Se você precisar localizar macros, em virtude de elas serem específicas por localidade (idioma), crie uma subpasta na pasta de instalação do Designer para cada localidade. Em seguida, crie uma subpasta de macro em cada subpasta de localidade e crie uma ou mais subpastas na subpasta de localidade para os arquivos Javascript. Por exemplo: c:\program files\Adobe\Designer\EN\macros\. O Designer carrega os arquivos JavaScript nessas pastas com base no idioma do aplicativo do Designer.

Registro de macros

Se você não estiver certo de quais macros o Designer está carregando, você poderá verificar o arquivo de log de macros.

O Designer cria um arquivo de log denominado MacrosLog.log na pasta de dados do aplicativo do Designer localizada aqui: C:\Documents and Settings\<nome do usuário>\Application Data\Adobe\Designer\<número de versão do Designer>.

O arquivo MacrosLog.log relaciona as macros carregadas no Designer.