Create-TypeInstance
Creates one or more type instances, but does not store them in the Windchill database.
The ATTRIBUTE and FIELD parameters are processed first to construct a single type instance. This processing occurs if either FIELD is specified or GROUP_IN is not specified.
The FIELD parameter can be used for the following:
• Specify values to populate in the resulting type instance.
• Override default values for a given attribute specified in the list of ATTRIBUTE parameter values.
If specified, the contents of GROUP_IN are processed second. One type instance per element within the GROUP_IN is constructed and added to the output group. The attributes in each resulting type instance are determined by combining the ATTRIBUTE parameter values with the attributes found in a given element.
Similar to the FIELD parameter, each attribute value in an element serves to populate or override default values in the resulting type instance. Attributes named CLASS or OBID within any element of the GROUP_IN parameter are ignored.
Syntax
<ie:webject name="Create-TypeInstance" 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="FIELD" data="field"/>
<ie:param name="FORMAT" data="[TRUE | FALSE]"/>
<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="SESSION_ID" data="$(session[]session_id[])"/>
<ie:param name="TYPE" data="type_name"/>
<ie:param name="UNFORMATED" data="dataType"/>
</ie:webject>
Parameters
|
Required
|
Interdependent
|
Optional
|
|
INSTANCE
|
AUTHORIZATION
|
ACCEPT_LANGUAGE
|
|
TYPE
|
CONTAINER_REF
|
ATTRIBUTE
|
|
DBUSER
|
CONNECTION_ATTEMPTS
|
|
PASSWD
|
CONNECTION_ATTEMPT_INTERVAL
|
|
INCLUDE_ARGS
|
FIELD
|
|
INCLUDE_CONSTRAINTS
|
FORMAT
|
|
INCLUDE_DESCRIPTORS
|
GROUP_IN
|
|
NEXT_OP
|
GROUP_OUT
|
|
|
SESSION_ID
|
|
|
UNFORMATTED
|
|
|
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 the section Common Webject Parameters in Adapter Webjects Overview. |
CONTAINER_REF
A Windchill context to apply the webject against. This parameter accepts the following types of input:
• The UFID of a Windchill context. Multiple UFIDs can be specified for this parameter.
• MEMBERSHIP—The query finds only those contexts of which the user is a member.
When this parameter is specified, the scope of queries executed against the TYPE parameter is restricted to the associated context.
FIELD
The attributes and associated values to be created (global attribute values and or attribute values of subtypes). This parameter is optional.
For global attributes, just the name and value of the desired attribute is specified. For example:
"source=wt.part.Source.make."
The FIELD parameter can be used for the following:
• Specify values to populate in the resulting type instance.
• Override default values for a given attribute specified in the list of ATTRIBUTE parameter values.
GROUP_IN
Input group containing attributes to populate the new type instance. This parameter is optional.
Similar to the FIELD parameter, each attribute value in an element serves to populate or override default values in the resulting TypeInstance. Attributes named CLASS or OBID within any element of the GROUP_IN parameter are ignored.
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 object type name. If WHERE is specified, TYPE must also be specified. For more information, see
Specifying the TYPE and WHERE Parameters.
