NNS ADix - How to...Import or Export Pictures
   

This topic describes how to import or export pictures with NNS ADix.

General

Pictures can be stored in Active Directory using the following attributes:

Attribute Implementations ADS Type Size
thumbnailPhoto Windows Server 2000 and higher ADSTYPE_OCTET_STRING, single-valued 0-102400 bytes
thumbnailLogo Windows Server 2000 and higher ADSTYPE_OCTET_STRING, single-valued 0-32767 bytes
jpegPhoto Windows Server 2003 and higher ADSTYPE_OCTET_STRING, multi-valued unlimited
photo Windows Server 2003 and higher ADSTYPE_OCTET_STRING, multi-valued unlimited

Various applications can use these attributes to display or store pictures.

Note:
    For example Outlook 2010 uses the attribute thumbnailPhoto to display a thumbnail photo of a recipient in
    the Address Book/GAL.


Import or Export Pictures

With NNS ADix we provide a way to conveniently import or export pictures.
The following table contains a list of the auxiliary attributes used for picture export/import:

Attribute Export Behavior Import Behavior
adixThumbnailPhoto A thumbnail photo stored as octet string.
Converts the octet string stored in the Active Directory attribute thumbnailPhoto to the JPEG-format and saves the JPEG-file to the export path used for the current export operation. The file will be called [name]_thumbnailPhoto.jpg.
The full path to a picture-file.
Converts the picture-file to an octet string and saves this octet string to the Active Directory attribute thumbnailPhoto.
adixThumbnailLogo A thumbnail logo stored as octet string.
Converts the octet string stored in the Active Directory attribute thumbnailLogo to the JPEG-format and saves the JPEG-file to the export path used for the current export operation. The file will be called [name]_thumbnailLogo.jpg.
The full path to a JPEG-file.
Converts the picture-file to an octet string and saves this octet string to the Active Directory attribute thumbnailLogo.
adixJpegPhoto Photos stored as octet strings.
Converts the octet strings stored in the Active Directory attribute jpegPhoto to the JPEG-format and saves the JPEG-file to the export path used for the current export operation. The file will be called [name]_jpegPhoto[n].jpg.
The full path to one or more picture-files.
Converts the picture-files to octet strings and saves this octet strings to the Active Directory attribute jpegPhoto.
adixPhoto Photos stored as octet strings.
Converts the octet strings stored in the Active Directory attribute Photo to the JPEG-format and saves the JPEG-file to the export path used for the current export operation. The file will be called [name]_Photo[n].jpg.
The full path to one or more picture-files.
Converts the picture-files to octet strings and saves this octet strings to the Active Directory attribute Photo.

Simply use the attributes mentioned above to import or export pictures.

Note:
    We support the import of JPEG-, PNG- or GIF-formatted pictures. The format used for picture export is always JPEG.

Note:
    You can also import or export pictures using the Active Directory attributes directly, but using these attributes means to use or to get
    octet strings. Using the auxiliary attributes enables you to use or to get JPEG-files which is more convenient.

Example:

The following example imports a thumbnail photo based on the file 'c:\data\j.doe.jpg' for an user named 'j.doe':

path;adixThumbnailPhoto
LDAP://cn=j.doe,cn=users,dc=dom,dc=com;c:\data\j.doe.jpg

.top


 

Copyright © 2011 by NNS - Nigl Network Solutions