Exécution de règles de données

Exécute une règle de chargement des données Oracle Hyperion Financial Data Quality Management, Enterprise Edition en fonction de la période de début et de la période de fin, ainsi que des options d'import et d'export que vous avez indiquées.

Prérequis

  • Règles de données : les règles de chargement des données définissent comment Integrations charge des données à partir d'un fichier. Vous devez disposer de règles de chargement des données prédéfinies pour charger des données.

  • Vous devez disposer des privilèges requis pour pouvoir exécuter une règle de données spécifique.

Ressource REST

POST /aif/rest/{api_version}/jobs

Demande

Types de support pris en charge : application/json

Paramètres

Le tableau suivant récapitule la demande client.

Tableau A-1 Paramètres

Nom Description Type Obligatoire Valeur par défaut
api_version Version de l'API avec laquelle vous travaillez, par exemple, V1 Chemin Oui Aucun
jobType Doit être défini sur "DATARULE"   Oui Aucun
jobName Nom de la règle de chargement des données définie dans FDMEE. Vous devez placer le nom de la règle entre guillemets s'il contient un espace.   Oui Aucun
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 FDMEE.   Oui Aucun
endPeriod Derniè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 FDMEE.   Oui Aucun
importMode Détermine le mode d'import des données vers FDMEE.

Les valeurs acceptables sont les suivantes :

  • APPEND pour les ajouter aux données de PDV existantes dans FDMEE

  • REPLACE pour supprimer les données de PDV et les remplacer par celles du fichier.

  • RECALCULATE pour ignorer l'import des données, mais retraiter les données avec les comptes logiques et les mappings mis à jour.

  • NONE pour ignorer l'import des données dans la table intermédiaire FDMEE

   Oui Aucun
exportMode Détermine le mode d'export des données vers FDMEE.

Valeurs acceptables pour une application Oracle Hyperion Planning :

  • STORE_DATA pour fusionner les données de la table intermédiaire FDMEE avec les données Planning existantes.

  • ADD_DATA pour ajouter les données de la table intermédiaire FDMEE à Planning.

  • SUBTRACT_DATA pour soustraire les données de la table intermédiaire FDMEE des données Planning existantes.

  • REPLACE_DATA pour effacer les données de PDV et les remplacer par des données dans la table intermédiaire FDMEE. Les données sont effacées pour Scénario, Version, Année, Période et Entité.

  • NONE pour ignorer l'export des données à partir de FDMEE vers Planning.

Valeurs acceptables pour les applications Financial Consolidation and Close et Tax Reporting :

  • MERGE : par défaut, le chargement de l'ensemble des données est traité dans le mode Fusionner. Si les données existaient déjà dans l'application, le système remplace les données existantes par les nouvelles données du fichier de chargement. Si les données n'existent pas, les données sont créées.

  • REPLACE : dans un premier temps, le système remplace les données existantes dans l'application par celles référencées dans le fichier de chargement des données. Le système effectue ensuite le chargement des données en mode Fusionner.

  • NONE : ignore l'export des données de FDMEE vers Financial Consolidation and Close

   Oui Aucun
fileName Nom de fichier facultatif. Si vous n'indiquez aucun nom de fichier, cette API importe les données contenues dans le fichier spécifié dans la règle de chargement des données. Le fichier de données doit déjà résider dans la boîte de réception avant l'exécution de la règle de données.   Oui Aucun

Exemple d'URL

https://<SERVICE_NAME>-<TENANT_NAME>.<dcX>.oraclecloud.com/aif/rest/V1/jobs

Exemple de corps de demande

{"jobType":"DATARULE",
"jobName":"aso to bso dr",
"startPeriod":"Dec-18",
"endPeriod":"Dec-18",
"importMode":"REPLACE",
"exportMode":"NONE",
"fileName":""
}

Réponse

Types de support pris en charge : application/json

Tableau A-2 Paramètres

Nom Description

status

Statut du job : -1 = en cours ; 0 = succès ; 1 = erreur ; 2 = annulation en attente ; 3 = annulé ; 4 = paramètre non valide

jobStatus

Représentation textuelle du statut du job, affichant l'une des valeurs suivantes : "RUNNING", "SUCCESS". "FAILED"

jobId

ID de processus généré dans FDMEE pour le job

logFileName

Fichier journal contenant les entrées de cette exécution.

outputFileName

Nom du fichier de sortie généré, le cas échéant.

processType

Type du processus exécuté. Contiendra "COMM_LOAD_BALANCES" pour toutes les exécutions de règle de données

executedBy

Nom de connexion de l'utilisateur pour exécuter la règle.

details

Renvoie la trace de pile d'exception en cas d'erreur d'application

Exemple de corps de réponse

L'exemple suivant illustre un corps de réponse au format JSON.

{
    "jobStatus": "RUNNING"
"jobId": 2019
"logFileName": "\outbox\logs\Account Reconciliation Manager_2019.log"
"outputFileName": null
"processType": "COMM_LOAD_BALANCES"
"executedBy": "admin"
"status": -1
"links": [1]
    0:  {
    "rel": "self"
    "href": "https://<SERVICE_NAME>-<TENANT_NAME>.<dcX>.oraclecloud.com/aif/rest/V1/jobs/2019"
    "action": "GET"
}
"details": null

}