Adding a Service Catalog GroupAdded by IBM on October 26, 2012 | Version 1 (Original)
|A Service Catalog Group provides a way to group web services in IBM® Forms Experience Builder. Tags: Forms Experience Builder, Service
Catalog Group, adding, OSGi Service description, creating, MANIFEST.MF, .jar files, packaging, Java class, 8.0, design, develop
Refer to Setting up your development environment before starting.
A new Service Catalog Group can be added toForms Experience Builder by creating and deploying an appropriate OSGi .jar bundle.
To the application designer, Service Catalog Groups are listed in the Service Catalog dropdown in the Forms Experience Builder Service Configuration dialog. This dropdown allows the application designer to filter services by the Service Catalog Group to which they belong. By default, there are two predefined groups: General and IBM Forms Experience Builder Applications. Providing a new implementation of a Service Catalog Group creates a group as an option in the Service Catalog dropdown. Services can be added to a particular Service Catalog Group by implementing a Service Catalog that belongs to that group.
- Create a Java class
Create a Java class that implements the com.ibm.form.nitro.service.services.IServiceCatalogGroup interface to return a unique group identifier and a readable group name. The following example adds the My Services group to the Forms Experience Builder.
In this example, the locale used by the user can be retrieved by using com.ibm.form.platform.service.framework.i18n.LocaleUtils.getRequestLocale(. If you are using the Eclipse IDE, its Externalize Strings wizard can extract strings for your OSGi bundle.
public class MyServiceCatalogGroup
public String getGroupId()
public String getGroupName()
Locale requestLocale = LocaleUtils.getRequestLocale();
/* use request locale to determine a translated group name */
return "My Services";
- Create an OSGi Service Description
You must create an .xml file to declare your Java class as an OSGi service. For example, create a MyServiceCatalogGroup.xml file with the following content:
For the class attribute of the implementation element, use the fully qualified name of the Java class you created in Step 1 . Ensure that the name attribute of the component element is unique. Although not required, you can make the name attribute the same as the fully qualified name of the Java class that you created in Step 1 .
<?xml version="1.0" encoding="UTF-8"?>
<implementation class="com.mycompany.services.MyServiceCatalogGroup" />
- Create a MANIFEST.MF file
Bundle-Name: My Company Services
Bundle-Vendor: My Company
- Deploy the Service Catalog Group.
Create a .jar file that contains all the files listed in the previous steps in an OSGi bundle structure. For example:
On the Forms Experience Builder server, put the .jar file in one the following directories or in a subdirectory of one of the following directories:
- Non Windows:
- If the extensions directory does not exist, you must restart the Forms Experience Builder server after the directory is created.
- /opt/ibm/forms/ is not case-sensitive.