Téléchargement d'un fichier de données dans un environnement et exécution d'une règle de chargement de données

Utilisez ces scripts pour charger un fichier dans un environnement et exécuter une règle de données afin d'importer les données du fichier dans une application.

Prérequis

Les définitions suivantes dans la gestion des données :
- une définition de règle de chargement de données nommée VisionActual ;. Nous partons du principe que la règle de données n'indique pas de chemin de fichier pour le fichier d'entrée.
- les définitions des périodes du Mar-15 au Jun-15.
Un fichier de données correctement formaté (GLActual.dat) qui contient des données.

Pour importer des données et exécuter une règle de chargement des données, exécutez les commandes permettant de réaliser les étapes suivantes :

Vous connecter à l'environnement.
Télécharger un fichier GLActual.dat qui contient des données des périodes du Mar-15 au Jun-15 dans le dossier de gestion des données inbox/Vision.
Importer les données du fichier GLActual.dat dans la gestion des données à l'aide de la règle de chargement des données VisionActual, de la période de début Mar-15, de la période de fin Jun-15 et du mode d'import REPLACE.
Exporter les données avec l'option STORE_DATA pour fusionner les données de la table intermédiaire de gestion des données avec les données d'application existantes.
Vous déconnecter.

Exemple de script Windows

Créez runDataLoadRule.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)"
$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

Exemple de script Linux/UNIX

Créez runDataLoadRule.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 "${datafile}" "${dataFileUploadLocation}"
${epmautomatescript} rundatarule "${dataRuleName}" "${startPeriod}" "${endPeriod}" "${importMode}" "${exportMode}" "${dataFileUploadLocation}/${dataFile}"
${epmautomatescript} logout

Création du fichier input.properties

Créez le fichier input.properties en copiant l'un des exemples suivants et en le mettant à jour avec les informations de votre environnement. Enregistrez le fichier dans le répertoire dans lequel runDataLoadRule.ps1 ou runDataLoadRule.sh est stocké.

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

Tableau 3-21 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é.
`dataFile`	Fichier qui contient les données à importer à l'aide de la règle de données.
`dataFileUploadLocation`	Emplacement dans lequel charger le fichier de données.
`dataRuleName`	Nom d'une règle de chargement de données définie dans l'intégration des données.
`startPeriod`	Première période pour laquelle les données doivent être chargées. Ce nom de période doit être défini dans le mapping de période de l'intégration des données.
`endPeriod`	Pour un chargement de données multipériode, dernière période pour laquelle des données doivent être chargées. Pour un chargement de période unique, utilisez la même période que la période de début. Ce nom de période doit être défini dans le mapping de période de l'intégration des données.
`importMode`	Mode d'import des données dans l'intégration des données. Utilisez `APPEND`, `REPLACE` ou `RECALCULATE`. Utilisez `NONE` pour ignorer l'import de données dans les tables intermédiaires.
`exportMode`	Mode d'export des données vers l'application. Utilisez l'intégration des données. Utilisez `STORE_DATA`, `ADD_DATA`, `SUBTRACT_DATA` ou `REPLACE_DATA`. Utilisez `NONE` pour ignorer l'export de données de l'intégration des données vers l'application. Remarque : Financial Consolidation and Close prend uniquement en charge les modes `MERGE` et `NONE`.

Exécution du script

Créez runDataLoadRule.ps1 ou runDataLoadRule.sh en copiant le script d'une section précédente.
Créez le fichier input.properties et enregistrez-le dans le répertoire où se trouve le script runDataLoadRule. 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.
Lancez le script.
- Windows PowerShell : exécutez runDataLoadRule.ps1.
- Linux/UNIX : exécutez ./runDataLoadRule.sh.