Installing the Workflow Provider
OracleAS Portal Integration Solutions
OracleAS Workflow Portlet - Installation
Instructions
| Last Update: |
May 2005 |
| Status: |
Beta |
Contents
Introduction
User Interface
Deploying the
Provider
Publishing the
Portlet
Registering
the Provider
Adding
the Portlet
Introduction
The Oracle Application Server (OracleAS) Workflow Portlet displays Oracle Workflow
notifications.
User Interface
When added to an OracleAS Portal page, this portlet provides the following user
interface components:
Show Mode
Notification's Details Page
Deploying the Provider
After you have downloaded workflow.zip, follow the instructions in installing.integration.v2.html to deploy the OracleAS Workflow Provider.
Publishing the Portlet
Configuring the
provider
- In order to be able to view the notifications, the portlet has to
be able to access the workflow database. In order to enable this, the
following entries need to be made in the data-sources.xml file present in
the <OC4J_HOME>/j2ee/home/config
directory.
<data-source
class="com.evermind.sql.DriverManagerDataSource"
name="OracleWorkflowProviderDS"
location="jdbc/OracleWorkflowProviderDS"
xa-location="jdbc/xa/OracleWPXADS"
ejb-location="jdbc/OracleWPDS"
connection-driver="oracle.jdbc.driver.OracleDriver"
username="workflow_manager_username"
password="workflow_manager_password"
url="jdbc:oracle:thin:@host:port:sid"
inactivity-timeout="30"
/>
The default schema for the workflow manager is usually owf_mgr.
- This method is fine, if you are only interested in testing the
portlet, but if you are concerned about the security issues of
disclosing the password in the data-sources.xml
file, then you may use the JAZN
user manager to obfuscate the password. In order to use JAZN user
manager to store the password in an obfuscated form, please make the
following changes.
- Modify the <OC4J_HOME>/j2ee/home/config/application.xml
file, so that jazn is the default user manager.
<orion-application
....>
.....
<jazn provider="XML" location="./jazn-data.xml" />
....
</orion-application>
- Modify the <OC4J_HOME>/j2ee/home/config/jazn.xml
file, so that jazn uses the jazn-data.xml file
<jazn
provider="XML"
location="./jazn-data.xml" />
- Now modify the <OC4J_HOME>/j2ee/home/config/jazn-data.xml
file by adding an entry for the workflow_managers_password.
<jazn-realm>
<realm>
<name>jazn.com</name>
<users>
....
<user>
<name>password_for_workflow_manager</name>
<credentials>!workflow_manager_password</credentials>
</user>
</users>
</realm>
</jazn-realm>
<!--
dont forget to add the '!' before the password. -->
- Finally modify the <OC4J_HOME>j2ee/home/config/data-sources.xml
file.
<data-source
class="com.evermind.sql.DriverManagerDataSource"
name="OracleWorkflowProviderDS"
location="jdbc/OracleWorkflowProviderDS"
xa-location="jdbc/xa/OracleWPXADS"
ejb-location="jdbc/OracleWPDS"
connection-driver="oracle.jdbc.driver.OracleDriver"
username="workflow_manager_username"
password="->password_for_workflow_manager"
url="jdbc:oracle:thin:@host:port:sid"
inactivity-timeout="30"
/>
<!-- note that the text in the
password field is the same as the name in the jazn-data.xml
file -->
NOTE: Once you make jazn
your default user manager, then your OC4J's admin password is also
changed. If you are already using JAZN as your default manager,
then there is no issue. By default, the password
for admin user is "welcome".
Registering the
Provider
- Login to OracleAS Portal using an account that has build
privileges. If your home page is not the Build/Administer
page, click on the Builder link in the
top
right corner of the screen. Click on the Build
tab if that is not the active tab.
- Under the Build tab (on OracleAS
Portal Home Page), click on Register Portlet
Provider within the portlet called Providers.
- Fill out provider information for the Email Provider:
- Name: Workflow
- Display
Name: Workflow Portlet Provider
- Timeout: 500
- Timeout
Message: Workflow Portlet Provider Timed Out
- Implementation
Style: Web
- Click on the Next
button to enter the Web Provider specific information
- Enter the Web
Provider location
- URL: http://your_oc4j_hostname:port/workflow/providers/workflow
- Select the radio button labeled The user
has the same identity in the Web providers application as in the Single
Sign-On identity.
- Scroll down to the User/Session
Information section and specify the login frequency as Once
Per Session.
- Click on the Finish
button to complete the registration
Note: When registering a new provider with OracleAS Portal,
only the user who registered the provider has privileges to see the
provider/portlets.
If necessary, go to the Folder with the name of the provider within the
Portlet Repository content area and update the provider privileges as
required.
Adding
the Portlet to a Page
You are now ready to add the Portlet to a page.
Trademarks
Oracle and the Oracle logo are
trademarks or registered
trademarks of Oracle Corporation in the United States and other
countries.
All other names are trademarks and/or registered trademarks of
their respective owners.
|
Bookmark
