importSnapshot

Importa el contenido de una instantánea en el entorno de servicio. La instantánea que importe debe estar disponible en la ubicación de carga predeterminada.

Utilice el comando uploadFile para cargar una instantánea, o el comando copySnapshotFromInstance para copiarla de otra instancia.

Los siguientes elementos no forman parte de las instantáneas de aplicación de Planning, Planning Modules y FreeForm:
- Datos de auditoría
- Datos de la consola de trabajos
Use el comando cloneEnvironment o la función Clonar entorno si desea copiar los datos de auditoría y de la consola de trabajos en el entorno de destino.
La importación de la instantánea puede fallar si el proceso de negocio de Planning contiene un miembro de período definido cuyo nombre se ha cambiado que se ha suplantado por un miembro de período personalizado. Por ejemplo, si ha cambiado el nombre del miembro de período YearTotal definido a unused_YearTotal y, a continuación, ha agregado, un miembro de período de tipo alternativo con el nombre de miembro definido original (YearTotal en este ejemplo). En este escenario, la importación de la instantánea puede fallar.
Las instantáneas no contienen los datos de la tabla temporal de Data Management. Para importar estos datos, use los comandos exportDataManagement y importDataManagement o la interfaz de scripts de mantenimientos del sistema de Data Management. Puede usar el comando cloneEnvironment o la función Clonar entorno para crear una copia idéntica del entorno, incluidos los datos de la tabla temporal de Data Management.

Las actividades que puede realizar con este comando dependen de su rol.

Los administradores de servicio solo pueden importar artefactos de aplicación en un entorno.
Necesita los roles de administrador del servicio y administrador del dominio de identidad para importar contenido de la aplicación en el entorno de servicio, y artefactos de dominio de identidad (usuarios y sus asignaciones de roles predefinidas) en el dominio de identidad del entorno.
Si se hace referencia a un usuario que no está en el dominio de identidad en la instantánea que se está importando, EPM Automate crea un usuario en el dominio de identidad y asigna la contraseña predeterminada que se especifica en el comando, o bien una contraseña única temporal a cada usuario si no especifica una contraseña en el comando. Por defecto, será necesario que el usuario restablezca la contraseña durante el primer inicio de sesión.

Nota:

En el caso de procesos de negocio que no sean de Account Reconciliation, Profitability and Cost Management ni de Oracle Enterprise Data Management Cloud: al cargar los metadatos, Oracle Enterprise Performance Management Cloud puede hacer varias transferencias de carga si en el intento anterior se han rechazado registros porque los miembros compartidos aparecían antes que los miembros base en el esquema. Estos intentos pueden aumentar el tiempo de procesamiento del comando.
A los usuarios que sean miembros de grupos en Control de acceso se les debe asignar un rol predeterminado. No están permitidos los intentos de asignar a un grupo un usuario que no esté previamente asignado a un rol predefinido.

Se aplica a

Planning, Planning Modules, FreeForm, Financial Consolidation and Close, Tax Reporting, Account Reconciliation, Profitability and Cost Management, Enterprise Profitability and Cost Management, Oracle Enterprise Data Management Cloud, Sales Planning y Strategic Workforce Planning.

Roles necesarios

Administrador del servicio, Usuario avanzado asignado al rol de aplicación Administrador de migraciones

Se necesita el rol Administrador de dominio de identidad para importar usuarios y asignaciones de roles predefinidas.

Sintaxis

epmautomate importSnapshot SNAPSHOT_NAME [importUsers=true|false] [userPassword=DEFAULT_PASSWORD] [resetPassword=true|false]

, donde:

