Trabajar con plantillas

Las plantillas permiten almacenar configuraciones de aplicación o de dimensión en un archivo sin conexión para su uso en otros entornos de Oracle Enterprise Data Management Cloud. Utilice plantillas para transferir aplicaciones o dimensiones y sus objetos de metadatos 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.

Para utilizar una plantilla, primero debe exportar una aplicación o dimensión y todos sus objetos de metadatos relacionados del entorno de origen a un archivo .json y, a continuación, importar esa plantilla en el entorno de destino.

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 de aplicación Migraciones - Administrar (consulte Descripción de los roles y los permisos de aplicación) para importar y exportar aplicaciones y dimensiones en plantillas.
Cuando se transfiere una aplicación al entorno de destino:
- Si el propietario de la aplicación del entorno de origen también existe en el entorno de destino, se conservan como propietario de la aplicación en el entorno de destino.
- Si el propietario de la aplicación del entorno de origen no existe en el entorno de destino, un administrador del servicio debe asignar un propietario a la aplicación en el entorno de destino.
Puede transferir nuevas aplicaciones o dimensiones desde el entorno de origen al de destino, o puede transferir aplicaciones o dimensiones que ya existen en el entorno de destino. El proceso de importación de plantilla actualiza las aplicaciones o dimensiones existentes en el entorno de destino. Para ello, crea objetos que no existen todavía y modifica los objetos existentes de la aplicación o dimensión de destino. Consulte Actualización de aplicaciones o dimensiones existentes con 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 varias aplicaciones en un solo archivo de plantilla. Si está realizando la transferencia en el nivel de dimensión, no puede transferir varias dimensiones en un solo 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.

Para exportar aplicaciones o un dimensión a una plantilla:

En el mosaico Herramientas, seleccione Plantillas.

Note:
El mosaico Herramientas solo es visible para los administradores del servicio o los usuarios con el rol de aplicación Migraciones - Administrar.
En el separador Exportar, realice una acción:
- Para exportar aplicaciones, seleccione una aplicación en el panel de la izquierda. Presione Ctrl/Cmd y haga clic para seleccionar varias aplicaciones. Las aplicaciones que seleccione se muestran en la sección Artefactos seleccionados.
- Para exportar una dimensión, expanda la aplicación en el panel izquierdo y seleccione la dimensión que desea exportar. No puede seleccionar varias dimensiones en un solo archivo de plantilla.
  
  Note:
  Para exportar una dimensión de atributo, seleccione la dimensión base para la dimensión de atributo.
En Archivo de plantilla, introduzca un nombre de archivo con la extensión .json y, a continuación, haga clic en Exportar.
La plantilla se creará y se descargará en el sistema de archivos local. Se mostrará el estado de la exportación.

Para importar una aplicación o dimensión de una plantilla:

En el mosaico Herramientas, seleccione Plantillas.

Note:
Los mosaicos Herramientas y Plantillas solo son visibles para los administradores del servicio o los usuarios con el rol de aplicación Migraciones - Administrar.
En el separador Importar, haga clic en Elegir archivo.
En el sistema de archivos local, seleccione un archivo con la extensión .json y, a continuación, haga clic en Abrir.
Opcional: seleccione una o más Opciones de importación:
- Reemplazar permisos: reemplace los permisos existentes en el entorno de destino por permisos de la plantilla de origen.
- Reemplazar grupos de políticas: reemplace los grupos de políticas existentes en el entorno de destino por grupos de políticas de la plantilla de origen.
- Excluir objetos archivados: excluye los objetos archivados en una plantilla desde un entorno de origen de ser importados en el entorno de destino si los objetos de origen no existen en el entorno de destino.
  
  Note:
  Los objetos archivados en una plantilla de origen que ya existen en el entorno de destino no se pueden excluir de la vista previa o la importación de plantilla.
Consulte Objetos y valores de plantilla.
Haga clic en Vista previa para identificar los objetos del archivo de plantilla y ver el estado de cada uno de ellos. Consulte Vista previa de importaciones de plantillas y revisión de resultados de importaciones.
Haga clic en Importar y, a continuación, haga clic en Sí en el mensaje de confirmación.
Se importará la plantilla y se mostrará el estado de cada objeto de la plantilla. Consulte Vista previa de importaciones de plantillas y revisión de resultados de importaciones.