runIntegration

Se aplica a

Roles necesarios

Sintaxis

• En las integraciones de modalidad estándar, debe especificar los valores para importMode, exportMode y periodName
• En las integraciones de modalidad rápida, debe especificar el valor para exportMode
• Los nombres de parámetros y sus valores distinguen mayúsculas y minúsculas

• JOB_NAME es el nombre de un trabajo de integración definido en Data Integration.
• importMode determina cómo se importan los datos en Data Integration. Los modos de importación aceptables son:
  • Append para agregar los datos de PDV existentes a Data Integration.
  • Replace para suprimir los datos de PDV y reemplazarlos por los datos del archivo.
  • Map and Validate para omitir la importación de datos y volver a procesar los datos con cuentas lógicas y asignaciones actualizadas.
  • No Import para omitir la importación de datos a la tabla temporal de Data Integration.
• exportMode determina cómo se cargan los datos en la aplicación de destino. En las integraciones de modalidad rápida, no puede usar Check ni No Export como valor del parámetro exportMode. Los valores de modo de exportación aceptable son:
  • Merge para actualizar los datos existentes y agregar nuevos datos.
  • Replace para borrar los datos existentes en el PDV y cargarlos con los datos nuevos. En la modalidad estándar, se borran los datos de las dimensiones Scenario, Version, Year, Period y Entity. En la modalidad rápida, los datos se borran para las dimensiones Year, Period y Entity. Puede definir regiones de borrado personalizado para ambas modalidades.
  • Accumulate para agregar los datos a los datos existentes. Aplicable a Planning, Planning Modules, Financial Consolidation and Close, Tax Reporting, Profitability and Cost Management y Enterprise Profitability and Cost Management.
  • Subtract para restar los datos del balance existente. Aplicable a Profitability and Cost Management y Enterprise Profitability and Cost Management.

    Para las integraciones de modalidad rápida:

    • No puede utilizar Check y No Export como valor de este parámetro.

    • Para Planning, Planning Modules y Financial Consolidation and Close, los únicos valores válidos son Replace, Merge y Accumulate.

  • No Export para omitir la exportación de datos. Use este modo para cargar los datos en la tabla temporal para su revisión antes de cargarlos en la aplicación de destino.

  • Check para llevar a cabo solo una comprobación de validación de datos.

    Para Oracle Fusion Cloud como destino, solo se admiten los siguientes modos de exportación:

    • MERGE para fusionar los datos de la tabla temporal de Data Integration con los datos existentes
    • NONE para omitir la exportación de datos de Data Integration a la aplicación
