WIXLIB

OIG 11G R2 TrainingOIG 11G R2 Field Enablement TrainingAppendix-A – How to Create a TaskFlowDisclaimer: The Virtual Machine Image and other software are provided for useonly during the workshop. Please note that you are responsible for deleting themfrom your computers before you leave. If you would like to try out any of the Oracleproducts, you may download them from the Oracle Technology l) or the Oracle E-Delivery WebSite(http://edelivery.oracle.com)Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class1 Page

OIG 11G R2 TrainingTable of ContentsIntroduction 3Creating a new taskflow 3Packaging the taskflow .61UI changes using SandBox .63Grant View Permission on Taskflow .73Testing the task flow .74Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class2 Page

OIG 11G R2 Training1. IntroductionIn Lab 4.1 we have seen the task flow for gathering the additional request information at the cartlevel and at the cart item level. In this lab we will take a look at how to create a simple taskflow andhow to hook it up to OIM in order to gather additional information at the cart item level.We would create a task flow which will have only 2 fields collected. Justification and Office. As withthe Lab4.1 when you save the information. We use the newly introduced AdditionalRequestInfoclass to store the information user has entered.Note:If you are doing it in the workshop VM environment, please revert to the snapshot takenbefore Lab4.1 -PS2-Request-Enhancements. This is recommended as we want toexperience end to end task flow creation and hooking it into OIM. Lab4.1 has alreadydone hooking the task flow in OIM as part of that Lab.2. Creating a new Taskflow Using JDeveloperNote: You can either do this in the workshop VM environment or in your Own JDeveloper.1. In the VM open a terminal window and create a directory Appedix. We will be creatingour new taskflow in this directorymkdir /app/dummydata/Appendix2. Launch the JDeveloper using the launchJDev.sh located in Deskstop/Startup ScriptsOracle Proprietary - Restricted to Personal Use in an Oracle partner training class3 Page

OIG 11G R2 Training3. In JDeveloper click on New Application4. Provide the Name as RequestUI and the directory as /app/dummydata/Appendix. Theapplication is of type Generic Application. Click on FinishOracle Proprietary - Restricted to Personal Use in an Oracle partner training class4 Page

OIG 11G R2 Training5. Application will create a generic project Project1. We would need to delete this project aswe need to create a ADF project. Right Click on Project1 and click Delete ProjectOracle Proprietary - Restricted to Personal Use in an Oracle partner training class5 Page

OIG 11G R2 TrainingIn the Pop up select the following option to delete the project from JDeveloper and fromfile systemOracle Proprietary - Restricted to Personal Use in an Oracle partner training class6 Page

OIG 11G R2 Training6. In the Jdeveloper Menu Click on File- New. Create a project of type ADF View ControllerProjectClick Ok7. Name the Project as RequestUI and click FinishOracle Proprietary - Restricted to Personal Use in an Oracle partner training class7 Page

OIG 11G R2 Training8. You should see the following structure in JDeveloperOracle Proprietary - Restricted to Personal Use in an Oracle partner training class8 Page

OIG 11G R2 Training9. We need to add the jar files needed for writing and compiling the Java Bean we will bewriting In the next step. We need to add two jars files. These files are IDM-HOME /server/modules/oracle.iam.ui.model 11.1.2/adflibCommonModel.jar IDM-HOME /server/modules/oracle.iam.ui.view 11.1.2/adflibPlatformUI.jarRight Click on the Project RequestUI- Project PropertiesClick on Libraries and ClassPath - Add Jar/DirectorySelect IDM-HOME /server/modules/oracle.iam.ui.model 11.1.2/adflibCommonModel.jarOracle Proprietary - Restricted to Personal Use in an Oracle partner training class9 Page

OIG 11G R2 TrainingClick Select to add the Jar file.Now Click on Add Jar/Directory AgainSelect IDM-HOME /server/modules/oracle.iam.ui.view 11.1.2/adflibPlatformUI.jarOracle Proprietary - Restricted to Personal Use in an Oracle partner training class10 P a g e

OIG 11G R2 TrainingClick Select to choose the fileNow you should see the two jars in the list. Click Ok to close the window. Now we shouldhave the Jars needed for compiling the files later.Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class11 P a g e

OIG 11G R2 Training10. We first need to create a managed bean. Managed bean is responsible to doing the workin the backend. In our case the managed bean will collect the information entered in thetwo text fields Justification and Office. It will also save the information entered in thesetwo fields by user when Save button is clicked. We also need a Utility class as well whichwill do some supporting functionality for managed bean. Let’s first create the Utilityclass.Right Click on Request UI - New11. Click on Java & Select Java ClassOracle Proprietary - Restricted to Personal Use in an Oracle partner training class12 P a g e

OIG 11G R2 Training12. Specify the name as UIUtil and package as com.oracle.ui.view. Click OK.It will create a Java fileOracle Proprietary - Restricted to Personal Use in an Oracle partner training class13 P a g e

OIG 11G R2 TrainingOracle Proprietary - Restricted to Personal Use in an Oracle partner training class14 P a g e

OIG 11G R2 Training13. Enter the following lines just under the packageimport javax.faces.component.UIComponent;14. In the java class paste the below codepublic static UIComponent findParentComponent(UIComponent component, Class parentClass){UIComponent comp component;while ((comp ! null) && (!parentClass.isAssignableFrom(comp.getClass()))) {comp comp.getParent();}return comp;}Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class15 P a g e

OIG 11G R2 TrainingNote: Our taskflow we are creating will open in a new popup window. This code abovewill find the parent component ( OIM Main window) so that the taskflow can be closed.15. Now Let’s create the Managed Bean class. In the JDeveloper From the Menu Click onFile- NewClick on Java and Select Java ClassOracle Proprietary - Restricted to Personal Use in an Oracle partner training class16 P a g e

OIG 11G R2 Training16. Specify the name as RequestBean. Package should be populated automatically. Click OkYou should have the Java Class CreatedOracle Proprietary - Restricted to Personal Use in an Oracle partner training class17 P a g e

OIG 11G R2 Training17. Now Import the following classes in the java fieimport javax.faces.event.ActionEvent;import rt AdditionalRequestInfo;import oracle.iam.ui.platform.view.RequestFormContext;18. Now define the following variables in the code.private String justification;private String office;private Boolean readOnly;private String cartItemId;private RequestFormContext requestFormContext;private AdditionalRequestInfo additionalRequestInfo;Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class18 P a g e

OIG 11G R2 Training19. Since we are writing a managed bean, we need to create setter and getter methods.Right click from within the java file and select Generate AssessorsOracle Proprietary - Restricted to Personal Use in an Oracle partner training class19 P a g e

OIG 11G R2 Training20. Select the following to generate these methodsOracle Proprietary - Restricted to Personal Use in an Oracle partner training class20 P a g e

OIG 11G R2 TrainingOracle Proprietary - Restricted to Personal Use in an Oracle partner training class21 P a g e

OIG 11G R2 Training21. You should see the methods generated by JDeveloper22. Now we need to make this bean Serializable. Import the class firstimport java.io.Serializable;Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class22 P a g e

OIG 11G R2 Training23. Now make the class implement Serializable interface24. Add two more methods Save and Cancel in the bean. These are called when the userclicks on Save and Cancel button respectively.Also Notice that once the data is saved . We hide the pop up windowpublic void Save(ActionEvent e){System.out.println(" ---- Inside Save ------");saveData();RichPopup popupRichPopup.class); nt(),if (popup ! null)popup.hide();}public void Cancel(ActionEvent e){System.out.println(" ---- Inside Cancel ------");RichPopup popupRichPopup.class); nt(),if (popup ! null)popup.cancel();}Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class23 P a g e

