Criação e edição de scripts

Você tem várias opções para criar scripts:

  • Editor de script digite sintaxe de script na janela Editor de script
  • Log de comandos copie sintaxe de script do log de comandos
  • Gravador de script grave a sintaxe dos comandos à medida que os executa
  • Captura de sintaxe insira a sintaxe dos comandos à medida que os seleciona na interface do usuário, sem executá-los
  • Histórico da tabela copie sintaxe de scripts do histórico de uma tabela de saída

Você pode usar essas opções em combinação. Por exemplo, você pode iniciar um script copiando a sintaxe do log de comandos e adicionar mais linhas de sintaxe diretamente na janela Editor de script.

Para editar um script existente no Analytics, você deve usar o Editor de script.

Você também pode usar um editor de texto à sua escolha, e copiar e colar a sintaxe em um script do Analytics.

Preenchimento automático de sintaxe

À medida que você digita a sintaxe no Editor de script, o Analytics preenche automaticamente comandos e palavras-chave do ACLScript, além de oferecer ajuda automática na tela para os parâmetros das funções.

Você pode desativar o preenchimento automático selecionando Desativar preenchimento automático em scripts na guia Interface na caixa de diálogo Opções (Ferramentas > Opções). Não é possível desativar a ajuda na tela para os parâmetros de funções.

Importar scripts ou snippets do ScriptHub

Outra opção para criar scripts é usar o conteúdo do ScriptHub. O ScriptHub é uma biblioteca baseada na web de itens de scripts do Analytics desenvolvida pelos funcionários e pela comunidade de usuários da Diligent. Como parte da sua assinatura, você pode fazer download e usar qualquer conteúdo do ScriptHub.

Para obter mais informações, consulte Importação do ScriptHub.

Criar ou editar um script no Editor de script

Você pode criar ou editar scripts digitando a sintaxe do ACLScript necessária diretamente no Editor de Script ou usando um dos outros métodos oferecidos para inserção de sintaxe.

Nota

Quando você cria ou edita um script, deve garantir que cada comando do ACLScript seja inserido em uma linha separada.

Criar ou editar o script

  1. Execute um dos seguintes passos para abrir o script no Editor de script:
    • Para criar um novo script, selecione Arquivo > Novo> Script.

      O script é criado com o nome Novo_Script. Clique com o botão direito do mouse e selecione Renomear para renomear o script.

      Nota

      Os nomes de script são limitados a 64 caracteres alfanuméricos. O nome pode incluir o caractere de sublinhado ( _ ) mas nenhum outro caractere especial e nenhum espaço. O nome não pode começar com um número.

    • Para abrir um script existente, clique duas vezes no script na guia Visão geral no Navegador.
  2. Adicione, modifique ou exclua sintaxe do ACLScript no Editor de script.

    Dica

    Você pode usar essas teclas de atalho para ações comuns:

    • Ctrl+Z desfazer uma ou mais ações
    • Ctrl+Y refazer uma ou mais ações
    • Ctrl+S salva o projeto do Analytics, incluindo o script aberto
  3. (Opcional) Posicione o cursor em um local adequado no script e conclua uma das seguintes etapas para inserir um ou mais itens específicos:
    Etapasdo item

    Nome do item do projeto

    (tabela, script, exibição, área de trabalho ou índice)

    1. Clique com o botão direito do mouse e selecione Inserir > Item de projeto.
    2. Selecione o tipo de item na lista suspensa Tipo de item.
    3. Selecione um ou mais nomes de item e clique em OK.
    Nome do campo
    1. Na barra de ferramentas do Editor de script, clique em Inserir campo .
    2. Selecione um ou mais nomes de campos e clique em OK.
    Expressão
    1. Na barra de ferramentas do Editor de script, clique em Inserir Expressão .
    2. Crie uma expressão e clique em OK.
    Caixa de diálogo
    1. Na barra de ferramentas do Editor de script, clique em Construir Novo Diálogo .
    2. Crie uma caixa de diálogo personalizada, clique em Fechar, e clique em OK.

    Para obter mais informações, consulte Criar caixas de diálogo personalizadas.

    Data e hora
    1. Clique com o botão direito do mouse e selecione Inserir > Data e hora.
    2. Insira ou selecione uma data, datahora ou hora e clique em OK.
    Token do Diligent One

    Para obter mais informações, consulte Adquira um token de acesso do HighBond.

  4. Selecione Arquivo > Salvar projeto.
  5. Clique em Sim na caixa de diálogo de confirmação.

Editar sintaxe de comando usando uma caixa de diálogo

Em vez de editar manualmente comandos em um script, você pode editá-los usando a caixa de diálogo associada.

Nota

Esse método somente está disponível para comandos que têm caixas de diálogo.

  1. Selecione um comando em um ACLScript existente.
  2. Na barra de ferramentas do Editor de script, clique em Editar comando .

    A caixa de diálogo do comando é exibida.

  3. Na caixa de diálogo, faça as alterações necessárias nos parâmetros do comando e clique em OK.

    A sintaxe do script é atualizada.

