Comando SET

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

Nota

O comando SET define uma opção do Analytics válida apenas durante a sessão do Analytics. Esse comportamento se aplica sempre que o comando SET for usado na linha de comando do Analytics ou em um script do Analytics.

Para definir opções do Analytics para que persistam entre sessões do Analytics, você deve usar a caixa de diálogo Opções. Para obter mais informações, consulte Configurar as opções do ACL.

Sintaxe

Sintaxe

Observações e comentários

SET BEEP valor

SET BEEP 2

Especifica o número de beeps a tocar quando o processamento de um comando é concluído.

O parâmetro valor deve estar entre 1 e 255.

SET CENTURY valor

SET CENTURY 40

Especifica o ano do início do século para anos com dois dígitos.

O parâmetro valor deve estar entre 0 e 99.

Se o valor de início do século é definido como 40, os anos de dois dígitos de 40 a 99 são interpretados como 1940 a 1999 e os anos de dois dígitos 00 a 39 são interpretados como 2000 a 2039.

SET CLEAN {ON | OFF}

SET CLEAN ON

Quando esta opção está ativada, o Analytics substitui os dados de caracteres inválidos por brancos e os dados numéricos por zeros.

SET DATE <TO> {0 | 1 | 2 | cadeia}

SET DATE "YYYY/MM/DD"

Especifica como o Analytics exibe datas e a parte de data de datahoras em exibições, relatórios e arquivos exportados.

  • SET DATE 0 define a data no formato MM/DD/AAAA

  • SET DATE 1 define a data no formato MM/DD/AA

  • SET DATE 2 define a data no formato DD/MM/AA

  • SET DATE "<cadeia>" define a data no formato personalizado definido

    Ao usar o comando SET DATE para especificar formatos de hora personalizados, você deve usar 'D' para dia, 'M' para mês e 'Y' para ano, mesmo se caracteres de formato de data diferentes tenham sido especificados na caixa de diálogo Opções. Por exemplo:

    SET DATE "DD MMM YYYY"

SET DELETE_FILE {ON | OFF}

SET DELETE_FILE ON

Configuração padrão: OFF

Especifique ON para excluir automaticamente o arquivo de dados associado quando você excluir um layout de tabela.

Especifique OFF para evitar que o arquivo de dados associado seja excluído quando você excluir um layout de tabela.

Você deve incluir o sublinhado ( _ ) em DELETE_FILE.

A execução de SET DELETE_FILE, sem qualquer parâmetro, na linha de comando exibe o estado de ativação de DELETE_FILE.

Cuidado

Tome cuidado ao ativar essa opção. Pode ser um arquivo de dados original o que será excluído junto com a tabela.

Os arquivos de dados são excluídos imediatamente. Esses arquivos excluídos não são enviados para a lixeira do Windows.

SET DESIGNATION valor

SET DESIGNATION "Produzido por ABC Corporation"

O parâmetro valor é uma cadeia entre aspas que especifica o rótulo a ser exibido no topo de cada página impressa.

SET ECHO {ON | NONE}

SET ECHO NONE
Comandos e resultados COM do em scripts executados do log
SET ECHO ON

Especifique NONE para interromper a gravação de comandos e resultados de scripts no log de comandos do Analytics. Especifique ON para retomar a gravação.

O comando SET ECHO se aplica apenas ao registro de comandos e resultados em scripts. Os comandos executados por meio da interface do usuário ou emitidos na linha de comando, e seus resultados, são sempre registrados, independentemente da definição de ECHO.

Você pode executar o comando SET ECHO NONE/ON em um script ou da linha de comando, mas, onde quer que o comando seja executado, apenas o registro de comandos e resultados em scripts é afetado.

A execução de SET ECHO, sem qualquer parâmetro, na linha de comando exibe o estado de ativação do registro de comandos e resultados em scripts.

SET EXACT {ON | OFF}

SET EXACT ON

Configuração padrão: OFF

Controla como o Analytics compara campos de caracteres, expressões ou valores literais.

Nota

