Comandos

Os comandos de script do ACL realizam operações em dados que, muitas vezes, têm um escopo amplo.

Por exemplo, o comando SUMMARIZE agrupa registros com base em valores idênticos em um campo e calcula subtotais e valores estatísticos para cada grupo.

Diversos comandos exibem os resultados em uma nova tabela do Analytics. Outros comandos realizam várias tarefas de aplicativos.

Lista de comandos

Veja a seguir uma lista completa dos comandos disponíveis no Analytics, organizados alfabeticamente ou por categoria.

Também são fornecidas as convenções usadas na documentação dos comandos, bem como alguns detalhes de uso geral.

Comandos em ordem alfabética

Comando Descrição

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.

ACCESSDATA

Importa dados de diversas origens de dados compatíveis com ODBC.

O comando assume a forma ACCESSDATA64 ou ACCESSDATA32, dependendo do driver do ODBC que você estiver usando (64 ou 32 bits).

ACTIVATE

Adiciona definições de campos armazenadas em uma área de trabalho do Analytics ao conjunto existente de definições de campos em um layout da tabela do Analytics.

AGE

Agrupa os registros em períodos de vencimento com base nos valores de um campo data ou datahora. Conta os registros em cada período e subtotaliza os campos numéricos especificados em cada período.

APPEND

Combina registros de duas ou mais tabelas do Analytics anexando-os em uma nova tabela do Analytics.

ASSIGN

Cria uma variável e atribui a ela um valor.

BENFORD

Conta o número de vezes que cada dígito (1 a 9) ou combinação de dígitos à esquerda ocorre em um campo e compara a contagem real à contagem esperada. O resultado esperado é calculado usando a fórmula de Benford.

CALCULATE

Calcula o valor de uma ou mais expressões.

CLASSIFY

Agrupa os registros com base em valores idênticos de um campo de caracteres ou numérico. Conta os registros em cada grupo e subtotaliza os campos numéricos especificados em cada grupo.

CLOSE

Fecha uma tabela, um arquivo de índice ou um arquivo de log do Analytics, ou encerra uma sessão do Gravador de Script.

CLUSTER

Agrupa registros em clusters com base nos valores similares de um ou mais campos numéricos. Os clusters podem ser unidimensionais ou multidimensionais.

COMMENT

Adiciona uma nota explicativa a um script sem afetar o processamento.

COUNT

Conta o número total de registros na exibição atual ou apenas os registros que cumprem a condição especificada.

CREATE LAYOUT

Cria um layout da tabela do Analytics vazio, que pode ser necessário em algumas situações de uso de scripts.

CROSSTAB

Agrupa registros com base em combinações idênticas de valores em dois ou mais campos de caracteres ou numéricos e exibe os grupos resultantes em uma grade de linhas e colunas. Conta os registros em cada grupo e subtotaliza os campos numéricos especificados em cada grupo.

CVSEVALUATE

Para a amostragem clássica de variáveis, oferece quatro métodos diferentes para projetar resultados da análise de amostra para toda a população.

CVSPREPARE

Estratifica uma população e calcula um tamanho de amostra estatisticamente válido para cada estrato na amostragem clássica de variáveis.

CVSSAMPLE

Obtém uma amostra de registros usando o método de amostragem clássica de variáveis.

DEFINE COLUMN

Cria e adiciona uma ou mais colunas a uma exibição existente.

DEFINE FIELD

Define um campo de dados físico em um layout da tabela do Analytics.

DEFINE FIELD...COMPUTED

Define um campo calculado em um layout da tabela do Analytics.

DEFINE RELATION

Define uma relação entre duas tabelas do Analytics.

DEFINE REPORT

Cria uma nova exibição ou abre uma exibição existente.

DEFINE TABLE DB

Define uma tabela de servidor do Analytics por meio de uma conexão a uma tabela de banco de dados usando o Conector do AX. Você pode estabelecer uma conexão a um banco de dados Microsoft SQL Server, Oracle ou DB2.

DEFINE VIEW

Define uma nova exibição ou sobrescreve uma exibição existente.

DELETE

