Carga de un archivo de datos en un entorno y ejecución de una regla de carga de datos

Utilice estos scripts para cargar un archivo en un entorno y, a continuación, ejecutar una regla de datos para importar datos del archivo en una aplicación.

Requisitos previos

  • Las siguientes definiciones en Data Management:
    • Definición de regla de carga de datos denominada VisionActual. Se supone que la regla de datos no especifica una ruta de archivo para el archivo de entrada.
    • Definiciones de periodos del Mar-15 al Jun-15
  • Archivo de datos con el formato correcto (GLActual.dat) que contenga datos.

Para importar datos y ejecutar una regla de carga de datos, ejecute comandos para realizar estos pasos:

  • Inicie sesión en el entorno.
  • Cargue un archivo GLActual.dat que contenga datos para los periodos del Mar-15 al Jun-15 en la carpeta inbox/Vision de Data Management.
  • Importe los datos de GLActual.dat a Data Management 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 temporal de Data Management con los datos de la aplicación existentes.
  • Cierre la sesión.

Script de Windows de ejemplo

Cree runDataLoadRule.ps1 copiando el siguiente script. Almacénelo en un directorio local. 
$inputproperties = ConvertFrom-StringData(Get-Content ./input.properties -raw)
$username="$($inputproperties.username)"
$passwordfile="$($inputproperties.passwordfile)"
$serviceURL="$($inputproperties.serviceURL)"
$dataFile="$($inputproperties.dataFile)"
$dataRuleName="$($inputproperties.dataRuleName)"
$startPeriod="$($inputproperties.startPeriod)"
$endPeriod="$($inputproperties.endPeriod)"
$importMode="$($inputproperties.importMode)"
$exportMode="$($inputproperties.exportMode)"

epmautomate login ${username} ${passwordfile} ${serviceURL}
epmautomate uploadfile ${datafile} ${dataFileUploadLocation}
epmautomate rundatarule ${dataRuleName} ${startPeriod} ${endPeriod} ${importMode} ${exportMode} ${dataFileUploadLocation}/${dataFile}
epmautomate logout

Script de Linux/UNIX de ejemplo

Cree runDataLoadRule.sh copiando el siguiente script. Almacénelo en un directorio local. 
#!/bin/bash
. ./input.properties
export JAVA_HOME=${javahome}
${epmautomatescript} login "${username}" "${passwordfile}" "${serviceURL}"
${epmautomatescript} uploadfile "${datafile}" "${dataFileUploadLocation}"
${epmautomatescript} rundatarule "${dataRuleName}" "${startPeriod}" "${endPeriod}" "${importMode}" "${exportMode}" "${dataFileUploadLocation}/${dataFile}"
${epmautomatescript} logout

Creación del archivo input.properties

Cree el archivo input.properties copiando uno de los siguientes scripts y actualizándolo con información para su entorno. Guarde el archivo en el directorio en el que está almacenado runDataLoadRule.ps1 o runDataLoadRule.sh.

Windows 
username=serviceAdmin
passwordfile=./password.epw
serviceURL=https://example.oraclecloud.com
dataFile=GLActual.dat
dataFileUploadLocation=UPLOAD_LOCATION
dataRuleName=RULE_NAME
startPeriod=START_PERIOD
endPeriod=END_PERIOD
importMode=IMPORT_MODE
exportMode=EXPORT_MODE
Linux/UNIX 
javahome=JAVA_HOME
epmautomatescript=EPM_AUTOMATE_LOCATION
username=exampleAdmin
passwordfile=examplePassword.epw
serviceURL=exampleURLdataFile=GLActual.dat
dataFileUploadLocation=UPLOAD_LOCATION
dataRuleName=RULE_NAME
startPeriod=START_PERIOD
endPeriod=END_PERIOD
importMode=IMPORT_MODE
exportMode=EXPORT_MODE

Tabla 3-21 Parámetros de input.properties

Parámetro Descripción
javahome Ubicación JAVA_HOME. Solo para Linux/UNIX.
epmautomatescript Ruta de acceso absoluta del ejecutable de EPM Automate (epmautomate.sh). Solo para Linux/UNIX.
username Nombre de usuario de un administrador del servicio que también tiene asignado el rol de administrador del dominio de identidad.
password Contraseña del administrador de servicio o el nombre y la ubicación del archivo de contraseña cifrado.
serviceURL URL del entorno a partir del cual desea generar la instantánea.
dataFile Archivo que contiene los datos que se importarán utilizando la regla de datos.
dataFileUploadLocation Ubicación en la que se cargarán los archivos de datos.
dataRuleName Nombre de una regla de carga de datos definida en Data Integration.
startPeriod Primer período para el que se van a cargar los datos. Este nombre de período debe estar definido en la asignación de períodos de Data Integration.
endPeriod Para una carga de datos de varios períodos, el último período para el que cargarán los datos. Para una carga de un único período, introduzca el mismo período como período inicial. Este nombre de período debe estar definido en la asignación de períodos de Data Integration.
importMode Modo para importar datos en Data Integration. Utilice APPEND, REPLACE o RECALCULATE. Utilice NONE para omitir la importación de datos en las tablas temporales.
exportMode Modo para exportar datos a la aplicación. Utilice Data Integration. Utilice STORE_DATA, ADD_DATA, SUBTRACT_DATA o REPLACE_DATA. Utilice NONE para omitir la exportación de datos de Data Integration a la aplicación.

Nota:

Financial Consolidation and Close solo soporta los modos MERGE y NONE.

Ejecución del script

  1. Cree runDataLoadRule.ps1 o runDataLoadRule.sh copiando el script de una sección anterior.
  2. Cree el archivo input.properties y guárdelo en el directorio en el que está ubicado el script runDataLoadRule. El contenido de este archivo difiere según su sistema operativo. Consulte Creación del archivo input.properties.

    Asegúrese de que tiene privilegios de escritura en este directorio. Para Windows, puede que necesite iniciar PowerShell mediante la opción Ejecutar como administrador para poder ejecutar el script.

  3. Inicie el script.
    • Windows PowerShell: ejecute runDataLoadRule.ps1.
    • Linux/UNIX: ejecute ./runDataLoadRule.sh.