Daten importieren und Programmregeln ausführen

Verwenden Sie diese Skripte, um Datendateien hochzuladen und Daten aus den hochgeladenen Dateien in einen Profitability and Cost Management-Geschäftsprozess zu importieren.

Diese Skripte führen die folgenden Schritte aus:

  • Anmeldung bei der Umgebung
  • Upload einer Datendatei mit den zu ladenden Daten
  • Upload einer Regeldatei mit Datenregeln
  • Laden von Daten aus der Datendatei in die Anwendung, um vorhandene Werte zu überschreiben
  • Ausführen aller Regeln in der Regeldatei
  • Abmeldung

Windows-Skript

Erstellen Sie eine Datei namens importData.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)"
$applicationName="$($inputproperties.applicationName)"
$dataFileName="$($inputproperties.dataFileName)"
$rulesFileName="$($inputproperties.rulesFileName)"
$fileDestination="$($inputproperties.fileDestination)"
$clearAllDataFlag="$($inputproperties.clearAllDataFlag)"
$dataLoadValue="$($inputproperties.dataLoadValue)"

epmautomate login ${username} ${passwordfile} ${serviceURL}
epmautomate uploadfile "${dataFileName}" ${fileDestination}
epmautomate uploadfile "${rulesFileName}" ${fileDestination}
epmautomate loaddata ${applicationName} clearAllDataFlag=${clearAllDataFlag} dataLoadValue=${dataLoadValue} rulesFileName="${rulesFileName}" dataFileName="${dataFileName}"
epmautomate logout

Linux-/UNIX-Skript

Erstellen Sie eine Datei namens importData.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 "${dataFileName}" "${fileDestination}"
${epmautomatescript} uploadfile "${rulesFileName}" "${fileDestination}"
${epmautomatescript} loaddata "${applicationName}" "clearAllDataFlag=${clearAllDataFlag}" "dataLoadValue=${dataLoadValue}" rulesFileName="${rulesFileName}" dataFileName="${dataFileName}"
${epmautomatescript} logout

Datei "input.properties" erstellen

Um die importData-Skripte auszuführen, erstellen Sie die Datei input.properties, und aktualisieren Sie sie mit den Informationen für Ihre Umgebung. Speichern Sie die Datei im selben Verzeichnis, in dem die Datei importData.ps1 oder importData.sh gespeichert ist.

Windows

username=exampleAdmin
passwordfile=examplePassword.epw
serviceURL=exampleURL
applicationName=APPLICATION_NAME
dataFileName=DATA_FILE.txt
rulesFileName=RULE_FILE.txt
fileDestination=profitinbox
clearAllDataFlag=true
dataLoadValue=OVERWRITE_EXISTING_VALUES
Linux/UNIX 
javahome=JAVA_HOME
epmautomatescript=EPM_AUTOMATE_LOCATION
username=exampleAdmin
passwordfile=examplePassword.epw
serviceURL=exampleURL
applicationName=APPLICATION_NAME
dataFileName=DATA_FILE.txt
rulesFileName=RULE_FILE.txt
fileDestination=profitinbox
clearAllDataFlag=true
dataLoadValue=OVERWRITE_EXISTING_VALUES

Tabelle 3-26 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.
applicationName Name der Profitability and Cost Management-Anwendung, in die Daten geladen werden sollen.
dataFileName Name der Datei, die die zu importierenden Daten enthält.
rulesFileName Name der Datei, die die Regeln enthält, die für die importierten Daten ausgeführt werden sollen.
fileDestination Speicherort, an den die Daten und Regeldateien hochgeladen werden sollen.
clearAllDataFlag Gibt an, ob vorhandene Daten im Anwendungs-Cube gelöscht werden sollen. Wenn Sie nicht möchten, dass vorhandene Daten gelöscht werden, setzen Sie diesen Parameter auf false.
dataLoadValue Gibt an, wie vorhandene Daten behandelt werden sollen. Wenn Sie möchten, dass vorhandene Daten im Cube beibehalten werden, setzen Sie diesen Parameter auf ADD_TO_EXISTING.

Skripte ausführen

  1. Erstellen Sie die Datei importData.ps1 oder importData.sh, indem Sie das Skript aus einem vorhergehenden Abschnitt kopieren.
  2. Erstellen Sie die Datei input.properties, und speichern Sie sie im selben Verzeichnis, in dem sich das Skript importData 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.

  3. Starten Sie das Skript.
    • Windows PowerShell: Führen Sie die Datei importData.ps1 aus.
    • Linux/UNIX: Führen Sie die Datei ./importData.sh aus.