12    Executing OIDF Processes through Process Modelling Framework

Process Modelling Framework (PMF) is a process design and execution framework in OFSAA that facilitates the implementation of process sequences or pipelines. Use the framework to orchestrate Run Pipelines and Business Pipelines, alongside the objects that are a part of these pipelines.

This section provides information about the usage of the Process Modeling Framework (PMF) feature in executing the OIDF processes.

 

NOTE

For detailed information about the Process Modeling Framework (PMF) feature in OFSAA, see the Oracle Financial Services Analytical Applications Infrastructure Process Modelling Framework Orchestration Guide Release 8.1.0.0.0.

 

Topics:

·        Overview

·        Process Modeling Framework Roles

·        Access the Process Modeling Framework in OIDF

·        Use the Process Modelling Framework for OIDF Functions

Overview

In OIDF Rule Run Framework (RRF), PMF is used to create a Run definition in a Run process. The visual representation of the Run is enabled through PMF by the construction of a Run Pipeline (process). The set of tasks required to carry out the OIDF functions is managed through PMF. Through the PMF, you can execute the following out-of-the-box Run processes for data loading:

·        Oracle Insurance Data Foundation Sourced Run

·        Oracle Insurance Data Foundation Execution Run

Process Modeling Framework Roles

Before you access PMF for the management of OIDF tasks, ensure to provide specific users with security or access rights. To grant access to the PMF functionality, assign the following PMF Roles to the user.

See the Oracle Financial Services Analytical Applications Infrastructure Process Modelling Framework Orchestration Guide Release 8.1.0.0.0 for details.

 

Table 33: PMF User Role Codes and Role Names

Role Code

Role Name

WFMWRITE

Manage Workflow Monitor

WFADMINACC

Process Admin User

WFDELACC

Process Delegation User

WFACC

Workflow Access

WFADV

Workflow Advanced

WFAUTH

Workflow Authorize

WFDELGADM

Workflow Delegation Admin

WFMACC

Workflow Monitor Access

WFREAD

Workflow Read

WFWRITE

Workflow Write

 

Access the Process Modelling Framework in OIDF

To access the PMF, follow these steps:

1.     Log in to the OIDF application and click AdministrationTitle: Administrator icon - Description: Administrator icon.

2.     In the Information Domain list, select the information domain required for OIDF. Then click the Process Modelling Framework tile.

Figure 51: Select Process Modelling Framework Tile in the Administration Page

Title: Description of selecting the Process Modelling Framework Tile in the Administration Page follows - Description: This illustration shows selecting the Process Modelling Framework tile in the Administration page.

3.     A submenu is displayed with the following menu items:

§       To access the Process Modeller, click Process Modeller.

§       To monitor currently running processes, click Process Monitor.

§       To delegate the Run process, click Delegation.

Figure 52: Select the Process Modeller or Process Monitor option in PMF submenu

Title: Description of the Process Modelling Framework submenu follows - Description: This illustration shows the Process Modelling Framework submenu. This submenu lists the Process Modeller and the Process Monitor options. Select Process Modeller to open the Process Modeller page or select Process Monitor to open the Process Monitor page.

Use the Process Modelling Framework for OIDF Functions

You can use PMF in one of the following ways to perform OIDF functions or tasks:

·        Use Standard OIDF Run Pipelines

·        Configure and Manage Custom Pipelines for OIDF Functions

 

ATTENTION

Ensure you have executed all the Runs and Batch IDs mentioned in the latest RUN_CHART_SUMMARY sheet of the Oracle Insurance Data Foundation Application Pack Run Chart to access the out-of-the-box Run pipelines mentioned in the Use Standard OIDF Run Pipelines section.

 

Use the following Process Modelling Framework features to perform the OIDF functions either by using the standard pipelines (processes) or by creating custom pipelines:

·        Process Modeler

·        Process Monitor

Process Modeler

The Process Modeler is used to create and modify types of Pipelines, test the Process Flow, and execute the Run.

This is a sample Process Modeler page in PMF.

Figure 53: Sample Process Modeler page

