アイテムリスト
定義と用法
アイテムリストの再使用可能なコンポーネントは、グリッドビューのデータセットからアイテムのリストを表示できる組み込みマッシュアップです。また、リストのサーチ、並べ替え、フィルタのほか、リスト全体または特定のリストアイテムに対して操作を実行できます。
次の方法で、アイテムリストの再使用可能なコンポーネントを設定できます。
• リストへの入力を指定するモデル Thing を定義
• サーチとフィルタを有効化または無効化
• 初期のフィルタと並べ替えのオプションを設定
• グリッド内の行の最大数を設定
• リストの選択タイプを設定
• 埋め込み操作バーで使用可能な操作を設定 (詳細については、操作バーを参照してください)
フィルタドロップダウンメニューまたはサーチボックスを使用して、アイテムリストをフィルタまたはサーチできます。ただし、フィルタドロップダウンメニューとサーチボックスが JSON コンフィギュレーションファイルで有効になっていない場合は、フィルタとサーチは使用できません。属性名をクリックすることで、属性によってリストを並べ替えることができます。並べ替え順序を逆にするには、もう一度属性名をクリックします。
アイテムリストの再使用可能なコンポーネントには、埋め込み操作バーの再使用可能なコンポーネントも含まれています。操作バーを設定することにより、1 つまたは複数のリストアイテムに対して操作を実行するなど、追加の機能を有効にできます。詳細については、
操作バーを参照してください。デフォルトでは、アイテムリストの操作バーには、フィルタ基準に一致するすべての属性値を CSV ファイルにエクスポートする
「エクスポート」操作が含まれています。
アイテムリストには、「デフォルトに戻す」ボタンもあります。「デフォルトに戻す」ボタンは、列の並べ替え、スワップ、表示/非表示など、フィルタ、サーチ、グリッドレベルの操作のデフォルト設定を回復します。
以下のサンプルイメージは、アイテムリストの再使用可能なコンポーネントのフォーマットを示します。
アイテムリストの再使用可能なコンポーネントには、タスクリスト、変更適用アイテムリスト、添付資料リスト、およびアクティビティリストという 4 つの定義済みコンフィギュレーションがあります。特定の定義済みコンフィギュレーションの詳細については、そのトピックページを参照してください。
バインドプロパティ
アイテムリストコンポーネントには、バインドに使用可能な 4 つのプロパティがあります。
• input - バックエンドシステムからフェッチする必要があるデータの入力 ID を示す JSON。この情報は CCO (Common Communication Object) フォーマットで指定されます。この JSON に含まれるキーは、アイテムリストが入力として受け取る必要があるデータによって異なります。たとえば、添付資料リストには、変更適用アイテムリストとは異なる入力が必要です。
• tailoringName - コンポーネントのインスタンス名の文字列。これは調整と密接に結合されています。tailoringName は、各コンポーネントに対して保存されている調整情報をフェッチするために使用します。
• totalItemsNumber - サーチ基準とフィルタ基準に一致するリストアイテムの総数を示す整数。
• selectedItems - グリッド内で選択したアイテムのリストを持つ JSON。次に例を示します。
{
"timeStamp":"2019-08-25 18:53:33.476",
"data":[
{
"itemListsData":[
{
"items":[
{
"workItem":{
"value":"OR:wt.workflow.work.WorkItem:143921"
}
},
{
"workItem":{
"value":"OR:wt.workflow.work.WorkItem:143928"
}
}
],
"objectType":"PTC.Workflow.WorkItem"
}
],
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
}
}
],
"version":"1.0.0",
"statusMessage":"OK",
"status":"200"
}
コンフィギュレーションフィールド
次のテーブルは、このコンポーネントの設定に使用される JSON フィールドを示しています。
プロパティ名 | 説明 | タイプ | デフォルト値 | 必須またはオプション |
maxNumberOfRowsInGrid | グリッド領域に表示される行の最大数。10,000 以下の値を入力することをお勧めします。 | Integer | 50 | オプション |
modelThingName | データを取得するモデル Thing の名前。 | String | PTC.ItemListModelThing。 | 必須 |
label | アイテムリストのタイトル。 | String | [[PTC.ItemList]] | オプション |
selectionType | 一度に選択できるグリッド内のアイテムの数を指定します。使用可能なオプション: none、single または multi。 | String | multi | オプション |
waitForInput | グリッドに設定されているアイテムの読み込みを開始する前に、実行時に値がアイテムリストの入力マッシュアップパラメータに渡されるのを待つかどうかを指定します。使用可能なオプション: true、false。 | Boolean | false | オプション |
filterFieldID | フィルタ基準となるバックエンドシステム内のフィールドの ID。空白にした場合、フィルタするオプションはありません。 | MultiValueSelector | なし | オプション |
filterLabelOverride | モデルから返される表示値をオーバーライドするフィルタのラベル。 | String | なし | オプション |
defaultSelectedFilterValue | 最初に選択した値、またはフィルタ基準となる値。空白の場合、デフォルトのフィルタはありません。 | String | なし | オプション |
defaultSortField | 並べ替えの基準となる初期の列。空白の場合、最初の列によってアイテムリストが並べ替えられます。 | MultiValueSelector | なし | オプション |
defaultSortDirection | デフォルトの並べ替え方向 (該当する場合)。使用可能なオプション: asc は昇順を示し、dsc は降順を示します。フィールドを空白のままにすると、並べ替え方向は昇順になります。 | String | asc | オプション |
enableSearch | サーチフィールドを表示するかどうか。オプション : true、false。 | Boolean | true | オプション |
findHintText | サーチボックスに表示するヒントテキスト。 | String | "[[PTC.ItemListFindHintText]]" | オプション |
attributes | グリッドに表示する属性。詳細については、MultiValueSelector のドキュメンテーションを参照してください。その他のサブプロパティを参照してください: | MultiValueSelector | なし | 必須 |
fieldTitleOverride | 属性の代替表示名。これは、モデルから引き出されたフィールド名をオーバーライドします。 | String | なし | オプション |
showExportAction | エクスポート操作を有効または無効にします。オプション、true、false。 | Boolean | true | オプション |
actionBarConfiguration | 埋め込み操作バーのコンフィギュレーション。詳細については、 操作バーを参照してください。 | JSON | なし | オプション |
modelConfigurations | コンポーネントをさらにカスタマイズするために、アプリケーションビルダーが追加の値をモデルに渡す際の開始点。 | JSON | なし | オプション |
サンプルコンフィギュレーション
{
"modelConfigurations":{
},
"filterFieldId":{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":""
}
],
"objectType":""
}
],
"adapter":{
"instanceName":"",
"thingName":""
}
}
]
}
},
"defaultSortField":{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":""
}
],
"objectType":""
}
],
"adapter":{
"instanceName":"",
"thingName":""
}
}
]
}
},
"actionBarConfiguration":{
"maxItemsToShow":{
"value":2
},
"modelThingName":{
"entityName":"PTC.ActionBarModel.Thing"
},
"actions":{
"selectedValues":{
"data":[
{
"itemListsData":[
],
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
}
}
]
}
}
},
"modelThingName":{
"entityName":"PTC.ItemListModelThing"
},
"label":{
"value":"[[PTC.ItemListLabel]]"
},
"showExportAction":{
"value":true
},
"selectionType":{
"selectedKey":"multi"
},
"waitForInput":{
"value":false
},
"filterLabelOverride":{
"value":""
},
"defaultSortDirection":{
"selectedKey":"asc"
},
"attributes":{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":"",
"additionalData":{
"fieldTitleOverride":{
"value":""
}
}
}
],
"objectType":""
}
],
"adapter":{
"instanceName":"",
"thingName":""
}
}
]
}
},
"defaultSelectedFilterValue":{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":""
}
],
"objectType":""
}
],
"adapter":{
"instanceName":"",
"thingName":""
}
}
]
}
},
"enableSearch":{
"value":true
},
"maxNumberOfRowsInGrid":{
"value":50
}
}