Caricamento di un file di dati in un ambiente ed esecuzione di una regola di caricamento dati

Utilizzare questi script per caricare un file in un ambiente e quindi eseguire una regola dati per importare i dati dal file in un'applicazione.

Prerequisiti

  • In Gestione dati sono disponibili le seguenti definizioni:
    • Una definizione di regola di caricamento dati denominata VisionActual. Si presume che la regola dei dati non specifichi un percorso file per il file di input.
    • Definizioni di periodo da Mar-15 a Jun-15
  • Un file di dati con formato corretto (GLActual.dat) che contenga dati.

Per importare i dati ed eseguire una regola di caricamento dati è necessario eseguire i comandi per completare la seguente procedura.

  • Collegamento all'ambiente.
  • Caricare un file GLActual.dat che contiene dati per i periodi da Mar-15 a Jun-15 nella cartella inbox/Vision di Gestione dati.
  • Importare i dati da GLActual.dat in Gestione dati utilizzando la regola di caricamento dati VisionActual con periodo di inizio Mar-15, periodo di fine Jun-15 e modalità di importazione REPLACE.
  • Esportare i dati con l'opzione STORE_DATA per unire i dati della tabella intermedia di Data Management con i dati dell'applicazione esistenti.
  • Scollegarsi.

Script di esempio per Windows

Creare runDataLoadRule.ps1 copiando lo script seguente. Archiviarlo in una directory locale. 
$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 di esempio di Linux/UNIX

Creare runDataLoadRule.sh copiando lo script seguente. Archiviarlo in una directory locale. 
#!/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

Creazione del file input.properties

Creare il file input.properties copiando una delle opzioni indicate di seguito e aggiornandolo con le informazioni relative all'ambiente in uso. Salvare il file nella directory in cui è archiviato runDataLoadRule.ps1 o importMetadata.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

Tabella 3-21 Parametri di input.properties

Parametro Descrizione
javahome Posizione di JAVA_HOME. Solo per Linux/UNIX.
epmautomatescript Percorso assoluto dell'eseguibile di EPM Automate (epmautomate.sh). Solo per Linux/UNIX.
username Nome utente di un Amministratore servizi a cui è assegnato anche il ruolo Amministratore del dominio di Identity.
password Password dell'Amministratore servizi o nome e posizione del password file cifrato.
serviceURL URL dell'ambiente dal quale generare lo snapshot.
dataFile Il file che contiene i dati da importare usando la regola dati.
dataFileUploadLocation Posizione nella quale deve essere caricato il file di dati.
dataRuleName Il nome della regola di caricamento dati definito in Integrazione dati.
startPeriod Il primo periodo per il quale devono essere caricati i dati. È necessario definire questo nome di periodo nel mapping dei periodi di Integrazione dati.
endPeriod In caso di più periodi di caricamento dati, l'ultimo periodo per il quale caricare i dati. Se il caricamento è per un periodo singolo, usare lo stesso periodo come periodo di inizio. È necessario definire questo nome di periodo nel mapping dei periodi di Integrazione dati.
importMode Modalità per l'importazione di dati in Integrazione dati. Usare APPEND, REPLACE o RECALCULATE. Usare NONE per ignorare l'importazione di dati nelle tabelle intermedie.
exportMode Modalità per l'esportazione di dati nell'applicazione. Utilizzare Integrazione dati. Utilizzare STORE_DATA, ADD_DATA, SUBTRACT_DATA o REPLACE_DATA. Utilizzare NONE per ignorare l'esportazione di dati da Integrazione dati nell'applicazione.

Nota:

In Financial Consolidation and Close sono supportate solo le modalità MERGE e NONE.

Esecuzione dello script

  1. Creare runDataLoadRule.ps1 o runDataLoadRule.sh copiando lo script da una sezione precedente.
  2. Creare il file input.properties e salvarlo nella directory in cui è memorizzato lo script runDataLoadRule. Il contenuto di questo file varia a seconda del sistema operativo. Fare riferimento alla sezione Creazione del file input.properties.

    Assicurarsi di avere i privilegi di scrittura in questa directory. Per Windows, potrebbe essere necessario avviare PowerShell utilizzando l'opzione Esegui come amministratore per poter essere in grado di eseguire lo script.

  3. Avviare lo script.
    • Windows PowerShell: eseguire runDataLoadRule.ps1.
    • Linux/UNIX: eseguire ./runDataLoadRule.sh.