Create-Objects
The Create-Objects webject creates one or more instances of Windchill objects populated with the corresponding attribute values and stores them in the Windchill database.
• When creating a single object, this webject is typically called with the TYPE and FIELD parameters.
• When creating multiple objects, this webject is typically called with the GROUP_IN parameter.
All objects are created within a transaction. If any object creation fails, no objects are created.
Syntax
<ie:webject name="Create-Objects" type="ACT">
<ie:param name="ACCEPT_LANGUAGE"
data="$(@SERVER[]accept_language[])"/>
<ie:param name="ATTRIBUTE" data="attribute"/>
<ie:param name="AUTHORIZATION"
data="$(@SERVER[]authorization[0])"/>
<ie:param name="CONNECTION_ATTEMPTS" data="attempts"/>
<ie:param name="CONNECTION_ATTEMPT_INTERVAL" data="interval"/>
<ie:param name="CONTAINER_REF" data="[ufid | MEMBERSHIP]"/>
<ie:param name="DBUSER" data="username"/>
<ie:param name="DESCRIPTOR" data="attribute_name"/>
<ie:param name="FIELD" data="field"/>
<ie:param name="FORMAT" data="[TRUE | FALSE]"/>
<ie:param name="GROUP_FILTER" data="group_name"/>
<ie:param name="GROUP_IN" data="group_in"/>
<ie:param name="GROUP_OUT" data="group_out"/>
<ie:param name="INCLUDE_ARGS" data="[TRUE | FALSE]"/>
<ie:param name="INCLUDE_CONSTRAINTS" data="[TRUE | FALSE]"/>
<ie:param name="INCLUDE_DESCRIPTORS" data="[TRUE | FALSE]"/>
<ie:param name="INSTANCE" data="appl_name"/>
<ie:param name="NEXT_OP" data="operation_name"/>
<ie:param name="PASSWD" data="password"/>
<ie:param name="REFERENCE_EXCEPTIONS" data="[TRUE | FALSE]"/>
<ie:param name="SESSION_ID" data="$(session[]session_ID[])"/>
<ie:param name="TYPE" data="type_name"/>
</ie:webject>
<ie:param name="ACCEPT_LANGUAGE"
data="$(@SERVER[]accept_language[])"/>
<ie:param name="ATTRIBUTE" data="attribute"/>
<ie:param name="AUTHORIZATION"
data="$(@SERVER[]authorization[0])"/>
<ie:param name="CONNECTION_ATTEMPTS" data="attempts"/>
<ie:param name="CONNECTION_ATTEMPT_INTERVAL" data="interval"/>
<ie:param name="CONTAINER_REF" data="[ufid | MEMBERSHIP]"/>
<ie:param name="DBUSER" data="username"/>
<ie:param name="DESCRIPTOR" data="attribute_name"/>
<ie:param name="FIELD" data="field"/>
<ie:param name="FORMAT" data="[TRUE | FALSE]"/>
<ie:param name="GROUP_FILTER" data="group_name"/>
<ie:param name="GROUP_IN" data="group_in"/>
<ie:param name="GROUP_OUT" data="group_out"/>
<ie:param name="INCLUDE_ARGS" data="[TRUE | FALSE]"/>
<ie:param name="INCLUDE_CONSTRAINTS" data="[TRUE | FALSE]"/>
<ie:param name="INCLUDE_DESCRIPTORS" data="[TRUE | FALSE]"/>
<ie:param name="INSTANCE" data="appl_name"/>
<ie:param name="NEXT_OP" data="operation_name"/>
<ie:param name="PASSWD" data="password"/>
<ie:param name="REFERENCE_EXCEPTIONS" data="[TRUE | FALSE]"/>
<ie:param name="SESSION_ID" data="$(session[]session_ID[])"/>
<ie:param name="TYPE" data="type_name"/>
</ie:webject>
Parameters
|
Required
|
Interdependent
|
Optional
|
|---|---|---|
|
INSTANCE
|
AUTHORIZATION
|
ACCEPT_LANGUAGE
|
|
CONTAINER_REF
|
ATTRIBUTE
|
|
|
DBUSER
|
CONNECTION_ATTEMPTS
|
|
|
DESCRIPTOR
|
CONNECTION_ATTEMPT_INTERVAL
|
|
|
FIELD
|
FORMAT
|
|
|
GROUP_FILTER
|
GROUP_OUT
|
|
|
GROUP_IN
|
SESSION_ID
|
|
|
INCLUDE_ARGS
|
||
|
INCLUDE_CONSTRAINTS
|
||
|
INCLUDE_DESCRIPTORS
|
||
|
NEXT_OP
|
||
|
PASSWD
|
||
|
REFERENCE_EXCEPTIONS
|
||
|
TYPE
|
 |
If a parameter is listed in the table but is not defined below, then it has a common parameter definition. For descriptions of those parameters, see Common Webject Parameters section in Adapter Webjects Overview.
|
ATTRIBUTE
The attributes to be returned in the output group for each object. Multiple values can be specified for this parameter. If this parameter is not specified, a default set of attributes is returned.
The default set of attributes is configured in the DefaultAttributes property value of the wt.adapter.delegates.properties file.
If a DefaultAttributes property is not defined, all attributes of all objects are returned. This parameter is optional.
|
|
You must specify a context if the value of the folder attribute is the folder name.
|
CONTAINER_REF
The UFID of a Windchill context with which to associate the created objects. All objects are created in this context.
FIELD
An attribute and associated value to be included in the requested operation. The attribute and associated value are separated by an equals sign. For example:
<ie:param name="FIELD" data="source=wt.part.Source.make"/>
The attribute and value are dependent on the object and operation being performed. This parameter is optional. This parameter can have multiple values.
GROUP_IN
The input group containing objects to create. Each element represents an object to be created.
The type of each object is determined by the value of the CLASS attribute value within a given element. If an element does not have a CLASS attribute value, an exception is thrown.
All attributes other than CLASS and OBID are used as the attribute values on the object being created. If attribute values are Java objects, then they must match the appropriate type for the attribute being populated.
If an attribute value is a string, but the corresponding attribute being populated is of a different type, then attribute translation is attempted and the string value must conform to the string representation of the corresponding Java object.
GROUP_OUT
The name of the output group containing the results. If this parameter is omitted, then the name of the output group is constructed by appending the string “-Output” to the webject name. This parameter is optional.
TYPE
The name of the type of object or objects. If GROUP_IN is specified, then TYPE is not necessary, since object types are controlled by the CLASS attribute value of an element.