Comando ACCEPT
Cria uma caixa de diálogo que solicita interativamente um ou mais valores de entrada de script dos usuários. Cada valor de entrada é armazenado em uma variável nomeada de caracteres.
Nota
Não é seguro usar o comando ACCEPT para inserir senhas. Em vez disso, use Comando PASSWORD.
O comando ACCEPT não é suportado em scripts executados no Robôs.
Você pode criar uma caixa de diálogo interativa mais avançada com o Comando DIALOG.
Sintaxe
ACCEPT {texto_mensagem <FIELDS categoria_item_projeto> TO nome_variável} <...n>
Parâmetros
| Nome | Descrição |
|---|---|
| texto_mensagem |
O rótulo exibido na caixa de diálogo para solicitar informações. Deve ser uma cadeia entre aspas ou uma variável de caracteres. Para inserir várias solicitações, separe-os com vírgulas. Embora não obrigatório, o uso de vírgulas facilita a leitura do script: ACCEPT "Especifique uma data inicial:" TO v_data_inicial, "Especifique uma data final:" TO v_data_final |
| FIELDS categoria_item_projeto opcional |
Cria uma lista suspensa de itens do projeto para a entrada do usuário, em vez de uma caixa de texto. O usuário pode selecionar um único item do projeto, campo ou variável na lista. categoria_item_projeto indica os tipos de item a serem exibidos na lista. Por exemplo, a especificação de xf exibe todas as tabelas do projeto na lista. Coloque categoria_item_projetos entre aspas: FIELDS "xf" Para ver os códigos usados para especificar as categorias, consulte Códigos para categorias de item de projeto. Você pode especificar mais de um código na mesma solicitação, mas não é possível misturar itens de projeto, campos ou variáveis. |
| TO nome_variável |
O nome da variável de caracteres a ser usada para armazenar a entrada do usuário. A variável será criada, caso ela não exista. Se a variável já existir, seu valor atual será exibido na caixa de diálogo como o valor padrão. Nota Não use caracteres que não sejam em inglês, como é, em nomes de variáveis que serão usadas na substituição de variáveis. Nomes variáveis que contenham caracteres não ingleses causarão falhas na substituição de variáveis. O comando ACCEPT cria somente variáveis de caracteres. Se precisar da entrada de outro tipo de dado, você deverá converter a variável de caracteres para o tipo necessário no processamento subsequente em um script. Para obter mais informações, consulte Tipo de dados de entrada. |
Exemplos
Solicitação para o usuário selecionar a tabela do Analytics a ser aberta
Você precisa de uma caixa de diálogo que solicita que o usuário selecione o nome da tabela a ser aberta. O script abre a tabela selecionada pelo usuário:
ACCEPT "Selecione a tabela a abrir:" FIELDS "xf" TO v_nome_tabela
OPEN %v_nome_tabela%
Os sinais de porcentagem são obrigatórios porque indicam que o nome da tabela a ser aberta está armazenado na variável v_nome_tabela. Se os sinais de porcentagem forem omitidos, o script tentará abrir uma tabela denominada "v_nome_tabela".
Uso de várias caixas de diálogo para coletar entradas obrigatórias
Você quer criar uma caixa de diálogo separada para cada valor que deve ser inserido pelo usuário do script.
Use uma cadeia com uma única solicitação em cada instância do comando ACCEPT. O script gera caixas de diálogo separadas para especificação de cada um dos seguintes itens:
- um nome de tabela
- um campo para amostragem
- um intervalo de amostragem
- um valor inicial aleatório
ACCEPT "Digite o nome da tabela para análise" TO v_nome_tabela
OPEN %v_nome_tabela%
ACCEPT "Selecione o campo para amostra" FIELDS "N" TO v_campo_para_amostra
ACCEPT "Digite o intervalo de amostragem" TO v_intervalo_amostragem
ACCEPT "Digite o valor inicial aleatório" TO v_valor_inicial_aleatório
SAMPLE ON %v_campo_para_amostra% INTERVAL v_intervalo_amostragem FIXED v_valor_inicial_aleatório RECORD TO Amostra_saída OPEN
Quando o script for executado
- A primeira caixa de diálogo solicita o nome da tabela.
- A segunda caixa de diálogo, com FIELDS "N", solicita uma seleção de campo em uma lista suspensa de campos numéricos.
- A terceira caixa de diálogo solicita o valor do intervalo.
- A quarta caixa de diálogo solicita o valor de início aleatório.
Uso de uma única caixa de diálogo com várias solicitações para coletar as entradas necessárias
Você quer criar uma única caixa de diálogo para todos os valores que devem ser inseridos pelo usuário do script.
Use várias solicitações, separadas por vírgulas, no comando ACCEPT para solicitar que o usuário informe os vários valores de entrada. A mesma caixa de diálogo contém solicitações para a data inicial e a data final de um intervalo de datas:
ACCEPT "Especifique uma data inicial:" TO v_data_inicial, "Especifique uma data final:" TO v_data_final
Observações
Para obter informações detalhadas sobre variáveis, consulte Trabalhando com variáveis no ACLScript.
Interatividade
Use ACCEPT para criar um script interativo. Quando o comando ACCEPT é processado, o script é pausado e uma caixa de diálogo é exibida solicitando informações do usuário que o Analytics usa posteriormente no processamento.
É possível criar caixas de diálogo separadas que solicitam um item de cada vez ou criar uma que solicita vários itens.
Comparação entre DIALOG e ACCEPT
O comando DIALOG permite criar uma caixa de diálogo interativa mais avançada, que pode ter um ou mais dos seguintes tipos de controles:
- caixa de texto
- caixa de seleção
- botões de opção
- lista suspensa de valores personalizados
- lista de Itens do projeto
Você também pode personalizar o layout da caixa de diálogo. Para obter mais informações, consulte Comando DIALOG.
Códigos para categorias de item de projeto
Use os seguintes códigos para especificar a categoria do item do projeto a ser exibido em uma lista suspensa.
Categorias de projeto
|
Código |
Categoria |
|---|---|
|
xf |
Tabelas |
|
xb |
Scripts |
|
xi |
Índices |
|
xr |
Exibições e relatórios |
|
xw |
Áreas de trabalho |
Categorias de campo
|
Código |
Categoria |
|---|---|
|
C |
Campos de caractere |
|
N |
Campos numéricos |
|
D |
Campos de datahora |
|
L |
Campos lógicos |
Categorias de variável
|
Código |
Categoria |
|---|---|
|
c |
Variáveis de caractere |
|
n |
Variáveis numéricas |
|
d |
Variáveis de datahora |
|
l |
Variáveis lógicas |
Tipo de dados de entrada
ACCEPT armazena a entrada do usuário em uma ou mais variáveis de caracteres. Se você precisar de entradas numéricas ou datahora, poderá usar as funções VALUE( ) ou CTOD( ) para converter o conteúdo da variável de caracteres em um valor numérico ou datahora:
SET FILTER TO BETWEEN(%v_campo_data%; CTOD(%v_data_inicial%); CTOD(%v_data_final%))
No exemplo, as datas inicial e final desse filtro são armazenadas como valores de caractere. Elas devem ser convertidas em valores de dada para serem usadas com um campo de data que usa um tipo de dados Datetime.
Delimitar o nome da variável com símbolos de porcentagem (%) substitui o valor do caractere contido pela variável pelo nome da variável. A função CTOD( ) converte em seguida o valor do caractere em um valor de data.
Posição do comando ACCEPT
É recomendável colocar todos os comandos ACCEPT no início de um script, se possível. Se você solicitar todas as entradas no início, o script poderá ser executado sem interferências assim que o usuário digitar as informações necessárias.
Nota
Você não pode usar o comando ACCEPT dentro do comando GROUP.