Exclui um item de projeto do Analytics, um campo de um layout da tabela, uma variável, uma ou mais entradas de histórico de tabela, uma relação entre tabelas ou um arquivo em uma pasta do Windows. Além disso, remove uma coluna de uma exibição.

DIALOG

Cria uma caixa de diálogo personalizada que solicita interativamente um ou mais valores de entrada de script dos usuários. Cada valor de entrada é armazenado em uma variável nomeada.

DIRECTORY

Gera uma lista de arquivos e pastas no diretório especificado.

DISPLAY

Exibe informações sobre o tipo de item do Analytics especificado. Também pode exibir o resultado de uma expressão ou a saída de uma função.

DO REPORT

Gera o relatório do Analytics especificado.

DO SCRIPT

Executa um script secundário ou externo de dentro de um script do Analytics.

DUMP

Exibe o conteúdo de um arquivo ou do registro atual em codificações de caracteres hexadecimais, ASCII e EBCDIC.

DUPLICATES

Detecta quando valores duplicados ou registros inteiros duplicados existem em uma tabela do Analytics.

ESCAPE

Encerra o script ou todos os scripts sendo processados, sem sair do Analytics.

EVALUATE

Para a amostragem por registro ou a amostragem por unidades monetárias, projeta os erros encontrados em dados amostrados para toda a população e calcula os limites superiores de taxa de desvio ou o valor da afirmação incorreta.

EXECUTE

Executa um aplicativo ou processo externo ao Analytics. Emula o comando Run do Windows. Pode ser usado para interagir com o prompt de comando do Windows.

EXPORT

Exporta dados do Analytics para o formato de arquivo especificado ou para o Resultados do HighBond.

EXTRACT

Extrai dados de uma tabela do Analytics e usa esses dados para gerar uma nova tabela do Analytics ou anexá-los a uma tabela do Analytics existente. É possível extrair todos os registros ou campos selecionados.

FIELDSHIFT

Desloca a posição inicial de uma definição de campo em um layout da tabela.

FIND

Pesquisa um campo de caracteres indexado para encontrar o primeiro valor correspondente à cadeia de caracteres especificada.

FUZZYDUP

Detecta valores quase idênticos (duplicidades parciais) em um campo de caracteres.

FUZZYJOIN

Usa correspondências parciais para combinar campos de duas tabelas do Analytics em uma única tabela nova do Analytics.

GAPS

Detecta se um campo numérico ou datahora em uma tabela do Analytics contém uma ou mais falhas em dados sequenciais.

GROUP

Executa um ou mais comandos do ACLScript em um registro antes de passar ao próximo registro na tabela, executando apenas uma passagem pela tabela. A execução do comando pode ser controlada por condições.

HELP

Abre os documentos de ajuda do Analytics em um navegador.

HISTOGRAM

Agrupa os registros com base em valores de um campo de caracteres ou numérico, conta o número de registros em cada grupo e exibe os grupos e contagens em um gráfico de barras.

IF

Especifica uma condição que deve ser avaliada como verdadeira para executar um comando.

IMPORT ACCESS

Cria uma tabela do Analytics definindo e importando um arquivo de banco de dados do Microsoft Access.

IMPORT DELIMITED

Cria uma tabela do Analytics definindo e importando um arquivo de texto delimitado.

IMPORT EXCEL

Cria uma tabela do Analytics definindo e importando uma planilha ou intervalo nomeado do Microsoft Excel.

IMPORT GRCPROJECT

Cria uma tabela do Analytics importando uma tabela do Projetos do HighBond.

IMPORT GRCRESULTS

Cria uma tabela do Analytics importando uma tabela ou interpretação do Resultados do HighBond.

IMPORT LAYOUT

Importa um arquivo de layout da tabela externo (.layout) para um projeto do Analytics.

IMPORT MULTIDELIMITED

Cria várias tabelas do Analytics definindo e importando várias planilhas do Microsoft Excel.

IMPORT MULTIEXCEL

Cria várias tabelas do Analytics definindo e importando várias planilhas ou intervalos nomeados do Microsoft Excel.

IMPORT ODBC

