高度なカスタマイズ > Windchill アダプタ > Windchill アダプタ Webject ライブラリ > Action Webject > Create-Links
  
Create-Links
Create-Links Webject は、Windchill オブジェクト間の新規の関連付けを作成します。関連付けは、指定した属性値で作成され、Windchill データベースに保存されます。
1 つのオブジェクトを作成する際、この Webject は通常 FROM_OBJECT_REF および TO_OBJECT_REF パラメータで呼び出されます。複数のオブジェクトを作成する際、この Webject は通常 GROUP_IN パラメータで呼び出されます。
すべてのオブジェクトはトランザクション内で作成されます。オブジェクト作成が失敗すると、オブジェクトは作成されません。
構文
<ie:webject name="Create-Links" type="ACT">
<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="CONNECTION_ATTEMPTS" data="attempts"/>
<ie:param name="CONNECTION_ATTEMPT_INTERVAL" data="interval"/>
<ie:param name="DBUSER" data="username"/>
<ie:param name="DESCRIPTOR" data="attribute_name"/>
<ie:param name="FIELD" data="name=value"/>
<ie:param name="FORMAT" data="[TRUE | FALSE]"/>
<ie:param name="FROM_OBJECT_REF" data="ufid"/>
<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_DELIMITER" data="^" />
<ie:param name="REFERENCE_EXCEPTIONS" data="[TRUE | FALSE]"/>
<ie:param name="REFERENCE_OUTPUT_DELIMITER" data="^" />
<ie:param name="SESSION_ID" data="$(session[]session_id[])"/>
<ie:param name="TO_OBJECT_REF" data="ufid"/>
<ie:param name="TYPE" data="type_name"/>
<ie:param name="UNFORMATTED" data="dataType" />
</ie:webject>
パラメータ
必須
相互依存
オプション
FROM_OBJECT_REF
AUTHORIZATION
ACCEPT_LANGUAGE
INSTANCE
DBUSER
ATTRIBUTE
TYPE
GROUP_IN
CONNECTION_ATTEMPTS
INCLUDE_ARGS
CONNECTION_ATTEMPT_INTERVAL
INCLUDE_CONSTRAINTS
FIELD
INCLUDE_DESCRIPTORS
FORMAT
NEXT_OP
GROUP_OUT
PASSWD
REFERENCE_DELIMITER
REFERENCE_EXCEPTIONS
REFERENCE_OUTPUT_DELIMITER
TO_OBJECT_REF
SESSION_ID
UNFORMATTED
* 
表に記載されているパラメータの定義が以下にない場合、そのパラメータは共通の定義を持っています。これらのパラメータの説明については、アダプタ Webject の概要の「一般 Webject パラメータ」セクションを参照してください。
FIELD
リクエストされた操作に含める属性および関連値。属性と関連値は、等号で区切られます。以下に例を示します。
<ie:param name="FIELD" data="source=wt.part.Source.make"/>
属性と値は、実行されるオブジェクトおよび操作に依存します。このパラメータはオプションです。このパラメータには複数の値を指定できます。
FROM_OBJECT_REF
関連付けのプライマリオブジェクト (役割 A) として動作する既存のオブジェクトの Unique Federation Identifier (UFID)。オブジェクトの作業コピーが指定されている必要があります。また、そのオブジェクトはすでにチェックアウトされている必要があります。このパラメータは必須です。
GROUP_IN
オブジェクトを含んでいるグループを指定します。オブジェクト ID (OBID) 属性を持つグループの各要素に新規の関連付けが作成されます。
関連付けのプライマリオブジェクトは、FROM_OBJECT_REF によって指定されるオブジェクトです。
GROUP_IN によって指定されるグループの各要素の OBID 属性値によって指定されるオブジェクトは、セカンダリオブジェクトです。
このため、FROM_OBJECT_REF によって指定されるオブジェクトと GROUP_IN の各オブジェクト間に関連付けが作成されます。
このパラメータを指定しない場合は、TO_OBJECT_REF パラメータを指定する必要があります。
GROUP_OUT
結果を含む出力グループの名前。このパラメータが省略されると、出力グループの名前は文字列 "_Output" を Webject 名に追加することで構築されます。このパラメータはオプションです。
TO_OBJECT_REF
関連付けのほかのオブジェクトとして動作する既存のオブジェクトの UFID を指定します。
各関連付けのプライマリオブジェクトは、FROM_OBJECT_REF の値によって指定されるオブジェクトです。FROM_OBJECT_REF によって指定されるオブジェクトと TO_OBJECT_REF 値によって指定される各オブジェクト間に関連付けが作成されます。
このパラメータを指定しない場合は、GROUP_IN パラメータを指定する必要があります。
このパラメータには複数の値を指定できます。
プライマリオブジェクト以外の UFID によって、オブジェクトが事実上ローカル Windchill システムではなくリモート情報システムにあることが示される場合、関連付けは FederatedLink オブジェクトを使用して作成されます。また、必要に応じて LightweightProxy オブジェクトも作成され、リモートオブジェクトへのローカル参照として動作します。LightweightProxy オブジェクトは関連付けのプライマリ以外の役割として登録されます。
TYPE
作成するリンクのタイプを指定します。このパラメータは必須です。