Adição de itens personalizados ao menu principal do Analytics

Você pode adicionar itens personalizados como seus próprios scripts do Analytics, bem como comandos usados com frequência, ao menu principal do Analytics. Os itens personalizados aparecem no menu Aplicativos. Esse recurso é particularmente útil na criação de scripts que serão usados por outras pessoas e você quer ter um único local fácil de usar para acessar os scripts.

Acesso por projeto ou global

Você pode criar itens de menu personalizados que são restritos a projetos do Analytics individuais, ou disponibilizar os itens globalmente, sempre que o Analytics for aberto.

• acesso por projeto coloque o arquivo de texto (*.mnu) que contém os itens de menu personalizados na mesma pasta do projeto do Analytics (*.acl)
• acesso global coloque o arquivo de texto (*.mnu) que contém os itens de menu personalizados na mesma pasta do executável do Analytics (ACLWin.exe)

Você também pode combinar abordagens e criar itens de menu personalizados por projeto e globais.

O arquivo de menu configurável (*.mnu)

Use um ou mais arquivos de texto com uma extensão de arquivo .mnu para criar itens de menu personalizados.

Entradas de submenu

Cada arquivo *.mnu cria uma entrada de submenu separada no menu Aplicativos. Por exemplo, Scripts de contabilidade.mnu cria a entrada de submenu Scripts de contabilidade e esta estrutura de menu: Aplicativos > Scripts de contabilidade.

As entradas de submenu aparecem em ordem alfanumérica no menu Aplicativos.

Itens do menu personalizados

Cada entrada de submenu contém os itens do menu personalizado individuais. Por exemplo, você pode ter dois itens que executam os seguintes scripts:

• Análise de contas a pagar

  (Aplicativos > Scripts de contabilidade > Análise de contas a pagar)

• Análise de contas a receber

  (Aplicativos > Scripts de contabilidade > Análise de contas a receber)

Os itens do menu personalizados aparecem em submenus na ordem em que estão relacionados no arquivo *.mnu.

Usando um ou mais arquivos *.mnu, você pode criar submenus em cascata e de vários níveis de acordo com os seus requisitos.

Número máximo de Itens do menu personalizados

O menu Aplicativos pode conter no máximo 179 itens do menu personalizados. O máximo se aplica ao número total de itens do menu personalizados em todos os níveis de submenu e em todos os arquivos *.mnu.

Sintaxe do arquivo de menu

Um arquivo de amostra de menu Modelo.mnu, está incluído na pasta Arquivos de dados da amostra, instalada com o Analytics.

• Modelo.mnu cria a entrada de submenu Modelo no menu Aplicativos em Sample Project.acl e nos outros três projetos do Analytics de amostra contidos na pasta Arquivos de dados da amostra.
• A entrada de submenu Modelo contém seis itens de menu personalizados no primeiro nível.
• Um dos itens do menu personalizados no primeiro nível, Análise de margem, contém quatro itens de menu personalizados no segundo nível.
• A maioria dos itens do menu personalizados em Modelo.mnu são simplesmente espaços reservados para demonstrar o conceito dos arquivos de menu.

O conteúdo de Modelo.mnu é mostrado a seguir, juntamente com os seus requisitos de sintaxe.

Conteúdo de Modelo.mnu

MENU PRINCIPAL                        6                                                   .
Análise de margens                    8 menu_def                                          .
Análise de inventário                 PAUSE 'AMOSTRA DE LOTE DE ANÁLISE DE INVENTÁRIO'    .
Análise de Contas a Pagar             PAUSE 'INICIE SEU(S) LOTE(S) DE C/P'                .
Análise de Contas a Receber           PAUSE 'FAÇA LOTE(S) DE C/R AQUI'                    .
Funções de auditoria interna          PAUSE 'AMOSTRAS DE PROCESSOS DE AUDITORIA INTERNA'  .
Sair do ACL                           QUIT                                                .
                                                                             
ANÁLISES DE MARGENS                   4                                                   .
Lista de exceção                      PAUSE 'DO Lote  where margem<=0'                    .
Produtos com altas margens            PAUSE 'Amostra de lote de 5 maiores margens'        .
Produtos com baixas margens           PAUSE 'Calcular 5 menores margens'                  .
Estatísticas de margens               STATISTICS                                          .

Requisitos de sintaxe do arquivo de menu

