Variáveis de ambiente em caminhos de saída

É possível padronizar os caminhos de saída listados nas especificações de documentos com variáveis de ambiente. Crie uma variável de ambiente para um local de saída comum e, em seguida, especifique essa variável de ambiente com o nome do arquivo individual na especificação do documento.

A sintaxe para especificar as variáveis de ambiente é a mesma daquela usada em pré e pós-comandos; o nome da variável deve ser colocado entre ${variable_name}. Exemplo: ${MY_RPE_OUTPUT}\defectData\testData.pdf

Nota: As variáveis de ambiente podem ser configuradas para:
  • Um perfil do usuário: Variáveis de perfil do usuário são acessíveis apenas pelo usuário que efetuou login.
  • O sistema: Variáveis do sistema são acessíveis por qualquer usuário que efetua login no computador.
Se você estiver usando variáveis de ambiente definidas para um perfil de usuário específico, deverá gerar documentos com a mesma conta de usuário. Caso contrário, a variável de ambiente não poderá ser localizada.

Se uma especificação de documento que contém uma variável de ambiente for movida para outro computador, você deverá configurar a variável de ambiente no computador também para que a especificação de documento seja executada com êxito.

Vantagens de usar variáveis de ambiente em vez de caminhos absolutos

  • Se você precisar alterar o local comum dos arquivos de saída para outra pasta ou servidor, poderá atualizar a variável de ambiente. Não é necessário modificar cada especificação de documento individualmente.
  • Você pode controlar a saída de um relatório com a API da linha de comandos.

Exemplo

Criando uma variável de ambiente de exemplo no Microsoft Windows:
  1. Clique com o botão direito no ícone Computador.
  2. Selecione Configurações avançadas do sistema.
  3. Clique em Propriedades.
  4. Selecione a guia Avançado.
  5. Clique em Variáveis de Ambiente.
  6. Na seção Variáveis do sistema, clique em Novo.
  7. Insira um Nome de variável. Exemplo: MY_RPE_OUTPUT
  8. Insira um Valor de variável. Exemplo: d:\myreports
  9. Clique em OK em cada janela para para salvar e fechar.
Consulte a documentação para seu sistema operacional para obter informações adicionais sobre como criar variáveis de ambiente em seu sistema.
Especificando a variável de ambiente no caminho de saída de especificação do documento:
  1. No aplicativo Launcher, crie uma especificação do documento.
  2. Na visualização Especificação do documento, selecione um tipo de saída. Exemplo: Destino: PDF
  3. Clique com o botão direito no tipo de saída e selecione Configurar saída.
  4. No campo Caminho, insira o caminho para o arquivo de saída. Exemplo: ${MY_RPE_OUTPUT}\defectData\testData.pdf
  5. Clique em OK.
  6. Publique um documento de teste e verifique se a saída foi gerada no local correto.