組織ピッカーの設定
目的
問題: 組織ピッカーをカスタム UI に追加し、ピッカーを以下のように設定する必要があります。
• 特定のタイプのオブジェクトのみをサーチする
• 特定のコンテナ内のオブジェクトのみをサーチする
• 特定のサーチ基準入力フィールドを表示する
• サーチ結果テーブルで特定のオブジェクトの属性を表示する
バックグラウンド
組織ピッカーは、特定の基準に応じて異なる組織を選択し、それをアプリケーションで使用するという要件がある場合に使用されます。通常の使用としては、特定の組織で利用可能な部品を検索する場合です。この場合、組織ピッカーを使用して組織を選択し、サーチ基準に渡して部品のサーチを実行します。
範囲/適用可能性/前提条件
タグを配置する <マイページ>.jsp ファイルには、"/netmarkets/jsp/begin.jspf" または "/netmarkets/jsp/beginPopuf.jspf" ファイルと "/netmarkets/jsp/end.jspf" ファイルが含まれると仮定します。
予測される結果
組織ピッカーのタグを使用すると、指定したラベルとともにテキストボックスおよび「検索」ボタンが表示されます。「検索...」ボタンをクリックすると組織ピッカーが起動します。
「検索...」ボタンをクリックすると、組織ピッカーが表示されます。
ソリューション
JSP ファイルの組織ピッカー共通コンポーネントを使用して、アプリケーションに組織ピッカーを含めます。
前提となる知識
この目的を達成するには、次のことを理解している必要があります。
• JSP、JavaScript、カスタム taglibs に関連した基本的な開発
• リソースバンドルファイルカスタマイズの管理
• Windchill xconfmanager の概念
ソリューションエレメント
エレメント | タイプ | 説明 |
|---|---|---|
PickerAttributes.xml | XML | pickerAttributes.xml XML ファイル。このファイルを使用して、ピッカーのオブジェクトタイプ用の検索基準属性をカスタマイズします。 ランタイム場所: <Windchill>\codebase\pickerAttributes.xml |
searchClientResource.java | リソースバンドルファイル | このファイルを使用して、ピッカーのコンテンツをローカライズします。 |
organizationPicker.tag | カスタム JSP タグファイル | このファイルには、このタグでサポートされるパラメータの詳細が含まれています。 ランタイム場所: <Windchill>\codebase\WEB-INF\tags\ContextPicker.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 ページに組織ピッカーを含める
組織ピッカーは organizationPicker タグを呼び出すことで JSP から起動できます。
<tr>
<wctags:organizationPicker id="organizationPickerId" />
</tr>
<wctags:organizationPicker id="organizationPickerId" />
</tr>
カスタマイズポイント
パラメータ | デフォルト値 | 有効な値 | 必須 | 説明 |
|---|---|---|---|---|
Id | ページで一意のもの | False | ID は、呼び出しアプリケーションのすべてのピッカーに関連付けられています。異なるタイプであるか同じタイプであるかにかかわらず、この ID はすべてのピッカーに対し 1 ページ内で一意である必要があります。ID の名前に "." (ドット) を含めることはできません。 | |
componentId | pickerSearch | pickerAttributes.xml で指定された任意の有効なコンポーネント ID | いいえ | componentId は、特定ピッカーのサーチ基準パネルに表示される属性を決定します。 |
pickerCallback | ユーザーがこのパラメータを指定しなかった場合、実行時に生成されます。 | コールバック関数の名前 | いいえ | ユーザーが実装する必要のあるカスタマイズされたコールバック関数の名前。custom.js ファイルで pickerCallback 関数を指定することを強くお勧めします。 |
defaultValue | "" (空白) | 任意の値 | いいえ | ピッカーによってレンダリングされたテキストボックスのデフォルト値。 |
defaultHiddenValue | "" (空白) | 任意の値 | いいえ | ピッカーに関連付けられた非表示テキストボックスのデフォルト値。 |
Label | コンテキストピッカー | 任意の値 | いいえ | ピッカーのラベル。 |
displayAttribute | 名前 | 任意の属性 | いいえ | 組織ピッカーから結果を選択した後、ピッカーテキストボックスに表示される属性の名前。 |
containerRef | "" (空白) | 任意のコンテナ | いいえ | ユーザーがサーチを制限する containerRef の値。 |
baseWhereClause | "" (空白) | 任意の有効な I*E where 句照会 | いいえ | ユーザー入力に関係なく特定の基準でサーチ結果をフィルタする場合の追加の where 句。この where 句は、内部 where 句を持つ "ANDed" を取得するだけです。 |
pickerTitle | コンテキスト | 任意の値 | いいえ | ピッカーのタイトル。 |
pickedDataFetcher | <WebApp>/netmarkets/jsp/search/pickedData.jsp | フェッチャファイルの URL 場所 | いいえ | 選択した結果を処理するために AJAX 呼び出しによって使用されるデータフェッチャファイルの URL。 |
Editable | True | true/false | いいえ | この属性は、テキストボックスに「検索」アイコンを含めるかどうかを定義します。 |
readOnlyPickerTextBox | False | true/false | いいえ | この属性は、ピッカーテキストボックスを編集可能にするかどうかを定義します。 |
Inline | False | true/false | いいえ | テーブルレベルの操作またはインラインでピッカーを起動する場合、このパラメータの値を true に指定する必要があります。 |
pickedAttributes | 名前 | 有効な属性の任意のコンマ区切りリスト | いいえ | このパラメータは、ピッカーが取得する属性のコンマ区切りリストを含んでいます。インラインが "true" の場合にのみ適用されます。 |
pickerType | サーチ | search/picker | いいえ | このパラメータは、ピッカータイプを "search" ピッカーまたは "picker" ピッカーに定義します。search ピッカーでは、ピッカーにサーチ基準が表示されたら、「サーチ」ボタンをクリックして結果を確認する必要があります。ただし、"picker" ピッカーの場合は、サーチ基準なしでも結果テーブルが直接表示されます。 |
pickerTextBoxLength | 25 | 任意の数値 | いいえ | このパラメータは、ピッカーテキストボックスの長さを定義します。 |
searchResultsViewId | "" (空白) | 任意の有効なビュー ID | いいえ | このパラメータを使用すると、ピッカーサーチ結果テーブルのカスタムビュー ID を定義できます。 |
extraSuggestAttributes | emaild | ユーザーがサーチする任意のフィールド | False | このパラメータは、自動候補表示に使用する追加の属性を指定するのに利用します。 |
showSuggestion | false | True/false | False | このプロパティが true になっている場合、コンテキストピッカーに使用した最近の複数の選択が表示されます。この場合、callback 関数および onchange 関数の修正が必要です。デフォルト値は false です。サーチページのみに実行されます。このプロパティは、ピッカーの自動候補表示を可能にするために使用されます。 |
suggesMinChars | 1 | 整数値 | False | このパラメータを使用して、最小文字を決定します。自動候補表示が有効になっている場合は、この文字を基準にして、自動候補表示が開始します。 |
suggestServiceKey | ピッカー特有 | userPicker, partPicker など。 | False | クエリーサービスを呼び出す候補のクラスを選択するキー (例: ContextServicePickerSuggestable)。search-service.properties.xconf ファイル内にキーが存在する必要があります。 |
結果テーブルでの複数選択オプションを持つ組織ピッカーの設定
<wctags:organizationPicker id="orgPickerId" multiSelect="true" />
組織ピッカーの baseWhereClause の設定
<wctags:organizationPicker id="orgPickerId"
baseWhereClause="(name=’myOrg*’)" />
baseWhereClause="(name=’myOrg*’)" />
組織ピッカーの pickerCallback 関数の設定
<wctags:organizationPicker id="orgPickerId"
pickerCallback="myPickerCallback" />
myPickerCallback function can be like:
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;
}
}
pickerCallback="myPickerCallback" />
myPickerCallback function can be like:
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;
}
}