Ejecución de reglas de datos

Ejecuta una regla de carga de datos de Oracle Hyperion Financial Data Quality Management, Enterprise Edition basada en el período de inicio y el período de finalización y las opciones de importación y exportación que especifique.

Requisitos

  • Reglas de datos: las reglas de carga de datos definen cómo carga Integrations los datos desde un archivo. Deben existir reglas de carga de datos predefinidas para cargar los datos.

  • Debe contar con los privilegios necesarios para ejecutar una regla de datos específica.

Recurso REST

POST /aif/rest/{api_version}/jobs

Solicitud

Tipos de medio admitidos: application/json

Parámetros

En la siguiente tabla se resume la solicitud del cliente.

Tabla A-1 Parámetros

Nombre Descripción Tipo Obligatorio Valor predeterminado
api_version Versión de la API con la que está trabajando; por ejemplo, V1 Ruta Ninguno
jobType Se debe establecer en "DATARULE"   Ninguno
jobName Nombre de una regla de carga de datos definida en FDMEE. Debe entrecomillar el nombre de la regla si contiene un espacio.   Ninguno
startPeriod Primer período para el que se van a cargar los datos. Este nombre de período debe definirse en la asignación de períodos de FDMEE.   Ninguno
endPeriod Último período para el que se van a cargar los datos. Este nombre de período debe definirse en la asignación de períodos de FDMEE.   Ninguno
importMode Determina el modo en el que se importan los datos en FDMEE.

Estos son los valores aceptables:

  • APPEND para agregar los datos de PDV existentes a FDMEE

  • REPLACE para suprimir los datos de PDV y reemplazarlos por los datos del archivo

  • RECALCULATE para omitir la importación de los datos y volver a procesar los datos con cuentas lógicas y de asignaciones actualizadas.

  • NONE para omitir la importación de datos a la tabla temporal de FDMEE

  Ninguno
exportMode Determina el modo en el que se exportan los datos a FDMEE.

Los valores aceptables de la aplicación Oracle Hyperion Planning son:

  • STORE_DATA para fusionar los datos de la tabla temporal de FDMEE con los datos de Planning existentes

  • ADD_DATA para agregar los datos de la tabla temporal de FDMEE a Planning

  • SUBTRACT_DATA para restar los datos de la tabla temporal de FDMEE a los datos de Planning existentes

  • REPLACE_DATA para borrar los datos de PDV y reemplazarlos por los datos de la tabla temporal de FDMEE. Se borran los datos de Escenario, Versión, Año, Periodo y Entidad

  • NONE para omitir la exportación de datos de FDMEE a Planning

Los valores aceptables de las aplicaciones Financial Consolidation and Close y Tax Reporting son:

  • MERGE: de forma predeterminada, toda la carga de datos se procesa en el modo de fusión. Si los datos ya existían en la aplicación, el sistema sobrescribe los datos existentes con los nuevos datos del archivo de carga. Si no existen datos, se crearán los nuevos datos.

  • REPLACE: en primer lugar, el sistema borra los datos existentes en la aplicación y los reemplaza por los referenciados en el archivo de carga de datos. A continuación, el sistema realiza la carga de datos en el modo de fusión.

  • NONE: omite la exportación de datos de FDMEE a Financial Consolidation and Close

  Ninguno
fileName Nombre de archivo opcional. Si no especifica ningún nombre de archivo, la API importa los datos incluidos en el nombre de archivo especificado en la regla de carga de datos. El archivo de datos debe residir en INBOX antes de la ejecución de la regla de datos.   Ninguno

URL de ejemplo

https://<NOMBRE_SERVICIO>-<NOMBRE_INQUILINO>.<dcX>.oraclecloud.com/aif/rest/V1/jobs

Ejemplo de cuerpo de solicitud

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

Respuesta

Tipos de medio admitidos: application/json

Tabla A-2 Parámetros

Nombre Descripción

status

Estado del trabajo: -1 = en curso; 0 = correcto; 1 = error; 2 = pendiente de cancelación; 3 = cancelado; 4 = parámetro no válido

jobStatus

Texto que representa el estado del trabajo con uno de los valores siguientes: "RUNNING", "SUCCESS". "FAILED"

jobId

Identificador de proceso generado en FDMEE para el trabajo

logFileName

Archivo de registro que contiene las entradas de esta ejecución.

outputFileName

Nombre del archivo de salida generado, si lo hay.

processType

Tipo de proceso ejecutado. Incluirá "COMM_LOAD_BALANCES" para todas las ejecuciones de la regla de datos

executedBy

Nombre de inicio de sesión del usuario utilizado para ejecutar la regla.

details

Devuelve el rastreo de pila de excepciones en caso de error de aplicación

Ejemplo de cuerpo de respuesta

A continuación se muestra un ejemplo de cuerpo de respuesta con formato 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

}