11.6 Creating Gateway Plug-In Registration Files

When you execute the Create Printer task, the Gateway type drop-down list contains a dynamic list of gateway types. This list is created from the registration files that reside in the directory WEB-INF\plugins\ndps\gatecfg. To make your gateway plug-in available in this list you need to create a registration file for your plug-in and copy it to this directory.

Registration files for gateway plug-ins are similar to registration files for regular iManager plug-ins. They consist of XML tags that define the plug-in. The following example shows the CompanyXYZ.xml file that is included with the iManager 2.7 SDK:

 <plugins>
   <gateway-config>
     <id>iPrint.gatecfg.CompanyXYZ</id>
     <version>1.0</version>
     <required-version>2.7.0</required-version>
     <register-gadget>true</register-gadget>
     <display-name-key>GateConfigNameKey</display-name-key>
     <resource-properties-file>CompanyXYZResources</resource-properties-file>
     <class-name>com.novell.imanage.iPrint.plugins.GatewayTemplate</class-name>
     <merge-template>iPrint.gatecfg.GatewayTemplate</merge-template>
   </gateway-config>
 </plugins>
 

The outermost tag, <plugins>, is identical to that used for iManager plug-ins. The main difference is that registration files for gateway plug-ins use the <gateway-config> tag to define a gateway rather than <role>, <task>, or <book>. However, the remaining tags are identical to those used to define tasks, and they serve the same purposes. For detailed information about these tags, see Section 3.5, Creating Registration Files.