• periodName es el nombre de uno o más periodos o rangos de periodos, cada uno entre llaves, para los que importar o exportar datos. Las convenciones de nomenclatura de periodos aceptables son las siguientes:
  • Para cargas de un solo periodo, especifique el nombre del periodo entre llaves, por ejemplo, {Jan-21}
  • Para cargas de varios periodos, incluya los nombres de periodo de inicio y finalización entre llaves, por ejemplo, {Jan-21}{Mar-21} (para cargar datos para todos los periodos del 21 de enero al 21 de marzo)
  • Para Planning, Planning Modules, Financial Consolidation and CloseFreeForm y Tax Reporting: puede especificar el nombre del periodo y el año del proceso de negocio con el formato {Jan#FY21}{Mar#FY21} para cargar los datos para todos los periodos con inicio el 21 de enero y fin el 21 de marzo.

    El nombre de periodo se debe escribir entre llaves.

    • Un solo periodo: hace referencia al nombre de periodo de Data Management para un único periodo definido en la asignación de Period.
    • Varios periodos: hace referencia a una carga de varios periodos. El parámetro se especifica con el formato {Month-Year}{Month-Year}. Por ejemplo, {Jan-20}{Mar-20} para una carga de varios periodos desde el 20 de enero hasta el 20 de marzo.
    • Nombre de periodo de Planning: hace referencia a un nombre de periodo de Planning con formato {Month#Year}, por ejemplo, {Jan#FY20}{Mar#FY20}. Con esta convención, no tiene que especificar los nombres de periodos de Data Integration. En lugar de especificar los nombres de miembro para las dimensiones Year y Scenario.

      Este parámetro está soportado en los procesos de negocio de Planning,Tax Reporting y Financial Consolidation and Close. Es funcional tanto para sus aplicaciones de servicio como para los despliegues en la nube obtenidos de orígenes de datos locales.

      Usar esta convención es útil si se activa desde un script de Groovy de EPM Cloud mediante la captura de los nombres de miembro Year y Period. La asignación de periodo de aplicación o la asignación de periodo global debe existir con el valor Year y Month en los valores de destino de la asignación de periodo.

    • Variable de sustitución: es una extensión del formato de nombre de periodo de Planning anterior donde una variable de sustitución, en lugar de los nombres de miembro Year y Month reales, que se puede especificar con formato {Month#&CurYr}{&FcstMonth#&CurYr}; por ejemplo, {Jan#&CurYr}{&FcstMonth#&CurYr}.

      Está soportada una combinación tanto de nombres de miembro reales como de variables de sustitución.

      Este formato está soportado en los procesos de negocio de Planning,Tax Reporting y Financial Consolidation and Close.

      La asignación de periodo de aplicación o la asignación de periodo global debe existir en Data Integration del entorno donde de ejecuta el comando, con los valores Year y Month disponibles en los valores de destino de la asignación de periodo. En este caso, Year y Month hacen referencia al valor actual de la variable de sustitución durante la ejecución.

    • GLOBAL POV: ejecuta la carga de datos para el periodo de PDV global. Use el formato {GLOBAL_POV}.

    Note:

    Si usa cualquier parámetro de nomenclatura de periodos que no sea el parámetro descrito en esta sección, verá un mensaje de error Entrada no válida – HTTP 400.

    Copie la sección periodName del documento de la API de REST. De esta forma se detallan los distintos formatos como PDV global, Var. sust., etc.

  • {GLOBAL_POV} para ejecutar la carga de datos para el periodo definido en el PDV global en el sistema o en la configuración de la aplicación en Data Integration.

    Note:

    Está soportado el formato de convención de nomenclatura para periodos {Month#Year} para Planning, Planning Modules, Financial Consolidation and Close y Tax Reporting. Según esta convención, puede especificar nombres de miembro para las dimensiones Year y Scenario en lugar de los nombres de periodo de Data Integration. Este enfoque resulta útil si el comando se activa desde un script de Groovy capturando los nombres de miembro Year y Period.

    La convención de nomenclatura de la variable de sustitución {Jan#&CurYr}{&FcstMonth#&CurYr} es una extensión de la convención de nomenclatura del periodo anterior. Puede especificar una variable de sustitución en lugar de los nombres de miembro Year y Month si está ejecutando este comando en Planning, Planning Modules, Financial Consolidation and Close y Tax Reporting. También está soportada una combinación de nombres de miembro y variables de sustitución.

    Las convenciones anteriores de nomenclatura de periodos y de variables de sustitución solo funcionan si las asignaciones de periodos de aplicación o de periodos globales con los valores Year y Month en los valores de destino ya existen en Data Integration.
• inputFileName, para cargas de datos basadas en archivos, especifica el nombre del archivo, disponible en la bandeja de entrada, de las que se van a importar los datos. Si especifica el nombre de directorio en la definición de integración, transfiera solo el nombre de archivo. Si no incluye un nombre de directorio en la definición de integración, use el formato inbox/DIR_NAME/FILE_NAME, por ejemplo, inbox/GLBALANCES.txt o inbox/EBSGL/GLBALANCES.txt. Si el archivo se ha cargado en la ubicación predeterminada del entorno, use la convención #epminbox/FILE_NAME, por ejemplo, #epminbox/GLBALANCES.txt, para identificar el archivo de datos de entrada.

  Este parámetro solo se puede aplicar a cargas de datos basadas en archivos nativos. Si no especifica este valor de parámetro para cargas de datos basadas en archivos, con este comando se importan datos del archivo especificado en la definición de integración. Si especifica este valor de parámetro para cargas de datos que no estén basadas en archivos, el comando lo ignora.

• PARAMETERS, opcionalmente, identifica parámetros de tiempo de ejecución con el formato PARAMETER_NAME="PARAMETER". Los parámetros incluyen tanto filtros de origen como opciones de destino.

  Note:

  El único parámetro que puede usar ahora para un tipo de dimensión (metadatos) de una aplicación de destino es "Refresh Database"=Yes|No.

Ejemplos

• Importación de un solo periodo:

  epmAutomate runIntegration VisionDataLoad importMode=Replace exportMode=Merge period="{Mar-15}"

• Importación de varios periodos:

  epmAutomate runIntegration VisionDataLoad importMode=Replace exportMode=Merge period="{Mar-15} {Jun-15}"

• Integración incremental de datos basados en archivos:

  epmAutomate runIntegration IncrementalFileLoad importMode=Replace exportMode=Merge period="{Jan-20}{Mar-20}" inputFileName=File1.txt