Add a Group

Operation Name

Add a Group

Function Overview

Registers Group with specified contents.
Enables a group to belong to specified group.

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".
Group name	Required	Available	Enter the group name.	Same value will be set to [Group name(pre-Windows2000)] when entered. Available character string length is 64 characters maximum.
pre-Windows 2000 group name	Required	Available	Enter the pre-Windows 2000 group name.	Available character string length is 256 characters maximum.
Group scope	Required	Not available	Select group scope. [Domain local]: [Global]:(default) [Universal]:
Group type	Required	Not Available	Select sort of group. [Security]:(default) [Distribution]:

Optional settings

Item name	Required/Optional	Use of variables	Description	Remarks
Belonging group name	Optional	Available	Enter a group name registered as a member.	Enter by seperating with comma, when registering multiple group.
Description	Optional	Available	Enter a description.
E-mail	Optional	Available	Enter an e-mail.
Memo	Optional	Available	Enter a memo.

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

Component variable name	Description	Remarks
register_count	Stores the number of resistered data.	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	Returns the error type when error occurred.	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	Returns the error message when error occurred.	Default value is null. The message may vary depending on the DataSpider Servista version.
error_trace	Returns the trace information when error occurred.	Default value is null. The message may vary depending on the DataSpider Servista version or the client application used.

Specification Limits

Registered account is created in "Users".
When adding a group with checked [Include child domain as operation target] in global resource, "jp.synctrust.util.account.context.ContextException" error may occur if an account which matches to the name set in [Group name] or [Group name(pre-Windows2000)] is registered to the child domain. In this case, uncheck [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 item of resource is not specified.	Required item selected in [Destination] is not specified.	Specify required item of resource.
InvalidPropertyConfigurationException Required item is not specified.	Required item is not specified.	Specify required item.
InvalidPropertyConfigurationException Exceeds maximum length.	Character string length of entered item exceeds maximum value.	Enter value below the available character string length.
InvalidPropertyConfigurationException Setting value is wrong.Group name(pre-Windows).	There is some non-enterable words below in [Group name(pre-Windows2000)]. . , / \ [ ] : ; \| = + * ? < > "	Enter proper value in [pre-Windows 2000 group name].
jp.synctrust.util.account.context.ContextException Not available to resister because of same account duplication.	Account has already resistered correspond with [Group] or [Group name(pre-Windows2000)].	Confirm setting contents.
java.rmi.UnmarshalException	Certificate is not inported in $DATASPIDER_HOME/jre/lib/security/cacerts.	It is required to inport certificate in $DATASPIDER_HOME/jre/lib/security/cacerts.