OIG 11G R2 Training25. Now we need to define one more method saveData() which is getting called from Saveas shown able.public void saveData(){System.out.println("--- Inside #saveData ---");if ((this.requestFormContext ! null) && (this.additionalRequestInfo ! null)) {this.cartItemId r();System.out.println(" -- Cart Item Id " cartItemId " ----");this.readOnly Type() ! estFormContext.getActionType()! t.println(" -- readOnly " readOnly " ----");Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class24 P a g e

OIG 11G R2 ItemId, "office", this.office);System.out.println(" ---Saving Done ----- ");}If you look at the above code snippet. Request Context and additionalRequestInfo willget passed into managed bean automatically.We can get the cartItem ID once we have these two . The ID will tell us what is gettingrequested and based on what is being requested (i.e app instance , role , entitlement) wecan collect different information from user by calling different taskflow. Take a look atthe IdentitySamples - CatalogUI project for more information. We will keep it simplehere in this task flow.Once the user enters the information for justification and office in the screen and saves it. The setters methods are called first which will set the values for these in the bean. TheSave action will call the save method in the bean which in turn is calling saveData()We call additonRequestInfo.setAttribute method to set these additional values . So thatOIM can save these values and these values will show up In the approval chain as well.The setAttribute & geAttribute has two types . One as shown above where you pass thecartItemID which will be useful if you have multiple items in the cart and thecorresponding values needs to be save . The other method without the cart Item Id whichis simpler version.Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class25 P a g e

OIG 11G R2 Training26. We also need to add an Initialize() method. This method is called first everytime managedbean is called. This method will call the getAttribute method from AdditonalRequestInfointerface. So if the values are already selected by the user when he has accessed last time(i.e the interface is opened by approver where we need to display already selectedvalue). This initialize() method will get the already set value and display it to the user.Add the following lines just after the consturtorpublic void initialize(){System.out.println("--- Inside Initialize------");if (requestFormContext ! null && additionalRequestInfo ! null) {// initialize attribute valuesthis.cartItemId r();System.out.println(" -- Cart Item Id " cartItemId " ----");justification mId,"justification");System.out.println(" --- Jusstification is " justification "-------");office mId,"office");System.out.println(" --- office is " office "-------");// and "mode"readOnly requestFormContext.getActionType() ! RequestFormContext.ActionType.REQUEST &&requestFormContext.getActionType() ! println(" --- Read Only is " readOnly "-------");}}Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class26 P a g e