SNAPSHOT_NAME es el nombre de una instantánea de la ubicación de carga predeterminada.
importUsers, opcionalmente, especifica si se van a importar los usuarios y sus asignaciones de roles predefinidos de la instantánea. El valor predeterminado es false. Use importUsers=true para importar usuarios y asignaciones de roles predefinidos en el dominio de identidad si la instantánea de origen contiene datos sobre los usuarios nuevos o si se han asignado nuevos roles a los usuarios actuales.
Los valores de User Login no distinguen mayúsculas y minúsculas. Por ejemplo, el valor de inicio de sesión del usuario jane.doe@example.com se considera que es idéntico a Jane.Doe@Example.com o a cualquier variación de sus mayúsculas o minúsculas. Si cualquiera de las variaciones encuentra una coincidencia con una conexión de usuario existente en el dominio de identidad, con este comando no se importa el usuario de la instantánea.
Nota:
- La importación de usuarios y sus roles predefinidos falla si un usuario que no es un Administrador de dominio de identidad realiza la operación de importación. Se registrará el siguiente error en el Informe de estado de la migración: Error al importar el artefacto del directorio externo ARTIFACT_NAME. El usuario USER_NAME no tiene autorización para realizar esta operación. El usuario debe tener el rol de administrador de dominio de identidad para realizar esta operación.
- Si no importa los usuarios y un usuario de la instantánea de origen no está asignado a un rol predefinido en el entorno de destino, se muestra un error (EPMIE-00070: Error al buscar el usuario durante la importación de las funciones asignadas).
- Los cambios en los roles predefinidos del usuario se actualizarán en función de los roles asignados en la instantánea de origen. Sin embargo, las asignaciones de roles del destino no se eliminarán para que coincidan con las de la instantánea de origen. Por ejemplo, asuma que a jdoe se le ha asignado el rol predefinido Usuario avanzado en el entorno de destino, pero solo tiene el rol Usuario en la instantánea de origen. En esta situación, este comando asigna a jdoe el rol Usuario y no elimina la asignación de rol Usuario avanzado en el entorno de destino.
- Con este comando no se suprimen los usuarios existentes del entorno de destino si no existen en la instantánea de origen. Por ejemplo, jdoe tiene una cuenta en el entorno de destino, pero esta cuenta no está en la instantánea de origen. En esta situación, la cuenta de jdoe en el entorno de destino no se suprime.
- Con este comando se agregan usuarios que no existan en el entorno de destino; no se actualizan las propiedades del usuario actual en el entorno de destino, incluso aunque sean distintos en la instantánea de origen. Por ejemplo, si el apellido de jdoe en la instantánea de origen está escrito de forma distinta en el entorno de destino, el cambio no se realizará en el entorno de destino.
- Con este comando no se cambian las contraseñas de los usuarios existentes en el entorno de destino, incluso aunque sean diferentes en las instantáneas de origen.
userPassword, opcionalmente, indica la contraseña predeterminada que asignar a los nuevos usuarios que se crean en el dominio de identidad. La contraseña que especifique debe cumplir los requisitos mínimos para contraseñas. Si no especifica un valor para este parámetro, se asigna una contraseña temporal única a cada usuario.
resetPassword, opcionalmente, indica si el nuevo usuario debe cambiar la contraseña la primera vez que inicia sesión. El valor predeterminado es true, que exige que los usuarios nuevos cambien la contraseña la primera vez que inicien sesión. Si este valor se establece en true, los usuarios nuevos recibirán mensajes de correo electrónico de activación de la cuenta en que se le solicite que cambien las contraseñas.

Ejemplos

Importe solo los artefactos de aplicación: epmautomate importSnapshot April16FullApp
Importe artefactos de dominio de identidad y de la aplicación (se necesitan roles de administrador del servicio y de administrador de dominio de identidad):
- Asigne una contraseña temporal única a cada usuario nuevo y fuerce a los usuarios a restablecerla tras iniciar sesión la primera vez:
  epmautomate importSnapshot April16FullApp importUsers=true
- Asigne una contraseña específica y permita a los usuarios no cambiarla si así lo deciden. No se recomienda para importaciones en entornos de producción:
  epmautomate importSnapshot April16FullApp importUsers=true userPassword=P@ssw0rd1 resetPassword=false