Cria uma tabela do Analytics definindo e importando dados de uma origem de dados ODBC.

ODBC significa Open Database Connectivity (conectividade aberta de banco de dados), um padrão da Microsoft para acessar bancos de dados.

IMPORT PDF

Cria uma tabela do Analytics definindo e importando um arquivo Adobe PDF.

IMPORT PRINT

Cria uma tabela do Analytics definindo e importando um arquivo de imagem de impressão (relatório).

IMPORT SAP

Cria uma tabela do Analytics importando dados de um sistema SAP usando o Direct Link.

IMPORT XBRL

Cria uma tabela do Analytics definindo e importando um arquivo XBRL.

IMPORT XML

Cria uma tabela do Analytics definindo e importando um arquivo XML.

INDEX

Cria um índice para uma tabela do Analytics que permite acessar os registros em uma ordem sequencial em vez de na ordem física.

JOIN

Combina campos de duas tabelas do Analytics em uma única tabela nova do Analytics.

LIST

Exibe os dados de um ou mais campos de uma tabela do Analytics formatados em colunas.

LOCATE

Pesquisa pelo primeiro registro que corresponde ao valor ou condição especificado ou move para o número de registro especificado.

LOOP

Executa repetidamente uma série de comandos do ACLScript em um registro enquanto uma condição especificada é avaliada como verdadeira.

MERGE

Combina registros de duas tabelas ordenadas do Analytics com estrutura idêntica em uma nova tabela do Analytics que usa o mesmo critério de ordenação das tabelas originais.

NOTES

Cria, modifica ou remove uma nota associada a um registro individual em uma tabela do Analytics.

NOTIFY

Envia uma mensagem de notificação por e-mail.

OPEN

Abre uma tabela do Analytics e o arquivo de dados associado.

OUTLIERS

Identifica valores discrepantes estatísticos em um campo numérico. Os valores discrepantes podem ser identificados para o campo como um todo ou para grupos separados baseados em valores idênticos de um ou mais campos-chave de caracteres, numéricos ou datahora.

PASSWORD

Cria uma definição de senha, sem valor de senha, que solicita uma senha do usuário durante a execução de um script.

PAUSE

Suspende um script e exibe informações em uma caixa de diálogo aos usuários.

PREDICT

Aplica um modelo preditivo a um conjunto de dados sem rótulo para prever classes ou valores numéricos associados a registros individuais.

PRINT

Imprime um arquivo de texto, um arquivo de log do Analytics ou um item de projeto do Analytics exportado como um arquivo externo: um script (.aclscript), um layout da tabela (.layout) ou uma área de trabalho (.wsp). Também é possível imprimir um gráfico gerado por um comando.

PROFILE

Gera estatísticas resumidas para um ou mais campos numéricos ou expressões numéricas em uma tabela do Analytics.

QUIT

Encerra a sessão atual e fecha o Analytics.

RANDOM

Gera um conjunto de números aleatórios.

RCOMMAND

Passa uma tabela do Analytics para um script do R externo como um quadro de dados e cria uma nova tabela no projeto do Analytics usando a saída do script R externo.

REFRESH

Atualiza os dados em uma tabela do Analytics com a origem de dados associada.

RENAME

Renomeia um item ou arquivo de projeto do Analytics.

REPORT

Formata e gera um relatório baseado na tabela aberta do Analytics.

RETRIEVE

Recupera o resultado de uma consulta do Direct Link enviada para processamento em segundo plano.

SAMPLE

Obtém uma amostra de registros usando o método de amostragem por registro ou de amostragem por unidades monetárias.

SAVE

Copia uma tabela do Analytics, salvando-a com um nome diferente, ou salva um projeto do Analytics.

SAVE LAYOUT

Salva um layout da tabela do Analytics em um layout da tabela externo (.layout) ou salva metadados do layout da tabela em uma tabela do Analytics.

SAVE LOG

Salva todo o log de comandos ou as entradas de log para a sessão atual do Analytics um arquivo externo.

SAVE TABLELIST

Salva uma lista de todas as tabelas de um projeto do Analytics em uma tabela do Analytics ou em um arquivo CSV.

