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.
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.
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 and enter com.novell.nds.dirxml.driver.delimitedtext.DelimitedTextDriver as the the driver module in the Remote Loader console.
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. |