Substituição de URI

O sistema oferece suporte à definição de variáveis de substituição (às vezes chamadas de tokens) para valores de URL e de caminhos de arquivos que façam referência a locais nativos de armazenamento de arquivos. Para URLs, o sistema oferece suporte à definição de variáveis em um arquivo de propriedades Variável de Substituição. Para caminhos nativos de armazenamento de arquivos, há duas opções: o arquivo de propriedades Variável de Substituição ou através de uma consulta extensível de configuração de Armazenamento de Arquivos. Veja mais detalhes sobre essas opções abaixo.

  • Arquivo de propriedades de variáveis de substituição. Uma variável de substituição de parte ou de toda a definição do URI pode ser configurada em um arquivo de propriedades. Isso possibilita que os administradores do sistema definam os locais de URI corretos em um arquivo de propriedades, enquanto os usuários de configuração precisam saber apenas o nome da variável. Por exemplo, ao definir o local de um arquivo de extração em uma tarefa em batch de extração, em vez de digitar o caminho do arquivo h:\oracle\serverName\1.0.0.0\batch\extract\, o usuário batch pode informar @FILE_​EXTRACT@, pressupondo que haja uma entrada no arquivo de variáveis de substituição com o nome FILE_​EXTRACT e o valor h:\oracle\serverName\1.0.0.0\batch\extract\. Outro exemplo é que o usuário batch pode informar @BATCH_​FILES@\extract\, pressupondo que a variável de URI de BATCH_​FILES esteja definida como h:\oracle\serverName\1.0.0.0\batch\.

    Observação: O produto preenche automaticamente o valor de SPLOUTPUT no arquivo de propriedades que pode ser utilizado na configuração do URI. Além disso, o produto disponibiliza nomes de variáveis pré-definidos para outras referências comuns. Consequentemente, o menu 'avançado' nas etapas de instalação do sistema pode solicitar que os instaladores definam valores para essas variáveis predefinidas, se desejado. Na instalação, é possível optar por definir variáveis de substituição adicionais para várias referências de URI. Para obter mais informações, consulte o System Administration Guide.

  • Consulta extensível de Armazenamento de Arquivos. Especificamente para caminhos de arquivos que façam referência ao sistema nativo de arquivos, o sistema também oferece suporte à definição de um caminho usando a consulta extensível Configuração de Armazenamento de Arquivos. Os pontos a seguir destacam as etapas necessárias para essa opção.

    • Acesse Consulta Extensível e procure pela consulta Configuração do Armazenamento de Arquivo.

    • Clique em Adicionar para criar uma nova entrada. Defina o nome do valor da consulta. Isso será usado ao configurar um caminho do arquivo que usará esse valor. Escolha o valor do Adaptador de Arquivo Armazenamento Nativo de Arquivos. Insira o valor do caminho de arquivos desejado. Os valores definidos aqui podem fazer referência a valores definidos no arquivo de propriedades Variáveis de Substituição. Por exemplo, o caminho de arquivos pode fazer referência a @SPLOUTPUT@.

    • Para fazer referência a esse valor nas configurações do sistema, use a sintaxe file-storage://XXXX, em que XXXX é o valor da consulta extensível. Usando o mesmo exemplo acima, se você definir um valor de consulta extensível de CM-FileExtract com um valor de caminho de h:\oracle\serverName\1.0.0.0\batch\extract\, então, ao configurar o caminho de extração de arquivo de uma tarefa de extração em batch, insira file-storage://CM-FileExtract. Outro exemplo: se o caminho do arquivo do valor da consulta extensível for configurado como h:\oracle\serverName\1.0.0.0\batch\, então o usuário que configura o caminho do arquivo na extração em batch inserirá file-storage://CM-FileExtract/extract

Quando deve-se definir variáveis de substituição no arquivo de propriedades e quando deve-se defini-las na consulta extensível? Os pontos a seguir destacam as diferenças entre as opções que podem ajudar nessa escolha.

  • As variáveis de substituição dos URLs são compatíveis apenas por meio do arquivo de propriedades.

  • O arquivo de propriedades pode ser modificado apenas por um administrador do sistema. Se houver valores que estejam definidos no horário da instalação e não se alterem, definir os valores no arquivo de propriedades poderá ser benéfico.

  • Ao definir ambientes adicionais, como ambientes de teste ou de produção, os valores na consulta extensível poderão ser copiados usando CMA. Idealmente, os valores são definidos de modo que são iguais entre várias regiões.