Welcome to a new Red Mavericks article.
Today I’m writing about WebCenter Content User Interface. I will provide an overview over this renovated interface, some considerations regarding my installation experience process and what we can customize.
This article refers to Webcenter Content 22.214.171.124. We already have Webcenter’s 12c version, but the 11g is still widely used, even in most of our projects.
So, Oracle WebCenter Content User Interface offers a revamped interface, more user-friendly, with sophisticated:
- Searching capabilities
- Upload of multiple documents at once, each one with its own metadata form
- Preview of documents with the related contents, metadata and revisions
- Selection of document’s revisions via tabs
- Tagging a document as Favorite
- Perform actions over one or multiple documents in the list of documents
This new interface without any doubt increases users’ experience and usability as well as offering a simple way to store, secure, retrieve, and share any type of document.
I think this new user interface puts Webcenter Content more tuned to the reality of the current Oracle web applications, brings it to a new level of experience.
WebCenter Content User Interface was entirely redesigned using ADF and can be easily customized. From developer’s point-of-view is much easier to develop new features targeted to specific customer needs since we just need to use ADF instead of Idoc Script.
Administration configurations still remain only accessible on the default native WebCenter Content interface, but from my point-of-view this is not an issue since we can think of this interface as a backoffice and the new one as the interface for the end-users.
In order to use WebCenter Content User Interface you must have already installed the WebCenter Content 126.96.36.199 or 188.8.131.52 versions.
Then you will need to perform a second installation for the new WebCenter Content User Interface with both Weblogic Server and Oracle Development Framework. This second installation requires a separate domain.
You can perform this second installation in two ways:
- In one single host, i.e., in the same host where you have previously installed WebCenter Content domain.
- In completely separate machines as well.
In both cases this new domain will then connect to WebCenter Content Server. You can follow the installation instructions here.
During my installation I felt some lack of information regarding MDS configuration for this new domain that will contain the WebCenter Content User Interface. Basically, before you can run the scripts mentioned in the installation instruction in the weblogic shell to create the metadata partition (point 6 of Chapter 12.5) you will have to:
- Download the Repository Creation Utility (RCU) 184.108.40.206 via Oracle E-Delivery
- Run ./rcu located in rcuHome/bin folder
- When you reach the “Step 3 of 7: Select Components” you should select:
- “WebCenter Content”
- If the database you are connecting to is based on 12c you should unselect the option “Oracle Information Rights Management” since it is not supported.
- “WebCenter Content”
- “Oracle Platform Security Services” inside of “AS Common Schemas”
After a successful installation of this new domain you are ready to use it and customize it based on your customer requirements.
In the installation machine you are able to find the full ADF application of this new interface. You can find it in this location
In order to use this application you will have to install the version 220.127.116.11 of the JDeveloper. You can find more details here.
Inside of the “WccAdfCustomization” application you should select the “Show libraries” in the Application Navigator in order to have access to important jars that you can take advantage for your developments.
This application contains two projects:
- Model – Gathers the data from the WebCenter Content Server. In this project you should turn your attention to “jar”.
- ViewController – This is the project were you will do interface customizations. Here you have the “jar” library. In this library you can find all the pages of the WebCenter Content User Interface.
During your customization you cannot directly edit the pages from “WccAdfLibrary.jar” library. You will have to create what Oracle call as “Seeded Customization Layer””.
You can have as many seeded customization layers as you want.
So what really is a “Seeded Customization Layer”?
A “Seeded Customization Layer” is a container of one type of customizations. In most cases, one layer would be sufficient but if multiple layer values are defined, the customizations for those values are applied in the order in which they are defined.
For example, imagine that you want different customizations for each deployable environment or different customers. The layers you create will be under the customer layer.
Where can I create a customization layer?
In order to create a customization you need to open the “adf-config.xml” file under “Application Resources”. Find the “customerCustomizationLayerValues” properties and insert the name we want for your layer.
Then open the “CustomizationLayerValues.xml” file also under the “Application Resources”. Find the “customer” layer and set the same name as you have given in the “value” property.
How to customize a page?
After JDeveloper having started you can notice that the “customer” customization layer is selected with the “Demo” layer that we have previously set in the configurations’ files. If you define more than one layer you can select the one you want to perform your customizations.
Expand the “WccAdfLibrary.jar” library from the “ViewController” project and open the “docInfoTabs.jsff” page from the “wcc” package. As you can notice you cannot directly edit the code but you can drag-and-drop new controls or even use the “Property Inspector” to edit them.
For this example try to drag-and-drop a button as shown in the next image.
After you have inserted the new button you can notice that a new file is generated for you in the “ViewController” project with the new button. From now on you can edit the button properties over the new file “docInfoTabs.jsff.xml”.
The generated packages structure identifies the “Seeded Customization Layer”.
How can I test my customizations?
Before you can start testing your application in your Integrated Weblogic Server you need to set the idc connection and admin user in the “connections.xml” file under the “Application Resources”. This configuration specifies the default, local WebCenter Content server connection.
On the next post we’ll explore how to use these same button to get document’s current properties and metadata, change one of the metadata attributes and save it using the API available in the “WccAdfCustomization” application.
Image post by Chad Horwedel