SubForm control type

The SubForm control type provides a means to use custom user interfaces for complex multi-valued attributes.

This control type is used infrequently by some IBM® Security Identity Manager adapters.

SubForm is a special control type used to start a servlet, JSP, or static HTML page from a window that opens from a custom IBM Security Identity Manager form. Use subforms to submit an arbitrary number of parameter names and values to a custom servlet or JSP. They are used to create custom user interfaces for complex multi-valued attributes.

Table 1. SubForm parameters
Parameter Description Value
customServletURI The URI to the servlet, JSP, or static HTML page to be started from the main form. If a servlet is implemented and deployed in the default web application for IBM Security Identity Manager, the value for this parameter is the same as the URL-pattern value defined byweb.xml in the servlet-mapping tag, without the slash (/). If a JSP is implemented, the value for this parameter is the JSP file name that includes the jsp file extension. This parameter is required on all subforms. Servlet name or JSP file name such as sample.jsp
Parameter Name Arbitrary parameter name and value that is included in the HTTP request that starts the resource at customServletURI. For example:
objectClass=erracfgrp
Parameter Value

From the Appliance Dashboard on the IBM Security Identity Manager virtual appliance console, click Configure > Advanced Configuration > Custom File Management. From the All Files tab, go to directories/utilities and download the extensions.zip file and extract it. Go to \extensions\7.0\examples\subform.