Testar o script

Se você deseja testar o script ao executá-lo integralmente ou passo a passo, clique em Executar  ou em Passo  na barra de ferramentas do Editor de script.

Nota

Ao executar um script integralmente ou passo a passo, todos os scripts atualmente abertos são automaticamente salvos.

Criar um script na linha de comando

Você pode copiar as entradas do log na guia Log no Navegador como ponto de partida para criar um novo script ou adicioná-las a um script existente. A sintaxe de cada comando executado anteriormente no Analytics é gravada no log como uma entrada de log individual.

Você pode selecionar os seguintes tipos de entradas e copiá-los para um script novo ou existente:

  • entradas individuais
  • uma série de entradas associadas a uma tabela
  • grupos maiores de entradas associadas a uma sessão ou a um período
  1. No Navegador, clique na guia Log para exibir o log.
  2. Selecione a entrada do log ou o grupo de entradas que você quer incluir no script.

    Se você selecionar itens de nível superior na exibição em árvore, as subentradas serão automaticamente selecionadas.

  3. Execute uma das seguintes ações:
    Criar um novo script
    1. Clique com o botão direito do mouse na exibição em árvore do Log e selecione Salvar itens selecionados > Script.
    2. Na caixa de diálogo Salvar script como, insira um nome para o novo script e clique em OK.

      Nota

      Os nomes de script são limitados a 64 caracteres alfanuméricos. O nome pode incluir o caractere de sublinhado ( _ ) mas nenhum outro caractere especial e nenhum espaço. O nome não pode começar com um número.

      O novo script é adicionado à guia Visão geral no Navegador. O script é salvo na pasta que contém a tabela do Analytics ativa ou na pasta do projeto raiz, se nenhuma tabela está aberta.

    Copiar a sintaxe para um script existente
    1. Clique com o botão direito do mouse na guia Log e selecione Copiar.
    2. Abra um script existente, se ainda não estiver aberto.
    3. No Editor de script, posicione o cursor no local onde deseja inserir a sintaxe copiada.
    4. Clique com o botão direito do mouse e selecione Colar.

Criar um script com o Gravador de script

O Gravador de script do Analytics permite criar um script registrando suas ações conforme você trabalha com tabelas e comandos na interface do usuário do Analytics. A vantagem de usar o Gravador de Script para criar scripts é que não há necessidade de inserir manualmente a sintaxe necessária para cada comando do ACLScript nem de conhecer essa sintaxe.

Somente comandos são capturados pelo Gravador de Script. Como regra geral, se o comando for exibido no log de comandos, poderá ser capturado em pelo Gravador de Script.

Dica

O Gravador de Script também é uma ferramenta útil para aprender o ACLScript. Você pode gravar uma série de etapas de análise através do Gravador de Script e exibir os scripts resultantes posteriormente a fim de exibir a série de comandos e sintaxes necessárias para reproduzir o comportamento em um script.

  1. No menu principal do Analytics, selecione Ferramentas > Gravador de script Ativado.

    O ícone do Gravador de Script é exibido na barra de status e uma caixa de seleção é exibida à esquerda do item de menu para indicar que o Gravador de Script está ativado.

  2. Execute as etapas de análise ou processamento que você deseja gravar.

    O Analytics registra cada comando processado em um novo script.

  3. Quando você terminar de analisar ou processar os dados, selecione Ferramentas > Gravador de script Ativado novamente para desativar o Gravador de script.

    O Analytics solicitará que você salve o script.

  4. Digite um nome significativo para o script na caixa de texto e clique em OK.

    Nota

    Os nomes de script são limitados a 64 caracteres alfanuméricos. O nome pode incluir o caractere de sublinhado ( _ ) mas nenhum outro caractere especial e nenhum espaço. O nome não pode começar com um número.

Criar um script com captura de sintaxe

A captura de sintaxe permite usar os menus e as caixas de diálogo do Analytics para inserir automaticamente sintaxe do ACLScript em um script.

  1. Abra o script com o qual você quer trabalhar.
  2. (Opcional) Abra a tabela com a qual você quer trabalhar.

    Dica

    Se você iniciar a captura de sintaxe antes de abrir uma tabela, a tabela não abrirá fisicamente na guia Exibição porque os comandos não são realmente executados durante a captura de sintaxe. Pode ser difícil visualizar os comandos subsequentes em uma tabela aberta para orientação.

  3. Na barra de ferramentas do Editor de script, clique em Iniciar captura da sintaxe .
  4. Execute as etapas de análise ou processamento que você deseja gravar.

    A sintaxe associada será inserida automaticamente no script. Os comandos em si não são executados.

  5. Clique em Interromper captura de sintaxe  para interromper a inserção da sintaxe de comandos no script.

