Download - Trabajar con EPM Automate para Oracle Enterprise ... · Outlook, Visual Studio, Visual Basic, Internet Explorer, Active Directory y SQL Server son marcas comerciales registradas o

Oracle® CloudTrabajar con EPM Automate para Oracle Enterprise Performance

Management Cloud

F28903-01

Oracle Cloud Trabajar con EPM Automate para Oracle Enterprise Performance Management Cloud

F28903-01

Copyright © 2016, 2020, Oracle y/o sus filiales. Todos los derechos reservados.

Autor principal: EPM Information Development Team

Este software y la documentación relacionada están sujetos a un contrato de licencia que incluye restriccionesde uso y revelación, y se encuentran protegidos por la legislación sobre la propiedad intelectual. A menosque figure explícitamente en el contrato de licencia o esté permitido por la ley, no se podrá utilizar, copiar,reproducir, traducir, emitir, modificar, conceder licencias, transmitir, distribuir, exhibir, representar, publicarni mostrar ninguna parte, de ninguna forma, por ningún medio. Queda prohibida la ingeniería inversa,desensamblaje o descompilación de este software, excepto en la medida en que sean necesarios paraconseguir interoperabilidad según lo especificado por la legislación aplicable.

La información contenida en este documento puede someterse a modificaciones sin previo aviso y no segarantiza que se encuentre exenta de errores. Si detecta algún error, le agradeceremos que nos lo comuniquepor escrito.

Si este software o la documentación relacionada se entrega al Gobierno de EE.UU. o a cualquier entidad queadquiera las licencias en nombre del Gobierno de EE.UU. entonces aplicará la siguiente disposición:

U.S. GOVERNMENT END USERS:

Oracle programs, including any operating system, integrated software, any programs installed on thehardware, and/or documentation, delivered to U.S. Government end users are "commercial computersoftware" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplementalregulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, includingany operating system, integrated software, any programs installed on the hardware, and/or documentation,shall be subject to license terms and license restrictions applicable to the programs. No other rights aregranted to the U.S. Government.

Este software o hardware se ha desarrollado para uso general en diversas aplicaciones de gestión de lainformación. No se ha diseñado ni está destinado para utilizarse en aplicaciones de riesgo inherente,incluidas las aplicaciones que pueden causar daños personales. Si utiliza este software o hardware enaplicaciones de riesgo, usted será responsable de tomar todas las medidas apropiadas de prevención defallos, copia de seguridad, redundancia o de cualquier otro tipo para garantizar la seguridad en el uso de estesoftware o hardware. Oracle Corporation y sus filiales declinan toda responsabilidad derivada de los dañoscausados por el uso de este software o hardware en aplicaciones de riesgo.

Oracle y Java son marcas comerciales registradas de Oracle y/o sus filiales. Todos los demás nombrespueden ser marcas comerciales de sus respectivos propietarios.

Intel e Intel Xeon son marcas comerciales o marcas comerciales registradas de Intel Corporation. Todas lasmarcas comerciales de SPARC se utilizan con licencia y son marcas comerciales o marcas comercialesregistradas de SPARC International, Inc. AMD, Opteron, el logotipo de AMD y el logotipo de AMD Opteronson marcas comerciales o marcas comerciales registradas de Advanced Micro Devices. UNIX es una marcacomercial registrada de The Open Group. Microsoft, Windows, PowerPoint, Word, Excel, Access, Office,Outlook, Visual Studio, Visual Basic, Internet Explorer, Active Directory y SQL Server son marcascomerciales registradas o marcas comerciales de Microsoft Corporation en los Estados Unidos y/o en otrospaíses.

Este software o hardware y la documentación pueden proporcionar acceso a, o información sobre contenidos,productos o servicios de terceros. Oracle Corporation o sus filiales no son responsables y por endedesconocen cualquier tipo de garantía sobre el contenido, los productos o los servicios de terceros a menosque se indique otra cosa en un acuerdo en vigor formalizado entre Ud. y Oracle. Oracle Corporation y susfiliales no serán responsables frente a cualesquiera pérdidas, costos o daños en los que se incurra comoconsecuencia de su acceso o su uso de contenidos, productos o servicios de terceros a menos que se indiqueotra cosa en un acuerdo en vigor formalizado entre Ud. y Oracle.

Tabla de contenidos

Accesibilidad a la documentación......................................................................................................... vii

Comentarios sobre la documentación ................................................................................................. ix

1 Acerca de EPM Automate

Instalación de EPM Automate ................................................................................................................ 1-2

Windows............................................................................................................................................ 1-3

Linux/UNIX/Mac OS X.................................................................................................................. 1-3

Descripción del nivel de cifrado de EPM Automate ........................................................................... 1-4

2 Referencia de comandos

Comandos de un vistazo ......................................................................................................................... 2-1

Comandos de Planning y de los módulos de Planning ...................................................................... 2-4

Comandos de Financial Consolidation and Close ............................................................................... 2-5

Comandos de Tax Reporting .................................................................................................................. 2-6

Comandos de Profitability and Cost Management ............................................................................. 2-7

Comandos de Account Reconciliation................................................................................................... 2-8

Comandos de Oracle Enterprise Data Management Cloud ............................................................... 2-8

Comandos de Strategic Workforce Planning........................................................................................ 2-9

Comandos de Oracle Sales Planning Cloud ......................................................................................... 2-9

Acerca de la ejecución de comandos de EPM Automate .................................................................. 2-10

Requisitos previos .......................................................................................................................... 2-10

Ubicaciones de archivo predeterminadas................................................................................... 2-12

Activar protocolo de seguridad de capa de transporte 1.2 ...................................................... 2-13

Uso de comandos de EPM Automate.......................................................................................... 2-13

Especificación de varios valores para un parámetro................................................................. 2-14

Comandos de EPM Automate .............................................................................................................. 2-14

Códigos de salida.................................................................................................................................... 2-68

Ejecución de EPM Automate................................................................................................................. 2-74

Windows.......................................................................................................................................... 2-74

Linux ................................................................................................................................................ 2-75

iii

Ejecución de varias instancias de EPM Automate..................................................................... 2-76

3 Escenarios de ejemplo de ejecución de comandos

Escenarios de ejemplo para todos los servicios.................................................................................... 3-1

Copia de seguridad de instantáneas de aplicación en un equipo ............................................. 3-2

Creación de varios usuarios con contraseñas únicas .................................................................. 3-4

Creación de usuarios y asignación a roles predefinidos .......................................................... 3-12

Recuento del número de usuarios asignados a roles ................................................................ 3-14

Creación de informes de auditoría de usuarios asignados a roles.......................................... 3-16

Creación de informe de auditoría de asignación de roles y revocación................................. 3-19

Enmascaramiento de registros de acceso e informe de actividades para cumplir las

normas de privacidad .............................................................................................................. 3-22

Automatización de descargas de informes de actividad en un equipo local ........................ 3-27

Descarga de logs de acceso desde un entorno ........................................................................... 3-30

Automatización de la clonación de entornos ............................................................................. 3-33

Clonación de un entorno ............................................................................................................... 3-36

Eliminación de archivos innecesarios desde un entorno.......................................................... 3-37

Búsqueda y descarga de archivos de un entorno ...................................................................... 3-37

Recreación de un entorno antiguo de EPM Cloud para auditorías ........................................ 3-38

Automatización de auditoría y conformidad sobre el acceso a la base de datos.................. 3-48

Escenarios de ejemplo para aplicaciones de planificación y presupuestación, consolidación e

informes de impuestos ..................................................................................................................... 3-57

Automatización de la exportación de un gran número de celdas desde un cubo de

almacenamiento agregado....................................................................................................... 3-58

Importación de metadatos en la aplicación ................................................................................ 3-63

Importación de datos, ejecución de un script de cálculo y copia de datos desde una basede datos de almacenamiento de bloques a una base de datos de almacenamiento

agregado..................................................................................................................................... 3-63

Exportación y descarga de metadatos y datos ........................................................................... 3-64

Exportación y descarga de datos de aplicación ......................................................................... 3-64

Carga de un archivo de datos en un entorno y ejecución de una regla de carga de datos.. 3-65

Automatización de la integración de datos diaria..................................................................... 3-66

Escenarios de ejemplo para Account Reconciliation ......................................................................... 3-68

Carga de balances preformateados en un periodo.................................................................... 3-68

Carga e importación de una instantánea de copia de seguridad ............................................ 3-68

Escenarios de ejemplo para Profitability and Cost Management.................................................... 3-69

Importación de metadatos en la aplicación ................................................................................ 3-69

Importación de datos y ejecución de reglas del programa....................................................... 3-70

Escenarios de ejemplo para Oracle Enterprise Data Management Cloud ..................................... 3-70

Sincronización de dimensiones y asignaciones de Oracle Enterprise Data Management

Cloud con aplicaciones de EPM Cloud ................................................................................. 3-72

Sincronización de dimensiones de EPM Cloud con aplicaciones de Oracle Enterprise Data

Management Cloud.................................................................................................................. 3-74

iv

Automatización de la ejecución de scripts .......................................................................................... 3-75

Supervisión de las actividades de EPM Automate ............................................................................ 3-75

4 Replicación de un entorno de EPM Cloud

Configuración de la replicación diaria .................................................................................................. 4-1

Configuración de replicaciones a petición ............................................................................................ 4-2

Configuración del entorno secundario .................................................................................................. 4-2

A Preparación para ejecutar el comando replay

Acerca del comando replay..................................................................................................................... A-1

Requisitos previos..................................................................................................................................... A-1

Creación de archivos HAR ...................................................................................................................... A-2

Creación de archivos de reproducción .................................................................................................. A-5

Generación de archivos de rastreo ......................................................................................................... A-6

Sesión de reproducción de ejemplo ....................................................................................................... A-6

B Manejo de caracteres especiales

v

Accesibilidad a la documentación

Para obtener información acerca del compromiso de Oracle con la accesibilidad, visiteel sitio web del Programa de Accesibilidad de Oracle en http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Acceso a Oracle Support

Los clientes de Oracle que hayan adquirido soporte disponen de acceso a soporteelectrónico a través de My Oracle Support. Para obtener información, visite http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info o http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs si tiene problemas de audición.

vii

http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc

http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc

http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info

http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info

http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs

http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs

Comentarios sobre la documentación

Para proporcionar comentarios sobre esta documentación, envíe un correo electrónicoa [email protected] o, en un tema de Oracle Help Center, haga clic en el botónComentarios ubicado debajo de la tabla de contenidos (puede que tenga quedesplazarse hacia abajo para ver el botón).

Siga el desarrollo de la información de EPM en los siguientes sitios de redes sociales:

LinkedIn: http://www.linkedin.com/groups?gid=3127051&goback=.gmp_3127051

Twitter: http://twitter.com/hyperionepminfo

Facebook: http://www.facebook.com/pages/Hyperion-EPM-Info/102682103112642

YouTube: https://www.youtube.com/oracleepminthecloud

ix

http://www.linkedin.com/groups?gid=3127051&goback=.gmp_3127051

http://twitter.com/hyperionepminfo

http://www.facebook.com/pages/Hyperion-EPM-Info/102682103112642

https://www.youtube.com/oracleepminthecloud

1Acerca de EPM Automate

EPM Automate permite a los administradores de servicio realizar de forma remotatareas en entornos de Oracle Enterprise Performance Management Cloud distintos deNarrative Reporting.

Los administradores de servicio pueden realizar tareas de forma remota en entornosde los servicios de EPM Cloud siguientes:

• Planning

• Módulos de Planning

• Cierre y consolidación financieros

• Tax Reporting

• Rentabilidad y gestión de costes

• Account Reconciliation

• Oracle Enterprise Data Management Cloud

• Oracle Strategic Workforce Planning Cloud

• Oracle Sales Planning Cloud

Nota: Esta guía no se aplica a Narrative Reporting.

EPM Automate permite a los administradores de servicio automatizar muchas tareasrepetibles, incluidas las siguientes:

• Importación y exportación de metadatos, datos, artefactos e instantáneas deaplicación, plantillas y asignaciones de Data Management

• Carga de archivos en entornos, visualización de archivos y supresión de archivosdel servicio

• Descarga de instantáneas, informes y archivos de metadatos y datos del servicio

• Ejecución de reglas de negocio en datos y actualización de la aplicación

• Copiar datos de una base de datos a otra; por lo general, desde una base de datosde almacenamiento de bloques a una base de datos de almacenamiento agregadao desde una base de datos de almacenamiento de bloques a otra base de datos dealmacenamiento de bloques

• Ejecutar una regla de lote de Data Management

Acerca de EPM Automate 1-1

• Generación de informes, informes de aprovisionamiento e informes de auditoríade usuarios de Data Management

• Importación de datos de balance previamente asignados, tipos de cambio,transacciones previamente asignadas, datos de balance y perfiles en AccountReconciliation

• Copiar perfiles en un periodo para iniciar el proceso de conciliación

• Despliegue del cubo de cálculo de una aplicación de Profitability and CostManagement

• Borrado, copia y supresión de puntos de vista en aplicaciones de Profitability andCost Management

• Reproducción de la carga de Oracle Smart View for Office en un entorno con el finde activar las pruebas de rendimiento si hay una carga muy elevada

• Importación de datos adicionales de un archivo en Financial Consolidation andClose

Puede crear scripts que sean capaces de realizar una amplia serie de tareas yautomatizar su ejecución mediante un programador. Por ejemplo, puede crear unscript para descargar la copia de seguridad de mantenimiento diaria de los entornos ycrear copias de seguridad locales de los artefactos y datos.

Descripción general en vídeo de EPM Automate

Tutorial: Cómo ejecutar comandos de Planning con EPM Automate

Instalación de EPM AutomateEl instalador de EPM Automate para Windows, Linux/UNIX y MacOS X estádisponible en el servicio.

EPM Automate se puede instalar en máquinas virtuales y en máquinas de IntegrationCloud Service que puedan acceder a hosts externos en una conexión HTTP segura.

Nota:

EPM Automate se puede emplear solo en sistemas operativos de 64 bits queestán actualmente soportados por el proveedor del sistema operativo.

En computadoras Linux y UNIX, EPM Automate busca las siguientes variables deentorno para determinar la configuración del proxy:

• proxyHost

• proxyPort

• https.proxyHost

• https.proxyPort

Instalación de EPM Automate

1-2 Oracle Cloud Trabajar con EPM Automate para Oracle Enterprise Performance Management Cloud

https://apexapps.oracle.com/pls/apex/f?p=44785:265:0:::265:P265_CONTENT_ID:10891

https://apex.oracle.com/pls/apex/f?p=44785:265:0:::265:P265_CONTENT_ID:10717

Nota:

EPM Automate no funciona con credenciales SSO (proveedor de identidad)corporativas. Puesto que los usuarios no pueden conectarse con credencialescorporativas, las cuentas del usuario para acceder a EPM Automate debenmantenerse en el servicio.

Si ha configurado la suscripción para SSO, también debe permitir a losusuarios conectarse con sus credenciales de dominio de identidad. Consulte Cómo permitir la conexión con credenciales de dominio de identidad enAdministración de Oracle Cloud Identity Management.

Instrucciones de descarga: Descarga e instalación de clientes en Introducción a OracleEnterprise Performance Management Cloud para administradores.

Windows

De forma predeterminada, EPM Automate se instala en C:/Oracle/EPM Automate.

Para instalar EPM Automate:

1. En la computadora con Windows donde desea instalar EPM Automate, obtengaacceso a un entorno.

2. En la página de inicio, puede acceder a Configuración y acciones haciendo clic enel nombre de usuario.

3. Haga clic en Descargas.

4. En la página Descargas, haga clic en Descargar para Windows en la sección EPMAutomate.

5. Guarde el instalador en el equipo.

6. Haga clic con el botón derecho en el instalador (EPM Automate.exe) y seleccioneEjecutar como administrador.

7. En Control de cuentas de usuario, haga clic en Sí.

8. Siga las peticiones de datos en pantalla para completar la instalación.

Linux/UNIX/Mac OS X

EPM Automate requiere acceso a un despliegue de versión de JRE 1.7 o superior. Lavariable de entorno JAVA_HOME debe establecerse para apuntar a la instalación deJRE.

Para instalar EPM Automate:

1. Acceda a un entorno.

2. En la página de inicio, puede acceder a Configuración y acciones haciendo clic enel nombre de usuario.

3. Haga clic en Descargas.

4. En la página Descargas, haga clic en Descargar para Linux/Mac en la sección EPMAutomate.

Instalación de EPM Automate

Acerca de EPM Automate 1-3

5. Guarde el instalador (EPMAutomate.tar) en un directorio en el que tengaprivilegios de lectura/escritura/ejecución.

6. Extraiga el contenido del instalador, defina las variables de entorno necesarias yejecute epmautomate.sh:

Ejemplo de Mac OS (asumiendo un shell de bash) para instalar y ejecutar desde eldirectorio inicial.

cd ~/tar xf path_to_downloaded_EPMAutomate.tarexport JAVA_HOME=$(/usr/libexec/java_home)export PATH $HOME/epmautomate/bin:$PATHepmautomate.sh

Ejemplo de Linux (asumiendo un shell de bash) para instalar y ejecutar desde eldirectorio inicial. Se presupone el uso de la versión de JDK 1.8.0_191.

cd ~/tar xf path_to_downloaded_EPMAutomate.tarexport JAVA_HOME=/opt/jdk1.8.0_191export PATH ~/Downloads/epmautomate/bin:$PATHepmautomate.sh

Descripción del nivel de cifrado de EPM AutomateOracle Enterprise Performance Management Cloud utiliza seguridad de capa detransporte (TLS) con un algoritmo hash criptográfico SHA-2/SHA-256 para protegerla comunicación con EPM Automate.

Descripción del nivel de cifrado de EPM Automate


2Referencia de comandos

EPM Automate no se admite para Narrative Reporting.

• Comandos de un vistazo

• Comandos de Planning y de los módulos de Planning

• Comandos de Financial Consolidation and Close

• Comandos de Tax Reporting

• Comandos de Profitability and Cost Management

• Comandos de Account Reconciliation

• Comandos de Oracle Enterprise Data Management Cloud

• Comandos de Strategic Workforce Planning

• Comandos de Oracle Sales Planning Cloud

Comandos de un vistazoEs una lista alfabética de todos los comandos de EPM Automate.

Tabla 2-1 Lista alfabética de comandos de EPM Automate

Nombre del comando PBCS,SWP, SP

FCCS TRCS PCMCS ARCS EDMCS

addUsers

addUsersToGroup

addUsersToTeam

addUserToGroups

applicationAdminMode

applyDataGrants

assignRole

clearCube

clearPOV

copyFileFromInstance

copyPOV

copySnapshotFromInstance

Referencia de comandos 2-1

Tabla 2-1 (Continuación) Lista alfabética de comandos de EPM Automate



createReconciliations

deleteFile

deletePOV

deployCube

downloadFile

enableApp

encrypt

exportAppAudit

exportAppSecurity

exportData

exportDimension

exportDimensionMapping

exportMapping

exportMetadata

exportQueryResults

exportSnapshot

exportTemplate

feedback

getDailyMaintenanceStartTime

getSubstVar

help

importAppSecurity

importBalances

importData

importDimension

importMapping

importMetadata

importPreMappedBalances

importPreMappedTransactions

importProfiles

importRates

importSnapshot

Comandos de un vistazo





importSupplementalData

importTemplate

importTmPremappedTransactions

listFiles

loadData

loadDimData

login

logout

maskData

mergeDataSlices

mergeSlices

provisionReport

recreate

refreshCube

removeUserFromGroups

removeUsers

removeUsersFromGroup

removeUsersFromTeam

renameSnapshot

replay

resetService

restructureCube

roleAssignmentReport

runAutomatch

runBatch

runBusinessRule

runCalc

runComplianceReport

runDailyMaintenance

runDataRule

runDMReport

Comandos de un vistazo





runMatchingReport

runPlanTypeMap

setDemoDates

setEncryptionKey

setDailyMaintenanceStartTime

setManualDataAccess

setPeriodStatus

setSubstVars

sortMember

unassignRole

upgrade

uploadFile

userAuditReport

userGroupReport

Abreviaturas

• PBCS: Planning (incluidos los módulos de Planning)

• SWP: Oracle Strategic Workforce Planning Cloud

• SP: Oracle Sales Planning Cloud

• FCCS: Financial Consolidation and Close

• TRCS: Tax Reporting

• PCMCS: Profitability and Cost Management

• ARCS: Account Reconciliation

• EDMCS: Oracle Enterprise Data Management Cloud

Comandos de Planning y de los módulos de PlanningSon todos los comandos de EPM Automate que funcionan para los entornos dePlanning (incluidos los módulos de Planning).

Comandos de Planning y de los módulos de Planning


Comandos de Planning y de los módulos de Planning

addUsers

addUsersToGroup

addUserToGroups


assignRole

clearCube



deleteFile

downloadFile

encrypt

exportAppAudit

exportAppSecurity

exportData

exportMapping

exportMetadata

exportSnapshot

feedback


getSubstVar

help

importAppSecurity

importData

importMapping

importMetadata

importSnapshot

listFiles

login

logout

maskData

mergeDataSlicesprovisionReport

recreate

refreshCube


removeUsers


renameSnapshot

replay

resetService

restructureCube


runBatch

runBusinessRule

runDailyMaintenance

runDataRule

runDMReport

runPlanTypeMap

setEncryptionKey


setManualDataAccess

setSubstVars

sortMember

unassignRole

upgrade

uploadFile

userAuditReport

userGroupReport

Comandos de Financial Consolidation and CloseSon todos los comandos de EPM Automate que funcionan para los entornos deFinancial Consolidation and Close.

Comandos de Financial Consolidation and Close


Comandos de EPM Automate para Financial Consolidation and Close

addUsers

addUsersToGroup

addUsersToTeam

addUserToGroups


assignRole



deleteFile

downloadFile

encrypt

exportData

exportMapping

exportMetadata

exportSnapshot

feedback

getSubstVar

help

importAppSecurity

importData

importMapping

importMetadata

importSnapshot



listFiles

login

logout

maskData

provisionReport

recreate

refreshCube

removeUsers



removeUsersFromTeam

renameSnapshot

replay

resetService

restructureCube


runBatch

runBusinessRule

runDailyMaintenance

runDataRule

runDMReport

runPlanTypeMap

setDemoDates

setEncryptionKey


setManualDataAccess

setSubstVars

unassignRole

upgrade

uploadFile

userAuditReport

userGroupReport

Comandos de Tax ReportingSon todos los comandos de EPM Automate que funcionan para los entornos de TaxReporting.

Comandos de Tax Reporting


Comandos de EPM Automate para Tax Reporting

addUsers

addUsersToGroup

addUsersToTeam

addUserToGroups


assignRole



deleteFile

downloadFile

encrypt

exportData

exportMapping

exportMetadata

exportSnapshot

feedback


getSubstVar

help

importAppSecurity

importData

importMapping

importMetadata

importSnapshot


listFiles

login

logout

maskData

provisionReport

recreate

refreshCube


removeUsers


removeUsersFromTeam

renameSnapshot

replay

resetService

runBatch

restructureCube


runBusinessRule

runDataRule

runDMReport

runPlanTypeMap

setDemoDates

setEncryptionKey


setManualDataAccess

setSubstVars

unassignRole

upgrade

uploadFile

userAuditReport

userGroupReport

Comandos de Profitability and Cost ManagementSon todos los comandos de EPM Automate que funcionan para los entornos deProfitability and Cost Management.

Comandos de EPM Automate para Profitability and Cost Management

addUsers

addUsersToGroup

addUserToGroups

applyDataGrants

assignRole

clearPOV


copyPOV


deleteFile

deletePOV

deployCube

downloadFile

enableApp

encrypt

exportMapping

exportQueryResults

exportSnapshot

exportTemplate

feedback

help

importMapping

importSnapshot

importTemplate

listFiles

loadData

loadDimData

login

logout

mergeSlices

provisionReport

recreate


removeUsers


renameSnapshot

resetService


runBatch

runCalc

runDailyMaintenance

runDataRule

runDMReport

setEncryptionKey


setManualDataAccess

unassignRole

upgrade

uploadFile

userAuditReport

userGroupReport

Comandos de Profitability and Cost Management


Comandos de Account ReconciliationSon todos los comandos de EPM Automate que funcionan para los entornos deAccount Reconciliation.

Comandos de EPM Automate para Account Reconciliation

addUsers

addUsersToTeam

addUserToGroups

assignRole




deleteFile

downloadFile

encrypt

exportMapping

exportSnapshot

feedback


help

importBalances

importMapping



importProfiles

importRates

importSnapshot

listFiles

login


logout

provisionReport

recreate


removeUsers

removeUsersFromTeam

renameSnapshot


resetService

runAutomatch

runBatch

runDailyMaintenance

runDataRule

runDMReport

runComplianceReport

runMatchingReport

setDemoDates

setEncryptionKey


setManualDataAccess

setPeriodStatus

unassignRole

upgrade

uploadFile

userAuditReport

userGroupReport

Comandos de Oracle Enterprise Data Management CloudSon los comandos de EPM Automate que funcionan para los entornos de OracleEnterprise Data Management Cloud.

Comandos para Oracle Enterprise Data Management Cloud

addUsers

addUsersToGroup

addUserToGroups

assignRole



deleteFile

downloadFile

encrypt

exportDimension


exportSnapshot

feedback


help

importDimension

importSnapshot

listFiles

login

logout

provisionReport

recreate


removeUsers


renameSnapshot

resetService


runDailyMaintenance

setEncryptionKey


setManualDataAccess

unassignRole

uploadFile

userAuditReport

upgrade

userGroupReport

Comandos de Account Reconciliation


Comandos de Strategic Workforce PlanningSon los comandos de EPM Automate que funcionan para los entornos de OracleStrategic Workforce Planning Cloud.

Comandos para Strategic Workforce Planning

addUsers

addUsersToGroup

addUserToGroups


assignRole

clearCube



deleteFile

downloadFile

encrypt

exportAppAudit

exportAppSecurity

exportData

exportMapping

exportMetadata

exportSnapshot

feedback


getSubstVar

help

importAppSecurity

importData

importMapping

importMetadata

importSnapshot

listFiles

login

logout

maskData


recreate

refreshCube


removeUsers


renameSnapshot

replay

resetService

restructureCube


runBatch

runBusinessRule

runDailyMaintenance

runDataRule

runDMReport

runPlanTypeMap

setEncryptionKey


setManualDataAccess

setSubstVars

sortMember

unassignRole

upgrade

uploadFile

userAuditReport

userGroupReport

Comandos de Oracle Sales Planning CloudSon los comandos de EPM Automate que funcionan para los entornos de Oracle SalesPlanning Cloud.

Comandos de Strategic Workforce Planning


Comandos de Sales Planning

addUsers

addUsersToGroup

addUserToGroups


assignRole

clearCube



deleteFile

downloadFile

encrypt

exportAppAudit

exportAppSecurity

exportData

exportMapping

exportMetadata

exportSnapshot

feedback


getSubstVar

help

importAppSecurity

importData

importMapping

importMetadata

importSnapshot

listFiles

login

logout

maskData


recreate

refreshCube


removeUsers


renameSnapshot

replay

resetService

restructureCube


runBatch

runBusinessRule

runDailyMaintenance

runDataRule

runDMReport

runPlanTypeMap

setEncryptionKey


setManualDataAccess

setSubstVars

sortMember

unassignRole

upgrade

uploadFile

userAuditReport

userGroupReport

Acerca de la ejecución de comandos de EPM AutomateTodos los servicios de Oracle Enterprise Performance Management Cloud que no seanNarrative Reporting utilizan los comandos de EPM Automate para administrar losentornos de forma remota.

Para obtener una lista de los comandos utilizados por cada servicio, consulte:








Requisitos previosEn esta sección se enumeran los requisitos para utilizar EPM Automate, como el usode las credenciales de Oracle Enterprise Performance Management Cloud y lasubicaciones de archivo predeterminadas en los entornos.

Acerca de la ejecución de comandos de EPM Automate


GeneralLos usuarios de EPM Cloud pueden utilizar las credenciales de dominio de identidadpara conectarse a un entorno mediante el uso de EPM Automate. Sin embargo, solo losadministradores de servicio pueden ejecutar comandos.

• Además, se requiere el rol de administrador de dominio de identidad paraejecutar comandos que modifiquen objetos en el dominio de identidad.

• Cualquier archivo necesario para ejecutar un comando debe existir en el entorno.Utilice el comando uploadFile para cargar archivos.

Consulte Ubicaciones de archivo predeterminadas para obtener más informaciónsobre la ubicación de archivo predeterminada utilizada por cada servicio.

• Uso de extensión de archivo en comandos:

– Especifique el nombre completo del archivo, incluida la extensión de archivo(por ejemplo, data.csv), para ejecutar comandos que realizan operacionesde archivos. Ejemplo de comandos de operaciones de archivos incluyedeletefile listfiles y uploadfile.

– No utilice extensiones de archivos para ejecutar comandos que realizanoperaciones de migración. Las operaciones de migración requieren que seespecifique el nombre de una instantánea.

• Los valores de parámetro que contienen un carácter de espacio (por ejemplo,comentarios, nombres de ubicación y rutas de carpetas) deben ir entre comillas.

Planning

• Trabajos

Para muchos de los comandos que se describen en la siguiente sección serequieren trabajos. Los trabajos son acciones, como la importación o exportaciónde datos, que se pueden iniciar inmediatamente o programar para que se realicenposteriormente, por ejemplo, la importación o exportación de datos y elrefrescamiento de la base de datos.

Con la consola de trabajos, debe crear los trabajos adecuados para realizar lassiguientes operaciones. Para obtener instrucciones detalladas sobre la creación detrabajos en Planning, consulte "Gestión de trabajos" en Administración de Planning.

– Importar datos a una aplicación

– Exportar datos de una aplicación

– Importar metadatos a una aplicación

– Exportar metadatos de una aplicación

– Copie los datos desde una base de datos de almacenamiento de bloques enuna base de datos de almacenamiento agregado o desde una base dealmacenamiento agregado a otra base de datos de almacenamiento debloques

• Reglas de negocio

Las reglas de negocio que desee ejecutar deben existir en la aplicación.



Puede utilizar Calculation Manager para crear reglas de negocio, que acontinuación se desplegarán en la aplicación. Consulte Diseño con CalculationManager para Oracle Enterprise Performance Management Cloud.

Data Management

• Reglas de datos

Las reglas de carga de datos definen cómo Data Management carga los datos deun archivo. Tiene que haber predefinido reglas de carga de datos para cargar losdatos con EPM Automate.

• Lotes

Puede cargar datos utilizando los lotes definidos en Data Management. Si utilizanun lote, los administradores de servicio pueden combinar muchas reglas de cargaen un lote y ejecutarlas en serie o en paralelo.

Ubicaciones de archivo predeterminadasLas ubicaciones predeterminadas de carga y descarga pueden variar en los serviciosde Oracle Enterprise Performance Management Cloud.

• La ubicación predeterminada en la que EPM Automate carga los archivos yalmacena los archivos para descarga es accesible para estas aplicaciones. Debecargar archivos en esta ubicación si planea procesarlos mediante un proceso quees nativo para estas aplicaciones.

– Planning

– Enterprise Planning

– Conciliación de cuentas

– Financial Consolidation and Close

– Tax Reporting

Puede utilizar el explorador de bandeja de entrada/buzón de salida paraexaminar los archivos almacenados en la ubicación predeterminada. Lasinstantáneas de la aplicación que cree con EPM Automate no aparecen en elexplorador de bandeja de entrada/buzón de salida; puede verlas en el separadorInstantáneas de Migración.

• Los archivos que se van a procesar mediante un proceso de Profitability and CostManagement nativo se deben cargar en profitinbox. Los archivos exportadospor los procesos de Profitability and Cost Management se almacenan enprofitoutbox. Utilice el explorador de archivos para examinar estos archivos.

• Los archivos que se van a procesar mediante Data Management deben estardisponibles en la bandeja de entrada o en una carpeta dentro de ella. De formapredeterminada, los archivos exportados mediante Data Management sealmacenan en el buzón de salida, mientras que las salidas de informe de DataManagement se almacenan en la carpeta outbox/report de Data Management.Utilice el explorador de archivos de Data Management para examinar estosarchivos.



Activar protocolo de seguridad de capa de transporte 1.2EPM Automate se debe instalar en un sistema operativo que admita el protocolo deseguridad de capa de transporte (TLS) 1.2 o superior.

Para garantizar el máximo nivel de seguridad para la autentificación y el cifrado dedatos, EPM Automate solo admite TLS 1.2. Si TLS 1.2 no está activado en lacomputadora desde la que se ejecuta EPM Automate, se muestra el error EPMAT-7:Unable to connect. Unsupported Protocol: HTTPS. Para resolverlo, pida aladministrador de TI que active TLS 1.2.

Los procedimientos para activar TLS 1.2 dependen del sistema operativo. Use estasfuentes de información; puede haber recursos web similares para otros sistemasoperativos admitidos:

• Realice la actualización para activar TLS 1.1 y TLS 1.2 como protocolos deseguridad predeterminados en WinHTTP en Windows para obtener informaciónsobre la activación de TLS 1.2 para computadoras con Windows.

• Protección de la configuración de TLS para obtener información sobre laactivación de TLS 1.2 en OpenSSL para Red Hat Enterprise Linux.

Uso de comandos de EPM Automate

Secuencia de parámetros de comandos

Todos los parámetros obligatorios para un comando se deben transferir en lasecuencia identificada en la sintaxis del comando. Los parámetros obligatorios y susvalores preceden a los parámetros opcionales, que se pueden transferir en cualquiersecuencia. Los parámetros opcionales no son posicionales.

Por ejemplo, tenga en cuenta la siguiente sintaxis del comando login:

epmautomate login USERNAME PASSWORD URL IDENTITYDOMAIN [ProxyServerUserName=PROXY_USERNAME] [ProxyServerPassword=PROXY_PASSWORD] [ProxyServerDomain=PROXY_DOMAIN]

Este comando tiene cuatro parámetros obligatorios;USERNAME, PASSWORD , URL yIDENTITYDOMAIN, que deben aparecer en la secuencia identificada en la sintaxis. Elcomando devolverá un error si no se mantiene esta secuencia. Los parámetrosopcionales (ProxyServerUserName, ProxyServerPassword yProxyServerDomain) y sus valores se pueden especificar en cualquier secuencia.

¿Son los comandos de EPM Automate sensibles a mayúsculas/minúsculas?

Los comandos de EPM Automate no son sensibles a mayúsculas/minúsculas. Laforma de escribir un comando no tiene ningún efecto en la ejecución del comando. Porejemplo, puede escribir el comando addUsers como addusers, ADDUSERS oAdDuSeRs.

¿Distinguen entre mayúsculas y minúsculas los parámetros de comando deEPM Automate?

Los parámetros de comando de EPM Automate no distinguen entre mayúsculas yminúsculas. La forma de escribir un nombre de parámetro de comando no tieneningún efecto en la ejecución del comando. Por ejemplo, puede escribir el parámetro



https://support.microsoft.com/en-us/help/3140245/update-to-enable-tls-1-1-and-tls-1-2-as-default-secure-protocols-in-wi

https://support.microsoft.com/en-us/help/3140245/update-to-enable-tls-1-1-and-tls-1-2-as-default-secure-protocols-in-wi

https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/security_guide/sec-Hardening_TLS_Configuration#sec-Configuring_Specific_Applications

de comando FileName como filename, fileName o fIlEnAmE sin que afecte a laejecución del comando.

Especificación de varios valores para un parámetroAlgunos comandos de EPM Automate aceptan varios valores de parámetro separadospor coma; por ejemplo, una petición de datos de tiempo de ejecución de miembros detipo en reglas de negocio, conjuntos de reglas y plantilla en una aplicación dePlanning.

Para establecer más de un miembro para un tipo de miembros de una petición detiempo de ejecución llamada Entities en un comando de EPM Automate, utiliceuna , (coma) como se muestra en el siguiente ejemplo para ejecutar el comandorunbusinessrule.

epmautomate runbusinessrule clearDistData TargetYear=FY19TargetMonth=Feb Entities=District1,District2

Los nombres de miembro que contienen caracteres especiales, como espacio y coma,deben ir entre comillas y se parados mediante \ (barra diagonal inversa), como semuestra en el siguiente ejemplo:

epmautomate runbusinessrule clearDistData TargetYear=FY19TargetMonth=Feb Entities="\"District 1\",\"entity_name, withcomma\""

Comandos de EPM AutomateEsta sección contiene información detallada sobre cada comando de EPM Automate,incluida la descripción del comando, la sintaxis, la descripción de los parámetros yejemplos.

Para obtener una lista de los comandos utilizados por cada servicio, consulte:








• Comandos de Oracle Sales Planning Cloud

Para obtener información sobre los códigos de estado usados por EPM Automate,consulte Códigos de salida.

addUsers

Crea un lote de usuarios en un dominio de identidad utilizando un archivo de valoresseparados por comas (.csv) codificado por ANSI o UTF-8 que se ha cargado en elentorno. Utilice el comando uploadFile para cargar archivos en un entorno. El formatodel archivo es el siguiente:

Comandos de EPM Automate


First Name,Last Name,Email,User LoginJane,Doe,[email protected],jdoeJohn,Doe,[email protected],[email protected]

Consulte Importación de un lote de cuentas de usuarios en Introducción a Oracle Cloudpara una descripción detallada del formato de archivo CSV.

Si una definición de usuario en el archivo CSV coincide con una cuenta de usuario queexiste en el dominio de identidad, no se realizarán cambios en la cuenta de usuarioexistente. Este comando crea cuentas solo para nuevos usuarios cuya información decuenta se incluye en el archivo. Dado que las cuentas de usuario son comunes a todoslos entornos de servicio que soporta un dominio de identidad, los nuevos usuariosestán disponibles para todos los entornos que comparten el dominio de identidad.

Nota:

• Necesita tanto roles de administrador de servicio como de administradorde dominio de identidad para ejecutar este comando.

• Las utilidades de Oracle Enterprise Performance Management Cloudrequieren que los usuarios usen sus credenciales del dominio deidentidad. Consulte "Garantía de que los usuarios pueden ejecutarutilidades EPM Cloud tras la configuración de SSO" en Introducción aOracle Enterprise Performance Management Cloud para administradores.

Sintaxis: epmautomate addUsers FILE_NAME userPassword=PASSWORD[resetPassword=true|false], donde:

• FILE_NAME es el nombre de un archivo CSV que contiene información delusuario. El archivo de entrada que contiene caracteres de varios bytes debeutilizar codificación de caracteres UTF 8. El uso de la codificación ANSI provocaproblemas con la forma en que se muestra la información del usuario en laspantallas de Mis servicios.

• userPassword indica la contraseña predeterminada para todos los nuevosusuarios que se crean en el dominio de identidad. Esta contraseña debe cumplirlos requisitos mínimos para contraseñas de dominios de identidad.

• resetPassword, de forma opcional, indica si los nuevos usuarios deben cambiarla contraseña la primera vez que inician sesión. El valor predeterminado es true.A menos que este parámetro se defina en false, los nuevos usuarios se veránobligados a cambiar la contraseña la primera vez que inicien sesión.



Nota:

• Este comando asigna una contraseña (valor de userPassword) a todoslos usuarios especificados en el archivo CSV. La asignación de la mismacontraseña a todos los usuarios puede ser aconsejable si desea crearusuarios solo con fines de prueba.

Si está creando usuarios reales de EPM Cloud y desea asignar unacontraseña específica a cada usuario, utilice un script en lugar de estecomando. Consulte Creación de varios usuarios con contraseñas únicas.En el archivo de entrada del script, puede definir una contraseñaespecífica para cada usuario; el script crea cada usuario y le asigna lacontraseña especificada.

• Cuando se agregan usuarios con este comando, a diferencia de cuando seagregan desde Mis servicios, Oracle Cloud no envía correos electrónicos acada usuario recién agregado de forma automática. Debe enviar lascredenciales por correo electrónico de forma manual (el nombre y lacontraseña de inicio de sesión) a cada nuevo usuario. Además, debeforzar a los nuevos usuarios a cambiar la contraseña en el primer inicio desesión especificando resetPassword=true.

Ejemplos:

• Agregue usuarios de prueba en el dominio de identidad con la mismacontraseña sin requerir que cambien la contraseña:

epmautomate addUsers user_file.CSV userPassword=Example@Pwd1resetPassword=false

• Agregue usuarios reales al dominio de identidad, asigne una contraseña única acada usuario y fuerce a los usuarios a cambiar la contraseña:

Consulte Creación de varios usuarios con contraseñas únicas

addUsersToGroup

Agrega un lote de usuarios a un grupo existente en Control de acceso mediante el usode un archivo CSV con codificación ANSI o UTF-8 que se haya cargado en el entorno.Utilice el comando uploadFile para cargar archivos en un entorno. El formato delarchivo es el siguiente:

User [email protected]

Nota:

El usuario se agrega a un grupo solo si se cumplen las condiciones siguientes:

• Los ID de inicio de sesión de usuario incluidos en el archivo existen en eldominio de identidad que presta servicio al entorno.

• El usuario tiene asignado un rol predefinido en el dominio de identidad.

Además, el archivo no debe contener el ID de inicio de sesión del usuario queejecuta este comando.



Sintaxis: epmautomate addUsersToGroup NOMBRE_ARCHIVO NOMBRE_GRUPO,donde:

• FILE_NAME es el nombre de un archivo CSV que contiene los nombres de iniciode sesión de los usuarios que desea asignar a un grupo en Control de acceso.

• NOMBRE_GRUPO es el nombre del grupo existente en Control de acceso.

Ejemplo: epmautomate addUsersToGroup user_file.CSV example_group

addUsersToTeam

Agrega los usuarios de EPM Cloud que se muestran en un archivo CSV a un equipoexistente. Si un usuario incluido en el archivo CSV ya es miembro del equipo, con estecomando se ignora al usuario. El formato del archivo CSV es el siguiente:

User Login, primary_userjdoe, [email protected],no

Nota:

De forma predeterminada, se designa un usuario primario para realizar lastareas asignadas al equipo.

Sintaxis: epmautomate addUsersToTeam ARCHIVO NOMBRE_EQUIPO, donde:

• ARCHIVO identifica un archivo CSV con formato UTF8 que muestra los ID deconexión de los usuarios para agregarlos al equipo. Antes de ejecutar el comando,use el comando uploadFile para agregar el archivo a la bandeja de entrada.

• NOMBRE_EQUIPO identifica un nombre de equipo según la definición de Controlde acceso.

Ejemplo: epmautomate addUsersToTeam example_users.csvexample_team

addUserToGroups

Agrega un usuario como un miembro de los grupos de Control de acceso identificadosen un archivo CSV ANSI o UTF-8 codificado. Utilice el comando uploadFile paracargar archivos en un entorno. El formato del archivo es el siguiente:

Group NameGroup1Group2

Sintaxis: epmautomate addUserToGroups FILE_NAME User_Login, donde:

• FILE_NAME es el nombre de un archivo CSV que contiene los nombres de losgrupos de Control de acceso a los que desea asignar el usuario.

• User_Login es el identificador de inicio de sesión de un usuario de EPM Cloudque se va a asignar a los grupos de Control de acceso. Este identificador de iniciode sesión de usuario debe existir en el dominio de identidad que presta servicio alentorno y se debe asignar a un rol predefinido.

Ejemplo: epmautomate addUserToGroups groups.CSV [email protected]




Pone la aplicación en modo de administración, de forma que se limita el acceso a laaplicación solo a administradores de servicio. Este comando es útil para evitar que losusuarios trabajen en la aplicación cuando los administradores de servicio realizanoperaciones administrativas.

La aplicación permanece en el modo de administración hasta que se cambie para quetodos los usuarios puedan acceder.

Sintaxis: epmautomate applicationAdminMode <Value>, donde Valueespecifica si se debe poner la aplicación en modo de administración. Estos son losvalores aceptables:

• true para poner la aplicación en modo de administración.

• false para volver a poner la aplicación en modo normal de forma que todos losusuarios puedan acceder a ella.

Ejemplos:

• Poner la aplicación en modo de administración: epmautomateapplicationAdminMode true

• Devolver la aplicación a su funcionamiento normal: epmautomateapplicationAdminMode false

applyDataGrants

Refresca los otorgamientos de datos, que controlan el acceso a los segmentos de datosde Essbase, para que coincidan con los otorgamientos de datos definidos en unaaplicación de Profitability and Cost Management.

Los otorgamientos de datos de nivel de grupo y usuario que realice en la aplicación deProfitability and Cost Management se sincronizan de forma automática en Essbase.Utilice este comando para sincronizar el acceso a datos de Essbase si sospecha que haydiscordancia entre los otorgamientos de datos en la aplicación y los filtros en Essbase.

El tiempo necesario para realizar esta operación dependerá del tamaño de laaplicación. Asegúrese de que la operación de refrescamiento de los otorgamientos dedatos termina antes de que se realice una copia de seguridad de la aplicación duranteel próximo periodo de mantenimiento. Debido a que la aplicación no se debe utilizarmientras esta operación está en curso, Oracle recomienda programar esta operación enun momento en el que los usuarios no estén trabajando con la aplicación.

Sintaxis: epmautomate applyDataGrants APPLICATION_NAME, dondeAPPLICATION_NAME es el nombre de la aplicación de Profitability and CostManagement para la que se van a volver a crear los otorgamientos de datos.

Ejemplo: epmautomate applyDataGrants BksML12

assignRole

Asigna los usuarios incluidos en un archivo CSV con codificación ANSI o UTF-8 a unrol predefinido o de aplicación. Utilice este comando para asignar usuarios a un rolpredefinido, o bien un rol de aplicación pertenecientes a una aplicación deplanificación, consolidación, informes de impuestos o administración de datos.



Nota:

No puede utilizar este comando para asignar roles de aplicación a aplicacionesde Account Reconciliation y Profitability and Cost Management, las cuales noadmiten la asignación de roles de aplicación a usuarios.

Antes de utilizar este comando, utilice el comando uploadFile para cargar archivos enel entorno. El formato del archivo es el siguiente:


Consulte Asignación de un rol a muchos usuarios en Introducción a Oracle Cloud.

Nota:

• Necesita tanto roles de administrador de servicio como de administradorde dominio de identidad para asignar roles predefinidos a los usuarios.

• Solo necesita un administrador de servicio para asignar usuarios a rolesde aplicación.

• Utilice las comillas dobles para incluir los nombres de rol que contienencaracteres de espacio.

Uso: epmautomate assignRole NOMBRE_ARCHIVO ROL, donde:

• NOMBRE_ARCHIVO es el nombre de un archivo CSV que contiene ID de inicio desesión de usuario.

• ROL identifica una de las siguientes acciones:

– Si asigna usuarios a roles de dominio de identidad predefinidos, ROLE debeidentificar un rol predefinido aplicable al servicio. Consulte Descripción delos roles predefinidos en Introducción a Oracle Enterprise PerformanceManagement Cloud para administradores.

Valores aceptables para Planning, los módulos de Planning, FinancialConsolidation and Close y Tax Reporting:

* Administrador del servicio

* Usuario avanzado

* Usuario (no utilice Planner, que se ha utilizado en anteriores versionesdel servicio)

* Visor

Valores aceptables para Oracle Enterprise Data Management Cloud:


* Usuario



– Si asigna usuarios a un rol de aplicación, ROL debe identificar un rol deaplicación incluido en el separador Asignar roles de Control de acceso.

Valores aceptables para las aplicaciones de Planning, los módulos dePlanning, Financial Consolidation and Close y Tax Reporting:

* Administrador de aprobaciones

* Persona que asigna la propiedad de aprobaciones

* Diseñador de procesos de aprobaciones

* Supervisor de aprobaciones

* Creador de cuadrícula ad hoc

* Usuario ad hoc

* Usuario ad hoc de solo lectura

* Administrador de Calculation Manager

* Crear integración

* Obtener detalles

* Ejecutar integración

* Asignación masiva

* Administrador de acceso a lista de tareas

Valores aceptables para las aplicaciones de Oracle Enterprise DataManagement Cloud:

* Creador de aplicaciones

* Creador de vistas

Para obtener una descripción de estos roles, consulte Gestión de asignacionesde roles en el nivel de aplicación en Administración del control de acceso paraOracle Enterprise Performance Management Cloud.

Ejemplos:

• Asigne usuarios a un rol de dominio de identidad predefinido: epmautomateassignRole admin_role_file.CSV "Administrador del servicio"

• Asigne usuarios a un rol de aplicación: epmautomate assignRoleexample_file.CSV "Administrador de acceso a lista de tareas"

clearCube

Suprime los datos específicos de los cubos de entrada y de informes utilizando laconfiguración especificada en un trabajo de tipo clear cube. Con este comando nose suprime la definición de aplicación en las tablas relacionales de la aplicación.Consulte Borrado de cubos en Administración de Planning.

Sintaxis: epmautomate clearCube JOB_NAME, donde: JOB_NAME es el nombre deuna trabajo definido en la aplicación.

Ejemplo: epmautomate clearCube ClearPlan1



clearPOV

Borra los artefactos del modelo y los datos desde una combinación de punto de vista(PDV) o una región de datos dentro del PDV en una aplicación.

Sintaxis: epmautomate clearPOV APPLICATION_NAME POV_NAME[QUERY_NAME] PARAMETER=VALUE stringDelimiter="DELIMITER" donde:

• APPLICATION_NAME es el nombre de una aplicación de Profitability and CostManagement

• NOMBRE_PDV es un PDV de la aplicación. Este valor es necesario.

• QUERY_NAME, de forma opcional, es el nombre de una consulta exactamente comose define en Profitability and Cost Management. Si se especifica, esta consulta seutilizará para borrar la región de datos dentro del PDV.

Nota: Si especifica un nombre de consulta, debe establecer el valor de todoslos parámetros de tiempo de ejecución (véase más adelante) en false.

• PARÁMETRO=VALOR indica los parámetros de tiempo de ejecución y sus valorespara borrar el PDV. Especifique tantos pares de parámetro y valor como requierael proceso. Parámetros válidos, al menos uno de los cuales es necesario y susvalores:

– isManageRule=true|false especifica si se van a borrar las reglas.

– isInputData=true|false especifica si se van a borrar los datos deentrada

– isAllocatedValues=true|false especifica si se van a borrar los valoresde asignación

– isAdjustmentValues=true|false especifica si se van a borrar losvalores de ajuste

Nota:

Los valores de parámetros (true o false) deben ir en minúscula.

Para borrar regiones de datos en un PDV (si se especifica unNOMBRE_CONSULTA), debe establecer el valor de los parámetros de tiempo deejecución (isManageRule, isInputData, isAllocatedValues eisAdjustmentValues) en false.

• stringDelimiter="DELIMITADOR" especifica el delimitador utilizado en losvalores de PDV. El delimitador debe ir entre comillas dobles.

Ejemplos:

• Borrar todos los artefactos y los datos del modelo de un PDV: epmautomateclearPOV BksML12 2012_Jan_Actual isManageRule=trueisInputData=true isAllocatedValues=trueisAdjustmentValues=true stringDelimiter=”_”

• Borrar regiones de datos en un PDV: epmautomate clearPOV BksML122012_Jan_Actual queryName=BksML12_2012_Jan_clear_query



isManageRule=false isInputData=false isAllocatedValues=falseisAdjustmentValues=false stringDelimiter=”_”


Copia un archivo de un entorno de origen al entorno (destino) desde el que se ejecutaeste comando. Antes de ejecutar este comando, inicie una sesión en EPM Automate yen el entorno de destino.

Sintaxis: epmautomate copyFileFromInstance SOURCE_FILE_NAMEUSERNAME PASSWORD_FILE URL IDENTITYDOMAIN TARGET_FILE_NAME, donde:

• NOMBRE_ARCHIVO_ORIGEN es el nombre del archivo (incluida la extensión) quese quiere copiar desde el entorno origen.

• USUARIO es el nombre de usuario de un administrador de servicio del entorno deorigen.

• ARCHIVO_CONTRASEÑAS es el nombre y la ubicación del archivo que contiene lacontraseña cifrada del administrador de servicio del entorno de origen.

• URL es la URL del entorno de origen.

• DOMINIO_IDENTIDAD es el dominio de identidad del entorno de origen.

• NOMBRE_ARCHIVO_DESTINO es un nombre único para el archivo (incluida laextensión) en el entorno desde el que se ejecuta este comando.

Ejemplo: epmautomate copyFileFromInstance "my data file.zip"serviceAdmin C:\mySecuredir\password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com myprodIdentityDomain "my targetdata file.zip"

copyPOV

Copia los artefactos de modelo y los datos del cubo de Essbase de un PDV de origenen un PDV de destino.

Sintaxis: epmautomate copyPOV APPLICATION_NAME SOURCE_POV_NAMETARGET_POV_NAME PARAMETER=VALUE stringDelimiter="DELIMITER",donde:

• APPLICATION_NAME es el nombre de la aplicación de Profitability and CostManagement que contiene el PDV de origen.

• NOMBRE_PDV_ORIGEN es el nombre del PDV de origen en la aplicaciónespecificada

• NOMBRE_PDV_DESTINO es el nombre de un PDV de destino válido con el estadoDraft

• PARÁMETRO=VALOR indica los parámetros de tiempo de ejecución y sus valorespara copiar el PDV. Especifique tantos pares de parámetro y valor como requierael proceso. Parámetros válidos y sus valores:

– isManageRule=true|false

especifica si se van a borrar las reglas



– isInputData=true|false especifica si se van a borrar los datos deentrada

– modelViewName especifica el nombre del segmento de datos que se va acopiar desde el PDV de origen al PDV de destino.

– createDestPOV=true|false especifica si se va a crear el PDV de destinosi no existe

Nota:



Ejemplo: epmautomate copyPOV BksML12 2012_Jan_Actual2012_Feb_Actual isManageRule=true isInputData=truemodelViewName="Balancing - 5 Customer Costs" createDestPOV=truestringDelimiter=”_”


Copia la instantánea actual de un entorno de origen al entorno (destino) desde el quese ejecuta este comando.

Este comando se utiliza principalmente para migrar (clonar) un entorno copiando lainstantánea actual de otro entorno; por ejemplo, de un entorno de prueba a un entornode producción. Antes de ejecutar este comando, inicie una sesión en EPM Automate yen el entorno de destino.

Sintaxis: epmautomate copySnapshotFromInstance SNAPSHOT_NAMEUSERNAME PASSWORD_FILE URL IDENTITYDOMAIN, donde:

• NOMBRE_INSTANTÁNEA es el nombre de una instantánea existente en el entornode origen.

• USUARIO es el nombre de usuario de un administrador de servicio del entorno deorigen.

• ARCHIVO_CONTRASEÑAS es el nombre y la ubicación del archivo que contiene lacontraseña cifrada del administrador de servicio del entorno de origen.

• URL es la URL del entorno de origen.

• DOMINIO_IDENTIDAD es el dominio de identidad del entorno de origen.

Ejemplo: epmautomate copySnapshotFromInstance "Artifact Snapshot"serviceAdmin C:\mySecuredir\password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com myprodIdentityDomain


Copia los perfiles en el periodo especificado.

Sintaxis: epmautomate createreconciliations PERIODOFILTRO_GUARDADO, donde:

• PERIODO es el nombre de un periodo



• FILTRO_GUARDADO es el nombre de un filtro público guardado. Si no especificaningún filtro guardado, EPM Automate copia todos los perfiles aplicables

Ejemplos:

• epmautomate createReconciliations “January 2015”

• epmautomate createReconciliations “January 2015” “CorporateRecs”

deleteFile

Suprime un archivo o una instantánea de la ubicación de carga predeterminada, unacarpeta Administración de datos o de profitinbox/profitoutbox. Para suprimir unarchivo de una ubicación diferente a la ubicación de carga predeterminada, debeespecificar la ubicación del archivo.

Sintaxis: epmautomate deleteFile FILE_NAME

Nota:

Debe especificar el nombre del archivo, incluida la extensión; por ejemplo,data.csv, data.zip, si procede.

Puede suprimir una instantánea sin especificar la extensión del archivo (.zip).Sin embargo, este uso no está aprobado.

Ejemplos:

• Supresión de la ubicación de carga predeterminada: epmautomate deleteFiledata.csv

• Supresión de la ubicación de carga predeterminada: epmautomate deleteFileoutbox/data.csv

• Suprima una instantánea que haya creado mediante la migración:

– epmautomate deleteFile "Backup 18-06-12.zip" o

– epmautomate deleteFile "Backup 18-06-12" (no aprobado)

• Supresión de profitinbox (Profitability and Cost Management): epmautomatedeleteFile profitinbox/data.csv

• Supresión de profitoutbox (Profitability and Cost Management): epmautomatedeleteFile profitoutbox/data.csv

• Supresión de una carpeta de Data Management: epmautomate deleteFileoutbox/dm_data/data.csv

deletePOV

Suprime los artefactos de modelo y los datos del cubo de Essbase de un PDV.

Sintaxis: epmautomate deletePOV APPLICATION_NAME POV_NAMEstringDelimiter="DELIMITER", donde:

• APPLICATION_NAME es el nombre de la aplicación de Profitability and CostManagement que contiene el PDV que se va a suprimir.



• NOMBRE_PDV es el nombre del PDV que se va a suprimir. Este valor es necesario.


Ejemplo: epmautomate deletePOV BksML12 2012_Jan_ActualstringDelimiter="_"

deployCube

Despliega o vuelve a desplegar el cubo de cálculo de una aplicación de Profitabilityand Cost Management.

Sintaxis: epmautomate deployCube APPLICATION_NAME PARAMETER=VALUEcomment="comment", donde:

• APPLICATION_NAME es el nombre de una aplicación de Profitability and CostManagement

• PARÁMETRO=VALOR indica los parámetros de tiempo de ejecución y sus valorespara desplegar el cubo. Especifique tantos pares de parámetro y valor comorequiera el proceso. Parámetros válidos y sus valores:

Nota:


– isKeepData=true|false

especifica si se conservan los datos existentes, si los hay

– isReplaceCube=true|false especifica si se debe reemplazar el cuboexistente

Nota:

Los valores de isKeepData e isReplaceCube no se pueden definir ambosen true.

– isRunNow=true|false especifica si se va a ejecutar el procesoinmediatamente

• comment es un comentario opcional entre comillas dobles

Ejemplo: epmautomate deployCube BksML12 isKeepData=trueisReplaceCube=false isRunNow=true comment=”Test cube deployment”

downloadFile

Descarga un archivo de un entorno en el equipo local. Este comando se utiliza paradescargar datos, metadatos y copias de seguridad de instantáneas para elalmacenamiento local. Este archivo se descarga en la carpeta desde la que ejecuta EPMAutomate.

Sintaxis: epmautomate downloadFile "[FILE_PATH]/FILE_NAME"

Ejemplos:



• Descarga de instantánea de mantenimiento diario: epmautomatedownloadFile "Artifact Snapshot"

• Descarga de una instantánea personalizada: epmautomate downloadFile"mySnapshot.zip"

• Descarga de un archivo de la ubicación de descarga predeterminada:epmautomate downloadFile data.csv

• Descarga de una carpeta de Data Management: epmautomate downloadfileoutbox/dm_data/data.csv

• Descarga de profitoutbox: epmautomate downloadFile profitOutbox/data.csv

enableApp

Activa una aplicación.

Sintaxis: epmautomate enableapp APPLICATION_NAME, dondeAPPLICATION_NAME es el nombre de la aplicación de Profitability and CostManagement que desea activar.

Ejemplo: epmautomate enableApp BksML12

encrypt

Utiliza el estándar de cifrado avanzado (AES) para cifrar la contraseña de EPM Cloud(y, opcionalmente, la contraseña del servidor proxy de Internet) y almacenarla en unarchivo de contraseñas. Su contraseña solo se cifrará una vez.

Nota:

Consulte Manejo de caracteres especiales para obtener información sobre elcifrado de contraseñas que contengan caracteres especiales.

Sintaxis: epmautomate encrypt CONTRASEÑA CLAVE ARCHIVO_CONTRASEÑAS[ProxyServerPassword=CONTRASEÑA_PROXY], donde:

• CONTRASEÑA es la contraseña del administrador de servicio en el servicio. Nopuede utilizar credenciales corporativas con EPM Automate.

• CLAVE es la clave de cifrado que se utilizará para cifrar la contraseña.

• ARCHIVO_CONTRASEÑAS es el nombre y la ubicación del archivo en el que sealmacena la contraseña cifrada. El archivo de contraseñas debe llevar laextensión .epw.

• ProxyServerPassword=CONTRASEÑA_PROXY es la contraseña con la que elusuario se autentifica en el servidor proxy. Necesaria solo si está activada laautentificación en el servidor proxy para la red.

Ejemplos:

• Cifrado solo de la contraseña de EPM Cloud: epmautomate encryptP@ssword1 myKey C:\mySecuredir\password.epw



• Cifrado de las contraseñas de EPM Cloud y del servidor proxy de Internet:epmautomate encrypt E@xample1 myKey C:\mySecuredir\password.epw ProxyServerPassword=Proxy_Pwd1

exportAppAudit

Exporta registros de auditoría de datos en un archivo ZIP, que puede descargar paraalmacenamiento local.

Sintaxis: epmautomate exportAppAudit EXPORT_FILE_NAME[ndays=Number_of_Days], donde:

• NOMBRE_ARCHIVO_EXPORTACIÓN es el nombre del archivo ZIP que almacenarálos datos de auditoría exportados. Este archivo se almacenará en el buzón desalida, desde donde puede descargarlo en su computadora. Utilice el exploradorde bandeja de entrada/buzón de salida para ver los detalles del archivoexportado.

• ndays, opcionalmente, identifica el número de días para el que se van a exportarlos registros de auditoría. El valor predeterminado es siete días. Los valoresposibles son: all, 1, 2, 7, 30, 60 y 180.

Ejemplo: epmautomate exportAppAudit auditData ndays=30

exportAppSecurity

Exporta las asignaciones de acceso a nivel de artefacto (ACL) a un archivo CSV, quepuede descargar para almacenamiento local.

Sintaxis: epmautomate exportAppSecurity EXPORT_FILE_NAME.CSV, dondeEXPORT_FILE_NAME es el nombre del archivo que almacenará los datos de seguridadexportados. Este archivo se creará en el buzón de salida, desde donde puededescargarlo en su computadora.

Ejemplo: epmautomate exportAppSecurity app_security.CSV

exportData

Exporta datos de la aplicación a un archivo ZIP utilizando la configuración deexportación de datos, incluido el nombre de archivo, especificada en un trabajo de tipoexport data. El archivo de datos exportado se almacena en la ubicación de descargapredeterminada desde donde lo puede descargar en su equipo. Utilice el exploradorde bandeja de entrada/buzón de salida para ver los detalles del archivo exportado.

Sintaxis: epmautomate exportData JOB_NAME [FILE_NAME], donde:JOB_NAME es el nombre de un trabajo definido en la aplicación y FILE_NAME es elnombre del archivo ZIP (opcional) al que se exportarán los datos.

Ejemplo: epmautomate exportData dailydataexport dailyData.zip

exportDimension

Exporta una dimensión desde una aplicación de Oracle Enterprise Data ManagementCloud

Sintaxis: epmautomate exportDimension APPLICATION DIMENSIONFILE_NAME, donde:

• APPLICATION es el nombre de una aplicación de Oracle Enterprise DataManagement Cloud



• DIMENSION es el nombre de una dimensión de aplicación

• FILE_NAME es el nombre del archivo (CSV o ZIP en función del tipo deaplicación de Oracle Enterprise Data Management Cloud) para almacenar losdatos exportados. Este archivo se creará en la carpeta predeterminada; puededescargarlo en un equipo local mediante el comando downloadFile o copiarlo enotro entorno de EPM Cloud mediante el comando copyFileFromInstance.

Ejemplo: epmautomate exportDimension USOperations EntityEntityData.CSV


Exporta las reglas de asignación de una dimensión específica de Oracle EnterpriseData Management Cloud para una ubicación a fin de crear un archivo de reglas deasignación.

Sintaxis: epmautomate exportDimensionMapping APPLICATION DIMENSIONLOCATION FILE_NAME, donde:


• DIMENSION es el nombre de una dimensión de aplicación

• LOCATION es la ubicación específica de para la que se deben exportar las reglas deasignación.

• FILE_NAME es el nombre del archivo CSV para almacenar las asignacionesexportadas. Este archivo se creará en la ubicación predeterminada; puededescargarlo en un equipo local mediante el comando downloadFile o utilizar elcomando copyFileFromInstance para copiarlo en otro entorno de EPM Cloud.

Ejemplo: epmautomate exportDimensionMapping USOperations EntityLoc1 Loc1Mappings.CSV

exportMapping

Exporta las reglas de asignación de una dimensión o ubicación específicas para crearun archivo de reglas de asignación. Debe especificar el nombre de archivo y unaubicación dentro del buzón de salida (por ejemplo, outbox/exportedAccountMap.txt uoutbox/france sales/exportedAccountMap.txt) para exportar las asignaciones. Utiliceel comando downloadfile para descargar el archivo de asignación exportado a unequipo local.

Sintaxis: epmautomate exportMapping NOMBRE_DIMENSIÓN|ALLNOMBRE_ARCHIVO UBICACIÓN, donde

• NOMBRE_DIMENSIÓN|ALL es la dimensión de origen desde la que se van aexportar las asignaciones. Especifique el nombre de la dimensión desde la que sevan a exportar las asignaciones u ALL para exportar asignaciones desde todas lasdimensiones de una ubicación.

• NOMBRE_ARCHIVO es un nombre único para el archivo de asignación y unaubicación dentro del buzón de salida.

• UBICACIÓN es la ubicación de Data Management para la que se deben exportarlas reglas de asignación.

Ejemplos:



• epmautomate exportMapping Account outbox/exportedAccountMap.txt "France Sales"

• epmautomate exportMapping ALL "outbox/france sales/exportedAccountMap.txt" "France Sales"

exportMetadata

Exporta metadatos a un archivo utilizando la configuración especificada en un trabajode tipo export metadata. El archivo que contiene los datos exportados se almacenaen la ubicación de descarga predeterminada desde donde lo puede descargar en unequipo local.

Opcionalmente, puede especificar un nombre de archivo para los datos exportados, loque sustituirá el nombre de archivo predeterminado (nombre del trabajo que se utilizapara exportar metadatos). Los metadatos se exportarán solo como un archivo ZIP.

Sintaxis: epmautomate exportMetadata JOB_NAME [FILE_NAME], dondeJOB_NAME es el nombre de un trabajo definido en la aplicación, y FILE_NAME es elnombre del archivo ZIP al que se exportarán los metadatos.

Ejemplo: epmautomate exportMetadata dailyAccountexportAccountexport.ZIP

exportQueryResults

Ejecuta una consulta definida en una aplicación y exporta los resultados a un archivode texto. El archivo de resultados de la consulta se almacena en profitoutbox; puededescargarlo mediante el comando downloadfile.

Sintaxis: epmautomate exportQueryResults APPLICATION_NAMEfileName=FILE_NAME [queryName=QUERY_NAME][exportOnlyLevel0Flg=true] [roundingPrecision=2], donde:

• APPLICATION_NAME es el nombre de la aplicación de Profitability and CostManagement en la que desea ejecutar la consulta

• fileName es el nombre del archivo .TXT que almacenará los resultados de laconsulta

• queryName es un parámetro opcional que identifica una consulta que se defineen la aplicación. Los nombres de las consultas que contienen caracteres de espaciodeben ir entre comillas dobles.

No especifique un nombre de consulta si desea exportar todos los datos deEssbase que pertenecen a la aplicación.

Las siguientes condiciones pueden provocar que este comando cree un archivo dedatos vacío:

– Una consulta con un formato incorrecto que no recupera ningún dato.

– Una consulta que genera demasiados datos. En este caso, puede reducir elámbito de la consulta de forma que recupere menos datos o divida la consultaen varias consultas más pequeñas.

Consulte Gestión de consultas de Oracle Profitability and Cost ManagementCloud en Administración de Oracle Profitability and Cost Management Cloud.



• exportOnlyLevel0Flg es un parámetro opcional que especifica si los datosrecuperados por la consulta deben estar en el nivel de granularidad más bajo.Especifique este valor de parámetro en minúscula.

Este parámetro se ignora si va a exportar todos los datos de la aplicaciónomitiendo el nombre de la consulta.

• roundingPrecision, de forma opcional, especifica el número de posicionesdecimales (con precisión de redondeo) que se va a utilizar al exportar losresultados de la consulta. Solo es aplicable si se ha especificado queryName. Elvalor predeterminado es 2.

Ejemplos:

• Exportar todos los datos de la aplicación:

epmautomate exportQueryResults BksML12fileName=”MyQuery1.txt”

• Exportar resultados de una consulta específica:

epmautomate exportQueryResults BksML12fileName=”MyQuery1.txt” queryName=”My Product Query”exportOnlyLevel0Flg=true roundingPrecision=3

exportSnapshot

Repite una operación de exportación realizada anteriormente para crear unainstantánea del contenido de Migración. Puede descargar la instantánea exportada dela ubicación predeterminada.

Mediante el uso de la migración, seleccione y exporte los artefactos deseados a unainstantánea; por ejemplo, October16FullApp. Utilice el nombre de la instantáneacon este comando para repetir posteriormente la operación de exportación, queexportará solo los artefactos que se seleccionaron durante la operación de exportaciónoriginal. Consulte Exportación de artefactos y aplicaciones en Administración demigración de Oracle Enterprise Performance Management Cloud.

Sintaxis: epmautomate exportSnapshot SNAPSHOT_NAME , dondeSNAPSHOT_NAME es el nombre de una instantánea existente en Migración. Estainstantánea se reemplazará por la nueva instantánea.

Ejemplo: epmautomate exportSnapshot October16FullApp

exportTemplate

Exporta una aplicación como una plantilla a un archivo .ZIP. El archivo exportado sealmacena en profitoutbox. Puede descargarlo en un equipo local mediante el comandodownloadfile.

Sintaxis: epmautomate exportTemplate APPLICATION_NAME File_Name,donde:

• APPLICATION_NAME es el nombre de la aplicación de Profitability and CostManagement que desea exportar como plantilla

• nombre_archivo es el nombre del archivo de plantilla

Ejemplo: epmautomate exportTemplate BksML12 template1



feedback

Envía comentarios a Oracle y a los administradores del servicio del entorno y carga deforma automática todos los archivos de registro de EPM Automate creados en lasúltimas 24 horas desde el directorio actual. Opcionalmente, puede cargar los archivosadicionales (por ejemplo, scripts de shell o archivos de rastreo Fiddler) que desee queutilicen los Servicios de Soporte Oracle para diagnosticar por qué se produce elproblema actual.

Este comando, que imita la función Proporcionar comentarios del servicio, resulta deespecial utilidad para proporcionar comentarios (solo texto) a Oracle en los casos enque la interfaz de usuario no responde o se produce un problema al ejecutar EPMAutomate.

Para obtener más información sobre la función Proporcionar comentarios, consulte Contribución a la recopilación de información de diagnóstico de Oracle mediante lautilidad de proporción de comentarios en Introducción a Oracle Enterprise PerformanceManagement Cloud para administradores.

Nota:

Los comentarios deben escribirse entrecomillados.

Sintaxis: epmautomate feedback "comment" [screenshot="FILE_PATH"][file="FILE_PATH"], donde:

• Comment es un texto que describe el problema sobre el que se está enviando estecomentario.

• Screenshot, de forma opcional, identifica el nombre de un archivo de gráficoque ilustra el problema para el que se está enviando este comentario. Puedeenviar varias instantáneas mediante la repetición de este parámetro y este valorsegún sea necesario.

• File, de forma opcional, identifica el nombre de un archivo; por ejemplo, unscript que desea que utilicen los Servicios de Soporte Oracle para resolver elproblema actual. Utilice este parámetro para enviar scripts automatizados de EPMAutomate o rastreos de Fiddler a Oracle. Puede enviar varios archivos mediante larepetición de este parámetro y este valor según sea necesario.

Ejemplos:

• Windows: epmautomate feedback "runplantypemapCampaignToReporting ClearData=True did not clear data fromaggregate storage" screenshot=C:/feedback/issue.jpgfile=exampleScript.ps1 file=script.ps1

• Linux: epmautomate feedback "runplantypemapCampaignToReporting ClearData=True did not clear data fromaggregate storage" screenshot=/scratch/screens/issue.jpgfile=/home/feedback/script.sh


Muestra, en la consola, la hora universal coordinada (UTC) a la que está programadoel inicio del mantenimiento diario del entorno.

Sintaxis y ejemplo: epmautomate getDailyMaintenanceStartTime



getSubstVar

Recupera los valores de las variables de sustitución y los muestra en pantalla con elformato NOMBRE_CUBO.VARIABLE_SUSTITUCIÓN=valor, por ejemplo,Plan2.CurYear=2016. Los valores de las variables de sustitución de nivel deaplicación se muestran con el formato ALL.VARIABLE_SUSTITUCIÓN=valor, porejemplo, ALL.CurYear=2016

Sintaxis: epmautomate getSubstVar CUBE_NAME|ALL[name=VARIABLE_NAME], donde:

• NOMBRE_CUBO es el cubo (por ejemplo, Plan1, Plan2) del que desea recuperar lavariable de sustitución. Utilice ALL para recuperar variables de sustitución en elnivel de aplicación.

• name=NOMBRE_VARIABLE identifica opcionalmente la variable de sustituciónpara la que desea recuperar el valor. Si no especifica un nombre de variable, elcomando recupera el valor de todas las variables de sustitución.

Ejemplos:

• Obtener el valor de todas las variables de sustitución en la aplicación y el nivel decubo: epmautomate getSubstVar ALL

• Obtener el valor de una variable de sustitución específica en el nivel de aplicación:epmautomate getSubstVar ALL name=CurYear

• Obtener el valor de todas las variables de sustitución en el nivel de cubo:epmautomate getSubstVar Plan2

• Obtener el valor de una variable de sustitución específica en el nivel de cubo:epmautomate getSubstVar Plan2 name=CurYear

help

Muestra la ayuda para todos los comandos.

Sintaxis: epmautomate help

Ejemplo: epmautomate help

importAppSecurity

Carga permisos de acceso para usuarios o grupos de una aplicación de un archivoCSV disponible en la bandeja de entrada. La importación de permisos de accesosobrescribe las asignaciones existentes solo para miembros importados, formularios dedatos, carpetas de formularios de datos, listas de tareas, reglas de negocio deCalculation Manager y carpetas de reglas de negocio de Calculation Manager. Todoslos demás permisos de acceso existentes se mantienen intactos.

Sintaxis: epmautomate importAppSecurity NOMBRE_ARCHIVO_ACLARCHIVO_ERROR [clearall=true|false], donde:

• NOMBRE_ARCHIVO_ACL es el nombre de un archivo CSV que contiene permisosde acceso que desea importar en la aplicación. Este archivo debe existir en elbuzón de entrada. El contenido de un archivo de entrada de ejemplo puede sersimilar al que se muestra en la siguiente imagen:



Para obtener una descripción de las cabeceras de columna y los posibles valores,consulte Importación de seguridad en API de REST para Oracle EnterprisePerformance Management Cloud.

• ARCHIVO_ERROR es el nombre de un archivo CSV, que EPM Automate creará enel buzón de salida para registrar los errores que se detecten durante estaoperación. Puede descargar este archivo en una computadora local para analizar ycorregir los informes indicados. El contenido de un archivo de error de ejemplopuede ser similar al que se muestra en la siguiente imagen. Las columnas de estearchivo se corresponden con las columnas de cabecera del archivo de entrada:

• clearall, opcionalmente, especifica si se van a suprimir los permisos de accesoexistentes antes de cargar los permisos nuevos del archivo. El valorpredeterminado es false.

Ejemplo: epmautomate importAppSecurity Acl_file.CSVAcl_import_error.CSV clearall=true

importBalances

Utiliza Data Management para importar datos de balances de una definición de cargade datos.

Sintaxis: epmautomate importBalances DL_DEFINITION PERIOD, donde:

• DL_DEFINITION es una definición de carga de datos existente en AccountReconciliation.

• PERIODO es el nombre de un periodo.

Ejemplo: epmautomate importBalances DailyLoad “January 2016”

importData

Importa datos de un archivo a la aplicación utilizando la configuración de importaciónde datos especificada en un trabajo de tipo import data. Utilice el comando uploadFile para cargar el archivo que contiene los datos de la aplicación en laubicación de carga predeterminada.

También puede especificar el nombre del archivo ZIP, CSV o TXT (archivo de datos deformato Essbase) desde el que se van a importar los datos. Si especifica un nombre dearchivo, se ignorará el nombre del archivo de importación en el trabajo.

Si el trabajo se define para importar los datos en formato de Essbase, el archivo ZIPdebe incluir un archivo de formato TXT de Essbase. Para otros trabajos deimportación, el archivo ZIP puede contener uno o más archivos CSV que identifiquen



la secuencia de importación en los nombres de archivo, por ejemplo, data1-3.csv,data2-3.csv y data3-3.csv.

Sintaxis: epmautomate importData JOB_NAME [FILE_NAME], donde:JOB_NAME es el nombre de un trabajo definido en la aplicación y FILE_NAME , deforma opcional, identifica el archivo ZIP o CSV del que se importarán los datos.

Ejemplo: epmautomate importData dailydataload dailydata.zip

importDimension

Importa una dimensión desde un archivo en una aplicación de Oracle Enterprise DataManagement Cloud. Antes de utilizar este comando, utilice el comando uploadFilepara cargar el archivo de importación en el entorno de destino. También puede utilizarel comando copyFileFromInstance para copiar el archivo desde el entorno de EPMCloud.

Sintaxis: epmautomate importDimension APPLICATION DIMENSIONIMPORT_TYPE FILE_NAME, donde:


• DIMENSION es el nombre de la dimensión de aplicación que se está importando.

• IMPORT_TYPE indica cómo realizar la importación. Los tipos de importaciónválidos son los siguientes:

– ResetDimension para suprimir todos los datos de dimensión existentes eimportar los nuevos datos

– ReplaceNodes para agregar o actualizar nodos y reemplazar las jerarquíasexistente durante la importación

– Merge para procesar cambios incrementales en los nodos y las jerarquíasmediante una solicitud de importación

• FILE_NAME es el nombre del archivo (CSV o ZIP en función del tipo deaplicación de Oracle Enterprise Data Management Cloud de la dimensión) quecontiene los datos de dimensión que se van a importar.

Ejemplo: epmautomate importDimension USOperations EntityReplaceNodes EntityData.CSV

importMapping

Importa las asignaciones de un archivo de importación de asignaciones, que se hacargado previamente en el servicio. Utilice el uploadFile comando para cargararchivos en el buzón de Data Management o en una carpeta.

Sintaxis: epmautomate importMapping NOMBRE_DIMENSIÓN|ALLNOMBRE_ARCHIVO MODO_IMPORTACIÓN MODO_VALIDACIÓN UBICACIÓN, donde

• NOMBRE_DIMENSIÓN|ALL indica el destinatario de la asignación. Especifique elnombre de la dimensión a la que se van a importar asignaciones u ALL paraimportar todas las asignaciones incluidas en el archivo a dimensiones adecuadas.

• NOMBRE_ARCHIVO es el nombre y la ubicación del archivo de importación deasignaciones disponible en Data Management en la bandeja de entrada o undirectorio dentro de ella. Especifique el nombre de archivo (archivos TXT en



formato de Data Management estándar) y su ruta (por ejemplo, inbox/AccountMap.txt o inbox/pbcs_maps/AccountMap.txt).

• MODO_IMPORTACIÓN es REPLACE para borrar las reglas de asignación existentesantes de importar asignaciones o MERGE para agregar nuevas reglas de asignacióna las reglas existentes.

• MODO_VALIDACIÓN es TRUE para validar los miembros de destino respecto a laaplicación o FALSE para cargar el archivo de asignación sin ejecutar lasvalidaciones.

• UBICACIÓN es la ubicación de Data Management para la que se deben cargar lasreglas de asignación.

Ejemplos:

• epmautomate importMapping Account inbox/AccountMap.txt MERGEFALSE "France Sales"

• epmautomate importMapping ALL "inbox/France Sales/AllMaps.txt" MERGE FALSE "France Sales" (carga las asignaciones delarchivo de importación de asignaciones en todas las dimensiones asignadas en laubicación France Sales)

importMetadata

Importa metadatos a la aplicación utilizando la configuración de importación de datosespecificada en un trabajo de tipo import metadata. También puede especificar elnombre del archivo ZIP desde el que se importarán los metadatos. Utilice el comando uploadFile para cargar el archivo que contiene los metadatos de la ubicación de cargapredeterminada.

El contenido del archivo ZIP que especifique tendrá prioridad sobre los nombres dearchivo definidos en el trabajo. El archivo ZIP puede contener uno o más archivosCSV. Los nombres de archivo que contienen metadatos para dimensiones debencoincidir con los nombres de archivos de importación definidos en el trabajo o bienterminar por _NOMBREDIMENSIÓN.csv; por ejemplo, metadata_Entity.csv,metadata_HSP_Smart Lists.csv y metadata_Exchange Rates.csv.

Nota:

Solo se importarán los metadatos para las dimensiones para los que estáconfigurada la importación de metadatos en el trabajo. Si están incluidas en elarchivo ZIP, se ignorarán los metadatos para otras dimensiones.



Nota:

Se crea una situación de importación ambigua si se cumplen las doscondiciones siguientes para el archivo ZIP:

• El ZIP contiene un archivo de metadatos cuyo nombre coincide con elnombre de archivo definido en el trabajo.

• El ZIP contiene uno o más archivos de metadatos cuyos nombresterminan en _NOMBREDIMENSIÓN.CSV o _NOMBREDIMENSIÓN.TXT,donde NOMBREDIMENSIÓN es el nombre de la dimensión en la que seimportan los metadatos.

Oracle recomienda que el archivo ZIP contenga un archivo de metadatos quetenga un nombre idéntico al que se hace referencia en el trabajo, o un archivocuyo nombre termine en _NOMBREDIMENSIÓN.CSV (o_NOMBREDIMENSIÓN.TXT), pero no las dos cosas a la vez. Por ejemplo, si va acargar un trabajo que hace referencia al archivo de metadatos Empleados_A-Z.CSV en la dimensión Empleados, el archivo ZIP puede incluirEmpleados_A-Z.CSV o Nuevos_Empleados.CSV, pero no los dos. Si el ZIPcontiene Empleados_A-Z.CSV y Nuevos_Empleados.CSV, EPM Automatepuede seleccionar cualquiera de los dos archivos para la importación,dependiendo del orden de los archivos en el ZIP. El archivo Empleados_A-Z.CSV es apto para la importación porque su nombre coincide con el nombrede archivo al que se hace referencia en el trabajo; Nuevos_Empleados.CSVtambién es apto porque su nombre coincide con el patrón_NOMBREDIMENSIÓN.CSV.

Sintaxis: epmautomate importMetadata JOB_NAME [FILE_NAME], dondeJOB_NAME es el nombre de un trabajo definido en la aplicación, y FILE_NAME es elnombre del archivo ZIP desde el que se van a importar los metadatos.

Ejemplo: epmautomate importMetadata importAccountimportAccount.zip


Importa datos de balance preasignados de un archivo en el repositorio de AccountReconciliation.

Sintaxis: epmautomate importPreMappedBalances PERIOD FILE_NAMEBALANCE_TYPE CURRENCY_BUCKET, donde:


• NOMBRE_ARCHIVO es el nombre del archivo CSV que contiene los datos que sedeben importar

• TIPO_BALANCE es SRC o SUB

• DEPÓSITO_MONEDAS es Entered, Functional o Reporting

Ejemplo: epmautomate importPreMappedBalances “January 2015”dailydata.csv SRC Reporting




Importa transacciones preasignadas de un archivo CSV en el repositorio de AccountReconciliation.

Sintaxis: epmautomate importPreMappedTransactions PERIODTRANSACTION_TYPE FILE_NAME DATE_FORMAT, donde:


• TIPO_TRANSACCIÓN es una de las siguientes opciones:

– BEX para ajustes en el balance explicado

– SRC para ajustes en el sistema de origen

– SUB para ajustes en el subsistema

• NOMBRE_ARCHIVO es el nombre del archivo CSV del que se deben importar losdatos

• FORMATO_FECHA es una cadena de texto con el formato de la fecha, por ejemplo,MMM d, aaaa.

Ejemplo: epmautomate importPreMappedTransactions “January 2015”“BEX” transactions.csv “MMM d, yyyy”

importProfiles

Importa nuevas definiciones de perfil de un archivo CSV en el repositorio de AccountReconciliation.

Sintaxis: epmautomate importProfiles FILE_NAME PROFILE_TYPE METHODDATE_FORMAT, donde:

• NOMBRE_ARCHIVO es el nombre del archivo CSV del que se deben importar losdatos

• TIPO_PERFIL es profiles o children

• MÉTODO es Replace o Update

• FORMATO_FECHA es una cadena de texto con el formato de la fecha, por ejemplo,MMM d, aaaa

Ejemplo: epmautomate importProfiles NewRecProfiles.csv ProfilesReplace “MMM d, yyyy”

importRates

Importa tipos de cambio de un archivo CSV en el repositorio de AccountReconciliation.

Sintaxis: epmautomate importRates PERIOD RATE_TYPE REPLACE_MODEFILE_NAME, donde:


• TIPO_CAMBIO es un tipo de cambio predefinido

• MODO_REEMPLAZO es Replace o ReplaceAll



• NOMBRE_ARCHIVO es el nombre del archivo CSV del que se deben importar lostipos

Ejemplo: epmautomate importRates “January 2015” Actual ReplaceAllavgrates.csv

importSnapshot

Importa el contenido de una instantánea en el entorno de servicio. La instantánea queimporte debe estar disponible en la ubicación de carga predeterminada. Utilice elcomando uploadFile para cargar una instantánea en la ubicación predeterminada.

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

• Los administradores de servicio solo pueden importar artefactos de aplicación enun entorno de servicio.

• Los administradores de dominio de identidad solo pueden importar artefactos dedominio de identidad.

• Necesita tanto roles de administrador de servicio como de administrador deldominio de identidad para importar contenido de la aplicación en el entorno deservicio, y artefactos de dominio de identidad (usuarios y sus asignaciones deroles) en el dominio de identidad del entorno.

Si un usuario que no está en el dominio de identidad aparece en la instantáneaque se está importando, EPM Automate crea un usuario en el dominio deidentidad y asigna la contraseña predeterminada que se especifica en el comando.Por defecto, será necesario que el usuario restablezca la contraseña durante elprimer inicio de sesión.

Nota: A los usuarios que sean miembros de grupos en Control de acceso seles debe asignar un rol predefinido. No están permitidos los intentos deasignar a un grupo un usuario que no esté previamente asignado a un rolpredefinido.

Sintaxis: epmautomate importSnapshot SNAPSHOT_NAME[userPassword=DEFAULT_PASSWORD] [resetPassword=true|false], donde

• SNAPSHOT_NAME es el nombre de una instantánea de la ubicación de cargapredeterminada.

• userPassword indica la contraseña predeterminada que desea asignar a nuevosusuarios que se crean en el dominio de identidad. La contraseña que especifiquedebe cumplir los requisitos mínimos para contraseñas de dominios de identidad.

• resetPassword indica si el nuevo usuario debe cambiar la contraseña en laprimera conexión. A menos que este parámetro opcional se defina en false, seobligará al nuevo usuario a cambiar la contraseña cuando se conecte por primeravez.

Ejemplos:

• Importar artefactos de la aplicación

epmautomate importSnapshot October16FullApp

• Importar artefactos de aplicación y dominio de identidad de la instantánea



– epmautomate importSnapshot October16FullAppuserPassword=Password1

Con este comando se fuerza a los nuevos usuarios a restablecer su contraseñadespués de conectarse por primera vez.

– epmautomate importSnapshot October16FullAppuserPassword=Password1 resetPassword=false

Este comando permite a los usuarios mantener la contraseña predeterminadasi lo desean.


Nota:

Todos los parámetros de comando deben ir entre comillas dobles.

Importa datos adicionales de un archivo a la aplicación. Utilice el comando uploadFilepara cargar el archivo que contiene los datos en la ubicación de carga predeterminada.

Sintaxis: epmautomate importSupplementalData "FILE_NAME""DATA_SET_NAME" "YEAR" "PERIOD_NAME" "SCENARIO_NAME", donde:

• FILE_NAME es el nombre de un archivo CSV, disponible en la ubicación de cargapredeterminada, que contiene datos adicionales con un formato adecuado.

• DATA_SET_NAME es el nombre del conjunto de datos en el que se deben importarlos datos adicionales del archivo.

• YEAR es el año en el que se despliega el conjunto de datos.

• PERIOD_NAME es el nombre del periodo en el que se despliega el conjunto dedatos.

• SCENARIO_NAME es el nombre del escenario en el que se despliega el conjunto dedatos.

Ejemplo: epmautomate importSupplementalData "DatasetImport.csv""EmployeeDataSet" "FY17" "Jan" "Actual"

importTemplate

Crea una estructura de aplicación mediante la importación de un archivo de plantillaque existe en profitinbox. Puede cargar un archivo de plantilla en profitinboxmediante el comando uploadFile.

Sintaxis: epmautomate importTemplate APPLICATION_NAME File_NameisApplicationOverwrite=true|false, donde:

• APPLICATION_NAME es el nombre de la aplicación de Profitability and CostManagement que desea crear mediante la importación de la plantilla.

• nombre_archivo es el nombre del archivo .ZIP que contiene la plantilla deaplicación. Este archivo debe existir en profitinbox.

• isApplicationOverwrite especifica si desea sobrescribir la aplicaciónexistente, si la hay. Especifique este valor de parámetro en minúscula.



Ejemplo: epmautomate importTemplate BksML12 template1.zipisApplicationOverwrite=true


Para un origen de datos específico, importa datos de transacciones previamenteasignadas desde un archivo del repositorio de Account Reconciliation en laConfrontación de transacciones. Utilice el comando uploadFile para cargar el archivode transacciones en el servicio.

Consulte Importación de datos en Conciliación de cuentas con Account Reconciliation paraobtener información sobre requisitos de formato de archivos de importación y laimportación de datos.

Nota:

• A diferencia de la pantalla Trabajos, solo puede importar datos detransacciones previamente asignadas de un archivo a la vez.

• Después de importar transacciones previamente asignadas para todos losorígenes de datos, ejecute el comando runautomatch.

Sintaxis: epmautomate importTmPremappedTransactions MATCH_TYPEDATA_SOURCE FILE_NAME [DATE_FORMAT], donde:

• MATCH_TYPE es un tipo de coincidencia definido en Account Reconciliation.

• DATA_SOURCE es el identificador del origen de datos asociado al tipo deconciliación que ha especificado.

• FILE_NAME es el nombre del archivo CSV que contiene las transacciones quedeben importarse. Este archivo debe estar disponible en el servicio.

• DATE_FORMAT es un parámetro opcional que indica el formato de los campos defecha incluidos en el archivo de importación de transacciones. El valorpredeterminado es DD-MMM-YYYY. Otros formatos de datos admitidos son lossiguientes: MM/dd/yyyy, dd/MM/yyyy, MM-dd-yyyy, d-M-yyyy y MMMd.yyyy.

Ejemplo: epmautomate importTmPremappedTransactions "INTERCOMPANY""AP" dailydata.csv d-M-yyyy

listFiles

Muestra los archivos de la ubicación predeterminada, las carpetas de DataManagement y profitinbox/profitoutbox (Profitability and Cost Management).También muestra los archivos de exportación incrementales y de copia de seguridad, ylas instantáneas de migración.

Sintaxis y ejemplo: epmautomate listFiles

loadData

Carga datos en un cubo de cálculo mediante un archivo disponible en profitinbox.Utilice el comando uploadFile para cargar archivos en profitinbox.



Sintaxis: epmautomate loadData APPLICATION_NAMEdataFileName=File_Name PARAMETER=VALUE, donde:

• APPLICATION_NAME es el nombre de la aplicación de Profitability and CostManagement en la que desea cargar los datos.

• dataFileName=nombre_archivo especifica un archivo de carga de datosdisponible en profitinbox

El nombre del archivo de datos debe ir entre comillas dobles.

• PARÁMETRO=VALOR indica los parámetros de tiempo de ejecución y sus valorespara cargar datos. Especifique tantos pares de parámetro y valor como requiera elproceso. Parámetros válidos y sus valores:

– clearAllDataFlag=true|false especifica si se van a borrar los datosexistentes en el cubo de la aplicación

– dataLoadValue=OVERWRITE_EXISTING_VALUES|ADD_TO_EXISTINGespecifica cómo manejar los datos existentes

Ejemplo: epmautomate loadData BksML12 dataFileName=”data1.txt”clearAllDataFlag=true dataLoadValue=”OVERWRITE_EXISTING_VALUES”

loadDimData

Carga metadatos de dimensión de uno o más archivos de profitinbox en unaaplicación. Utilice el comando uploadFile para cargar archivos en profitinbox.

Sintaxis: epmautomate loadDimData APPLICATION_NAMEdataFileName=File_Name [stringDelimiter="DELIMITER"], donde:

• APPLICATION_NAME es el nombre de la aplicación de Profitability and CostManagement en la que desea cargar los metadatos de dimensión.

• dataFileName=nombre_archivo especifica un archivo de carga de metadatosde dimensión disponible en profitinbox. Para cargar metadatos de varios archivos,indique los nombres de los archivos separándolos con un delimitador.

• stringDelimiter="DELIMITADOR" especifica el delimitador utilizado paraseparar los nombres de los archivos de metadatos. El delimitador debe ir entrecomillas dobles.

Ejemplo: epmautomate loadDimData BksML12dataFileName=”dimdata1.txt#dimdata1.txt” stringDelimiter="#"

login

Establece una conexión segura a un entorno. Puede iniciar una sesión, quepermanecerá activa hasta que se desconecte.



Nota:

• La utilidad no admite el inicio de sesión con las credenciales de inicio desesión único de su organización. Debe utilizar su nombre de usuario ycontraseña de EPM Cloud.

• Al utilizar este comando en los archivos por lotes para automatizaractividades, Oracle recomienda utilizar contraseñas cifradas para evitar elregistro de contraseñas de texto no cifrado en los archivos por lotes.

Al iniciar sesión, aparece un mensaje para actualizar EPM Automate si está usandouna versión anterior de esta. Puede utilizar el comando upgrade para actualizar lainstalación de forma silenciosa.

Sintaxis:

• Con contraseñas no cifradas: epmautomate login USUARIO CONTRASEÑAURL DOMINIO_IDENTIDAD [ProxyServerUserName=USUARIO_PROXYProxyServerPassword=CONTRASEÑA_PROXYProxyServerDomain=DOMINIO_PROXY]

• Con contraseñas cifradas: epmautomate login USUARIOARCHIVO_CONTRASEÑAS URL DOMINIOIDENTIDAD[ProxyServerUserName=USUARIO_PROXY][ProxyServerPassword=CONTRASEÑA_PROXY][ProxyServerDomain=DOMINIO_PROXY]

En estos comandos:

• USUARIO es el nombre de usuario de un administrador de servicio.

• CONTRASEÑA es la contraseña del administrador de servicio.

• ARCHIVO_CONTRASEÑAS es el nombre y la ubicación del archivo en el que sealmacena la contraseña cifrada del administrador de servicio. Consulte elcomando encrypt.

• URL es la URL del entorno al que conectarse.

• DOMINIO_IDENTIDAD es el dominio de identidad del entorno.

• ProxyServerUserName es el nombre de usuario utilizado para autentificar unasesión segura con el servidor proxy que controla el acceso a Internet. Necesariasolo si está activada la autentificación en el servidor proxy para la red.

• ProxyServerPassword es la contraseña con la que el usuario se autentifica en elservidor proxy. Necesaria solo si está activada la autentificación en el servidorproxy para la red. Esta contraseña se puede cifrar. Consulte el comando encrypt.Si esta contraseña está cifrada, se lee del ARCHIVO_CONTRASEÑAS.

• ProxyServerDomain es el nombre del dominio definido para el servidor proxy.Necesaria solo si está activada la autentificación para la red en el servidor proxy ysi se ha configurado un dominio de servidor proxy.



Nota:

EPM Automate detecta y utiliza la configuración del proxy de Internet de sucomputadora. Si la configuración de proxy requiere la autentificación con elservidor proxy, deberá introducir el dominio, el nombre de usuario y lacontraseña de servidor proxy como parámetros de este comando. Póngase encontacto con el administrador de red si necesita ayuda con el nombre dedominio y las credenciales del servidor proxy.

Ejemplos:

• Con una contraseña de EPM Cloud no cifrada, sin autentificación proxy:

epmautomate login serviceAdmin P@ssword1 https://test-cloud-pln.pbcs.us1.oraclecloud.com myIdentityDomain

• Con una contraseña de EPM Cloud cifrada, sin autentificación proxy:

epmautomate login serviceAdmin C:\mySecuredir\password.epwhttps://test-cloud-pln.pbcs.us1.oraclecloud.commyIdentityDomain

• Con una contraseña cifrada de EPM Cloud, si está activada la autentificación enel servidor proxy con un dominio de servidor:

epmautomate login serviceAdmin C:\mySecuredir\password.epwhttps://test-cloud-pln.pbcs.us1.oraclecloud.commyIdentityDomain [email protected]=ejemplo ProxyServerDomain=ejemplo

• Con una contraseña cifrada de EPM Cloud, si está activada la autentificación enel servidor proxy sin un dominio de servidor:

epmautomate login serviceAdmin C:\mySecuredir\password.epwhttps://test-cloud-pln.pbcs.us1.oraclecloud.commyIdentityDomain [email protected]=ejemplo

• Con una contraseña cifrada de EPM Cloud y con una contraseña de servidorproxy, si está activada la autentificación en el servidor proxy sin un dominio deservidor: Consulte el comando encrypt.

epmautomate login serviceAdmin C:\mySecuredir\password.epwhttps://test-cloud-pln.pbcs.us1.oraclecloud.commyIdentityDomain [email protected]=ejemplo

• Con una contraseña cifrada de EPM Cloud y con una contraseña de servidorproxy, si está activada la autentificación en el servidor proxy con un dominio deservidor: Consulte el comando encrypt.

epmautomate login serviceAdmin C:\mySecuredir\password.epwhttps://test-cloud-pln.pbcs.us1.oraclecloud.commyIdentityDomain [email protected]

logout

Finaliza la conexión actual a un entorno.



Sintaxis: epmautomate logout

maskData

Enmascara los datos de aplicación para garantizar la privacidad de los datos. Utiliceeste comando solo en los entornos de prueba para ocultar datos confidenciales a losdesarrolladores de aplicaciones.

ADVERTENCIA: No utilice este comando en entornos de producción, porquealeatoriza datos de aplicación actuales, dejándolos carentes de significado. No puededeshacer los efectos de este comando. Si enmascara los datos de un entorno de serviciopor error, debe restaurar los datos a partir de una copia de seguridad o de lainstantánea de mantenimiento.

Sintaxis: epmautomate maskData [–f], donde -f es una opción para forzar elinicio del proceso de enmascaramiento sin la confirmación del usuario. Si no emplea laopción -f, EPM Cloud le pedirá que confirme la acción.

mergeDataSlices

Fusiona todos los segmentos de datos incrementales de un cubo de almacenamientoagregado en el segmento principal de la base de datos y, opcionalmente, se eliminanlas celdas con el valor cero.

Sintaxis: epmautomate mergeDataSlices CUBE_NAME[keepZeroCells=true|false], donde:

• NOMBRE_CUBO identifica el cubo de almacenamiento agregado para el que sefusionan todos los segmentos de datos.

• keepZeroCells, opcionalmente, especifica si se van a eliminar las celdas quetengan un valor cero (borrar los datos de forma lógica de una región hace que lacelda tenga un valor cero). El valor predeterminado es true

Ejemplo: epmautomate mergeDataSlices rep1 keepZeroCells=false

mergeSlices

Fusiona segmentos de datos incrementales en el cubo de base de datos principal y, demanera opcional, elimina las celdas Essbase que contienen 0 (cero) como valor paracompactar el cubo. Eliminar las celdas que contienen 0 optimiza el rendimiento delcubo.

Sintaxis: epmautomate mergeSlices applicationName[removeZeroCells=true|false], donde:

• applicationName es el nombre de una aplicación de Profitability and CostManagement.

• removeZeroCells, especifica, de manera opcional, si se eliminan las celdas quecontienen 0. El valor predeterminado de este parámetro es false.

Ejemplos:

• Fusionar segmentos sin eliminar celdas que contienen 0

– epmautomate mergeSlices BksML30

– epmautomate mergeSlices BksML30 removeZeroCells=false



• Fusionar segmentos y eliminar celdas que contienen 0

epmautomate mergeSlices BksML30 removeZeroCells=true

provisionReport

Genera un informe de asignaciones de roles (archivo .CSV) y lo almacena en laubicación de descarga predeterminada desde donde lo puede descargar en sucomputadora. El informe muestra los roles predefinidos (por ejemplo, usuarioavanzado de un servicio) y de aplicación (como la asignación masiva, que es un rol deaplicación de Planning) asignados a los usuarios.

Se pueden generar dos versiones del informe: simplificada o clásica. El informesimplificado, que es idéntico al informe de asignaciones de roles que está disponibleen la pantalla Control de acceso, no muestra los roles de aplicación incluidos en rolespredefinidos ni los roles de componentes de roles de aplicación asignados al usuario.La versión clásica del informe muestra los roles de componente incluidos en los rolespredefinidos a los que se asignan los usuarios. Además, muestra los roles deaplicación asignados al usuario (directamente o mediante grupos).

Nota:

Este comando quedará obsoleto en una próxima versión. En lugar de estecomando, use roleAssignmentReport, con el que se obtiene un informeequivalente.

Sintaxis: epmautomate provisionReport REPORT_NAME [format=classic|simplified] [userType=serviceUsers|IDAdmins], donde:

• NOMBRE_INFORME es un nombre para el informe.

• format, opcionalmente, identifica qué formato se va a aplicar al informe. Valoresaceptables:

– simplified, la opción predeterminada, crea un informe idéntico al informede asignaciones de roles generado desde la pantalla Control de acceso.

– classic crea un informe que muestra los roles de componente incluidos enlos roles predefinidos a los que se asignan los usuarios. Además, muestra losroles de aplicación asignados al usuario (directamente o mediante grupos).

• userType, opcionalmente, identifica los usuarios que se van a incluir en elinforme. Si no especifica un valor para este parámetro, se utiliza el valorpredeterminado serviceUsers. Valores aceptables:

– serviceUsers crea un informe que contiene información de todos losusuarios funcionales (no incluye los administradores de dominio deidentidad si no se han asignado a un rol predefinido que otorgue acceso a laaplicación).

– IDAdmins crea un informe que muestra solo los usuarios asignados al rol deadministrador de dominio de identidad. El informe es idéntico en losformatos clásico y simplificado.

Ejemplos:

• Cree un informe clásico:



epmautomate provisionReport myProvReport.CSV format=classic

• Cree un informe simplificado:

– epmautomate provisionReport myProvReport.CSVformat=simplified

– epmautomate provisionReport myProvReport.CSVuserType=serviceUsers

• Cree un informe que muestre solo administradores de dominio de identidad:

– epmautomate provisionReport myProvReport.CSVuserType=IDAdmins

– epmautomate provisionReport myProvReport.CSVuserType=IDAdmins format=classic

recreate

Restaura un entorno a un estado limpio mediante el refrescamiento del despliegue.Este comando también puede utilizarse para cambiar el proceso de negocio que sepuede desplegar en un entorno.

Atención:

• Este comando suprime la aplicación existente y, de forma opcional, todoslos artefactos definidos por el usuario del entorno. Además, vuelve a crearla base de datos y elimina todos los datos existentes. Después de volver acrear el servicio, puede crear una nueva aplicación o importar unaaplicación mediante Migración o EPM Automate.

• Antes de utilizar este comando, realice una copia de seguridad completadel entorno.

Sintaxis: epmautomate recreate [-f] [removeAll=true|false][TempServiceType=Service_type], donde:

• -f fuerza que se inicie el proceso de nueva creación sin confirmación del usuario.Si no emplea la opción -f, EPM Cloud le pedirá que confirme la acción.

• removeAll, opcionalmente, elimina las instantáneas creadas por el usuario y elcontenido de la bandeja de entrada (archivos cargados) y del buzón de salida(archivos exportados del entorno). El valor predeterminado es false, quemantiene las instantáneas y el contenido de la bandeja de entrada y el buzón desalida.

• TempServiceType, de forma opcional, convierte temporalmente un entorno enun entorno de servicio diferente.

El comportamiento de este parámetro depende de su suscripción.

– Suscripciones distintas de EPM Standard Cloud Service y EPM EnterpriseCloud Service:

Puede utilizar la opción TempServiceType para convertir temporalmenteun entorno de Planning, Enterprise Planning, Tax Reporting o Financial



Consolidation and Close en un entorno de Account Reconciliation, OracleEnterprise Data Management Cloud o Profitability and Cost Management.Por ejemplo, si ha adquirido un entorno de Planning, puede convertirlo en unentorno de Account Reconciliation mediante la ejecución del siguientecomando:

epmautomate recreate -f removeAll=true TempServiceType=ARCS

Después de convertir el entorno a Account Reconciliation, puede volver aconvertirlo en el tipo de servicio original mediante la ejecución del siguientecomando:

epmautomate recreate -f

Nota:

Esta opción no se puede utilizar para crear un entorno de Narrative Reporting.

– Suscripciones de EPM Standard Cloud Service y EPM Enterprise CloudService:

Puede utilizar la opción TempServiceType para convertir un entorno deEPM Cloud en cualquier otro entorno soportado.

Las suscripciones de EPM Enterprise Cloud Service utilizan una plataformade EPM Cloud común. Inicialmente, puede desplegar cualquier proceso denegocio de EPM Cloud soportado.

Para cambiar de un proceso de negocio desplegado a otro, debe volver a crearel entorno para suprimir el despliegue actual y devolverlo a la plataformaoriginal de EPM Cloud. A continuación, puede volver a crearlo como elnuevo tipo de servicio. Por ejemplo, si ha creado un proceso de negocio deAccount Reconciliation, pero no desea crear un entorno de Oracle EnterpriseData Management Cloud, debe ejecutar dos veces el comando para volver acrear.

epmautomate recreate -f removeAll=trueepmautomate recreate -f TempServiceType=EDMCS

Si desea convertir un proceso de negocio (por ejemplo, AccountReconciliation) a Planning, Tax Reporting o Financial Consolidation andClose, no es necesario especificar un valor de TempServiceType, porqueestos entornos se pueden crear desde la plataforma original EPM Cloud.

Valores de TempServiceType aceptables:

– ARCS para convertir un entorno en un entorno de Account Reconciliation

– EDMCS para convertir un entorno en un entorno de Oracle Enterprise DataManagement Cloud

– EPRCS para convertir un entorno en un entorno de Narrative Reporting

– PCMCS para convertir un entorno en un entorno de Profitability and CostManagement

Ejemplos:



• epmautomate recreate -f removeAll=true vuelve a crear el entornoactual y lo restaura al tipo de servicio original, si es necesario. Además, elimina lasinstantáneas y el contenido de la bandeja de entrada y el buzón de salida

• epmautomate recreate -f removeAll=true TempServiceType=EDMCSvuelve a crear el entorno actual de Planning, Enterprise Planning, Tax Reporting oFinancial Consolidation and Close como un entorno de Oracle Enterprise DataManagement Cloud y elimina el contenido de la bandeja de entrada y el buzón desalida así como las instantáneas existentes.

refreshCube

Refresca el cubo de la aplicación. Normalmente, puede refrescar el cubo después deimportar los metadatos en la aplicación.

El tiempo necesario para terminar una operación de refrescamiento del cubo dependede los cambios realizados en la estructura de la aplicación y del impacto que tengan enel cubo. Por ejemplo, un refrescamiento después de actualizar un miembro del cubo dealmacenamiento de bloques ligero no puede tardar mucho tiempo, mientras que elrefrescamiento de un cubo después de actualizar un miembro del cubo dealmacenamiento de bloques denso o un miembro del cubo de almacenamiento deagregado podría tardar una cantidad considerable de tiempo. Se debe asegurar de quela operación de refrescamiento del cubo termina antes de que se realice una copia deseguridad de la aplicación durante el próximo periodo de mantenimiento.

Sintaxis: epmautomate refreshCube [JOB_NAME], donde JOB_NAME es elnombre de un trabajo definido en la aplicación

Ejemplo: epmautomate refreshCube dailyCubeRefresh


Elimina la afiliación de un usuario a grupos de Control de acceso identificados en unarchivo CSV ANSI o UTF-8 codificado. Utilice el comando uploadFile para cargararchivos en un entorno. El formato del archivo es el siguiente:

Group NameGroup1Group2

Nota: Estos grupos deben existir en Control de acceso.

Sintaxis: epmautomate removeUserFromGroups FILE_NAME User_Login,donde:

• FILE_NAME es el nombre del archivo CSV que contiene los nombres de los gruposde Control de acceso de los que se va a eliminar la afiliación del usuario.

• User_Login es el identificador de inicio de sesión de un usuario de EPM Cloudcuya afiliación se va a eliminar de los grupos de Control de acceso. Esteidentificador de inicio de sesión de usuario debe existir en el dominio deidentidad que presta servicio al entorno y se debe asignar a un rol predefinido.

Ejemplo: epmautomate removeUserFromGroups [email protected]



removeUsers

Suprime las cuentas de dominio de identidad identificadas en un archivo CSVcodificado por ANSI o UTF-8 que se haya cargado en el entorno. Utilice el comando uploadFile para cargar el archivo. El formato del archivo es el siguiente:

User [email protected]@example.com

Nota:

• Necesita tanto roles de administrador de servicio como de administradorde dominio de identidad para eliminar usuarios de un dominio deidentidad.

• El archivo CSV no debe incluir la cuenta del usuario que ejecuta estecomando.

• Dado que las cuentas de usuario son comunes a todos los entornos deservicio que soporta un administrador de dominio de identidad, alsuprimir una cuenta de un entorno se suprime para todos los entornosque comparten el administrador de dominio de identidad.

Sintaxis: epmautomate removeUsers NOMBRE_ARCHIVO, dondeNOMBRE_ARCHIVO es el nombre del archivo CSV que contiene los ID de inicio desesión de los usuarios que deben eliminarse del dominio de identidad.

Ejemplo: epmautomate removeUsers remove_users.CSV


Elimina los usuarios mostrados en un archivo CSV con codificación ANSI o UTF-8 deun grupo mantenido en Control de acceso. Antes de ejecutar este comando, utilice elcomando uploadFile para cargar el archivo que contiene los inicios de sesión deusuario en el entorno. El formato del archivo es el siguiente:


Sintaxis: epmautomate removeUsersFromGroup NOMBRE_ARCHIVONOMBRE_GRUPO, donde:

• NOMBRE_ARCHIVO es el nombre de un archivo CSV que contiene los nombres deinicio de sesión de los usuarios que desea eliminar de un grupo mantenido enControl de acceso.

• NOMBRE_GRUPO es el nombre del grupo Control de acceso del que desea eliminarusuarios.



Nota:

No puede eliminar su propio inicio de sesión de usuario de un grupo. Elusuario se elimina de un grupo solo si se cumplen las condiciones siguientes:

• Los inicios de sesión de usuario incluidos en el archivo existen en eldominio de identidad que presta servicio al entorno.

• El usuario tiene asignado un rol predefinido en el dominio de identidad.

Ejemplo: epmautomate removeUsersFromGroup user_file.CSVexample_group

removeUsersFromTeam

Elimina a los usuarios de EPM Cloud que se muestran en un archivo CSV de unequipo. Si un usuario incluido en el archivo CSV no es miembro del equipo, con estecomando se ignora al usuario. El formato del archivo CSV es el siguiente:


Sintaxis: epmautomate removeUsersFromTeam ARCHIVO.CSVNOMBRE_EQUIPO, donde:

• ARCHIVO identifica un archivo CSV con formato UTF8 que muestra los ID deconexión de los usuarios que se van a eliminar del equipo. Use el comando uploadFile para cargar el archivo CSV en la bandeja de entrada.

• NOMBRE_EQUIPO identifica un nombre de equipo según la definición de Controlde acceso.

Ejemplo: epmautomate removeUsersFromTeam example_users.csvexample_team

renameSnapshot

Cambia el nombre de una instantánea que ha cargado o creado en un entorno.

No cambie el nombre de una instantánea de mantenimiento en un entorno. Paramantener una copia de seguridad de la instantánea de mantenimiento, debe descargarArtifact Snapshot del entorno en un equipo local y, después, cambiarle elnombre según sea necesario. Consulte Descripción general de la instantánea demantenimiento en Introducción a Oracle Enterprise Performance Management Cloud paraadministradores.

Sintaxis: epmautomate renameSnapshot SNAPSHOT_NAMENEW_SNAPSHOT_NAME donde:

• NOMBRE_INSTANTÁNEA es el nombre de una instantánea existente. Este valor nodebe contener caracteres especiales como espacio, \ (barra invertida), / (barra), *(asterisco), ? (signo de cierre de interrogación), " (comillas), < (menor que) y >(mayor que).

• NOMBRE_INSTANTÁNEA_NUEVA es el nombre único que desea asignar a lainstantánea.



Ejemplo: epmautomate renameSnapshot "Example Snapshot"Example_Snapshot_18_09_25

replay

Reproduce la carga de Oracle Smart View for Office en un entorno con el fin de activarlas pruebas de rendimiento si hay una carga muy elevada para verificar que laexperiencia del usuario es aceptable cuando el servicio tiene una carga especificada.

Debe crear el archivo de reproducción que identifica las actividades de Smart Viewque se deben ejecutar en el servicio. Consulte Preparación para ejecutar el comandoreplay para obtener información detallada sobre cómo crear el archivo dereproducción.

Sintaxis: epmautomate replay REPLAY_FILE_NAME.csv [duration=N][trace=true] [lagTime=t], donde:

• NOMBRE_ARCHIVO_REPRODUCCIÓN es un archivo CSV que almacena lasactividades que se van a ejecutar en el entorno.

• Duration es un parámetro opcional que indica durante cuántos minutos seejecutan las actividades en el entorno.

Las actividades del archivo HAR se ejecutan una sola vez si no se define estevalor. Si las actividades del archivo HAR finalizan en el tiempo especificado poreste parámetro, EPM Automate vuelve a ejecutar el archivo HAR hasta quefinalicen las actividades. Por ejemplo, imagine que ha establecido duration=10para reproducir un archivo HAR que tarda tres minutos en ejecutarse. En esteescenario, el comando replay ejecuta las actividades del archivo HAR cuatro veces(unos 12 minutos) hasta que finalice la cuarta iteración.

• trace=true es una configuración opcional que indica a EPM Automate que creearchivos de rastreo en formato XML.

Si se especifica esta configuración opcional, EPM Automate crea una carpeta paracada archivo HAR incluido en el archivo CSV de reproducción y almacena todoslos archivos de rastreo relacionados en ella. Por cada actividad en el archivo HAR,EPM Automate genera un archivo de rastreo que contiene la respuesta de SmartView. Los archivos de rastreo se denominan trace-N.xml; por ejemplo,trace-1.xml, donde N es un contador que comienza en 1.

Las carpetas que almacenan los archivos de rastreo se crean en el directorio desdeel que se ejecuta EPM Automate. EPM Automate usa una combinación de hora delsistema del servidor actual y nombre del archivo HAR con formatoAAAA_MM_DD_HH_MM_SS_NOMBRE_ARCHIVO_HAR para asignar un nombre a lascarpetas. Por ejemplo, si el nombre del archivo HAR es forecast1.har, elnombre de la carpeta puede ser 2016_06_08_10_21_42_forecast1.

• [lagTime=t] es un parámetro opcional que especifica el número de segundosque el comando debe esperar entre la ejecución de cada archivo HAR incluido enel archivo de reproducción. Una vez que se ha iniciado la ejecución del primerarchivo HAR, el comando espera el número de segundos especificado por esteparámetro para iniciar el procesamiento del siguiente archivo HAR. Debido a quelas actividades de usuario normalmente no se inician de manera simultánea,establecer este parámetro ayuda a crear una simulación de carga más realista enun entorno.

Los números negativos (por ejemplo -1) y las fracciones (por ejemplo, 1/2) no seaceptan como valor del parámetro. Se soportan valores decimales. Si este



parámetro no se establece, la ejecución de todos los archivos HAR del archivo dereproducción se iniciará simultáneamente; al igual que si se establece lagTime=0.

Por ejemplo, suponga que desea simular la carga de 1000 usuarios iniciandosesión en un entorno durante la hora punta para realizar actividades. Puede creararchivos HAR para simular estas sesiones y, después, ejecutar este comando conun tiempo de demora de 3,6 segundos para replicar la carga utilizada en elentorno.

Ejemplo: epmautomate replay forecast1.CSV duration=60 lagTime=3.6

Consulte Sesión de reproducción de ejemplo para obtener los pasos detalladosimplicados en la ejecución de este comando.


Genera un informe de asignaciones de roles (.CSV) y lo almacena en la ubicación dedescarga predeterminada desde donde lo puede descargar en su computadora. Elinforme muestra los roles predefinidos (por ejemplo, usuario avanzado de un servicio)y de aplicación (como la asignación masiva, que es un rol de aplicación de Planning)asignados a los usuarios. Este informe coincide con la versión CSV del informe deasignaciones de roles generado desde Control de acceso.

Nota:

Con este comando se genera un informe equivalente al creado con el comandoprovisionReport con los valores predeterminados:

epmautomate provisionReport REPORT_NAME format=simplifieduserType=serviceUsers

Sintaxis: epmautomate roleAssignmentReport NOMBRE_INFORME dondeNOMBRE_INFORME es el nombre del informe.

Ejemplo: epmautomate roleAssignmentReport myReport.CSV

resetService

Reinicia el entorno. Utilice este comando solo cuando observe una degradación gravedel rendimiento o si recibe mensajes de error que indiquen que el entorno no puedeutilizarse. El reinicio de un entorno no afecta a las personalizaciones de la aplicación(por ejemplo, el cambio de configuración regional, los valores relacionados con el temay la moneda, ect.). El reinicio tarda hasta 15 minutos.



Nota:

Los comentarios deben escribirse entrecomillados.

Sintaxis: epmautomate resetService "comment" [-f], donde:

• Comment es una descripción del problema que ha causado que restableciera elentorno. Los comentarios deben escribirse entrecomillados.

• -f, de forma opcional, especifica que desea forzar el reinicio del entorno sininteracción adicional del usuario. Si no emplea esta opción, EPM Automate lepedirá que confirme la acción. Esta opción resulta útil si programa un script queutilice este comando.

Ejemplos:

• epmautomate resetService "Users experience slow connections;force restarting the environment" -f

• epmautomate resetService "Users experience unacceptably slowconnections"

restructureCube

Realiza una reestructuración completa de un cubo de almacenamiento de bloques paraeliminar o reducir la fragmentación. La reestructuración también elimina los bloquesvacíos, y no traspasará ningún cambio de la aplicación al cubo.

Nota:

Antes de ejecutar este comando, asegúrese de que nadie utiliza la aplicación.

Sintaxis: epmautomate restructureCube CUBE_NAME, donde CUBE_NAME es elnombre de un cubo exactamente como figura en una aplicación.

Ejemplo: epmautomate restructureCube Plan1

runAutomatch

Ejecuta el proceso de coincidencia automática para hacer coincidir transaccionesutilizando las reglas definidas por un administrador del servicio. Puede supervisar elestado del proceso de coincidencia automática en el separador Historial de trabajosde Account Reconciliation.

Nota: Ejecute este comando después de importar datos de transacciones en laconfrontación de transacciones con el comandoimportTmPremappedTransactions.

Sintaxis: epmautomate runAutomatch RECONCILIATION_TYPE, dondeRECONCILIATION_TYPE es un tipo de conciliación definido en AccountReconciliation.

Ejemplo: epmautomate runAutomatch INTERCOMPANY



runBatch

Ejecuta un lote de Data Management.

Si el modo de ejecución de lote de Data Management está establecido en En serie, sedevuelve el control cuando todos los trabajos del lote están completados; si estáestablecido en Paralelo, se devuelve el control cuando todos los trabajos del lote seenvían para la ejecución.

Sintaxis: epmautomate runBatch BATCH_NAME, donde

NOMBRE_LOTE es el nombre de un lote definido en Data Management.

Ejemplos: epmautomate runBatch Accounting_batch

runBusinessRule

Inicia una regla de negocio o un conjunto de reglas.

Sintaxis: epmautomate runBusinessRule RULE_NAME [PARAMETER=VALUE],donde:

• NOMBRE_REGLA es el nombre de una regla de negocio exactamente como se defineen el entorno.

• PARÁMETRO=VALOR indica los parámetros en tiempo de ejecución opcionales ysus valores necesarios para ejecutar la regla de negocio.

Especifique los parámetros de tiempo de ejecución para iniciar solo reglas. Si estáejecutando conjuntos de reglas, el comando omite los parámetros de tiempo deejecución que especifique. Los conjuntos de reglas se ejecutan utilizando losvalores predeterminados que ha especificado al crear el conjunto de reglasmediante Calculation Manager.

Nota:

La regla se ejecuta en el tipo de plan en el que se ha desplegado.

Utilice el par PARÁMETRO=VALOR para especificar tantas peticiones de datosen tiempo de ejecución como reglas de negocio se necesiten. En el siguienteejemplo se utilizan dos peticiones de datos en tiempo de ejecución (Period yEntity) y sus valores (Q1 y USA).

Se utilizan los valores predeterminados si no se proporcionan valores para losparámetros de tiempo de ejecución. El comando ignora las peticiones de datosen tiempo de ejecución que no coincidan exactamente con las definidas en laregla.

Consulte Especificación de varios valores para un parámetro para obtenerinformación sobre cómo introducir varios valores para un parámetro.

Ejemplo: epmautomate runBusinessRule RollupUSSales Period=Q1Entity=USA

runCalc

Realiza los cálculos en una aplicación. Mediante el uso de este comando, puedeejecutar cálculos con reglas en un PDV de modelo en datos de un PDV de datosdiferente sin copiar las reglas en los distintos PDV.



Sintaxis: epmautomate runCalc APPLICATION_NAME POV_NAME[DATA_POV_NAME] PARAMETER=VALUE [comment="comment"]stringDelimiter="DELIMITER", donde:

• APPLICATION_NAME es el nombre de la aplicación de Profitability and CostManagement que contiene el PDV que se va a calcular.

• NOMBRE_PDV es el nombre del PDV de modelo que se va a calcular.

• NOMBRE_PDV_DATOS es, opcionalmente, el nombre del PDV de datos que se va acalcular mediante el uso de reglas del PDV de modelo.

Si no se especifica NOMBRE_PDV_DATOS, de forma predeterminada se utilizaráNOMBRE_PDV.

Solo puede utilizar exeType=ALL_RULES si especifica NOMBRE_PDV_DATOS.

• PARÁMETRO=VALOR indica los parámetros de tiempo de ejecución y sus valorespara realizar el cálculo. Especifique tantos pares de parámetro y valor comorequiera el proceso. Parámetros válidos y sus valores:

– exeType=ALL_RULES|RULESET_SUBSET|SINGLE_RULE identifica el tipode ejecución de regla. Es un parámetro necesario.

Según el valor definido para exeType, se pueden especificar los siguientesparámetros:

* Si especifica exeType=ALL_RULES, no incluya el subconjunto de reglaso parámetros relacionados con una única regla como subsetStart,subsetEnd, ruleSetName y ruleName. Debe utilizar este exeType siestablece el parámetro NOMBRE_PDV_DATOS.

* Si especifica exeType=SINGLE_RULE, especifique los valores solo pararuleSetName y ruleName.

* Si especifica exeType=RULESET_SUBSET, especifique los valores parasubsetStart y subsetEnd.

– subsetStart especifica el número de secuencia de la primera regla delconjunto de reglas para ejecutar

– subsetEnd especifica el número de secuencia de la última regla del conjuntode reglas para ejecutar

– ruleSetName identifica el conjunto de reglas que contiene los cálculos quedesea realizar

– ruleName es el nombre de la regla que se va a ejecutar (para ejecutar unasola regla)

– isClearCalculated=true|false especifica si se van a borrar los cálculosexistentes

– isExecuteCalculations=true|false especifica si se van a realizarcálculos

– isRunNow=true|false defina este valor en true para ejecutar el procesoahora



– optimizeReporting=true|false establezca este valor opcional enfalse si los cálculos se van a realizar sin optimización para la generación deinformes. El valor predeterminado es true

Mejores prácticas:

* Establezca optimizeReporting=false solo cuando sea necesario paraahorrar tiempo de procesamiento; por ejemplo, al ejecutar una sola reglao una serie secuencial de varios PDV.

* Cuando ejecute varios trabajos de cálculo simultáneos, establezcaoptimizeReporting=true para todos los trabajos; solo el últimotrabajo en completarse realizará la agregación, evitando el procesamientoredundante e impidiendo que los trabajos en ejecución se ralenticen.

– comment es un comentario opcional entre comillas dobles

– stringDelimiter es el delimitador utilizado en los valores de PDV. Eldelimitador debe ir entre comillas dobles.

Nota:


Ejemplo: epmautomate runCalc BksML12 2012_Jan_Actual Jan-2016isClearCalculated=true isExecuteCalculations=true isRunNow=truesubsetStart=10 subsetEnd=20 ruleSetName=”Utilities ExpenseAdjustment" ruleName="Occupancy Expense Allocations"exeType=”ALL_RULES” comment=”Test calculation”stringDelimiter="_"

runComplianceReport

Genera un informe que está definido en Conformidad de conciliación. Consulte Usode informes en Administración de Account Reconciliation para obtener instrucciones parala definición de informes.

Sintaxis: epmautomate runComplianceReport FILE_NAME GROUP_NAMEREPORT_NAME REPORT_FORMAT [Param=value], donde:

• FILE_NAME es un nombre de archivo único para el informe que se va a generar. Siya existe un informe con este nombre en el servidor, este se sobrescribirá. Utiliceel comando downloadFile para descargar este informe en un equipo local.

• GROUP_NAME es el nombre del grupo con el que está asociado el informe.

• REPORT_NAME es un nombre único para el informe que se va a generar.

• REPORT_FORMAT es uno de los siguientes formatos para el informe:

– PDF

– HTML (no está soportado para gráficos)

– XLS (no está soportado para gráficos)

– XLSX (no está soportado para gráficos)

– CSV



• Param=value, de forma opcional, identifica los parámetros necesarios paragenerar el informe. Por ejemplo, el informe Balance By Account Type tomados parámetros: Period con el valor July 2017 y Currency Bucket con elvalor Entered. Debe especificar estos parámetros como "Period = July2017" "Currency Bucket = Entered".

Consulte Generación de informes predefinidos en Conformidad de conciliación enAdministración de Account Reconciliation para obtener la lista de informes predefinidosde Conformidad de conciliación y los parámetros para generarlos.

Ejemplo: epmautomate runComplianceReport "Example_File Name""Reconciliation Manager" "Balance By Account Type" PDF "Period =July 2017" "Currency Bucket = Entered"

runDailyMaintenance

Inicia el proceso de mantenimiento de servicio diario inmediatamente, en lugar deesperar a que se muestre la ventana del mantenimiento diario programado. Estecomando le permite forzar la creación de una instantánea de copia de seguridad yactualizar el entorno. Antes de ejecutar este comando, asegúrese de que nadie utiliza elentorno. Este comando no afecta a la programación de mantenimiento diario. Utiliceeste comando si no desea esperar a la ventana del próximo mantenimiento para que seapliquen los cambios realizados en el entorno; por ejemplo, después de aplicar unarevisión puntual.

Sintaxis: epmautomate runDailyMaintenance [skipNext=true|false] [-f], donde:

• skipNext, opcionalmente, indica si se debe omitir la siguiente aparición delproceso de mantenimiento diario. El valor predeterminado es "false".

• -f, opcionalmente, indica si se debe forzar el inicio del proceso de mantenimientosin la confirmación del usuario. Si no emplea la opción -f, EPM Cloud le pediráque confirme la acción.

Ejemplos:

• Para forzar el inicio de un mantenimiento diario fuera del ciclo sin omitir elsiguiente mantenimiento programado: epmautomate runDailyMaintenance-f

• Para forzar el inicio de un mantenimiento diario fuera del ciclo y omitir elsiguiente mantenimiento programado: epmautomate runDailyMaintenanceskipNext=true -f

• Para iniciar un mantenimiento diario fuera del ciclo y omitir el siguientemantenimiento programado: epmautomate runDailyMaintenanceskipNext=true

runDataRule

Ejecuta una regla de carga de datos de Data Management basada en el periodo inicialy en el periodo final, así como en las opciones de importación o exportación queespecifique.

Sintaxis: epmautomate runDataRule RULE_NAME START_PERIOD END_PERIODIMPORT_MODE EXPORT_MODE [FILE_NAME], donde:



• NOMBRE_REGLA es el nombre de una regla de carga de datos definida en DataManagement. Debe entrecomillar el nombre de la regla si contiene espacios.

• PERIODO_INICIAL es el primer periodo durante el que se deben cargar los datos.Este nombre de periodo debe estar definido en la asignación de periodos de DataManagement

• PERIODO_FINAL es, cuando la carga de datos abarca varios periodos, el últimoperiodo durante el que se deben cargar los datos. Cuando la carga abarca un soloperiodo, introduzca el mismo periodo que el periodo inicial. Este nombre deperiodo debe estar definido en la asignación de periodos de Data Management

• MODO_IMPORTACIÓN determina cómo se importan los datos a Data Management.

La configuración del modo de importación es sensible a mayúsculas/minúsculas.Estos son los valores aceptables:

– APPEND para agregar los datos de PDV existentes a Data Management.

– REPLACE para suprimir los datos de PDV y reemplazarlos por los datos delarchivo

– RECALCULATE para volver a calcular los datos

– NONE para omitir la importación de datos a la tabla temporal de DataManagement

• MODO_EXPORTACIÓN determina cómo se exportan los datos a la aplicación.

La configuración del modo de exportación es sensible a mayúsculas/minúsculas.Estos son los valores aceptables:

Nota:

Para Financial Consolidation and Close, solo se admiten los siguientes modosde exportación:

– MERGE para fusionar los datos de la tabla temporal de Data Managementcon los datos existentes

– REPLACE para eliminar entradas de la tabla temporal de DM y sustituirlaspor las de la carga de datos

– NONE para omitir la exportación de datos de Data Management a laaplicación

Nota:

Para Oracle Fusion Cloud como destino, solo se admiten los siguientes modosde exportación:

– MERGE para fusionar los datos de la tabla temporal de Data Managementcon los datos existentes

– NONE para omitir la exportación de datos de Data Management a laaplicación



– STORE_DATA para fusionar los datos de la tabla temporal de DataManagement con los datos existentes

– ADD_DATA para agregar los datos de la tabla temporal de Data Management ala aplicación

– SUBTRACT_DATA para restar los datos de la tabla temporal de DataManagement de los datos existentes

– REPLACE_DATA para borrar los datos de PDV y reemplazarlos por los datosde la tabla temporal de Data Management. Se borran los datos de Escenario,Versión, Año, Periodo y Entidad

– NONE para omitir la exportación de datos de Data Management a la aplicación

• NOMBRE_ARCHIVO es un nombre de archivo opcional. Si no especifica ningúnnombre de archivo, EPM Automate importa los datos incluidos en el nombre dearchivo especificado en la regla de carga de datos. Este archivo debe estardisponible en la carpeta de la bandeja de entrada o en una carpeta dentro de ella.

Nota:

Si se especifica una ruta en la regla de datos, no especifique la ruta de archivoen el comando. Especifique solo el nombre de archivo. Si no se especifica unaruta en la regla de datos, especifique la ruta completa para el archivo de datos.

Ejemplos:

• Importación de varios períodos: epmautomate runDataRule VisionActualMar-15 Jun-15 REPLACE STORE_DATA inbox/Vision/GLActual.dat

• Importación de un solo período: epmautomate runDataRule "VisionActual" Mar-15 Mar-15 REPLACE STORE_DATA inbox/Vision/GLActual.dat

runDMReport

Crea un informe de Data Management y lo almacena en la carpeta outbox/reports.Utilice el comando downloadfile para descargar el informe en un equipo local.

El informe generado se denomina según el ID del trabajo de Data Management quegenera el informe y el formato del informe. Por ejemplo, si el ID de trabajo del informees 2112 y el formato de salida del informe que especifique es PDF, el nombre delinforme es 2112.pdf. El nombre del informe aparece en la consola después de que segenere el informe. También puede identificar el nombre del informe en el separadorDetalles del proceso de Data Management o mediante el comando listfiles.

Sintaxis: epmautomate runDMReport NOMBRE_INFORME PARÁMETRO=Valor"Report Output Format=[PDF|HTML|XLS|XLSX]", donde

• NOMBRE_INFORME es el nombre de la plantilla de informe de Data Managementque se va a utilizar para la generación del informe.

• PARÁMETRO=Valor indica parámetros de informe y sus valores. Puedeespecificar tantos parámetros como sea necesario en formato PARÁMETRO=Valor.La lista de parámetros necesarios dependerá del informe que desee generar.



Nota:

Los parámetros de tiempo de ejecución de informe se definen al diseñar losinformes. Para ejecutar este comando, debe generar y copiar estos parámetrosy valores en EPM Automate en el separador Flujo de trabajo. Para generar losparámetros de tiempo de ejecución de un informe, en el separador Flujo detrabajo de Data Management, haga clic en Ejecución del informe y, acontinuación, seleccione un grupo de Grupo de informes. Seleccione elinforme para el que desea generar los parámetros y, a continuación, haga clicen Crear script de informe. Opcionalmente, puede especificar valores deparámetros de informe y, a continuación, seleccionar un formato de salida y,luego, hacer clic en Aceptar. Utilice los parámetros que se muestran enGenerar script de informe para especificar los parámetros de tiempo deejecución y los valores para generar el informe.

• Formato de salida de informe indica el formato de salida del informe. Lasopciones válidas son PDF, HTML, XLS y XLSX. El formato de informepredeterminado es PDF.

Ejemplo: epmautomate runDMReport "TB Current Location By TargetAcct (Cat,Per)" "Period=Jul 14" "Category=Forecast""Location=FCSTtoVISCONSOL1" "Rule Name=FCSTtoVISCONSOL1" "ReportOutput Format=HTML"

runMatchingReport

Genera un informe que está definido en Confrontación de transacciones.

Sintaxis: epmautomate runMatchingReport FILE_NAME GROUP_NAMEREPORT_NAME REPORT_FORMAT [Param=value], donde:

• FILE_NAME es un nombre de archivo único para el informe que se va a generar. Siya existe un informe con este nombre en el servidor, este se sobrescribirá. Utiliceel comando downloadFile para descargar este informe en un equipo local.

• GROUP_NAME es el nombre del grupo con el que está asociado el informe.

• REPORT_NAME es un nombre único para el informe que se va a generar.

• REPORT_FORMAT es uno de los siguientes formatos para el informe:

– PDF

– HTML (no está soportado para gráficos)

– XLS (no está soportado para gráficos)

– XLSX (no está soportado para gráficos)

– CSV

• Param=Value, de forma opcional, identifica los parámetros necesarios paragenerar el informe. Por ejemplo, para el informe Match Type Configuration,que toma el parámetro status con el valor approved, especifique el parámetroy el valor como status=Approved.



Consulte Generación de informes predefinidos en Coincidencia de transacciones enAdministración de Account Reconciliation para obtener la lista de informes predefinidosde Confrontación de transacciones y los parámetros para generarlos.

Ejemplo: epmautomate runMatchingReport Example_FileName"Transaction Matching" "Match Type Configuration" HTML“status=Approved”

runPlanTypeMap

Copia los datos de una base de datos de almacenamiento de bloques en una base dedatos de almacenamiento agregado o de un almacenamiento de bloques en otroalmacenamiento de bloques según la configuración especificada en un trabajo de tipoplan type map.

Sintaxis: epmautomate runPlanTypeMap JOB_NAME [clearData=true|false], donde:

• NOMBRE_TRABAJO es el nombre de un trabajo de tipo plan type map definidoen la aplicación.

• clearData es una configuración opcional que indica si los datos de la base dedatos destino se deben eliminar antes de copiar los datos. Si no se establece estevalor de parámetro, se utiliza el valor predeterminado true.


Ejemplo: epmautomate runPlanTypeMap CampaignToReportingclearData=false


Establece la hora UTC a la que se inicia el mantenimiento diario del entorno.

Para garantizar que el uso de este comando no interfiera con el requisito de Oracle decrear copias de seguridad, este comando no cambiará la hora de inicio delmantenimiento si el proceso de mantenimiento diario no se ha realizado en las últimas36 horas.

Sintaxis: epmautomate setDailyMaintenanceStartTime HoraInicio, dondeHoraInicio es la hora UTC (en formato HH:00 de 24 horas) a la que debe empezar elproceso de mantenimiento. El rango de valores aceptable oscila entre las 00:00 y las23:00.

Ejemplo: epmautomate setDailyMaintenanceStartTime 14:00 (establece lahora de mantenimiento diario a las 2:00 PM UTC)

setDemoDates

Utilice este comando solo en la configuración de instalaciones con datos de lademostración interna de Oracle.

Solo para Account Reconciliation: vuelve a nombrar los períodos de AccountReconciliation para que sean consistentes con la fecha especificada. También restablecelas fechas de todas las conciliaciones que tienen asociados valores del atributo DemoCode de setdemodate o setdemodatenostatuschage.

Este comando gestiona conciliaciones en hasta dos períodos; un periodo actual y unperíodo anterior (históricas). Si las conciliaciones de más de dos períodos se etiquetancon el atributo Demo Code, el comando trata estos periodos como si pertenecieran al



periodo anterior. Las conciliaciones que no tienen este valor de atributo no se venafectadas.

• Si el valor es setdemodate, el comando restablece las fechas de conciliación enfunción de la fecha especificada y la devuelve al estado Abierto conpreparador

• Si el valor es setdemodatenostatuschage, el comando restablece las fechas deconciliación en función de la fecha especificada, pero sin cambiar el estado deconciliación

Solo para Financial Consolidation and Close y Tax Reporting: este comandorestablece la fecha de inicio y finalización de las tareas y otros datos referentes a fechaspara que las tareas sean adecuadas para una demostración. Calcula las nuevas fechasde tarea basándose en el valor del conjunto de atributos SETDEMODATES de laprogramación de tareas junto con el valor Demo Date proporcionado. Si no seespecifica el valor Demo Date, el comando utiliza la fecha del día para calcular lasnuevas fechas de tareas.

Nota: Las tareas de programas que no tienen el valor SETDEMODATES no seven afectadas.

En función de la fecha de demostración que especifique, este comando adelantatodas las fechas asociadas a la tarea. Esto incluye las fechas principales de tiempo deejecución (fecha de inicio, fecha de finalización, etc.) y fechas auxiliares, incluidasfechas del historial, fechas de vencimiento de flujo de trabajo individual y fechas deinicio (reales). El estado de la tarea no se ve afectado.

Sintaxis: epmautomate setDemoDates [DEMO_DATE], donde DEMO_DATE es unafecha opcional en el formato YYYY-MM-DD. Las conciliaciones se restablecen a la fechaactual si no especifica este valor.

Ejemplo: epmautomate setDemoDates 2017-02-15

setEncryptionKey

Establece una clave de cifrado personalizada para el acceso a la base de datos. La clavede cifrado personalizada se aplica después del siguiente mantenimiento diario delentorno. Puede activarla inmediatamente ejecutando el comando resetService.

Usar este comando proporciona una solución Traiga su propia clave (BYOK) para quelos clientes incluyan EPM Cloud en su rotación de administración de claves estándar.

Sintaxis: epmautomate setEncryptionKey key=key, donde key es una cadenapersonalizada de cualquier longitud que desea utilizar como clave de cifrado.

Ejemplos:

• Para definir la clave de cifrado: epmautomate setEncryptionKey key=se!m+a2J

• Para eliminar la clave de cifrado: epmautomate setEncryptionKey key=

setManualDataAccess

Especifica si Oracle puede acceder manualmente a la base de datos de un entorno ensituaciones de emergencia cuando un entorno no responda y el cliente aún no haya



proporcionado una solicitud de servicio para investigar y hacer que el entorno estédisponible.

En una situación de emergencia, Oracle recurre a un proceso interno donde unejecutivo de desarrollo de alto nivel, tras un proceso de verificación independiente,permite un acceso manual a la base de datos. Use este comando para impedir queOracle acceda a la base de datos sin su aprobación explícita.

Sintaxis: epmautomate setManualDataAccess Allow|Revoke

El valor que especifique con este comando se aplicará de forma inmediata.

Ejemplos:

• Si desea impedir el acceso de base de datos manual sin aprobación explícita:epmautomate setManualDataAccess revoke

• Para permitir el acceso a la base de datos manual durante las emergencias:epmautomate setManualDataAccess allow

setPeriodStatus

Establece un estado de periodo específico.

Sintaxis: epmautomate setPeriodStatus PERIOD STATUS, donde:


• ESTADO es OPEN, CLOSED o LOCKED

Ejemplo: epmautomate setPeriodStatus “January 2015” OPEN

setSubstVars

Crea o actualiza variables de sustitución en el nivel de aplicación o de cubo. No puedeutilizar este comando para establecer múltiples valores y/o funciones para variablesde sustitución.

Sintaxis: epmautomate setSubstVars CUBE_NAME SUBSTVAR=VALUE[SUBSTVAR=VALUE], donde:

• NOMBRE_CUBO es el cubo (por ejemplo, Plan1 o Plan2) para el que se crea o seactualiza la variable de sustitución. Utilice All en lugar de un nombre de cubopara establecer o actualizar la variable de sustitución en el nivel de aplicación.

• VARIABLE_SUSTITUCIÓN es el nombre de la variable de sustitución cuyo valorse establece o se actualiza.

• VALOR es el nuevo valor de la variable de sustitución.

Ejemplos:

• Crear o actualizar una variable de sustitución en el nivel de aplicación:epmautomate setSubstVars ALL CurYear=2015 CurPeriod=Jan

• Crear o actualizar variables de sustitución en el nivel de cubo: epmautomatesetSubstVars Plan2 CurYear=2013 CurPeriod=Jan



sortMember

Ordena los miembros de dimensiones de entidad, cuenta, escenario, versiones y dedimensiones personalizadas. Este comando ayuda a ordenar los miembros dedimensión después de cargar los miembros en Planning.

Nota:

• No puede utilizar este comando para ordenar miembros de dimensionesde periodo, años y moneda.

• Este comando solo funciona con Planning.

Sintaxis: epmautomate sortMember Member [type=children|descendants][order=ascending|descending], donde:

• Member es el nombre del miembro padre cuyos descendientes o hijos se van aordenar.

• type, especifica, de manera opcional, los miembros que se van a ordenar. Estosson los valores aceptables:

– descendants ordena todos los submiembros (hijos y descendientes) delmiembro padre que especifique como el valor de Member.

– children, el valor predeterminado, ordena solo los miembros en el nivelinmediatamente inferior al miembro padre que especifique como el valor deMember.

• order, identifica, de forma opcional, un orden de clasificación. Estos son losvalores aceptables:

– ascending es el orden de clasificación predeterminado.

– descending

Ejemplos:

• epmautomate sortMember Entity ordena los hijos de la dimensión Entidaden orden ascendente.

• epmautomate sortMember Entity type=descendantsorder=descending ordena todos los submiembros de la dimensión Entidad enorden descendente.

unassignRole

Elimina un rol asignado actualmente a los usuarios cuyos ID de inicio de sesión seincluyen en el archivo CSV con codificación ANSI o UTF-8 que se utiliza con estecomando.



Nota:

No puede utilizar este comando para eliminar asignaciones de roles deaplicación de aplicaciones de Account Reconciliation y Profitability and CostManagement, las cuales no admiten la asignación de roles de aplicación ausuarios.

Antes de ejecutar este comando, cargue el archivo en el entorno utilizando el comando uploadFile. El formato del archivo es el siguiente:


Nota:

• Necesita tanto roles de administrador de servicio como de administradorde dominio de identidad para revocar la asignación de roles predefinidos.

• Un administrador de servicio puede ejecutar este comando para revocarasignaciones de roles de aplicación.

El archivo CSV no debe incluir la cuenta del usuario que ejecuta estecomando.

• Utilice las comillas dobles para incluir los nombres de rol que contienencaracteres de espacio.

Uso: epmautomate assignRole NOMBRE_ARCHIVO ROL, donde:

• NOMBRE_ARCHIVO es el nombre del archivo CSV que contiene los ID de inicio desesión de los usuarios cuya asignación de roles se va a revocar.

• ROL identifica una de las siguientes acciones:

– Si elimina la asignación de usuarios a roles predefinidos, ROL debe identificarun rol predefinido aplicable al servicio. Consulte Descripción de los rolespredefinidos en Introducción a Oracle Enterprise Performance Management Cloudpara administradores.

Valores aceptables para Planning, los módulos de Planning, FinancialConsolidation and Close y Tax Reporting:


* Usuario avanzado

* Usuario (no utilice Planner, que se ha utilizado en anteriores versionesdel servicio)

* Visor

Valores aceptables para Oracle Enterprise Data Management Cloud:


* Usuario



– Si elimina la asignación de usuarios a un rol de aplicación, ROL debeidentificar un rol de aplicación incluido en el separador Roles de Control deacceso.

Valores aceptables para las aplicaciones de Planning, los módulos dePlanning, Financial Consolidation and Close y Tax Reporting.

* Administrador de aprobaciones

* Persona que asigna la propiedad de aprobaciones

* Diseñador de procesos de aprobaciones

* Supervisor de aprobaciones

* Creador de cuadrícula ad hoc

* Usuario ad hoc

* Usuario ad hoc de solo lectura

* Administrador de Calculation Manager

* Crear integración

* Obtener detalles

* Ejecutar integración

* Asignación masiva

* Administrador de acceso a lista de tareas

Valores aceptables para las aplicaciones de Oracle Enterprise DataManagement Cloud:

* Creador de aplicaciones

* Creador de vistas

Para obtener una descripción de estos roles, consulte Gestión de asignacionesde roles en el nivel de aplicación en Administración del control de acceso paraOracle Enterprise Performance Management Cloud.

Ejemplos:

• Anule la asignación de usuarios de un rol de dominio de identidad predefinido:epmautomate unassignRole remove_roles.CSV "Administrador delservicio"

• Anule la asignación de usuarios de un rol de aplicación: epmautomateunassignRole example_file.CSV "Administrador de acceso alista de tareas"

upgrade

Descarga automáticamente la versión más reciente de EPM Automate y la instala deforma silenciosa.

Después de ejecutarse el comando login para iniciar una sesión, EPM Automateidentifica la versión instalada actualmente. Si la versión instalada no es la másreciente, EPM Automate le informa de que hay una nueva versión disponible.



Sintaxis: epmautomate upgrade

uploadFile

Carga un archivo del equipo local en el servicio. Utilice este comando para cargararchivos que contengan datos, metadatos, definiciones de reglas, definiciones dedimensiones, transacciones asignadas, plantillas e instantáneas de copia de seguridad.

Sintaxis: epmautomate uploadFile "FILE_NAME"[DATA_MANAGEMENT_FOLDER | profitinbox]

Ejemplos:

• Cargar en la ubicación predeterminada: epmautomate uploadFile "C:/pbcsdata/quarterlydata.csv"

• Cargar en una carpeta de Data Management: epmautomate uploadFile "C:/fdmee_data/data.zip" inbox/repository

• Carga en profitinbox (Profitability and Cost Management): epmautomateuploadFile "C:/profitability_data/data.zip" profitinbox

userAuditReport

Genera un informe de auditoría de usuario (archivo .CSV) y lo almacena en laubicación de descarga predeterminada desde donde lo puede descargar en su equipo.Este informe contiene información sobre los usuarios que iniciaron sesión en unentorno a lo largo del periodo especificado. Muestra la dirección IP del equipo desdeel que inició sesión el usuario y la fecha y hora en las que el usuario accedió al entorno.

Sintaxis: epmautomate userAuditReport FROM_DATE TO_DATEREPORT_NAME, donde:

• FECHA_INICIAL indica la fecha de inicio (con formato AAAA-MM-DD) del periodocuyo informe de auditoría se debe generar

• FECHA_FINAL indica la fecha de finalización (con formato AAAA-MM-DD) delperiodo cuyo informe de auditoría se debe generar

• NOMBRE_INFORME es el nombre del archivo de informe

Ejemplo: epmautomate userAuditReport 2016-10-15 2016-12-15myAuditReport.CSV

userGroupReport

Genera un informe (archivo CSV) que muestra los grupos a los que están asignados losusuarios en Control de acceso y lo almacena en la ubicación de descargapredeterminada, desde donde puede cargarlo a su equipo. El informe indica si laasignación de usuario a un grupo es directa (como miembro de un grupo) o indirecta(como miembro de un grupo que es hijo de un grupo anidado).

El informe identifica el nombre de inicio de sesión, el nombre, el apellido, la direcciónde correo electrónico, el grupo asignado y el tipo de asignación del usuario con elsiguiente formato. Es idéntico a la versión CSV del informe creado desde el separadorInforme de grupo de usuarios en Control de acceso. Por ejemplo, suponga que elusuario jdoe es miembro del grupo Test1, el cual es hijo del grupo anidado Test2.En este escenario, el informe mostrará la siguiente información para jdoe:



User, First Name, Last Name, Email, Direct, Groupjdoe, John, Doe, [email protected], Yes, test1jdoe, John, Doe, [email protected], No, test2

Sintaxis: epmautomate userGroupReport REPORT_NAME, donde REPORT_NAMEes el nombre del archivo de informe.

Ejemplo: epmautomate userGroupReport UsrGrpReport.CSV

Códigos de salidaEPM Automate devuelve un código de salida y un mensaje para indicar el estado de laoperación. Los códigos de salida se agrupan en cinco números de código; cada códigopuede indicar muchas condiciones de error. Revise el mensaje adjunto para identificarla condición específica que causó el error.

Además, EPM Automate crea un archivo de registro(NOMBRE_COMANDO_MARCA_TIEMPO.log, por ejemplo,uploadfile_16_11_2016_11_27_10.log) para cada ejecución de comandofallida. Los archivos de registro se crean en la computadora desde la que se ejecutaEPM Automate.

Errores de código de salida 1

Error del comando al ejecutarse EPM Automate usa este código de salidapara mostrar los mensajes relacionados con el código de estado HTTP 200 y 400. Estoscódigos son devueltos por las API de REST que usa EPM Automate.

Privilegios insuficientes para realizar la operación Este error semuestra si el usuario cuyas credenciales se utilizan para conectarse al servicio no tieneprivilegios suficientes para realizar la operación que ha intentado.

Conéctese con una cuenta que tenga privilegios suficientes para realizar la operación.Normalmente, solo los administradores del servicio pueden realizar operaciones en elservicio.

El recurso no existe Este error se muestra si el archivo o instantánea que deseasuprimir o descargar no existe en el servicio.

Utilice el comando listfiles para verificar el nombre del archivo y su ubicación.

Instantánea no válida INSTANTÁNEA Este error se muestra cuando el serviciono puede validar la instantánea que ha especificado para la operación de exportación oimportación.

Verifique que está utilizando una instantánea válida.

Error interno del servidor. No es posible suprimir el archivo:NOMBRE_ARCHIVO Utilice "Proporcionar comentarios" con losdetalles Este error se muestra si el archivo o instantánea no se ha podido suprimirdel servicio debido a un error del servidor.

Informe de este problema a Oracle con el comando Comentarios o con la funciónProporcionar comentarios.

Archivo no válido: NOMBRE_ARCHIVO Este error se muestra si el archivo o lainstantánea que desea suprimir o descargar no existe en el servicio o si el nombre dearchivo no está en el formato requerido.

Utilice el comando listfiles para verificar el nombre del archivo y su ubicación.

Códigos de salida


La operación recreate lleva mucho tiempo ejecutándose. Póngaseen contacto con los servicios de soporte Este error se muestra si laoperación de nueva creación que ha iniciado no se termina en una hora.


El servicio de restablecimiento lleva mucho tiempo ejecutándose.Póngase en contacto con los servicios de soporte Este error se muestrasi la operación de restablecimiento del servicio que ha iniciado no se termina en unahora.


No se puede realizar la operación. Hay otra instancia en curso.Vuelva a intentarlo más tarde Este error se muestra si se intenta ejecutar elcomando copysnapshotfrominstance cuando otra instancia del comando estáactiva.

Espere a que el comando copysnapshotfrominstance finalice antes de intentarejecutar el comando de nuevo.

No se puede realizar la operación. Hay otro script demantenimiento en curso. Vuelva a intentarlo más tarde Este error semuestra si intenta ejecutar el comando copysnapshotfrominstance, recreate oresetservice cuando el proceso de restablecimiento del servicio o demantenimiento diario está en ejecución.

Vuelva a ejecutar la operación cuando termine el proceso de mantenimiento orestablecimiento.

Error al conectar con la instancia de origen: URL_ORIGEN Este errorse muestra si EPM Automate no puede conectarse al entorno de origen para iniciar elcomando copysnapshotfrominstance.

Verifique que las credenciales, el dominio de identidad y la URL que se utilizan paraacceder al entorno de origen son válidos.

Error interno del servidor. Error al copiar la instantánea de lainstancia de origen. Utilice "Proporcionar comentarios" con losdetalles Este error se muestra cuando EPM Automate detecta un problemainesperado al ejecutar el proceso copysnapshotfrominstance.


Error interno del servidor. Utilice "Proporcionar comentarios"con los detalles Este error se muestra para indicar muchas condiciones delservidor interno que requieren acciones correctivas por parte de Oracle.


La instantánea NOMBRE_INSTANTÁNEA ya existe. Suprima lainstantánea y vuelva a ejecutar el comando Este error se muestra cuandodescarga o carga una instantánea en una ubicación en la que hay otra instantánea conun nombre idéntico.

Suprima o elimine la instantánea existente y, a continuación, vuelva a ejecutar elcomando.

Códigos de salida


Error al extraer la instantánea. Vuelva a intentarlo con unainstantánea correcta Este error se muestra si EPM Automate no puede extraer elcontenido de la instantánea al ejecutar el comando importsnapshot.

Verifique que la instantánea es válida.

Error interno del servidor. No es posible abrir el archivo paraescribir en él. Utilice "Proporcionar comentarios" con losdetalles Este error se muestra si los errores provocan la creación o actualización dearchivos CSV, por ejemplo, al generar el informe de auditoría.


No se han encontrado registros coincidentes. Seleccione otrorango de fechas. Este error se muestra si ejecuta el comando userauditreportpara generar el informe de auditoría para un rango de fechas durante el que los datosde auditoría no estarán disponibles.

Especifique un rango de fechas válido y, a continuación, vuelva a ejecutar el comandouserauditreport. Tenga en cuenta que el servicio solo mantiene el historial deauditoría de los últimos 120 días.

Ya existe un archivo con el mismo nombre: NOMBRE_ARCHIVO.Seleccione otro nombre de archivo Este error se muestra si un informe con elnombre de informe de auditoría que ha especificado ya existe en el servicio.

Suprima el archivo existente del servicio o especifique un nombre de archivo diferentey, a continuación, vuelva a ejecutar el comando userauditreport.

Error de la operación con estado $1. Utilice "Proporcionarcomentarios" Este mensaje indica un error interno del servidor que provoca unfallo en el proceso de restablecimiento o nueva creación del servicio.


EPMCSS-20643: No se pudieron agregar usuarios. No se encuentrael archivo NOMBRE_ARCHIVO.csv. Proporcione un nombre de archivoválido. Este error se muestra si el archivo CSV especificado que contieneinformación sobre los usuarios que desea agregar no está disponible en la bandeja deentrada.

Utilice el comando listfiles para verificar el nombre del archivo y su ubicación. Siel archivo no está en la bandeja de entrada, utilice el comando uploadFile para cargarel archivo.

EPMCSS-20644: No se pudo eliminar a los usuarios. No seencuentra el archivo NOMBRE_ARCHIVO.csv. Proporcione un nombrede archivo válido. Este error se muestra si el archivo CSV especificado quecontiene información sobre los usuarios que desea suprimir no está disponible en labandeja de entrada.


20645: Error al asignar el rol a los usuarios. Nombre de rolrolno válido. Proporcione un nombre de rol válido. Este error semuestra si no se soporta el rol especificado en el archivo CSV.

Códigos de salida


Verifique que el nombre del rol especificado en el archivo es Administrador delservicio, Usuario avanzado, Usuario o Visor.



Servicio no disponible El servicio no está disponible debido al error de HTTP404.

Verifique la disponibilidad del servicio accediendo al mismo desde un explorador enla computadora desde el que está ejecutando EPM Automate. Si el servicio está caídopor cualquier motivo, espere unos minutos y vuelva a intentarlo o póngase encontacto con los servicios de soporte de Oracle.

Timeout de lectura/escritura Este error se muestra si el socket de clientesufre un timeout (que dura unos 15 minutos) durante cualquier operación de lectura/escritura debido a que la red es lenta o a problemas con el cortafuegos.

Vuelva a ejecutar el comando fallido cuando el rendimiento global de la red sea alto. Siel fallo se debe a la configuración del cortafuegos, póngase en contacto con eladministrador de red.

Errores de código de salida 7EPM Automate muestra este error si no ha podido ejecutar un comando. El mensaje deerror, por ejemplo, Comando no válido, especifica por qué se ha producido el error.

EPM Automate no soporta proxies que requieran autenticación. Laconfiguración del proxy del equipo se realiza para autenticar con un servidor proxyantes de que su explorador pueda acceder a Internet.

Especifique un nombre de usuario, dominio y contraseña de servidor de proxy (outilice un archivo de contraseñas cifradas que contenga la contraseña del servidorproxy) en el comando de inicio de sesión para autentificarse en el servidor proxy.

No es posible abrir el archivo de contraseñas NOMBRE_ARCHIVOArchivo de contraseñas cifrado no válido, por ejemplo,ARCHIVO_CONTRASEÑAS.EPW. EPM Automate no ha encontrado el archivo en laubicación especificada o el archivo no está en el formato necesario.

Verifique el nombre del archivo y la ruta. Si el archivo no se puede analizar porque elformato no es válido, utilice el comando encrypt para volver a crear el archivo.

No es posible analizar el archivo de contraseñas NOMBRE_ARCHIVOEPM Automate no ha podido analizar el archivo de contraseñas cifrado porque elformato no es válido o porque se ha dañado.

Utilice el comando encrypt para volver a crear el archivo.

No es posible conectar a la URL. Causa raíz MENSAJE Este error semuestra si no se puede establecer una conexión debido a una URL incorrecta. Elmensaje que se muestra como causa raíz detalla el fallo subyacente que se produce porel uso de una URL incorrecta.

• Verifique que está utilizando una URL válida

• Si la configuración de proxy requiere la autentificación con el servidor proxy paraconectarse a Internet, especifique un nombre de usuario, dominio y contraseña deservidor de proxy (o utilice un archivo de contraseñas cifradas que contenga la

Códigos de salida


contraseña del servidor proxy) para iniciar sesión. Póngase en contacto con eladministrador de red si necesita ayuda.

No es posible conectar a la URL Protocolo no soportado El comandode conexión ha fallado porque la URL especificada utiliza un protocolo no soportado.El mensaje de error adjunto identifica el protocolo no soportado.

Asegúrese de que la URL que está utilizando con el comando de conexión utiliza elprotocolo seguro (HTTPS).

La sesión no está autentificada. Ejecute el comando "login"antes de ejecutar cualquier otro comando Ha intentado ejecutar uncomando antes de establecer una sesión mediante el comando login.

Ejecute el comando login para establecer una conexión segura a un entorno antes deintentar ejecutar otros comandos.

Parámetro no válido Este mensaje indica un error de sintaxis en un comandocausado por una secuencia incorrecta de parámetros de comando o la ausencia dealgunos valores de parámetros de comando necesarios.

Revise y corrija los parámetros de comando y la secuencia en que se han especificado.

El comando COMMAND_NAME no está soportado por SERVICE_TYPE EPMAutomate no ha podido ejecutar el comando con el servicio al que está conectadoporque el servicio no admite el comando.

Consulte Referencia de comandos para visualizar listas de comandos soportadas porcada tipo de servicio.

El archivo no existe en la ubicación: RUTA EPM Automate no haencontrado el archivo que desea procesar, por ejemplo, mediante el comando upload oreplay.

Asegúrese de que el nombre de archivo y la ruta son correctos.

No es posible abrir el archivo para leerlo: RUTA EPM Automate noha podido leer el archivo especificado.

Asegúrese de que el archivo está en el formato necesario. Verifique que el usuario queestá ejecutando EPM Automate tiene acceso de lectura al archivo.

No es posible abrir el archivo para escribir en él: RUTA EPMAutomate no ha podido escribir en el archivo especificado.

Asegúrese de que el archivo no está bloqueado por otro proceso. Verifique que elusuario que está ejecutando EPM Automate tiene acceso de escritura al archivo.

Comando no válido EPM Automate ha encontrado un comando no soportado.

Verifique que EPM Automate admite el comando; además, asegúrese de que elnombre del comando está escrito correctamente.

Formato de fecha no válido La herramienta ha encontrado un formato de fechano válido.

Especifique las fechas de generación de informes en un formato de fecha soportado.

FROMDATE FECHA no puede ser posterior a TODATE FECHA EPM Automateha encontrado una fecha de finalización que es anterior a la fecha de inicio.

Asegúrese de que el valor de to date en un rango de fechas especificado es unafecha posterior al valor de from date.

Códigos de salida


Se ha excedido el número máximo de comentarios (6) para un díaEste error se muestra al superar el número de comentarios que puede enviar medianteel comando feedback.

Ya existe un archivo con el mismo nombre en la ruta de descargaRUTA. Suprima el archivo y vuelva a ejecutar el comando Este errorse muestra cuando intenta descargar un archivo en una ubicación que ya tiene unarchivo que coincide con el nombre del archivo que se va a descargar.

Suprima, cambie el nombre o mueva el archivo existente y, a continuación, vuelva aejecutar el comando.

El archivo está vacío: RUTA Este error se muestra si el archivo dereproducción no tiene ningún contenido.

Asegúrese de que el archivo de reproducción (archivo CSV) muestra las credenciales(nombre de usuario y contraseña) y el nombre de los archivos HAR que se van a usarpara ejecutar el comando replay.

No es posible cifrar la contraseña, ya que no se puede resolverlocalhost. Asegúrese de que los nombres de host se han asignadosa las direcciones IP correctamente. Este error se muestra si EPM Automateno ha podido resolver la definición de host local en una dirección MAC porque elarchivo de hosts en su computadora contiene un nombre de servidor en lugar delocalhost para la dirección 127.0.0.1.

Asegúrese de que el archivo de hosts especifica localhost como nombre delservidor para 127.0.0.1

El nombre de la instantánea no es válido. Este error se muestra si noespecifica el nombre de la instantánea cuyo nombre se va a cambiar.

Especifique el nombre de una instantánea disponible en el entorno.

El nuevo nombre de la instantánea no es válido. Este error se muestrasi no especifica un nombre nuevo para la instantánea.

Especifique el nuevo nombre de la instantánea.

Nombre de instantánea no válido: {0}. No se permiten loscaracteres \\/*?"<>|. Este error se muestra si el nombre de la instantáneacontiene caracteres especiales como espacio, \ (barra invertida), / (barra), *(asterisco), ? (signo de cierre de interrogación), " (comillas), < (menor que), y > (mayorque).

Especifique un nombre de instantánea nuevo que no contenga estos caracteresespeciales.

No se ha podido cambiar el nombre de la instantánea: {0}. Puedeque haya otro proceso accediendo a ella. Vuelva a intentarlo mástarde. Este error se muestra en caso de que EPM Automate no pueda obtener unbloqueo exclusivo de la instantánea debido a que otro proceso la está utilizando.

Espere a que finalice la operación actual que está utilizando la instantánea y, acontinuación, vuelva a intentarlo.

La instantánea {0} ya existe. Suprima la instantánea y vuelva aejecutar el comando. Este error se muestra cuando el nuevo nombre de lainstantánea es idéntico al de una instantánea existente en el entorno.

Utilice un nombre de instantánea diferente o suprima la instantánea existentemediante el uso del comando deletefile.

Códigos de salida



Credenciales no válidas Este error se muestra cuando el nombre de usuario o lacontraseña utilizados con el comando login son incorrectos.

Especifique las credenciales válidas para el entorno al que intenta conectar.

Error de autentificación al ejecutar el comando. Vuelva aintentarlo Este error se muestra cuando falla la autentificación básica durante laejecución de un comando que no sea login. Este error se puede producir también parallamadas HTTP cuando la ejecución de un comando se vuelve a intentar (hasta tresveces).


Error interno del servidor MENSAJE Este error se muestra si EPM Automateencuentra excepciones desconocidas que no están relacionadas con las conexionesHTTP. Incluye los errores del servidor 503 y 500.

No es posible conectar a URL: MENSAJE Este error se muestra cuando elservidor no está disponible. El mensaje de error indica la excepción que ha provocadoque falle el comando.

Si el servidor no está disponible, póngase en contacto con los Servicios de SoporteOracle. Si el mensaje indica problemas con la URL, verifique que la URL que estáutilizando es válida.

Ejecución de EPM AutomateUtilice sus credenciales de Oracle Enterprise Performance Management Cloud parainiciar sesión mediante EPM Automate. No se puede iniciar sesión con las credencialesde inicio de sesión único.

Los usuarios de EPM Cloud pueden utilizar las credenciales de dominio de identidadpara conectarse a un entorno mediante el uso de EPM Automate. Sin embargo, solo losadministradores de servicio pueden realizar tareas mediante EPM Automate. Además,se requiere el rol de administrador de dominio de identidad para ejecutar comandosque modifiquen objetos en el dominio de identidad.

Generación del archivo log de depuración

Oracle Support le solicitará un archivo de registro de depuración de la sesión parasolucionar problemas que se han producido al ejecutar EPM Automate. EPMAutomate soporta la opción -d para generar mensajes de depuración, que se podránredireccionar a un archivo mediante la directiva >. Puede crear un archivo dedepuración para un comando o un archivo de ejecución por lotes o script que contengavarios comandos.

Sintaxis: comando epmautomate [parámetros_comando] -d > archivo_log2>&1

Ejemplo de Windows: epmautomate downloadfile "Artifact Snapshot" -d > C:\logs\download_log.txt 2>&1

Ejemplo de Linux: epmautomate.sh downloadfile "Artifact Snapshot" -d > ./logs/download_log 2>&1

Windows

Antes de ejecutar EPM Automate, asegúrese de que puede acceder al entorno desde lacomputadora desde la que está ejecutando EPM Automate.

Ejecución de EPM Automate


Para ejecutar EPM Automate en un cliente de Windows:

1. Haga clic en Inicio y, a continuación, en Todos los programas, seleccione EPMAutomate y, por último, Iniciar EPM Automate. Aparecerá el símbolo del sistemade EPM Automate.

2. Opcional: vaya al directorio desde el que desea realizar operaciones con EPMAutomate.

3. Opcional: Genere un archivo de cifrado de contraseñas. El archivo de cifrado decontraseñas sirve para utilizar una contraseña cifrada al iniciar sesión.

epmautomate encrypt P@ssword1 myKey C:/mySecuredir/password.epw

4. Inicie una sesión como administrador de servicio. Utilice un comando como elsiguiente:

• Con una contraseña cifrada:

epmautomate login serviceAdmin P@ssword1 https://test-cloudpln.pbcs_us1.oraclecloud.com myIdentityDomain

• Con una contraseña no cifrada:

epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloudpln.pbcs_us1.oraclecloud.com myIdentityDomain

5. Introduzca los comandos para ejecutar las tareas que desea realizar. Consulte unode los siguientes temas para ver una descripción de los comandos, su sintaxis yejemplos.






Consulte Códigos de salida para obtener información sobre el estado de ejecuciónde los comandos.

6. Cierre la sesión en el entorno. Utilice el siguiente comando.

epmautomate logout

Linux

Nota:

Asegúrese de que JAVA_HOME está definido en la variable PATH delarchivo .profile o como una variable de entrono de shell. Se requiere JREversión 1.7 o superior.

Para ejecutar EPM Automate en un cliente de Linux:



1. Abra una ventana de terminal y vaya al directorio en el que ha instalado EPMAutomate.

2. Opcional: Genere un archivo de cifrado de contraseñas. El archivo de cifrado decontraseñas sirve para utilizar una contraseña cifrada en lugar de una no cifrada aliniciar sesión.

epmautomate encrypt P@ssword1 myKey ../misc/encrypt/password.epw

3. Inicie una sesión como administrador de servicio. Utilice un comando como elsiguiente:

• Con una contraseña cifrada:

./bin/epmautomate.sh login serviceAdmin P@ssword1 https://test-cloudpln.pbcs_us1.oraclecloud.com myIdentityDomain

• Con una contraseña no cifrada:

./bin/epmautomate.sh login serviceAdmin ../misc/encrypt/password.epw https://test-cloudpln.pbcs_us1.oraclecloud.com myIdentityDomain

4. Introduzca los comandos para ejecutar las tareas que desea realizar. Consulte unode los siguientes temas para ver una descripción de los comandos, su sintaxis yejemplos.






Consulte Códigos de salida para obtener información sobre el estado de ejecuciónde los comandos.

5. Cierre la sesión en el entorno. Utilice el siguiente comando.

./bin/epmautomate.sh logout

Ejecución de varias instancias de EPM AutomatePuede ejecutar varias instancias de EPM Automate con respecto a un entorno delmismo directorio. De manera similar, puede ejecutar varias instancias de EPMAutomate con respecto a diferentes entornos desde mismo directorio o directoriosdiferentes.

Por ejemplo, puede que tenga que refrescar de manera simultánea el cubo de laaplicación de Planning en https://cloudpln.pbcs.us1.oraclecloud.com yhttps://testcloudpln.pbcs.us1.oraclecloud.com. En este escenario, tienedos opciones:

• Ejecutar dos instancias de EPM Automate desde el mismo directorio pararefrescar los cubos de la aplicación en entornos diferentes.

• Ejecutar EPM Automate desde directorios separados para conectar los entornos y,a continuación, refrescar los cubos de la aplicación.



En ambos escenarios, cada instancia de EPM Automate funciona de formaindependiente; cerrar sesión en una instancia no significa que se cierre sesión en lasotras. Las actividades iniciadas con EPM Automate siguen ejecutándose hasta sufinalización en el entorno, incluso si cierra la sesión desde otra instancia.

Esta sección contiene scripts de ejemplo de Windows y Unix/Linux (caller ymultisession) que se pueden usar para crear dos sesiones de EPM Automate pararealizar tareas. Para ejecutar varias sesiones simultáneas, debe agregar la siguienteinformación de conexión en el script caller, el cual llama al script multisessionpara ejecutar los comandos login, uploadfile, listfiles y logout. Puedemodificar el script multisession para realizar tareas distintas de estas. Asegúresede que ambos scripts se almacenan en el mismo directorio.

• Solo para caller.BAT: EPM_SID: identificador de sesión numérico único. Estese debe definir en el script caller en un valor único para cada sesión. En losscripts de ejemplo, se define en valores únicos de la siguiente manera:

– En caller.BAT, EPM_SID se define en !RANDOM!, que lo asigna a unnúmero único generado por el sistema. Este número también se utiliza paragenerar archivos de registro para cada sesión. Si desea realizar el seguimientodel archivo de registro para cada sesión, puede especificar un número únicoen lugar de !RANDOM!.

– En caller.sh, EPM_SID se define en el identificador de proceso, que esúnico. Si desea realizar un seguimiento del archivo de registro para cadasesión, puede especificar un EPM_SID único modificando la sentenciaexport EPM_SID=$$ en el script multisession para que se utilice el valortransferido y, a continuación, se transfiera un valor único para este parámetroen el script caller para cada sesión; por ejemplo, especificando el valor deEPM SID en caller.sh de la siguiente manera:

$SCRIPT_DIR/multisession.sh EPM_SID "USERNAME" "PASSWORD" "URL" "IDENTITYDOMAIN" "/home/user/Snapshot1.zip" &$SCRIPT_DIR/multisession.sh EPM_SID "USERNAME" "PASSWORD" "URL" "IDENTITYDOMAIN" "/home/user/Snapshot2.zip" &

• USERNAME: ID de conexión de un administrador de servicio

• PASSWORD: contraseña del administrador de servicio

• URL: URL de conexión del entorno

• IDENTITYDOMAIN: dominio de identidad del entorno

Scripts de Windows de ejemplo

caller.BAT

@echo offsetlocal EnableExtensions EnableDelayedExpansion

REM syntax: start /B multisession.bat EPM_SID "USERNAME" "PASSWORD" "URL" "IDENTITYDOMAIN" "SNAPSHOTPATH"start /B multisession.bat !RANDOM! "USERNAME" "PASSWORD" "URL" "IDENTITYDOMAIN" "C:\Snapshot1.zip"start /B multisession.bat !RANDOM! "USERNAME" "PASSWORD" "URL" "IDENTITYDOMAIN" "C:\Snapshot2.zip"

endlocal



multisession.BAT

@echo off

set EPM_SID=%1set USERNAME=%2set PASSWORD=%3set URL=%4set IDENTITYDOMAIN=%5set SNAPSHOTNAME=%6

echo User: %USERNAME% > %EPM_SID%.logecho Cloud Instance: %URL% >> %EPM_SID%.log

call epmautomate login %USERNAME% %PASSWORD% %URL% %IDENTITYDOMAIN% >> %EPM_SID%.logcall epmautomate uploadfile %SNAPSHOTNAME% >> %EPM_SID%.logcall epmautomate listfiles >> %EPM_SID%.logcall epmautomate logout

Script de shell Bourne de ejemplocaller.sh

#!/bin/sh

set +xSCRIPT_DIR=`dirname "${0}"`

# syntax: /home/user/multisession.sh "USERNAME" "PASSWORD" "URL" "IDENTITYDOMAIN" "SNAPSHOTPATH" &$SCRIPT_DIR/multisession.sh "USERNAME" "PASSWORD" "URL" "IDENTITYDOMAIN" "/home/user/Snapshot1.zip" &$SCRIPT_DIR/multisession.sh "USERNAME" "PASSWORD" "URL" "IDENTITYDOMAIN" "/home/user/Snapshot2.zip" &

multisession.sh

#!/bin/sh

set +x

EPM_AUTOMATE_HOME=/home/user/epmautomate

export JAVA_HOME=/home/user/jreexport EPM_SID=$$

USERNAME=$1PASSWORD=$2URL=$3IDENTITYDOMAIN=$4SNAPSHOTNAME=$5

echo User: $USERNAME > $EPM_SID.logecho Cloud Instance: $URL >> $EPM_SID.log

$EPM_AUTOMATE_HOME/bin/epmautomate.sh login $USERNAME $PASSWORD $URL $IDENTITYDOMAIN >> $EPM_SID.log$EPM_AUTOMATE_HOME/bin/epmautomate.sh uploadfile $SNAPSHOTNAME >> $EPM_SID.log$EPM_AUTOMATE_HOME/bin/epmautomate.sh listfiles >> $EPM_SID.log$EPM_AUTOMATE_HOME/bin/epmautomate.sh logout



3Escenarios de ejemplo de ejecución de

comandos

EPM Automate se puede utilizar para automatizar muchas tareas administrativascomunes de Oracle Enterprise Performance Management Cloud.

• Escenarios de ejemplo para todos los servicios

• Escenarios de ejemplo para aplicaciones de planificación y presupuestación,consolidación e informes de impuestos

• Escenarios de ejemplo para Account Reconciliation

• Escenarios de ejemplo para Profitability and Cost Management

• Escenarios de ejemplo para Oracle Enterprise Data Management Cloud

Escenarios de ejemplo para todos los serviciosEstos escenarios representan una secuencia típica de comandos que se puede utilizarpara realizar operaciones específicas en servicios de Oracle Enterprise PerformanceManagement Cloud que no sean de Narrative Reporting.

• Copia de seguridad de instantáneas de aplicación en un equipo

• Creación de varios usuarios con contraseñas únicas

• Creación de usuarios y asignación a roles predefinidos

• Recuento del número de usuarios asignados a roles

• Creación de informes de auditoría de usuarios asignados a roles

• Creación de informe de auditoría de asignación y revocación de roles

• Enmascaramiento de registros de acceso e informe de actividades para cumplir lasnormas de privacidad

• Automatización de descargas de informes de actividad en un equipo local

• Descarga de logs de acceso desde un entorno

• Automatización de la clonación de entornos

• Clonación de un entorno

• Eliminación de archivos innecesarios desde un entorno

• Búsqueda y descarga de archivos de un entorno

• Recreación de un entorno antiguo de EPM Cloud para auditorías

Escenarios de ejemplo de ejecución de comandos 3-1

• Automatización de auditoría y conformidad sobre el acceso a la base de datos

En algunos de estos escenarios, se utiliza una secuencia de comandos y las siguientescredenciales ficticias para realizar diversas actividades con EPM Automate.

• Nombre de usuario: serviceAdmin

• Archivo de contraseñas: C:/mySecuredir/password.epw

Este archivo se crea manualmente. Consulte el comando encrypt.

• URL de servicio: https://example.oraclecloud.com

• Dominio de identidad: ExampleDomain

Copia de seguridad de instantáneas de aplicación en un equipoEn este caso se explica cómo automatizar el proceso de creación de una copia deseguridad de la instantánea creada durante el mantenimiento del servicio diario en unequipo local.

Los siguientes scripts de ejemplo gestionan estas actividades.

• Descarga la instantánea de la aplicación (Artifact Snapshot) que se creó en elperiodo de mantenimiento

• Cambia el nombre de la instantánea descargada agregando el registro de hora

• Mantiene 10 copias de seguridad suprimiendo, si es necesario, las copias deseguridad más antiguas

Nota:

Si vuelve a planificar este script para utilizarlo, modifique los valores de losparámetros SET url, SET user y SET NumberOfBackups como seanecesario.

Consulte Automatización de la ejecución de scripts para obtener información sobre laprogramación del script con Programador de tareas de Windows.

Script de Windows de ejemplo

Cree un archivo por lotes (.bat) o de shell (.sh) que contenga un script similar alsiguiente para automatizar las descargas de instantáneas.

@echo offrem Sample script to download and maintain 10 maintenance backupsrem Update the following parameters

SET url=https://example.oraclecloud.comSET user=serviceAdminSET password=example.epwSET domain=ExampleDomainSET SnapshotName="Artifact Snapshot"SET NumberOfBackups=10

rem EPM Automate commandscall epmautomate login %user% %password% %url% %domain% IF %ERRORLEVEL% NEQ 0 goto :ERROR

Escenarios de ejemplo para todos los servicios


call epmautomate downloadfile %SnapshotName% IF %ERRORLEVEL% NEQ 0 goto :ERROR

call epmautomate logout IF %ERRORLEVEL% NEQ 0 goto :ERROR

rem Rename downloaded Artifact Snapshot, keep the last 10 backupsSet Timestamp=%date:~4,2%_%date:~7,2%_%date:~10,2%%ren %SnapshotName%.zip %SnapshotName%_%Timestamp%.zip

SET Count=0FOR %%A IN (%SnapshotName%*.*) DO SET /A Count += 1IF %Count% gtr %NumberOfBackups% FOR %%A IN (%SnapshotName%*.*) DO del "%%A" && GOTO EOF:EOF

echo Scheduled Task Completed successfullyexit /b %errorlevel%:ERRORecho Failed with error #%errorlevel%.exit /b %errorlevel%

Script de Linux/UNIX de ejemplo

Cree un archivo de shell (.sh) que contenga un script similar al siguiente paraautomatizar las descargas de instantáneas.

#!/bin/sh# Sample script to download and maintain 10 maintenance backups# Update the following eight parameters

url=https://example.oraclecloud.comuser=serviceAdminpassword=/home/user1/epmautomate/bin/example.epwdomain=ExampleDomainsnapshotname="Artifact Snapshot"numberofbackups=10epmautomatescript=/home/user1/epmautomate/bin/epmautomate.shjavahome=/home/user1/jdk1.8.0_191/

export JAVA_HOME=${javahome}

printResult(){ op="$1" opoutput="$2" returncode="$3"

if [ "${returncode}" -ne 0 ] then echo "Command failed. Error code: ${returncode}. ${opoutput}" else echo "${opoutput}" fi}

processCommand(){ op="$1"



date=`date`

echo "Running ${epmautomatescript} ${op}" operationoutput=`eval "$epmautomatescript $op"` printResult "$op" "$operationoutput" "$?"}

op="login ${user} ${password} ${url} ${domain}"processCommand "${op}"

op="downloadfile "${snapshotname}\"processCommand "${op}"

op="logout"processCommand "${op}"

# Renames the downloaded artifacts, keeps the last 10 backupstimestamp=`date +%m_%d_%Y_%I%M`mv"${snapshotname}.zip ${snapshotname}_${timestamp}.zip

((numberofbackups+=1))ls -tp ${snapshotname}*.zip | grep -v '/$' | tail -n +${numberofbackups} | xargs -d '\n' -r rm --

Creación de varios usuarios con contraseñas únicasUtilice los scripts de PowerShell y Bash Shell de esta sección para usar el comandoaddUsers de EPM Automate a fin de crear varios usuarios de Oracle EnterprisePerformance Management Cloud, cada uno con su propia contraseña.

Si utiliza la versión en PDF de este documento: para evitar saltos de líneas einformación de pie de página que inutilizarán estos scripts, cópielos de la VersiónHTML de este tema.

Utilice los scripts de esta sección para completar las siguientes tareas:

• Cargue un archivo CSV que contenga información de usuario en el entorno.

• Cree usuarios en el dominio de identidad y asigne una contraseña única a cadausuario.

• Suprima el archivo CSV cargado desde el entorno.

Nota:

Necesita tanto roles de administrador de servicio como de administrador dedominio de identidad para ejecutar este script.

Para crear varios usuarios, cada uno con una contraseña única:

1. Cree un archivo CSV que contenga información de usuario. El formato del archivoes el siguiente:

First Name,Last Name,Email,User Login,PasswordJane,Doe,[email protected],jdoe,P@ssword1John,Doe,[email protected],[email protected],P@ssword2



https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/cepma/sample_script_13_crt_users_unique_pwd.html

https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/cepma/sample_script_13_crt_users_unique_pwd.html

Guarde el archivo (por ejemplo, como users.csv) y almacénelo en el directoriodonde almacena los archivos de script que se crearán en los siguientes pasos.

2. Copie el script de una de las siguientes secciones en un archivo y guárdelo; porejemplo, como addusers.ps1 (Windows) o ./epmautomate/bin/addusers.sh (Linux/UNIX).

3. Solo para Windows: cree un archivo por lotes denominado addusers.batcopiando el siguiente script en un archivo. Guarde el archivo en el directoriodonde está almacenado users.CSV.

@echo offset paramRequiredMessage=Syntax: addusers.bat "FILENAME" "[resetPassword=true|false]"

set adminusername="ADMIN_USER_NAME"set adminpassword="ADMIN_PASSWORD"set url="URL"set identitydomain="IDENTITY_DOMAIN"

set dirpath=%~dp0echo %dirpath:~0,-1%cd %dirpath:~0,-1%set resetpassword=%~2

if "%~1" == "" ( echo File Name is missing. echo %paramRequiredMessage% exit /b 1 )if "%resetpassword%" == "" ( set resetpassword="resetPassword=true" )

PowerShell.exe -File addusers.ps1 %~1 %resetpassword% %adminusername% %adminpassword% %url% %identitydomain%

4. Modifique addusers.bat (Windows) o addusers.sh (Linux/UNIX) paradefinir los valores de los parámetros de la siguiente tabla.

Tabla 3-1 Valores de variable que se deben incluir en los scripts

Variable Descripción

adminusername Nombre de usuario de un administradordel servicio que también tiene asignado elrol de administrador del dominio deidentidad.Ejemplos:

Windows: set adminusername="jDoe"

Linux/UNIX:adminusername="John.Doe"



Tabla 3-1 (Continuación) Valores de variable que se deben incluir en losscripts


adminpassword Contraseña del administrador de servicio oubicación del archivo de contraseñacifrado. Consulte el comando encrypt paraobtener información sobre la creación dearchivos de contraseña cifrada.Ejemplos:

Windows: set adminpassword ="Example"

Linux/UNIX:adminpassword="Example"

url URL del entorno de EPM Cloud.Ejemplos:

Windows: set url="https://example.oraclecloud.com"

Linux/UNIX: url="https://example.oraclecloud.com"

identitydomain Nombre del dominio de identidad quepresta servicio al entorno.Ejemplos:

Windows: setidentitydomain="example"

Linux/UNIX:identitydomain="example"

5. Solo para addusers.sh: asegúrese de que los siguientes valores se han definidocorrectamente para el sistema:

• javahome

• Ubicación de epmautomatescript.sh mediante la actualización del valorde la directiva epmautomatescript

6. Ejecute addusers.bat (que ejecuta addusers.ps1) o addusers.sh desde eldirectorio donde están almacenados los scripts. Ejecute el siguiente comando:

Windows: addusers.bat "fileName.csv" ["resetPassword=true|false"].

Linux/UNIX: ./addusers.sh "fileName.csv" ["resetPassword=true|false"], donde:

• fileName.csv es el nombre del archivo CSV que contiene información delusuario.

Solo para Windows: este parámetro y su valor se deben incluir entre comillasdobles.

• resetpassword es un parámetro opcional que indica si desea forzar a losusuarios a cambiar sus contraseñas tras el primer inicio de sesión. De formapredeterminada, se recomienda true.

Solo para Windows: este parámetro y su valor se deben incluir entre comillasdobles.



Ejemplos:

• Windows: addusers.bat "users.csv" "resetPassword=false"

• Linux/UNIX: ./addusers.sh users.csv resetPassword=false

Script de PowerShell (adduser.ps1)

# Add users script

$inputfile=$args[0]$resetpassword=$args[1]$adminusername=$args[2]$adminpassword=$args[3]$url=$args[4]$identitydomain=$args[5]

# Generic variables$datedefaultformat=$(get-date)$global:addusersfile="addusers.csv"$logfile="addusers.log"

function LogMessage{ $message=$args[0]

echo "$message" >> $logfile}

function EchoAndLogMessage{ $message=$args[0]

echo "$message" echo "$message" >> $logfile}

function Init{ $logfileexists=Test-Path $logfile if ($logfileexists) { rm $logfile 2>&1 | out-null } if ($inputfile -eq $addusersfile) { $global:addusersfile="addusers-tmp.csv" }}

function Coda{ $addusersfileexists=Test-Path $addusersfile if ($addusersfileexists) { rm $addusersfile 2>&1 | out-null }}

function ValidateInputFile{ $inputfileheader=Get-Content $inputfile | Select -Index 0 $inputfilefirstrecord=Get-Content $inputfile | Select -Index 1



if ($inputfileheader -notlike "*First Name,Last Name,Email,User Login,Password*") { EchoAndLogMessage "File ${inputfile} does not contain correct header: `"First Name,Last Name,Email,User Login,Password`". Please correct before re-running script. Exiting." exit }

$elements=$inputfilefirstrecord -split "," $firstname=$elements[0] $lastname=$elements[1] $email=$elements[2] $username=$elements[3] $password=$elements[4]

if ([string]::IsNullOrEmpty($firstname)) { EchoAndLogMessage "The first record of file ${inputfile} contains an empty first name. Please correct before re-running script. Exiting." exit } elseif ([string]::IsNullOrEmpty($lastname)) { EchoAndLogMessage "The first record of file ${inputfile} contains an empty last name. Please correct before re-running script. Exiting." exit } elseif ([string]::IsNullOrEmpty($email)) { EchoAndLogMessage "The first record of file ${inputfile} contains an empty email address. Please correct before re-running script. Exiting." exit } elseif ([string]::IsNullOrEmpty($username)) { EchoAndLogMessage "The first record of file ${inputfile} contains an empty user login. Please correct before re-running script. Exiting." exit } elseif ([string]::IsNullOrEmpty($password)) { EchoAndLogMessage "The first record of file ${inputfile} contains an empty password. Please correct before re-running script. Exiting." exit }}

function ValidateInput{ $inputfileexists=Test-Path $inputfile if (!($inputfileexists)) { EchoAndLogMessage "Could not locate required file ${inputfile}" EchoAndLogMessage "Syntax: addusers.bat FILENAME [resetPassword=true|false]" EchoAndLogMessage "Exiting now." exit }

ValidateInputFile}

function ProcessCommand{ $op=$args echo "EPM Automate operation: epmautomate.bat $op" >> $logfile epmautomate.bat $op >> $logfile 2>&1 if ($LASTEXITCODE -ne 0) { echo "EPM Automate operation failed: epmautomate.bat $op. See $logfile for details." }



}

function processInputFile{ $infile=$args[0] EchoAndLogMessage "Running: EPMAutomate login ${adminusername} ${adminpassword} ${url} ${identitydomain}" ProcessCommand login ${adminusername} ${adminpassword} ${url} ${identitydomain} Get-Content $infile | ForEach-Object { $fullpath=$_.trim() $elements=$fullpath.split(',') $firstname=$elements[0] $lastname=$elements[1] $email=$elements[2] $username=$elements[3] $password=$elements[4]

if ($firstname -eq "First Name") { return } else { EchoAndLogMessage "Creating add users file: ${addusersfile}" echo "First Name,Last Name,Email,User Login" > ${addusersfile} echo "${firstname},${lastname},${email},${username}" >> ${addusersfile} $txt = [io.file]::ReadAllText("$addusersfile") -replace "`r`n","`n" [io.file]::WriteAllText("$addusersfile", $txt) }

LogMessage "Contents of add users file:" cat ${addusersfile} >> ${logfile} EchoAndLogMessage "Running: EPMAutomate uploadFile ${addusersfile}" ProcessCommand uploadFile ${addusersfile} EchoAndLogMessage "Running: EPMAutomate addUsers ${addusersfile} userPassword=${password} $resetPassword" ProcessCommand addUsers ${addusersfile} userPassword=${password} ${resetpassword} EchoAndLogMessage "Running: EPMAutomate deleteFile ${addusersfile}" ProcessCommand deleteFile ${addusersfile} }

EchoAndLogMessage "Running: EPMAutomate logout" ProcessCommand logout}

InitEchoAndLogMessage "$datedefaultformat"EchoAndLogMessage "Addusers script started"ValidateInputProcessInputFile "${inputfile}"CodaEchoAndLogMessage "Addusers script completed"EchoAndLogMessage "$datedefaultformat"

Script de shell de Bash (addusers.sh)

#!/bin/sh

inputfile=$1resetpasswordvalue=$2addusersfile="addusers.csv"logfile="addusers.log"



# UPDATE VALUES FOR YOUR TEST ENVIRONMENTjavahome=/home/user1/jdk1.8.0_191epmautomatescript=/home/user1/epmautomate/bin/epmautomate.shadminusername=adminuser1adminpassword=adminpassword1url=https://planning-a12345.pbcs.us2.oraclecloud.comidentitydomain=""

export JAVA_HOME=${javahome}

init(){ if [ -f "${logfile}" ] then rm ${logfile} fi

if [ "${inputfile}" == "${addusersfile}" ] then addusersfile="addusers-tmp.csv" fi}

coda(){ if [ -f "${addusersfile}" ] then rm ${addusersfile} fi}

validateInputFile(){ local inputfileheader=$(head -n 1 ${inputfile}) local inputfilefirstrecord=$(head -n 2 ${inputfile} | tail -n 1)

if [[ "${inputfileheader}" != *"First Name,Last Name,Email,User Login,Password"* ]] then echo "File ${inputfile} does not contain correct header: \"First Name,Last Name,Email,User Login,Password\". Please correct before re-running script. Exiting." | tee -a ${logfile} exit fi

local firstname=$(echo "${inputfilefirstrecord}" | cut -d',' -f1) local lastname=$(echo "${inputfilefirstrecord}" | cut -d',' -f2) local email=$(echo "${inputfilefirstrecord}" | cut -d',' -f3) local userlogin=$(echo "${inputfilefirstrecord}" | cut -d',' -f4) local password=$(echo "${inputfilefirstrecord}" | cut -d',' -f5)

if [[ "${firstname}" == "" ]] then echo "The first record of file ${inputfile} contains an empty first name. Please correct before re-running script. Exiting." | tee -a ${logfile} exit elif [[ "${lastname}" == "" ]] then echo "The first record of file ${inputfile} contains an empty last name. Please correct before re-running script. Exiting." | tee -a ${logfile} exit



elif [[ "${email}" == "" ]] then echo "The first record of file ${inputfile} contains an empty email address. Please correct before re-running script. Exiting." | tee -a ${logfile} exit elif [[ "${userlogin}" == "" ]] then echo "The first record of file ${inputfile} contains an empty user login. Please correct before re-running script. Exiting." | tee -a ${logfile} exit elif [[ "${password}" == "" ]] then echo "The first record of file ${inputfile} contains an empty password. Please correct before re-running script. Exiting." | tee -a ${logfile} exit fi}

validateInput(){ if [ ! -f "${inputfile}" ] then echo "Could not locate required file ${inputfile}" | tee -a ${logfile} echo "Syntax: addusers.sh FILENAME [resetPassword=true|false]" | tee -a ${logfile} echo "Exiting now." | tee -a ${logfile} exit fi

if [ ! -z "$(tail -c 1 "${inputfile}")" ] then echo "No newline found at end of file ${inputfile}. Adding newline to end of file." >> ${logfile} echo "" >> ${inputfile} fi

validateInputFile

if [[ "${resetpasswordvalue}" != "" ]] then resetpasswordvalue=$(echo "${resetpasswordvalue}" | cut -d'=' -f2) else resetpasswordvalue="true" fi}

processInputFile(){ echo "Running: EPMAutomate login ${adminusername} ${adminpassword} ${url} ${identitydomain}" | tee -a ${logfile} ${epmautomatescript} login ${adminusername} ${adminpassword} ${url} ${identitydomain} >> ${logfile}

while read line do firstname=$(echo "${line}" | cut -d',' -f1) lastname=$(echo "${line}" | cut -d',' -f2) email=$(echo "${line}" | cut -d',' -f3) username=$(echo "${line}" | cut -d',' -f4) password=$(echo "${line}" | cut -d',' -f5)



if [[ "${firstname}" != "First Name" ]] then echo "Creating add users file: ${addusersfile}" | tee -a ${logfile} echo "First Name,Last Name,Email,User Login" > ${addusersfile} echo "${firstname},${lastname},${email},${username}" >> ${addusersfile} else continue fi

echo "Contents of add users file:" >> ${logfile} cat ${addusersfile} >> ${logfile} echo "Running: EPMAutomate uploadFile ${addusersfile}" | tee -a ${logfile} ${epmautomatescript} uploadFile ${addusersfile} >> ${logfile} echo "Running: EPMAutomate addUsers ${addusersfile} userPassword=${password} resetPassword=${resetpasswordvalue}" | tee -a ${logfile} ${epmautomatescript} addUsers ${addusersfile} userPassword=${password} resetPassword=${resetpasswordvalue} >> ${logfile} echo "Running: EPMAutomate deleteFile ${addusersfile}" | tee -a ${logfile} ${epmautomatescript} deleteFile ${addusersfile} >> ${logfile} done < ${inputfile}

echo "Running: EPMAutomate logout" | tee -a ${logfile} ${epmautomatescript} logout >> ${logfile}}

initdate | tee ${logfile}echo "Addusers script started" | tee -a ${logfile}validateInputprocessInputFile "${inputfile}"codaecho "Addusers script completed" | tee -a ${logfile}date | tee -a ${logfile}

Creación de usuarios y asignación a roles predefinidosUtilice esta secuencia de comandos de EPM Automate para crear usuarios y asignarlosa roles predefinidos en el dominio de identidad.

• Conéctese al entorno como administrador del servicio.

• Exporte información de grupos y de pertenencia al grupo desde el entorno aexample_snapshot.zip. En este escenario se supone que previamente haexportado los artefactos de grupos y de pertenencia al grupo utilizando Migraciónpara crear example_snapshot.zip.

• Descargue la instantánea (example_snapshot.zip) en un directorio local.

• Suprima la instantánea (example_snapshot.zip) del entorno.

• Cierre la sesión en el entorno.

• Extraiga el contenido de example_snapshot.zip.

• Anexe información sobre nuevos usuarios a HSS-Shared Services\resource\External Directory\Users.csv con el formato Nombre,Apellidos,Correoelectrónico,Conexión de usuario.

Para obtener información detallada, consulte Importación de un lote de cuentas deusuarios en Getting Started with Oracle Cloud.



• Anexe información sobre asignaciones de roles de nuevos usuarios (con formatoNombre,Apellidos,Correo electrónico,Conexión de usuario) a archivos de rolesadecuados.

La asignación de usuarios para cada rol de dominio de identidad se debeespecificar en un archivo independiente disponible en HSS-Shared Services\resource\External Directory\Roles. Por ejemplo, la asignación al rol deadministrador del servicio se debe anexar a <service_name> ServiceAdministrator.csv, mientras que las asignaciones al rol de visor se debenanexar a HSS-Shared Services\resource\External Directory\Roles\<service_name> Viewer.csv.

Para obtener información detallada, consulte Asignación de un rol a muchosusuarios en Getting Started with Oracle Cloud.

• Vuelva a crear example_snapshot.zip comprimiendo el directorio HSS-Shared Services y su contenido.

• Inicie sesión en el entorno como administrador del servicio que también cuentacon el rol de administrador del dominio de identidad.

• Cargue el archivo example_snapshot.zip modificado en el entorno.

• Importe example_snapshot.zip en el entorno.

• Suprima el archivo example_snapshot.zip cargado del entorno.

• Cierre la sesión.

Nota:

Puede automatizar este escenario escribiendo un script personalizado querealiza estas tareas:

• Descomprimir example_snapshot.zip

• Anexar información de usuario a Users.csv

• Anexar asignaciones de roles a archivos

• Comprimir HSS-Shared Services y su contenido para volver a crearexample_snapshot.zip

epmautomate login serviceAdmin C:\mySecuredir\password.epw https://example.oraclecloud.com ExampleDomainepmautomate exportsnapshot example_snapshotepmautomate downloadfile "example_snapshot.zip"epmautomate deletefile "example_snapshot.zip"epmautomate logout

/* Add custom code to extract the contents of example_snapshot.zip

/* Add custom code to append new user information to HSS-Shared Services\resource\External Directory\Users.csv /* Optional: Add custom code to append role information to the appropriate role file(s) in HSS-Shared Services\resource\External Directory\Roles\/* Add custom code to zip HSS-Shared Services and its contents as example_snapshot.zip */



epmautomate login serviceAdmin C:/mySecuredir/password.epw https://example.oraclecloud.com ExampleDomainepmautomate uploadfile "example_snapshot.zip"epmautomate importsnapshot example_snapshot userPassword=Password1 resetPassword=trueepmautomate deletefile example_snapshot.zipepmautomate logout

Nota: El valor que especifique para userPassword (Password1 en elcomando anterior) se establecerá como contraseña inicial de los nuevosusuarios. Establezca el valor de resetPassword como true para que losnuevos usuarios tengan que restablecer la contraseña la primera vez queinician sesión. Consulte importSnapshot para obtener información.

Recuento del número de usuarios asignados a rolesUtilice el script de esta sección para generar el Informe de asignación de roles paracontar el número de usuarios de un entorno.

Cree provisionedUsersCount.bat mediante la copia del siguiente script.

Nota:

• Los parámetros de entrada para ejecutar este script son username,password/password_file, service_url, identity_domain, yprovision_report_file_name.

• Si utiliza la versión en PDF de este documento: para evitar saltos delíneas e información de pie de página que inutilizarán este script, cópielode la Versión HTML de este tema.

@echo offset paramRequiredMessage=Syntax: provisionedUsersCount.bat USERNAME PASSWORD/PASSWORD_FILE URL IDENTITY_DOMAIN PROVISION_REPORT_FILE_NAME

if "%~1" == "" ( echo User Name is missing. echo %paramRequiredMessage% exit /b 1 )if "%~2" == "" ( echo Password or Password_File is missing. echo %paramRequiredMessage% exit /b 1 )if "%~3" == "" ( echo URL is missing. echo %paramRequiredMessage% exit /b 1 )if "%~4" == "" ( echo Identity Domain is missing. echo %paramRequiredMessage% exit /b 1 )if "%~5" == "" ( echo Role Assignment Report File Name is missing.



https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/cepma/sample_script_5_license.html

echo %paramRequiredMessage% exit /b 1 )call epmautomate.bat login %~1 "%~2" %~3 %~4REM call epmautomate.bat login %~1 "%~2" %~3

if %errorlevel% NEQ 0 exit /b 1 call epmautomate.bat provisionreport "%5"if %errorlevel% NEQ 0 exit /b 1 call epmautomate.bat downloadfile "%5"if %errorlevel% NEQ 0 exit /b 1

set filePath="%cd%\%5"

if exist %filePath% ( SETLOCAL EnableDelayedExpansion set /a lineCount=0 set /a userCount=0 set userHeaderFound=false for /f "tokens=*" %%A in ( 'type %filePath%' ) do ( set /a lineCount+=1 set line=%%A REM Fetch username from role assignment information row if !userHeaderFound!==true ( for /f "delims=," %%i in ("!line!") do ( set userName=%%i ) if NOT !userName! == "" ( if !userCount! gtr 0 if NOT !userName! == !lastUserName! ( set /a userCount+=1 set users[!userCount!]=!userName! ) if !userCount! == 0 ( set /a userCount+=1 set users[!userCount!]=!userName! ) set lastUserName=!userName! ) ) REM Check for headers of Role Assignment Report if "!line!"=="User,Role,Granted through Groups" ( set userHeaderFound=true ) if "!line!"=="User,Roles,Granted Through" ( set userHeaderFound=true ) ) echo Number of Users: !userCount! for /l %%n in (1,1,!userCount!) do ( REM echo !users[%%n]! ) endlocal

) else ( echo Invalid Role AssignmentReport file path - %filePath%.)



Creación de informes de auditoría de usuarios asignados a rolesUtilice los scripts de esta sección para automatizar el proceso de creación de uninforme de auditoría para usuarios asignados a roles predefinidos en un entorno.

En este informe de auditoría se muestran los usuarios asignados a roles o grupospredefinidos que hayan cambiado desde la última vez que se generó el informe. Paracrear un informe de auditoría diario, ejecute este script a diario.

Cree provisioningAuditReport.bat copiando el siguiente script. Este script porlotes de envoltorio llama al script PowerShell provisioningAuditReport.ps1, elcódigo de origen para el que se proporciona más adelante en este escenario.

Nota:

• Los parámetros de entrada para ejecutarprovisioningAuditReport.bat son: username, password opassword_file, service_url y identity_domain.


@echo offset paramRequiredMessage=Syntax: provisioningAuditReport.bat USERNAME PASSWORD/PASSWORD_FILE URL IDENTITY_DOMAIN

if "%~1" == "" ( echo User Name is missing. echo %paramRequiredMessage% exit /b 1 )if "%~2" == "" ( echo Password or Password_File is missing. echo %paramRequiredMessage% exit /b 1 )if "%~3" == "" ( echo URL is missing. echo %paramRequiredMessage% exit /b 1 )

PowerShell.exe -File provisioningAuditReport.ps1 %*

provisioningAuditReport.bat llama a provisioningAuditReport.ps1, quese crea copiando el siguiente script.

Con provisioningAuditReport.ps1 se crea el informe de auditoría. Colóquelo enel mismo directorio en el que se encuentra provisioningAuditReport.bat.

$username=$args[0]$password=$args[1]$url=$args[2]$identitydomain=$args[3]



https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/cepma/sample_script_6_provisioning_audit.html

$date=$(get-date -f dd_MM_yy_HH_mm_ss)$datedefaultformat=$(get-date)$logdir="./logs/"$logfile="$logdir/epmautomate-provisionauditreport-" + $date + ".log"$reportdir="./reports/"$provisionreport="provreport-audittest-" + $date + ".csv"$provisionreporttemp="./provreport-audittest-temp.csv"$provisionreportunique="./provreport-audittest-unique.csv"$provisionreportbaselineunique="./provreport-audittest-baseline-unique.csv"

function EchoAndLogMessage{ $message=$args[0] echo "$message" echo "$message" >> $logfile}

function Init{ $logdirexists=Test-Path $logdir if (!($logdirexists)) { mkdir $logdir 2>&1 | out-null }

$logfileexists=Test-Path $logfile if ($logfileexists) { rm $logfile 2>&1 | out-null }

$reportdirexists=Test-Path $reportdir if (!($reportdirexists)) { mkdir $reportdir 2>&1 | out-null }}

function PostProcess{ rm $provisionreporttemp mv -Force $provisionreportunique $provisionreportbaselineunique}

function ProcessCommand{ $op=$args echo "EPM Automate operation: epmautomate.bat $op" >> $logfile epmautomate.bat $op >> $logfile 2>&1 if ($LASTEXITCODE -ne 0) { echo "EPM Automate operation failed: epmautomate.bat $op. See $logfile for details." exit }}

function RunEpmAutomateCommands{ EchoAndLogMessage "Running EPM Automate commands to generate the provisioning report." ProcessCommand login $username $password $url $identitydomain ProcessCommand provisionreport $provisionreport ProcessCommand downloadfile $provisionreport ProcessCommand deletefile $provisionreport



ProcessCommand logout}

function CreateProvisionReportTempFile{ # Loop through iteration csv file and parse Get-Content $provisionreport | ForEach-Object { $elements=$_.split(',') echo "$($elements[0]),$($elements[2])" >> $provisionreporttemp }}

function CreateUniqueElementsFile{ gc $provisionreporttemp | sort | get-unique > $provisionreportunique}

function CheckBaselineAndCreateAuditReport{ $provisionreportbaselineuniqueexists=Test-Path $provisionreportbaselineunique if (!($provisionreportbaselineuniqueexists)) { EchoAndLogMessage "No existing provisioning report, so comparison with a baseline is not possible. Audit report will be created at the next test run." } else { CreateAuditReport }}

function CreateAuditReport{ $auditreport=$reportdir + "auditreport-"+ $date + ".txt" $additions = @() $deletions = @()

EchoAndLogMessage "Comparing previous provisioning report with the current report." $compare=compare-object (get-content $provisionreportunique) (get-content $provisionreportbaselineunique)

$compare | foreach { if ($_.sideindicator -eq '<=') { $additions += $_.inputobject } elseif ($_.sideindicator -eq '=>') { $deletions += $_.inputobject } }

echo "Provisioning Audit Report for $datedefaultformat" > $auditreport echo "------------------------------------------------" >> $auditreport

if ($additions.count -ne 0) { echo " " >> $auditreport echo "Additions:" >> $auditreport foreach($element in $additions) { echo "$element" >> $auditreport } }

if ($deletions.count -ne 0) { echo " " >> $auditreport echo "Deletions:" >> $auditreport



foreach($element in $deletions) { echo "$element" >> $auditreport } }

if (($additions.count -eq 0) -and ($deletions.count -eq 0)) { echo " " >> $auditreport echo "No changes from last audit report." >> $auditreport }

EchoAndLogMessage "Provisioning audit report has been generated: $auditreport."}

InitEchoAndLogMessage "Starting EPMAutomate provisioning audit reporting"RunEpmAutomateCommandsCreateProvisionReportTempFileCreateUniqueElementsFileCheckBaselineAndCreateAuditReportPostProcessEchoAndLogMessage "EPMAutomate provisioning audit reporting completed"

Creación de informe de auditoría de asignación de roles y revocaciónUtilice el script de PowerShell de esta sección para automatizar el proceso de creaciónde un informe de auditoría que detalla la asignación de roles y la revocación de rolesen un entorno.

Cree AuditReportRoleAssignment.bat copiando el siguiente script. Este scriptpor lotes de contenedor llama al script PowerShellAuditReportRoleAssignment.ps, el código de origen para el que se proporcionamás adelante en este escenario.

Nota:

• Los parámetros de entrada para ejecutaAuditReportRoleAssignment.bat son: username, password opassword_file, service_url y identity_domain.


Script: AuditReportRoleAssignment.bat

@echo offset paramRequiredMessage=Syntax: AuditReportRoleAssignment.bat USERNAME PASSWORD/PASSWORD_FILE URL IDENTITY_DOMAIN

if "%~1" == "" ( echo User Name is missing. echo %paramRequiredMessage% exit /b 1 )if "%~2" == "" ( echo Password or Password_File is missing. echo %paramRequiredMessage% exit /b 1 )



https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/cepma/sample_script_9_role_assignment_sox.html

if "%~3" == "" ( echo URL is missing. echo %paramRequiredMessage% exit /b 1 )

PowerShell.exe -File AuditReportRoleAssignment.ps %*

Script: AuditReportRoleAssignment.ps

# EPM Automate Role Assignment Audit Report Script$username=$args[0]$password=$args[1]$url=$args[2]$identitydomain=$args[3]

# Generic variables$date=$(get-date -f dd_MM_yy_HH_mm_ss)$datedefaultformat=$(get-date)$logdir="./logs/"$logfile="$logdir/epmautomate-provisionauditreport-" + $date + ".log"$reportdir="./reports/"$provisionreport="provreport-audittest-" + $date + ".csv"$provisionreporttemp="./provreport-audittest-temp.csv"$provisionreportunique="./provreport-audittest-unique.csv"$provisionreportbaselineunique="./provreport-audittest-baseline-unique.csv"

function EchoAndLogMessage{ $message=$args[0] echo "$message" echo "$message" >> $logfile}function Init{ $logdirexists=Test-Path $logdir if (!($logdirexists)) { mkdir $logdir 2>&1 | out-null } $logfileexists=Test-Path $logfile if ($logfileexists) { rm $logfile 2>&1 | out-null } $reportdirexists=Test-Path $reportdir if (!($reportdirexists)) { mkdir $reportdir 2>&1 | out-null }}

function PostProcess{ rm $provisionreporttemp mv -Force $provisionreportunique $provisionreportbaselineunique}

function ProcessCommand{ $op=$args echo "EPM Automate operation: epmautomate.bat $op" >> $logfile epmautomate.bat $op >> $logfile 2>&1 if ($LASTEXITCODE -ne 0) {



echo "EPM Automate operation failed: epmautomate.bat $op. See $logfile for details." exit }}

function RunEpmAutomateCommands{ EchoAndLogMessage "Running EPM Automate commands to generate the audit report." ProcessCommand login $username $password $url $identitydomain ProcessCommand provisionreport $provisionreport ProcessCommand downloadfile $provisionreport ProcessCommand deletefile $provisionreport ProcessCommand logout}function CreateProvisionReportTempFile{ # Loop through iteration csv file and parse Get-Content $provisionreport | ForEach-Object { $elements=$_.split(',') echo "$($elements[0]),$($elements[2])" >> $provisionreporttemp }}

function CreateUniqueElementsFile{ gc $provisionreporttemp | sort | get-unique > $provisionreportunique}

function CheckBaselineAndCreateAuditReport{ $provisionreportbaselineuniqueexists=Test-Path $provisionreportbaselineunique if (!($provisionreportbaselineuniqueexists)) { EchoAndLogMessage "Could not find a baseline audit report to compare with. Audit report will be created next time you run test." } else { CreateAuditReport }}

function CreateAuditReport{ $auditreport=$reportdir + "auditreport-"+ $date + ".txt" $additions = @() $deletions = @() EchoAndLogMessage "Comparing previous audit report with the current one." $compare=compare-object (get-content $provisionreportunique) (get-content $provisionreportbaselineunique) $compare | foreach { if ($_.sideindicator -eq '<=') { $additions += $_.inputobject } elseif ($_.sideindicator -eq '=>') { $deletions += $_.inputobject } } echo "Provisioning Audit Report for $datedefaultformat" > $auditreport echo "------------------------------------------------" >> $auditreport if ($additions.count -ne 0) { echo " " >> $auditreport



echo "Additions:" >> $auditreport foreach($element in $additions) { echo "$element" >> $auditreport } } if ($deletions.count -ne 0) { echo " " >> $auditreport echo "Deletions:" >> $auditreport foreach($element in $deletions) { echo "$element" >> $auditreport } } if (($additions.count -eq 0) -and ($deletions.count -eq 0)) { echo " " >> $auditreport echo "No changes from last audit report." >> $auditreport } EchoAndLogMessage "Role audit report generated: $auditreport."}

InitEchoAndLogMessage "Starting EPMAutomate role audit report generation"RunEpmAutomateCommandsCreateProvisionReportTempFileCreateUniqueElementsFileCheckBaselineAndCreateAuditReportPostProcessEchoAndLogMessage "EPMAutomate role audit report completed"

Enmascaramiento de registros de acceso e informe de actividades para cumplir lasnormas de privacidad

Utilice los scripts de esta sección para automatizar el proceso de enmascaramiento deinformación en el Informe de actividad o los Registros de acceso.

Debido a las estrictas leyes de privacidad vigentes en algunos países, la informacióndisponible en los informes de actividad y los registros de acceso puede ocultarse a losadministradores de servicio para proteger la privacidad de los usuarios.

Utilice anonymizeData.bat para enmascarar información en el informe deactividad o los registros de acceso para cumplir las leyes de privacidad. Paraenmascarar la información, programe este script o una variación mediante elprogramador de Windows para que se ejecute todos los días una vez que finalice elproceso de mantenimiento diario de cada entorno.

Utilice las siguientes fuentes de información:

• Uso de informes de actividad y registros de acceso para supervisar el uso enIntroducción a Oracle Enterprise Performance Management Cloud para administradores

• Automatización de la ejecución de scripts

Para crear manualmente anonymizeData.bat, copie el script de Windowsproporcionado en el siguiente procedimiento y prográmelo mediante el programadorde Windows. Puede crear y ejecutar scripts similares para otras plataformas en caso deque no utilice Windows para la programación.

anonymizeData.bat es un script contenedor que ejecuta el scriptanonymizeData.ps1, el cual puede crear y actualizar tal y como se explica en elprocedimiento siguiente.



Nota: Si utiliza la versión en PDF de este documento: para evitar saltos delíneas e información de pie de página que inutilizarán estos scripts, cópielosde la Versión HTML de este tema.

1. Cree un archivo por lotes (BAT) llamado anonymizeData.bat que contenga elsiguiente script y guárdelo en una ubicación apropiada, por ejemplo, C:\automate_scripts.

@echo offset paramRequiredMessage=Syntax: anonymizeData.bat USERNAME PASSWORD/PASSWORD_FILE URL IDENTITY_DOMAIN

if "%~1" == "" ( echo User Name is missing. echo %paramRequiredMessage% exit /b 1 )if "%~2" == "" ( echo Password or Password_File is missing. echo %paramRequiredMessage% exit /b 1 )if "%~3" == "" ( echo URL is missing. echo %paramRequiredMessage% exit /b 1 )

PowerShell.exe -File anonymizeData.ps1 %*

2. Cree un script PowerShell (PS1) llamado anonymizeData.ps1 que contenga elsiguiente script y guárdelo en una ubicación apropiada, por ejemplo, C:\automate_scripts.

# Anonymize data script

$username=$args[0]$password=$args[1]$url=$args[2]$identitydomain=$args[3]

# Generic variables$date=$(get-date -f dd_MM_yy_HH_mm_ss)$datedefaultformat=$(get-date)$logdir="./logs/"$logfile="$logdir/anonymize-data-" + $date + ".log"$filelist="filelist.txt"

function LogMessage{ $message=$args[0]

echo "$message" >> $logfile}

function EchoAndLogMessage{ $message=$args[0]



https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/cepma/sample_script_41_mask_access_log_activity_rep.html

echo "$message" echo "$message" >> $logfile}function Init{ $logdirexists=Test-Path $logdir if (!($logdirexists)) { mkdir $logdir 2>&1 | out-null }

$logfileexists=Test-Path $logfile if ($logfileexists) { rm $logfile 2>&1 | out-null }

$filelistexists=Test-Path $filelist if ($filelistexists) { rm $filelist 2>&1 | out-null }}

function ProcessCommand{ $op=$args echo "EPM Automate operation: epmautomate.bat $op" >> $logfile if ($op -eq 'listfiles') { epmautomate.bat $op | where {$_ -like ' apr/*/access_log.zip'} | Tee-Object -FilePath $filelist | Out-File $logfile -Append 2>&1 } else { epmautomate.bat $op >> $logfile 2>&1 if ($LASTEXITCODE -ne 0) { echo "EPM Automate operation failed: epmautomate.bat $op. See $logfile for details." #exit } }}

function RunEpmAutomateCommands{ EchoAndLogMessage "Running EPM Automate commands to anonymize data in the access logs and activity reports." ProcessCommand login $username $password $url $identitydomain ProcessCommand listfiles ProcessFiles ProcessCommand logout}

function ProcessActivityReport{ $activityreport=$args[0] $user=$args[1]

$activityreportexists=Test-Path "$activityreport" if ($activityreportexists) { LogMessage "Removing User ID: $user from activity report $activityreport" (Get-Content "$activityreport").replace("$user", 'XXXXX') | Set-Content "$activityreport" $txt = [io.file]::ReadAllText("$activityreport") -replace "`r`n","`n" [io.file]::WriteAllText("$activityreport", $txt) #Get-ChildItem -File -Recurse | % { $x = get-content -raw -



path $activityreport; $x -replace "`r`n","`n" | set-content -path $activityreport } }}

function AnonymizeData{ $aprdir=$args[0] $datestampdir=$args[1] $path="$aprdir/$datestampdir" $accesslogzipped="access_log.zip" $accesslog="access_log.csv" $accesslogupdated=$accesslog + ".tmp" $activityreportfile="$datestampdir" + ".html" $userArray = @()

expand-Archive -Path "$path/$accesslogzipped" -DestinationPath $path rm $path/$accesslogzipped 2>&1 | out-null $accesslogexists=Test-Path "$path/$accesslog" if ($accesslogexists) { EchoAndLogMessage "Processing access log: $path/$accesslog" Get-Content $path/$accesslog | ForEach-Object { $elements=[regex]::Split( $_ , ',(?=(?:[^"]|"[^"]*")*$)' ) $date=$elements[0] $time=$elements[1] $uri=$elements[2] $duration=$elements[3] $bytes=$elements[4] $ip=$elements[5] $user=$elements[6] $screen=$elements[7] $action=$elements[8] $object=$elements[9] if ($date -like 'Date') { echo "$_" >> $path/$accesslogupdated } else { if ($user -notlike '-') { LogMessage "Removing instance of User ID: $user from $path/$accesslog." echo "$date,$time,$uri,$duration,$bytes,$ip,XXXXX,$screen,$action,$object" >> $path/$accesslogupdated $userArray += $user } else { echo "$date,$time,$uri,$duration,$bytes,$ip,$user,$screen,$action,$object" >> $path/$accesslogupdated } } } #Get-ChildItem -File -Recurse | % { $x = get-content -raw -path $path/$accesslogupdated; $x -replace "`r`n","`n" | set-content -path $path/$accesslogupdated } $txt = [io.file]::ReadAllText("$path/$accesslogupdated") -replace "`r`n","`n" [io.file]::WriteAllText("$path/$accesslogupdated", $txt) mv -Force $path/$accesslogupdated $path/$accesslog Compress-Archive -Path $path/$accesslog $path/$accesslogzipped rm $path/$accesslog 2>&1 | out-null }



EchoAndLogMessage "Processing activity report: $path/$activityreportfile" $userArray = $userArray | Select-Object -Unique foreach ($element in $userArray) { ProcessActivityReport "$path/$activityreportfile" "$element" }}

function ProcessFiles{ # Loop through iteration csv file and parse Get-Content $filelist | ForEach-Object { $fullpath=$_.trim() $elements=$fullpath.split('/') $aprdir=$elements[0] $datestampdir=$elements[1] $accesslogfile="access_log.zip" $activityreportfile="$datestampdir" + ".html" $datestampdirexists=Test-Path "$aprdir/$datestampdir" $accesslog="$aprdir/$datestampdir/$accesslogfile" $activityreport="$aprdir/$datestampdir/$activityreportfile"

echo "fullpath: $fullpath" >> $logfile echo "aprdir: $aprdir, datestampdir: $datestampdir" >> $logfile if (!($datestampdirexists)) { mkdir "$aprdir/$datestampdir" -ea 0 2>&1 | out-null ProcessCommand downloadfile "$accesslog" ProcessCommand downloadfile "$activityreport" mv "$accesslogfile" "$aprdir/$datestampdir" mv "$activityreportfile" "$aprdir/$datestampdir" AnonymizeData "$aprdir" "$datestampdir" ProcessCommand deletefile "$accesslog" ProcessCommand deletefile "$activityreport" ProcessCommand uploadfile "$accesslog" "$aprdir/$datestampdir" ProcessCommand uploadfile "$activityreport" "$aprdir/$datestampdir" } else { EchoAndLogMessage "Files in directory $aprdir/$datestampdir were processed earlier. Skipping these files." } }}

InitEchoAndLogMessage "Starting the anonymize data script"RunEpmAutomateCommandsEchoAndLogMessage "Anonymize data script completed"EchoAndLogMessage "Refer to logfile: $logfile for details."

3. Con el programador de Windows, programe anonymizeData.bat. Consulte Automatización de la ejecución de scripts para obtener pasos detallados.

Debe proporcionar los siguientes valores de parámetros para ejecutaranonymizeData.bat.

• Nombre de usuario de un administrador del servicio.

• Contraseña del administrador del servicio o la ubicación en la que estádisponible el archivo de contraseña cifrado.

• URL del entorno del servicio en el que se van a enmascarar los registros deacceso e informes de actividad.



• Nombre del dominio de identidad que presta servicio al entorno.

Automatización de descargas de informes de actividad en un equipo localUtilice el script de esta sección para automatizar la descarga de informes de actividadde un entorno en un equipo local.

Utilice syncAprReports.bat para descargar informes de actividad. Puedeprogramar el archivo por lotes mediante el programador de Windows paraautomatizar la descarga de informes de actividad. Consulte Uso de informes deactividad y registros de acceso para supervisar el uso en Introducción a Oracle EnterprisePerformance Management Cloud para administradores para obtener información detalladasobre informes de actividad.

Cree manualmente syncAprReports.bat mediante la copia del scriptproporcionado en el siguiente procedimiento y la actualización de los parámetros deconexión. Este script comprueba el entorno y descarga solo los informes que sean másrecientes que los que están disponibles en el directorio de descarga del equipo local.

Nota:

• El script se ejecutará desde un equipo de Windows únicamente.

• Con este script no se descarga el informe de actividad de comentarios, quese genera cuando el usuario envía comentarios.


1. Cree un archivo por lotes (.BAT) denominado syncAprReports.bat quecontenga el siguiente script y guárdelo en una ubicación adecuada (por ejemplo, C:\automate_scripts).

@echo offtitle APRsetlocal DisableDelayedExpansion

REM To hardcode the values in the script replace %1, %2, %3, %4, %5 with the actual values.REM Example:REM set apr_dir="C:\Oracle\apr"REM set username="serviceAdmin"REM set password="Ex@mple!"REM set url="https://test-example.stg-pbcs.us1.oraclecloud.com"REM set domain="example"set apr_dir=%1set username=%2set password=%3set url=%4set domain=%5setlocal EnableDelayedExpansionset epmautomate_dir=%cd%set lastfile=set argC=0for %%x in (%*) do Set /A argC+=1if %argC% neq 0 (



https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/cepma/sample_script_4.html

if %argC% neq 4 ( if %argC% neq 5 ( goto :usage ) ))goto :login:usageecho.echo Invalid syntax. Please check the parameters. echo Syntax:echo 1) syncAprReports.bat APR_FolderPath_on_client username password url domainecho or echo 2) set the parameters in the file and use below syntaxecho syncAprReports.batgoto :end

:loginsetlocal DisableDelayedExpansionfor /f "delims=" %%i in ('epmautomate login %username% %password% %url% %domain%') do set result=%%iif "Login successful" neq "%result%" ( echo Login Failed goto :end)

if not exist %apr_dir% (echo.echo apr folder does not exist GOTO :end)cd /D %apr_dir%for /f "delims=" %%D in ('dir /a:d /b /o:-n') do ( REM AFTER: for /f "delims=" %%D in ('dir /a-d /b /s /o:-n') do ( set "lastFile=%%~nD" goto :next)

:nextsetlocal EnableDelayedExpansionecho.echo Most Recent APR on client is %lastFile%

set "output_cnt=0"cd /D %epmautomate_dir%for /F "delims=" %%f in ('epmautomate listfiles') do (

cd /D !apr_dir! set "line=%%f" for /f "tokens=* delims= " %%a in ("!line!") do set line=%%a if "!line:~0,3!" equ "apr" (

if "!line:~4,8!" neq "Feedback" (

set isValidFile=false if "!line:~-5!" equ ".html" set isValidFile=true if "!line:~-5!" equ ".json" set isValidFile=true

if "!isValidFile!" equ "true" ( if "%lastFile%" lss "!line:~4,19!" (



if "!line:~4,19!" neq "!dirname!" ( set apr_dir=!apr_dir:"=! set /a output_cnt+=1 set "output[!output_cnt!]=!apr_dir!\!line:~4,19!" set "dirname=!line:~4,19!" REM start downloading mkdir "!dirname!" cd /D !dirname! echo downloading !line! set "downloadDir=!apr_dir!\!dirname!" cd /D %epmautomate_dir% for /f "delims=" %%i in ('epmautomate downloadfile "!line!"') do set result1=%%i move "!line:~24!" "!downloadDir!" > nul echo !result1! REM end downloading ) else ( REM start downloading cd /D !dirname! echo downloading !line! set apr_dir=!apr_dir:"=! set "downloadDir=!apr_dir!\!dirname!" cd /D %epmautomate_dir% for /f "delims=" %%i in ('epmautomate downloadfile "!line!"') do set result1=%%i move "!line:~24!" "!downloadDir!" > nul echo !result1! REM end downloading ) ) else ( REM TO-DO ) ) ) ))

echo.echo %output_cnt% APR's downloadedfor /L %%n in (1 1 !output_cnt!) DO echo !output[%%n]!goto :end

:endcd /D %epmautomate_dir%endlocal

2. Modifique syncAprReports.bat para definir los valores de los parámetros en lasiguiente tabla. Estos valores se utilizan para acceder al entorno y descargarinformes de actividad.



Tabla 3-2 Valores de parámetro que se van a incluir en syncAprReports.bat

Parámetro Valor esperado

set apr_dir=%1 Especifique un directorio existente en el que se descargarán losinformes de actividad.Ejemplo: set apr_dir="C:\Oracle\apr"

set username=%2 Un nombre de usuario de Oracle Enterprise PerformanceManagement Cloud que se utilizará para iniciar sesión en elentorno y descargar informes de actividad.Ejemplo: set username="ServiceAdmin"

set password=%3 El nombre y la ubicación del archivo que almacena la contraseñacifrada del usuario especificado por la variable username.También puede especificar la contraseña de texto sin formato delusuario (no recomendado). Consulte el comando encrypt paraobtener información sobre la creación de archivos de contraseñacifrada.

Ejemplos:

set password="C:\mySecuredir\password.epw"

set password="Ex@mple1"

set url=%4 La URL del entorno.Ejemplo: set url="https://test-example.stg-pbcs.us1.oraclecloud.com"

set domain=%5 El dominio de identidad que sirve al entorno.Ejemplo: set domain="example"

3. Con el programador de Windows, programe syncAprReports.bat. Consulte Automatización de la ejecución de scripts para obtener pasos detallados.

Descarga de logs de acceso desde un entornoUtilice el script de esta sección para automatizar el proceso de descarga de registros deacceso de un entorno en un equipo local.

Puede programar syncAccessLog.bat utilizando el programador de Windows paraautomatizar la descarga de los archivos de registro. Consulte Visualización y descargade informes de actividad y registros de acceso en Introducción a Oracle EnterprisePerformance Management Cloud para administradores para conocer los procedimientos dedescarga de registros de acceso mediante la administración de aplicaciones.

El siguiente script comprueba el entorno y descarga solo los archivos de registro queson más recientes que los disponibles en el directorio de descarga del equipo local.Este script es de Windows; puede crear un script de shell similar para entornos deLinux/UNIX.

1. Cree un archivo por lotes (.BAT) llamado syncAccessLog.bat que contenga elsiguiente script y guárdelo en una ubicación apropiada, por ejemplo, C:\automate_scripts.

Nota:

Si utiliza la versión en PDF de este documento: para evitar saltos de líneas einformación de pie de página que inutilizarán este script, cópielo de la VersiónHTML de este tema.



https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/cepma/sample_script_8_download_files.html

https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/cepma/sample_script_8_download_files.html

@echo offtitle APRsetlocal DisableDelayedExpansion

REM To hardcode the values in the script replace %1, %2, %3, %4, %5 with the actual values.REM Example:REM set apr_dir="C:\Oracle\apr"REM set username="serviceAdmin"REM set password="C:\mySecuredir\password.epw"REM set url="https://test-cloudpln.pbcs.us1.oraclecloud.com"REM set domain="myIdentityDomain"set apr_dir=%1set username=%2set password=%3set url=%4set domain=%5

setlocal EnableDelayedExpansionset epmautomate_dir=%cd%set lastfile=REM if [%1]==[] goto :usageREM if [%2]==[] goto :usageREM if [%3]==[] goto :usageREM if [%4]==[] goto :usage

set argC=0for %%x in (%*) do Set /A argC+=1if %argC% neq 0 ( if %argC% neq 4 ( if %argC% neq 5 ( goto :usage ) ))goto :login

:usageecho.echo Invalid syntax. Please check the parameters.echo Syntax:echo 1) syncAccessLog.bat APR_FolderPath_on_client username password url domainecho or echo 2) set the parameters in the file and use below syntaxecho syncAccessLog.batgoto :end

:loginsetlocal DisableDelayedExpansionREM for /f "delims=" %%i in ('epmautomate login %2 %3 %4 %5') do set result=%%ifor /f "delims=" %%i in ('epmautomate login %username% %password% %url% %domain%') do set result=%%i

if not exist %apr_dir% (echo.echo apr folder does not exist GOTO :end)cd /D %apr_dir%for /f "delims=" %%D in ('dir /a:d /b /o:-n') do ( REM AFTER: for /f "delims=" %%D in ('dir /a-d /b /s /o:-n') do (



set "lastFile=%%~nD" goto :next)

:nextsetlocal EnableDelayedExpansionecho.echo Most Recent Access Log on client is %lastFile%

set "output_cnt=0"cd /D %epmautomate_dir%for /F "delims=" %%f in ('epmautomate listfiles') do (

cd /D !apr_dir! set "line=%%f" for /f "tokens=* delims= " %%a in ("!line!") do set line=%%a if "!line:~0,3!" equ "apr" ( if "!line:~-4!" equ ".zip" ( if "%lastFile%" lss "!line:~4,19!" ( if "!line:~4,19!" neq "!dirname!" ( set apr_dir=!apr_dir:"=! set /a output_cnt+=1 set "output[!output_cnt!]=!apr_dir!\!line:~4,19!" set "dirname=!line:~4,19!" REM start downloading mkdir "!dirname!" cd /D !dirname! echo downloading !line! set "downloadDir=!apr_dir!\!dirname!" cd /D %epmautomate_dir% for /f "delims=" %%i in ('epmautomate downloadfile "!line!"') do set result1=%%i move "!line:~24!" "!downloadDir!" > nul echo !result1! REM end downloading ) else ( REM start downloading cd /D !dirname! echo downloading !line! set apr_dir=!apr_dir:"=! set "downloadDir=!apr_dir!\!dirname!" cd /D %epmautomate_dir% for /f "delims=" %%i in ('epmautomate downloadfile "!line!"') do set result1=%%i move "!line:~24!" "!downloadDir!" > nul echo !result1! REM end downloading ) ) else ( REM TO-DO ) ) ))

echo.echo %output_cnt% access logs downloadedfor /L %%n in (1 1 !output_cnt!) DO echo !output[%%n]!goto :end



:endcd /D %epmautomate_dir%endlocal

2. Modifique syncAccessLog.bat para establecer los valores de los parámetros enla siguiente tabla: Estos valores se utilizan para acceder al entorno y descargar losregistros de acceso.

Tabla 3-3 Valores de variable que se van a incluir en syncAccessLog.bat

Variable Valor esperado

set apr_dir=%1 Especifique el directorio en el que se van adescargar los registros de acceso.Ejemplo: set apr_dir="C:\Oracle\apr"

set username=%2 Un nombre de usuario de Oracle EnterprisePerformance Management Cloud que se vaa utilizar para iniciar sesión en el entorno ydescargar los registros de acceso.Ejemplo: setusername="ServiceAdmin"

set password=%3 El nombre y la ubicación del archivo quealmacena la contraseña cifrada del usuarioespecificado por la variable username.También puede especificar la contraseña detexto sin formato del usuario (norecomendado). Consulte el comando encrypt para obtener información sobre lacreación de archivos de contraseña cifrada.

Ejemplos:

set password="C:\mySecuredir\password.epw"

set password="P@ssword1"

set url=%4 La URL del entorno.Ejemplo: set url="https://test-cloudpln.pbcs.us1.oraclecloud.com"

set domain=%5 El dominio de identidad que sirve alentorno.Ejemplo: setdomain="myIdentityDomain"

3. Con el programador de Windows, programe syncAccessLog.bat. Consulte Automatización de la ejecución de scripts para obtener pasos detallados.

Automatización de la clonación de entornosUtilice el script de esta sección para automatizar la clonación de entornos.

Cree un archivo de lote (.bat) o shell (.sh) que contenga un script similar alsiguiente para clonar un entorno. El siguiente script de ejemplo para Windows manejaestas actividades en el entorno de destino (clon):



• Inicie sesión en el entorno de destino.

• Prepare el entorno para aceptar los datos del origen.

• Suprima el archivo Artifact Snapshot que se creó durante el último periodode mantenimiento.

• Copie Artifact Snapshot del entorno de origen.

• Importe los artefactos del archivo Artifact Snapshot en el destino. A losnuevos usuarios que se crean en el dominio de identidad de destino se les asignala contraseña que ha especificado en lugar de IDM_NEW_USER_PWD en el script.


Nota:

• El valor sourcePassword debe identificar la ubicación del archivo decontraseñas cifrado (ejemplo de Windows: C:\mySecuredir\example_pwd.epw). Consulte el comando encrypt.

• EPM Automate, durante el proceso de importación de artefactos, creanuevos usuarios y les asigna los roles correspondientes en el dominio deidentidad de destino. Para ello, es necesario que al usuario que ejecutaeste script tenga los roles de administrador del servicio y administradorde dominio de identidad en el entorno de destino.

• Para copiar una instantánea que no sea Artifact Snapshot, cambie elnombre de la instantánea en el script.


• Ejemplo de sintaxis del script: clone sourceUser sourcePasswordsourceURL sourceIDDomain targetUser targetPasswordtargetURL targetIDDomain. Por ejemplo:

clone [email protected] C:\mySecuredir\example_pwd.epwhttps://example.oraclecloud.com [email protected] C:\mySecuredir\example_pwd2.epwhttps://example-another.oraclecloud.com exampleDomain2.


@echo offSET /A ARGS_COUNT=0 FOR %%A in (%*) DO SET /A ARGS_COUNT+=1 if %ARGS_COUNT% == 0 ( cls echo. echo Welcome to Clone echo Type Clone help and press ENTER for help. echo. exit /b 0 ) IF /I %1=="help" goto :HELP



https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/cepma/sample_script_3.html

REM echo %ARGS_COUNT% if %ARGS_COUNT% NEQ 8 ( goto :HELP )set sourceUser=%1set sourcePassword=%2set sourceURL=%3set sourceDomain=%4set targetUser=%5set targetPassword=%6set targetURL=%7set targetDomain=%8set ERROR_LEVEL=0

CD /D %~dp0echo Login to Target Environmentcall epmautomate login %targetUser% %targetPassword% %targetURL% %targetDomain%IF %ERROR_LEVEL% NEQ 0 ( echo Login into target environment failed with error %ERROR_LEVEL%. goto :END )

echo Recreating Target Environmentcall epmautomate recreate -f IF %ERROR_LEVEL% NEQ 0 ( echo Recreate failed on target environment with error %ERROR_LEVEL%. goto :END )

echo Deleting Old Artifact Snapshot from the Target Environmentcall epmautomate deletefile "Artifact Snapshot" > NUL IF %ERROR_LEVEL% NEQ 0 ( IF %ERROR_LEVEL% NEQ 8 ( echo deletefile failed on target environment with error %ERROR_LEVEL% goto :END ) )

echo Copying Artifact Snapshot from the Source Environment to Target call epmautomate copysnapshotfrominstance "Artifact Snapshot" %sourceUser% %sourcePassword% %sourceURL% %sourceDomain%IF %ERROR_LEVEL% NEQ 0 (echo Login into target environment failed with error %ERROR_LEVEL%.goto :END)

echo Importing Snapshot into the Target Environmentcall epmautomate importsnapshot "Artifact Snapshot" userPassword=IDM_NEW_USER_PWD IF %ERROR_LEVEL% NEQ 0 ( echo Restore failed on target environment with error %ERROR_LEVEL%. goto :END )

echo Logging out from the Target Environmentcall epmautomate logout IF %ERROR_LEVEL% NEQ 0 ( echo Logout failed with error %ERROR_LEVEL%. goto :END )



echo Clone on target completed:printOnConsoleecho.echo %1echo.

:HELPecho.echo Usage : clone sourceUser sourcePasswordFile sourceURL sourceIDDomain targetUser targetPassword targetURL targetIDDomainecho All the values are mandatory for clone to executeexit /B 0

:ENDset returnValue=%ERROR_LEVEL%exit /B %returnValue%

Clonación de un entornoUtilice la secuencia de comandos de EPM Automate que se muestra en esta secciónpara clonar un entorno de forma manual.

Puede clonar un entorno por muchas razones. En este escenario se supone que va aclonar un entorno para ofrecer protección ante la pérdida de servicio. También sesupone que utiliza la instantánea de la aplicación creada en el entorno de origendurante el mantenimiento de servicio diario.

Requisitos previos

El dominio de identidad utilizado por el entorno que está clonando (origen) y elentorno que crea como clon (destino) deben utilizar un conjunto de asignaciones deusuarios y roles idéntico.

• Si el origen y el destino residen en el mismo centro de datos, deben compartir undominio de identidad.

• Si el origen y el destino no comparten un centro de datos, debe crearmanualmente el conjunto de asignaciones de roles y usuarios del origen en eldominio de identidad del destino.

Clonación de un entornoEn este escenario se utiliza la siguiente información de origen:

• URL: https://test-cloud-pln.pbcs.us1.oraclecloud.com

• Dominio de identidad: myprodIdentityDomain

Para clonar un entorno, ejecute comandos que realicen los pasos siguientes:

• Inicie sesión en el entorno de destino en el que desea establecer la clonaciónmediante el uso de las siguientes credenciales:

– Nombre de usuario: serviceAdmin

Se supone que serviceAdmin también se asigna al rol de administrador dedominio de identidad que permite a este usuario crear los nuevos usuarios alos que se hace referencia en la instantánea de artefactos.

– Archivo de contraseñas: C:/mySecuredir/password2.epw



Debe crear este archivo. Consulte el comando encrypt.

– URL: https://test-cloud-pln.pbcs.us2.oraclecloud.com

– Dominio de identidad: myNewIdentityDomain

• Vuelva a crear el entorno.

• Suprima Artifact Snapshot si está presente.

• Copie una instantánea Artifact Snapshot del entorno de origen en el entornode destino.

• Importe artefactos de Artifact Snapshot en el entorno y cree nuevos usuariosen el dominio de identidad.


epmautomate login serviceAdmin C:\mySecuredir\password2.epw https://test-cloud-pln.pbcs.us2.oraclecloud.com myNewIdentityDomainepmautomate recreate -fepmautomate deletefile "Artifact Snapshot"epmautomate copysnapshotfrominstance "Artifact Snapshot" C:\mySecuredir\password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com myprodIdentityDomainepmautomate importsnapshot "Artifact Snapshot" "userPassword=IDM_NEW_USER_PWDepmautomate logout

Eliminación de archivos innecesarios desde un entornoUtilice la secuencia de comandos de esta sección para eliminar archivos innecesariosde un entorno.

En este escenario, puede ejecutar una secuencia de comandos para completar estospasos:

• Inicie sesión en el entorno.

• Muestre los archivos y las instantáneas en el entorno.

• Suprima los archivos entitymetadata.csv de la bandeja de entrada/buzón desalida Backupsnapshot.zip desde el entorno.


epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com myIdentityDomainepmautomate listfilesepmautomate deletefile entitymetadata.csvepmautomate deletefile Backupsnapshot.zipepmautomate logout

Búsqueda y descarga de archivos de un entornoUtilice el script de ejemplo de esta sección para automatizar el proceso de descarga deuno o más archivos des de un entorno de Oracle Enterprise Performance ManagementCloud utilizando una cadena de texto como comodín.

El siguiente script le permite que coincida la cadena que se especifica como el valor delparámetro NOMBRE DE ARCHIVO con los nombres de archivo mostrados mediante elcomando listfile y, a continuación, podrá descargar automáticamente los archivosque coinciden con la cadena.



Asegúrese de asignar la cadena de búsqueda adecuada al parámetro FILENAME. Porejemplo, FILENAME="Scheduler Output/epm" coincidirá con la cadenaScheduler Output/epm en los nombres de archivo de la salida del comandolistfiles de su entorno para identificar los archivos que se van a descargar.

Los parámetros de entrada para ejecutar este script son username, password opassword_file, service_url y identity_domain.

Nota:

Si utiliza la versión en PDF de este documento: para evitar saltos de líneas einformación de pie de página que inutilizarán este script, cópielo de la VersiónHTML de este tema.

Windows

@echo off setlocal EnableExtensions EnableDelayedExpansion set USERNAME="username" set PASSWORD="password" set URL="url" set IDENTITY_DOMAIN="identity_domain_name"

call epmautomate login %USERNAME% %PASSWORD% %URL% %IDENTITY_DOMAIN% set FILENAME="Scheduler Output/epm" for /f "tokens=*" %%i in ('epmautomate listfiles ^| findstr ^ %FILENAME%') do ( call epmautomate downloadfile "%%i" )call epmautomate logoutendlocal

Linux/UNIX

#!/bin/sh USERNAME="username" PASSWORD="password" URL="url" IDENTITY_DOMAIN="identity_domain_name"

./epmautomate.sh login $USERNAME $PASSWORD $URL $IDENTITY_DOMAIN FILENAME='Scheduler Output/epm' #echo $FILENAME./epmautomate.sh listfiles | grep "^ $FILENAME" | while read -r line ; do echo "Processing $line" ./epmautomate.sh downloadfile "$line" done./epmautomate.sh logout

Recreación de un entorno antiguo de EPM Cloud para auditoríasUtilice el script de esta sección para crear una solución de autoservicio para manteneruna biblioteca actualizada de instantáneas para su entorno de Oracle EnterprisePerformance Management Cloud. Necesita un entorno dedicado al propósito deactualizar y mantener una biblioteca de instantáneas actualizadas.



EPM Cloud soporta la compatibilidad con instantáneas solo para un ciclo mensual.Puede migrar instantáneas de mantenimiento del entorno de prueba al de produccióny viceversa. Sin embargo, es posible que los requerimientos de auditoría de algunosclientes necesiten restaurar instantáneas de varios años en el entorno más reciente, yacceder a la aplicación en un periodo de tiempo breve.

Debe programar este script para que se ejecute una vez al mes a fin de convertir lasinstantáneas disponibles y hacerlas compatibles con el nivel de revisión más recientede EPM Cloud. Oracle recomienda que ejecute un script después del tercer viernes delmes para asegurarse de que todos los problemas del entorno de producción se hanresuelto.

Nota:

No puede usar este script para actualizar las instantáneas de AccountReconciliation y Oracle Enterprise Data Management Cloud

Funcionamiento del scriptPor cada instantánea que el cliente almacena, el script actualizado realiza estas tareasmediante el uso de EPM Automate:

1. Con la información del archivo input.properties, se conecta a un entorno.

2. Utiliza el comando recreate volver a crear el entorno.

3. Importa la instantánea en el entorno.

4. Ejecuta el mantenimiento diario en un entorno, lo que convierte la instantánea alformato compatible con el nivel de parche de EPM Cloud actual.

5. Descarga Artifact Snapshot (la instantánea de mantenimiento) en unacarpeta. Si ha recreado un entorno 18.05 cargando instantáneas de snapshots/18.05, Artifact Snapshot se descarga en snapshots/18.06.

Ejecución del script

1. Cree el archivo input.properties y actualícelo con información de su entorno.Guarde el archivo en un directorio local. Este directorio lo denominaremosparentsnapshotdirectory. El contenido de este archivo difiere según susistema operativo.

Asegúrese de que tiene privilegios de escritura en este directorio.

2. Cree el script upgradeSnapshots.ps1 (Windows) o upgradeSnapshots.sh(Linux/UNIX) y guárdelo en parentsnapshotdirectory, donde se ubicainput.properties.

3. Cree un subdirectorio, por ejemplo, snapshots, enparentsnapshotdirectory.

4. En el directorio que ha creado en el paso anterior (snapshots), cree unsubdirectorio para la instantánea mensual que desea convertir para hacerlacompatible con el nivel de parche de EPM Cloud actual. Asigne un nombre aldirectorio con el formato YY.MM; por ejemplo, 18.05 para el directorio en el quese almacenan las instantáneas de mayo de 2018.



5. Copie las instantáneas en el subdirectorio adecuado. Por ejemplo, copie lasinstantáneas de mayo de 2018 en snapshots/18.05.

6. Inicie el script. En Linux/UNIX, ejecute ./upgradeSnapshots.sh.

Nota: Si utiliza la versión en PDF de este documento: para evitar saltos delíneas e información de pie de página que inutilizarán estos scripts, cópielosde la Versión HTML de este tema.

Windows

Cree los scripts input.properties y upgradeSnapshots.ps1 copiando losscripts de esta sección.

Creación de input.properties

username=exampleAdminuserpassword=examplePasswordserviceurl=exapleURLidentitydomain=exampleDomainproxyserverusername=proxyServerUserNameproxyserverpassword=proxyPasswordproxyserverdomain=proxyDoaminparentsnapshotdirectory=C:/some_directory/snapshots

Actualización de input.properties

Nota:

Si authentication at proxy server no está activado para su entornode red de Windows, elimine las propiedades proxyserverusername,proxyserverpassword y proxyserverdomain del archivoinput.properties.

Tabla 3-4 Parámetros de input.properties

Parámetro Descripción

username Nombre de usuario de un administrador del servicio.

userpassword Contraseña del administrador de servicio.

serviceurl URL del entorno que se usa en esta actividad.

identitydomain Dominio de identidad del entorno.

proxyserverusername Nombre de usuario utilizado para autentificar una sesión seguracon el servidor proxy que controla el acceso a Internet.

proxyserverpassword Contraseña para autentificar el usuario con el servidor proxy.

proxyserverdomain Nombre del dominio definido para el servidor proxy.

parentsnapshotdirectory Ruta de acceso absoluta del directorio que se utilizará como eldirectorio padre del directorio en el que se almacenan lasinstantáneas que se van a procesar. Utilice barras inclinadas (/)como separadores de directorio.



https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/cepma/sample_script_10_snapsht_library.html

Creación de upgradeSnapshots.ps1

Utilice este script de ejemplo para crear upgradeSnapshots.ps1.

# Script for recreating an old EPM Cloud environment

# read in key/value pairs from input.properties file$inputproperties=ConvertFrom-StringData(Get-Content ./input.properties -raw)

# Global variables$parentsnapshotdirectory="$($inputproperties.parentsnapshotdirectory)"$username="$($inputproperties.username)"$userpassword="$($inputproperties.userpassword)"$serviceurl="$($inputproperties.serviceurl)"$identitydomain="$($inputproperties.identitydomain)"$proxyserverusername="$($inputproperties.proxyserverusername)"$proxyserverpassword="$($inputproperties.proxyserverpassword)"$proxyserverdomain="$($inputproperties.proxyserverdomain)"$operationmessage="EPM Automate operation:"$operationfailuremessage="EPM Automate operation failed:"$operationsuccessmessage="EPM Automate operation completed successfully:"$epmautomatescript="epmautomate.bat"

$workingdir="$pwd"$logdir="$workingdir/logs/"$logfile="$logdir/epmautomate-upgradesnapshots.log"

function LogMessage { $message=$args[0] $_mydate=$(get-date -f dd_MM_yy_HH_mm_ss)

echo "[$_mydate] $message" >> $logfile}

function LogAndEchoMessage{ $message=$args[0] $_mydate=$(get-date -f dd_MM_yy_HH_mm_ss)

echo "[$_mydate] $message" | Tee-Object -Append -FilePath $logfile}

function LogOutput{ $_mydate=$(get-date -f dd_MM_yy_HH_mm_ss) $op=$args[0] $opoutput=$args[1] $returncode=$args[2]

#If error if ($returncode -ne 0) { $failmessage="[$_mydate] $operationfailuremessage $op" LogMessage $failmessage LogMessage $opoutput LogMessage "return code: $returncode" } else { $successmessage="[$_mydate] $operationsuccessmessage $op" LogMessage $successmessage LogMessage $opoutput LogMessage "return code: $returncode" }



}

function ExecuteCommand{ $op=$args[0] $epmautomatecall="$epmautomatescript $op" $date=$(get-date -f dd_MM_yy_HH_mm_ss)

LogMessage "$operationmessage $epmautomatecall" $operationoutput=iex "& $epmautomatecall" >> $logfile 2>&1 LogOutput $op $operationoutput $LastExitCode}

function ProcessCommand{ $command=$args[0] $date=$(get-date -f dd_MM_yy_HH_mm_ss)

if (!([string]::IsNullOrWhitespace($command))) { if (!($command.StartsWith("#"))) { ExecuteCommand $command } }}


# removing existing epmautomate debug logs rm ./*.log

# remove existing log file rm $logfile}

function GetNextDate{ $latestyearmonth=$args[0] LogMessage "latest year.month: $latestyearmonth" $latestyear,$latestmonth=$latestyearmonth.split('\.') LogMessage "latest year: $latestyear" LogMessage "latest month: $latestmonth" $intlatestyear=[int]$latestyear $intlatestmonth=[int]$latestmonth

if ($intlatestmonth -eq 12) { $intnextmonth=1 $intnextyear=$intlatestyear+1 } else { $intnextmonth=$intlatestmonth+1 $intnextyear=$intlatestyear }

$nextyear="{0:D2}" -f $intnextyear $nextmonth="{0:D2}" -f $intnextmonth

echo "$nextyear.$nextmonth"



}

function ProcessSnapshot{ $snapshotfile=$args[0] LogMessage "snapshotfile: $snapshotfile" $nextdate=$args[1] LogMessage "nextdate: $nextdate" $snapshotfilename=$snapshotfile.split('/')[-1] LogMessage "snapshotfilename: $snapshotfilename" $snapshotname=$snapshotfilename.split('.')[0] LogMessage "snapshotname: $snapshotname"

ProcessCommand "login $username $userpassword $serviceurl $identitydomain $proxyserverusername $proxyserverpassword $proxyserverdomain" ProcessCommand "recreate -f" ProcessCommand "uploadfile $snapshotfile" ProcessCommand "importsnapshot $snapshotname" ProcessCommand "runDailyMaintenance -f skipNext=true" ProcessCommand "downloadfile 'Artifact Snapshot'" ProcessCommand "deletefile $snapshotname" ProcessCommand "logout"

$nextdatedirexists=Test-Path $parentsnapshotdirectory/$nextdate if (!($nextdatedirexists)) { mkdir $parentsnapshotdirectory/$nextdate 2>&1 | out-null }

LogMessage "Renaming 'Artifact Snapshot.zip' to $snapshotname.zip and moving to $parentsnapshotdirectory/$nextdate" mv $workingdir/'Artifact Snapshot.zip' $workingdir/$snapshotname.zip >> $logfile 2>&1 mv $workingdir/$snapshotname.zip $parentsnapshotdirectory/$nextdate >> $logfile 2>&1}

#----- main body of processingdateInitLogAndEchoMessage "Starting upgrade snapshots processing"$snapshotdirs=@(Get-ChildItem -Directory "$parentsnapshotdirectory" -name)LogMessage "snapshot directories: $snapshotdirs"$latestreleasedate=$snapshotdirs[-1]LogMessage "latest release date: $latestreleasedate"$latestreleasesnapshotdir="$parentsnapshotdirectory/$latestreleasedate"LogMessage "latest release snapshot dir: $latestreleasesnapshotdir"$nextdate=$(GetNextDate "$latestreleasedate")$snapshotfiles=@(Get-ChildItem -File "$latestreleasesnapshotdir")if ($snapshotfiles.length -eq 0) { LogAndEchoMessage "No snapshot files found in directory $latestreleasesnapshotdir. Exiting script." exit}foreach ($snapshotfile in $snapshotfiles) { LogAndEchoMessage "Processing snapshotfile: $snapshotfile" ProcessSnapshot $latestreleasesnapshotdir/$snapshotfile $nextdate}LogAndEchoMessage "Upgrade snapshots processing completed"date



Linux/UNIX

Cree upgradeSnapshots.sh y input.properties copiando los siguientes scripts.

Creación de input.properties para Linux/UNIX

Nota:

Si su red no está configurada para utilizar un servidor proxy para acceder aInternet, elimine las propiedades proxyserverusername,proxyserverpassword y proxyserverdomain del archivoinput.properties.

username=exampleAdminuserpassword=examplePasswordserviceurl=exapleURLidentitydomain=exampleDomainproxyserverusername=proxyserverpassword=proxyserverdomain=jdkdir=/home/user1/jdk160_35epmautomatescript=/home/exampleAdmin/epmautomate/bin/epmautomate.shparentsnapshotdirectory=/home/exampleAdmin/some_directory/snapshots

Actualización de input.properties

Tabla 3-5 Parámetros de input.properties


username Nombre de usuario de un administrador delservicio.

userpassword Contraseña del administrador de servicio.

serviceurl URL del entorno que se usa en esta actividad.

identitydomain Dominio de identidad del entorno.

proxyserverusername Nombre de usuario utilizado para autentificaruna sesión segura con el servidor proxy quecontrola el acceso a Internet.

proxyserverpassword Contraseña para autentificar el usuario con elservidor proxy.

proxyserverdomain Nombre del dominio definido para el servidorproxy.

jdkdir Ubicación JAVA_HOME.

epmautomatescript Ruta de acceso absoluta del ejecutable de EPMAutomate (epmautomate.sh).

parentsnapshotdirectory Ruta de acceso absoluta del directorio que seutilizará como el directorio padre del directorioen el que se almacena la instantánea que se va aprocesar.

Creación de upgradeSnapshots.sh



Utilice este script de ejemplo para crear upgradeSnapshots.sh.

#!/bin/sh

. ./input.propertiesworkingdir=$(pwd)logdir="${workingdir}/logs/"logfile=epmautomate-upgradesnapshots.logoperationmessage="EPM Automate operation:"operationfailuremessage="EPM Automate operation failed:"operationsuccessmessage="EPM Automate operation completed successfully:"logdebugmessages=true

if [ ! -d ${jdkdir} ]then echo "Could not locate JDK/JRE. Please set value for "jdkdir" property in input.properties file to a valid JDK/JRE location." exitfi

if [ ! -f ${epmautomatescript} ]then echo "Could not locate EPM Automate script. Please set value for "epmautomatescript" property in the input.properties file." exitfi

export JAVA_HOME=${jdkdir}

debugmessage() { # logdebugmessages is defined (or not) in testbase input.properties if [ "${logdebugmessages}" = "true" ] then logmessage "$1" fi}

logmessage() { local message=$1 local _mydate=$(date)

echo "[$_mydate] ${message}" >> "$logdir/$logfile"}

echoandlogmessage() { local message=$1 local _mydate=$(date)

echo "[$_mydate] ${message}" | tee -a ${logdir}/${logfile}}

logoutput(){ date=`date` op="$1" opoutput="$2" returncode="$3"

#If error



#if grep -q "EPMAT-" <<< "$2" if [ $returncode -ne 0 ] then failmessage="[${date}] ${operationfailuremessage} ${op}" logmessage "${failmessage}" logmessage "${opoutput}" logmessage "return code: ${returncode}" else successmessage="${operationsuccessmessage} ${op}" logmessage "${successmessage}" logmessage "${opoutput}" logmessage "return code: ${returncode}" fi}

getLatestReleaseSnapshotDir(){ local snapshotdirs=$(find ${parentsnapshotdirectory} -type d | sort) debugmessage "snapshot directories: ${snapshotdirs}" local latestreleasesnapshotdir=$(echo ${snapshotdirs##*$\n} | rev | cut -d' ' -f1 | rev) debugmessage "latest release snapshot dir: ${latestreleasesnapshotdir}" echo "${latestreleasesnapshotdir}"}

getNextDate(){ local thisyearmonth=$1 local thisyear=$(echo ${thisyearmonth} | cut -d'.' -f1) local thismonth=$(echo ${thisyearmonth} | cut -d'.' -f2)

intthismonth=$(bc <<< ${thismonth}) intthisyear=$(bc <<< ${thisyear})

if [ ${intthismonth} -eq 12 ] then local intnextmonth=1 local intnextyear=$((intthisyear+1)) else local intnextmonth=$((intthismonth+1)) local intnextyear=${intthisyear} fi nextmonth=$(printf "%02d\n" ${intnextmonth}) nextyear=$(printf "%02d\n" ${intnextyear})

debugmessage "next date: ${nextyear}.${nextmonth}"

echo "${nextyear}.${nextmonth}"}

init(){ if [ ! -d "$logdir" ] then mkdir $logdir fi

# removing existing epmautomate debug logs if ls ./*.log >/dev/null 2>&1 then



rm ./*.log fi

# remove existing log files if [ -f "${logdir}/${logfile}" ] then rm ${logdir}/${logfile} fi}

processCommand(){ op="$1" date=`date`

logmessage "$operationmessage $op" operationoutput=`eval "$epmautomatescript $op"` logoutput "$op" "$operationoutput" "$?"}

processSnapshot(){ local snapshotfile="$1" local nextdate="$2" local snapshotname=$(echo "${snapshotfile}" | rev | cut -d'/' -f1 | rev | cut -d'.' -f1)

processCommand "login ${username} ${userpassword} ${serviceurl} ${identitydomain} ${proxyserverusername} ${proxyserverpassword} ${proxyserverdomain}" processCommand "recreate -f" processCommand "uploadfile ${snapshotfile}" processCommand "importsnapshot \"${snapshotname}\"" processCommand "runDailyMaintenance -f skipNext=true" processCommand "downloadfile \"Artifact Snapshot\"" processCommand "deletefile \"${snapshotname}\"" processCommand "logout"

if [ ! -d ${parentsnapshotdirectory}/${nextdate} ] then mkdir ${parentsnapshotdirectory}/${nextdate} fi

logmessage "Renaming \"Artifact Snapshot.zip\" to ${snapshotname}.zip and moving to ${parentsnapshotdirectory}/${nextdate}" mv "${workingdir}/Artifact Snapshot.zip" "${workingdir}/${snapshotname}.zip" >> "$logdir/$logfile" 2>&1 mv "${workingdir}/${snapshotname}.zip" ${parentsnapshotdirectory}/${nextdate} >> "$logdir/$logfile" 2>&1}

#----- main body of processingdateechoandlogmessage "Starting upgrade snapshots processing"initlatestreleasesnapshotdir=$(getLatestReleaseSnapshotDir)latestreleasedate=$(echo "${latestreleasesnapshotdir}" | rev | cut -d'/' -f1 | rev)debugmessage "latest release date: ${latestreleasedate}"nextdate=$(getNextDate ${latestreleasedate})

snapshotfiles=$(find ${latestreleasesnapshotdir} -type f -name \*.zip | tr "\n" "|")if [ ${#snapshotfiles} -eq 0 ]



then echoandlogmessage "No snapshot files found in directory ${latestreleasesnapshotdir}"fi

IFS="|"for snapshotfile in $snapshotfilesdo echoandlogmessage "Processing snapshotfile: ${snapshotfile}" processSnapshot ${snapshotfile} ${nextdate}doneunset IFSechoandlogmessage "Upgrade snapshots processing completed."

Automatización de auditoría y conformidad sobre el acceso a la base de datosUtilice los scripts de PowerShell y Bash Shell de esta sección para usar los comandosde EPM Automate a fin de recopilar datos de auditoría y conformidad sobre el accesomanual a la base de datos.

Puede utilizar estos scripts para completar las siguientes tareas:

• Descargar el Informe de actividad para el día actual

• Analizar el informe para determinar si se ha registrado el acceso manual a la basede datos para el entono

• Crear ./reports/dataAccessAuditReport.txt relacionado con eldirectorio desde donde ejecuta el script. El informe muestra la hora de acceso a labase de datos y el comando SQL que se ha ejecutado. Se trata de un archivoacumulado, que muestra la información más reciente en la parte superior. Lainformación disponible incluye:

– La fecha y hora en la que se generó el informe

– Detalles del acceso a la base de datos, si están disponibles. El acceso a la basede datos sin una solicitud de servicio y el acceso a la base de datos consolicitud de servicio se muestran en secciones distintas.

Si no se registra el acceso manual a la base de datos en el Informe deactividad, el informe indica No SQL statements executed.

Si utiliza la versión en PDF de este documento: para evitar saltos de líneas einformación de pie de página que inutilizarán estos scripts, cópielos de la VersiónHTML de este tema.

Para automatizar la auditoría y la conformidad del acceso a la base de datos:

1. Copie uno de los scripts de las siguientes secciones en un archivo y guárdelo en elsistema de archivos. Asigne al archivo el nombre parseActivityReport.ps1(Windows) o parseActivityReport.sh (Linux/UNIX).

2. Solo para Windows: cree un archivo por lotes denominadoparseActivityReport.bat copiando el siguiente script en un archivo. Guardeel archivo en el directorio donde está almacenado parseActivityReport.ps1.

@echo offset epmuser="EPM_USER"set epmpwd="EPM_PASSWORD"set epmurl="EPM_URL"set epmidentitydomain="EPM_IDENTITY_DOMAIN"



https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/cepma/sample_script_12_data_access_audit_compliance.html

https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/cepma/sample_script_12_data_access_audit_compliance.html

set dirpath=%~dp0echo %dirpath:~0,-1%cd %dirpath:~0,-1%

PowerShell.exe -File parseActivityReport.ps1 %epmuser% %epmpassword% %epmurl% %epmidentitydomain%

set dirpath=%~dp0echo %dirpath:~0,-1%cd %dirpath:~0,-1%

PowerShell.exe -File parseActivityReport.ps1 %epmuser% %epmpassword% %epmurl% %epmidentitydomain%

3. Modifique parseActivityReport.bat (Windows) oparseActivityReport.sh (Linux/UNIX) para definir los valores de losparámetros de la siguiente tabla.

Tabla 3-6 Valores de variable que se deben incluir en los scripts


epmuser Nombre de usuario de un administradordel servicio.Ejemplos:

Windows: set epmuser="jDoe"

Linux/UNIX: epmuser="jDoe"

epmpassword Contraseña del administrador de servicio oubicación del archivo de contraseñacifrado. Consulte el comando encrypt paraobtener información sobre la creación dearchivos de contraseña cifrada.Ejemplos:

Windows: set epmpassword ="Example"

Linux/UNIX: epmpassword="Example"

epmurl URL del entorno de Oracle EnterprisePerformance Management Cloud.Ejemplos:

Windows: set epmurl="https://example.oraclecloud.com"

Linux/UNIX: epmurl="https://example.oraclecloud.com"

epmidentitydomain Nombre del dominio de identidad quepresta servicio al entorno.Ejemplos:

Windows: setepmidentitydomain="example"

Linux/UNIX:epmidentitydomain="example"

4. Solo para parseActivityReport.sh: asegúrese de que los siguientes valoresse han definido correctamente para el sistema:



• JAVA_HOME

• Ubicación de epmautomatescript.sh mediante la actualización del valorde la directiva epmautomatescript

5. Mediante un programador disponible en el sistema operativo, programeparseActivityReport.bat (que ejecuta parseActivityReport.ps1) oparseActivityReport.sh para que se ejecute una vez al día. Consulte Automatización de la ejecución de scripts.

Script de PowerShell (parseActivityReport.ps1)

# Parse Activity Report script

$epmuser=$args[0]$epmpassword=$args[1]$epmurl=$args[2]$epmidentitydomain=$args[3]

$logdir="./logs"$logfile="${logdir}/data_access.log"$reportdir="./reports"$reportfile="${reportdir}/dataAccessAuditReport.txt"$matchfile="${reportdir}/matchfile.txt"$nosrfile="${reportdir}/data_access_nosr.csv"$srfile="${reportdir}/data_access_sr.csv"$aprfilelist="${reportdir}/aprfilelist.txt"$activityreportfilelist="${reportdir}/activityreportfiles.txt"$activityreportregex='apr/[0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{2}_[0-9]{2}_[0-9]{2}/[0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{2}_[0-9]{2}_[0-9]{2}.html'

$global:activityreportfile=""

$NO_SQL_EXECUTED_STATEMENT="No SQL statements executed"$SQL_WITH_SR_EXECUTED_STATEMENT="SQL statements executed with an SR"$SQL_WITH_NO_SR_EXECUTED_STATEMENT="SQL statements executed without an SR"

function DownloadLatestActivityReport() { epmautomate.bat login ${epmuser} ${epmpassword} ${epmurl} ${epmidentitydomain} >> ${logfile} epmautomate.bat listfiles > ${aprfilelist} foreach ($line in Get-Content $aprfilelist) { if ($line -match $activityreportregex){ echo "$line" >> $activityreportfilelist } } $global:activityreportfile=Get-Content ${activityreportfilelist} -Tail 1 $global:activityreportfile=$global:activityreportfile.trim() echo " " echo "Processing activity report file: $global:activityreportfile" | tee -a ${logfile} epmautomate.bat downloadfile "$global:activityreportfile" >> ${logfile} epmautomate.bat logout >> ${logfile}}

function deleteLine($file, $start, $end) { $i = 0 $start-- $end-- (Get-Content $file) | where{ ($i -lt $start -or $i -gt $end)



$i++ } > $file #(Get-Content $file)}

function GenerateCsvs(){ $sqlregex='<DIV id="Database">.*?</DIV>' $activityreportfilename=Split-Path $global:activityreportfile -leaf

echo "Creating CSV file: ${matchfile} from data in activityreportfile: ${activityreportfilename}" >> ${logfile} # remove tab and newline characters $activityreportexists=Test-Path "$activityreportfilename" if ($activityreportexists) { (Get-Content "$activityreportfilename") -join ' ' | Set-Content "$activityreportfilename" (Get-Content "$activityreportfilename") -replace "`t", "" | Set-Content "$activityreportfilename" }

# capture text matching regex $string=Get-Content $activityreportfilename $ans=$string -match $sqlregex

if ($ans -eq "True") { $Matches.0 > $matchfile # remove HTML tags, etc. (Get-Content "$matchfile") -replace "<tr", "`n<tr" | Set-Content "$matchfile" (Get-Content "$matchfile") -replace "<tr[^>]*>", "" | Set-Content "$matchfile" (Get-Content "$matchfile") -replace "<th[^>]*>", "" | Set-Content "$matchfile" (Get-Content "$matchfile") -replace "<td[^>]*>", "|" | Set-Content "$matchfile" (Get-Content "$matchfile") -replace "<br>", "" | Set-Content "$matchfile" (Get-Content "$matchfile") -replace "</td>", "" | Set-Content "$matchfile" (Get-Content "$matchfile") -replace "</tr>", "" | Set-Content "$matchfile" (Get-Content "$matchfile") -replace "\s*</table>\s*</DIV>", "" | Set-Content "$matchfile" deleteLine $matchfile 1 2

# create SR, NOSR CSV files Get-Content $matchfile | ForEach-Object { $elements=$_.split('|') $timeval=$elements[1].Trim() $srval=$elements[3].Trim() $sqlval=$elements[4].Trim()

if (${srval} -eq "") { echo "${timeval}|${sqlval}" >> ${nosrfile} } else { if (${sqlval} -ne "") { echo "${srval}|${timeval}|${sqlval}" >> ${srfile} } } }

} else { # no SQL statements in activity report echo "" >> ${reportfile} echo $(date) >> ${reportfile}



echo "Processing activity report file: $global:activityreportfile" >> ${reportfile} echo "${NO_SQL_EXECUTED_STATEMENT}" | tee -a ${reportfile} CleanUp exit }}

function ReportResults() { echo $(date) >> ${reportfile} echo "Processing activity report file: $global:activityreportfile" >> ${reportfile} $srfileexists=Test-Path $srfile if ($srfileexists) { echo "" | tee -a ${reportfile} echo "${SQL_WITH_SR_EXECUTED_STATEMENT}" | tee -a ${reportfile} echo "SR# Time SQL Statement" | tee -a ${reportfile} echo "--- ---- -------------" | tee -a ${reportfile}

# Loop through csv file and parse Get-Content $srfile | ForEach-Object { $elements=$_.split('|') $srval=$elements[0] $timeval=$elements[1] $sqlval=$elements[2] echo "${srval} ${timeval} ${sqlval}" | tee -a ${reportfile} } }

$nosrfileexists=Test-Path $nosrfile if ($nosrfileexists) { echo "" | tee -a ${reportfile} echo "${SQL_WITH_NO_SR_EXECUTED_STATEMENT}" | tee -a ${reportfile} echo "Time SQL Statement" | tee -a ${reportfile} echo "---- -------------" | tee -a ${reportfile}

# Loop through csv file and parse Get-Content $nosrfile | ForEach-Object { $elements=$_.split('|') $timeval=$elements[0] $sqlval=$elements[1] echo "${timeval} ${sqlval}" | tee -a ${reportfile} } }}


$reportdirexists=Test-Path $reportdir if (!($reportdirexists)) { mkdir $reportdir 2>&1 | out-null }

$logfileexists=Test-Path $logfile if ($logfileexists) { rm $logfile 2>&1 | out-null



}

$matchfileexists=Test-Path $matchfile if ($matchfileexists) { rm $matchfile 2>&1 | out-null }

$nosrfileexists=Test-Path $nosrfile if ($nosrfileexists) { rm $nosrfile 2>&1 | out-null }

$srfileexists=Test-Path $srfile if ($srfileexists) { rm $srfile 2>&1 | out-null }

$aprfilelistexists=Test-Path $aprfilelist if ($aprfilelistexists) { rm $aprfilelist 2>&1 | out-null }

$activityreportfilelistexists=Test-Path $activityreportfilelist if ($activityreportfilelistexists) { rm $activityreportfilelist 2>&1 | out-null }}

function CleanUp{ $matchfileexists=Test-Path $matchfile if ($matchfileexists) { rm $matchfile 2>&1 | out-null }

$aprfilelistexists=Test-Path $aprfilelist if ($aprfilelistexists) { rm $aprfilelist 2>&1 | out-null }

$activityreportfilelistexists=Test-Path $activityreportfilelist if ($activityreportfilelistexists) { rm $activityreportfilelist 2>&1 | out-null }}

InitDownloadLatestActivityReportGenerateCsvsReportResultsCleanUp

Script de shell de Bash (parseActivityReport.sh)

#!/bin/sh

export JAVA_HOME=/scratch/dteHome/autoWork/jdk1.8.0_191epmautomatescript=/scratch/dteHome/autoWork/epmautomate/19.11.55/bin/epmautomate.sh

epmuser="<EPM USER>"



epmpwd="<EPM PASSWORD>"epmurl="<EPM URL>"epmidentitydomain="<EPM IDENTITY DOMAIN>"

logdir=./logslogfile="${logdir}/data_access.log"reportdir=./reportsreportfile="${reportdir}/dataAccessAuditReport.txt"nosrfile="${reportdir}/data_access_nosr.csv"srfile="${reportdir}/data_access_sr.csv"matchfile="${reportdir}/match.out"aprfilelist="${reportdir}/aprfilelist.txt"activityreportfile=""activityreportregex='apr/[0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{2}_[0-9]{2}_[0-9]{2}/[0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{2}_[0-9]{2}_[0-9]{2}.html'

NO_SQL_EXECUTED_STATEMENT="No SQL statements executed".SQL_WITH_SR_EXECUTED_STATEMENT="SQL statements executed with an SR"SQL_WITH_NO_SR_EXECUTED_STATEMENT="SQL statements executed without an SR"

cd "$(dirname "$0")"

generateCsvs(){ local sqlregex='<DIV id="Database">.*?</DIV>' local activityreportfilename=$(echo "${activityreportfile}" | rev | cut -d'/' -f1 | rev)

echo "Creating CSV file: ${matchfile} from data in activityreportfile: ${activityreportfilename}" >> ${logfile} # remove tab and newline characters cat "${activityreportfilename}" | tr -d "\t\n\r" > ${matchfile} # capture text matching regex grep -Po "${sqlregex}" ${matchfile} > ${matchfile}.tmp

# remove HTML tags, etc. sed -e 's/<tr/\n<tr/g' -e 's/<tr[^>]*>//g' -e 's/<th[^>]*>//g' -e 's/<td[^>]*>/|/g' -e 's/<br>//g' -e 's|</td>||g' -e 's|</tr>||g' -e 's|[ ]*</table></DIV>||g' -e 's/|[ ]*/|/g' -e 's/[ ]*|/|/g' -e 's/<DIV id="Database">.*\n//g' ${matchfile}.tmp > ${matchfile}

# create SR, NOSR CSV files while read line do timeval=$(echo "${line}" | cut -d'|' -f2) srval=$(echo "${line}" | cut -d'|' -f4) sqlval=$(echo "${line}" | cut -d'|' -f5)

if [[ "${srval}" == "" ]] then echo "${timeval}|${sqlval}" >> ${nosrfile} else if [[ "${sqlval}" != "" ]] then echo "${srval}|${timeval}|${sqlval}" >> ${srfile} fi fi done < ${matchfile}}

reportResults() {

echo $(date) >> ${reportfile} echo "Processing activity report file: $activityreportfile" >> ${reportfile} if [[ -f ${srfile} ]] then echo "" | tee -a ${reportfile} echo "${SQL_WITH_SR_EXECUTED_STATEMENT}" | tee -a ${reportfile} echo "SR# Time SQL Statement" | tee -a ${reportfile} echo "--- ---- -------------" | tee -a ${reportfile} while read line do srval=$(echo "${line}" | cut -d'|' -f1) timeval=$(echo "${line}" | cut -d'|' -f2) sqlval=$(echo "${line}" | cut -d'|' -f3) echo "${srval} ${timeval} ${sqlval}" | tee -a ${reportfile} done < ${srfile} fi

if [[ -f ${nosrfile} ]] then echo "" | tee -a ${reportfile} echo "${SQL_WITH_NO_SR_EXECUTED_STATEMENT}" | tee -a ${reportfile} echo "Time SQL Statement" | tee -a ${reportfile} echo "---- --- ---------" | tee -a ${reportfile} while read line do timeval=$(echo "${line}" | cut -d'|' -f1) sqlval=$(echo "${line}" | cut -d'|' -f2) echo "${timeval} ${sqlval}" | tee -a ${reportfile} done < ${nosrfile} fi

if [[ ! -f ${srfile} ]] && [[ ! -f ${nosrfile} ]] then echo "" | tee -a ${reportfile} echo "${NO_SQL_EXECUTED_STATEMENT}" | tee -a ${reportfile} fi}

downloadLatestActivityReport() { ${epmautomatescript} login ${epmuser} ${epmpwd} ${epmurl} ${epmidentitydomain} >> ${logfile} ${epmautomatescript} listfiles > ${aprfilelist} activityreportfile=$(cat ${aprfilelist} | grep -P "${activityreportregex}" | tail -n 1 | sed -e 's/^ //') echo " " echo "Processing activity report file: ${activityreportfile}" | tee -a ${logfile} ${epmautomatescript} downloadfile "${activityreportfile}" >> ${logfile} ${epmautomatescript} logout >> ${logfile}}

checkParams(){ if [ -z "$epmuser" ] then echo "Username is missing." echo "Syntax: parseActivityReport.sh USERNAME PASSWORD URL IDENTITYDOMAIN" exit 2 fi

if [ -z "$epmpwd" ] then



echo "Password is missing." echo "Syntax: parseActivityReport.sh USERNAME PASSWORD URL IDENTITYDOMAIN" exit 2 fi

if [ -z "$epmurl" ] then echo "URL is missing." echo "Syntax: parseActivityReport.sh USERNAME PASSWORD URL IDENTITYDOMAIN" exit 2 fi}

init(){ checkParams

if [ ! -d "${logdir}" ] then mkdir ${logdir} fi if [ ! -d "${reportdir}" ] then mkdir ${reportdir} fi

if [ ! -f "${epmautomatescript}" ] then echo "Cannot locate EPMAutomate script: ${epmautomatescript}. Please check setting and run script again. Exiting." | tee -a ${logfile} exit fi

if [ -f "${srfile}" ] then rm ${srfile} fi

if [ -f "${nosrfile}" ] then rm ${nosrfile} fi

if [ -f "${matchfile}" ] then rm ${matchfile} fi

if [ -f "${aprfilelist}" ] then rm ${aprfilelist} fi}

cleanup(){ if [ -f "${matchfile}" ] then rm ${matchfile} fi



if [ -f "${matchfile}.tmp" ] then rm ${matchfile}.tmp fi

if [ -f "${aprfilelist}" ] then rm ${aprfilelist} fi}

initdownloadLatestActivityReportgenerateCsvsreportResultscleanup

Escenarios de ejemplo para aplicaciones de planificación ypresupuestación, consolidación e informes de impuestos

Los scripts disponibles en esta sección le ayudan a automatizar las tareas en losentornos de Planning (incluidos los módulos de Planning), Financial Consolidationand Close y Tax Reporting.

• Automatización de la exportación de un gran número de celdas desde un cubo dealmacenamiento agregado

• Importación de metadatos en la aplicación

• Importación de datos, ejecución de un script de cálculo y copia de datos desdeuna base de datos de almacenamiento de bloques a una base de datos dealmacenamiento agregado

• Exportación y descarga de metadatos y datos

• Exportación y descarga de datos de aplicación

• Carga de un archivo de datos en un entorno y ejecución de una regla de carga dedatos

• Automatización de la integración de datos diaria

En esos escenarios, se utiliza una secuencia de comandos para realizar diversasactividades con EPM Automate. Se utilizan las siguientes credenciales ficticias parainiciar sesión en un entorno:






Escenarios de ejemplo para aplicaciones de planificación y presupuestación, consolidación e informes de impuestos


Automatización de la exportación de un gran número de celdas desde un cubo dealmacenamiento agregado

Utilice el script de PowerShell de esta sección para exportar un gran número de celdasdesde un cubo de almacenamiento agregado (ASO).

Debido a los límites impuestos por QUERYRESULTLIMIT de Essbase, es imposibleexportar una gran cantidad de datos desde la interfaz de usuario. Con el script dePowerShell disponible en esta sección se divide la operación de exportación en unnúmero especificado de trabajos, se ejecuta cada trabajo, se descargan los datosexportados y se concatenan los archivos de exportación en un archivo de exportación,lo que garantiza que solo haya una cabecera.

Nota:

• Con este script se ejecuta un trabajo existente del tipo Exportar datos. Paraobtener instrucciones detalladas sobre la creación de trabajo en Planning,consulte "Gestión de trabajos" en Administración de Planning.


1. Copie el siguiente script y guárdelo en su sistema de archivos, por ejemplo, comoASOCellExport.ps1.

$user = '<USERNAME>'$pass = '<PASSWORD>'$serverURL = '<URL>'$applicationName = '<APPLICATIONNAME>'$cubeName = '<CUBENAME>'$splitDimension = '<DIMENSION_TO_SPLIT_THE_EXPORT>'$topLevelMemberForExport = '<TOP_MEMBER_FOR_EXPORT>'$exportJobName = '<EXPORT_JOB_NAME>'$exportFilePrefix = '<PREFIX_FOR_EXPORT_FILE>'$columnMembers = '<MEMBERS_ON_COLUMNS>'$povMembers = '<POV_MEMBERS>'$numberOfExportFiles = <NUMBER_OF_FILES_TO_SPLIT_THE_EXPORT>

$memberArray = @()$exportFileArray = @()

function getLevel0 ($parent) { $parent.children.ForEach({ if ( $_.children.count -eq 0 ) { $script:memberArray += $_.name } getLevel0($_) })}

function findMember ($tree, $memberName) { $subtree = "" if ($tree.name -eq $memberName){ return $tree } else {



https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/cepma/sample_script_11_export_aso_cells.html

$tree.children.ForEach({ #Write-Host $_.name if ($subtree -eq ""){ $subtree = findMember $_ $memberName} }) return $subtree }}

#putting together base64 encoded authentication header based un user and password$encodedCredentials = [Convert]::ToBase64String([System.Text.Encoding]::ASCII.GetBytes($($user) + ":" + $($pass)))$headers = @{ Authorization = "Basic $encodedCredentials" }

#test login$testRequest = $serverURL + '/HyperionPlanning/rest/v3/applications'

try { $response = Invoke-RestMethod -Uri $testRequest -Method Get -Headers $headers -UseBasicParsing}catch { Write-Host $_ return}

#retrieve dimension hierarchy from application Write-Host "Retrieving member list for split dimension " $splitDimension$request = $serverURL + '/HyperionPlanning/rest/v3/internal/applications/' + $applicationName + '/plantypes/' + $cubeName + '/dimensions/' + $splitDimensiontry { $response = Invoke-RestMethod -Uri $request -Method Get -Headers $headers -UseBasicParsing}catch { Write-Host $_ return}Write-Host $splitDimension " member list retrieved"

#search for the top of the export hierarchyWrite-Host "Searching for member " $topLevelMemberForExport " in hierarchy"$member = findMember $response $topLevelMemberForExportif ( $member.name -ne $topLevelMemberForExport ) { Write-Host $topLevelMemberForExport " not found in hierarchy, exiting ..." return 128}Write-Host "Found member " $topLevelMemberForExport " in hierarchy"

#retrieve level 0 memebers in export hierarchyWrite-Host "Retrieving Level 0 members for hierarchy"getLevel0($member)if ( $memberArray.Length -eq 0 ) { Write-Host "no level 0 members found in hierarchy, exiting ..." return 128}Write-Host $memberArray.Length " Level 0 members for export hierarchy retrieved"

$request = $serverURL + '/HyperionPlanning/rest/v3/applications/' + $applicationName + '/jobs'



#splitting member list into the number of export files$numberOfEntitiesPerFile = [math]::truncate($memberArray.Length / $numberOfExportFiles)for ($i = 1; $i -le $numberOfExportFiles; $i++) { $memberList = "" $firstMember = ($i - 1) * $numberOfEntitiesPerFile if ($i -lt $numberOfExportFiles) { $lastMember = $i * $numberOfEntitiesPerFile } else { $lastMember = $i * $numberOfEntitiesPerFile + $memberArray.Length % $numberOfExportFiles } for ($j = $firstMember; $j -lt $lastMember; $j++) { $memberList += $memberArray[$j] if ($j -lt $lastMember - 1) {$memberList += ","} #avoid adding a comma (,) after the last member of each set }

$jobDetails=' { "jobType":"EXPORT_DATA","jobName":"' + $exportJobName + '", "parameters":{ "exportFileName":"Export-' + $i + '.zip", "rowMembers":"' + $memberList + '", "columnMembers":"' + $columnMembers + '", "povMembers":"' + $povMembers + '" } }'

#start export job try{ $response = Invoke-RestMethod -Uri $request -Method Post -Headers $headers -Body $jobDetails -ContentType "application/json"} catch { Write-Host $_ return }

Write-Host "Started export job " $i " out of " $numberOfExportFiles

#checking job status, continue once jos is completed $statusRequest = $serverURL + '/HyperionPlanning/rest/v3/applications/' + $applicationName + '/jobs/' + $response.jobId $statusResponse = Invoke-RestMethod -Uri $statusRequest -Method Get -Headers $headers -UseBasicParsing

while ( $statusResponse.descriptiveStatus -eq "Processing" ) { Write-Host $statusResponse.descriptiveStatus Start-Sleep -s 10 $statusResponse = Invoke-RestMethod -Uri $statusRequest -Method Get -Headers $headers -UseBasicParsing } Write-Host $statusResponse.descriptiveStatus

Write-Host "Downloading export file ..." $downloadRequest = $serverURL + '/interop/rest/11.1.2.3.600/applicationsnapshots/Export-' + $i + '.zip/contents' $statusResponse = Invoke-RestMethod -Uri $downloadRequest -Method Get -Headers $headers -OutFile "$exportFilePrefix-$i.zip"



Write-Host "Expanding archive ..." Expand-Archive -Force -LiteralPath "$exportFilePrefix-$i.zip" -DestinationPath "$exportFilePrefix-$i" Remove-Item "$exportFilePrefix-$i.zip"

Get-ChildItem -Path "$exportFilePrefix-$i" –File -Name | ForEach-Object { $exportFileArray += "$exportFilePrefix-$i\" + $_ }}

Write-Host "creating outputfile ..."#write header to outputfileGet-Content $exportFileArray[0] | Select-Object -First 1 | Out-File "$exportFilePrefix.csv"

#write content to outputfile skipping headerForEach ($exportFile in $exportFileArray) { Get-Content $exportFile | Select-Object -Skip 1 | Out-File -Append "$exportFilePrefix.csv"}

Compress-Archive -LiteralPath "$exportFilePrefix.csv" -DestinationPath "$exportFilePrefix.zip"

Write-Host "cleaning up ..."Remove-Item "$exportFilePrefix-*" -RecurseRemove-Item "$exportFilePrefix.csv"

2. Modifique el script de PowerShell, por ejemplo, ASOCellExport.ps1 paraestablecer los valores de los parámetros de la tabla siguiente.

Tabla 3-7 Valores de variables que se deben incluir en el script de PowerShell


$user Nombre de usuario de un administradordel servicio.Ejemplo: $user = 'jDoe'

$pass Contraseña del administrador de servicio oubicación del archivo de contraseñacifrado. Consulte el comando encrypt paraobtener información sobre la creación dearchivos de contraseña cifrada.Ejemplo: $pass = 'Example'

$serverURL URL del entorno de Oracle EnterprisePerformance Management Cloud que alojala aplicación de Planning.Ejemplo: $serverURL = 'https://example .oraclecloud.com'

$applicationName Nombre de una aplicación de Planning.Ejemplo: $applicationName ='Vision'

$cubeName Nombre de un cubo de la aplicación.Ejemplo: $cubeName = 'VisASO'



Tabla 3-7 (Continuación) Valores de variables que se deben incluir en el scriptde PowerShell


$splitDimension Nombre de una dimensión cuyosmiembros se usan para dividir laexportación en grupos.Ejemplo: $splitDimension ='Account'

$topLevelMemberForExport Nombre de un miembro de la subjerarquíade dimensiones en la que se crea una listade miembros de nivel 0.Ejemplo: $topLevelMemberForExport= 'Total Cash Flow'

$exportJobName Nombre de un trabajo existente del tipoExportar datos. La configuración especificaen este trabajo se sobrescribirá con losparámetros que establezca en el script.Ejemplo: $exportJobName = 'ASOCell Export'

$exportFilePrefix Prefijo de nombre de archivo paraidentificar de forma exclusiva los archivosgenerados por el trabajo de exportación.Ejemplo: $exportFilePrefix ='cashflow'

$columnMembers Columnas de miembros que incluir en laexportación.Ejemplo: $columnMembers ='Period'

$povMembers Punto de vista que incluir en laexportación. Los miembros de PDV debenincluir el resto de dimensiones y puedenincluir funciones como se muestra acontinuación:

ILvl0Descendants(YearTotal),ILvl0Descendants(Year),ILvl0Descendants(Scenario),ILvl0Descendants(Version),ILvl0Descendants(P_TP),ILvl0Descendants(AltYear)

Ejemplo: $povMembers = 'YTD'

$numberOfExportFiles Número de trabajos que ejecutar para estaoperación de exportación. Si la exportaciónsigue fallando debido a limitaciones de laconsulta, aumente este número.Ejemplo: $numberOfExportFiles = 3

3. Con el programador de Windows, programe el script de PowerShell, por ejemplo,ASOCellExport.ps1. Consulte Automatización de la ejecución de scripts paraobtener pasos detallados.



Importación de metadatos en la aplicaciónUtilice la secuencia de comandos que aparece en esta sección para importar metadatosde aplicación desde un archivo de forma manual.


• Inicie sesión en un entorno.

• Cargue el archivo de metadatos accounts.zip.

• Importe los metadatos desde accounts.zip en la aplicación con el trabajoaccountMetadata.

• Refresque el cubo.


epmautomate login serviceAdmin C:\mySecuredir\password.epw https://example.oraclecloud.com ExampleDomainepmautomate uploadfile accounts.zipepmautomate importmetadata accountMetadata accounts.zipepmautomate refreshcubeepmautomate logout

Importación de datos, ejecución de un script de cálculo y copia de datos desde unabase de datos de almacenamiento de bloques a una base de datos de almacenamientoagregado

Utilice la secuencia de comandos de esta sección para importar datos de un archivo,refrescar el cubo, ejecutar una regla de negocio para calcular el cubo y, a continuación,enviar los datos a un cubo ASO.



• Cargue un archivo data.csv.

• Importe los datos desde data.csv en la aplicación con el trabajoloadingq1data.

• Refresque el cubo.

• Ejecute la regla de negocio RevenueAllocation desplegada en el tipo de planRollupUSSales con las peticiones de datos en tiempo de ejecución Quarter=Q1Entity=USA para transformar los datos.

• Envíe los datos a una base de almacenamiento agregada con el trabajoCampaignToReporting.


epmautomate login serviceAdmin C:\mySecuredir\password.epw https://example.oraclecloud.com ExampleDomainepmautomate uploadfile data.csvepmautomate importdata loadingq1data data.csv



epmautomate refreshcubeepmautomate runbusinessrule RevenueAllocation Quarter=Q1 Entity=USAepmautomate runplantypemap CampaignToReporting clearData=trueepmautomate logout

Exportación y descarga de metadatos y datosUtilice la secuencia de comandos de esta sección para exportar metadatos y datos deaplicación y, a continuación, descargar los archivos de exportación en un directoriolocal.



• Exporte los metadatos en entityData.zip con el trabajoexportentitymetadata.

• Exporte los datos de la aplicación en forecastData.zip con el trabajoforecastdata.

• Muestre el contenido de la bandeja de entrada/buzón de salida de Planning.

• Descargue los archivos de datos exportados (exportentitydata.zip yforecastdata.zip) de la bandeja de entrada/buzón de salida de Planning enel equipo local.


epmautomate login serviceAdmin C:\mySecuredir\password.epw https://example.oraclecloud.com ExampleDomainepmautomate exportmetadata exportentitymetadata entityData.zipepmautomate exportdata forecastdata forecastData.zipepmautomate listfilesepmautomate downloadfile entityData.zipepmautomate downloadfile forecastData.zipepmautomate logout

Exportación y descarga de datos de aplicaciónUtilice la secuencia de comandos de esta sección para exportar datos de aplicación y, acontinuación, descargarlos en un directorio local.



• Cree copias de seguridad de datos (entitydata.zip y forecastdata.zip).

• Muestre los archivos en la bandeja de entrada o el buzón de salida para verificarque las copias de seguridad están presentes.

• Descargue (entitydata.zip y forecastdata.zip) en un equipo local.


epmautomate login serviceAdmin C:\mySecuredir\password.epw https://example.oraclecloud.com ExampleDomainepmautomate exportmetadata exportentitymetadata entityData.zip



epmautomate exportdata entitydata entitydata.zipepmautomate exportdata forecastdata forecastdata.zipepmautomate listfilesepmautomate downloadfile entityData.zipepmautomate downloadfile forecastData.zipepmautomate logout

Carga de un archivo de datos en un entorno y ejecución de una regla de carga de datosUtilice la secuencia de comandos de esta sección para cargar un archivo en un entornoy, a continuación, ejecutar una regla de datos para importar datos del archivo en unaaplicación.

Nota: Este escenario no se aplica a Oracle Enterprise Data ManagementCloud.

Requisitos previos

• Las siguientes definiciones en Data Management:

– Definición de regla de carga de datos denominada VisionActual. Sesupone que la regla de datos no especifica una ruta de archivo para el archivode entrada.

– Definiciones de periodos del Mar-15 al Jun-15

• Archivo de datos con el formato correcto (GLActual.dat) que contenga datos.

Importación de datos a Data Management y ejecución de una regla de carga dedatos

Para importar datos y ejecutar una regla de carga de datos, ejecute comandos pararealizar estos pasos:


• Cargue un archivo GLActual.dat que contenga datos para los periodos delMar-15 al Jun-15 en la carpeta inbox/Vision de Data Management.

• Importe los datos de GLActual.dat a Data Management utilizando la regla decarga de datos VisionActual, el periodo inicial Mar-15, el periodo finalJun-15 y el modo de importación REPLACE.

• Exporte los datos con la opción STORE_DATA para fusionar los datos de la tablatemporal de Data Management con los datos de Planning existentes.


epmautomate login serviceAdmin C:\mySecuredir\password.epw https://example.oraclecloud.com ExampleDomainepmautomate uploadfile GLActual.dat inbox/Visionepmautomate rundatarule VisionActual Mar-15 Jun-15 REPLACE STORE_DATA inbox/Vision/GLActual.datepmautomate logout



Automatización de la integración de datos diariaEn este escenario se explora el uso de un script de ejemplo para automatizar laintegración de datos periódica.

Cree un archivo de lote (.bat) o shell (.sh) que contenga un script similar alsiguiente para automatizar las actividades relacionadas con la integración de datos. Elsiguiente script de ejemplo para Windows automatiza la integración diaria de datos delas aplicaciones completando estas actividades:


• Suprima DailyPlanData si está presente.

• Cargue DailyPlanData en el servicio.

• Ejecute la regla de negocio Clear Plan Targets en el tipo de plan Plan1.

• Importe los datos con el nombre del trabajo LoadDailyPlan.

• Ejecute la regla de negocio Balance Sheet - Plan.

• Ejecute la regla de negocio Allocate Plan Targets.

• Suprima DailyTarget.zip si está presente.

• Exporte datos a DailyTarget.zip con el nombre de trabajoExportDailyTarget.

• Descargue DailyTarget.zip en el servidor y agregue la marca de tiempo.

• Desconéctese de Planning.

Nota:

• Si vuelve a planificar este script para utilizarlo, asegúrese de modificar losvalores de los parámetros SET url, SET user y SET domain. Además,puede modificar los valores de los parámetros dataimportfilename,dataexportfilename, importdatajobname, exportdatajobname,br_clear, br_calculatebalancesheet y br_allocatetargetpara ajustar los requisitos



@echo off

rem Sample Script to demonstrate daily data integration with rem Oracle Planning and Budgeting Cloud Services application.rem This script uploads Plan data, clears target numbers,.rem runs a business rule to calculate balance sheet data, and .rem recalculates target numbers on the Vision demo application



rem Please input the below parametersSET url=https://example.oraclecloud.comSET user=serviceAdminSET domain=ExampleDomainSET dataimportfilename=DailyPlanData.csvSET dataexportfilename=DailyTargetSET importdatajobname=LoadDailyPlanSET exportdatajobname=ExportDailyTargetSET br_clear=Clear Plan TargetsSET br_calculatebalancesheet=Balance Sheet - PlanSET br_allocatetarget=Allocate Plan Targets

SET password=%1

rem Executing EPM Automate commands

CD /D %~dp0call epmautomate login %user% %password% %url% %domain%IF %ERRORLEVEL% NEQ 0 goto :ERROR

for /f %%i in ('call epmautomate listfiles') do if %%i==%dataimportfilename% (call epmautomate deletefile %%i)IF %ERRORLEVEL% NEQ 0 goto :ERROR

call epmautomate uploadfile %dataimportfilename%IF %ERRORLEVEL% NEQ 0 goto :ERROR

call epmautomate runbusinessrule "%br_clear%"IF %ERRORLEVEL% NEQ 0 goto :ERROR

call epmautomate importdata "%importdatajobname%"IF %ERRORLEVEL% NEQ 0 goto :ERROR

call epmautomate runbusinessrule "%br_calculatebalancesheet%"IF %ERRORLEVEL% NEQ 0 goto :ERROR

call epmautomate runbusinessrule "%br_allocatetarget%" "TargetVersion=Baseline"IF %ERRORLEVEL% NEQ 0 goto :ERROR

for /f %%i in ('call epmautomate listfiles') do if %%i=="%dataexportfilename%.zip" (call epmautomate deletefile %%i)IF %ERRORLEVEL% NEQ 0 goto :ERROR

call epmautomate exportdata %exportdatajobname% "%dataexportfilename%.zip"IF %ERRORLEVEL% NEQ 0 goto :ERROR

call epmautomate downloadfile "%dataexportfilename%.zip"IF %ERRORLEVEL% NEQ 0 goto :ERROR

rem Section to rename the file

Set Timestamp=%date:~4,2%_%date:~7,2%_%date:~10,4%_%time:~1,1%%time:~3,2%%ren "%dataexportfilename%.zip" "%dataexportfilename%_%Timestamp%.zip"

call epmautomate logoutIF %ERRORLEVEL% NEQ 0 goto :ERROR

:EOFecho Scheduled Task Completed successfullyexit /b %errorlevel%



:ERRORecho Failed with error #%errorlevel%.exit /b %errorlevel%

Escenarios de ejemplo para Account ReconciliationEn estos escenarios, se analizan los comandos para realizar algunas tareas comunes deAccount Reconciliation.

Estos escenarios utilizan las siguientes credenciales ficticias para iniciar sesión en unentorno:




• URL de servicio: https://test-cloud-arcs.us1.oraclecloud.com

• Dominio de identidad: myARCSDomain

Carga de balances preformateados en un periodoEn este escenario, se enumeran los comandos para importar datos asignados de unarchivo cargado a un entorno de Account Reconciliation.



• Cargue los datos de balance con formato previo en Account Reconciliation desdeC:/Staging/April15Bal.csv, creado con una aplicación de libro mayor deterceros.

• Importe los datos asignados de April15Bal.csv a April 2015.

• Suprima April15Bal.csv de Account Reconciliation.


epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloud-arcs.us1.oraclecloud.commyARCSDomainepmautomate uploadfile “C:/Staging/ARMBalUpload.csv”epmautomate importpremappedbalances “April 2015” ARMBalUPload.csvepmautomate deletefile ARMBalUpload.csvepmautomate logout

Carga e importación de una instantánea de copia de seguridadEn este escenario, se enumeran los comandos para cargar una instantánea de copia deseguridad y, a continuación, importar artefactos de la instantánea a un entorno deAccount Reconciliation.

Requisitos previos

Se ha realizado una copia de seguridad de una instantánea diaria (por ejemplo,April15FullApp) de todos los artefactos y datos del servicio en un servidor local.

Escenarios de ejemplo para Account Reconciliation


Restauración de datos y artefactos


• Inicie sesión en un entorno con una cuenta que tenga los roles de administradordel servicio y administrador de dominio de identidad.

• Cargue la instantánea C:/dailybackups/April15FullApp, de la que se harealizado una copia de seguridad, en el servicio.

• Importe los artefactos y los datos de April15FullApp.

• Suprima April15FullApp.


epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloud-arcs.us1.oraclecloud.com myARCSDomainepmautomate uploadfile “C:/dailybackups/April15FullApp”epmautomate importsnapshot April15FullApp "userPassword=IDM_NEW_USER_PWD"epmautomate deletefile “April15FullApp”epmautomate logout

Escenarios de ejemplo para Profitability and Cost ManagementEn estos escenarios se analizan los comandos para realizar algunas tareas comunes deProfitability and Cost Management.

• Importación de metadatos en la aplicación

• Importación de datos y ejecución de reglas del programa

En esos escenarios, se utiliza una secuencia de comandos para realizar diversasactividades con EPM Automate. Se utilizan las siguientes credenciales ficticias parainiciar sesión en un entorno de ejemplo:






Importación de metadatos en la aplicaciónUtilice la secuencia de comandos de esta sección para cargar un archivo de metadatose importar metadatos del archivo en la aplicación de Profitability and CostManagement.



• Cargue el archivo de metadatos dimdata1.txt.

• Importe los metadatos de dimdata1.txt a la aplicación BksML12.

Escenarios de ejemplo para Profitability and Cost Management


• Active la aplicación.


epmautomate login serviceAdmin C:\mySecuredir\password.epw https://example.oraclecloud.com ExampleDomainepmautomate uploadfile "c:\profit_data\dimdata1.txt" profitinboxepmautomate loaddimdata BksML12 dataFileName=dimdata1.txtepmautomate enableapp BksML12epmautomate logout

Importación de datos y ejecución de reglas del programaUtilice la secuencia de comandos de esta sección para cargar archivos de datos eimportar datos desde los archivos cargados en una aplicación de Profitability and CostManagement.



• Cargue el archivo de datos c:\profit_data\profitdata1.txt enprofitinbox.

• Cargue el archivo de reglas c:\profit_data\rule1.txt en profitinbox.

• Cargue los datos de profitdata1.txt en la aplicación BksML12 parasobrescribir los valores existentes.

• Ejecute todas las reglas.


epmautomate login serviceAdmin C:\mySecuredir\password.epw https://example.oraclecloud.com ExampleDomainepmautomate uploadfile "c:\profit_data\profitdata1.txt" profitinboxepmautomate uploadfile "c:\profit_data\rule1.txt" profitinboxepmautomate loaddata BksML12 clearAllDataFlag=True dataLoadValue=”OVERWRITE_EXISTING_VALUES” rulesFileName=”rule1.txt” dataFileName=”profitdata1.txt”epmautomate logout

Escenarios de ejemplo para Oracle Enterprise Data Management CloudEn estos escenarios de ejemplo se explora el uso de comandos de EPM Automate parasincronizar dimensiones de aplicación entre Oracle Enterprise Data ManagementCloud y Oracle Enterprise Performance Management Cloud.

• Sincronización de dimensiones y asignaciones de Oracle Enterprise DataManagement Cloud con aplicaciones de EPM Cloud

• Sincronización de dimensiones de EPM Cloud con aplicaciones de OracleEnterprise Data Management Cloud

Escenarios de ejemplo para Oracle Enterprise Data Management Cloud


Nota:

• Necesita el rol Administrador del servicio para ejecutar los scripts de estasección.

• Los scripts de esta sección son para uso exclusivo en un entorno deWindows. Puede crear scripts similares para entornos de UNIX y Linux.

Parámetros para la ejecución de scripts

Los archivos de script de esta sección requieren que se especifiquen algunos de losvalores de parámetro que se explican en la siguiente tabla. No todos estos parámetrosse utilizan en todos los scripts.

Tabla 3-8 Valores de parámetro para archivos de script


EDMUSER Identificador de inicio de sesión de usuariode un administrador del servicio de OracleEnterprise Data Management Cloud.

Ejemplo: [email protected]

EDMSVR URL del entorno de Oracle Enterprise DataManagement Cloud.

Ejemplo: EDMSVR=https://example.oraclecloud.com

EDMDOMAIN Nombre del dominio que sirve al entorno deOracle Enterprise Data Management Cloud.

Ejemplo: EDMDOMAIN=edm_domain

EDMPWDFILE Nombre y ubicación del archivo decontraseña cifrado (EPW) del administradordel servicio de Oracle Enterprise DataManagement Cloud.

Ejemplo: EDMPWDFILE=edm_jdoe.epw

EDMAPP Nombre de una dimensión de aplicación deOracle Enterprise Data Management Cloud.

Ejemplo: EDMAPP=USOperations

EDMDIM Nombre de la dimensión que se va a exportaro importar.

Ejemplo: EDMDIM=entity

EDMLOC Nombre de la ubicación que se va a exportar.

Ejemplo: EDMLOC=Loc1

EPMUSER Nombre de inicio de sesión de unadministrador del servicio de EPM Cloud.

Ejemplo:[email protected]



Tabla 3-8 (Continuación) Valores de parámetro para archivos de script


EPMSVR URL del entorno de EPM Cloud.

Ejemplo: EPMSVR=https://example.oraclecloud.com

EPMDOMAIN Nombre del dominio que sirve al entorno deEPM Cloud.

Ejemplo: EPMDOMAIN=epm_domain

EPMIMPJOB Nombre de un trabajo de importaciónexistente del tipo import metadata en elentorno de EPM Cloud.

Ejemplo: EPMIMPJOB=imp_DIMMetadata

EPMEXPJOB Nombre de un trabajo existente del tipoexport metadata en el entorno de EPMCloud.

Ejemplo: EPMEXPJOB=Exp_DIMMetadata

PWDFILE Nombre y ubicación del archivo decontraseña cifrado (EPW) para eladministrador del servicio de EPM Cloud.

Ejemplo: PWDFILE=pwd_jdoe.epw

DIMFILE Nombre del archivo que va a contener losdatos de dimensión exportados.

Ejemplo: DIMFILE=entity_file.CSV

MAPFILE Nombre del archivo que va a contener losdatos de asignación exportados.

Ejemplo: MAPFILE=map_file.CSV

Sincronización de dimensiones y asignaciones de Oracle Enterprise Data ManagementCloud con aplicaciones de EPM Cloud

En este escenario de ejemplo se explora la sincronización de una dimensión entre unaaplicación de Oracle Enterprise Data Management Cloud y una aplicación de OracleEnterprise Performance Management Cloud.

Si utiliza la versión en PDF de este documento: para evitar saltos de líneas einformación de pie de página que inutilizarán el script, cópielo de la Versión HTML deeste tema.


• Exportar una dimensión desde una aplicación de Oracle Enterprise DataManagement Cloud

• Exportar asignaciones desde una dimensión de aplicación de Oracle EnterpriseData Management Cloud

• Copiar archivos de exportación a un entorno de EPM Cloud



https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/cepma/edmcs_scenarios_1_sync_edm_dim_with_epm.html

https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/cepma/edmcs_scenarios_1_sync_edm_dim_with_epm.html

• Importar metadatos y asignaciones de dimensión en una aplicación de EPMCloud

Para sincronizar una dimensión y asignaciones entre una aplicación de OracleEnterprise Data Management Cloud y una aplicación de EPM Cloud:

1. Cree un archivo de script copiando el siguiente script:

rem Integration example to sync application dimensions between EDM and EPM Cloudrem Windows script for demonstration purposes only; do not use in production environments

set EDMUSER=useridset EDMSVR=https://hostnameset EDMDOMAIN=exampleset EDMPWDFILE=example_EDMset EDMAPP=appnameset EDMDIM=dimnameset EDMLOC=location

set EPMUSER=useridset EPMSVR=https://hostnameset EPMDOMAIN=example_EPMset EPMIMPJOB=importjobnameset PWDFILE=C:\Oracle\EPM.epwset DIMFILE=dimension.csvset MAPFILE=mapping.csv

rem Synchronizing EDM ---> EPMrem Export Dimension and Mappings from EDM

epmautomate login %EDMUSER% %EDMPWDFILE% %EDMSVR% %EDMDOMAIN%epmautomate exportdimension %EDMAPP% %EDMDIM% %DIMFILE%epmautomate exportdimensionmapping %EDMAPP% %EDMDIM% %EDMLOC% %MAPFILE%epmautomate logout

rem Log into the EPM Cloud environmentepmautomate login %EPMUSER% %PWDFILE% %EPMSVR% %EPMDOMAIN%

rem Copy exported files from EDM environment to EPM and import metadata and mappingsepmautomate copyfilefrominstance %DIMFILE% %EDMUSER% %EDMPWDFILE% %EDMSVR% %EDMDOMAIN% inbox/%DIMFILE%epmautomate importmetadata %EPMIMPJOB%

epmautomate copyfilefrominstance %MAPFILE% %EDMUSER% %EDMPWDFILE% %EDMSVR% %EDMDOMAIN% inbox/%MAPFILE%epmautomate importmapping %EDMDIM% %MAPFILE% REPLACE FALSE %EDMLOC%

epmautomate logout

2. Modifique el archivo de script y defina los valores de parámetro necesarios.Consulte en la tabla de Escenarios de ejemplo para Oracle Enterprise DataManagement Cloud la explicación y el ejemplo de los distintos parámetros.

3. Ejecute el script de forma manual o prográmelo para que se ejecute según seanecesario. Consulte Automatización de la ejecución de scripts.



Sincronización de dimensiones de EPM Cloud con aplicaciones de Oracle EnterpriseData Management Cloud

En este escenario de ejemplo se explora la sincronización de una dimensión yasignaciones entre una aplicación de Oracle Enterprise Performance ManagementCloud y una aplicación de Oracle Enterprise Data Management Cloud.

Si utiliza la versión en PDF de este documento: para evitar saltos de líneas einformación de pie de página que inutilizarán el script, cópielo de la Versión HTML deeste tema.


• Exportar metadatos (dimensiones) desde una aplicación de EPM Cloud

• Copiar los archivos de exportación que contienen datos de dimensión en unentorno de Oracle Enterprise Data Management Cloud

• Importar metadatos de dimensión en la aplicación de Oracle Enterprise DataManagement Cloud

Para sincronizar una dimensión entre una aplicación de EPM Cloud y una aplicaciónde Oracle Enterprise Data Management Cloud:

1. Cree un archivo de script de Windows copiando el siguiente script:

rem Integration example to sync an application dimension between EPM Cloud and EDMrem Windows script for demonstration purposes only; do not use in production environments

set EDMUSER=useridset EDMSVR=https://hostnameset EDMPWDFILE=example_EDM.epwset EDMDOMAIN=exampleset EDMAPP=appnameset EDMDIM=dimname

set EPMUSER=useridset EPMSVR=https://hostnameset EPMDOMAIN=exampleset PWDFILE=example_epm.epwset EPMEXPJOB=exportjobname

rem Synchronizing EPM ---> EDMrem Export Metadata from EPMepmautomate login %EPMUSER% %PWDFILE% %EPMSVR% %EPMDOMAIN%epmautomate exportmetadata %EPMEXPJOB%epmautomate logout

rem Import Dimension to EDMrem log into the EDM environmentepmautomate login %EDMUSER% %EDMPWDFILE% %EDMSVR% %EDMDOMAIN%rem copy exported metadata file into the EDM environmentepmautomate copyfilefrominstance %EPMEXPJOB%.zip %EPMUSER% %PWDFILE% %EPMSVR% %EPMDOMAIN% %EPMEXPJOB%.zipepmautomate importdimension %EDMAPP% %EDMDIM% ReplaceNodes %EPMEXPJOB%.zipepmautomate logout



https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/cepma/edmcs_scenarios_2_sync_epmapp_dim_with_edm.html

https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/cepma/edmcs_scenarios_2_sync_epmapp_dim_with_edm.html

2. Modifique el archivo de script y defina los valores de parámetro necesarios.Consulte en la tabla de Escenarios de ejemplo para Oracle Enterprise DataManagement Cloud la explicación y el ejemplo de los distintos parámetros.

3. Ejecute el script de forma manual o prográmelo para que se ejecute según seanecesario. Consulte Automatización de la ejecución de scripts.

Automatización de la ejecución de scriptsUn administrador de servicio programa scripts en el programador de tareas deWindows o utiliza un trabajo cron para automatizar actividades con EPM Automate.

Para programar la ejecución de scripts de EPM Automate con el Programador detareas de Windows:

1. Haga clic en Inicio, en Panel de control y, a continuación, en Herramientasadministrativas.

2. Abra Programador de tareas.

3. Seleccione Acción y, a continuación, Crear tarea básica.

4. Introduzca un nombre de tarea y una descripción opcional y, a continuación, hagaclic en Siguiente.

5. En Disparador de tarea, seleccione un programa para ejecutar el script y, acontinuación, haga clic en Siguiente.

6. En la siguiente pantalla, especifique otros parámetros de programación y, acontinuación, haga clic en Siguiente.

7. En Acción, asegúrese de que está seleccionada la opción Iniciar un programa.

8. En Iniciar un programa, realice los siguientes pasos:

a. En Programa/script seleccione el script que desea programar.

b. En Agregar argumentos (opcional), introduzca la contraseña del administradorde servicio identificado por el parámetro de script SET user.

c. En Empezar en (opcional), introduzca la ubicación en la que está instalado EPMAutomate, normalmente, en C:/Oracle/EPMAutomate/bin.

d. Haga clic en Siguiente.

9. En Resumen, seleccione Abrir el diálogo Propiedades para esta tarea al hacer clicen Finalizar y, a continuación, haga clic en Finalizar.

10. En General, seleccione estas opciones de seguridad y, a continuación, haga clic enAceptar.

• Ejecutar si el usuario está o no conectado

• Ejecutar con los privilegios más altos

Supervisión de las actividades de EPM AutomatePara ayudarle a identificar el estado de la operación que ha inicializado, EPMAutomate muestra los códigos de estado en la consola desde la que la ejecuta.

Consulte Códigos de salida.

Automatización de la ejecución de scripts


Utilice la consola de trabajos de Planning para supervisar los trabajos que ejecutemediante el uso de EPM Automate. Consulte Gestión de trabajos en Administración dePlanning para obtener más información.

Supervisión de las actividades de EPM Automate


4Replicación de un entorno de EPM Cloud

Estos pasos están implicados en la configuración de un entorno secundario de OracleEnterprise Performance Management Cloud para garantizar la disponibilidad delservicio, si el centro de datos principal de Oracle deja de estar disponible debido acircunstancias imprevistas.

Nota:

Los procedimientos descritos en este apéndice no se pueden aplicar aNarrative Reporting.

• Configuración de la replicación de artefactos diaria

• Configuración de replicaciones a petición

• Configuración del entorno secundario

Configuración de la replicación diariaPara replicar un entorno, use EPM Automate para copiar la instantánea del artefactocreada durante el mantenimiento diario del entorno principal al entorno secundario.

Oracle realiza un mantenimiento rutinario en cada entorno de forma diaria. Duranteeste mantenimiento del servicio, Oracle crea una instantánea de mantenimientorealizando una copia de seguridad del contenido del entorno (datos y artefactosexistentes, incluidas las asignaciones de roles y usuarios del dominio de identidad).

Para configurar la replicación del servicio diaria:

1. Cree un archivo de script que contenga los siguientes comandos de EPMAutomate. Este script replica la instantánea de la aplicación del entorno principalen el entorno secundario.

Nota: Asegúrese de cambiar el nombre de usuario, el archivo de contraseñas,los nombres de dominio de identidad y las URL de servicio. Para obtener másinformación sobre la creación de un archivo de contraseñas cifrado, consulte elcomando encrypt.

REM Sign in to the secondary instanceepmautomate login serviceAdmin secondaryPassword.epw secondary_URL secondaryDomainREM Delete the existing artifact snapshotepmautomate deletefile "Artifact Snapshot"REM Copy the snapshot from the primary instanceepmautomate copysnapshotfrominstance "Artifact Snapshot" primaryPassword.epw primary_URL primaryDomain

Replicación de un entorno de EPM Cloud 4-1

REM Sign out of the secondary instanceepmautomate logout

2. Con un programador, por ejemplo, el programador de tareas de Windows,programe la ejecución del archivo de script para que se ejecute dos horas despuésdel inicio del periodo de mantenimiento.

3. Establezca una hora de inicio del periodo de mantenimiento idéntica en losentornos principal y secundario. Consulte Establecimiento del tiempo demantenimiento de servicio en Introducción a Oracle Enterprise PerformanceManagement Cloud para administradores para obtener más información.

Configuración de replicaciones a peticiónPara reducir el RPO, puede crear instantáneas del entorno principal a petición y, acontinuación, copiarlas en el entorno secundario.

Por ejemplo, puede crear y programar un script de EPM Automate que se ejecute cadaseis horas entre las replicaciones diarias para reducir el RPO de 24 a seis horas.

Nota: Durante la creación de instantáneas a petición, el entorno principal secoloca en modo de solo lectura durante unos minutos.

Para configurar la replicación a petición:

1. Cree un archivo de script que contenga los siguientes comandos de EPMAutomate. Este script replica la instantánea de la aplicación del entorno principalen el entorno secundario.

Nota: Asegúrese de cambiar el nombre de usuario, el archivo de contraseñas,los nombres de dominio de identidad y las URL de servicio. Para obtener másinformación sobre la creación de un archivo de contraseñas cifrado, consulte elcomando encrypt.

REM Sign in to the primary instanceepmautomate login serviceAdmin primaryPassword.epw primary_URL primaryDomainREM Create a snapshot and then sign outepmautomate exportsnapshot "Artifact Snapshot"epmautomate logoutREM Sign in to the secondary instanceepmautomate login serviceAdmin secondaryPassword.epw secondary_URL secondaryDomainREM Copy the snapshot from the primary instanceepmautomate copysnapshotfrominstance "Artifact Snapshot" primaryPassword.epw primary_URL primaryDomainREM Sign out of the secondary instanceepmautomate logout

2. Con un programador, por ejemplo, el programador de tareas de Windows,programe la ejecución del archivo de script para que se ejecute como sea necesariopara cumplir con el RPO que desee.

Configuración del entorno secundarioConfigure el entorno secundario para activarlo.

Configuración de replicaciones a petición


Realice este procedimiento solo si necesita activar el entorno secundario cuando elentorno principal no esté disponible durante un largo periodo.

Para configurar el entorno secundario:

1. Inicie una sesión de EPM Automate y realice estas actividades.

• Inicie sesión en el entorno secundario con una cuenta que tenga los roles deadministrador del servicio y administrador de dominio de identidad.Asegúrese de especificar el nombre de usuario, la contraseña, el nombre dedominio y la URL de servicio.

• Vuelva a crear el entorno.

• Importe artefactos de aplicación y dominio de identidad de la instantánea.


Puede realizar las actividades anteriores ejecutando los siguientes comandos.Consulte Comandos de EPM Automate para obtener más información sobre lossiguientes comandos:

epmautomate login serviceAdmin secondaryPassword.epw secondary_URL secondaryDomainepmautomate recreate –fepmautomate importsnapshot “Artifact Snapshot” "userPassword=IDM_NEW_USER_PWD"epmautomate logout

2. Conéctese al entorno secundario y verifique que todos los datos están disponibles.

3. Envíe la URL del entorno secundario a todos los usuarios.

Configuración del entorno secundario

Replicación de un entorno de EPM Cloud 4-3

Configuración del entorno secundario


APreparación para ejecutar el comando

replay

El comando replay se utiliza para probar el rendimiento de un entorno sometido a unacarga, con objeto de verificar que la experiencia de usuario es aceptable cuando elservicio tiene una carga especificada. Debe completar algunos pasos antes de realizarpruebas de carga en entornos.

En este apéndice se describen los pasos que los administradores de servicio debenrealizar antes de ejecutar el comando replay de EPM Automate.

• Acerca del comando replay

• Requisitos previos

• Creación de archivos HAR

• Creación de archivos de reproducción

• Generación de archivos de rastreo

• Sesión de reproducción de ejemplo

Acerca del comando replayEl comando replay reproduce la carga de Oracle Smart View for Office en un entornocon el fin de activar las pruebas de rendimiento si hay una carga muy elevada paraverificar que la experiencia de usuario es aceptable cuando el servicio tiene una cargaespecificada.

Por ejemplo, puede probar la experiencia de usuario en un entorno de prueba si hayuna carga muy elevada para asegurarse de que el servicio actuará correctamentedespués de migrar la aplicación del entorno de prueba al entorno de producción.

Requisitos previosAl ejecutar el comando con un archivo de reproducción, EPM Automate ejecuta cadafila del archivo de reproducción en paralelo para ejercer una carga en el servicio paraque pueda realizar pruebas y verificar que la experiencia del usuario es aceptablecuando el servicio tiene una carga.

• Identifique los formularios que necesitan un mayor procesamiento en el entorno.Los formularios que manejan grandes cantidades de datos, o los formularios queincluyen cálculos complejos, son buenos candidatos. Por ejemplo, los formulariosque se utilizan para enviar previsiones, procesos implicados en la creación deinformes y ad hoc y estáticos, pueden ejercer grandes cargas en el servicio.

• Instale Fiddler si es necesario. EPM Automate requiere un archivo de formatoHTTP Archive (HAR) 1.1 que contenga el registro de la interacción del explorador

Preparación para ejecutar el comando replay A-1

web con Oracle Smart View for Office. Utilice Fiddler para crear este archivo. Sino tiene Fiddler instalado, descargue e instale la versión más reciente de Fiddler.

• Ejecute las actividades principales que ha identificado anteriormente en una seriede formularios. Utilice Smart View para ejecutar las actividades y Fiddler paracapturar los detalles de las actividades y exportarlos a archivos HAR. Consulte Creación de archivos HAR para obtener información.

• Cree un archivo CSV de reproducción que muestre las credenciales (nombres deusuario y contraseñas) y el nombre de los archivos HAR que se van a ejecutar.Cada fila del archivo puede contener el nombre de usuario y la contraseña de unusuario único para simular varias sesiones de usuario simultáneas. Consulte Creación de archivos de reproducción para obtener información

El usuario cuyas credenciales se han especificado en una fila para ejecutar unarchivo HAR no tiene que ser el usuario que ha ejecutado la sesión de Smart Viewque se ha utilizado para crear el archivo HAR. Sin embargo, este usuario debetener los derechos para ejecutar estas actividades en el entorno.

Consulte Sesión de reproducción de ejemplo para obtener los pasos detallados paraejecutar el comando de reproducción.

Creación de archivos HAREl archivo HAR captura los rastreos de los procesos de Oracle Smart View for Officeque se ejecutan en el entorno.

Debido a que Fiddler captura información sobre todo el tráfico de HTTP(S), al crear losarchivos HAR, absténgase de realizar actividades que puedan agregar rastreosinnecesarios a Fiddler.

Para crear un archivo HAR:

1. Inicie Fiddler.

2. Asegúrese de que Fiddler está configurado para descifrar el tráfico de HTTPS detodos los procesos.

a. Seleccione Herramientas, a continuación Opciones y, por último, HTTPS.

b. Seleccione Descifrar tráfico HTTPS, si no está seleccionada.

Fiddler muestra información sobre el certificado raíz que utiliza para interceptarel tráfico de HTTPS. En general, es seguro confiar en este certificado.

Creación de archivos HAR

A-2 Oracle Cloud Trabajar con EPM Automate para Oracle Enterprise Performance Management Cloud

c. Haga clic en Sí si desea agregar el certificado raíz a la lista de CA de confianza;si no, seleccione No.

d. Opcional: si ha seleccionado No en el paso anterior, puede seleccionar Omitirerrores de certificado de servidor para suprimir las advertencias de seguridadde Fiddler relacionadas con el descifrado del tráfico de HTTPS.

e. Haga clic en Aceptar.

3. Inicie Smart View y acceda al entorno para el que desea capturar el rastreo.

4. En Smart View, abra los formularios o ejecute las actividades que ejercen una grancarga de procesamiento en el entorno.

Fiddler registra los procesos de Smart View que ha iniciado.



5. En Fiddler, realice estos pasos:

a. Seleccione Archivo, luego Exportar sesiones y, a continuación, Todaslas sesiones o Sesiones seleccionadas. Si se ha conectado a otrossitios web al ejecutar Fiddler, seleccione Sesiones seleccionadas paraelegir las sesiones relevantes para el entorno.

b. En Seleccionar formato de exportación, seleccione HTTPArchivev1.1 como formato de exportación.

c. Haga clic en Siguiente.

d. En Exportar como HTTPArchive v1.1, seleccione el directorio dondedesea almacenar el archivo y especifique un nombre de archivo.



e. Haga clic en Guardar.

Creación de archivos de reproducciónUn archivo de reproducción es un archivo CSV que muestra las credenciales (nombrede usuario y contraseña) y el nombre de los archivos HAR que se van a ejecutar paracargar el sistema mediante el comando replay de EPM Automate.

Asegúrese de que el nombre de usuario y la contraseña que especifique tienen losderechos necesarios para ejecutar las actividades incluidas en el archivo HAR.

Al ejecutar el comando de reproducción, EPM Automate ejecuta cada fila en el archivode reproducción en paralelo para ejercer una carga en el servicio. Por ejemplo, si elarchivo de reproducción contiene 10 filas, EPM Automate reproduce 10 sesiones paraque pueda realizar pruebas y verificar que la experiencia del usuario es aceptablecuando el servicio tiene una carga especificada. Cada actividad incluida en el archivoHAR se ejecuta en serie.

Consulte Comandos de EPM Automate para obtener más información sobre laejecución del comando de reproducción.

Para crear un archivo de reproducción:

1. Abra Microsoft Office Excel e inicie una nueva hoja de trabajo.

2. Introduzca un nombre de usuario, la contraseña y la ubicación de un archivo HARen las columnas A, B y C respectivamente de la fila 1.

Repita este paso para crear filas adicionales.

Nota: Debe especificar la ruta absoluta a la ubicación del archivo HAR.Utilice la barra (/) como separador de directorio en rutas de archivo. Noutilice barras diagonales inversas (\).

3. Guarde el archivo.

4. En Guardar como, realice estos pasos:

a. Seleccione el directorio donde desea almacenar el archivo de reproducción.

b. En Nombre de archivo, especifique un nombre y, en Guardar como tipo,seleccione CSV (separado por comas) (*.csv).

c. Haga clic en Guardar.

Un archivo de reproducción de ejemplo puede ser el siguiente:

Creación de archivos de reproducción


Generación de archivos de rastreoAl ejecutar el comando replay, puede generar archivos de rastreo para compartir conlos Servicios de Soporte Oracle para solucionar los problemas. Los Servicios deSoporte Oracle utilizan los archivos de rastreo para comprender cómo el entorno hamanejado una actividad de Oracle Smart View for Office.

Utilice el parámetro trace=true opcional con el comando replay para generar losarchivos de rastreo en formato XML. Si utiliza este parámetro, por cada actividad en elarchivo HAR, EPM Automate crea un archivo de rastreo que contiene la respuesta deSmart View a la actividad.

Los archivos de rastreo se denominan trace-N.xml; por ejemplo, trace-1.xml,donde N es un contador que comienza en 1. Si se especifican varios archivos HAR connombres idénticos en el archivo de reproducción, EPM Automate consolida losarchivos de rastreo en una carpeta.

Los archivos de rastreo relacionados con un archivo HAR están almacenados en unacarpeta en el directorio desde el que ejecuta EPM Automate. EPM Automate crea unacarpeta para cada archivo HAR que aparece en el archivo de reproducción. EPMAutomate usa una combinación de hora del sistema del servidor actual y nombre delarchivo HAR con formato AAAA_MM_DD_HH_MM_SS_NOMBRE_ARCHIVO_HAR paraasignar un nombre a las carpetas. Por ejemplo, si el nombre del archivo HAR esforecast1.har, el nombre de la carpeta puede ser2016_06_08_10_21_42_forecast1.

Sesión de reproducción de ejemploDescribe cómo ejecutar el comando replay utilizando varios archivos HAR.

En esta sección se da por hecho lo siguiente:

• Ha creado los siguientes archivos HAR. Cada archivo HAR puede contener elmismo conjunto de actividades. Consulte Creación de archivos HAR para obtenerinformación detallada.

– C:\Oracle\EPM Automate\forecast_vision_plan1.har

– C:\Oracle\EPM Automate\forecast_vision_plan2.har

– C:\Oracle\EPM Automate\forecast_plan2.har

• Ha creado un archivo de reproducción C:/Oracle/EPM Automate/vision_forecast_replay.csv con el siguiente contenido (consulte Creaciónde archivos de reproducción para obtener más información):

Nota:

Utilice la barra (/) como separador de directorio en rutas de archivo delarchivo de reproducción. No utilice barras diagonales inversas (\).

[email protected],examplePwd,C:/Oracle/EPM Automate/[email protected],examplePwd,C:/Oracle/EPM Automate/[email protected],examplePwd,C:/Oracle/EPM Automate/forecast_plan2.har

Para ejecutar el comando replay:

Generación de archivos de rastreo


1. En la ventana del símbolo del sistema, navegue al directorio; por ejemplo, C:\Oracle\EPM Automate\bin, donde está instalado EPM Automate.

2. Conéctese a un entorno como administrador del servicio y, a continuación, ejecuteel comando replay:

epmautomate login [email protected] examplePasswordhttps://test-cloud-pln.pbcs.us1.oraclecloud.commyIdentityDomain

epmautomate replay "c:/Oracle/EPM Automate/vision_forecast_replay.csv" duration=12 lagTime=4 trace=true

EPM Automate muestra información de reproducción en la consola y termina elprocesamiento después de la duración especificada (12 minutos en el ejemploanterior). También crea los archivos y carpetas de rastreo porque el comandoanterior incluye el parámetro trace=true.

Debido a que el comando se ha ejecutado desde C:\Oracle\EPM Automate\bin, EPM Automate ha almacenado los archivos de rastreo en las siguientescarpetas. Tenga en cuenta que estas carpetas se denominan según los nombres delos archivos HAR.

• C:\Oracle\EPM Automate\bin\[email protected]



3. Desconéctese del entorno:

epmautomate logout

Sesión de reproducción de ejemplo


Sesión de reproducción de ejemplo


BManejo de caracteres especiales

Los valores de contraseñas, contraseñas de proxy y parámetros de comando de OracleEnterprise Performance Management Cloud pueden contener caracteres especiales. Esnecesario aplicar un tratamiento especial a EPM Automate para que admita estoscaracteres.

En los ejemplos de esta sección se usa el comando encrypt para demostrar el uso delos caracteres especiales.

Oracle recomienda que incluya los pares de valores y parámetros entre comillasdobles.

Windows

Estos caracteres especiales se deben identificar con comillas dobles (") junto al carácterespecial o junto al valor de parámetro que contiene el carácter especial.

• " (comillas dobles). Para cifrar Example"pwd1, use epmautomate encryptExample""""pwd1 mykey exampleFile.epw o epmautomate encrypt"Example""pwd1" mykey exampleFile.epw

• & (ampersand). Para cifrar Example&pwd1, use epmautomate encryptExample"&"pwd1 mykey exampleFile.epw o epmautomate encrypt"Example&pwd1" mykey exampleFile.epw.

• ) (paréntesis de cierre). Para cifrar Example)pwd1, use epmautomate encryptExample")"pwd1 mykey exampleFile.epw o epmautomate encrypt"Example)pwd1" mykey exampleFile.epw.

UNIX/LinuxEn los sistemas operativos UNIX y Linux, en estos caracteres especiales se debe usaruna barra invertida (\)

• " (comillas dobles). Para cifrar Example"pwd1, use epmautomate encryptExample\"pwd1 mykey exampleFile.epw o epmautomate encrypt"Example\"pwd1" mykey exampleFile.epw

• ' (comillas simples). Para cifrar Example'pwd1, use epmautomate encryptExample\'pwd1 mykey exampleFile.epw o epmautomate encrypt"Example\'pwd1" mykey exampleFile.epw

• $ (signo de dólar). Para cifrar Example$pwd1, use epmautomate encryptExample\$pwd1 mykey exampleFile.epw o epmautomate encrypt"Example\$pwd1" mykey exampleFile.epw

• \ (barra diagonal inversa). Para cifrar Example\pwd1, use epmautomateencrypt Example\\pwd1 mykey exampleFile.epw o epmautomateencrypt "Example\\pwd1" mykey exampleFile.epw

Manejo de caracteres especiales B-1

B-2 Oracle Cloud Trabajar con EPM Automate para Oracle Enterprise Performance Management Cloud

Download - Trabajar con EPM Automate para Oracle Enterprise ... · Outlook, Visual Studio, Visual Basic, Internet Explorer, Active Directory y SQL Server son marcas comerciales registradas o

Top Related