Compiling and configuring the user exit

The following sections provide an overview on how to compile and configure the sample user exit.

To compile this sample user exit, you need the following files:
  • SampleParticipantValidation.java
  • base_java_utilities.jar
  • Configuration_SDK.jar
  • payment_accessors.jar
  • util.jar

Getting the user exit files from the container

Complete the following steps to get the user exit files from the artifacts container.
  1. The files for user exits are provided in the FTM artifacts pod and must be downloaded from the pod. For more information about getting files from the artifacts container for your offering, see Getting the files from the artifacts container for your FTM offering.
  2. Extract the user exit files on a workstation that has the Java™ compiler.

Compiling

To compile the user exit, complete the following steps.
Note: The following example of compiling the user exit must be customized based on the Java class name, Java package name, and location of the dependency JAR files that you are using.
  1. The SampleParticipantValidation class is in the com.ibm.fxh.core.ui.validation Java package, so create the following directory structure: C:\com\ibm\fxh\core\ui\validation.
  2. Copy the following files into the C:\com\ibm\fxh\core\ui\validation directory.
    • SampleParticipantValidation.java
    • base_java_utilities.jar
    • Configuration_SDK.jar
    • payment_accessors.jar
    • util.jar
  3. Compile the Java class by using the following commands. Use the IBM® Java V1.8 SDK to compile.
    cd C:\com\ibm\fxh\core\ui\validation
javac SampleParticipantValidation.java -classpath base_java_utilities.jar;Configuration_SDK.jar;payment_accessors.jar;util.jar

Packaging

After the code is compiled, package the class file into a JAR file that is used to deploy into the framework user interface runtime.

The following example of creating a JAR file must be customized based on your selected file names.
cd \
jar cvf C:\com\ibm\fxh\core\ui\validation\SampleParticipantValidation.jar com\ibm\fxh\core\ui\validation\SampleParticipantValidation.class

Installing

For more information about installing this user exit, see User exits for the FTM components.

Configuring

To use the user exit, configure it in the user interface.

  1. Browse to the Common Services properties page.
  2. Click Edit.
  3. Enter the value com.ibm.fxh.core.ui.validation.SampleParticipantValidation for the Participant Validation User Exit property.
  4. Save your changes and restart the Control Center.