Cria um script do histórico da tabela

Você pode criar um script com base no histórico associado a uma tabela de saída ou resultados do Analytics.

Por exemplo, se você adicionar uma tabela de inventário mensal a um projeto do Analytics e extrair divisões e itens relevantes para uma nova tabela, você poderá criar um script para esse processo com base no histórico da tabela associado à primeira tabela de saída criada.

Cada tabela criada como resultado de um comando do Analytics mantém um registro dos comandos usados para criá-la, incluindo os comandos que criaram tabelas intermediárias entre a tabela original do Analytics e a tabela resultante. Você pode copiar esse histórico da tabela para um novo script que pode então ser usado para automatizar a criação de tabelas de saída subsequentes.

  1. Abra uma tabela de saída que é resultado de um processo que você deseja automatizar em um script.
  2. Selecione Ferramentas > Criar script no Histórico de tabelas.

    Se a Exibição_padrão está ativa, o Analytics pede que você renomeie a exibição para impedir que ela seja substituída ao executar o novo script.

  3. Se o Analytics solicitar que a exibição seja renomeada, clique em Renomear, insira um novo nome e clique em OK.
  4. Insira um nome do novo script na caixa de diálogo Salvar como e clique em OK.

    Nota

    Os nomes de script são limitados a 64 caracteres alfanuméricos. O nome pode incluir o caractere de sublinhado ( _ ) mas nenhum outro caractere especial e nenhum espaço. O nome não pode começar com um número.

  5. (Opcional) Abra e edite o novo script se quiser ajustar seu comportamento.

    Por exemplo, em vez de sobrescrever a tabela original, você poderia optar por salvar a saída em uma tabela com um nome diferente.

Adquira um token de acesso do HighBond

Cuidado

O token de acesso gerado corresponde à conta usada para fazer login no Diligent One. Como um autor de scripts, pode não ser apropriado especificar seu próprio token de acesso em um script se ele for usado por outras pessoas.

Proteja os tokens de acesso como qualquer senha de conta.

Use um token existente, a menos que você tenha um motivo para criar um novo. Se o token existente não funcionar, crie um novo. O uso de um token existente reduz o número de tokens que você precisa gerenciar.

  1. Execute uma das seguintes ações:

    • No menu principal do Analytics, selecione Ferramentas > Token de Acesso do HighBond.

    • No Editor de script, clique com o botão direito e selecione Inserir > Token do HighBond.

    A página Gerenciar tokens da API abre no navegador. Pode ser necessário primeiro fazer o login no Diligent One.

    O acesso à página Gerenciar Tokens da API por meio do Analytics é um recurso de conveniência. Você também pode fazer login no Diligent One e acessar a página por meio do seu perfil de usuário sem usar o Analytics.

  2. Execute uma das seguintes ações:

    • Usar um token existente

      1. Na coluna Token, clique no token parcialmente mascarado que deseja usar.

      2. Digite a senha da conta do Diligent One e clique em Confirmar.

        O token não mascarado é exibido.

      3. Clique em Copiar para copiar o token.

        Dica

        Não feche a caixa de diálogo que contém o token até colar corretamente o token.

    • Criar um novo token

      1. Clique em Adicionar token > Analytics.

      2. No painel lateral Novo token do Analytics, especifique estas informações:

        Campo ou opção Descrição
        Descrição

        Insira uma descrição que forneça informações úteis, como:

        • O propósito do token
        • Onde o token é usado – por exemplo, o nome e a localização do script do Analytics, ou o nome e a localização da tarefa do robô
        Expiração do token
        • Habilitada o token expira após um número de dias especificado
        • Desabilitada o token nunca expira

        Nota

        Sua organização pode ter uma política de segurança que exige a expiração de tokens após um determinado período. É recomendado criar tokens com expiração. O Diligent One enviará uma notificação automática por e-mail antes da data de expiração.
        Expiração em Especifique o número de dias até a expiração do token (1 a 365).
        Senha Digite a senha da conta do Diligent One.

      3. Clique em Gerar token.

      4. Clique em Copiar para copiar o token.

        Dica

        Não feche o painel lateral que contém o token até colar corretamente o token.

  3. Dependendo do método de definição de senha que você está usando, faça uma das seguintes opções:

    • Tag de análise PASSWORD No Designer de Tarefa em um robô ACL, cole o token copiado em um campo de parâmetro de senha.

    • Comando PASSWORD No Analytics, cole o token copiado em um prompt de senha exibido durante a execução de scripts.

    • Comando SET PASSWORD No Analytics, cole o token no ponto apropriado na sintaxe do comando SET PASSWORD em um script.

  4. No Launchpad, feche a caixa de diálogo ou o painel lateral que contém o token.

    Se tiver criado um novo token, uma versão parcialmente mascarada do token é adicionada ao início da lista de tokens.

    Para obter mais informações, consulte Criando e gerenciando tokens de acesso do HighBond.