Title: Description of the sample Process Modeller page follows - Description: This illustration shows the Process Modeller page. The Process Modeller page displays the existing Business Process Pipelines and Run Pipelines with the details such as Process ID, Process Name, Process Description, Version, Instance, Application, and Last Modified. You can use this page to create a new Pipeline, or to edit or delete an existing Pipeline, launch, edit, or view any Process Flow, and execute the designed Pipeline. You can also launch the Process Monitor page from this page.

The Process Modeler page displays the existing Business Process Pipelines and Run Pipelines with the details such as Process ID, Process Name, Process Description, Version, Instance, Application, and Last Modified.

You can perform the following tasks from the Process Modeler window:

·        Click to create a new Pipeline.

·        Click the Process Name link to launch and edit the Process Flow.

·        Click to delete a Pipeline.

·        Click to view the following submenu:

§       Click View to see the process flow.

§       Click Copy to create a new Pipeline with the same process flow.

§       Click Process Flow Monitor to monitor the Pipeline.

§       Click Test Process Flow to test or check whether the Business Pipeline you designed works as expected.

§       Click Execute Run to execute a Run Pipeline.

§       Click Export Process to export a Process.

 

NOTE

The export process is performed using the Object Migration feature.

 

·        Use the Search grid to search for a specific Pipeline by providing a keyword from the Process ID, Process Name, or Process Description and then click SearchTitle: Search icon - Description: Search icon. Click ResetTitle: Reset icon - Description: Reset icon to reset the Search fields.

·        You can sort the Pipelines based on Process ID, Process Name, or Application. Click the Sort by drop-down and select the required attribute to sort.

·        You can use the Filter Pipeline field to filter pipelines based on the pipeline type. For example, to view only the Run Pipelines, remove Process from the Filter Pipeline field.

·        Click Title: Process Monitor icon - Description: Process Monitor iconto launch the Process Monitor page.

Process Monitor

The Process Monitor is used to supervise the current stage of the process for different instances. After integration with an application, you can invoke the workflow. After invoking, the workflow goes through all the stages defined. The Process Monitor displays all the completed stages, current stage, and future stages. Your user group must be mapped to the function role Workflow Monitor Access (WFMACC) to access the Process Monitor page. For the list of the PMF Roles, see the Process Modeling Framework Roles section.

This is a sample Process Monitor page in PMF.

Figure 54: Sample Process Monitor Page

Title: Description of the sample Process Monitor page follows - Description: This illustration shows the Process Monitor page. This page displays all the workflows, which are invoked from the application with details such as Entity Name, Entity ID, Process Name, Process Description, Execution Start Time, Last Execution Time, Last Updated By, and Status. You can abort, resume, or re-run a Pipeline. You can also launch the Process Modeller page from this page.

This page displays all the workflows, which are invoked from the application with details such as Entity Name, Process Name, Process Description, Execution Start Time, Last Execution Time, Last Updated By, and Status.

You can perform the following tasks on the Process Monitor page:

·        Click Title: Menu icon - Description: Menu icon to view the following submenu:

Figure 55: Process Monitor with Re-Run, Abort, and Resume options

Title: Description of the Process Monitor with Re-Run, Abort, and Resume options follows - Description: This illustration shows the Process Monitor with Re-Run, Abort, and Resume options. You can abort, resume, or re-run a Pipeline.

§       Abort: To abort an ongoing Run Pipeline process.

§       Resume: To resume a Run Pipeline process.

§       Re-Run: To execute a Run Pipeline process again irrespective of the previous execution status.

·        Use the Search grid to search for a specific Pipeline by providing a keyword from the Job ID, Process Name, or Process Description, and then click SearchTitle: Search icon - Description: Search icon. Click ResetTitle: Reset icon - Description: Reset icon to reset the Search fields.

·        You can sort the Pipelines based on Job ID, Process Name, or Application. Click the Sort by list and select the required attribute to sort.

·        You can use the Filter Pipeline field to filter pipelines based on the pipeline type. For example, to view only the Run Pipelines, remove Process from the Filter Pipeline field.

·        Click Title: Process Modeler icon - Description: Process Modeler icon to open the Process Modeler page.

Use Standard OIDF Run Pipelines

After OIDF is installed successfully, the following out-of-the-box standard Run pipelines (PMF processes) are available in the PMF:

