高度なカスタマイズ > Windchill アダプタ > Windchill アダプタ Webject ライブラリ > アダプタ Webject の概要 > 一般 Webject パラメータ
  
一般 Webject パラメータ
以下のパラメータは複数の Webject に適用され、共通の定義を持っています。
共通パラメータが適用されるかどうかを確認するには、各 Webject エントリの「パラメータ」セクションの表を参照してください。
* 
Webject 間で共通する追加パラメータもいくつかありますが、Webject がそのパラメータをどのように使用するかによって定義が異なります。次に、ユニバーサル定義を持つパラメータについてのみ説明します。
ACCEPT_LANGUAGE
Windchill 属性値およびメッセージの言語プリファレンスおよびロケール。この値を使用して、ロケール固有の入出力を処理するときに使用する適切な java.util.Locale を決定します。ACCEPT_LANGUAGE は、呼び出し元が Info*Engine の自動ロケール検出をオーバーライドするときに使用できます。
ロケール固有の値は、言語プリファレンスに対応するロケールを使用して解析され、フォーマットされます。フォーマットは LN-CC-ds です。
"LN" は ISO およびインターネット規格で定義されている 2 文字の言語識別子です (英語は en、フランス語は fr、ドイツ語は de など)。
"CC" は ISO およびインターネット規格で定義されている 2 文字の国コードです (アメリカ合衆国は US、フランスは FR、ドイツは DE、ドイツは DE など)。
"ds" は地域で定義されている方言識別子です。
CC および ds コンポーネントは省略する場合があります。一般的に、CC コンポーネントは指定し、方言文字列は省略します。一般的な例は、en-US、en-GB、fr-FR、de-DE、de-CH (ドイツ語/スイス)、it-IT (イタリア語) などです。
このパラメータはオプションです。
このパラメータはすべての Webject に適用されるわけではありません。各 Webject の説明の「パラメータ」表を参照してください。
ATTRIBUTE
オブジェクトごとに出力グループに返される属性。このパラメータには複数の値を指定できます。このパラメータが指定されていない場合は、デフォルトの属性セットが返されます。
各タイプの属性のデフォルトセットは wt.adapter.delegates.properties ファイルの DefaultAttributes プロパティ値で定義されています。
DefaultAttributes プロパティが定義されていない場合は、すべてのオブジェクトのすべての属性が返されます。このパラメータはオプションです。
このパラメータはすべての Webject に適用されるわけではありません。各 Webject の説明の「パラメータ」表を参照してください。
* 
ATTRIBUTE パラメータは、次の Webject に対して固有の定義を持っています。
AUTHORIZATION
有効な HTTP 認証ヘッダー値。HTTP Basic 認証のみがサポートされます。指定すると、このパラメータはユーザー名とパスワードのソースとして動作し、Webject の実行と関連付けられ、DBUSER と PASSWD は無視されます。AUTHORIZATION、DBUSER、および PASSWD パラメータで資格証明を指定しない場合は、Info*Engine の認証マッピングメカニズムによって、これらのパラメータ値が指定されます。
このパラメータはすべての Webject に適用されます。
* 
標準の Windchill インストールでは、署名を常に要求するよう設定されています。つまり、サーバーは認証のために Web サーバーに提供されたユーザー名を信頼します。このユーザー名は、Windchill にルーティングする Webject 呼び出し時に使用され、DBUSER、PASSWD、および AUTHORIZATION パラメータ値は無視されます。
認証およびユーザー認証の仕様の詳細については、Info*Engine User's Guide を参照してください。
DBUSER
DBUSER Webject は、Windchill システムへの認証時に使用するユーザー名を指定します。このパラメータを適用するには、PASSSWD も指定する必要があります。
AUTHORIZATION が指定されている場合、DBUSER と PASSWD は無視されます。AUTHORIZATION、DBUSER、および PASSWD パラメータで資格証明を指定しない場合は、Info*Engine の認証マッピングメカニズムによって、これらのパラメータ値が指定されます。
このパラメータはすべての Webject に適用されます。
CONNECTION_ATTEMPTS
エラーを返す前にアダプタの接続の確立を試行する最大回数。デフォルト値は 1 です。このパラメータはオプションです。
複数の INSTANCE パラメータ値を指定する場合、CONNECTION_ATTEMPTS の値は、アダプタインスタンスのリストを繰り返す最大数を定義します。
このパラメータはオプションであり、すべての Webject に適用されます。
CONNECTION_ATTEMPT_INTERVAL
Windchill システムへの接続が失敗した場合、接続の試行を繰り返す間の遅延秒数。デフォルト値は 60 秒です。このパラメータはオプションです。
複数の INSTANCE パラメータ値が指定されている場合、CONNECTION_ATTEMPT_INTERVAL の値は、アダプタインスタンスのリスト全体を繰り返す試行間の待機秒数を定義します。
このパラメータはオプションであり、すべての Webject に適用されます。
DESCRIPTOR
Webject が実行する基本コマンドのコマンドフィルタに含む属性名。このパラメータは何度も指定してフィルタに含む複数の属性名を認識させることができます。
これらは、基本コマンドが実行するデータベース照会で返される属性です。ほとんどの場合、この属性セットは ATTRIBUTE パラメータによって認識される属性セットと組み合わせます。ただし、ATTRIBUTE パラメータは Webject の出力グループの各エレメントに返される属性セットも指定します。DESCRIPTOR パラメータは、Webject が実行する Windchill コマンドによってデータベースから選択されたビジネスオブジェクト属性の制御に使用されます。
GROUP_FILTER が指定されている場合、このパラメータは無視されます。
このパラメータはすべての Webject に適用されるわけではありません。各 Webject の説明の「パラメータ」表を参照してください。
FORMAT
オブジェクトごとに出力グループで返される属性をエンドユーザー向けにフォーマットするかどうかを指定します。TRUE を指定すると、各属性は表示値を返すようにフォーマットされます。FALSE を指定すると、各属性の未処理の内部値が返されます。
このパラメータのデフォルトは TRUE です。このパラメータはオプションです。
詳細については、属性変換の委任の定義を参照してください。
このパラメータはオプションです。
このパラメータはすべての Webject に適用されるわけではありません。各 Webject の説明の「パラメータ」表を参照してください。
GROUP_FILTER
コマンドフィルタ (コマンドレイヤー AttributeContainerSpec) を含むグループの名前。
このパラメータを指定すると、参照するグループに 1 つのエレメントのみが含まれており、そのエレメントには command_filter という名前の属性が含まれていると見なされます。属性値は Java クラスの com.ptc.core.meta.container.common.AttributeContainerSpec のインスタンスであると見なされます。
このパラメータを指定すると、DESCRIPTOR、INCLUDE_DESCRIPTORS、INCLUDE_CONSTRAINTS、INCLUDE_ARGS、および NEXT_OP は無視されます。
このパラメータはすべての Webject に適用されるわけではありません。各 Webject の説明の「パラメータ」表を参照してください。
INCLUDE_ARGS
Webject によって実行される基本コマンドが実行結果にデータベースフィルタの属性コンテキスト関数の引数を含めるかどうかを指定します。TRUE または FALSE を指定します。このパラメータのデフォルトは FALSE です。GROUP_FILTER が指定されている場合、このパラメータは無視されます。
このパラメータはすべての Webject に適用されるわけではありません。各 Webject の説明の「パラメータ」表を参照してください。
INCLUDE_CONSTRAINTS
Webject によって実行される基本コマンドが制約情報を適用するかどうかを指定します。TRUE または FALSE を指定します。このパラメータのデフォルトは FALSE です。GROUP_FILTER が指定されている場合、このパラメータは無視されます。
このパラメータはすべての Webject に適用されるわけではありません。各 Webject の説明の「パラメータ」表を参照してください。
INCLUDE_DESCRIPTORS
Webject が実行した基本コマンドを実行結果の DESCRIPTOR パラメータ値に含めるかどうかを指定します。TRUE または FALSE を指定します。このパラメータのデフォルトは FALSE です。GROUP_FILTER が指定されている場合、このパラメータは無視されます。
このパラメータはすべての Webject に適用されるわけではありません。各 Webject の説明の「パラメータ」表を参照してください。
INSTANCE
Windchill アダプタの名前を指定します。Info*Engine の「プロパティ管理」ユーティリティでアダプタを設定するときに、アダプタ名を定義できます。詳細については、INSTANCE パラメータを使用したアダプタの名前の指定を参照してください。
このパラメータはすべての Webject で必須です。
NEXT_OP
Webject によって返されるオブジェクトに適用する次の操作の識別子を指定します。これにより、INCLUDE_CONSTRAINTS が TRUE に指定されている場合に適用される制約を決定します。GROUP_FILTER が指定されている場合、このパラメータは無視されます。
このパラメータはすべての Webject に適用されるわけではありません。各 Webject の説明の「パラメータ」表を参照してください。
PASSWD
Windchill システムへの認証に使用するパスワードを指定します。DBUSER パラメータを指定する場合は、PASSWD パラメータも指定する必要があります。
AUTHORIZATION が指定されている場合、DBUSER と PASSWD は無視されます。AUTHORIZATION、DBUSER、および PASSWD パラメータで資格証明を指定しない場合は、Info*Engine の認証マッピングメカニズムによって、これらのパラメータ値が指定されます。
このパラメータはすべての Webject に適用されます。
* 
標準の Windchill インストールでは、署名を常に要求するよう設定されています。つまり、サーバーは認証のために Web サーバーに提供されたユーザー名を信頼します。このユーザー名は、Windchill にルーティングする Webject 呼び出し時に使用され、DBUSER、PASSWD、および AUTHORIZATION パラメータ値は無視されます。
認証およびユーザー認証の仕様の詳細については、Info*Engine User's Guide を参照してください。
REFERENCE_DELIMITER
属性参照を区切るために使用される区切り記号を指定します。このパラメータはオプションです。
このパラメータはすべての Webject に適用されるわけではありません。各 Webject の説明の「パラメータ」表を参照してください。
REFERENCE_EXCEPTIONS
ユーザーが参照オブジェクトを読み取るためのアクセス許可を持たない場合に、参照をたどり展開する Webject がどのように動作するかを指定します。このパラメータに有効な値は TRUE および FALSE です。
ユーザーが参照されているオブジェクトを読み取るためのアクセス許可を持たない場合は次のようになります。
FORMAT に TRUE が指定され、REFERENCE_EXCEPTIONS に TRUE が指定された場合、アクセス制御例外が発生します。
FORMAT に TRUE が指定され、REFERENCE_EXCEPTIONS に FALSE が指定された場合、「セキュリティ保護されている情報」などの文字列が表示されます。
このパラメータはすべての Webject に適用されるわけではありません。各 Webject の説明の「パラメータ」表を参照してください。
REFERENCE_OUTPUT_DELIMITER
出力の生成時に属性参照を区切るために使用される区切り記号。デフォルト値は REFERENCE_DELIMITER の値です。このパラメータはオプションです。
このパラメータはすべての Webject に適用されるわけではありません。各 Webject の説明の「パラメータ」表を参照してください。
SESSION_ID
Webject を実行するセッションの識別子。
このパラメータはすべての Webject に適用されるわけではありません。各 Webject の説明の「パラメータ」表を参照してください。
このパラメータはほとんどの Webject でオプションですが、次の Webject では必須です。
Commit-Transaction
Rollback-Transaction
End-Session
Start-Transaction
UNFORMATTED
FORMAT=true の場合に未フォーマットのままにする必要があるデータタイプ (たとえば java.sql.Timestamp などの完全修飾 Java クラス名)。このパラメータには複数の値を指定できます。このパラメータはオプションです。
このパラメータはすべての Webject に適用されるわけではありません。各 Webject の説明の「パラメータ」表を参照してください。
WHERE_CASE_SENSITIVITY
サーチが大文字小文字の区別をするかどうかを指定します。このパラメータのデフォルトは FALSE です。つまり、サーチでは大文字と小文字を区別しません。サーチで大文字と小文字を区別するには TRUE を指定します。
このパラメータは WHERE が指定されているときにのみ指定されます。