Os espaços em branco são tratados como caracteres.

  • SET EXACT está OFF o Analytics usa a cadeia mais curta para comparar duas cadeias de comprimento diferente. A comparação começa com os caracteres à esquerda e segue para a direita.

    Por exemplo, "AB" é igual a "AB", e também é considerada igual a "ABC".

  • SET EXACT está ON as cadeias comparadas devem ser idênticas para haver uma correspondência. Na comparação de duas cadeias de tamanho diferente, o Analytics usa a cadeia mais curta com espaços acrescentados à direita para igualar o tamanho da cadeia mais longa.

    Por exemplo, "AB" é igual a "AB", mas não é considerada igual a "ABC".

Para obter mais exemplos mostrando SET EXACT, consulte "Comparações exatas de caractere" na guia Tabela (caixa de diálogo Opções).

Você pode usar a função ALLTRIM( ) para remover espaços em branco à esquerda e à direita e garantir que apenas os caracteres de texto e os espaços internos sejam comparados.

Por exemplo: ALLTRIM(" AB") = ALLTRIM("AB") será verdadeiro se a função ALLTRIM( ) for usada para os valores; caso contrário, será falso.

Alguns comandos e funções do Analytics são afetados pelo SET EXACT e outros não:

Afetado Não afetado
  • Comando LOCATE
  • Função MATCH( )
  • Função BETWEEN( )
  • Comando JOIN
  • Comando DEFINE RELATION
  • Função FIND( )
  • Função FINDMULTI( )

SET FILTER <TO> {teste | nome_filtro}

SET FILTER TO NoProd = "070104347"
SET FILTER TO FiltroNoProd

Cria um filtro global (filtro de exibição) na tabela aberta e especifica um teste lógico ou o nome de um filtro salvo existente.

A execução de SET FILTER, sem qualquer parâmetro, remove todos os filtros da tabela aberta.

SET FOLDER caminho da pasta

Especifica a pasta do projeto do Analytics na guia Visão geral para a saída do comando. A pasta de saída padrão é a pasta que contém a tabela ativa.

Este é um caminho no estilo DOS usando o formato /nome_pasta/nome_subpasta, onde a barra (/) inicial indica o nível raiz na guia Visão geral. Você deve especificar um caminho de arquivo completo.

  • SET FOLDER /Tabelas/Resultados define a pasta de saída com o a subpasta Resultados. A subpasta Resultados será criada, caso não exista.

  • SET FOLDER / define a pasta de saída no nível de raiz na guia Visão geral

  • SET FOLDER define a pasta de saída para o padrão (a pasta que contém a tabela ativa)

A pasta de saída permanece como foi definida, até que seja redefinida ou até que o projeto seja fechado. Após a abertura do projeto, a pasta de saída irá reverter o padrão da pasta da tabela ativa.

SET FORMAT {ON | OFF}

SET FORMAT ON

Configuração padrão: OFF

Se você usar o parâmetro ON, o Analytics exibirá automaticamente o layout de tabela atual e as definições dos campos calculados quando uma nova tabela for aberta. Os resultados aparecem no log de comando.

SET FUZZYGROUPSIZE <TO> num

SET FUZZYGROUPSIZE TO 10

Especifica o número máximo de itens que podem aparecer no grupo de duplicatas parciais nos resultados de saída. O parâmetro num não pode ser menor que 2 ou maior que 100. O tamanho padrão é 20. O tamanho especificado permanece em vigor durante a sessão do Analytics.

SET GRAPH tipo

SET GRAPH LINE

Especifica o tipo de gráfico a ser usado para todos os gráficos gerados subsequentemente. A execução de comandos deve ser compatível com o tipo de gráfico especificado. Por exemplo, o comando BENFORD não pode produzir um gráfico PIE2D ou PIE3D. Se um tipo de gráfico incompatível for especificado, o tipo de gráfico padrão será usado (BAR3D).

O parâmetro tipo deve ser um dos seguintes:

  • PIE2D

  • PIE3D

  • BAR2D

  • BAR3D – este é o tipo de gráfico padrão.

  • STACKED2D

  • STACKED3D

  • LAYERED

  • LINE

  • BENFORD – combina gráfico de barras 2D e gráfico de linhas 2D.

