Oracle® Cloud Trabajo con EPM Automate para Oracle Enterprise Performance Management Cloud E75508-01 Oracle Cloud Trabajo con EPM Automate para Oracle Enterprise Performance Management Cloud , E75508-01 Copyright © 2016, Oracle and/or its affiliates. All rights reserved. Primary Author: EPM Information Development Team Este software y la documentación relacionada están sujetos a un contrato de licencia que incluye restricciones de uso y revelación, y se encuentran protegidos por la legislación sobre la propiedad intelectual. A menos que 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, publicar ni 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 para conseguir 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 se garantiza que se encuentre exenta de errores. Si detecta algún error, le agradeceremos que nos lo comunique por escrito. Si este software o la documentación relacionada se entrega al Gobierno de EE. UU. o a cualquier entidad que adquiera licencias en nombre del Gobierno de EE. UU. se aplicará la siguiente disposición: U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any 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 are granted to the U.S. Government. Este software o hardware se han desarrollado para uso general en diversas aplicaciones de gestión de la informació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 en aplicaciones de riesgo, usted será responsable de tomar todas las medidas apropiadas de prevención de fallos, copia de seguridad, redundancia o de cualquier otro tipo para garantizar la seguridad en su uso. Oracle Corporation y sus filiales declinan toda responsabilidad derivada de los daños causados 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 nombres pueden ser marcas comerciales de sus respectivos propietarios. Intel e Intel Xeon son marcas comerciales o marcas comerciales registradas de Intel Corporation. Todas las marcas comerciales de SPARC se utilizan con licencia y son marcas comerciales o marcas comerciales registradas de SPARC International, Inc. AMD, Opteron, el logotipo de AMD y el logotipo de AMD Opteron son marcas comerciales o marcas comerciales registradas de Advanced Micro Devices. UNIX es una marca comercial 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 marcas comerciales registradas o marcas comerciales de Microsoft Corporation en los Estados Unidos y/o en otros países. Este software o hardware y la documentación pueden ofrecer acceso a contenidos, productos o servicios de terceros o información sobre los mismos. Ni Oracle Corporation ni sus filiales serán responsables de ofrecer cualquier tipo de garantía sobre el contenido, los productos o los servicios de terceros y renuncian explícitamente a ello, a menos que se indique otra cosa en un acuerdo en vigor formalizado entre Ud. y Oracle. Oracle Corporation y sus filiales no se harán responsables de las pérdidas, los costos o los daños en los que se incurra como consecuencia del acceso o el uso de contenidos, productos o servicios de terceros, a menos que se indique otra cosa en un acuerdo en vigor formalizado entre Ud. y Oracle. Contents Accesibilidad a la documentación ........................................................................................................... v Comentarios sobre la documentación ................................................................................................ vii 1 2 Acerca de la utilidad EPM Automate Instalación de la utilidad ......................................................................................................................... 1-1 Windows............................................................................................................................................ 1-2 Linux/UNIX...................................................................................................................................... 1-2 Referencia de comandos Comandos de la utilidad EPM Automate aplicables a todos los servicios ...................................... 2-1 Comandos específicos de Oracle Planning and Budgeting Cloud .................................................... 2-7 Comandos específicos de Integrations ................................................................................................ 2-12 Comandos específicos de Oracle Account Reconciliation Cloud .................................................... 2-15 Códigos de estado................................................................................................................................... 2-18 Ejecución de la utilidad EPM Automate ............................................................................................. 2-18 Windows.......................................................................................................................................... 2-18 Linux ................................................................................................................................................ 2-19 Ejecución de varias instancias de la utilidad.............................................................................. 2-20 3 Escenarios de ejemplo de ejecución de comandos Escenarios de ejemplo de Oracle Planning and Budgeting Cloud .................................................... 3-1 Escenario 1: importación de metadatos en la aplicación ............................................................ Escenario 2: importación de datos, ejecución de un script de cálculo y copia de datos desde una base de datos de almacenamiento de bloques a una base de datos de 3-2 almacenamiento agregado......................................................................................................... 3-2 Escenario 3: exportación y descarga de metadatos y datos ....................................................... 3-3 Escenario 4: eliminación de los archivos necesarios desde una instancia de servicio ........... 3-3 Escenario 5: Archivado de copias de seguridad del servicio de forma local........................... 3-3 Escenario 6: Clonación de una instancia de servicio................................................................... Escenario 7: Importación de datos a Integrations, ejecución de una regla de carga de 3-4 datos y exportación de datos a Planning................................................................................. 3-5 iii Escenario 8: Automatización de descargas de instantáneas de aplicaciones .......................... 3-6 Escenario 9: Automatización de la integración de datos diaria................................................. 3-7 Escenario 10: Automatización de la clonación de instancias ..................................................... 3-9 Escenarios de ejemplo de Oracle Account Reconciliation Cloud .................................................... 3-11 Escenario 1: Carga de balances preformateados en un periodo.............................................. 3-11 Escenario 2: Uso de una instantánea para la recuperación de un bloqueo............................ 3-12 Automatización de la ejecución de scripts .......................................................................................... 3-12 Supervisión de actividades de la utilidad EPM Automate............................................................... 3-13 iv Accesibilidad a la documentación Para obtener información acerca del compromiso de Oracle con la accesibilidad, visite el sitio web del Programa de Accesibilidad de Oracle en http://www.oracle.com/pls/ topic/lookup?ctx=acc&id=docacc. Acceso al soporte de Oracle Los clientes de Oracle que hayan adquirido soporte disponen de acceso a soporte electró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. v Comentarios sobre la documentación Envíe sus comentarios sobre esta documentación a: [email protected] 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 Google+: https://plus.google.com/106915048672979407731/ #106915048672979407731/posts YouTube: https://www.youtube.com/user/EvolvingBI vii 1 Acerca de la utilidad EPM Automate La utilidad EPM Automate permite a los administradores de servicio realizar tareas en las instancias de servicio de manera remota. Permite a los administradores de servicio automatizar muchas tareas repetibles, incluidas las siguientes: • Importe y exporte metadatos y datos • Refrescar la aplicación • Ejecutar reglas de negocio en los datos • Copiar datos de una base de datos a otra; por lo general, desde una base de datos de almacenamiento de bloques a una base de datos de almacenamiento agregada o desde una base de datos de almacenamiento de bloques a otra base de datos de almacenamiento de bloques • Cargar archivos en instancias de servicio, mostrar archivos y suprimir archivos del servicio • Ejecutar una regla de lote de Integrations y obtener el archivo de registro de salida • Exportar e importar instantáneas de aplicaciones y artefactos • Importar datos de balance preasignados a Oracle Account Reconciliation Cloud • Importar tipos de cambio, transacciones preasignadas y perfiles a Oracle Account Reconciliation Cloud • Copiar perfiles en un periodo para iniciar el proceso de conciliación Puede crear scripts que sean capaces de realizar una amplia serie de tareas y automatizar su ejecución mediante un programador. Por ejemplo, puede crear un script para descargar la copia de seguridad de mantenimiento diaria de las instancias de servicio y crear copias de seguridad locales de los artefactos y los datos. Descripción general en vídeo de la utilidad de automatización de EPM Tutorial: Cómo ejecutar tareas de Oracle Planning and Budgeting Cloud con la utilidad EPM Automate Instalación de la utilidad El instalador de la utilidad EPM Automate para Windows y Linux/UNIX está disponible en el servicio. Acerca de la utilidad EPM Automate 1-1 Instalación de la utilidad Note: Esta utilidad solo está soportada en clientes de 64 bits de sistemas operativos admitidos. La utilidad EPM Automate utiliza la configuración de proxy especificada en el equipo. No obstante, la utilidad no funciona si está activada la autentificación en el servidor proxy para la red. Windows De forma predeterminada, la utilidad EPM Automate se instala en C:/Oracle/EPM Automate. Para instalar la utilidad: 1. En el equipo con Windows donde desea instalar la utilidad, obtenga acceso a una instancia de servicio. 2. En la página inicial, pulse o haga clic en Navegador. 3. En Instalaciones, haga clic en EPM Automate (para Windows). 4. Guarde el instalador en el equipo. 5. Haga clic con el botón derecho en el instalador (EPM Automate.exe) y seleccione Ejecutar como administrador. 6. En Control de cuentas de usuario, haga clic en Sí. 7. Siga las peticiones de datos en pantalla para completar la instalación. Linux/UNIX Para instalar la utilidad: 1. Acceda a una instancia de servicio. 2. En la página inicial, pulse o haga clic en Navegador. 3. En Instalaciones, haga clic en EPM Automate (para Linux/Unix). 4. Guarde el instalador (EPMAutomate.tar) en un directorio en el que tenga privilegios de lectura/escritura/ejecución. 5. Con un comando como el siguiente, extraiga el contenido del installer: tar -xvf EPMAutomate.tar 1-2 Trabajo con EPM Automate para Oracle Enterprise Performance Management Cloud 2 Referencia de comandos La información necesaria para ejecutar la utilidad se organiza en función del servicio con el que trabaje. Por lo general, para trabajar con un servicio, debe consultar dos secciones: la sección general y la específica del servicio. • Comandos de la utilidad EPM Automate aplicables a todos los servicios • Comandos específicos de Oracle Planning and Budgeting Cloud • Comandos específicos de Integrations • Comandos específicos de Oracle Account Reconciliation Cloud Comandos de la utilidad EPM Automate aplicables a todos los servicios Todos los servicios utilizan los comandos de la utilidad EPM Automate descritos en esta sección. Debe ser administrador de servicio para ejecutar estos comandos. • De manera predeterminada, los archivos que cargue en un servicio se almacenan en el buzón/buzón de salida. Puede examinar el buzón/buzón de salida con el explorador de buzón/buzón de salida de Oracle Hyperion Planning. • Si desea procesar un archivo con Integrations, debe cargarlo en la carpeta repository del buzón/buzón de salida. Utilice el explorador de archivos para buscar estos archivos; no puede obtener acceso a ellos con el explorador de buzón/ buzón de salida. • Las instantáneas de la aplicación que cree con la utilidad no aparecen en el explorador de buzón/buzón de salida; puede verlas en el separador Instantáneas de Migración. Note: Los valores de parámetro que contengan un carácter de espacio deben aparecer entre comillas. Table 2-1 servicios Comandos de la utilidad EPM Automate que funcionan con todos los Referencia de comandos 2-1 Comandos de la utilidad EPM Automate aplicables a todos los servicios Table 2-1 (Cont.) Comandos de la utilidad EPM Automate que funcionan con todos los servicios Comando Descripción help Muestra la ayuda. Sintaxis: epmautomate help (para obtener acceso a la página de referencia de comandos, en la que obtiene acceso a las descripciones de todos los comandos de la utilidad EPM Automate ) o epmautomate NOMBRE_COMANDO help para mostrar la ayuda de un comando concreto. Ejemplo: epmautomate login help encrypt Utiliza el estándar de cifrado avanzado (AES) para cifrar su contraseña y almacenarla en un archivo de contraseñas. Su contraseña solo se cifrará una vez. Sintaxis: epmautomate encrypt PASSWORD KEY PASSWORD_FILE, donde: • CONTRASEÑA es la contraseña del administrador de servicio en el servicio. No puede utilizar credenciales corporativas con la utilidad EPM Automate. • KEY es la clave de cifrado que se utilizará para cifrar la contraseña. • PASSWORD_FILE es el nombre y la ubicación del archivo en el que se almacena la contraseña cifrada. El archivo de contraseña debe llevar la extensión .epw. Ejemplo: epmautomate encrypt P@ssword1 myKey C: \mySecuredir\password.epw 2-2 Trabajo con EPM Automate para Oracle Enterprise Performance Management Cloud Comandos de la utilidad EPM Automate aplicables a todos los servicios Table 2-1 (Cont.) Comandos de la utilidad EPM Automate que funcionan con todos los servicios Comando Descripción login Establece una conexión segura a una instancia de servicio. Puede iniciar una sesión, que permanecerá activa hasta que se desconecte. No puede utilizar credenciales corporativas para iniciar sesión con esta utilidad. Sintaxis: • Con una contraseña no cifrada: epmautomate login USERNAME PASSWORD URL IDENTITYDOMAIN • Con una contraseña cifrada: epmautomate login USERNAME PASSWORD_FILE URL IDENTITYDOMAIN En estos comandos: • NOMBRE_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 se almacena la contraseña cifrada del administrador de servicio. • URL es la URL de la instancia de servicio a la que desea conectarse. • IDENTITYDOMAIN es el dominio de identidad de la instancia de servicio. Ejemplos: • Con una contraseña cifrada: epmautomate login serviceAdmin P@ssword1 https://test-cloud-pln.pbcs.us1.oraclecloud.com myIdentityDomain • Con una contraseña no cifrada: epmautomate login serviceAdmin C:\mySecuredir \password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com myIdentityDomain logout Finaliza la conexión actual a una instancia de servicio. Sintaxis: epmautomate logout Referencia de comandos 2-3 Comandos de la utilidad EPM Automate aplicables a todos los servicios Table 2-1 (Cont.) Comandos de la utilidad EPM Automate que funcionan con todos los servicios Comando Descripción uploadfile Carga un archivo del equipo local en una carpeta de la instancia de servicio. Utilice este comando para cargar archivos que contengan datos, metadatos, definiciones de reglas, definiciones de dimensiones, transacciones asignadas e instantáneas de copia de seguridad. Sintaxis: epmautomate uploadfile "NOMBRE_ARCHIVO" [CARPETA_INTEGRATIONS] Ejemplos: • Carga en el buzón o el buzón de salida de Planning: epmautomate uploadfile "C:/pbcsdata/ quarterlydata.csv" • Carga en una carpeta de Integrations: epmautomate uploadfile "C:/fdmee_data/data.zip" inbox/ repository downloadfile Descarga un archivo de una instancia de servicio en el equipo local. Este comando se utiliza para descargar datos, metadatos y copias de seguridad de instantáneas para el almacenamiento local. Este archivo se descarga en la carpeta desde la que ejecuta la utilidad. Sintaxis: epmautomate downloadfile "[RUTA_ARCHIVO]/NOMBRE_ARCHIVO" Ejemplos: • Descarga del buzón o el buzón de salida: epmautomate downloadfile data.csv • Descarga de una carpeta de Integrations: epmautomate downloadfile outbox/report/data.csv • Descarga del repositorio de Oracle Account Reconciliation Cloud: epmautomate downloadfile "data.csv" listfiles Muestra los archivos del buzón o el buzón de salida, una carpeta de Integrations o el repositorio de Oracle Account Reconciliation Cloud. Este comando no muestra las instantáneas de Migración. Sintaxis: epmautomate listfiles deletefile Suprime un archivo o una instantánea de aplicación del buzón o el buzón de salida, una carpeta de Integrations o el repositorio de Oracle Account Reconciliation Cloud. Sintaxis: epmautomate deletefile FILE_NAME Ejemplos: • epmautomate deletefile data.csv • epmautomate deletefile applicationbackupOctober30 2-4 Trabajo con EPM Automate para Oracle Enterprise Performance Management Cloud Comandos de la utilidad EPM Automate aplicables a todos los servicios Table 2-1 (Cont.) Comandos de la utilidad EPM Automate que funcionan con todos los servicios Comando Descripción exportsnapshot Repite una operación de exportación realizada anteriormente para crear una instantánea del contenido de Migración. Sintaxis: epmautomate exportsnapshot NOMBRE_INSTANTÁNEA, donde NOMBRE_INSTANTÁNEA es el nombre de una instantánea existente en Migración. Esta instantánea se reemplazará por la nueva instantánea. Ejemplo: epmautomate exportsnapshot October16FullApp importsnapshot Importa el contenido de una instantánea a la instancia de servicio. Sintaxis: epmautomate importsnapshot SNAPSHOT_NAME Ejemplo: epmautomate importsnapshot October16FullApp copysnapshotfrominsta nce Migra (clona) una instancia copiando una instantánea de una instancia (origen) en la instancia actual (destino), por ejemplo, de una instancia de prueba en una instancia de producción. Sintaxis: epmautomate copysnapshotfrominstance NOMBRE_INSTANTÁNEA NOMBRE_USUARIO ARCHIVO_CONTRASEÑAS URL DOMINIO_IDENTIDAD, donde: • NOMBRE_INSTANTÁNEA es el nombre de una instantánea existente en la instancia de origen de Migración. • NOMBRE_USUARIO es el nombre de usuario de un administrador de servicio de la instancia de origen. • ARCHIVO_CONTRASEÑAS es el nombre y la ubicación del archivo que contiene la contraseña cifrada del administrador de servicio de la instancia de origen. • URL es la URL de la instancia de origen. • DOMINIO_IDENTIDAD es el dominio de identidad de la instancia de origen. Ejemplo: epmautomate copysnapshotfrominstance "Artifact Snapshot" serviceAdmin C: \mySecuredir\password.epw https://test-cloudpln.pbcs.us1.oraclecloud.com myprodIdentityDomain Referencia de comandos 2-5 Comandos de la utilidad EPM Automate aplicables a todos los servicios Table 2-1 (Cont.) Comandos de la utilidad EPM Automate que funcionan con todos los servicios Comando Descripción recreate -f Restaura una instancia de servicio en un estado limpio mediante el refrescamiento del despliegue. Este proceso suprime la aplicación de Planning y todos los artefactos definidos por el usuario. Caution: El uso de este comando resultará en la pérdida de los artefactos y datos existentes. Realice una copia de seguridad completa de la aplicación antes de volver a crear una instancia de servicio. Sintaxis: epmautomate recreate -f provisionreport Genera un informe de aprovisionamiento (archivo .CSV) y lo almacena en el buzón o el buzón de salida. Este informe contiene información sobre los roles asignados a los usuarios e información de herencia que muestra la secuencia de herencia que se inicia con el rol original responsable de otorgar el rol aprovisionado al usuario. Sintaxis: epmautomate provisionreport NOMBRE_INFORME, donde NOMBRE_INFORME es el nombre del archivo de informe. Ejemplo: epmautomate provisionreport myProvReport.CSV userauditreport Genera un informe de auditoría de usuarios (archivo .CSV) y lo almacena en el buzón o el buzón de salida. Este informe contiene información sobre los usuarios que iniciaron sesión en una instancia de servicio a lo largo del periodo especificado. Muestra la dirección IP del equipo desde el que inició sesión el usuario y la fecha y hora en la que el usuario accedió a la instancia de servicio. Sintaxis: epmautomate userauditreport FECHA_INICIAL FECHA_FINAL NOMBRE_INFORME, donde: • FECHA_INICIAL indica la fecha inicial (con formato YYYY-MM-DD) del periodo cuyo informe de auditoría debe generarse • FECHA_FINAL indica la fecha final (con formato YYYYMM-DD) del periodo cuyo informe de auditoría debe generarse • NOMBRE_INFORME es el nombre del archivo de informe Ejemplo: epmautomate userauditreport myAuditReport.CSV 2-6 Trabajo con EPM Automate para Oracle Enterprise Performance Management Cloud Comandos específicos de Oracle Planning and Budgeting Cloud Table 2-1 (Cont.) Comandos de la utilidad EPM Automate que funcionan con todos los servicios Comando Descripción feedback Envía comentarios a Oracle y a los administradores de servicio de la instancia. Este comando, que imita la función Proporcionar comentarios (consulte Envío de comentarios a Oracle en Uso de Oracle Planning and Budgeting Cloud) del servicio, resulta de especial utilidad para proporcionar comentarios (solo texto) a Oracle en los casos en que la interfaz de usuario no responde o se produce un problema al ejecutar la utilidad. Note: Los comentarios deben escribirse entrecomillados. Sintaxis: epmautomate feedback "comment" Ejemplo: epmautomate feedback "runplantypemap CampaignToReporting ClearData=True did not clear data from aggregate storage" resetservice Reinicia la instancia de servicio. Utilice este comando solo cuando observe una degradación grave del rendimiento o si recibe mensajes de error que indiquen que la instancia no puede utilizarse. El restablecimiento del servicio no afecta a la personalización de la aplicación (por ejemplo, cambio de configuración regional, configuración relacionada con el tema y la moneda, etc.). El restablecimiento tarda hasta 15 minutos. Note: Los comentarios deben escribirse entrecomillados. Sintaxis: epmautomate resetservice "comment" Ejemplo: epmautomate resetservice "Users experience unacceptably slow connections" Comandos específicos de Oracle Planning and Budgeting Cloud Requisitos previos • Trabajos En muchos de los comandos explicados en la siguiente sección, se necesitan trabajos de Oracle Hyperion Planning. Los trabajos son acciones, como la importación o exportación de datos, que se pueden iniciar inmediatamente o programar para que se realicen posteriormente, por ejemplo, la importación o exportación de datos y el refrescamiento de la base de datos. Referencia de comandos 2-7 Comandos específicos de Oracle Planning and Budgeting Cloud Con la consola de trabajos, debe crear los trabajos adecuados para realizar las siguientes operaciones. Para obtener instrucciones detalladas para crear trabajos, consulte Gestión de trabajos en Administración de Planning para Oracle Planning and Budgeting Cloud. – 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 en una base de datos de almacenamiento agregado o desde una base de almacenamiento agregado a otra base de datos de almacenamiento de bloques • Reglas de negocio Las reglas de negocio que desee ejecutar deben existir en la aplicación de Planning. Puede utilizar Oracle Hyperion Calculation Manager para crear reglas de negocio, que a continuación se desplegarán en la aplicación de Planning. Consulte Diseño con Calculation Manager para Oracle Enterprise Performance Management Cloud. Comandos de la utilidad EPM Automate para Oracle Planning and Budgeting Cloud Debe ser administrador de servicio para ejecutar estos comandos. Para completar tareas con la utilidad, es posible que también deba utilizar algunos de los comandos explicados en Comandos de la utilidad EPM Automate aplicables a todos los servicios. Table 2-2 Comandos de Oracle Planning and Budgeting Cloud Comando Descripción importdata Importa datos desde un archivo en la bandeja de entrada/buzón de salida utilizando la configuración de los datos de importación especificados en un trabajo de Planning de tipo import data. También puede especificar el nombre del archivo ZIP, CSV o TXT (archivo de datos de formato Essbase) desde el que se van a importar los datos. Si especifica un nombre de archivo, 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 ZIP debe incluir un archivo de formato TXT de Essbase. Para otros trabajos de importació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 NOMBRE_TRABAJO [NOMBRE_ARCHIVO], donde: NOMBRE_TRABAJO es el nombre de un trabajo definido en la aplicación de Planning y NOMBRE_ARCHIVO identifica el archivo ZIP o CSV desde el que se importan los datos. Ejemplo: epmautomate importdata dailydataload dailydata.zip 2-8 Trabajo con EPM Automate para Oracle Enterprise Performance Management Cloud Comandos específicos de Oracle Planning and Budgeting Cloud Table 2-2 (Cont.) Comandos de Oracle Planning and Budgeting Cloud Comando Descripción exportdata Exporta los datos de la aplicación en un archivo utilizando la configuración de los datos de exportación, incluyendo el nombre de archivo, especificado en un trabajo de Planning de tipo export data. Puede ver los detalles del archivo exportado utilizando el Planning explorador de bandeja de entrada/buzón de salida. Opcionalmente, puede especificar un nombre de archivo para los datos exportados. Los datos se exportan solo como archivo ZIP. Los datos se exportan solo como archivo ZIP. El archivo exportado se almacena en la bandeja de entrada/buzón de salida de Planning. Sintaxis: epmautomate exportdata NOMBRE_TRABAJO [NOMBRE_ARCHIVO], donde: NOMBRE_TRABAJO es el nombre de un trabajo definido en la aplicación de Planning y NOMBRE_ARCHIVO es el nombre del archivo ZIP al que se exportarán los datos. Ejemplo: epmautomate exportdata dailydataexport dailyData.zip refreshcube Refresca el cubo de la aplicación de Planning. Normalmente, puede refrescar el cubo después de importar los metadatos en la aplicación. Sintaxis: epmautomate refreshcube runbusinessrule Inicia una regla de negocio. Sintaxis: epmautomate runbusinessrule RULE_NAME [PARAMETER=VALUE], donde: • RULE_NAME es el nombre de una regla de negocio exactamente como se define en la instancia del servicio. • PARAMETER=VALUE indica los parámetros en tiempo de ejecución opcionales y sus valores necesarios para ejecutar la regla de negocio. Note: La regla se ejecuta en el tipo de plan en el que se ha desplegado. Utilice el emparejamiento PARAMETER=VALUE para especificar tantas peticiones de datos en tiempo de ejecución como reglas de negocio se necesiten. El siguiente ejemplo utiliza dos peticiones de datos en tiempo de ejecución (Period y Entity) y sus valores (Q1 y USA). Ejemplo: epmautomate runbusinessrule RollupUSSales Period=Q1 Entity=USA Referencia de comandos 2-9 Comandos específicos de Oracle Planning and Budgeting Cloud Table 2-2 (Cont.) Comandos de Oracle Planning and Budgeting Cloud Comando Descripción runplantypemap Copia los datos desde una base de datos de almacenamiento de bloques a una base de datos de almacenamiento agregado o desde una base de datos de almacenamiento de bloques a otra base de datos de almacenamiento de bloques según la configuración especificada en el trabajo de Planning de tipo plan type map. Sintaxis: epmautomate runplantypemap NOMBRE_TRABAJO [clearData=true|false], donde: • JOB_NAME es el nombre de un trabajo de tipo plan type map definido en la aplicación de Planning. • clearData es una configuración opcional que indica si los datos de la base de datos de destino se deben eliminar antes de copiar los datos. Si no se define este valor de parámetro, se utilizará el valor predeterminado True. Ejemplo: epmautomate runplantypemap CampaignToReporting clearData=false 2-10 Trabajo con EPM Automate para Oracle Enterprise Performance Management Cloud Comandos específicos de Oracle Planning and Budgeting Cloud Table 2-2 (Cont.) Comandos de Oracle Planning and Budgeting Cloud Comando Descripción importmetadata Importa los metadatos desde un archivo de la bandeja de entrada/buzón de salida a la aplicación mediante la configuración de los datos de importación especificados en el trabajo de Planning de tipo import metadata. También puede especificar el nombre del archivo ZIP desde el que se importarán los metadatos. El contenido del ZIP que especifique tendrá prioridad sobre los nombres de archivo definidos en el trabajo. El archivo ZIP puede contener uno o más archivos CSV. Los nombres de archivo que contienen metadatos para dimensiones deben coincidir con los nombres de archivos de importación definidos en el trabajo o bien terminar por _DIMENSIONNAME.csv; por ejemplo, metadata_Entity.csv, metadata_HSP_Smart Lists.csv y metadata_Exchange Rates.csv. Note: 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 el archivo ZIP, se ignorarán los metadatos para otras dimensiones. Sintaxis: epmautomate importmetadata NOMBRE_TRABAJO [NOMBRE_ARCHIVO], donde: NOMBRE_TRABAJO es el nombre de un trabajo definido en la aplicación de Planning y NOMBRE_ARCHIVO es el nombre del archivo ZIP desde el que se importan los metadatos. Ejemplo: epmautomate importmetadata importAccount importAccount.zip Referencia de comandos 2-11 Comandos específicos de Integrations Table 2-2 (Cont.) Comandos de Oracle Planning and Budgeting Cloud Comando Descripción exportmetadata Exporta metadatos a un archivo utilizando la configuración especificada en un trabajo de Planning de tipo export metadata. El archivo que contiene los datos exportados se almacena en la bandeja de entrada/buzón de salida de Planning. Opcionalmente, puede especificar un nombre de archivo para los datos exportados, lo que sustituirá el nombre de archivo predeterminado (nombre del trabajo que se utiliza para exportar metadatos). Los metadatos se exportarán solo como un archivo ZIP. Sintaxis: epmautomate exportmetadata NOMBRE_TRABAJO [NOMBRE_ARCHIVO], donde: NOMBRE_TRABAJO es el nombre de un trabajo definido en la aplicación de Planning y NOMBRE_ARCHIVO es el nombre del archivo ZIP al que se exportarán los metadatos. Ejemplo: epmautomate exportmetadata dailyAccountexport Accountexport.ZIP setsubstvars Crea o actualiza variables de sustitución en el nivel de aplicación o de tipo de plan. No puede utilizar este comando para definir múltiples valores y/o funciones para variables de sustitución. Sintaxis: epmautomate setsubstvars NOMBRE_TIPO_PLAN VARIABLE_SUSTITUCIÓN=VALOR [VARIABLE_SUSTITUCIÓN=VALOR], donde: • NOMBRE_TIPO_PLAN es el tipo de plan (por ejemplo, Plan1 o Plan2) para el que se crea o se actualiza la variable de sustitución. Utilice ALL en lugar de un nombre de tipo de plan para definir 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 valor se 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 tipo de plan: epmautomate setsubstvars Plan2 CurYear=2013 CurPeriod=Jan Comandos específicos de Integrations Requisitos previos • Reglas de datos Las reglas de carga de datos definen cómo carga Integrations los datos de un archivo. Deben existir reglas de carga de datos predefinidas para cargar los datos con la utilidad EPM Automate. 2-12 Trabajo con EPM Automate para Oracle Enterprise Performance Management Cloud Comandos específicos de Integrations • Lotes Puede cargar datos utilizando los lotes definidos en Integrations. Si utilizan un lote, los administradores de servicio pueden combinar muchas reglas de carga en un lote y ejecutarlas en serie o en paralelo. • Debe ser administrador de servicio para ejecutar estos comandos. Comandos de la utilidad EPM Automate para Integrations Para completar tareas con la utilidad, es posible que también deba utilizar algunos de los comandos explicados en Comandos de la utilidad EPM Automate aplicables a todos los servicios. Table 2-3 Comandos de Integrations Referencia de comandos 2-13 Comandos específicos de Integrations Table 2-3 (Cont.) Comandos de Integrations Comando Descripción rundatarule Ejecuta una regla de carga de datos de Integrations basada en el periodo inicial y en el periodo final, así como en las opciones de importación o exportación que especifique. Sintaxis: epmautomate rundatarule NOMBRE_REGLA PERIODO_INICIAL PERIODO_FINALMODO_IMPORTACIÓN MODO_EXPORTACIÓN [NOMBRE_ARCHIVO], donde: • NOMBRE_REGLA es el nombre de una regla de carga de datos definida en Integrations. Debe entrecomillar el nombre de la regla si contiene espacios. • PERIODO_INICIAL es el primer periodo durante el que deben cargarse los datos. Este nombre de periodo debe estar definido en la asignación de periodos de Integrations. • PERIODO_FINAL es, cuando la carga de datos abarca varios periodos, el último periodo durante el que deben cargarse los datos. Cuando la carga abarca un solo periodo, introduzca el mismo periodo que el periodo inicial. Este nombre de periodo debe estar definido en la asignación de periodos de Integrations. • MODO_IMPORTACIÓN determina cómo se importan los datos a Integrations. Estos son los valores aceptables: – APPEND para agregar los datos de PDV existentes a Integrations – REPLACE para suprimir los datos de PDV y reemplazarlos por los datos del archivo – NONE para omitir la importación de datos a la tabla de asignación de etapas de Integrations • MODO_EXPORTACIÓN determina cómo se exportan los datos a la aplicación de Oracle Hyperion Planning. Estos son los valores aceptables: – – – – – STORE_DATA para fusionar los datos de la tabla de asignación de etapas de Integrations con los datos de Planning existentes ADD_DATA para agregar los datos de la tabla de asignación de etapas de Integrations a Planning SUBTRACT_DATA para restar los datos de la tabla de asignación de etapas de Integrations de los datos de Planning existentes REPLACE_DATA para borrar los datos de PDV y reemplazarlos por los datos de la tabla de asignación de etapas de Integrations. Se borran los datos de Escenario, Versión, Año, Periodo y Entidad NONE para omitir la exportación de datos de Integrations a Planning • NOMBRE_ARCHIVO es un nombre de archivo opcional. Si no especifica ningún nombre de archivo, la utilidad EPM Automate importa los datos incluidos en el nombre de archivo especificado en la regla de carga de datos. Ejemplos: • Importación de varios periodos: epmautomate rundatarule VisionActual Mar-15 Jun-15 REPLACE STORE_DATA inbox/Vision/GLActual.dat 2-14 Trabajo con EPM Automate para Oracle Enterprise Performance Management Cloud • Importación de un solo periodo: epmautomate rundatarule "Vision Actual" Mar-15 Mar-15 Comandos específicos de Oracle Account Reconciliation Cloud Table 2-3 (Cont.) Comandos de Integrations Comando Descripción runbatch Ejecuta un lote de Integrations. Si el modo de ejecución de lote de Integrations está establecido en En serie, se devuelve 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 se envían para la ejecución. Sintaxis: epmautomate runbatch NOMBRE_LOTE, donde NOMBRE_LOTE es el nombre del lote definido en Integrations. Ejemplo: epmautomate runbatch Accounting_batch Comandos específicos de Oracle Account Reconciliation Cloud Requisitos previos • Debe ser administrador de servicio o usuario avanzado para ejecutar comandos. • El periodo, el tipo de cambio, el tipo de transacción y el filtro público guardado que utiliza para ejecutar los comandos específicos de Oracle Account Reconciliation Cloud deben existir en el directorio de buzón/buzón de salida. Consulte el comando uploadfile en Comandos de la utilidad EPM Automate aplicables a todos los servicios para obtener información sobre la carga de archivos. Comandos de la utilidad EPM Automate para Oracle Account Reconciliation Cloud Para completar tareas con la utilidad, es posible que también deba utilizar algunos de los comandos explicados en Comandos de la utilidad EPM Automate aplicables a todos los servicios. Table 2-4 Comandos específicos de Oracle Account Reconciliation Cloud Comando Descripción importpremappedbalances Importa datos de balance preasignados de un archivo al repositorio de Oracle Account Reconciliation Cloud. Sintaxis: epmautomate importpremappedbalances PERIODO NOMBRE_ARCHIVO TIPO_BALANCE DEPÓSITO_MONEDAS, donde: • PERIODO es el nombre de un periodo • NOMBRE_ARCHIVO es el nombre del archivo CSV que contiene los datos que deben importarse • TIPO_BALANCE es SRC o SUB • DEPÓSITO_MONEDAS es Entered, Functional o Reporting Ejemplo: epmautomate importpremappedbalances "January 2015" dailydata.csv SRC Reporting Referencia de comandos 2-15 Comandos específicos de Oracle Account Reconciliation Cloud Table 2-4 (Cont.) Comandos específicos de Oracle Account Reconciliation Cloud Comando Descripción importrates Importa tipos de cambio de un archivo CSV al repositorio de Oracle Account Reconciliation Cloud. Sintaxis: epmautomate importrates PERIODO TIPO_CAMBIO MODO_REEMPLAZO NOMBRE_ARCHIVO, donde: • • • • PERIODO es el nombre de un periodo TIPO_CAMBIO es un tipo de cambio predefinido MODO_REEMPLAZO es Replace o ReplaceAll NOMBRE_ARCHIVO es el nombre del archivo CSV del que deben importarse los tipos Ejemplo: epmautomate importrates "January 2015" Actual ReplaceAll avgrates.csv importpremappedtransact ions Importa transacciones preasignadas de un archivo CSV al repositorio de Oracle Account Reconciliation Cloud. Sintaxis: epmautomate importpremappedtransactions PERIODO TIPO_TRANSACCIÓN NOMBRE_ARCHIVO FORMATO_FECHA, donde: • PERIODO es el nombre de un periodo • 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 deben importarse los datos • FORMATO_FECHA es una cadena de texto con el formato de la fecha, por ejemplo, MMM d, yyyy Ejemplo: epmautomate importpremappedtransactions "January 2015" "BEX" transactions.csv "MMM d, yyyy" importprofiles Importa nuevas definiciones de perfil de un archivo CSV al repositorio de Oracle Account Reconciliation Cloud. Sintaxis: epmautomate importprofiles NOMBRE_ARCHIVO TIPO_PERFIL MÉTODO FORMATO_FECHA, donde: • NOMBRE_ARCHIVO es el nombre del archivo CSV del que deben importarse los datos • 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, yyyy Ejemplo: eppmatomate importprofiles NewRecProfiles.csv Profiles Replace "MMM d, yyyy" 2-16 Trabajo con EPM Automate para Oracle Enterprise Performance Management Cloud Comandos específicos de Oracle Account Reconciliation Cloud Table 2-4 (Cont.) Comandos específicos de Oracle Account Reconciliation Cloud Comando Descripción createreconciliations Copia los perfiles en el periodo especificado. Sintaxis: epmautomate createreconciliations PERIODO FILTRO_GUARDADO, donde: • PERIODO es el nombre de un periodo • FILTRO_GUARDADO es el nombre de un filtro público guardado. Si no especifica ningún filtro guardado, la utilidad copia todos los perfiles aplicables Ejemplos: • epmautomate createreconciliations "January 2015" • epmautomate createreconciliations "January 2015" "Corporate Recs" setperiodstatus Define el estado del periodo en el especificado. Sintaxis: epmautomate setperiodstatus PERIODO ESTADO, donde: • PERIODO es el nombre de un periodo • ESTADO es OPEN, CLOSED o LOCKED Ejemplo: epmautomate setperiodstatus "January 2015" OPEN setdemodates Utilice este comando solo en la configuración de instalaciones con datos de la demostración interna de Oracle. Cambia el nombre de los periodos para que sea consistente con la fecha especificada. También restablece las fechas de todas las conciliaciones que tienen asociados valores del atributo Demo Code de setdemodate o setdemodatenostatuschage. • Si el valor es setdemodate, este comando restablece las fechas de conciliación en función de la fecha especificada y la devuelve al estado Open with Preparer • Si el valor es setdemodatenostatuschage, este comando restablece las fechas de conciliación en función de la fecha especificada, pero sin cambiar el estado de conciliación Las conciliaciones que no tienen este valor de atributo no se ven afectadas. Sintaxis: epmautomate setdemodates [FECHA_DEMOSTRACIÓN], donde FECHA_DEMOSTRACIÓN es un fecha opcional con el formato YYYY-MM-DD. Las conciliaciones se restablecen a la fecha actual si no especifica este valor. Ejemplo: epmautomate setdemodates 2015-12-15 Referencia de comandos 2-17 Códigos de estado Códigos de estado La utilidad EPM Automate devuelve un código para indicar el estado de la operación. Table 2-5 Códigos de salida de la utilidad EPM Automate Código de estado Descripción 0 Operación completada sin errores. 1 La operación no se ha podido completar debido a un error. 2 Pendiente de cancelación. 3 El usuario ha finalizado la operación. 4 Parámetros incorrectos. 5 Privilegios insuficientes. 6 El servicio no está disponible. 7 Comando no válido. 8 Parámetro no válido. 9 Dominio de identidad, contraseña o nombre de usuario no válido. 10 Contraseña caducada. 11 El servicio no está disponible. Ejecución de la utilidad EPM Automate Debe ser administrador de servicio para realizar tareas con la utilidad EPM Automate. La utilidad EPM Automate utiliza la configuración de proxy especificada en el equipo. No obstante, la utilidad no funciona si está activada la autentificación en el servidor proxy para la red. Windows Antes de ejecutar la utilidad EPM Automate, asegúrese de que puede obtener acceso a Oracle Planning and Budgeting Cloud desde el equipo en el que está ejecutando la utilidad. Para ejecutar la utilidad EPM Automate en un cliente de Windows: 1. Haga clic en Inicio y, a continuación, en Todos los programas, seleccione EPM Automate y, por último, Iniciar EPM Automate. Aparecerá el símbolo del sistema de Iniciar EPM Automate. 2. Opcional: Vaya al directorio desde el que desea realizar operaciones con la utilidad EPM Automate. 3. Opcional: Genere un archivo de cifrado de contraseñas. El archivo de cifrado de contraseñas sirve para utilizar una contraseña cifrada al iniciar sesión. epmautomate encrypt P@ssword1 myKey C:/mySecuredir/password.epw 2-18 Trabajo con EPM Automate para Oracle Enterprise Performance Management Cloud Ejecución de la utilidad EPM Automate 4. Inicie una sesión como administrador de servicio. Utilice un comando como el siguiente: • 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 completar. Consulte Comandos específicos de Oracle Planning and Budgeting Cloud para ver una descripción de los comandos, su sintaxis y ejemplos. Consulte Códigos de estado para obtener información sobre el estado de ejecución de los comandos. 6. Cierre la sesión en el servicio de la instancia. Utilice el siguiente comando. epmautomate logout Linux Note: Asegúrese de que JAVA_HOME está definido en la variable PATH del archivo .profile o como una variable de entrono de shell. Para ejecutar la utilidad EPM Automate en un cliente de Linux: 1. Abra una ventana de terminal y vaya al directorio en el que ha instalado la utilidad EPM Automate. 2. Opcional: Genere un archivo de cifrado de contraseñas. El archivo de cifrado de contraseñas sirve para utilizar una contraseña cifrada en lugar de una no cifrada al iniciar sesión. epmautomate encrypt P@ssword1 myKey ../misc/encrypt/password.epw 3. Inicie una sesión como administrador de servicio. Utilice un comando como el siguiente: • 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 completar. Consulte Comandos específicos de Oracle Planning and Budgeting Cloud para ver una descripción de los comandos, su sintaxis y ejemplos. Referencia de comandos 2-19 Ejecución de la utilidad EPM Automate Consulte Códigos de estado para obtener información sobre el estado de ejecución de los comandos. 5. Cierre la sesión en el servicio de la instancia. Utilice el siguiente comando. ./bin/epmautomate.sh logout Ejecución de varias instancias de la utilidad Ejecute la utilidad EPM Automate desde directorios independientes si debe conectar a varias instancias de servicio en paralelo utilizando una instalación de la utilidad. Por ejemplo, tiene que refrescar de manera simultánea el cubo de la aplicación de Planning en https://cloudpln.pbcs.us1.oraclecloud.com y en https:// testcloudpln.pbcs.us1.oraclecloud.com. En este escenario, debe ejecutar la utilidad desde directorios independientes, por ejemplo, desde C:/scripts/ MyService para conectar a la primera instancia y desde C:/scripts/ MyServicetest para conectar a la segunda instancia, y ejecutar el comando cuberefresh. 2-20 Trabajo con EPM Automate para Oracle Enterprise Performance Management Cloud 3 Escenarios de ejemplo de ejecución de comandos • Escenarios de ejemplo de Oracle Planning and Budgeting Cloud • Escenarios de ejemplo de Oracle Account Reconciliation Cloud Escenarios de ejemplo de Oracle Planning and Budgeting Cloud • Escenario 1: importación de metadatos en la aplicación • Escenario 2: importación de datos, ejecución de un script de cálculo y copia de datos desde una base de datos de almacenamiento de bloques a una base de datos de almacenamiento agregado • Escenario 3: exportación y descarga de metadatos y datos • Escenario 4: eliminación de los archivos necesarios desde una instancia de servicio • Escenario 5: archivo de copias de seguridad del servicio de forma local • Escenario 6: Clonación de una instancia de servicio • Escenario 7: Importación de datos a Integrations, ejecución de una regla de carga de datos y exportación de datos a Planning • Escenario 8: Automatización de descargas de instantáneas de aplicaciones • Escenario 9: Automatización de la integración de datos diaria • Escenario 10: Automatización de la clonación de instancias En esos escenarios, se utiliza una secuencia de comandos para completar diversas actividades con la utilidad EPM Automate. Se utilizan las siguientes credenciales ficticias para iniciar sesión en una instancia de servicio de ejemplo: • Nombre de usuario: serviceAdmin • Archivo de contraseñas: C:/mySecuredir/password.epw Este archivo se crea manualmente. Consulte el comando encrypt en Comandos de la utilidad EPM Automate aplicables a todos los servicios. • URL de servicio: https://test-cloud-pln.pbcs.us1.oraclecloud.com • Dominio de identidad: myIdentityDomain Escenarios de ejemplo de ejecución de comandos 3-1 Escenarios de ejemplo de Oracle Planning and Budgeting Cloud Escenario 1: importación de metadatos en la aplicación En este escenario, puede ejecutar una secuencia de comandos para completar estos pasos: • Inicie sesión en la instancia. • Cargue el archivo de metadatos accounts.zip. • Importe los metadatos desde accounts.zip en la aplicación con el trabajo accountMetadata. • Refresque el cubo. • Cierre la sesión. epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com myIdentityDomain epmautomate uploadfile accounts.zip epmautomate importmetadata accountMetadata accounts.zip epmautomate refreshcube epmautomate logout Escenario 2: importación de datos, ejecución de un script de cálculo y copia de datos desde una base de datos de almacenamiento de bloques a una base de datos de almacenamiento agregado En este escenario, puede ejecutar una secuencia de comandos para completar estos pasos: • Inicie sesión en la instancia. • Cargue un archivo data.csv. • Importe los datos desde data.csv en la aplicación con el trabajo loadingq1data. • Refresque el cubo. • Ejecute la regla de negocio RevenueAllocation desplegada en el tipo de plan RollupUSSales con las peticiones de datos en tiempo de ejecución Quarter=Q1 Entity=USA para transformar los datos. • Envíe los datos a una base de almacenamiento agregada con el trabajo CampaignToReporting. • Cierre la sesión. epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com myIdentityDomain epmautomate uploadfile data.csv epmautomate importdata loadingq1data data.csv epmautomate refreshcube epmautomate runbusinessrule RevenueAllocation Quarter=Q1 Entity=USA epmautomate runplantypemap CampaignToReporting clearData=true epmautomate logout 3-2 Trabajo con EPM Automate para Oracle Enterprise Performance Management Cloud Escenarios de ejemplo de Oracle Planning and Budgeting Cloud Escenario 3: exportación y descarga de metadatos y datos En este escenario, puede ejecutar una secuencia de comandos para completar estos pasos: • Inicie sesión en la instancia. • Exporte los metadatos en entityData.zip con el trabajo exportentitymetadata. • Exporte los datos de la aplicación en forecastData.zip con el trabajo forecastdata. • Muestre el contenido del buzón o del buzón de salida de Oracle Hyperion Planning. • Descargue los archivos de datos exportados (exportentitydata.zip y forecastdata.zip) del buzón de entrada/salida de Planning en la computadora local. • Cierre la sesión. epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com myIdentityDomain epmautomate exportmetadata exportentitymetadata entityData.zip epmautomate exportdata forecastdata forecastData.zip epmautomate listfiles epmautomate downloadfile entityData.zip epmautomate downloadfile forecastData.zip epmautomate logout Escenario 4: eliminación de los archivos necesarios desde una instancia de servicio En este escenario, puede ejecutar una secuencia de comandos para completar estos pasos: • Inicie sesión en la instancia de servicio. • Muestre el contenido del buzón o del buzón de salida. • Suprima los archivos entitymetadata.csv y forecastdata.csv del buzón o del buzón de salida. • Cierre la sesión. epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com myIdentityDomain epmautomate listfiles epmautomate deletefile entitymetadata.csv epmautomate deletefile forecastdata.csv epmautomate logout Escenario 5: Archivado de copias de seguridad del servicio de forma local En este escenario, puede ejecutar una secuencia de comandos para completar estos pasos: • Inicie sesión en la instancia de servicio. Escenarios de ejemplo de ejecución de comandos 3-3 Escenarios de ejemplo de Oracle Planning and Budgeting Cloud • Crear copias de seguridad de datos (entitydata.zip y forecastdata.zip). • Mostrar los archivos en la bandeja de entrada o el buzón de salida para verificar que las copias de seguridad están presentes. • Descargar (entitydata.zip y forecastdata.zip) en una computadora local. • Cierre la sesión. epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com myIdentityDomain epmautomate exportmetadata exportentitymetadata entityData.zip epmautomate exportdata entitydata entitydata.zip epmautomate exportdata forecastdata forecastdata.zip epmautomate listfiles epmautomate downloadfile entityData.zip epmautomate downloadfile forecastData.zip epmautomate logout Escenario 6: Clonación de una instancia de servicio Puede clonar una instancia de servicio por muchas razones. En este escenario se supone que va a clonar una instancia para ofrecer protección ante la pérdida de servicio. También se supone que utiliza la instantánea de la aplicación creada en la instancia de origen durante el mantenimiento de servicio diario. Requisitos previos El dominio de identidad utilizado por la instancia de servicio que está clonando (origen) y la instancia de servicio que crea como clon (destino) deben utilizar un conjunto de asignaciones de usuarios y roles idéntico. • Si el origen y el destino residen en el mismo centro de datos, deben compartir un dominio de identidad. • Si el origen y el destino no comparten un centro de datos, debe crear manualmente el conjunto de asignaciones de funciones y usuarios del origen en el dominio de identidad del destino. Clonación de una instancia En 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 una instancia de servicio, ejecute comandos que realicen los pasos siguientes: • Iniciar sesión en la instancia de destino en la que desea establecer la clonación mediante el uso de las siguientes credenciales: – Nombre de usuario: serviceAdmin – Archivo de contraseñas: C:/mySecuredir/password2.epw Debe crear este archivo. Consulte el comando encrypt en Comandos específicos de Oracle Planning and Budgeting Cloud. – URL: https://test-cloud-pln.pbcs.us2.oraclecloud.com 3-4 Trabajo con EPM Automate para Oracle Enterprise Performance Management Cloud Escenarios de ejemplo de Oracle Planning and Budgeting Cloud – Dominio de identidad: myNewIdentityDomain • Volver a crear la instancia de servicio. • Suprima Artifact Snapshot si está presente. • Clone la instancia copiando la instantánea Artifact Snapshot de la instancia de origen. • Importe los artefactos de Artifact Snapshot. • Cierre la sesión. epmautomate login serviceAdmin C:\mySecuredir\password2.epw https://test-cloud-pln.pbcs.us2.oraclecloud.com myNewIdentityDomain epmautomate recreate -f epmautomate deletefile "Artifact Snapshot" epmautomate copysnapshotfrominstance "Artifact Snapshot" C:\mySecuredir\password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com myprodIdentityDomain epmautomate importsnapshot "Artifact Snapshot" epmautomate logout Escenario 7: Importación de datos a Integrations, ejecución de una regla de carga de datos y exportación de datos a Planning Requisitos previos • Definiciones siguientes en Integrations: – Definición de regla de carga de datos denominada VisionActual – 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 Integrations y ejecución de una regla de carga de datos Para importar datos y ejecutar una regla de carga de datos, ejecute comandos para realizar estos pasos: • Inicie sesión en la instancia de servicio. • Cargue un archivo GLActual.dat que contenga datos para los periodos del Mar-15 al Jun-15 en la carpeta de Integrations inbox/Vision. • Importe los datos de GLActual.dat a Integrations utilizando la regla de carga de datos VisionActual, el periodo inicial Mar-15, el periodo final Jun-15 y el modo de importación REPLACE. • Exporte los datos con la opción STORE_DATA para fusionar los datos de la tabla de asignación de etapas de Integrations con los datos de Oracle Hyperion Planning existentes. • Cierre la sesión. epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com myIdentityDomain epmautomate uploadfile GLActual.dat inbox/Vision epmautomate rundatarule VisionActual Mar-15 Jun-15 REPLACE STORE_DATA inbox/Vision/ Escenarios de ejemplo de ejecución de comandos 3-5 Escenarios de ejemplo de Oracle Planning and Budgeting Cloud GLActual.dat epmautomate logout Escenario 8: Automatización de descargas de instantáneas de aplicaciones Cree un archivo de lote (.bat) o shell (.sh) que contenga un script similar al siguiente para automatizar las descargas de instantáneas. El siguiente script de ejemplo para Windows maneja estas actividades. • Descarga la instantánea de la aplicación (Artifact Snapshot) que se creó en la ventana 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 de seguridad más antiguas Note: Si vuelve a planificar este script para utilizarlo, modifique los valores de los parámetros SET url, SET user y SET NumberOfBackups como sea necesario. Consulte Automatización de la ejecución de scripts para obtener información sobre la programación del script con Programador de tareas de Windows. @echo off rem Sample script to download and maintain 10 maintenance backups rem Update the following three parameters SET SET SET SET SET url=https://test-cloud-pln.pbcs.us1.oraclecloud.com [email protected] NumberOfBackups=10 password=%1 SnapshotName=Artifact Snapshot rem EPM Automate commands CD /D %~dp0 call epmautomate login %user% %password% %url% IF %ERRORLEVEL% NEQ 0 goto :ERROR call epmautomate downloadfile "%SnapshotName%" IF %ERRORLEVEL% NEQ 0 goto :ERROR call epmautomate logout IF %ERRORLEVEL% NEQ 0 goto :ERROR rem Renames the downloaded artifacts, keeps the last 10 backups Set Timestamp=%date:~4,2%_%date:~7,2%_%date:~10,4%_%time:~1,1%%time:~3,2%% ren "%SnapshotName%.zip" "%SnapshotName%_%Timestamp%.zip" SET Count=0 FOR %%A IN ("%SnapshotName%*.*") DO SET /A Count += 1 IF %Count% gtr %NumberOfBackups% FOR %%A IN ("%SnapshotName%*.*") DO del "%%A" && GOTO EOF 3-6 Trabajo con EPM Automate para Oracle Enterprise Performance Management Cloud Escenarios de ejemplo de Oracle Planning and Budgeting Cloud :EOF echo Scheduled Task Completed successfully exit /b %errorlevel% :ERROR echo Failed with error #%errorlevel%. exit /b %errorlevel% Escenario 9: Automatización de la integración de datos diaria Cree un archivo de lote (.bat) o shell (.sh) que contenga un script similar al siguiente para automatizar las actividades relacionadas con la integración de datos. El siguiente script de ejemplo para Windows automatiza la integración diaria de datos de las aplicaciones completando estas actividades: • Inicie sesión en una instancia de servicio. • 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 trabajo ExportDailyTarget. • Descargue DailyTarget.zip en el servidor y agregue la marca de tiempo. • Cierre la sesión de Oracle Planning and Budgeting Cloud. Note: Si vuelve a planificar este script para utilizarlo, asegúrese de modificar los valores 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_allocatetarget para ajustar los requisitos Consulte Automatización de la ejecución de scripts para obtener información sobre la programación del script con Programador de tareas de Windows. @echo off rem rem rem rem rem Sample Script to demonstrate daily data integration with Oracle Planning and Budgeting Cloud Services application. This script uploads Plan data, clears target numbers,. runs a business rule to calculate balance sheet data, and . recalculates target numbers on the Vision demo application Escenarios de ejemplo de ejecución de comandos 3-7 Escenarios de ejemplo de Oracle Planning and Budgeting Cloud rem SET SET SET SET SET SET SET SET SET SET Please input the below parameters url=https://test-cloud-pln.pbcs.us1.oraclecloud.com [email protected] domain=myIdentitydomain dataimportfilename=DailyPlanData.csv dataexportfilename=DailyTarget importdatajobname=LoadDailyPlan exportdatajobname=ExportDailyTarget br_clear=Clear Plan Targets br_calculatebalancesheet=Balance Sheet - Plan br_allocatetarget=Allocate Plan Targets SET password=%1 rem Executing EPM Automate commands CD /D %~dp0 call 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 logout IF %ERRORLEVEL% NEQ 0 goto :ERROR :EOF echo Scheduled Task Completed successfully exit /b %errorlevel% 3-8 Trabajo con EPM Automate para Oracle Enterprise Performance Management Cloud Escenarios de ejemplo de Oracle Planning and Budgeting Cloud :ERROR echo Failed with error #%errorlevel%. exit /b %errorlevel% Escenario 10: Automatización de la clonación de instancias Cree un archivo de lote (.bat) o shell (.sh) que contenga un script similar al siguiente para clonar una instancia. El siguiente script de ejemplo para Windows maneja estas actividades en la instancia de destino (clon): • Inicie sesión en la instancia de destino. • Prepare el entorno para aceptar los datos del origen. • Suprima el archivo Artifact Snapshot que se creó durante el último periodo de mantenimiento. • Copie Artifact Snapshot de la instancia de origen. • Importe los artefactos del archivo Artifact Snapshot en el destino. • Cierre la sesión. Note: En el siguiente script, se supone que pasa valores de parámetro con este formato como parte de la ejecución del script: clone username passwordsource URL source identity doamin target URL target password target identity domain. Por ejemplo, clone [email protected] P@ssw0rd https://test-cloudpln.pbcs.us1.oraclecloud.com myIdentityDomain https:// test-cloud-pln.pbcs.us2.oraclecloud.com P@ssw0rd2 myNewIdentityDomain. Note: Las instancias de origen y destino de este ejemplo utilizan distintos dominios de identidad. Antes de ejecutar este script, debe crear manualmente el conjunto de asignaciones de funciones y usuarios del origen en el dominio de identidad del destino. Consulte Automatización de la ejecución de scripts para obtener información sobre la programación del script con Programador de tareas de Windows. @echo off SET /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 ) Escenarios de ejemplo de ejecución de comandos 3-9 Escenarios de ejemplo de Oracle Planning and Budgeting Cloud set set set set set set set set IF /I %1=="help" goto :HELP REM echo %ARGS_COUNT% if %ARGS_COUNT% NEQ 7 ( goto :HELP ) user=%1 password=%2 url1=%3 domain=%4 url2=%5 tgtPassword=%6 tgtDomain=%7 returnValue=0 CD /D %~dp0 echo Login to Target Environment call epmautomate login %user% %tgtPassword% %url2% %tgtDomain% IF %ERRORLEVEL% NEQ 0 ( echo Login into target environment failed with error %ERRORLEVEL%. goto :END ) echo Recreating Target Environment call epmautomate recreate -f IF %ERRORLEVEL% NEQ 0 ( echo Recreate failed on target environment with error %ERRORLEVEL%. goto :END ) echo Deleting Old Artifact Snapshot from the Target Environment call epmautomate deletefile "Artifact Snapshot" > NUL IF %ERRORLEVEL% NEQ 0 ( IF %ERRORLEVEL% NEQ 8 ( echo deletefile failed on target environment with error %ERRORLEVEL%. goto :END ) ) echo Copying Artifact Snapashot from the Source Environment to Target call epmautomate copysnapshotfrominstance "Artifact Snapshot" %password% %url1% %domain% IF %ERRORLEVEL% NEQ 0 ( echo Login into target environment failed with error %ERRORLEVEL%. goto :END ) echo Importing Snapshot into the Target Environment call epmautomate importsnapshot "Artifact Snapshot" IF %ERRORLEVEL% NEQ 0 ( echo Restore failed on target environment with error %ERRORLEVEL%. goto :END ) echo Logging out from the Target Environment call epmautomate logout IF %ERRORLEVEL% NEQ 0 ( echo Logout failed with error %ERRORLEVEL%. goto :END ) echo Clone on target completed 3-10 Trabajo con EPM Automate para Oracle Enterprise Performance Management Cloud Escenarios de ejemplo de Oracle Account Reconciliation Cloud :printOnConsole echo. echo %1 echo. :HELP echo. echo Usage : Clone ^<user name^> ^<Source password^> ^<Source domain^> ^<Source URL^> ^<Target URL^> ^<Target password^> ^<Target domain^> echo All the values are mandatory for clone to execute exit /B 0 :END set returnValue=%ERRORLEVEL% exit /B %returnValue% Escenarios de ejemplo de Oracle Account Reconciliation Cloud • Escenario 1: Carga de balances preformateados en un periodo • Escenario 2: Uso de una instantánea para la recuperación de un bloqueo En esos escenarios, se utiliza una secuencia de comandos para completar diversas actividades con la utilidad EPM Automate. Se utilizan las siguientes credenciales ficticias para iniciar sesión en una instancia de servicio de ejemplo: • Nombre de usuario: serviceAdmin • Archivo de contraseñas: C:/mySecuredir/password.epw Este archivo se crea manualmente. Consulte el comando encrypt en Comandos de la utilidad EPM Automate aplicables a todos los servicios. • URL de servicio: https://test-cloud-arcs.us1.oraclecloud.com • Dominio de identidad: myARCSDomain Escenario 1: Carga de balances preformateados en un periodo En este escenario, puede ejecutar una secuencia de comandos para completar estos pasos: • Inicie sesión en la instancia. • Cargue los datos del balance preformateado en Oracle Account Reconciliation Cloud desde C:/Staging/April15Bal.csv, creado con una aplicación de libro mayor de terceros. • Importe los datos asignados de April15Bal.csv a April 2015. • Suprima April15Bal.csv de Oracle Account Reconciliation Cloud. • Cierre la sesión. epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloud-arcs.us1.oraclecloud.com myARCSDomain epmautomate uploadfile “C:/Staging/ARMBalUpload.csv” epmautomate importpremappedbalances “April 2015” ARMBalUPload.csv epmautomate deletefile ARMBalUpload.csv epmautomate logout Escenarios de ejemplo de ejecución de comandos 3-11 Automatización de la ejecución de scripts Escenario 2: Uso de una instantánea para la recuperación de un bloqueo 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. Restauración de datos y artefactos En este escenario, puede ejecutar una secuencia de comandos para completar estos pasos: • Inicie sesión en la instancia. • Cargue la instantánea C:/dailybackups/April15FullApp, de la que se ha realizado una copia de seguridad, en el servicio. • Importe los artefactos y los datos de April15FullApp. • Suprima April15FullApp. • Cierre la sesión. epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloud-arcs.us1.oraclecloud.com myARCSDomain epmautomate uploadfile “C:/dailybackups/April15FullApp” epmautomate importsnapshot April15FullApp epmautomate deletefile “April15FullApp” mautomate logout Automatización de la ejecución de scripts Un administrador de servicio programa scripts en Programador de tareas de Windows o utiliza un trabajo cron para automatizar actividades con la utilidad EPM Automate. Para programar la ejecución de scripts de la utilidad EPM Automate con Programador de tareas de Windows: 1. Haga clic en Inicio, en Panel de control y, a continuación, en Herramientas administrativas. 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, haga clic en Siguiente. 5. En Disparador de tarea, seleccione un programa para ejecutar el script y, a continuación, haga clic en Siguiente. 6. En la siguiente pantalla, especifique otros parámetros de programación y, a continuació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: 3-12 Trabajo con EPM Automate para Oracle Enterprise Performance Management Cloud Supervisión de actividades de la utilidad EPM Automate a. En Programa/script seleccione el script que desea programar. b. En Agregar argumentos (opcional), introduzca la contraseña del administrador de servicio identificado por el parámetro de script SET user. c. En Empezar en (opcional), introduzca la ubicación en la que está instalada la utilidad EPM Automate, 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 clic en Finalizar y, a continuación, haga clic en Finalizar. 10. En General, seleccione estas opciones de seguridad y, a continuación, haga clic en Aceptar. • Ejecutar si el usuario está o no conectado • Ejecutar con los privilegios más altos Supervisión de actividades de la utilidad EPM Automate Para ayudarle a identificar el estado de la operación que ha inicializado, la utilidad muestra los códigos de estado en la consola desde la que ejecuta la utilidad EPM Automate. Consulte Códigos de estado. Utilice la consola de trabajos de Oracle Hyperion Planning para supervisar los trabajos que ejecute mediante la utilidad EPM Automate. Consulte Comprobación del estado del trabajo en Trabajo con Planning para Oracle Planning and Budgeting Cloud Service para obtener más información. Escenarios de ejemplo de ejecución de comandos 3-13 Supervisión de actividades de la utilidad EPM Automate 3-14 Trabajo con EPM Automate para Oracle Enterprise Performance Management Cloud