Trabajar con plantillas

Las plantillas permiten almacenar la información de configuración de aplicación y dimensión o la información de metadatos seleccionada en un archivo fuera de línea para su uso en otros entornos de Oracle Fusion Cloud Enterprise Data Management.

Utilice plantillas para transferir aplicaciones, dimensiones u objetos de metadatos específicos entre entornos (por ejemplo, de un entorno de prueba a un entorno de producción) o para conseguir un inicio rápido en nuevas implantaciones.

Cloud EDM soporta dos tipos de exportaciones de plantillas:

Exportación de aplicación: permite exportar aplicaciones o dimensiones completas junto con todos los objetos de metadatos relacionados.
Exportación granular: permite exportar objetos de metadatos seleccionados individualmente entre tipos de artefactos soportados para realizar migraciones incrementales más específicas.

Para utilizar una plantilla, debe exportar el contenido del entorno de origen a un archivo .json y, a continuación, importar esa plantilla en el entorno de destino.

Para las exportaciones de aplicaciones, debe exportar una aplicación o una dimensión completa y todos sus metadatos relacionados.
Para las exportaciones granulares, seleccione objetos de metadatos específicos (entre uno o más tipos de artefactos) para incluirlos en la plantilla.

Las plantillas solo contienen metadatos y no incluyen ningún dato, solicitud ni historial de transacciones.

Mejores prácticas

Si desea crear una aplicación en un entorno de prueba que pretende transferir a un entorno de producción existente, se recomienda refrescar primero el entorno de prueba con una instantánea actual del entorno de producción y, a continuación, crear la aplicación que se va a transferir. De este modo, se garantiza que los objetos globales, como las propiedades y las vistas, tengan los mismos identificadores en ambos entornos.

Caution:

Las plantillas están diseñadas para migrar cambios de un entorno a otro. Por este motivo, es importante designar un sistema de origen en el que se realicen todos los cambios y un sistema de destino al que se migran los cambios. No realice cambios en ambos entornos. Puede utilizar las instantáneas de migración para volver a sincronizar sus entornos si es necesario. Consulte Mejores prácticas en Ejemplos de escenarios de migración.

Consideraciones

Debe ser administrador del servicio o tener el rol granular Migraciones - Administrar (consulte Descripción de roles y permisos granulares) para importar y exportar aplicaciones y dimensiones en plantillas.
Las exportaciones de aplicaciones incluyen dimensiones o aplicaciones completas y todos los artefactos dependientes (como conexiones globales). Las exportaciones granulares incluyen solo los objetos de metadatos seleccionados y no incluyen automáticamente todas las dependencias. Al utilizar exportaciones granulares, asegúrese de que los objetos dependientes necesarios existen en el entorno de destino o se incluyen en la plantilla para evitar errores de importación.
Cuando se transfiere una aplicación al entorno de destino:
- Si la persona responsable de la aplicación del entorno de origen también existe en el entorno de destino, se conserva como persona responsable de la aplicación en el entorno de destino.
- Si la persona responsable de la aplicación del entorno de origen no existe en el entorno de destino, un administrador del servicio debe asignar una persona responsable a la aplicación en el entorno de destino.
Puede transferir aplicaciones, dimensiones u objetos de metadatos soportados nuevos o existentes. El proceso de importación de plantilla actualiza aplicaciones, dimensiones u objetos de metadatos existentes en el entorno de destino mediante la creación de objetos que no existen todavía y la modificación de objetos existentes. Consulte Actualización de un artefacto existente mediante una plantilla.
Solo se pueden transferir aplicaciones activas.
Debe excluir los objetos de cadena de datos archivados de las importaciones de plantilla si los objetos archivados en el entorno de origen no existen aún en el entorno de destino

Note:
Los objetos que dependen de un objeto archivado también se excluyen de la importación de plantilla si no existen en el entorno de destino. Si se excluyera parcialmente un objeto dependiente, el objeto aparecerá en la vista previa de plantilla o se importará con un mensaje de advertencia que indique que no se ha podido importar.
Por ejemplo, si excluye una dimensión archivada durante la importación y la dimensión aún no existe en el entorno de destino, los objetos como los enlaces de dimensión, los tipos de nodo, las políticas y las extracciones también se excluyen de la importación de plantilla si aún no existen en el entorno de destino.
Puede transferir tanto aplicaciones como dimensiones en un solo archivo de plantilla. Por ejemplo, puede seleccionar una aplicación de GL y dos dimensiones de una aplicación de Planning. Sin embargo, tenga en cuenta que, al seleccionar una aplicación, se incluirán automáticamente todas las dimensiones de esa aplicación. No puede seleccionar una aplicación y, a continuación, seleccionar solo un subconjunto de dimensiones de esa aplicación. Por lo tanto, si la aplicación de GL tiene tres dimensiones, puede seleccionar dos dimensiones, pero si selecciona toda la aplicación, las tres dimensiones se incluirán automáticamente.

Tip:
Si tiene conversores de tipo de nodo o suscripciones en varias aplicaciones, puede ser útil transferir esas aplicaciones y dimensiones en un único archivo de plantilla. Por ejemplo, si tiene una suscripción entre un punto de vista Cuenta en una aplicación de GL y un punto de vista Cuenta en una aplicación de Planning, puede transferir la aplicación de GL y la dimensión Cuenta en la aplicación de Planning que contenga el punto de vista de suscripción en un único archivo de plantilla.
Al transferir dimensiones, la aplicación que contiene la dimensión debe existir en el entorno de destino.
Para transferir una aplicación o dimensión entre entornos, ambos entornos deben ser de la misma versión.
Al importar una plantilla, si un usuario o un grupo existe tanto en el entorno de origen como en el de destino, se importan las siguientes referencias de usuario y grupo de los objetos asociados:
- Permisos
- Usuarios y grupos de política
- Personas asignadas de suscripción
- Filtros de vista para usuarios y grupos
Si un usuario o un grupo del entorno de origen no existe en el destino, no se transfiere la referencia de usuario o grupo asociada. Aparecerá un mensaje que indica los usuarios y los grupos que faltan en el entorno de destino y los objetos asociados que no se han importado.
Tanto las aplicaciones o dimensiones de origen como las de destino deben existir en el entorno de destino para importar los conversores de tipo de nodo y las suscripciones. Transfiera tanto las aplicaciones de origen como de destino en el mismo archivo de plantilla, o bien asegúrese de importar primero la aplicación o dimensión de origen para los conversores y las suscripciones, de modo que al importar la aplicación o dimensión de destino se creen los conversores y las suscripciones.
Si está transfiriendo una dimensión con propiedades que usan un tipo de datos de nodo para hacer referencia a otras dimensiones, esas dimensiones de origen ya deben existir en el sistema de destino. Si no es el caso, transfiera esas dimensiones de origen primero o use una plantilla de aplicación para transferir todas las dimensiones en el mismo archivo de plantilla.
Cuando se importan los siguientes objetos globales, si el objeto ya existe en el entorno de destino con el mismo nombre pero un identificador diferente, se cambia el nombre del objeto de origen en el entorno de destino para que sea único:
- Propiedades
- Vistas
- Conjuntos de búsquedas
- Conexiones globales
Después de importar una aplicación o dimensión a una plantilla, puede revisar el contenido del archivo de plantilla en un visor de .json.

Caution:
La edición manual del archivo de plantilla no está soportada.