ThingWorx Flow > 既成のコネクタと操作 > 既成のコネクタサービス > Windchill > 照会によってエンティティを取得
照会によってエンティティを取得
照会に基づいてエンティティのメタデータ詳細を取得するには、「照会によってエンティティを取得」操作を使用します。Windchill オブジェクトの名前または番号を指定してそのメタデータを取得できます。
ワークフローで「照会によってエンティティを取得」操作を使用するには、次の手順を完了します。
1. 「Windchill」の下の「照会によってエンティティを取得」操作をキャンバスにドラッグし、この操作にマウスポインタを合わせて をクリックするか、この操作をダブルクリックします。「照会によってエンティティを取得」ウィンドウが開きます。
2. 必要に応じて、「ラベル」を編集します。デフォルトでは、ラベル名は操作名と同じです。
3. 認証スキームを追加するには、 Windchill の承認を参照してください。デフォルトでは、「基本」が選択されています。Windchill の認証スキームを事前に追加している場合、リストから選択します。
4. 「エンティティタイプ」リストで、適切なエンティティタイプを選択します。
5. 「フィルタ」グループの「結合手段」リストで、次のいずれかのオプションを選択します。
「OR」 - 「フィルタ条件」グループで指定した、いずれかの条件が真を返さなければなりません。
「AND」 - 「フィルタ条件」グループで指定した、すべての条件が真を返さなければなりません。
デフォルトでは、「AND」が選択されています。
6. 「フィルタ条件」グループで、「追加」をクリックし、次の操作を行います。
a. 「プロパティ」リストで、選択したエンティティタイプのプロパティのうち、フィルタするものを選択します。
b. 「一致条件」リストで、適切な条件演算子を選択します。
c. 「値」フィールドに、フィルタするプロパティの値を入力します。
d. フィルタ条件に複数のプロパティを追加するには、「追加」をクリックします。または、 をクリックしてプロパティを削除します。
7. 「プロパティを選択」グループで、「追加」をクリックし、次の操作を行います。
a. 「プロパティ」フィールドで、選択したエンティティタイプに対して取得するプロパティを選択します。
b. 複数のプロパティを追加するには、「追加」をクリックします。または、 をクリックして、追加した任意のプロパティを削除します。
デフォルトでは、選択したエンティティのすべてのプロパティが取得されます。
8. 「関連アイテムを追加」グループで、「追加」をクリックし、次の操作を行います。
a. 「関連アイテム」フィールドで、選択したエンティティタイプに対して取得するエンティティの関連アイテムを選択します。
複数の関連アイテムを追加するには、「追加」をクリックします。または、 をクリックして、追加した任意の関連アイテムを削除します。
デフォルトでは、選択したエンティティの関連アイテムは取得されません。
9. 「制限」フィールドに、取得するサーチ結果の件数を入力します。
10. 「スキップ」フィールドに、サーチ結果から上位何件の結果をスキップするかを入力します。
11. 「完了」をクリックします。
出力スキーマ
「照会によってエンティティを取得」操作の出力スキーマは、動的スキーマです。これは、「エンティティタイプ」「プロパティ」「関連アイテム」フィールドで選択した値に従って変更されます。出力スキーマは、選択したエンティティタイプのオブジェクトと、Windchill OID をコンマで区切った識別子リストから成る配列を含みます。次の図にデフォルトの出力スキーマを示します。
「エンティティタイプ」Parts を選択した場合、出力スキーマは次の図のようになります。
「エンティティタイプ」Parts を選択し、「プロパティ」AssemblyMode に設定した場合、出力スキーマは次の図のようになります。
* 
たとえば、次の操作への入力として AssemblyMode をマッピングする場合、{ "Value": "separable", "Display": "Separable" } のような値が返されます。Value フィールドのみをマッピングする場合、マッピングを次のように更新します。
{{$a0.Results[0].AssemblyMode.Value}}
「エンティティタイプ」Parts を選択し、「プロパティ」AssemblyMode に設定し、「関連アイテム」Folder に設定した場合、出力スキーマは次の図のようになります。