SAVE WORKSPACE

Cria e salva uma área de trabalho.

SEEK

Pesquisa um campo de caracteres indexado para encontrar o primeiro valor correspondente à expressão de caracteres ou cadeia de caracteres especificada.

SEQUENCE

Determina se um ou mais campos em uma tabela do Analytics estão em ordem sequencial e identifica itens fora de sequência.

SET

Define uma opção configurável do Analytics.

SIZE

Calcula um tamanho da amostra e um intervalo de amostragem estatisticamente válidos para amostragem registro ou por unidades monetárias.

SORT

Ordena registros em uma tabela do Analytics em ordem sequencial crescente ou decrescente de acordo com um ou mais campos-chave especificados. Os resultados são enviados a uma tabela nova e fisicamente reordenada do Analytics.

STATISTICS

Calcula estatísticas para um ou mais campos numéricos ou datahora em uma tabela do Analytics.

STRATIFY

Agrupa os registros em intervalos numéricos de acordo com os valores de um campo numérico. Conta os registros em cada intervalo e subtotaliza os campos numéricos especificados em cada intervalo.

SUMMARIZE

Agrupa os registros com base em valores idênticos em um ou mais campos de caracteres, numéricos ou datahora. Conta os registros em cada grupo e subtotaliza os campos numéricos especificados em cada grupo.

TOP

Posiciona no primeiro registro de uma tabela do Analytics.

TOTAL

Calcula o valor total de um ou mais campos em uma tabela do Analytics.

TRAIN

Usa aprendizado de máquina automatizado para criar um modelo preditivo ideal usando um conjunto de dados de treinamento.

VERIFY

Verifica a existência de erros de validade de dados em um ou mais campos em uma tabela do Analytics, confirmando se os dados estão consistentes com as definições do campo no layout da tabela.

Importar e exportar dados

Comando Descrição
ACCESSDATA

Importa dados de diversas origens de dados compatíveis com ODBC.

O comando assume a forma ACCESSDATA64 ou ACCESSDATA32, dependendo do driver do ODBC que você estiver usando (64 ou 32 bits).

DEFINE TABLE DB

Define uma tabela de servidor do Analytics por meio de uma conexão a uma tabela de banco de dados usando o Conector do AX. Você pode estabelecer uma conexão a um banco de dados Microsoft SQL Server, Oracle ou DB2.

EXPORT

Exporta dados do Analytics para o formato de arquivo especificado ou para o Resultados do HighBond.

IMPORT ACCESS

Cria uma tabela do Analytics definindo e importando um arquivo de banco de dados do Microsoft Access.

IMPORT DELIMITED

Cria uma tabela do Analytics definindo e importando um arquivo de texto delimitado.

IMPORT EXCEL

Cria uma tabela do Analytics definindo e importando uma planilha ou intervalo nomeado do Microsoft Excel.

IMPORT GRCPROJECT

Cria uma tabela do Analytics importando uma tabela do Projetos do HighBond.

IMPORT GRCRESULTS

Cria uma tabela do Analytics importando uma tabela ou interpretação do Resultados do HighBond.

IMPORT MULTIDELIMITED

Cria várias tabelas do Analytics definindo e importando várias planilhas do Microsoft Excel.

IMPORT MULTIEXCEL

Cria várias tabelas do Analytics definindo e importando várias planilhas ou intervalos nomeados do Microsoft Excel.

IMPORT ODBC

Cria uma tabela do Analytics definindo e importando dados de uma origem de dados ODBC.

ODBC significa Open Database Connectivity (conectividade aberta de banco de dados), um padrão da Microsoft para acessar bancos de dados.

IMPORT PDF

Cria uma tabela do Analytics definindo e importando um arquivo Adobe PDF.

IMPORT PRINT

Cria uma tabela do Analytics definindo e importando um arquivo de imagem de impressão (relatório).

IMPORT SAP

Cria uma tabela do Analytics importando dados de um sistema SAP usando o Direct Link.

IMPORT XBRL

Cria uma tabela do Analytics definindo e importando um arquivo XBRL.

