アイテムピッカーの設定
目的
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>
<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" />
Foundation.myPickerComponentId" />
アイテムピッカーの baseWhereClause の設定
<wctags:itemPicker id="itemPicker"
baseWhereClause="(name=’demo*’)" />
baseWhereClause="(name=’demo*’)" />
アイテムピッカーの pickerCallback 関数の設定
<wctags:itemPicker id="itemPicker"
pickerCallback="myPickerCallback" />
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;
}
}
{
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;
}
}