SET HISTORY <TO> valor

SET HISTORY TO 50

Especifica o número máximo de entradas do histórico da tabela para manter. O parâmetro valor deve estar entre 1 e 100.

SET INDEX <TO> valor

SET INDEX TO "CódigoCliente.INX"

Especifica o índice a ser aplicado à tabela ativa.

SET LEARN <TO> script

SET LEARN TO RegInventário

Especifica o nome do arquivo de script que o Gravador de Script usa para gravar comandos.

SET LOG <TO> {arquivo | OFF}

SET LOG TO "análise.log"
SET LOG OFF

O primeiro comando ativa o registro em log no log especificado. O log especificado será criado, se não existir.

O segundo comando restaura o registro ao log de comandos original do Analytics.

Nota

O comprimento máximo do caminho do projeto do Analytics e do nome do log é 259 caracteres, incluindo o caminho do arquivo, o nome do log e a extensão do arquivo (.log).

SET LOOP <TO> num

SET LOOP TO 20

Especifica o número máximo de loops executados pelo comando LOOP antes que o comando seja encerrado.

O intervalo de num vai de 0 a 32767, onde 0 desliga o teste de loop.

SET MARGIN lado <TO> valor

SET MARGIN TOP TO 100

Especifique LEFT, RIGHT, TOP ou BOTTOM do parâmetro lado. Se você quiser alterar a margem de todos os lados, será necessário especificar cada margem com um comando SET MARGIN separado. A especificação de um valor de 100 cria uma margem de 1 polegada.

SET MATH <TO> {FIRST | LAST | MIN | MAX}

SET MATH TO MIN

Configuração padrão: MAX

Especifica como a precisão decimal funciona quando dois operandos são avaliados em uma expressão numérica.

  • FIRST use o número de casas decimais do primeiro operando em um par de operandos
  • LAST use o número de casas decimais do último operando em um par de operandos
  • MIN use o número mínimo de casas decimais em um par de operandos
  • MAX use o número máximo de casas decimais em um par de operandos

Em expressões com vários operandos, a configuração SET MATH funciona com base em pares, aplicando a configuração especificada a cada par de operandos, arredondando conforme a necessidade, à medida que os operandos são avaliados na ordem matemática padrão (parênteses, ordem, multiplicação e divisão, adição e subtração).

Se a configuração SET MATH reduzir o número de casas decimais em um resultado, este será arredondado e não truncado.

Para obter mais informações, consulte Controlar arredondamentos em expressões numéricas.

Nota

Não é possível usar SET MATH enquanto uma tabela do Analytics estiver aberta.

SET MONTHS <TO> cadeia

Especifica as abreviações de três caracteres para nomes do mês. O parâmetro cadeia é a lista de abreviações de meses separadas por vírgula.

SET NOTIFYFAILSTOP {ON | OFF}

SET NOTIFYFAILSTOP ON

Configuração padrão: OFF

  • NOTIFYFAILSTOP está OFF o Analytics permite a continuidade do script, mesmo em caso de falha de um comando NOTIFY no script.
  • NOTIFYFAILSTOP está ON o Analytics interrompe o processamento do script e grava uma mensagem no log em caso de falha de um comando NOTIFY no script. O script é interrompido após a falha inicial ou após a quantidade especificada em NOTIFYRETRYATTEMPTS, caso nenhuma das tentativas obtenha sucesso.

SET NOTIFYRETRYATTEMPTS <TO> num

SET NOTIFYRETRYATTEMPTS TO 10

Especifica o número de vezes que o comando NOTIFY deve tentar enviar um e-mail se a tentativa inicial falhar. Insira um número de 0 a 255. Caso seja usado 0, nenhuma tentativa adicional é feita após a primeira falha. O valor padrão é 5.

Um possível motivo para que o comando NOTIFY falhe ao enviar um e-mail é a indisponibilidade do servidor de e-mail.

SET NOTIFYRETRYINTERVAL <TO> segundos

SET NOTIFYRETRYINTERVAL TO 30