IMPORT XML

Cria uma tabela do Analytics definindo e importando um arquivo XML.

RETRIEVE

Recupera o resultado de uma consulta do Direct Link enviada para processamento em segundo plano.

Perfil e verificar dados

Comando Descrição

BENFORD

Conta o número de vezes que cada dígito (1 a 9) ou combinação de dígitos à esquerda ocorre em um campo e compara a contagem real à contagem esperada. O resultado esperado é calculado usando a fórmula de Benford.

COUNT

Conta o número total de registros na exibição atual ou apenas os registros que cumprem a condição especificada.

DUPLICATES

Detecta quando valores duplicados ou registros inteiros duplicados existem em uma tabela do Analytics.

FUZZYDUP

Detecta valores quase idênticos (duplicidades parciais) em um campo de caracteres.

GAPS

Detecta se um campo numérico ou datahora em uma tabela do Analytics contém uma ou mais falhas em dados sequenciais.

OUTLIERS

Identifica valores discrepantes estatísticos em um campo numérico. Os valores discrepantes podem ser identificados para o campo como um todo ou para grupos separados baseados em valores idênticos de um ou mais campos-chave de caracteres, numéricos ou datahora.

PROFILE

Gera estatísticas resumidas para um ou mais campos numéricos ou expressões numéricas em uma tabela do Analytics.

SEQUENCE

Determina se um ou mais campos em uma tabela do Analytics estão em ordem sequencial e identifica itens fora de sequência.

STATISTICS

Calcula estatísticas para um ou mais campos numéricos ou datahora em uma tabela do Analytics.

TOTAL

Calcula o valor total de um ou mais campos em uma tabela do Analytics.

VERIFY

Verifica a existência de erros de validade de dados em um ou mais campos em uma tabela do Analytics, confirmando se os dados estão consistentes com as definições do campo no layout da tabela.

Ordenar dados

Comando Descrição

INDEX

Cria um índice para uma tabela do Analytics que permite acessar os registros em uma ordem sequencial em vez de na ordem física.

SORT

Ordena registros em uma tabela do Analytics em ordem sequencial crescente ou decrescente de acordo com um ou mais campos-chave especificados. Os resultados são enviados a uma tabela nova e fisicamente reordenada do Analytics.

Agrupar dados

Comando Descrição

AGE

Agrupa os registros em períodos de vencimento com base nos valores de um campo data ou datahora. Conta os registros em cada período e subtotaliza os campos numéricos especificados em cada período.

CLASSIFY

Agrupa os registros com base em valores idênticos de um campo de caracteres ou numérico. Conta os registros em cada grupo e subtotaliza os campos numéricos especificados em cada grupo.

CLUSTER

Agrupa registros em clusters com base nos valores similares de um ou mais campos numéricos. Os clusters podem ser unidimensionais ou multidimensionais.

CROSSTAB

Agrupa registros com base em combinações idênticas de valores em dois ou mais campos de caracteres ou numéricos e exibe os grupos resultantes em uma grade de linhas e colunas. Conta os registros em cada grupo e subtotaliza os campos numéricos especificados em cada grupo.

HISTOGRAM

Agrupa os registros com base em valores de um campo de caracteres ou numérico, conta o número de registros em cada grupo e exibe os grupos e contagens em um gráfico de barras.

OUTLIERS

Identifica valores discrepantes estatísticos em um campo numérico. Os valores discrepantes podem ser identificados para o campo como um todo ou para grupos separados baseados em valores idênticos de um ou mais campos-chave de caracteres, numéricos ou datahora.

STRATIFY

Agrupa os registros em intervalos numéricos de acordo com os valores de um campo numérico. Conta os registros em cada intervalo e subtotaliza os campos numéricos especificados em cada intervalo.

SUMMARIZE

Agrupa os registros com base em valores idênticos em um ou mais campos de caracteres, numéricos ou datahora. Conta os registros em cada grupo e subtotaliza os campos numéricos especificados em cada grupo.

Combinar dados

Comando Descrição

APPEND

Combina registros de duas ou mais tabelas do Analytics anexando-os em uma nova tabela do Analytics.

