Modeling History

This application enables you to trace and inspect the configuration changes to a model within an environment. This helps you to trace and audit who did what and when. Depending on the user authorizations, even historic versions of environments and functions can be restored.

The Modeling History application captures a snapshot of the configuration (as an XML file) only on important operations like “CREATE”, “DELETE” and “MANUAL”.

Key Features

The following table explains the key features available.

Key Feature Use
Environment List All current and historic environments are listed on the initial page. If an environment is deleted, it is no longer visible in the list.
History Versions

Once an environment is selected, a detailed list of all changes to the environment, functions and fields are displayed on the right-hand side of the screen.

You can select and restore old versions of an environment, function or field.
Environment If you select an environment, the system lists here all the operations executed within the environment together with an entry description, the history type, time stamp, user and name.
Function All the operations executed on the function within the environment are listed here together with the timestamp, user and name.
Fields All the operations executed for fields on the environment are listed here together with the timestamp, user and name.
Retrieve Version Retrieves the selected history version entry.
Show Configuration Displays the selected history version configuration in XML format.
The system creates the entries in the modeling history when the following prerequisites are met:

  • An environment, function and field are either created, changed, deleted or transported.

  • The Historize button is manually executed in the environment.

Procedure

In the client where SAP Profitability and Performance Management is installed, choose Start of the navigation pathSAP Menu Next navigation step Profitability and Performance Management Next navigation step System Reports Next navigation step Show Modeling HistoryEnd of the navigation path or launch the transaction code /NXI/P1_MODEL_HIST. The system opens the Modeling History window where you can process the following activities in edit mode.

Retrieve Function

You can use the Retrieve button to recover the specific environment, function or field:

  1. Choose an environment from the environment list to be the starting point of the retrieval.

  2. On the History Versions screen, choose one of the following tabs:

    • Environment: To retrieve a specific version of an environment.

    • Function:To retrieve a specific version of a function.

    • Field:To retrieve a specific version of a field.

  3. The following columns appear on the Function Details section of the History Versions screen:

    • Description: This is the same as the environment name

    • History Type: Describes the type in which the historization was generated:

      • “CREATE”: Is created when new or copied environments, functions or fields are saved.
      • “MANUAL”: Historization can be triggered manually by choosing the Historize button in the modeling environment.
      • “CHANGE”: This only logs the operation but does not capture a configuration snapshot. No information can be retrieved for this history type.
      • “DELETE”: Is initiated when an environment, functions or fields are removed.
      • “TRANSPORT”: Is created when an environment is transported to another system. Once it is initiated from the source system, the Transport history type appears.
      • “IMPORT”: Is created when an environment has been imported from one system to another.
      • “RETRIEVED”: Is created when an environment, functions or fields are recovered.

    • Time Stamp: Displays the system time when the Historize button was chosen and the historization was created

    • User: Is the ID of the user who performed the historization

    • Name: Is the full name of the user to whom the ID is assigned

  4. Select the specific entry or version you want to retrieve. You can check the time stamp to find it.

  5. Choose Retrieve.

  6. The Recover Environments window appears.

    Fill out the following in the Retrieve as Version section when you retrieve an environment:

    • Environment: Define an environment ID for the retrieved environment .

    • Version: Specify the version ID that you want the retrieved environment to have.

    • Description: Specify a name for the retrieved environment.

    • Parent Node: Define under which node or description node the retrieved environment is placed.

    In addition, define the following when you retrieve a function:

    • Parent Calculation: Specify under which calculation unit the function is placed.

    • Function: Specify the function ID for the retrieved function.

  7. Choose OK.

    To validate the retrieved item, navigate to the details you set in the Retrieve as Version section.

Manual Historization

To perform manual historization, select the entry to be historized in the function hierarchy on the Modeling Environment tab and choose Historize. The system then displays the following message: “Historization successfully completed”.

Related Information

For more information about modeling, see Modeling Environment.