Creating an Approval Matrix Configuration App

Matrix App Creation Instructions:

1. If the app IQX_CAPEX_DEMO_MATRIX does NOT exist in the system you are working in, please create a new app called IQX_CAPEX_DEMO_MATRIX and import the following XML file.
   
   IQX_CAPEX_DEMO_MATRIX_000001.xml

2. Use the File → Copy menu option to copy this to a new application.
   
   

   Naming Convention

   Name your new app by appending _MATRIX to the end of the original app name. 

   e.g.

   Original App: IQX_CAPEX_DEMO

   Matrix App: IQX_CAPEX_DEMO_MATRIX   

3. Add an Implementation class and set the Type Declaration to Public.
   

   No methods need to be implemented in the implementation class.  The purpose is so that the data model can be created as a type in the class that can then be accessed by the Main Application's ABAP exits.

4. You must then create a structure for each Role that you are going to allow users to configure.  In the following example you can see that we are allowing for roles: FIController, GroupIT, CFO, CEO.
   To create a new Role, simply use the copy and paste functionality on one of the existing roles and rename both the Table and Structure accordingly. 
   
   
   
   
   
5. If your approval matrix depends on another value (e.g. Cost Center, Company Code), then you must add that field(s) directly into the Rows Struct.
6. Once your Data Model is correct, you need to adjust the configuration of the table so that the necessary columns are displayed.  Note that if you have added additional fields (e.g. Cost Center), those should appear as the first columns in the table.
7. For each of the roles, you should add a Button to the table Cells collection.  You must configure the following properties:
   1. Actions if pressed: Script:openApproversPopover(evt)

   2. Advanced: cdata:path="FIController"
      
      

      "FIController" in this example configures the button to the management of users for the structure in the Data Model called FIController.  You will change FIController to match the role you are working with.

      
      

Configuring the Main Application to Leverage the Matrix Configuration:

1. Go into the Properties of the app and click the Agent Determ. button
   
   
   
   
2. Enter the name of the Matrix app and specify an App Key