DEFINE RELATION

Define uma relação entre duas tabelas do Analytics.

EXTRACT

Extrai dados de uma tabela do Analytics e usa esses dados para gerar uma nova tabela do Analytics ou anexá-los a uma tabela do Analytics existente. É possível extrair todos os registros ou campos selecionados.

FUZZYJOIN

Usa correspondências parciais para combinar campos de duas tabelas do Analytics em uma única tabela nova do Analytics.

JOIN

Combina campos de duas tabelas do Analytics em uma única tabela nova do Analytics.

MERGE

Combina registros de duas tabelas ordenadas do Analytics com estrutura idêntica em uma nova tabela do Analytics que usa o mesmo critério de ordenação das tabelas originais.

Dados de amostra

Comando Descrição

CVSPREPARE

Estratifica uma população e calcula um tamanho de amostra estatisticamente válido para cada estrato na amostragem clássica de variáveis.

CVSSAMPLE

Obtém uma amostra de registros usando o método de amostragem clássica de variáveis.

CVSEVALUATE

Para a amostragem clássica de variáveis, oferece quatro métodos diferentes para projetar resultados da análise de amostra para toda a população.

SIZE

Calcula um tamanho da amostra e um intervalo de amostragem estatisticamente válidos para amostragem registro ou por unidades monetárias.

SAMPLE

Obtém uma amostra de registros usando o método de amostragem por registro ou de amostragem por unidades monetárias.

EVALUATE

Para a amostragem por registro ou a amostragem por unidades monetárias, projeta os erros encontrados em dados amostrados para toda a população e calcula os limites superiores de taxa de desvio ou o valor da afirmação incorreta.

Aprendizado de máquina

Comando Descrição

CLUSTER

Agrupa registros em clusters com base nos valores similares de um ou mais campos numéricos. Os clusters podem ser unidimensionais ou multidimensionais.

TRAIN

Usa aprendizado de máquina automatizado para criar um modelo preditivo ideal usando um conjunto de dados de treinamento.

PREDICT

Aplica um modelo preditivo a um conjunto de dados sem rótulo para prever classes ou valores numéricos associados a registros individuais.

Campo, registro e tabela

Comando Descrição

ACTIVATE

Adiciona definições de campos armazenadas em uma área de trabalho do Analytics ao conjunto existente de definições de campos em um layout da tabela do Analytics.

CREATE LAYOUT

Cria um layout da tabela do Analytics vazio, que pode ser necessário em algumas situações de uso de scripts.

DEFINE COLUMN

Cria e adiciona uma ou mais colunas a uma exibição existente.

DEFINE FIELD

Define um campo de dados físico em um layout da tabela do Analytics.

DEFINE FIELD...COMPUTED

Define um campo calculado em um layout da tabela do Analytics.

DEFINE REPORT

Cria uma nova exibição ou abre uma exibição existente.

DEFINE VIEW

Define uma nova exibição ou sobrescreve uma exibição existente.

EXTRACT

Extrai dados de uma tabela do Analytics e usa esses dados para gerar uma nova tabela do Analytics ou anexá-los a uma tabela do Analytics existente. É possível extrair todos os registros ou campos selecionados.

FIELDSHIFT

Desloca a posição inicial de uma definição de campo em um layout da tabela.

FIND

Pesquisa um campo de caracteres indexado para encontrar o primeiro valor correspondente à cadeia de caracteres especificada.

IMPORT LAYOUT

Importa um arquivo de layout da tabela externo (.layout) para um projeto do Analytics.

LIST

Exibe os dados de um ou mais campos de uma tabela do Analytics formatados em colunas.

LOCATE

Pesquisa pelo primeiro registro que corresponde ao valor ou condição especificado ou move para o número de registro especificado.

NOTES

Cria, modifica ou remove uma nota associada a um registro individual em uma tabela do Analytics.

OPEN

Abre uma tabela do Analytics e o arquivo de dados associado.

REFRESH

Atualiza os dados em uma tabela do Analytics com a origem de dados associada.

SAVE

