Creating an EPM Data File

You can export text, smart list and dates from your Oracle Fusion Cloud Enterprise Performance Management application and push it to an EPM data file. This process requires that you use the Quick Mode method to extract data from your data sources and then load the data directly to a data export file.

When the data is pushed, Data Integration creates an output data file. The name of the data file is <Target App Name>_<Process ID>.dat, and it is written to the <APPL ROOT FOLDER>/outbox directory. You can access the data file from the Process Details page from the OUTPUT file column.

To register a Data Export File with an EPM Data File type application:

  1. From the Data Integration home page, then Actions, select Applications.

  2. On the Applications page, click Image shows the Add icon. (Add icon).

  3. On the Create Application page, and then Category, select Data Export.

  4. From Type, select EPM Data File.

    The Application field shows the name EPM Data File.

    Image shows Create Applications page.

  5. Optional: In Prefix, specify a prefix to make the application name unique.

    The prefix is concatenated with the file name to form a unique application name. For example, if you want to name an application with the same name as an existing one, you can assign your initials as the prefix.

  6. Create the integration job between the source and target applications for the data export file:

    1. From the Data Integration home page, click Image shows the Add icon. (Add icon).

    2. On the Create Integration page, and then in Name and Description, enter a name and description for the integration job.

    3. In Location, enter a new location name, or pick an existing location to specify where to load data.

    4. Tap the Quick Mode slider on.

      When you associate an integration job with the Quick Mode method and then save the job, you cannot reverse the Quick Mode association. However, the integration job can be deleted.

    5. From the Image shows Source icon. Source drop-down, select the source application.

    6. From the Image shows the Target icon. Target drop-down, select EPM Data File.

      Image shows the General Integration page.

    7. Click Save and Continue.

  7. Map the dimensions between source and the target application:

    1. On the Mapping Dimensions page, , select the Import Format

    2. In the mappings grid, map the source columns source to the dimensions in the target application for the data export file by completing the following:

      1. In Select Source Dimension, select the name of the source dimension to map to the EPM data file dimension.

      2. Optional: Add a target expression for each of the Cloud EPM dimensions.

        For information on using target expressions, see Using Target Expressions.

        Note:

        You cannot use a SQL target expression types with the Quick Mode method.

        Source expression types are not available with the Quick Mode method.

    3. Click Save and Continue.
    4. The Map Members option is not available when using the Quick Mode method.

    5. Click Options.

      You can also go to the Options page from the Data Integration home page by clicking Image shows Select icon. to the right of the integration job and then select Options.

    6. To select a period for the Quick Mode period, select the Filters tab.

      Period processing using the Quick Mode method does not use periods defined in the Period Mapping option. Instead, periods are handled like other dimensions and can be filtered in the (Source) Filters option. If you do not filter for the Year and Period, specify a single period at the time of execution.

      Note:

      If you map a period dimension and specify a target expression for the period on the Mapping Dimensions page for the integration, then the Period drop-down is not available for selection because the period is derived from the mapping.

      If you do not specify a filter for the Year and Period, specify a single period when running the integration.

    7. Click Image shows the Add icon..

    8. (Optional): From the Dimension Name drop-down, select Year and then select the year from the source file from which to load data from Filter Condition.

      For multi-period loads, you can specify filters for the Year and Period dimensions and extract multiple years only when you specify all periods in a year. Partial period extracts crossing multiple periods are not supported.

    9. Click Save.
    10. Select the Options tab.
    11. In Category, specify an explicit source filter for the Scenario dimension.

      Category is used to categorize and map source system data to a target Scenario dimension member in the integration.

      Category is not used to determine the Scenario for Quick Mode processing.

    12. From Data Extract Option, select Level 0 Data.

      The Level 0 Data data extract option enables you to extract entire members at the bottom of dimension (raw data stored in a database) and enables you to apply filters and select columns to include in the output file. This extract option also enables you to export non-numeric data if the target application is an EPM data file. The Level 0 Data option uses the MAXL Export method to extract data. This method can be used only by the Service Administrator. The application is read only when the extract step is executing.

      If you select the Level 0 data extract method, the system automatically creates the business rule "DM BR Data Export" to perform the data extract from the Oracle Enterprise Performance Management Cloud.

      Note:

      When you use the Level 0 data extract method, you cannot use a shared member in the source filter.

      Image shows the Options page.

    13. Click Save.

  8. Run the integration:

    1. From the Data Integration home page, select the integration job associated with the EPM Data file integration and then click Image shows Run icon..

    2. From the Run Integration page, the default value for the Mode is Replace.

    3. If no period was defined on the Options page, then from the Period drop-down, select the single period from the source file from which to load data.

      If you map a period dimension and specify a target expression for period on the Map Dimension page for the integration, then the Period drop-down is not available for selection because the period is derived from the mapping.

    4. If filters have been defined for the integration, click the Filters tab and make any changes as desired.

    5. Click Run.