Import de données et exécution de règles de programme

Utilisez ces scripts pour charger des fichiers de données et importer les données des fichiers chargés dans un processus métier Profitability and Cost Management.

Les scripts effectuent les étapes suivantes :

  • Connexion à l'environnement.
  • Chargement d'un fichier contenant les données à charger.
  • Chargement d'un fichier contenant des règles de données.
  • Chargement des données du fichier de données dans l'application pour remplacer les valeurs existantes.
  • Exécution de toutes les règles du fichier de règles.
  • Déconnexion.

Script Windows

Créez un fichier nommé importData.ps1 en copiant le script suivant. Stockez-le dans un répertoire local. 
$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

Script Linux/UNIX

Créez un fichier nommé importData.sh en copiant le script suivant. Stockez-le dans un répertoire local. 
#!/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

Création du fichier input.properties

Pour exécuter les scripts importData, créez le fichier input.properties et mettez-le à jour avec les informations de votre environnement. Enregistrez le fichier dans le répertoire dans lequel importData.ps1 ou importData.sh est stocké.

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

Tableau 3-26 Paramètres du fichier input.properties

Paramètre  Description
javahome Emplacement de JAVA_HOME. Pour Linux/UNIX uniquement.
epmautomatescript Chemin absolu de l'exécutable EPM Automate (epmautomate.sh). Pour Linux/UNIX uniquement.
username Nom d'utilisateur d'un administrateur de service disposant également du rôle Administrateur de domaine d'identité.
password Mot de passe de l'administrateur de service, ou nom et emplacement du fichier de mots de passe cryptés.
serviceURL URL de l'environnement à partir duquel générer l'instantané.
applicationName Nom de l'application Profitability and Cost Management dans laquelle charger les données.
dataFileName Nom du fichier contenant les données à importer.
rulesFileName Nom du fichier contenant les règles à exécuter sur les données importées.
fileDestination Emplacement dans lequel charger les fichiers de données et de règles.
clearAllDataFlag Indique si les données existantes doivent être effacées dans le cube d'application. Définissez ce paramètre sur false si vous ne voulez pas effacer les données existantes.
dataLoadValue Indique comment gérer les données existantes. Indiquez ADD_TO_EXISTING pour conserver les données existantes du cube.

Exécution des scripts

  1. Créez importData.ps1 ou importData.sh en copiant le script d'une section précédente.
  2. Créez le fichier input.properties et enregistrez-le dans le répertoire où se trouve le script importData. Le contenu de ce fichier varie en fonction du système d'exploitation. Reportez-vous à la section Création du fichier input.properties.

    Assurez-vous que vous disposez de privilèges d'écriture sur ce répertoire. Pour Windows, vous devrez peut-être démarrer PowerShell à l'aide de l'option Exécuter en tant qu'administrateur afin de pouvoir exécuter le script.

  3. Lancez le script.
    • Windows PowerShell : exécutez importData.ps1.
    • Linux/UNIX : exécutez ./importData.sh.