·        Oracle Insurance Data Foundation Sourced Run: This Run pipeline (Process) loads all non-Run enabled tables in OIDF.

·        Oracle Insurance Data Foundation Execution Run: This Run pipeline (Process) loads all Run enabled tables in OIDF.

To load all non-Run enabled tables in OIDF using the out-of-the-box Oracle Insurance Data Foundation Sourced Run process, or to load all Run enabled tables in OIDF using the out-of-the-box Oracle Insurance Data Foundation Execution Run process, perform the steps in the following section:

·        Table to Table (T2T) Loading Process

Configure and Manage Custom Pipelines for OIDF Functions

This section provides information about configuring and managing the custom pipelines (processes) for OIDF functions.

 

NOTE

Ensure you have completed the required settings mentioned in the following section:

·        Prerequisites for loading T2T

 

In this section, to create and execute a custom Run pipeline (process) for OIDF in PMF using Fact Common Policy Summary T2T for illustration, follow these steps:

·        Create a Run Pipeline

·        Create a Process Flow for a Run Pipeline

·        Select the Run Parameters and Execute the Run 

·        Abort, Resume, or Rerun the Process

·        Verify the Run Execution

The Insurance Liability Contracts Data Load Process is created and executed in this section for Fact Common Policy Summary T2T. The visual representation of the preceding steps is depicted in the following illustration.

Figure 56: Create and Execute a Custom Run Pipeline

Title: Description of creating and executing the Run pipeline follows - Description: This illustration shows the flow of creating and executing the Run pipeline. The flow is explained in detail in the sections that follow this illustration.

 

NOTE

Use a Business Pipeline to design a Business Process, which consists of a sequence of internal or external tasks through well-defined interfaces. Using the designer, you can design the entire business flows consisting of several types of tasks or another business pipeline.

For information about designing a Business Pipeline, see the Orchestration of a Business Pipeline section in the Oracle Financial Services Analytical Applications Infrastructure Process Modelling Framework Orchestration Guide Release 8.1.0.0.0.

 

To use a standard out-of-the-box Run pipeline for OIDF, see the Use Standard OIDF Run Pipelines section.

Create a Run Pipeline

Visual representation of the Run is enabled through PMF by the construction of a Run pipeline. Several OFSAA widgets that enable the construction of Run pipeline are available in the Component toolbar. For detailed information about the Components in PMF, see the Components for Designing Your Process Flow section in the Oracle Financial Services Analytical Applications Infrastructure Process Modelling Framework Orchestration Guide Release 8.1.0.0.0.

Figure 57: Create a Run Pipeline

Title: Description of creating the Run pipeline follows - Description: This illustration shows the stage of creating the Run pipeline. This stage is explained in detail in the steps that follow this illustration.

To create a new Run pipeline for Insurance Liability Contracts Data Load Process in the Process Modeler, follow these steps:

1.     From OFSAA Home, select Oracle Insurance Data Foundation, click Administration Title: Administrator icon - Description: Administrator icon. In the Information Domain list, select the information domain required for OIDF. Then click the Process Modelling Framework tile. A submenu is displayed. Click Process Modeller to access the Process Modeler page.

2.     In the Process Modeler page, click Title: Add icon - Description: Add icon.

3.     The Process Details page is displayed.

Figure 58: Process Details page

Title: Description of the Process Details page follows - Description: This illustration shows the Process Details page in the Process Monitor. The functionalities are described in detail in the tabular column that follows this illustration.

Enter or select the required values for each field.

Table 34: Process Details page field names and description

Field Name

Description and instruction

Process ID

Enter a unique and easily recognizable value.

Process Name

Enter a unique and easily recognizable value

Process Description

Enter a unique and easily recognizable value

App Package ID

Select the required application package in which the process must be created from the drop-down list.

Type

Select the required process type from the Type drop-down list. The options are as follows:

·        Business Process Pipeline

·        Run Pipeline

·        Stream Pipeline

Registered Topics

NOTE:

This functionality is currently not applicable to OFSBCE.

Spark DB

Enable the Spark DB option if you are executing the Run for Hive metadata.

