Search Group including the Group

Operation Name

Function Overview

Gets groups including the groups which match the specified search criteria.

Data Model

XML type.

Properties

For information about using variables, refer to "variables".

Basic Settings

Item name	Required/Optional	Use of Variables	Description	Remarks
Name	Required	Not available	Enter the name to show on the script canvas.

Required Settings

Item name	Required/Optional	Use of variables	Description	Remarks
Destination	Required	Not available	Select a global resource. For more details on global resource settings, refer to "Global resource properties. [Add]: Adds a new global resource. [Edit list]: Enables to edit the global resource settings in the "Edit resource list".
Search Criteria	Optional	-	Specify the search criteria. It can be operated by following buttons. [Add]: Adds a search criteria. [Up]: Moves the order of the selected search criteria upwards by one. [Down]: Moves the order of the selected search criteria downwards by one. [Delete]: Deletes a search criteria.
Search criteria/Item	Required	Not available	Select the search item. [Group name]:(Default) [Group name(pre-Windows2000)]: [Group type]: [Description]: [E-mail]: [Notes]:	Displayed item can be changed at [Set search items]. If [Group type] was selected, select [Equal to] for [Range].
Search criteria/Range	Required	Not available	Select the search range. [Contain]:(Default) [Equal to]: [Start with]: [End with]:
Search criteria/Content	Required	Available	Enter the searching content.	If entering english letter, a capital letter and a small letter will be searched without distinction.

Property action

Item name	Description	Remarks
Set search items	Start Set search items wizard and then set up displayed item of [Item] from [Search criteria].

Data processing method

Item name	Required/Optional	Use of variables	Description	Remarks
Data processing method	Required	Not available	Select a data processing method. [Use script settings]:(Default) Applies the setting of mass data processing in script property to the adapter. [Disable]: Does not perform mass data processing. [Enable]: Performs mass data processing.

Comment

Item name	Required/Optional	Use of variables	Description	Remarks
Comment	Optional	Not available	You can write a short description of this adapter. The description will be reflected in the specifications.

Schema

Input schema

None.

Output schema

<?xml version="1.0" encoding="Shift_JIS"?>
<activedirectory>
<group>
  <cn></cn>
  <sAMAccountName></sAMAccountName>
  <groupType></groupType>
  <groupNameIncludedMember></groupNameIncludedMember>
  <description></description>
  <mail></mail>
  <info></info>
</group>
</activedirectory>

Item name	Item name(Japanese)	Remarks
cn	Group name
sAMAccountName	Group name(pre-Windows2000)
groupType	Group type	For more detailes on set point, refer to, "Set point of group type".
groupNameIncludedMember	Belonging group name	Specify multiple affiliated groups by using comma to separate, and enclose it with ""(double quotation).
description	Description
mail	E-mail
info	Notes

Item without attribute will be set up as ""(null character).
If multiple output information exists, setting order will be unsettled.

Loading schema on mapper

Schema is loaded automatically.

For more details, refer to "Edit schema".

Mass Data Processing

Mass data processing is supported.

PSP Usage

PSP is not supported.

Available Componet Variables

Component variable name	Description	Remarks
execute_count	Stores the number of data that are searched.	Default value is null.
message_category	Stores the category of message code corresponding to the occured error.	Default value is null.
message_code	Stores the code of message code corresponding to the occured error.	Default value is null.
message_level	Stores the severity of message code corresponding to the occured error.	Default value is null.
error_type	When an error occurs, the type of error occurred will be stored.	Default value is null. Error is represented in the format depicted below. Example:"java.io.FileNotFoundException The message may vary depending on the DataSpider Servista version.
error_message	When an error occurs, the message of error occurred will be stored.	Default value is null. The message may vary depending on the DataSpider Servista version.
error_trace	When an error occurs, the trace of error occurred will be stored.	Default value is null. The message may vary depending on the DataSpider Servista version or the client application used.

Search Method When Two or More Items are Set

Use OR conditon when items are same, and use AND condition when items are different.
Example:

Item	Range	Content	Search method
Common name Common name	Equal to Start with	Suzuki Ichiro Tanaka	Common name="Suzuki Ichiro" OR Common name="Tanaka*"
Common name Telephone number	Equal to Start with	Suzuki Ichiro 03	Common name="Suzuki Ichiro" AND Telephone number="03*"

Specification Limits

[Group name(pre-Windows2000)] is unique attribute in the Active Directory, therefore account can be identified by specifying it in search criteria.

If search criteria is no set, all of the group account that holds group member will be target for operation.

Main Exceptions

Exception name	Cause	Solution
ResourceNotFoundException Resource definition could not be found. Name:[]	[Destination] is not specified.	Specify [Destination].
ResourceNotFoundException Resource definition could not be found. Name:[<Name of global resources>]	Resource definition selected in [Destination] is not found.	Confirm the global resource specified in [Destination].
InvalidPropertyConfigurationException Required items for resource is not speficied.	Required items of resource selected by [Destination] is not specified.	Specify required items for resource.
InvalidPropertyConfigurationException Search criteria(Content) is not entered.	[Content] of [Search criteria] is not entered.	Enter [Content] of [Search criteria] or delete it from [Search criteria].
java.rmi.UnmarshalException	Certificate has not been imported in $DATASPIDER_HOME/jre/lib/security/cacerts.	It is necessary to import certificate in $DATASPIDER_HOME/jre/lib/security/cacerts.