Propriedade	Requisitos
Comprimento de linha	Todas as linhas do arquivo de menu devem ter exatamente o mesmo comprimento. Embora não obrigatória, é uma prática recomendada usar um ponto (.) para marcar visualmente o fim da linha, logo antes do retorno de carro.
Numeração das linhas	As linhas no arquivo de menu são contadas a partir do zero (0). Lembre-se desse esquema de numeração sempre que especificar referências de número de linha na sintaxe do arquivo de menu. Se o editor de texto usado exibe e conta números de linha a partir de 1, você precisa subtrair 1 do número de linha do editor de texto ao especificar referências de número de linha do arquivo de menu. No exemplo acima, o item de menu Análise de margens aparece na linha 1, e o bloco de sintaxe do submenu ANÁLISE DE MARGENS aparece nas linhas 8 a 12.
Linhas em branco	Linhas em branco podem aparecer entre blocos de sintaxe, mas não dentro deles. As linhas em branco, compostas de caracteres de espaço, devem ter o mesmo comprimento das outras linhas no arquivo do menu. Embora não obrigatórias, uma ou mais linhas em branco entre os blocos de sintaxe oferecem uma separação visual no arquivo do menu.
Blocos de sintaxe	Blocos de sintaxe definem cada grupo de itens do menu personalizados. Você pode usar vários blocos de sintaxe para criar vários níveis de menu. O lado esquerdo do bloco contém os nomes dos itens menu, um por linha. Esses são os nomes exibidos no menu no Analytics. Os nomes podem ter no máximo 35 caracteres. O lado direito do bloco contém um comando do ACLScript ou uma referência de linha para um bloco de sintaxe de nível inferior. As linhas no lado direito do bloco devem todas começar na posição de caractere 37. Use somente caracteres de espaço para alinhar elementos de texto. Não use caracteres de tabulação. Nota A presença de um único caractere de tabulação em um arquivo de menu fará com que o arquivo seja ignorado. Use um editor de texto que possa exibir caracteres de tabulação, o que permite que você verifique sua presença.
Cabeçalhos de blocos	Cada bloco de sintaxe começa com uma única linha de cabeçalho. O lado esquerdo da linha contém o identificador do bloco em maiúsculas e o lado direito contém o número de linhas no bloco. No exemplo acima, a linha 0 contém o identificador do bloco MENU PRINCIPAL e especifica que há 6 linhas no bloco. A linha de cabeçalho não é contada. Os identificadores de bloco são opcionais. Esses identificadores mantêm os blocos de sintaxe organizados dentro do arquivo de menu. Eles não são exibidos em nenhum lugar na estrutura do menu Aplicativos do Analytics. Mesmo se você omitir um identificador de bloco, o número especificado de linhas no bloco deve iniciar na posição de caractere 37.
Referência a um bloco de sintaxe de nível inferior	Uma referência de um item de menu a um bloco de sintaxe de nível inferior tem o formato núm def_menu. núm especifica o número da linha em que o bloco de sintaxe de nível inferior começa, ou seja, a linha de cabeçalho do bloco de sintaxe de nível inferior. No exemplo acima, a linha 1 contém o item de menu Análise de margens, que faz referência à linha em que o bloco de sintaxe de nível interior ANÁLISE DE MARGENS começa (8 def_menu).
Itens do menu personalizados	Os itens do menu personalizados podem especificar: qualquer comando de script válido do ACL uma referência de linha a um bloco de sintaxe de nível inferior Para criar um item de menu personalizado que executa um script do Analytics, especifique DO SCRIPT nome_do_script. Por exemplo: Script Calcular valor da mediana DO SCRIPT Calcular_Valor_Mediana Nota O script deve estar incluído no projeto do Analytics no qual o item do menu personalizado é exibido. Os comandos curtos podem ser inseridos diretamente no arquivo .mnu. Os comandos maiores com vários parâmetros devem ser salvos em um script, que pode ser referenciado usando o comando DO SCRIPT.

Criar ou editar um arquivo de menu

A forma mais fácil de criar um arquivo de menu é copiar o exemplo de arquivo de menu do Analytics (Template.mnu) e modificá-lo.

Considere os pontos a seguir ao editar um arquivo de menu que já está sendo usado:

• Antes de editar um arquivo de menu, faça uma cópia de backup.
• Se você adicionar ou remover linhas, não deixe de ajustar adequadamente todas as referências ao número de linha.
• Sempre que possível, adicione novos itens ao final do arquivo de menu para preservar as referências de linha existentes.

1. Copie Modelo.mnu da pasta Arquivos de dados da amostra do Analytics para um local de trabalho.

   Cuidado

   Não edite o arquivo de modelo original. Se ocorrer algum problema, você pode copiar novamente o arquivo original e reiniciar o processo.

2. Renomeie o arquivo copiado com um nome adequado.

   O nome atribuído ao arquivo torna-se o nome da entrada de submenu no menu Aplicativos do Analytics.

   Nota

   Se você está criando um arquivo de menu do zero, altere a extensão do arquivo para .mnu.

3. Abra o arquivo renomeado em um editor de texto como Notepad++ e edite-o para criar submenus e itens do menu personalizados.

   Siga rigorosamente Requisitos de sintaxe do arquivo de menu acima.

4. Execute uma das seguintes ações:
   • Salve o arquivo na pasta que contém o projeto do Analytics nos quais você quer que os itens de menu personalizados sejam exibidos.
   • Salve o arquivo na pasta que contém o executável do Analytics para que os itens do menu personalizados fiquem disponíveis para todos os projetos do Analytics abertos no computador.

   Dica

   Você pode criar arquivos de menu por projeto ou globais, se necessário.

5. Feche e abra novamente o Analytics para atualizar o menu Aplicativos.

   A entrada do submenu e os itens do menu personalizados devem agora estar disponíveis no menu Aplicativos menu.

   Se o submenu e os itens do menu personalizados não aparecerem, verifique cuidadosamente o conteúdo do arquivo do menu em relação aos requisitos de sintaxe acima. Torne todos os caracteres não imprimíveis visíveis no editor de texto que está usando. Um espaço extra no fim de uma linha, ou um caractere de tabulação em qualquer lugar no arquivo do menu, faz com que o arquivo seja ignorado.