Infodom

Select the information domain from the Infodom drop-down list in which the Run Pipeline must be created. The list displays all the infodoms mapped to the applications configured in your OFSAA instance.

Tag

Enter the text that can be used as search keywords or helpful in defining a relationship between two or more Pipelines.

Segment

Select the application segment. The options are as follows:

·        OIDFSEG: OIDF segment

 

4.     To save the details and launch the process flow designing page, click Save And Launch. Or, to save the details and close the Process Details page, click Save And Close.

Create a Process Flow for a Run Pipeline

After you select Save and Launch in the Process Details page, a blank process flow designing page opens.

Figure 59: Process Flow Page

Title: Description of the Process Flow tab follows - Description: The Process Flow tab contains a floating toolbar and a drawing canvas. Use the drawing canvas to design the process flow with the Tools, Activities, and OFSAA Widgets components available in the floating toolbar

The Process Flow  tab contains a floating toolbar and a drawing canvas. Use the drawing canvas to design the process flow with the Tools, Activities, and OFSAA Widgets components available in the floating toolbar. You can design the process flow diagrams for all three types of processes (Business Process Pipeline, Run Pipeline, and Stream Pipeline).

To design a process flow diagram for any Run Pipeline, see the Run Pipeline section, and to use several components available in the Process Flow tab, see the Components for Designing Your Process Flow section in the Oracle Financial Services Analytical Applications Infrastructure Process Modelling Framework Orchestration Guide Release 8.1.0.0.0.

Figure 60: Create Process Flow for Run Pipeline

Title: Description of creating the Process Flow for Run pipeline follows - Description: This illustration shows the stage of creating the Process Flow for the Run pipeline. This stage is explained in detail in the steps that follow this illustration.

To create a process flow diagram for an Insurance Liability Contracts Data Load Process (a Run Pipeline for the Fact Common Policy Summary T2T execution) follow these steps:

1.     Use the drawing canvas with the LoadT2T widget as the base. In the illustration, each LoadT2T widget represents each of the Insurance Liability Contracts Data Load Process for the Fact Common Policy Summary T2T. The LoadT2T widgets are executed in parallel.

Figure 61: Insurance Liability Contracts Data Load Process Flow Design

Title: Description of the Insurance Liability Contracts Data Load Process Flow Design follows - Description: This illustration shows the Insurance Liability Contracts Data Load Process Flow Design. You can design other data load processes in the same method.

2.     Double-click a LoadT2T widget to configure the details related to its Activity, Transitions, and Notifications.

Figure 62: Insurance Liability Contracts Data Load Process with LoadT2T widget – Add Activity Details

Title: Description of the Add Activity Details in Insurance Liability Contracts Data Load Process with LoadT2T widget follows - Description: This illustration shows the Add Activity Details page in Insurance Liability Contracts Data Load Process with LoadT2T widget.

Figure 63: Insurance Liability Contracts Data Load Process with LoadT2T widget – Add Transitions Details

Title: Description of the Add Transactions Details in Insurance Liability Contracts Data Load Process with LoadT2T widget follows - Description: This illustration shows the Add Transactions Details page in Insurance Liability Contracts Data Load Process with LoadT2T widget.

3.     On the drawing canvas, select the Definition, Application Rule, and Data Fields tabs to see the respective details.

 

NOTE

To create an Application Rule, see the Application Rules section, and to create a Data Field, see the Data Fields section in the Oracle Financial Services Analytical Applications Infrastructure Process Modelling Framework Orchestration Guide Release 8.1.0.0.0.

 

§       Definition tab details

Figure 64: Insurance Liability Contracts Data Load Process with Definition Tab Details

Title: Description of the Definition Tab Details page in Insurance Liability Contracts Data Load Process follows - Description: This illustration shows the Definition tab details page in Insurance Liability Contracts Data Load Process.

§       Application Rule tab details: You can add or modify or delete the Rule details.

Figure 65: Insurance Liability Contracts Data Load Process with Application Rule Tab Details

Title: Description of the Application Rule Tab Details page in Insurance Liability Contracts Data Load Process follows - Description: This illustration shows the Application Rule tab details page in Insurance Liability Contracts Data Load Process.

