Como funcionam os arquivos de preferência do Analytics

Nota

O comportamento do arquivo de preferências foi alterado na versão 10.0 do Analytics. Este tópico explica como os arquivos de preferências funcionam na versão 10.0 e posteriores.

As definições para as opções configuráveis no Analytics – ou seja, as configurações da caixa de diálogo Opções – estão gravadas em um arquivo de preferências (arquivo .prf) chamado aclwin18.prf (edição não Unicode) ou acl18.prf (edição Unicode).

Qualquer mudança que você fizer na caixa de diálogo Opções será salva automaticamente no arquivo .prf. As mudanças permanecerão em efeito até que você as altere explicitamente outra vez.

Arquivos de preferências globais versus específicas do projeto

Um único arquivo .prf global pode controlar o comportamento do Analytics e todos os projetos do Analytics que você abrir ou você pode associar diferentes arquivos .prf com projetos do Analytics individuais como uma forma de personalizar as preferências a cada projeto. Por exemplo, você pode especificar que diferentes projetos utilizam diferentes formatos de exibição de data, ou que um projeto exclui o arquivo de dados da fonte quando você exclui um layout de tabela, e outro projeto não o faz.

Importância dos criadores de script do Analytics

A compreensão dos arquivos de preferência pode ser importante para autores de scripts do Analytics caso disponibilizem esses scripts para outros usuários do Analytics e precisem controlar as configurações de preferências do Analytics nos computadores dos outros usuários.

Arquivo global de preferências

Quando você instala o Analytics, um arquivo .prf com as definições de configurações padrão (configurações de Fábrica) é criado no seguinte local:

  • A pasta de dados do aplicativoC:\Users\< nome da conta do usuário >\AppData\Local\ACL (local no Windows 10)

Nota

A pasta de dados do aplicativo pode estar escondida pelo sistema operacional do Windows. Se necessário, habilite a pasta do Windows para mostrar arquivos e pastas ocultos.

O arquivo .prf na pasta de dados de aplicativos contém as configurações globais de preferência para o Analytics. Todas as alterações efetuadas na caixa de diálogo Opções são salvas nesse arquivo .prf global, a menos que você use um arquivo .prf específico do projeto.

O arquivo .prf global é usado quando:

  • você abre o Analytics sem abrir um projeto do Analytics
  • você abre um projeto que não tem um arquivo .prf específico do projeto
  • você fecha um projeto sem fechar o Analytics.

Configurações globais de preferência por usuário

Se mais de uma conta de usuário acessar o Analytics no mesmo computador, arquivos .prf separados existem nas pastas de dados do aplicativo para cada conta de usuário, e diferentes usuários podem configurar suas próprias preferências globais.

Arquivo .prf global de regeneração automática

Se o arquivo .prf na pasta de dados do aplicativo for excluído, renomeado ou não puder ser usado por algum outro motivo, um novo arquivo .prf com as definições de configuração padrão será automaticamente criado na pasta de dados do aplicativo quando você abrir o Analytics.

Arquivos de preferências específicos de projetos

Se você quiser customizar as configurações de preferência de um ou mais projetos do Analytics, você pode manualmente copiar o arquivo .prf global da pasta de dados do aplicativo para a pasta contendo o projeto do Analytics individual. O arquivo .prf copiado agora se torna um arquivo .prf específico do projeto.

Cuidado

Se você copiar o arquivo .prf global, tenha o cuidado de não mover inadvertidamente o arquivo em vez de copiá-lo. Se você mover o arquivo, qualquer configuração de preferências globais que você tenha criado serão perdidas e substituídas pela definição de configuração padrão.

Nota

Se você tiver diferentes versões do Analytics instaladas lado a lado, certifique-se de copiar a versão correta do arquivo .prf.

O arquivo de projeto do Analytics com a extensão .acl e o arquivo .prf específico do projeto devem estar na mesma pasta para que a associação entre os dois ocorra. Quando o projeto é aberto, são usadas as configurações de preferências definidas no arquivo .prf específico do projeto. Todas as alterações efetuadas na caixa de diálogo Opções são salvas no arquivo .prf específico do projeto, em vez de no arquivo .prf global.

O benefício dos arquivos .prf específicos do projeto

A vantagem de arquivos .prf específicos do projeto é que você pode customizar preferências com base em solicitações de projetos específicos e script dentro de um projeto.

Se você enviar um projeto do Analytics para outro usuário, também poderá incluir arquivos .prf específicos do projeto para assegurar que, quando o usuário executar qualquer script do projeto, os resultados sejam consistentes com os resultados em seu próprio computador.

Ao mesmo tempo, porque o arquivo .prf é específico do projeto, ele não afeta as configurações de preferências globais do usuário.

Revertendo para o arquivo .prf global

A qualquer momento, você pode reverter utilizando o arquivo .prf global para um projeto excluindo ou renomeando o .prf específico do arquivo.

Identificando quais arquivos de preferência estão sendo usados

O Analytics exibe o caminho do arquivo .prf ativo no momento na parte inferior da caixa de diálogo Opções. Se o caminho para a pasta de dados do aplicativo estiver sendo exibido, o arquivo .prf global está sendo usado. Se um caminho para uma pasta de projeto do Analytics estiver sendo exibida, um arquivo .prf específico do projeto está sendo usado.

Revertendo para as definições de configurações padrão.

Você pode reverter para as definições de configurações padrão (configurações de Original) a qualquer momento, clicando no botão Original na parte inferior da caixa de diálogo Opções. Clicar em Fábrica configura todas as opções em todas as guias de Opções para seus valores padrão, não apenas as opções na guia ativa. A reversão para as configurações-padrão aplica-se apenas ao arquivo .prf ativo exibido na parte inferior da caixa de diálogo Opções.

Ordem de precedência do arquivo de preferências

Um projeto do Analytics está aberto

Quando você abre um projeto do Analytics, um arquivo .prf é carregado utilizando a seguinte ordem de precedência:

  1. O arquivo .prf específico do projeto na pasta contendo o projeto do Analytics
  2. Se nenhum arquivo .prf específico do projeto for encontrado, carregar o arquivo .prf global na pasta de dados do aplicativo
  3. Se nenhum arquivo .prf global for encontrado, recriar automaticamente o arquivo .prf global na pasta de dados do aplicativo utilizando as definições de configurações padrão (configurações de Fábrica) e carregar o arquivo recriado

Nenhum projeto do Analytics está aberto

Quando você abre o Analytics sem abrir um projeto, um arquivo .prf é carregado utilizando a seguinte ordem de precedência:

  1. Arquivo .prf global na pasta de dados do aplicativo
  2. Se nenhum arquivo .prf global for encontrado, recriar automaticamente o arquivo .prf global na pasta de dados do aplicativo utilizando as definições de configurações padrão (configurações de Fábrica) e carregar o arquivo recriado

Criar configurações de preferências aplicadas em uma sessão do Analytics

Você pode usar o comando SET para criar configurações de preferências temporárias aplicadas apenas durante uma sessão do Analytics. Por exemplo, SET DATE "DD MMM YYYY" altera temporariamente o formato de exibição da data.

Esse comportamento se aplica sempre que o comando SET for usado na linha de comando do Analytics ou em um script do Analytics.

Assim que você fechar o Analytics, serão restauradas as configurações armazenadas no arquivo .prf aplicável. O comando SET nunca faz qualquer alteração em um arquivo .prf.

Para obter mais informações, consulte Comando SET.