Search Group including the User

Operation Name

Function Overview

Gets groups including the users 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. Common name]:(Default) [Last name]: [First name]: [Display name]: [Telephone number]: [E-mail]: [Company]:	Displayed item can be changed at [Set search item].
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].

Account option settings

Item name	Required/Optional	Use of variables	Description
User must change password at next logon	Optional	Not available	Select whether to set an account "User must change password at next logon" valid as the search criteria. [Not checked]:(Default) Not set as search criteria. [Checked]: Set as search criteria.
Password never expires	Optional	Not available	Select whether to set an account with "Password never expires" valid as the search criteria. [Not checked]:(Default) Not set as search criteria. [Checked]: Set as search criteria.
Store password using reversible encryption	Optional	Not available	Select whether to set an account with "Store password using reversible encryption" valid as the search criteria. [Not checked]:(Default) Not set as search criteria. [Checked]: Set as search criteria.
Account disabled	Optional	Not available	Select whether to set an account with "Account disabled" valid as the search criteria. [Not checked]:(Default) Not set as search criteria. [Checked]: Set as 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 set up in script property to the adapter. [Disable]: Mass data processing is not performed. [Enable]: Mass data processing is performed.

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 Component 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

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

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

Primary group cannot be get as search results.

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.