高度なカスタマイズ > Windchill アダプタ > Windchill アダプタ Webject ライブラリ > Action Webject > Update-Objects
  
Update-Objects
Update-Objects Webject は、Windchill オブジェクトの 1 つ以上の属性値を更新します。
オブジェクトを更新する場合、オブジェクトの作業コピーが指定され、オブジェクトがすでにチェックアウトされている必要があります。オブジェクトが更新できない場合、例外が発生してオブジェクトが更新されます。
OBJECT_REF パラメータおよび 1 つまたは複数の FIELD パラメータを指定することで、個々のオブジェクトを更新します。
FIELD に加えて 1 つ以上の OBJECT_REF または TYPE および WHERE を指定することで、複数のオブジェクトを更新できます。
FIELD の値は、更新するすべてのオブジェクトに適用されます。
FIELD パラメータの値は、GROUP_IN を使用して更新したオブジェクトには適用されません。結果として、GROUP_IN を指定すると、一度に複数のオブジェクトを最も確実に更新することができます。
構文
<ie:webject name="Update-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="MODIFICATION" data="[ADD | REPLACE | DELETE]"/>
<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="SESSION_ID" data="$(session[]session_id[])"/>
<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>
パラメータ
必須
相互依存
オプション
INSTANCE
AUTHORIZATION
ACCEPT_LANGUAGE
CONTAINER_REF
ATTRIBUTE
DBUSER
CONNECTION_ATTEMPTS
DESCRIPTOR
CONNECTION_ATTEMPT_INTERVAL
FIELD
FORMAT
GROUP_FILTER
GROUP_OUT
GROUP_IN
MODIFICATION
INCLUDE_ARGS
REFERENCE_DELIMITER
INCLUDE_CONSTRAINTS
REFERENCE_OUTPUT_DELIMITER
INCLUDE_DESCRIPTORS
SESSION_ID
NEXT_OP
UNFORMATTED
OBJECT_REF
PASSWD
REFERENCE_EXCEPTIONS
TYPE
WHERE
WHERE_CASE_SENSITIVITY
* 
表に記載されているパラメータの定義が以下にない場合、そのパラメータは共通の定義を持っています。これらのパラメータの説明については、アダプタ Webject の概要の「一般 Webject パラメータ」セクションを参照してください。
CONTAINER_REF
Webject を適用する対象となる Windchill コンテキスト。このパラメータは以下のタイプの入力を受け取ります。
Windchill コンテキストの UFID。このパラメータには複数の UFID を指定できます。
MEMBERSHIP - ユーザーがメンバーになっているコンテキストのみが照会されます。
このパラメータを指定した場合、TYPE および WHERE パラメータに対して実行される照会の範囲は、関連付けられたコンテキストに限られます。
FIELD
このパラメータは、リクエストされた操作に含める属性および関連値を指定します。属性と関連値は、等号で区切られます。次に例を示します。
<ie:param name="FIELD" data="source=wt.part.Source.make"/>
属性と値は、実行されるオブジェクトおよび操作に依存します。このパラメータには複数の値を指定できます。
* 
MODIFICATION = DELETE の場合、name=value ペアの value 部分は無視され、指定した属性のすべての値が除去されます。
たとえば、MODIFICATION = DELETE で、FIELD = a = b の場合、"a" は属性で、"b" は値です。値は無視され、属性 "a" のすべての値が除去されるので不要になります。MODIFICATION = DELETE の場合に FIELD パラメータに必要なのは、FIELD = a だけです。
GROUP_IN
更新するオブジェクト。各エレメントの OBID 属性では、更新するオブジェクトを選択します。各要素のその他の属性は選択したオブジェクトで置き換え、または追加される値を指定します。このパラメータは FIELD パラメータの代わり、または追加として指定できます。
FIELD パラメータが指定されると、更新される (TYPE および WHERE または OBJECT_REF で選択された) 単一のオブジェクトの属性がそのパラメータによって定義されますが、GROUP_IN グループの各要素は、更新されるオブジェクトを定義し、複数のオブジェクトを一度に更新できるようになります。
GROUP_OUT
結果を含む出力グループの名前。このパラメータが省略されると、出力グループの名前は文字列 "_Output" を Webject 名に追加することで構築されます。このパラメータはオプションです。
MODIFICATION
属性値が置き換えられるか、削除されるか、追加されるかを指定します。このパラメータには次の値がサポートされています。
REPLACE - FIELD パラメータまたは GROUP_IN パラメータの要素で指定された属性により、更新されるオブジェクトの属性が置き換えられます。
ADD - FIELD パラメータまたは GROUP_IN パラメータの要素で指定された属性が、更新されるオブジェクトの属性に追加されます。指定された属性が値を持っていないか、指定された属性が複数の値を持つことを許可されていない場合にのみ、追加が可能です。
DELETE - FIELD パラメータの name=value ペアの指定した値は無視され、指定した属性のすべての値が除去されます。
たとえば、MODIFICATION = DELETE で、FIELD = a = b の場合、"a" は属性で、"b" は値です。値は無視され、属性 "a" のすべての値が除去されるので不要になります。MODIFICATION = DELETE の場合に FIELD パラメータに必要なのは、FIELD = a だけです。
このパラメータのデフォルトは REPLACE です。このパラメータはオプションです。
TYPE
オブジェクトタイプの名前。WHERE を指定した場合、TYPE も指定する必要があります。詳細については、TYPE および WHERE パラメータの指定を参照してください。
WHERE
照会するオブジェクトを識別する照会定義式。このパラメータは、OBJECT_REF の代わりに、または OBJECT_REF と組み合わせて使用できます。
OBJECT_REF が指定されていない場合、WHERE を指定する必要があります。WHERE を指定した場合、TYPE も指定する必要があります。詳細については、TYPE および WHERE パラメータの指定を参照してください。