Eine Datendatei in eine Umgebung hochladen und eine Dataload-Regel ausführen

Verwenden Sie diese Skripte , um eine Datei in eine Umgebung hochzuladen, und führen Sie dann eine Datenregel aus, um Daten aus der Datei in eine Anwendung zu importieren.

Voraussetzungen

Die folgenden Definitionen in Data Management:
- Eine Dataload-Regeldefinition namens VisionActual. Es wird davon ausgegangen, dass die Datenregel keinen Dateipfad für die Eingabedatei angibt.
- Periodendefinitionen Mar-15 bis Jun-15
Eine ordnungsgemäß formatierte Datendatei (GLActual.dat), die Daten enthält.

Um Daten zu importieren und Dataload-Regeln auszuführen, müssen Sie Befehle ausführen, die die folgenden Schritte abschließen:

Anmeldung bei der Umgebung
Laden Sie eine Datei GLActual.dat, die Daten für die Perioden Mar-15 bis Jun-15 enthält, in den Data Management-Ordner inbox/Vision hoch.
Importieren Sie Daten aus GLActual.dat in Data Management mit der Dataload-Regel VisionActual, Startperiode Mar-15, Endperiode Jun-15 und Importmodus REPLACE.
Exportieren Sie Daten mit der Option STORE_DATA, um die Daten in der Staging-Tabelle der Komponente Datenmanagement mit vorhandenen Anwendungsdaten zusammenzuführen.
Melden Sie sich ab.

Windows-Beispielskript

Erstellen Sie die Datei runDataLoadRule.ps1, indem Sie das folgende Skript kopieren. Speichern Sie die Datei in einem lokalen Verzeichnis.

$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

Linux-/UNIX-Beispielskript

Erstellen Sie die Datei runDataLoadRule.sh, indem Sie das folgende Skript kopieren. Speichern Sie die Datei in einem lokalen Verzeichnis.

#!/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

Datei "input.properties" erstellen

Erstellen Sie die Datei input.properties, indem Sie eines der folgenden Skripte kopieren, und aktualisieren Sie sie mit Informationen für Ihre Umgebung. Speichern Sie die Datei im selben Verzeichnis, in dem die Datei runDataLoadRule.ps1 oder runDataLoadRule.sh gespeichert ist.

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

Tabelle 3-21 Parameter für "input.properties"

Parameter	Beschreibung
`javahome`	Verzeichnis `JAVA_HOME`. Nur für Linux/UNIX.
`epmautomatescript`	Absoluter Pfad der ausführbaren Datei für EPM Automate (`epmautomate.sh`). Nur für Linux/UNIX.
`username`	Benutzername eines Serviceadministrators, der auch über die Rolle Identitätsdomainadministrator verfügt.
`password`	Kennwort des Serviceadministrators oder Name und Speicherort der verschlüsselten Kennwortdatei.
`serviceURL`	URL der Umgebung, aus der Sie den Snapshot generieren möchten.
`dataFile`	Die Datei, die die Daten enthält, die mit der Datenregel importiert werden sollen.
`dataFileUploadLocation`	Speicherort, an den die Datendatei hochgeladen werden soll.
`dataRuleName`	Name einer in der Komponente Datenintegration definierten Dataload-Regel.
`startPeriod`	Erste Periode, für die Daten geladen werden sollen. Dieser Periodenname muss in der Periodenzuordnung der Komponente Datenintegration definiert sein.
`endPeriod`	Bei Dataloads für mehrere Perioden ist dies die letzte Periode, für die Daten geladen werden sollen. Bei Dataloads für eine einzelne Periode ist dies dieselbe Periode wie die Startperiode. Dieser Periodenname muss in der Periodenzuordnung der Komponente Datenintegration definiert sein.
`importMode`	Modus des Datenimports in die Komponente Datenintegration. Verwenden Sie die Werte `APPEND`, `REPLACE` oder `RECALCULATE`. Verwenden Sie den Wert `NONE`, um den Datenimport in Staging-Tabellen zu überspringen.
`exportMode`	Modus des Datenexports in die Anwendung. Verwenden Sie die Komponente Datenintegration. Verwenden Sie die Werte `STORE_DATA`, `ADD_DATA`, `SUBTRACT_DATA` oder `REPLACE_DATA`. Verwenden Sie den Wert `NONE`, um den Datenexport aus der Komponente Datenintegration in die Anwendung zu überspringen. Hinweis: Financial Consolidation and Close unterstützt nur die Modi `MERGE` und `NONE`.

Skripte ausführen

Erstellen Sie die Datei runDataLoadRule.ps1 oder runDataLoadRule.sh, indem Sie das Skript aus einem vorhergehenden Abschnitt kopieren.
Erstellen Sie die Datei input.properties, und speichern Sie sie im selben Verzeichnis, in dem sich das Skript runDataLoadRule befindet. Die Inhalte dieser Datei unterscheiden sich je nach Betriebssystem. Informationen hierzu finden Sie unter Datei "input.properties" erstellen.
Stellen Sie sicher, dass Sie Schreibrechte in diesem Verzeichnis haben. Unter Windows müssen Sie möglicherweise PowerShell mit der Option Als Administrator ausführen starten, um das Skript ausführen zu können.
Starten Sie das Skript.
- Windows PowerShell: Führen Sie die Datei runDataLoadRule.ps1 aus.
- Linux/UNIX: Führen Sie die Datei ./runDataLoadRule.sh aus.