List-FolderContents
Returns a group that lists the objects contained within a specified folder or cabinet, which acts as a top-level folder.
Syntax
<ie:webject name="List-FolderContents" type="OBJ">
<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="CONTENT_TYPE" data="content_type"/>
<ie:param name="DBUSER" data="username"/>
<ie:param name="DESCRIPTOR" data="attribute_name"/>
<ie:param name="FOLDER_PATH" data="pathname"/>
<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="OBJECT_REF" data="ufid"/>
<ie:param name="PASSWD" data="password"/>
<ie:param name="REFERENCE_DELIMITER" data="^" />
<ie:param name="REFERENCE_EXCEPTIONS" data="[TRUE | FALSE]"/>
<ie:param name="REFERENCE_OUTPUT_DELIMITER" data="^" />
<ie:param name="TYPE" data="type_name"/>
<ie:param name="UNFORMATTED" data="dataType" />
<ie:param name="WHERE" data="where-clause"/>
<ie:param name="WHERE_CASE_SENSITIVITY" data="[TRUE | FALSE]"/>
</ie:webject>
Parameters
|
Required
|
Interdependent
|
Optional
|
|
INSTANCE
|
AUTHORIZATION
|
ACCEPT_LANGUAGE
|
|
CONTAINER_REF
|
ATTRIBUTE
|
|
DBUSER
|
CONNECTION_ATTEMPTS
|
|
DESCRIPTOR
|
CONNECTION_ATTEMPT_INTERVAL
|
|
FOLDER_PATH
|
CONTENT_TYPE
|
|
GROUP_FILTER
|
FORMAT
|
|
INCLUDE_ARGS
|
GROUP_IN
|
|
INCLUDE_CONSTRAINTS
|
GROUP_OUT
|
|
INCLUDE_DESCRIPTORS
|
REFERENCE_DELIMITER
|
|
NEXT_OP
|
REFERENCE_OUTPUT_DELIMITER
|
|
OBJECT_REF
|
UNFORMATTED
|
|
PASSWD
|
|
|
REFERENCE_EXCEPTIONS
|
|
|
TYPE
|
|
|
WHERE
|
|
|
WHERE_CASE_SENSITIVITY
|
|
|
|
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 Common Webject Parameters section 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 and WHERE and FOLDER_PATH parameters are restricted to the associated context.
CONTENT_TYPE
The types of objects to return. Multiple values can be specified for this parameter in order to identify multiple types of objects to return.
Each value of this parameter is the fully qualified name of a modeled class or subtype. If this parameter is omitted, all objects contained within the folder are returned. This parameter is optional.
FOLDER_PATH
The fully qualified path of the folder or cabinet for which contents are returned.
The string after the first “/” in the path must be the name of a cabinet. For example, the path name of “a_folder” under the “System” cabinet is /System/a_folder.
If just “/” is specified, then all root-level cabinets are returned.
Multiple values can be specified for this parameter. This parameter can be used instead of, or in addition to, TYPE, WHERE and OBJECT_REF to specify the folder.
GROUP_IN
Name of an input group containing one UFID per element (OBID attribute) that represents a folder or cabinet. This parameter is optional.
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.
OBJECT_REF
The Unique Federation Identifier (UFID) of a Windchill object. Multiple values can be specified for this parameter to identify multiple objects.
This parameter can be used instead of or in combination with WHERE, FOLDER_PATH, and GROUP_IN.
TYPE
Specifies the name of the notifiable Windchill type of the objects to be queried for. If WHERE is specified, then TYPE must also be specified. OBJECT_REF can be specified instead of, or in addition to, this parameter.
WHERE
A query expression identifying the objects for which to query. This parameter can be used instead of or in combination with OBJECT_REF, FOLDER_PATH, and GROUP_IN.
If WHERE is specified, then TYPE must also be specified. For more information, see
Specifying the TYPE and WHERE Parameters.
