基本的なカスタマイズ > ユーザーインタフェースのカスタマイズ > JSP クライアントへのピッカーの組み込み > アイテムピッカーの設定
  
アイテムピッカーの設定
目的
Windchill ビジネスオブジェクトのインスタンスを取得します。
バックグラウンド
アイテムピッカーは、特定の基準に応じて異なるビジネスオブジェクトを選択し、それをアプリケーションで使用するという要件がある場合に使用されます。
範囲/適用可能性/前提条件
タグを配置する <マイページ>.jsp ファイルには、"/netmarkets/jsp/begin.jspf" または "/netmarkets/jsp/beginPopuf.jspf" ファイルと "/netmarkets/jsp/end.jspf" ファイルが含まれると仮定します。
予測される結果
アイテムピッカーのタグを使用すると、指定したラベルとともにテキストボックスおよび「検索」ボタンが表示されます。「検索」ボタンをクリックするとアイテムピッカーが起動します。
「検索」ボタンをクリックすると、以下のようにアイテムピッカーが表示されます。
ソリューション
JSP ファイルのアイテムピッカー共通コンポーネントを使用して、アプリケーションにアイテムピッカーを含めます。
前提となる知識
この目的を達成するには、次のことを理解している必要があります。
JSP、JavaScript、カスタム taglibs に関連した基本的な開発
リソースバンドルファイルカスタマイズの管理
Windchill xconfmanager の概念
ソリューションエレメント
エレメント
タイプ
説明
pickerAttributes.xml
XML ファイル
このファイルを使用して、ピッカーのオブジェクトタイプ用の検索基準属性をカスタマイズします。
ランタイム場所: <Windchill>\codebase\pickerAttributes.xml
searchClientResource.java
リソースバンドルファイル
このファイルを使用して、ピッカーのコンテンツをローカライズします。
itemPicker.tag
カスタム JSP タグファイル
このファイルには、このタグでサポートされるパラメータの詳細が含まれています。
ランタイム場所: <Windchill>\codebase\WEB-INF\tags\itemPicker.tag
SearchableTypes.properties.xconf
xconf Properties ファイル
このファイルでコンポーネント ID および対応するオブジェクトタイプを指定し、xconfmanager を実行する必要があります。
ランタイム場所: <Windchill>\codebase\com\ptc\windchill\enterprise\search\server\SearchableTypes.properties.xconf
custom.js
JavaScript ファイル
このファイルのピッカー用にカスタム pickerCallback 関数を指定する必要があります。
ランタイム場所: <Windchill>\codebase\netmarkets\jsp\search\custom.js
* 
アイテムピッカーのタイプピッカーを無効化します。
手順 - jsp ページにアイテムピッカーを含める
基本アイテムピッカーを設定します。
<tr>
<wctags:itemPicker id="itemPickerId" />
</tr>
カスタマイズポイント
パラメータ
デフォルト値
有効な値
必須
説明
ID
ページで一意の ID
はい
ID は、呼び出しアプリケーションのすべてのピッカーに関連付けられています。異なるタイプであるか同じタイプであるかにかかわらず、この ID はすべてのピッカーに対し 1 ページ内で一意である必要があります。ID の名前に "." (ドット) を含めることはできません。
componentId
pickerSearch
pickerAttributes.xml で指定された任意の有効なコンポーネント ID
いいえ
componentId は、特定ピッカーのサーチ基準パネルに表示される属性を決定します。
pickerCallback
ユーザーがこのパラメータを指定しなかった場合、実行時に生成されます。
コールバック関数の名前
いいえ
ユーザーが実装する必要のあるカスタマイズされたコールバック関数の名前。custom.js ファイルで pickerCallback 関数を指定することをお勧めします。
defaultValue
"" (空白)
任意の値
いいえ
ピッカーによってレンダリングされたテキストボックスのデフォルト値。
defaultHiddenValue
"" (空白)
任意の値
いいえ
ピッカーに関連付けられた非表示テキストボックスのデフォルト値。
ラベル
アイテムピッカー
任意の値
いいえ
ピッカーのラベル。
displayAttribute
名前
任意の属性
いいえ
アイテムピッカーから結果を選択した後、ピッカーテキストボックスに表示される属性の名前。
containerRef
"" (空白)
任意のコンテナ
いいえ
ユーザーがサーチを制限する containerRef の値。
baseWhereClause
"" (空白)
任意の有効な I*E where 句照会
いいえ
ユーザー入力に関係なく特定の基準でサーチ結果をフィルタする場合の追加の where 句。この where 句は、内部 where 句を持つ "ANDed" を取得するだけです。
pickerTitle
アイテム
任意の値
いいえ
ピッカーのタイトル。
pickedDataFetcher
<Web アプリケーション>/netmarkets/jsp/search/pickedData.jsp
フェッチャファイルの URL 場所
いいえ
選択した結果を処理するために AJAX 呼び出しによって使用されるデータフェッチャファイルの URL。
Editable
True
true/false
いいえ
この属性は、テキストボックスに「検索」アイコンを含めるかどうかを定義します。
readOnlyPickerTextBox
False
true/false
いいえ
この属性は、ピッカーテキストボックスを編集可能にするかどうかを定義します。
typeComponentId
Foundation.contextPicker
SearchableTypes.properties ファイルで指定された任意の有効な componentId。
いいえ
このパラメータは、タイプピッカーに表示される一連のタイプを定義するために渡されます。
Inline
False
true/false
いいえ
テーブルレベルの操作またはインラインでピッカーを起動する場合、このパラメータの値を true に指定する必要があります。
pickedAttributes
名前
有効な属性の任意のコンマ区切りリスト
いいえ
このパラメータは、ピッカーが取得する属性のコンマ区切りリストを含んでいます。インラインが "true" の場合にのみ適用されます。
showTypePicker
True
true/false
いいえ
このパラメータは、ピッカーでタイプピッカーを有効にするために使用する必要があります。
pickerType
サーチ
search/picker
いいえ
このパラメータは、ピッカータイプを "search" ピッカーまたは "picker" ピッカーに定義します。search ピッカーでは、ピッカーにサーチ基準が表示されたら、「サーチ」ボタンをクリックして結果を確認する必要があります。ただし、"picker" ピッカーの場合は、サーチ基準なしでも結果テーブルが直接表示されます。
pickerTextBoxLength
25
任意の数値
いいえ
このパラメータは、ピッカーテキストボックスの長さを定義します。
searchResultsViewId
"" (空白)
任意の有効なビュー ID
いいえ
このパラメータを使用すると、ピッカーサーチ結果テーブルのカスタムビュー ID を定義できます。
customAccessController
"" (空白)
任意の有効な名前
いいえ
このパラメータは、ユーザー独自のカスタムアクセスコントローラを定義するために使用されます。このパラメータは、完全なクラス名を値として受け入れます。複数の customAccessController を指定するには、コンマ (,) で区切られたクラス名のリストを渡します。
objectType
wt.fc.Persistable
wt.part.WTPart
いいえ
デフォルトのオブジェクトタイプとして表示されるオブジェクトタイプの名前
excludeSubTypes
"" (空白)
任意の有効なサブタイプ
いいえ
このパラメータは、サーチからサブタイプを排除するために使用されます。
types from the search.
defaultIterationValue
すべて
すべて
いいえ
設定する必要がある作業版数フィールドの値。デフォルト値は ALL です
defaultVersionValue
すべて
すべて
いいえ
設定する必要があるリビジョンフィールドの値。デフォルト値は ALL です
typePickerFormat
いいえ
タイプピッカーのフォーマット。値は *dropdown*、*table*、*tree* のいずれかです。
singleSelectTypePicker
いいえ
このパラメータは、単一選択または複数選択のタイプピッカーの設定に使用されます。
typePickerObjectList
いいえ
このパラメータは、タイプピッカー内の特定のリレーションに基づいてオブジェクトタイプのリストを設定するときに使用します。
typePickerDefaultType
いいえ
このパラメータは、タイプピッカーでデフォルトで選択されるタイプを設定するときに使用します。
typePickerSubTypeDisplay
いいえ
このパラメータは、サブタイプの表示/非表示に使用します。可能な値は ROOT_TYPES (seedTypes のみを表示)、SOFT_TYPES (ソフトタイプのみを表示)、BOTH (モデル化されたタイプとソフトタイプを表示) です。
typePickerShowRoot
いいえ
このパラメータは、I レベルのエレメントとして seedTypes を表示するときに使用します。
showAllObjectTypes
いいえ
このパラメータは、タイプピッカーで適用可能なすべてのオブジェクトタイプを表示するときに使用します。
excludeRef
サーチから除外するオブジェクト参照のコンマ区切りリスト
いいえ
このパラメータは、サーチ結果から除外するオブジェクト参照のコンマ区切りリストを指定するときに使用します。
タイプピッカーなしのアイテムピッカーの設定
<wctags:itemPicker id="itemPicker" showTypePicker="false"/>
デフォルトのオブジェクトタイプを持つアイテムピッカーの設定
<wctags:itemPicker id="itemPicker" objectType="wt.part.WTPart" />
結果テーブルでの複数選択オプションを持つアイテムピッカーの設定
<wctags:itemPicker id="itemPicker" multiSelect="true" />
タイプピッカーでの独自の typeComponentId を持つアイテムピッカーの設定
<wctags:itemPicker id="itemPicker" typeComponentId="
Foundation.myPickerComponentId" />
アイテムピッカーの baseWhereClause の設定
<wctags:itemPicker id="itemPicker"
baseWhereClause="(name=’demo*’)" />
アイテムピッカーの pickerCallback 関数の設定
<wctags:itemPicker id="itemPicker"
pickerCallback="myPickerCallback" />
myPickerCallback 関数は次のようになります。
function myPickerCallback(objects, pickerID)
{
var updateHiddenField = document.getElementById(pickerID);
var updateDisplayField = document.getElementById(pickerID +
"$label$");
var myJSONObjects = objects.pickedObject;
for(var i=0; i< myJSONObjects.length;i++) {
var oid = myJSONObjects[i].oid;
// Here “name” is the displayAttribute requested
var displayAttr = eval("myJSONObjects[i].name");
updateHiddenField.value=oid;
updateDisplayField.value=displayAttr;
}
}