Move Group

Operation Name

Move Group

Function Overview

Moves the group which matches the specified search criteria to "Users" or specified "OU(Organizational Unit)".

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]: [Memo]:	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.
Move to	Required	Not available	Select where to move. [User(Users)]:(Default) Moves a group to the "Users". [Organizational Unit(OU)]: Moves the group to a Organizational Unit set in [Organization name].
Organization name	Optional	Available	Enter the organization name of move to.	If [Organizational Unit(OU)] is selected at [Move to], this will be valid.

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].

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

None.

Transaction

Transaction is not supported.

PSP Usage

PSP is not supported.

Available Componet Variables

Component variable name	Description	Remarks
execute_count	Stores the number of data moved.	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	Equal to Start with	Suzuki Ichiro 03	Common name="Suzuki Ichiro" AND Telephone number="03*"

Specified Methods for a Hierarchized Organization

If moving it to a hierarchized organization, specify it by supplement "OU=" and divide it with ","(Comma) to separate from bottom of hierarchy.

"OU=" at the head is supplemented automatically, so do not specify.

Example: If it is like following hierarchy

If moving to "ouB", Specify it as "ouB,OU=ouA".
If moving to "ouC", S@ecify it as "ouC,OU=ouB,OU=ouA".

Specification Limits

If search criteria is not set up, all user account will be extracted.

If multiple accounts correspond to search criteria, all of them will be target for update.

Account can be identified by specifing it in search criteria since [Group name(pre-Windows2000)] is unique attribute in the Active Directory.

If [Include child domain as operation target] is checked in global resource and the account which matches to [Search criteria] includes the group of child domain, "jp.synctrust.util.account.context.ContextException" error may occur. In this case, remove check from [Include child domain as operation target].

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].
InvalidPropertyConfigurationException Organization name is not entered.	[Organization name] is not entered.	Enter [Organization name].
Organization name specified in InvalidPropertyConfigurationException does not exist.	Organizational Unit specified in [Organization name] does not exist.	Confirm [Organization name].
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.