§       Data Fields tab details: Add, modify, delete, or view the Data Field details.

Figure 66: Insurance Liability Contracts Data Load Process with Data Fields Tab Details

Title: Description of the Data Fields Tab Details page in Insurance Liability Contracts Data Load Process follows - Description: This illustration shows the Data Fields tab details page in Insurance Liability Contracts Data Load Process.

4.     In the Process Flow tab, clickTitle: Save icon - Description: Save icon to save the process flow.

To execute the created Run pipeline (process), see the Select the Run Parameters and Execute the Run section.

Select the Run Parameters and Execute the Run

After a Run pipeline (process) is designed and defined in the process flow diagram, you must assign values to the Run parameters, and execute the Run. You can execute a Run Pipeline on the UI or using a command-line utility called wfExecExternal.sh.

Figure 67: Select Run Parameters and Execute the Run

Title: Description of selecting the Run parameters and executing the Run follows - Description: This illustration shows the stages of selecting the Run parameters and executing the Run. These stages are explained in detail in the steps that follow this illustration.

To select the Run parameters and execute the Run, follow these steps:

1.     In the Process Modeler page, click Title: Menu icon - Description: Menu icon corresponding to the Balance Computation Management Ledger Run process that must be executed. Click Execute Run.

Figure 68: Insurance Liability Contracts Data Load Process - Select Execute Run

Title: Description of selecting Execute Run in Insurance Liability Contracts Data Load Process follows - Description: This illustration shows selecting Execute Run in Insurance Liability Contracts Data Load Process.

2.     The Select Run Params page is displayed. This page consists of the Run parameters specific to the Balance Computation Management Ledger process.

Figure 69: Insurance Liability Contracts Data Load Process - Select Run Params Page

Title: Description of the Select Run Params page in the Insurance Liability Contracts Data Load Process follows - Description: This illustration shows the Select Run Params page in the Insurance Liability Contracts Data Load Process. Select the required Run parameters to execute the Run Pipeline. When you enter the required Run parameters and click OK, the Run execution is triggered. The functionalities are described in detail in the tabular column that follows this illustration.

Select or enter the required values for each field as follows.

Table 35: Insurance Liability Contracts Data Load Process - Select Run Params page field names and description

Field Name

Description or Instruction

Reporting Currency

Use the icon Title: Pop-out window icon - Description: Pop-out window icon to select the Reporting Currency Code used to calculate the amount during the data population in the target table.

Legal Entity

Use the icon Title: Pop-out window icon - Description: Pop-out window icon to select the Legal Entity Code to identify the legal entity used for the Run.

Consolidation Type

Select the Consolidation Type of legal entities on a solo or consolidation basis. In a Solo Run, only the selected legal entity is used. In a Consolidated Run, along with the selected legal entity, all its child legal entities are also used.

Intra Company Elimination

Select the Intra Company Elimination type to eliminate (YES) or skip the elimination (NO) of Intra Company Accounts during a Consolidated Run.

Consolidation Hierarchy

Use the icon Title: Pop-out window icon - Description: Pop-out window icon to select the Legal Entity Hierarchy used for the consolidated run. This parameter is not required for the Solo Run.

GAAP Code

Use the icon Title: Pop-out window icon - Description: Pop-out window icon to select the required accounting standard.

FIC MIS Date

Use the calendar icon Title: Calendar icon - Description: Calendar icon to select the extraction date.

Run Execution Description

Enter a longer description of the Run.

 

3.     When you click OK, the Run execution begins. The Select Run Params page closes.

 

NOTE

The execution of the Insurance Liability Contracts Data Load Process is triggered using the selected FIC MIS DATE. The Run SKey is generated and inserted into the DIM_RUN table. For the Run SKey generated, the corresponding user-selected Run parameters are inserted into the RUN_EXE_PARAMETERS table.

 

4.     To verify the Run execution status of the Balance Computation Management Ledger process, see the Verify the Run Execution section.

5.     To abort, resume, or rerun the process, see the section Abort, Resume, or Rerun the Process.

Abort, Resume, or Rerun the Process

