LiveCycle Product Blog

LiveCycle Process Management ES is essentially LiveCycle's workflow management component. After installing LiveCycle, it is a very good idea to verify that workflow functions correctly in your environment.

1) Install Sample Orchestrations
Ensure that you choose to deploy 'Samples' which is the last major step during configuration by LiveCycle Configuration Manager (LCM).

2) Login using Workbench ES

3) In the Processes view, navigate to Samples - LiveCycle ES, then MortgageLoan - Prebuilt. Open the orchestration (MortgageLoan - Prebuilt - 1.0) for view. It is a simple 2-step mortgage loan application workflow. Any user can initiate the workflow. If the requested amount is $500,000 or more, the workitem will be routed to a (senior) Bank Manager. It the amount is less than $500,000, it will be routed to a Loan Officer. The 'Bank Manager' role is mapped to the built-in user Tony Blue. The 'Loan Officer' role is mapped to the built-in user Alex Pink.

Tony Blue or Alex Pink can approve or deny the loan application. At this point, the workflow is completed. These two users along with Kel Varsen and Rye Woodard are four built-in users belonging to the LiveCycle user domain called 'Sample Organization, Finance Corp' which gets installed when you choose to deploy 'Samples' using LCM.

4) Login to LiveCycle Workspace (http://server:port/workspace) as user 'rwoodard' with password 'password'. Click on the 'Start Process' icon. On the left pane, click on 'Samples'. Click on the 'MortgageLoan - Prebuilt' icon. This will open up a PDF form. Type in values for 'Property Price' and 'Downpayment' so that the Mortgage amount is more than 500,000. Type in values for other fileds also. Do not check 'Approved' or 'Declined'. Click the 'Complete' button at the bottom right. Logout.

5) Wait about 2 minutes. Log back in to Workspace as user 'tblue' with password 'password'. Click on the 'To Do' icon. You should now see an icon representing a new workitem (task). Click it. The previous PDF form should now open up with the values you typed in. Check the checkbox for 'Approve' and click the the 'Complete' button at the bottom right. Logout.

6) Log in to the LiveCycle Admin Console (http://server:port/adminui). Navigate to Services->LiveCycle Process Management ES->Task Search. In the search field for User Name, type in 'Tony Blue', check 'Show Completed Task' and click the 'Search' button. You should see a task listed with a status of 'Completed'. Click on the Task ID and verify the timestamp and date.

7) You can now repeat this for a mortgage amount less than 500,000 and verify that the workitem (task) gets routed to Alex Pink (user 'apink with password 'password').

If this does not work for you, Process Management is not functional in your environment. Look in the appserver instance's log for clues on what might be wrong.

Posted by Jayan Kandathil at 1:56 PM | Permalink | Comments (0)

Foundation services are those services that are included with all the solution components. Services outside of the foundation are part of other individually (or packaged) licensed products.

If you would like to find out which LiveCycle ES 8.2 services are available with the Foundation and which services come with other licensed products, keep this document bookmarked: http://help.adobe.com/en_US/livecycle/8.2/solutioncomponents_services.pdf

Posted by Lee Sutton at 7:49 AM | Permalink | Comments (0)

[Edit] This script will not work with LC ES Update 1

If you would like to do some simple customizations with WorkSpace 8.0.1 such as switching out the corporate logo and login screens, these steps should make your life easier.

First, download this sample WorkspaceCustomizationBatchFiles.zip from https://share.acrobat.com/adc/document.do?docid=bf6c4f37-12e5-11dd-acd1-65538200e0b2. This will provide you with batch files to help extract and then repackage the WorkSpace EAR file (these are not part of LC ES).

Download and unzip the file onto your C:\ drive into a folder of your choosing. No spaces in the folder name. In the directory you will find 4 batch files marked with easy to follow steps. (The last three could have been combined but I wanted to explain what goes on behind the scenes.)

Preparation
Before running any of these steps, you must have the 2.0.1 Flex JDK in your path as well as your Java SDK. Take note that the compile step will not work with the 3.0.0 JDK compiler.

Step1-CreateCustomizableWorkspaceEnvironment.bat
The first step takes the EAR file from your J2EE deploy directory and extracts the files you need to customize the look and feel of WorkSpace. Although not required, you may want to change the WORKING_DIR to direct output to another location. What you will need to do is change the JBOSS_DIR to the directory where your LC EAR files are deployed. If you are using the default turn-key installation you won't need to change this.

The first batch file covers these steps:

Once the first step is complete you can quickly make changes to the images and style sheet that provide you with the look and feel of the default Workspace.

The first image to start with would be the "login_splash.png" which gives you the background on the login screen. You can find this image under C:\WorkspaceCustomization\ExpandedWAR\images\login_splash.png. The next most obvious change would be the "corp-logo.png" image that is displayed at the top left hand corner of WorkSpace. This is found under C:\WorkspaceCustomization\ExpandedWAR\images\corp-logo.png.

You have a choice to change the images by overwriting the existing files or simply change the HeaderPane or loginSplash sections in the C:\WorkspaceCustomization\ExpandedWAR\lc.css style sheet.

Step2-CompileNewSWF.bat
Once the images and style sheet have been changed we need to recompile the workspace-theme.swf file. This can be done by running the step 2 batch file. Again, be sure you are using the 2.0.1 SDK. To check, drop to a command line and run mxmlc.exe to see which version you are using.

Step3-CreateNewWARFile.bat>
The next step is to package up the changes into a WAR file. This step will create a new WAR file under C:\WorkspaceCustomization\NewWAR.

Step4-CreateNewEARFile.bat
Lastly, run step 4 and the new adobe-workspace-client.ear will be created under C:\WorkspaceCustomization\NewEAR.

Deploy the new EAR file
Backup and then delete the original adobe-workspace-client.ear file (Do NOT backup the ear file in the deploy directory or it will remain deployed). Under the default turn-key installation this can be found under C:\Adobe\LiveCycle8\jboss\server\all\deploy\adobe-workspace-client.ear. When you remove the file, you should receive a message in your log that indicates that the application has been undeployed:
2008-04-25 13:14:19,041 INFO [org.jboss.deployment.EARDeployer] Undeploying J2EE application, destroy step: file:/C:/Adobe/LiveCycle8/jboss/server/all/deploy/adobe-workspace-client.ear

Now copy the C:\WorkspaceCustomization\NewEAR\adobe-workspace-client.ear into the C:\Adobe\LiveCycle8\jboss\server\all\deploy directory to deploy the newly customized WorkSpace application.

When deployed correctly your log should indicate that the new application has been deployed:
2008-04-25 13:16:58,364 INFO [org.jboss.deployment.EARDeployer] Started J2EE application: file:/C:/Adobe/LiveCycle8/jboss/server/all/deploy/adobe-workspace-client.ear

To test your new application, go to http://yourmachine:8080/workspace and make sure the changes have taken place (be sure to close and reopen your browser in case any caching has occurred).

You should now have a slightly customized version of WorkSpace deployed!

If you would like to go one step further and create a separate URL for your new WorkSpace, do the following BEFORE running the step 4 batch file.

This is useful when creating Workspace versions that look slightly different for different groups or departments without having to change the underlying Flex application.

Posted by Lee Sutton at 12:26 PM | Permalink | Comments (0)