Apply-Service

Apply-Service Webject は、Windchill サービスを呼び出します。この Webject は、ヘルパークラスまたはサービスメソッドに、Webject への入力項目として指定されるオブジェクトの属性からのパラメータ値を提供するメカニズムを提供します。TYPE と WHERE、OBJECT_REF、および GROUP_IN パラメータは入力オブジェクトを指定します。

これらのパラメータは任意に組み合わせることができますが、Windchill サービスを適用する入力オブジェクトを Webject が 1 つ持つように、TYPE と WHERE、OBJECT_REF、または GROUP_IN の少なくとも 1 つが指定されている必要があります。

ARG パラメータを指定しない場合、TYPE と WHERE、OBJECT_REF、および GROUP_IN パラメータは必要ありません。Webject は指定された Windchill サービスを各オブジェクトに適用しながら提供されたすべての入力オブジェクトに作業版数を適用します。Webject によって返された出力グループには、累積結果が含まれます。

<ie:webject name="Apply-Service" type="ACT">
<ie:param name="ACCEPT_LANGUAGE"
data="$(@SERVER[]accept_language[])"/>
<ie:param name="ARG" data="argument"/>
<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="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="METHOD" data="method_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_EXCEPTIONS" data="[TRUE | FALSE]"/>
<ie:param name="SERVICE" data="service_name"/>
<ie:param name="SESSION_ID" data="$(session[]session_id[])"/>
<ie:param name="STATIC" data="[TRUE | FALSE]"/>
<ie:param name="TRANSACTION" data="[TRUE | FALSE]"/>
<ie:param name="TYPE" data="type_name"/>
<ie:param name="UNFORMATED" data="dataType" />
<ie:param name="WHERE" data="where_clause"/>
<ie:param name="WHERE_CASE_SENSITIVITY" data="[TRUE | FALSE]"/>
</ie:webject>

必須	相互依存	オプション
INSTANCE	ARG	ACCEPT_LANGUAGE
GROUP_OUT	AUTHORIZATION	ATTRIBUTE
METHOD	CONTAINER_REF	CONNECTION_ATTEMPTS
SERVICE	DBUSER	CONNECTION_ATTEMPT_INTERVAL
	DESCRIPTOR	FORMAT
	GROUP_FILTER	SESSION_ID
	GROUP_IN	STATIC
	INCLUDE_ARGS	TRANSACTION
	INCLUDE_CONSTRAINTS	UNFORMATTED
	INCLUDE_DESCRIPTORS
	NEXT_OP
	OBJECT_REF
	PASSWD
	REFERENCE_EXCEPTIONS
	TYPE
	WHERE
	WHERE_CASE_SENSITIVITY

METHOD パラメータによって名付けられたメソッドの引数。メソッドによって要求されるすべての引数を提供するために、このパラメータに対しては複数の値が指定できます。指定される値の順番と番号は、サービスメソッドによって要求されている順番と番号に一致する必要があります。

たとえば、サービスメソッドが wt.part.WTPart、java.lang.String、および int という 3 つのタイプの引数を要求している場合、Webject は 3 つの ARG パラメータを持つ必要があります。これらのパラメータを、サービスメソッドの正式な引数と同じ順番で指定する必要があります。

いずれの場合にも、type は wt.fc.Persistable のサブクラスであるクラス名を指定し、Webject は name-or-value がオブジェクトの UFID を指定すると解釈します。Webject は自動的にオブジェクトを取得し、その引数の値としてオブジェクトをサービスメソッドに渡します。

<ie:param name="ARG" data="wt.part.WTPart=obid"/>

<ie:param name="ARG" data="wt.doc.WTDocumentMaster=masterReference"/>

サービスメソッドによって生じた結果を含む出力グループの名前。サービスメソッドがビジネスオブジェクト (wt.fc.Persistable のサブクラスであるオブジェクト) を返す場合、出力グループの各要素はオブジェクトの通常の製品表現になります。

入力オブジェクトに追加するメソッドの名前。これにはヘルパークラスがアクセスを提供するサービスメソッド名か、ヘルパークラス自体で定義された静的なメソッドの名前を指定できます。呼び出すメソッドが静的なメソッドであっても、インスタンス化されるクラスには引数のないコンストラクタが存在する必要があります。これは必須のパラメータです。

このパラメータが FALSE に指定されている場合、データベーストランザクション内のコンテキストでメソッドは呼び出されません。このパラメータが TRUE に指定されている場合、メソッドはデータベーストランザクションのコンテキスト内で呼び出され、メソッドがすべての指定された入力オブジェクトに確実に呼び出しできない場合に、変更が自動的にロールバックされます。

METHOD パラメータによって指定されたメソッドがデータベース内の情報を作成または更新し、複数の入力オブジェクトが指定されている場合、このパラメータを TRUE として指定してください。これによって、メソッドが 1 つまたは複数の入力オブジェクトに確実に呼び出しできない場合にデータベースが変更されないようになります。