HCL Web Experience Factory | HCL Digital Experience
HCL Web Experience Factory (WEF) creates applications with rich, interactive digital experiences for delivery on desktop browsers, smartphones, tablets, and other channels. This application development tool enables developers to build custom web portlets, widgets, and applications for HCL Digital Experience, and IBM WebSphere Application Server environments.
Using HCL Web Experience Factory 8.5.1
Along with the release of HCL Digital Experience CF205, HCL has released an updated version of HCL Web Experience Factory, which is version 8.5.1. This release includes support for Java 1.8 and Eclipse 4.2.2 as outlined below.Updates from HCL Web Experience Factory 8.5 to HCL Web Experience Factory v8.5.1
- Previous releases of IBM Web Experience Factory and HCL Web Experience Factory v8.5 were available with an Installer package. The HCL Web Experience Factory 8.5.1 is available as a zip file which contains the Web Experience Factory 8.5.1 (WEF) plugin pre-installed in Eclipse version 4.4.
- Previous releases of Web Experience Factory compiled the applications with Java 1.6/1.7 SDKs. HCL Web Experience Factory 8.5.1 is compiled using a Java 1.8 SDK.
- Previous releases of Web Experience Factory contained a default IBM WebSphere Liberty Version 6 server and IBM JDK 6. HCL Web Experience Factory 8.5.1 does not contain a default application server or JDK. HCL Web Experience Factory 8.5.1 is compatible with any Version 8 JDK or Java server to deploy applications locally. It is compatible with HCL DX 8.5, 9.0, and 9.5 (CF205 or later) servers.
- HCL Web Experience Factory 8.5.1 is pre-installed in an Eclipse IDE. Use of the IBM Rational Application Developer IDE is not supported with this HCL WEF 8.5.1 release.
- Upgrading to HCL Web Experience Factory v8.5.1: We recommend developers install HCL Web Experience Factory v8.5.1 as a fresh installation and migrate existing portlets developed using previous releases of Web Experience Factory following the steps below.
Install HCL Web Experience Factory v8.5.1 in Windows and Linux Platforms
- Obtain HCL Web Experience Factory v8.5.1 from your HCL Software License Portal entitlements. HCL WEF 8.5.1 is included in all HCL Digital Experience 8.5 offering entitlements. See the Getting the Software Help Center topic for more information.
- Unzip the downloaded hcl-dx-wef-v8.5.1_2022XXXX.zip file.
The extracted file components contains:
- A
win
folder for Windows platform - A
linux
folder for Linux platform - A ReadMe Textfile for instructions to run the software once installed.
- A
- Download or use any JDK or JRE v8 installed to your local machine.
- Navigate to the installed path:
- For Windows platforms: From a command prompt, navigate to your WEF-8.5.1/win folder.
- For Linux Platforms: From a terminal, navigate to your WEF-8.5.1/linux folder.
- Run the script to replace
Variables
inlink
andini
files withPath
strings.- For Windows platforms: From the command prompt, run the
run.bat
command. - For Linux Platforms: From the terminal run the
sh run.sh
command. If successful, it prints the following message:The above tasks are completed
.
- For Windows platforms: From the command prompt, run the
- (Optional) Update the
eclipse.ini
file.- For Windows platforms: Navigate to
WEF-8.5.1/win/eclipse.
Add the following as
shown below:
-vm jre8-path\bin\javaw.exe
- For Linux Platforms: Navigate to
WEF-8.5.1/linux/eclipse.
Add the following as
shown below:
-vm jre8-path/bin
Note: In case you face any issues, refer to this topic for debugging guidance: https://wiki.eclipse.org/Eclipse.ini - For Windows platforms: Navigate to
WEF-8.5.1/win/eclipse.
Add the following as
shown below:
- Launch the eclipse.ini file using the executable file under
the Eclipse folder in the respective platforms.
Navigate to
and set the JRE path if it is not mapped already. This should allow Linked Java Objects to compile and work correctly. - After initial deployment, go to to change the IDE perspective.
- Select to create a new Web Experience Factory project. Add tutorials as desired.
- Deploy/Publish it to HCL Digital Experience server directly or by using DXClient.
Getting Started with HCL Web Experience Factory
- Go to
Web Experience Factory Designer
.
and search for - Expand the + sign at HCL Web Experience Factory
Designer. You can find a list of documents starting from
Overview of HCL Web Experience Factory Designer
through theGlossary
listings. - Go to information topic to learn how to publish models.
- Go to Note: Eclipse Kepler's online help (available through ) has known compatibility issues with Java 8. To access Eclipse Kepler's online help, follow the search content steps as described in Step 1.
to learn more about Builders.
Migrate portlets from IBM Web Experience Factory to HCL Web Experience Factory
- Create a backup of your existing WEF applications workspace.
- Open the eclipse using executable file under the eclipse folder in respective platforms.
- Enter the existing workspace path. It displays throw an alert message:
"Workspace '<old-workspace-path>' was written with an older version of the product and will be updated. Updating the workspace can make it incompatiable with older versions of the product. Are you sure you want to continue with this workspace?"
The alert message is displayed because the Eclipse version is upgraded during the HCL Web Experience Factory 8.5.1 installation. It does not corrupt your workspace. Click
OK
to continue. This opens all the applications in the latest WEF v8.5.1 perspective but with errors thrown for the project version. - Go to .
- Add the JRE 8 path and check it to default if it does not exist, otherwise verify JRE path you have defined is accurate.
- Right-click on each project and select Upgrade project Version.
- If you have set up IBM WebSphere Liberty v6 in the previous workspace, do note that it will also be migrated and it will run as if it runs on its own JRE 6. You may upgrade it to JRE 8 or delete it.
Import the SSL Certificate into the Java keystore
- Navigate to Installed-JRE-path'/lib/security from the workstation terminal or via command prompt.
- Execute the keytool to import the certificates into the Java keystore of the
current JRE that runs the HCL WEF v8.5.1 Designer (The keytool is pre-installed
with Java. If unavailable, install it separately).
- For Windows
platforms:
keytool.exe -import -trustcacerts -alias <alias-name> -file <path-to-the-certificate-file> -keystore <keystore> -storepass <password>
Example:keytool.exe -import -trustcacerts -alias default -file C:\Downloads\mylocal.der -keystore cacerts -storepass changeit
- For Linux
platforms:
keytool -import -trustcacerts -alias <alias-name> -file <path-to-the-certificate-file> -keystore <keystore> -storepass <password>
Example:kkeytool -import -trustcacerts -alias default -file /home/centos/Downloads/mylocal.der -keystore cacerts -storepass changeit
- For Windows
platforms:
- A success message displays after the certificates are imported into the Java keystore.
Deploy a portlet into target HCL DX servers
There are three options to deploy a portlet into a target HCL DX server:
A. Direct publish of the Portlet from Eclipse
- Right-click on the Web Experience Factory 8.5.1 project in Eclipse you want to export.
- Click Create a server configuration.
- Select the target HCL DX server to publish the application into.
- Test the server connection to verify the connection to the server. Click OK to continue.
- Click Finish to create the project according to the
details and features you have specified. The following message displays:
Would you like to publish your project now?
Click Yes to continue.
B. Export and import through the DX Administration interface
- Right-click on the Web Experience Factory 8.5.1 project you want to export.
- Select .
- Select .
- Choose .
- Login to the target DX server.
- Click on the Applications menu (Home icon) on the Administration header bar.
- Select the option.
- Install the WAR file exported in Steps 2 – 4.
- Navigate to the side toolbar and enable Edit Mode.
- Create a DX page and add the portlets deployed using the WAR file.
C. Import the exported WAR file using DXClient
The HCL DXClient tool can also be used to import portlet WAR files to target Digital Experience Servers. Refer to this DX Portlet Deploy Help Center topic to import the portlet WAR file using DXClient tool.