In the Process Monitor page, click Title: Menu icon - Description: Menu icon corresponding to the Run Pipeline process that must be aborted, resumed, or rerun. Then select Abort, Resume, or Re-Run.

Figure 70: Process Monitor with Re-Run, Abort, and Resume options

Title: Description of the Process Monitor with Re-Run, Abort, and Resume options follows - Description: This illustration shows the Process Monitor with Re-Run, Abort, and Resume options. You can abort, resume, or re-run a Pipeline.

Abort the Run Process Execution

The Abort feature helps you to abort a Run Pipeline (process), which is in the process of execution. To abort a Run process execution, follow these steps:

1.     In the Process Monitor page, click Title: Menu icon - Description: Menu icon corresponding to the Run process that must be aborted, and then select Abort.

2.     The Abort Process Execution page displays. To abort the Run process execution, enter comments, and click OK.

Figure 71: Abort Process Execution Page

Title: Description of the Abort Process Execution page follows - Description: This illustration shows the Abort Process Execution page. Enter the reason to abort the Run execution process in the Comments field and click OK.

Resume the Run Process Execution

You can resume a Run Pipeline (process), which is not executed successfully, explicitly interrupted, canceled, or put on hold during the execution process. By resuming a Run process execution, you can continue its execution directly from the point of interruption or failure and complete executing the remaining tasks.

To resume a Run process execution, follow these steps:

1.     In the Process Monitor page, click Title: Menu icon - Description: Menu icon corresponding to the Run process that must be resumed, and then select Resume.

2.     The Restart Process Execution page displays. To resume the Run process execution, enter comments, and click OK.

Figure 72: Restart Process Execution Page

Title: Description of the ReStart Process Execution page follows - Description: This illustration shows the ReStart Process Execution page. Enter the reason to restart the Run execution process in the Comments field and click OK.

Rerun the Run Process Execution

You can rerun a Run Pipeline (process), which was previously executed irrespective of its previous execution state.

To rerun a Run process execution, follow these steps:

1.     In the Process Monitor page, click Title: Menu icon - Description: Menu icon corresponding to the Run process that must be rerun, and then click Re-Run.

2.     The Re Run Process Execution page displays. To rerun the Run process execution, enter comments, and click OK.

Figure 73: Rerun Process Execution Page

Title: Description of the Re Run Process Execution page follows - Description: This illustration shows the Re Run Process Execution page. Enter the reason to rerun the Run execution process in the Comments field and click OK.

Verify the Run Execution

After the Run pipeline (process) execution, you can check the status of the execution.

Figure 74: Verify Run Execution

Title: Description of verifying the Run execution follows - Description: This illustration shows the stage of verifying the Run execution. This stage is explained in detail in the steps that follow this illustration.

To verify the Run execution, follow these steps:

1.     To open the Process Monitor page, in the Process Modeler page, click Title: Process Monitor icon - Description: Process Monitor icon or select Process Flow Monitor from the corresponding Title: Menu icon - Description: Menu icon process sub menuTitle: Process sub menu list - Description: Process sub menu list.

2.     In the Process Monitor page, for the required Run pipeline that was executed, search the Run instance by Job ID or Process Name, and select the process instance.

Figure 75: Insurance Liability Contracts Data Load Process – Process Monitor Page – Select Job ID

Title: Description of selecting the Job ID in the Process Monitor Page for the Insurance Liability Contracts Data Load Process follows - Description: This illustration shows selecting the Job ID in the Process Monitor Page for the Insurance Liability Contracts Data Load Process.

3.     A status page opens, which displays the execution status of the executed Run. In this illustration, the Insurance Liability Contracts Data Load Process is successfully executed.

Figure 76: Insurance Liability Contracts Data Load Process – Run Execution Status

Title: Description of the Run Execution Status in the Insurance Liability Contracts Data Load Process follows - Description: This illustration shows the Run Execution Status in the Insurance Liability Contracts Data Load Process.

To use a standard out-of-the-box Run pipeline for OIDF functions, see the Use Standard OIDF Run Pipelines section.

For information about the complete functioning of the PMF, see the Oracle Financial Services Analytical Applications Infrastructure Process Modelling Framework Orchestration Guide Release 8.1.0.0.0.