Copia uma tabela do Analytics, salvando-a com um nome diferente, ou salva um projeto do Analytics.

SAVE LAYOUT

Salva um layout da tabela do Analytics em um layout da tabela externo (.layout) ou salva metadados do layout da tabela em uma tabela do Analytics.

SAVE TABLELIST

Salva uma lista de todas as tabelas de um projeto do Analytics em uma tabela do Analytics ou em um arquivo CSV.

SAVE WORKSPACE

Cria e salva uma área de trabalho.

SEEK

Pesquisa um campo de caracteres indexado para encontrar o primeiro valor correspondente à expressão de caracteres ou cadeia de caracteres especificada.

TOP

Posiciona no primeiro registro de uma tabela do Analytics.

Interação com o usuário e criação de scripts geral

Comando Descrição

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.

ASSIGN

Cria uma variável e atribui a ela um valor.

CALCULATE

Calcula o valor de uma ou mais expressões.

CLOSE

Fecha uma tabela, um arquivo de índice ou um arquivo de log do Analytics, ou encerra uma sessão do Gravador de Script.

COMMENT

Adiciona uma nota explicativa a um script sem afetar o processamento.

DELETE

Exclui um item de projeto do Analytics, um campo de um layout da tabela, uma variável, uma ou mais entradas de histórico de tabela, uma relação entre tabelas ou um arquivo em uma pasta do Windows. Além disso, remove uma coluna de uma exibição.

DIALOG

Cria uma caixa de diálogo personalizada que solicita interativamente um ou mais valores de entrada de script dos usuários. Cada valor de entrada é armazenado em uma variável nomeada.

DO SCRIPT

Executa um script secundário ou externo de dentro de um script do Analytics.

ESCAPE

Encerra o script ou todos os scripts sendo processados, sem sair do Analytics.

EXECUTE

Executa um aplicativo ou processo externo ao Analytics. Emula o comando Run do Windows. Pode ser usado para interagir com o prompt de comando do Windows.

GROUP

Executa um ou mais comandos do ACLScript em um registro antes de passar ao próximo registro na tabela, executando apenas uma passagem pela tabela. A execução do comando pode ser controlada por condições.

IF

Especifica uma condição que deve ser avaliada como verdadeira para executar um comando.

LOOP

Executa repetidamente uma série de comandos do ACLScript em um registro enquanto uma condição especificada é avaliada como verdadeira.

NOTIFY

Envia uma mensagem de notificação por e-mail.

PASSWORD

Cria uma definição de senha, sem valor de senha, que solicita uma senha do usuário durante a execução de um script.

PAUSE

Suspende um script e exibe informações em uma caixa de diálogo aos usuários.

RCOMMAND

Passa uma tabela do Analytics para um script do R externo como um quadro de dados e cria uma nova tabela no projeto do Analytics usando a saída do script R externo.

RENAME

Renomeia um item ou arquivo de projeto do Analytics.

SET

Define uma opção configurável do Analytics.

Relatório

Comando Descrição

DO REPORT

Gera o relatório do Analytics especificado.

PRINT

Imprime um arquivo de texto, um arquivo de log do Analytics ou um item de projeto do Analytics exportado como um arquivo externo: um script (.aclscript), um layout da tabela (.layout) ou uma área de trabalho (.wsp). Também é possível imprimir um gráfico gerado por um comando.

REPORT

Formata e gera um relatório baseado na tabela aberta do Analytics.

Arquivo e sistema

Comando Descrição

DIRECTORY

Gera uma lista de arquivos e pastas no diretório especificado.

DISPLAY

Exibe informações sobre o tipo de item do Analytics especificado. Também pode exibir o resultado de uma expressão ou a saída de uma função.

DUMP

Exibe o conteúdo de um arquivo ou do registro atual em codificações de caracteres hexadecimais, ASCII e EBCDIC.

HELP

Abre os documentos de ajuda do Analytics em um navegador.

QUIT

Encerra a sessão atual e fecha o Analytics.

RANDOM

Gera um conjunto de números aleatórios.

SAVE LOG

Salva todo o log de comandos ou as entradas de log para a sessão atual do Analytics um arquivo externo.