Especifica a quantidade de tempo em segundos entre NOTIFYRETRYATTEMPTS. Insira um número entre 1 e 255. O valor padrão é 10 segundos.

SET ORDER <TO> valores

Especifica a sequência de ordenação dos campos de caractere. O parâmetro valores lista todos os caracteres da ordem de classificação selecionada.

SET OVERFLOW {ON | OFF}

SET OVERFLOW OFF

Configuração padrão: ON

Se OFF for especificado, o Analytics não interromperá o processamento quando ocorrer um erro de estouro.

SET PASSWORD num <TO> cadeia

SET PASSWORD 1 TO "senha123"

Usado para criar uma definição de senha e especificar um valor de senha para execução autônoma do script.

O parâmetro num identifica unicamente a definição de senha e deve ser um valor entre 1 e 10. Especifique o valor da senha como uma cadeia entre aspas.

SET PERIODS <TO> valor <;...n>

SET PERIODS TO "0,30,90,180,10000"

Especifica os períodos de vencimento padrão usados pelo comando AGE.

SET PICTURE formato

SET PICTURE "(9.999.999,99)"

Especifica a formatação padrão de valores numéricos.

SET READAHEAD <TO> tamanho

Especifica o tamanho da leitura do bloco de dados. Somente modifique essa configuração se aconselhado pelo Suporte.

SET RETRY <TO> num

SET RETRYIMPORT <TO> num

SET RETRY TO 50

Especifica o número de vezes que o Analytics tenta importar ou exportar dados se a tentativa inicial falhar. Insira um número de 0 a 255. Caso seja usado 0, nenhuma tentativa adicional é feita após a primeira falha. O padrão é 0.

Não há um período de espera entre as novas tentativas. Cada tentativa sucessiva é feita imediatamente após a falha precedente.

A capacidade de especificar novas tentativas é útil para fazer a conexão a bancos de dados ou serviços de dados de nuvem, que podem estar temporariamente indisponíveis.

Aplicável aos seguintes comandos:

  • ACCESSDATA
  • IMPORT GRCPROJECT
  • IMPORT GRCRESULTS
  • IMPORT SAP
  • RETRIEVE
  • REFRESH

    (para tabelas criadas inicialmente usando apenas ACCESSDATA ou IMPORT SAP)

  • EXPORT . . . ACLGRC

    (exportar para o Resultados do HighBond)

Nota

SET RETRYIMPORT é mantido para compatibilidade retroativa. SET RETRYIMPORT e SET RETRY executam ações idênticas.

SET SAFETY {ON | OFF}

SET SAFETY OFF

Especifique ON para exibir uma caixa de diálogo de confirmação ao sobrescrever os seguintes itens:

  • campos nos layouts de tabela

  • Tabelas do Analytics

  • arquivos, incluindo arquivos de dados do Analytics (.fil)

Especifique OFF para evitar a exibição da caixa de diálogo.

A especificação de SET SAFETY sem qualquer parâmetro na linha de comando exibe o estado de ativação de SAFETY.

SET SEPARATORS <TO> valores

SET SEPARATORS TO ",.;"

Especifica os separadores de casas decimais, milhares e de lista usados pelo Analytics. Os valores SET SEPARATORS devem ter caracteres separadores válidos na seguinte ordem:

  • casa decimal (ponto, vírgula ou espaço)

  • milhares (ponto, vírgula ou espaço)

  • lista (ponto e vírgula, vírgula ou espaço)

Entre os três separadores, o separador de casas decimais deve ser exclusivo. Você deve especificar todos os três separadores ao usar o comando. O separador de lista é usado principalmente para separar os parâmetros de função.

SET SESSION <nome_sessão>

SET SESSION
SET SESSION "Análise"

Cria uma nova sessão no log de comandos do Analytics. A sessão é identificada pelo carimbo de data/hora atual.

O nome_sessão opcional permite acrescentar até 30 caracteres de informações de identificação adicionais. Aspas são permitidas, mas não obrigatórias.

SET SORTMEMORY num

SET SORTMEMORY 800

