Criar scripts interativos

Você pode criar scripts interativos que solicitam entradas do usuário. Ao contrário de scripts padrão, que são executados sem interrupções, os scripts interativos suspendem a execução até que as informações necessárias sejam fornecidas pelo usuário.

O benefício da interatividade

A interatividade ajuda a criar scripts flexíveis com aplicação mais ampla. Não é preciso especificar antecipadamente todas as informações de entrada, o que exigiria o conhecimento de informações como nomes de tabelas e campos e, normalmente, resultaria em scripts de uso específico e pouco generalistas.

Com a interatividade dos scripts, você poderá coletar informações usando uma ou mais caixas de diálogo quando o usuário executar o script. Por exemplo, você pode usar a interatividade para coletar as seguintes entradas:

  • nome do usuário e senha
  • nomes de tabela e de campo
  • nomes do arquivo
  • limites de valores
  • intervalos de datas
  • identificadores como códigos de comerciantes, códigos de filiais e IDs de fornecedores e clientes
  • parâmetros de comando

Sequenciamento da interatividade

Sempre que possível, coloque todas as caixas de diálogo interativas no início do script, de forma que o restante do script possa ser executado sem interrupção.

Se as caixas de diálogo interativas ocorrerem no meio do script, o usuário poderá não estar mais presente nesse momento e o script ficará parado até que as entradas sejam fornecidas.

Três métodos de criação de interatividade

O Analytics oferece três métodos para criar interatividade em scripts. Cada método é associado a um comando do Analytics.

Os comandos ACCEPT e PASSWORD somente podem ser criados usando a sintaxe do ACLScript. O comando DIALOG pode ser criado usando a sintaxe do ACLScript ou a sintaxe pode ser gerada automaticamente utilizando o Construtor de diálogos, um utilitário visual.

Comando Descrição
Comando ACCEPT

O comando ACCEPT cria a caixa de diálogo interativa padrão, que permite dois métodos de entrada do usuário:

  • A caixa de texto reúne informações digitadas pelo usuário, como datas ou IDs de fornecedor ou cliente
  • A lista de itens do projeto apresenta ao usuário uma lista de itens do projeto do Analytics, como tabelas, campos ou variáveis

    A lista de itens é preenchida dinamicamente de acordo com o conteúdo do projeto do Analytics no qual o script é executado.

É possível criar caixas de diálogo separadas que solicitam um item de cada vez ou criar uma que solicita vários itens.

Comando DIALOG

Construtor de diálogos

O comando DIALOG cria uma caixa de diálogo interativa personalizada. As caixas de diálogo personalizadas permitem opções de layout mais avançadas e cinco métodos de entrada:

  • A caixa de texto reúne informações digitadas pelo usuário, como datas ou IDs de fornecedor ou cliente
  • A caixa de seleção oferece uma escolha binária ao usuário. Ou seja, a opção associada pode estar ativada ou desativada
  • Os botões de opção apresentam opções mutuamente exclusivas ao usuário. Ou seja, apenas uma das opções apresentadas pode ser escolhida por vez
  • Lista suspensa apresenta uma lista de opções personalizadas em texto ao usuário
  • A lista de itens do projeto apresenta ao usuário uma lista de itens do projeto do Analytics, como tabelas, campos ou variáveis

    A lista de itens é preenchida dinamicamente de acordo com o conteúdo do projeto do Analytics no qual o script é executado.

É possível criar caixas de diálogo separadas que solicitam um item de cada vez ou criar uma que solicita vários itens.
Comando PASSWORD

O comando PASSWORD cria uma caixa de diálogo simples com um único campo para inserir uma senha.

Quando o usuário digitar uma senha, os caracteres serão exibidos como asteriscos (*) na caixa de diálogo. A senha será retida na memória pela duração da sessão do Analytics, não aparecerá no script nem no log.