Sustitución de URI

El sistema soporta la capacidad de definir variables de sustitución (a veces denominadas tokens) para los valores de URL y los valores de ruta de acceso a archivo que hacen referencia a ubicaciones de almacenamiento de archivos nativos. Para los URLs, el sistema soporta la definición de variables en un archivo de propiedades de Variable de Sustitución. Para las rutas de almacenamiento de archivos nativos, existen dos opciones: el archivo de propiedades de Variable de Sustitución o una lista de valores ampliada de configuración de Almacenamiento de Archivo. A continuación, se proporcionan más detalles acerca de estas dos opciones.

  • Archivo de propiedades de variables de sustitución. En un archivo de propiedades, se puede configurar una variable de sustitución para toda la definición de URI o para una parte de ella. Esto permite a los administradores del sistema definir las ubicaciones de Identificador Uniforme de Recursos correctas en un archivo de propiedades, mientras que los usuarios de configuración solo necesitan conocer el nombre de la variable. Por ejemplo, al definir la ubicación de un archivo de extracción en un trabajo en lote de extracción, en lugar de escribir la ruta de archivo h:\oracle\serverName\1.0.0.0\batch\extract\, el usuario de lote puede ingresar @FILE_​EXTRACT@, suponiendo que hay una entrada en el archivo de variables de sustitución con el nombre FILE_​EXTRACT y el valor h:\oracle\serverName\1.0.0.0\batch\extract\. Otro ejemplo sería que el usuario de lote ingresara @BATCH_​FILES@\extract\, suponiendo que la variable de Identificador Uniforme de Recursos de BATCH_​FILES estuviera definida como h:\oracle\serverName\1.0.0.0\batch\.

    Nota: El producto completa automáticamente el valor de SPLOUTPUT en el archivo de propiedades para que se pueda utilizar en la configuración de URI. Además, el producto puede proporcionar algunos nombres de variables predefinidos para otras referencias comunes. Como parte de esto, el menú "avanzado" de los pasos de instalación del sistema puede solicitar a los instaladores que definan los valores de estas variables predefinidas, si lo desean. Las instalaciones pueden optar por definir variables de sustitución adicionales para diversas referencias de Identificadores Uniformes de Recursos. Consulte la Guía de Administración del Sistema para obtener más información.

  • Lista de valores ampliada de Almacenamiento de Archivo. Específicamente para las rutas de acceso a archivo que hacen referencia al sistema de archivos nativos, el sistema soporta la capacidad de definir una ruta mediante la lista de valores ampliada de Configuración de Almacenamiento de Archivo. En los siguientes puntos, se realzan los pasos que deben realizarse para esta opción.

    • Navegue hasta Lista de Valores Ampliada y busque la lista de valores Configuración de Almacenamiento de Archivo.

    • Haga click en Agregar para crear un nuevo registro. Defina un nombre de valor de lista de valores. Este se utilizará al configurar una ruta de acceso a archivo que use este valor. Seleccione el valor de Adaptador de Archivo de Almacenamiento de Archivos Nativos. Ingrese el valor deseado para la ruta de acceso a archivo. Los valores definidos aquí, a su vez, pueden hacer referencia a los valores definidos en el archivo de propiedades de Variables de Sustitución. Por ejemplo, la ruta de acceso a archivo puede hacer referencia a @SPLOUTPUT@.

    • Para hacer referencia a este valor en la configuración del sistema, use la sintaxis file-storage://XXXX, donde XXXX es el valor de lista de valores ampliada. Usando el ejemplo anterior, si define un valor de lista de valores ampliada de CM-FileExtract con la ruta de acceso a archivo h:\oracle\serverName\1.0.0.0\batch\extract\, al configurar la ruta de acceso a archivo de extracción para un trabajo de extracción en lote, ingrese file-storage://CM-FileExtract. En otro ejemplo, si la ruta de acceso a archivo del valor de lista de valores ampliada se configura en h:\oracle\serverName\1.0.0.0\batch\, el usuario que configura la ruta de acceso a archivo en la extracción en lote puede ingresar file-storage://CM-FileExtract/extract.

¿Cuándo debe definir variables de sustitución en el archivo de propiedades y cuándo debe definirlas en la lista de valores ampliada? En los siguientes puntos, se realzan las diferencias entre las opciones que pueden ayudar a tomar esta decisión.

  • Las variables de sustitución para los URLs solo se soportan mediante el archivo de propiedades.

  • Por lo general, el archivo de propiedades solo puede ser modificado por un administrador de sistema. Si en el momento de la instalación se definieron valores que no cambian, puede ser beneficioso definir los valores en el archivo de propiedades.

  • Al definir entornos adicionales, como entornos de prueba o producción, los valores de la lista de valores ampliada se pueden copiar mediante el Asistente de Migración de Configuración. Idealmente, los valores se definen de modo que sean iguales entre las distintas regiones.