Query-Links
Query-Links Webject は、Windchill オブジェクト間の関連付けをナビゲーションします。ベースオブジェクトがある場合は、指定した関連および役割によってベースオブジェクトと関連付けられるすべてのオブジェクトを返します。
構文
<ie:webject name="Query-Links" type="OBJ">
<ie:param name="ACCEPT_LANGUAGE"
data="$(@SERVER[]accept_language[])"/>
<ie:param name="ATTRIBUTE" data="attribute_name"/>
<ie:param name="AUTHORIZATION"
data="$(@SERVER[]authorization[0])"/>
<ie:param name="AUTO_NAVIGATE" data="[TRUE|FALSE]"/>
<ie:param name="CONFIGSPEC_OBJECT_META" data="meta_name"/>
<ie:param name="CONNECTION_ATTEMPTS" data="attempts"/>
<ie:param name="CONNECTION_ATTEMPT_INTERVAL" data="interval"/>
<ie:param name="CONTENT_TYPE" data="content_type"/>
<ie:param name="DBUSER" data="username"/>
<ie:param name="DESCRIPTOR" data="attribute_name"/>
<ie:param name="DIRECTION" data="role-name"/>
<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="OUTPUT_TYPE"
data="[OTHER_SIDE | RELATION | FULL]"/>
<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="SELECTBY" data="config_spec_name" />
<ie:param name="SELECTBY_BASELINE_REF"
data="selectby_baseline" />
<ie:param name="SELECTBY_CONFIG_ITEM_REF" data="ufid" />
<ie:param name="SELECTBY_CONFIGSPEC_REF" data="ufid" />
<ie:param name="SELECTBY_DATE" data="date" />
<ie:param name="SELECTBY_IN_USE_BY_USER" data="[TRUE | FALSE]" />
<ie:param name="SELECTBY_INCLUDE_WORKING" data="[TRUE | FALSE]"/>
<ie:param name="SELECTBY_LIFECYCLE_STATE"
data="selectby_lifecycle_state" />
<ie:param name="SELECTBY_UNIT" data="unit_value" />
<ie:param name="SELECTBY_VIEW_REF" data="view_object_ufid" />
<ie:param name="TYPE" data="type_name"/>
<ie:param name="UNFORMATTED" data="dataType" />
</ie:webject>
パラメータ
|
必須
|
相互依存
|
オプション
|
|
DIRECTION
|
AUTHORIZATION
|
ACCEPT_LANGUAGE
|
|
INSTANCE
|
CONFIGSPEC_OBJECT_META
|
ATTRIBUTE
|
|
TYPE
|
DBUSER
|
AUTO_NAVIGATE
|
|
GROUP_IN
|
CONNECTION_ATTEMPTS
|
|
DESCRIPTOR
|
CONNECTION_ATTEMPT_INTERVAL
|
|
GROUP_FILTER
|
CONTENT_TYPE
|
|
INCLUDE_ARGS
|
FORMAT
|
|
INCLUDE_CONSTRAINTS
|
GROUP_OUT
|
|
INCLUDE_DESCRIPTORS
|
OUTPUT_TYPE
|
|
NEXT_OP
|
REFERENCE_DELIMITER
|
|
OBJECT_REF
|
REFERENCE_OUTPUT_DELIMITER
|
|
PASSWD
|
UNFORMATTED
|
|
REFERENCE_EXCEPTIONS
|
|
|
SELECTBY
|
|
|
SELECTBY_BASELINE_REF
|
|
|
SELECTBY_CONFIG_ITEM_REF
|
|
|
SELECTBY_CONFIGSPEC_REF
|
|
|
SELECTBY_DATE
|
|
|
SELECTBY_IN_USE_BY_USER
|
|
|
SELECTBY_INCLUDE_WORKING
|
|
|
SELECTBY_LIFECYCLE_STATE
|
|
|
SELECTBY_UNIT
|
|
|
SELECTBY_VIEW_REF
|
|
|
|
表に記載されているパラメータの定義が以下にない場合、そのパラメータは共通の定義を持っています。これらのパラメータの説明については、 アダプタ Webject の概要の「一般 Webject パラメータ」セクションを参照してください。 |
AUTO_NAVIGATE
初期のナビゲーション結果を自動的に後処理して、より直接的に使用可能な結果を作成するかどうかを指定します。指定しない場合、デフォルト値は TRUE です。このパラメータはオプションです。
Windchill では、マスターおよび作業版数のデータモデルを持つ作業版数およびバージョンが設定されたオブジェクトから製品構造が構築されます。
製品構造のルートは、複数の作業版数を持つマスターオブジェクトです。マスターはそれぞれの作業版数にリンクします。各作業版数もマスターにリンクし、製品構造ではマスターの子として示されます。一般的に、アプリケーションはマスターおよび作業版数リンクをナビゲーションしません。代わりに、対象となるすべての属性を含んでいる作業版数のみを検索します。
AUTO_NAVIGATE パラメータを使用すると、Webject が自動的にマスターから作業版数にナビゲーションし、フェデレーションクライアントアプリケーションが通常検索する情報を出力グループに含めることができます。また、AUTO_NAVIGATE パラメータを使用すると、Webject は自動的に LightweightProxy オブジェクトの参照を解除し、リモートシステムから読み込まれていた出力グループの要素を返します。
CONFIGSPEC_OBJECT_META
オブジェクトをフィルタするときに使用する ConfigSpec オブジェクトを含むメタデータの名前。このパラメータは、SELECTBY=CONFIGSPEC_OBJECT の場合のみ使用します。
このパラメータは必須ではありません。デフォルト値は com.ptc.windchill.configSpec です。
CONTENT_TYPE
返されるオブジェクトのタイプ。返されるオブジェクトの複数のタイプを指定するために複数の値をこのパラメータに対して指定できます。このパラメータの各値は、モデルクラスまたはサブタイプの完全修飾名です。
このパラメータを指定しない場合は、フォルダ内に含まれるすべてのオブジェクトが返されます。このパラメータはオプションです。
DIRECTION
返されるオブジェクトが果たすリンククラスの役割。たとえば、usedBy、references、referencedBy があります。有効な値は、TYPE パラメータによって定義されるリンククラスに依存します。このパラメータは必須です。
GROUP_IN
オブジェクトを含んでいるグループを指定します。オブジェクト ID (OBID) 属性を含んでいるグループの要素ごとに、OBID 属性値によって参照されるオブジェクトがベースオブジェクトとして使用されます。
指定しない場合は、OBJECT_REF パラメータを指定する必要があります。OBJECT_REF パラメータを指定しない場合は、このパラメータを指定する必要があります。OBJECT_REF および GROUP_IN パラメータを両方とも指定すると、指示された複数のベースオブジェクトがナビゲーションされます。
GROUP_OUT
結果を含む出力グループの名前。このパラメータが省略されると、出力グループの名前は文字列 "_Output" を Webject 名に追加することで構築されます。このパラメータはオプションです。
OBJECT_REF
コンテンツのリスト元である Windchill オブジェクトの Unique Federation Identifier (UFID)。
このパラメータには複数の値を指定できます。このパラメータは、WHERE および GROUP_IN の代わりに、または WHERE および GROUP_IN と組み合わせて使用できます。WHERE および GROUP_IN のいずれも指定しない場合は、OBJECT_REF を指定する必要があります。それ以外の場合、STAGING_AREA も使用できます。
OUTPUT_TYPE
関連付けられたオブジェクトまたはリンクオブジェクトを返すかどうかを指定します。リンクオブジェクトは 2 つのオブジェクト間の関連を定義するオブジェクトです。このパラメータの有効な値は以下のとおりです。
• OTHER_SIDE - TYPE、WHERE、または OBJECT_REF で指定されたオブジェクトが関連するオブジェクトを返します。
• RELATION - リンクオブジェクト自体を返します。
• FULL - 各関連を定義するリンクオブジェクトからの属性と結合され、指定されたオブジェクトが関連付けられているオブジェクトを返します。リンクオブジェクトから取得された各属性の名前は、リンクオブジェクトのクラス名とリンクオブジェクトからの属性名を以下のフォーマットで連結して設定されます。
wt.part.WTPartUsageLink.quantity.amount
◦ wt.part.WTPartUsageLink はリンクオブジェクトのクラスです。
◦ quantity.amount はリンクオブジェクトの属性名です。
このパラメータのデフォルトは OTHER_SIDE です。このパラメータはオプションです。
SELECTBY
指定されたリンクのタイプによって参照されているオブジェクトが製品構造 (バージョンが設定されたオブジェクト) である場合の Windchill のコンフィギュレーション仕様。このパラメータの有効な値は以下のとおりです。
• LATEST - オブジェクトの最新バージョンを返します。
• USER - 呼び出しを行うユーザーに対して定義されたデフォルトのコンフィギュレーション仕様によって選択されたオブジェクトを返します。呼び出しを行うユーザーがデフォルトのコンフィギュレーション仕様を持っていない場合、LATEST が使用されます。
• BASELINE - 特定のベースラインに関連付けられたオブジェクトを返します。適用するベースラインを識別するには、SELECTBY_BASELINE_REF パラメータも指定されている必要があります。
• VIEW -特定のビューと関連付けられているオブジェクトを返します。適用するビューを識別するには、SELECTBY_VIEW_REF パラメータも指定されている必要があります。
• LIFECYCLE - 特定のライフサイクルの状態に関連付けられたオブジェクトを返します。適用するライフサイクル状態を識別するには、SELECTBY_LIFECYCLE_STATE パラメータも指定されている必要があります。
• IN_USE - 使用されているオブジェクトを返します。
• EFFECTIVITY - 特定のエフェクティビティと関連付けられているオブジェクトを返します。適用するエフェクティビティ制約を定義するには、SELECTBY_CONFIG_ITEM_REF、SELECTBY_DATE、および SELECTBY_UNIT パラメータも指定する必要があります。
• STANDARD - 標準コンフィギュレーション仕様に関連付けられているオブジェクトを返します。適用する制約を識別するには、SELECTBY_VIEW_REF、SELECTBY_LIFECYCLE_STATE、および SELECTBY_INCLUDE_WORKING パラメータも指定できます。
• STANDARD_DOCUMENT - 標準コンフィギュレーション仕様に関連付けられているオブジェクトを選択します。適用する制約を識別するには、SELECTBY_LIFECYCLE_STATE、SELECTBY_INCLUDE_WORKING、および SELECTBY_IN_USE_BY_USER パラメータも指定できます。
• CONFIGSPEC_REF - 設定および永続化されている ConfigSpec オブジェクトに基づいてオブジェクトを選択します。SELECTBY_CONFIGSPEC_REF パラメータも指定する必要があります。
• CONFIGSPEC_OBJECT - カスタム ConfigSpec オブジェクトをプログラムによって構築し、Webject に渡して、フィルタリング時に使用できるようにします。CONFIGSPEC_OBJECT_META パラメータも指定できます。SELECTBY 値を使用するには、ナビゲーションのシードのために GROUP_IN を指定し、ConfigSpec オブジェクトをメタデータとして GROUP_IN オブジェクトに保存しておく必要があります。
このパラメータのデフォルトは LATEST です。AUTO_NAVIGATE が FALSE に設定されている場合、このパラメータは無視されます。
SELECTBY_BASELINE_REF
SELECTBY が BASELINE として指定されている場合に使用されるベースラインオブジェクトの UFID。
SELECTBY_CONFIG_ITEM_REF
SELECTBY が EFFECTIVITY として指定されている場合に使用されるコンフィギュレーションアイテムの UFID。このパラメータが指定されている場合、SELECTBY_DATE または SELECTBY_UNIT のどちらかが指定されている必要があります。
SELECTBY_CONFIGSPEC_REF
オブジェクトのフィルタリングで使用する、永続化された ConfigSpec オブジェクトへの参照。
SELECTBY_DATE
SELECTBY が EFFECTIVITY として指定されている場合に使用される日付。このパラメータは単独で使用するか、または SELECTBY_CONFIG_ITEM_REF とともに使用することができます。
SELECTBY_IN_USE_BY_USER
ユーザーが使用中のオブジェクトのみを選択するかどうかを指定します。このパラメータはブール型です。SELECTBY=STANDARD_DOCUMENT のみで使用されます。指定しない場合は、オブジェクトを選択するときの基準として、使用中かどうかが使用されません。
SELECTBY_INCLUDE_WORKING
SELECTBY が STANDARD に指定されている場合に作業オブジェクトを含むかどうかを指定します。作業オブジェクトとは、ユーザーのパーソナルキャビネットにあるオブジェクトです。このパラメータに有効な値は TRUE および FALSE です。このパラメータのデフォルトは TRUE です。
SELECTBY_LIFECYCLE_STATE
SELECTBY が LIFECYCLE または STANDARD として指定されている場合に使用されるライフサイクル状態の名前。
SELECTBY_UNIT
SELECTBY が EFFECTIVITY として指定されている場合に使用される単位の値。このパラメータが指定されている場合、SELECTBY_CONFIG_ITEM_REF も指定される必要があります。
SELECTBY_VIEW_REF
SELECTBY が VIEW または STANDARD として指定されている場合に使用される、ビューオブジェクトの UFID。
TYPE
照会するオブジェクトの通知可能な Windchill タイプの名前を指定します。WHERE を指定した場合、TYPE も指定される必要があります。OBJECT_REF はこのパラメータの代わり、または追加として指定できます。
OBJECT_REF はこのパラメータの代わり、または追加として指定できます。このパラメータは必須です。
