C.3 Using the ImageFile PostProcessor

The ImageFile PostProcessor extension allows you to easily export images from the directory to the file system as JPG or PNG files. The PostProcessor further processes the output file generated by the driver. It expects the output file to be in a certain format. The images are contained in the output file as Base64-encoded strings and are then converted into binary blobs and written to files in a specified directory.

Figure C-3 ImageFile PostProcessor Extension

Policies and style sheets can be used to control the export process. The images are usually stored in an attribute of syntax Octet String or Stream for binary data.

C.3.1 Installing the ImageFile PostProcessor Extension

The ImageFile PostProcessor extensions are installed when you install Identity Manager and select the Delimited Text driver. The extensions are configured in the driver parameters. Each extension takes a parameter string that is specified in the driver parameters and passes it to the extension during initialization. Extensions define their own format for the parameter string.

The extensions are included in the DelimitedTextUtil.jar file.

C.3.2 Configuring the Driver for the ImageFile Extension

Driver Module

The ImageFile InputSource requires the DelimitedText driver. Select Java and enter com.novell.nds.dirxml.driver.delimitedtext.DelimitedTextDriver as the driver module. If you want to run the driver with the Remote Loader, select Connect to Remote Loader and enter com.novell.nds.dirxml.driver.delimitedtext.DelimitedTextDriver as the the driver module in the Remote Loader console.

Driver Parameters

Use the following table to configure the driver. For additional information regarding other driver parameters, refer to the Identity Manager Driver for Delimited Text documentation.

Table C-3 ImageFile PostProcessor Parameters

Parameter

XML Name

Sample Value

Purpose

Field Delimiter

field-delimiter

#

Indicates the character that is used to delineate field values in the input files. It must be one character.This must be set to the same character as the delim extension parameter or, if delim is not specified, to #.

Field Names (Field1, Field2, Field3…)

field-names

idx name prefix suffix size modified pic64

A comma-separated list of attribute names that can be referred to in the Schema Mapping rule. In the input files, the fields of the records must correspond to the order and positioning of the names in this list. For example, if you list eight field names in this parameter, then each record of the input files should have eight fields separated by the field delimiter character.The extension defines which fields it supports. The fields as listed here are the ones delivered by the extension. Altering the fields can cause malfunction.

PostProcessor Class

post-processor

com.novell.nds.dirxml.driver.delimitedtext.imagefile

Class name of the input source.

PostProcessor init string

post-processor-params

destdir=/var/novell/idm/users/output/images;format=png;debug=true

PostProcessor initialization parameters. For more information, see Section C.1.1, Installing the ImageFile InputSource Extension.