Abreviando nomes de comandos

Cuidado

A ACL recomenda que você não abrevie nomes de comandos em scripts e use a versão completa de cada nome.

A abreviação dificulta a leitura e a compreensão dos scripts. Sem nomes completos dos comandos, fica mais difícil pesquisar comandos na ajuda on-line.

A abreviação é particularmente problemática se os scripts serão modificados ou herdados por outra pessoa que pode não estar familiarizada com as abreviações.

Ao especificar comandos em scripts, você pode abreviar seus nomes. Você deve incluir caracteres à esquerda suficientes em um nome de comando para identificá-lo unicamente entre todos os comandos do Analytics.

Por exemplo:

  • EXT identifica unicamente o comando EXTRACT e é, portanto, uma abreviação válida.
  • EX não identifica unicamente o comando EXTRACT e gera uma mensagem de erro.

As abreviações podem ser bastante curtas, desde que identifiquem unicamente o comando.

Por exemplo, todas as abreviações a seguir do comando OPEN são válidas:

  • OPE
  • OP
  • O

Nota

Abreviações mais curtas dificultam o reconhecimento por outras pessoas.

A ordem de parâmetros em comandos

Nota

Como prática recomendada de scripting, os autores de scripts do Analytics devem ordenar os parâmetros exatamente na mesma ordem em que aparecem no log de comandos quando um comando é executado na interface do usuário do Analytics.

Muitos comandos do Analytics oferecem alguma flexibilidade em relação à ordem dos parâmetros. Por exemplo, estas três variações do mesmo comando CLASSIFY executam operações idênticas corretamente:

CLASSIFY ON NUMCLIENTE SUBTOTAL VALOR IF VALOR >= 100 TO "Classificar_1.FIL" OPEN APPEND KEY CODES STATISTICS
CLASSIFY ON NUMCLIENTE SUBTOTAL VALOR KEY CODES IF VALOR >= 100 TO "Classificar_1.FIL" OPEN APPEND STATISTICS
CLASSIFY ON NUMCLIENTE IF VALOR >= 100 SUBTOTAL VALOR STATISTICS KEY CODES TO "Classificar_1.FIL" APPEND OPEN

Alguns comandos exigem que um ou mais parâmetros apareçam em uma ordem específica. A ordem necessária é especificada nos tópicos desses comandos.

Nota

A ordem física dos parâmetros nos comandos não afeta a ordem em que o Analytics processa os parâmetros. Por exemplo, os parâmetros de escopo (ALL, FIRST, NEXT, WHILE) são aplicados antes do parâmetro IF, independentemente da posição relativa dos parâmetros.

Convenções de documentação de comandos

Convenção

Usada para:

MAIÚSCULAS

Palavras-chave do Script do ACL.

Nas seções de sintaxe genérica, as palavras-chave que não estão entre sinais de maior e menor < > são itens de sintaxe obrigatórios.

Nota

Em toda a documentação do Analytics, os nomes de comandos e parâmetros são apresentados em maiúsculas. Isso é apenas uma convenção de formatação. O Analytics não exige que as palavras-chave sejam inseridas em maiúsculas.

itálico

Parâmetros de comando fornecidos pelo usuário.

|

(barra vertical)

Separa itens de sintaxe entre chevrons ou chaves. Você só pode usar um dos itens.

< >

(chevrons)

Itens de sintaxe opcionais. Não digite os chevrons.

{ }

(chaves)

Itens de sintaxe obrigatórios. Não digite as chaves.

<;...n>

Indica que o item anterior pode ser repetido n vezes. As ocorrências são separadas por ponto e vírgula.

<...n>

Indica que o item anterior pode ser repetido n vezes. As ocorrências estão separadas por espaço em branco.

[rótulo] ::=

O nome de um bloco de sintaxe.

Esta convenção é usada para agrupar e rotular seções de sintaxe extensa ou uma unidade de sintaxe que pode ser utilizada em mais de um local. Cada local no qual o bloco de sintaxe pode ser usado é indicado com o rótulo entre colchetes. Por exemplo: [sintaxe_campo]