Understanding the Conversion Process

PeopleSoft Business Analysis Modeler (BAM) is a standalone application that enables developers to create multidimensional models for the purposes of reporting and analysis. BAM models are not integrated into the PeopleTools framework. Integrating BAM models with PeopleSoft applications takes many steps and a significant amount of time.

Analytic Calculation Engine analytic models are integrated into the PeopleTools framework and include much of the same functionality and many of the same parts as BAM models. You may want to convert existing BAM 8.8 models into Analytic Calculation Engine analytic models to reduce the extra steps and time needed to integrate these models with PeopleSoft applications. You use the PTAEACECONV Application Engine program for this purpose.

Because PTAEACECONV does not convert all BAM 8.8 model parts, you must manually complete the analytic model after conversion.

Note: The PTAEACECONV Application Engine program does not convert application data. Application developers are responsible for converting application data.

Converting BAM 8.8 models into analytic models involves these steps:

  1. Analyze the BAM 8.8 model.

    If the existing model contains rules that use the TEXT2MBR function, you must hard-code the function's second argument (Text) if the use of the function meets both of these conditions:

    • The TEXT2MBR function's second argument (Text) is not hard-coded.

    • The second argument matches the name of any dimension or data cube in the model.

      Note: If the second argument matches the name of a dimension member reference—for example, [COUNTRY:Belgium]—you do not need to hard-code the second argument of this instance of the TEXT2MBR function.

  2. Export the BAM 8.8 model.

    See Exporting BAM 8.8 Models.

  3. Run the PTAEACECONV Application Engine program.

    See Running the PTAEACECONV Application Engine Program.

  4. Examine the Application Engine log file.

    See Examining the PTAEACECONV Log File.

  5. Map the new analytic model to main and aggregate records that hold the application and aggregation data.

    See Mapping a Cube Collection to Main and Aggregate Records.

  6. Map data cubes and dimensions to fields in the main and aggregate records.

    See Mapping Data Cubes and Dimensions to Fields.

  7. Create PeopleSoft Pure Internet Architecture pages with analytic grids.

    See Understanding Analytic Grid Design.

  8. View the new analytic model in PeopleSoft Pure Internet Architecture.

    See Understanding the Analytic Model Viewer.

The PTAEACECONV Application Engine program converts most parts and circular formula options into analytic models.

BAM 8.8 Parts That Can Be Converted

These BAM 8.8 parts can be converted into analytic models:

  • Data cubes

  • Dimensions

  • User functions

  • Expression modifiers

  • Table views

  • Import maps

  • Organizers

BAM 8.8 Parts That Cannot Be Converted

These BAM 8.8 parts cannot be converted into analytic models:

  • Prefix modifiers

  • Styles

  • Option lists

    Note: References to option lists within the code of data cube rules; user functions and expression modifiers, however, are converted.

    See Understanding Part Conversion Details.

  • Timelines

  • Roles

  • Chart views

BAM 8.8 Circular Formula Options That Can Be Converted

These BAM 8.8 circular formula options can be converted into analytic models:

  • Resolve circular formulas through iteration.

  • Maximum number of iterations.

  • Maximum change in values.

  • Warn about circular formulas every time a circular formula is defined.

BAM 8.8 Circular Formula Options That Cannot Be Converted

The Only if iteration is not enabled BAM 8.8 circular formula option cannot be converted into an analytic model.