Especifica a memória máxima alocada para processos de classificação e indexação. O parâmetro num deve ser um valor de 0 a 2.000 megabytes (MB), a ser inserido em incrementos de 20 MB. Se a memória de classificação for definida como 0, o Analytics usará a memória disponível no momento.

SET SUPPRESSTIME {ON | OFF}

SET SUPPRESSTIME ON

Configuração padrão: OFF

Para uso apenas na definição de uma tabela do Analytics que use uma fonte de dados ODBC (comando IMPORT ODBC) ou acesso direto a um banco de dados (comando DEFINE TABLE DB).

Se você usa o parâmetro ON, o Analytics suprime a parte de hora de valores datahora na definição da tabela. Por exemplo, 20141231 235959 é lido, exibido e processado subsequentemente como 20141231.

A inclusão desse comando em um script do Analytics anterior a datahora (anterior à versão v.10.0) que assume que a parte de hora dos dados de data hora será truncada permite que o script execute na versão do Analytics com suporte a datahora.

O Analytics suprime a parte de hora usando apenas a parte de data do formato de datahora. Os dados de hora continuam presentes no arquivo .fil ou na tabela do banco de dados. Se necessário, você pode redefinir o campo ou definir um novo campo para incluir a parte de hora dos dados.

Se SET SUPPRESSTIME = OFF, as tabelas do Analytics que usam ODBC ou acesso direto ao banco de dados incluem valores completos de datahora.

Você pode executar o comando SET SUPPRESSTIME ON/OFF em um script ou da linha de comando.

A execução de SET SAFETY, sem qualquer parâmetro, na linha de comando exibe o estado de ativação da supressão da parte de hora dos dados de datahora.

SET SUPPRESSXML {ON | OFF}

SET SUPPRESSXML ON

Configuração padrão: OFF

Especifica que a saída do comando é em texto simples, e não texto formatado.

SET TEST {ON | OFF}

SET TEST ON

Especifica se os resultados dos testes IF, WHILE, FOR e NEXT associados com os comandos GROUP devem ser gravados no log.

SET TIME <TO> cadeia

SET TIME "hh:mm:ss PM"

Especifica como o Analytics exibe a parte de hora de datahoras e valores de hora independentes em exibições, relatórios e arquivos exportados.

Ao usar o comando SET TIME para especificar formatos de hora personalizados, você deve usar 'h' para hora, 'm' para minuto e 's' para segundo, mesmo se caracteres de formato de hora diferentes tenham sido especificados na caixa de diálogo Opções Por exemplo:

SET TIME TO "hh:mm"

SET UTCZONE {ON | OFF}

SET UTCZONE OFF

Configuração padrão: ON

  • UTCZONE está ON o Analytics altera a exibição de horas locais com um ajuste de UTC para o UTC equivalente à hora local. (UTC é o Tempo Universal Coordenado, o tempo em vigor em zero graus de longitude.)
  • UTCZONE está OFF o Analytics exibe horas locais com um ajuste de UTC, sem convertê-las ao UTC.

Por exemplo:

  • 01 Jan 2015 04:59:59 (SET UTCZONE ON)
  • 31 Dez 2014 23:59:59-05:00 (SET UTCZONE OFF)

A conversão de hora local para UTC é apenas para fins de exibição e não afeta os dados originais. Você pode alternar entre os dois modos de exibição sempre que quiser.

SET VERIFY {ON | OFF | BLANK}

SET VERIFY ON

Quando ON for especificado, o Analytics automaticamente verificará o conteúdo de um campo de dados correspondente ao tipo de dados do campo no layout da tabela, sempre que uma tabela for aberta. Quando BLANK for especificado, o Analytics substituirá os dados de caracteres inválidos por brancos e os dados numéricos inválidos com zeros, além da verificação descrita para o parâmetro ON.

SET WIDTH <TO> caracteres

SET WIDTH TO 20

Especifica a largura da exibição padrão em caracteres para campos numéricos calculados, ou expressões numéricas ad hoc, quando o Analytics não pode determinar a largura máxima.

Guia de scripting do ACL 14.1