You can integrate UCP UI with a new application or an existing application. The following instruction describes how to add the UCP UI in a new application through Oracle Jdeveloper. You can add the UI in an existing application by adding a region in an existing page or a new page in the application similarly. To create a new ADF web application in Oracle Jdeveloper, perform the following tasks:

1. Open the Oracle JDeveloper 12c wizard. Select New Application from the Application Navigator on the left pane. A New Gallery window appears.

2. In the New Gallery window, select ADF Fusion Web Application from the list of items, and click OK. The Create ADF Fusion Web Application window appears.

3. In this window, enter an application name, for example, MyApp. Also, enter the application package prefix, for example, oracle.ucp. Click Finish to create a new ADF application.

The bounded task flow in the UCP library can be added in any region to provide seamless integration to your application. In this section, we will create a demo ADF web page to host a region for the UCP task flow. To create a new ADF web page, perform the following tasks:

1. In the left window pane, right-click ViewController to display the context menu.

2. In the ViewController context menu, from the New menu, select Page. The Create JSF Page window appears.

3. In this wizard, enter the file name, for example, MyPage.jspx. From the Document Type menu, select JSP XML.

4. From the Page Layout menu, select Create Blank Page. Click OK. The new MyPage.jspx is created.

5. Open the newly created page by double-clicking MyPage.jspx under the ViewController node in the navigation pane. In the MyPage.jspx window, select Source from toolbar at the bottom to view the source code of the page.

If you have deployed UMS to Oracle WebLogic Server, then the UCP task flow library is already deployed to the server. However, the UCP task flow library may not be accessible from your JDeveloper instance. Therefore, it is important to connect the task flow library to you application. You must first create a file system connection from your JDeveloper instance to the library. To achieve this, perform the following steps:

1. Click the Window tab located in the toolbar on the top pane to display a drop-down list. From the list, select Resources to add the Resources tab to the right pane of the Jdeveloper window.

2. Under the Resources tab, click the folder icon to display a drop-down list. In the list, navigate to IDE Connections, and select File System. The Create File System Connection wizard appears.

3. Enter the connection name, for example, UCP Task Flow.

4. Click Browse to select the folder that contains the UCP task flow library. This folder is located in the oracle_common directory and the path would look like the following:

   oracle_common/communications/modules/oracle.ucs.userprefs.webapp_x.x
   

   where x.x is the version number, for example, 2.0.

   Navigate to this folder and click Select.

5. Click Ok. The File System Connection is created. To verify, expand the File System navigation tree in the right pane. On expanding the ADF Task Flows folder, you will see the option UserCommunicationPreferences.

With the support of an ADF task flow library, you can add a region in your web application so that the end users can access their preference directly from your application. To achieve this, perform the following tasks:

1. Click the Source tab of the newly created page, MyPage.jspx.

2. From the File System navigation tree in the right pane, drag the UserCommunicationPreferences task flow and drop it inside the <af:form> </af:form> tag in the page source to create a region in this tag.

   A context menu appears.

3. Select Region from the context menu. A confirmation window appears.

4. Click Add Library. The Edit Task Flow Binding wizard appears.

5. In the Input Parameters table, enter a value for profield, for example, soa. The value for the Profile ID determines that the created user interface accesses only user filters and channels in this profile. This should be the same profile that your application is targeting. Click OK. A region has been added to the page.

   If you have an existing ADF web application that you want to integrate with UCP by including a user preference page, then you can add a region to your existing or new ADF page, in the same manner as mentioned in this section.

Since UMS and UCP task flow libraries are deployed on Oracle WebLogic Server, you do not need these libraries in your application. You must reference these libraries from the weblogic.xml file. To achieve this, perform the following tasks:

1. Right-click the ViewController node located in the navigation pane. A context menu appears.

2. From the context menu, select New, and click From Gallery. The New Gallery wizard appears.

3. In the navigation pane, expand the General node and select Deployment Descriptors. From the list of items on the right pane, select Weblogic Deployment Descriptor. Click OK.

   The Create WebLogic Deployment Descriptor wizard appears.

4. From the list of deployment descriptors, select weblogic.xml, and click Next. In the next screen, select the latest version as the deployment descriptor version, and click Next. In the Summary page, click Finish

5. Open the newly created file by double-clicking weblogic.xml under the ViewController node in the navigation pane. In the weblogic.xml window, select Source from toolbar at the bottom to view the source code of the page.

6. In the weblogic.xml file, you will reference two libraries, that is, the UMS library (oracle.sdp.client) and the UCP library (oracle.ucs.userprefs.webapp). Add the following library references:

   <library-ref><library-name>oracle.sdp.client</library-name></library-ref>
   <library-ref><library-name>oracle.ucs.userprefs.webapp</library-name></library-ref>

Since you have already referenced the two libraries in the weblogic.xml file, you do not need to package these libraries in your application. This can be managed through the project deployment profile. To achieve this, perform the following tasks:

1. You must first create a project deployment profile. Right-click the ViewController node from the navigation pane. A context menu appears.

2. From the context menu, click Deploy, and select New Deployment Profile. The Create Deployment Profile wizard appears.

3. From the Profile Type drop-down list, select WAR File, and click OK.

   The project deployment profile has been created. You must, now, ensure that the libraries are not packaged in your application.

4. Under the General tab, select the Specify Java EE Web Context Root option, and enter your application context root, for example, myapp.

5. From the navigation tree, select Filters listed under WEB-INF/lib. Deselect all the .jar files listed in the right pane. Click OK to save changes to your deployment profile.

   This ensures that the libraries are not packaged in your application, as you have already referenced the important libraries in the weblogic.xml file in the previous section.

To create a new application deployment profile, perform the following tasks:

1. From the Applications drop-down list in the left pane, select Deploy and click New Deployment Profile from the context menu.

   The Create Deployment Profile wizard appears.

2. From the Profile Type drop-down list, select EAR File, and enter a name for your application deployment profile, for example, MyApp.

   Click OK to create the application deployment profile. The Edit EAR Deployment Profile Properties wizard appears.

3. From the navigation tree, select Application Assembly.

4. In the right pane, expand the ViewController.jpr node and select webapp1. to include it in the application.

5. In the toolbar, click Save All to save your application.

To deploy your application, perform the following tasks:

1. From the Applications drop-down list, select Deploy and click MyApp from the context menu. The Deploy MyApp wizard appears.

2. In the Deployment Action screen, select Deploy to Application Server and click Next.

3. In the Select Server screen, select the server from the list of Application servers, and click Finish to deploy your application.

   If the server is not in the list of application servers, then follow instructions in Configuring Application Server Connection to configure your server connection.

If you have not configured your application server connection, then you must first configure it by performing the following tasks:

1. From the Applications drop-down list, select Deploy and click MyApp from the context menu. The Deploy MyApp wizard appears.

2. In the Deployment Action screen, select Deploy to Application Server and click Next.

3. In the Select Server screen, click the plus icon located at the top right corner.

   The Create Application Server Connection wizard appears.

4. In the Connection Name field, enter your server connection name, for example, MyServer. Click Next.

5. In the Authentication screen, enter your application server's admin Username and Password. Click Next.

6. In the Configuration screen, specify the host name, port numbers and, domain name.

   Click Next.

7. On the Test screen, verify your connection by clicking Test Connection. If the test is successful, then click Finish. You should be able to see your application server in the list of application servers.

8. To deploy your application to the newly configured application server, select the server from the list and click Finish. You will receive a confirmation for the successful deployment of your application.