カスタムタスクの作成
カスタムタスクを作成するには、
ThingWorx Navigate のカスタマイズのトピックで説明されている必要条件の知識が必要です。
タスクのブロックの作成
ThingWorx Navigate タスクは、いくつかの基本的な部分で構成されています。
• マッシュアップ - タスクのユーザーインタフェース。
• ThingWorx Navigate サービス - 操作を実行する Java または JavaScript。ptc-windchill-OData-connector 統合コネクタで使用できるサービスは多数あります。
• Windchill - データのソース。
• Windchill REST Services。これは WRS とも呼ばれます。
|
この例では Windchill REST Services (WRS) を使用して、Windchill からデータにアクセスします。WRS は OData に基づいており、ThingWorx Navigate のカスタマイズに推奨される方法です。RestEasy サービスは、将来のリリースで廃止される予定です。WRS を使用および拡張する方法については、Windchill のインストールのカスタマイズセクションを参照してください。
|
ThingWorx Navigate 9.0 では再使用可能なコンポーネントが導入されています。これらのコンポーネントは、 マッシュアップを構築するため、およびカスタムタスクで使用するために用意されていますが、このトピックでは説明しません。
概要
例を使用して、タスクの構築ブロックを組み合わせて、作業マッシュアップを作成する方法を示します。この例では、Windchill 部品とその属性のリストが表示されます。これらを実行すると以下のような表示になります。
始める前に、タスクの機能とレイアウトを計画しておくことが役立ちます。そうすることにより、ユーザーインタフェースでデータがどのように表示される必要があるか、このデータを表示するために必要なパネル、およびパネルとともに使用されるサービスについて理解できます。
getPart (/ProdMgmt/Parts GET) や
createPartinParts (/ProdMgmt/Parts POST) などの多くのエンドポイントは、WRS ドメインですでに使用できます。これらのサービスは以下の例で使用します。独自のサービスの作成の詳細については、 ヘルプセンターの
「Thing サービス」のトピックを参照してください。
Windchill REST Services ヘルプセンターには、よく使用されるいくつかのサービスの手順も記載されています。
このカスタムタスクを作成するには、ThingWorx Composer で次の手順に従います。
1. プロジェクトの作成
プロジェクトを作成して、カスタムタスクの一部となるすべてのエンティティを整理します。
1. 新規プロジェクトを作成し、プロジェクトの名前を入力します。
2. プロジェクトを保存します。
2. データシェイプの作成
データを表すデータシェイプを作成します。
データシェイプの詳細については、 ヘルプセンターの
「データシェイプ」のトピックを参照してください。
1. 新規データシェイプを作成します。名前を入力し、前の手順で作成したプロジェクトの名前を「プロジェクト」で追加します。
2. 「フィールド定義」タブに移動します。
3. 以下のフィールド定義を追加します。それぞれの「ベースタイプ」は STRING です。
◦ PartNumber
◦ PartName
◦ PartVersion
◦ PartID
これらのフィールド定義は、カスタムタスクが表示するデータに対応しています。
4. データシェイプを保存します。
3. OData コネクタの設定
タスクに表示されるデータのソースを提供する OData コネクタのインスタンスを設定します。
この手順では、OData コネクタを設定し、次の手順では、API マップとデータのルートサービスを作成します。
ThingWorx Composer でエンドポイントを選択する前に、エンティティデータモデル内のサービスによって公開される関係を理解しておくことをお勧めします。以下に、製品管理ドメインでサービスによって公開されるタイプ、プロパティ、および関係の説明の例を示します。図に示されているように、エンティティタイプが
Part であるエンティティセット
Parts があります。OData サービスで定義されているパスを使用してこのエンティティセットにアクセスすることにより、
Parts のすべてのプロパティにアクセスできます。詳細については、
Windchill REST Services ヘルプセンターを参照してください。
1. ThingWorx Composer で新規統合コネクタを作成します。「テンプレートを選択」ウィンドウで、ODataConnector を選択し、「OK」をクリックします。名前を入力し、以前に作成したプロジェクトの名前を「プロジェクト」で追加します。
2. 「コンフィギュレーション」タブをクリックし、コネクタを設定します。認証タイプに応じて、異なるフィールドが必要です。
OData コネクタの設定のトピックで説明されている認証タイプのコンフィギュレーション手順に従ってください。詳細については、 ヘルプセンターの
「統合コネクタの作成」のトピックを参照してください。
3. 「OData コネクタ接続の設定」で、
「サービスルート相対 URL」を
/<ドメインバージョン>/<ドメイン識別子> の形式で追加します (
/<ドメインバージョン> はオプション)。ここでは、ドメイン識別子は
ProdMgmt ですが、必ず実際のドメインの正しいドメイン識別子を使用してください。詳細については、Windchill REST Services ヘルプセンターの
「OData Services as Domains」のトピックを参照してください。
4. 統合コネクタを保存します。
5. 必要に応じて、接続を検証して接続が成功したことを確認できます。「サービス」タブをクリックし、ValidateConnection サービスを実行します。出力に接続のステータスを示す「ステータス」と「メッセージ」が表示されます。
4. API Map およびルートサービスの作成
バックエンドシステムの属性をデータシェイプ内の属性に関連付ける API マップを作成します。次に、マッシュアップがデータを消費できるようにルートサービスを作成します。
1. 前の手順で作成した統合コネクタで、「API マップ」タブに移動します。「追加」をクリックします。
2. 「マッピング ID」に API マップの名前を入力します。このフィールドには任意の値を使用できます。
3. 「データシェイプを選択」で、以前に作成したデータシェイプを選択します。「データシェイプ」テーブルに、以前に作成したフィールド定義が表示されます。
4. 「エンドポイント」で、エンドポイントを選択します。ここでは、getParts (/ProdMgmt/Parts GET) を選択します。エンドポイントを選択すると、「API」テーブルに属性が表示されます。
5. 「API」テーブルの属性を、対応するフィールド定義にドラッグアンドドロップします。ここでは、最上位の属性「番号」、「名前」、「バージョン」、「ID」を使用します。
| 「API」テーブル内のエレメントを折りたたみ、目的の属性を簡単に検索できるようにします。 |
6. ルートサービスを作成するには、「このマッピングからサービスを作成」チェックボックスをオンにします。ここでは、サービスのデフォルト名は getParts です。必要に応じて、サービスの名前を変更できます。
7. 「完了」をクリックし、統合コネクタを保存します。
5. マッシュアップの作成
タスクのユーザーインタフェースとして機能するマッシュアップを作成します。
前述のように、マッシュアップを構築するには、 ウィジェットまたは ThingWorx Navigate コンポーネントのどちらか、あるいは両方の組み合わせを使用するオプションがあります。
• ウィジェットの使用の詳細については、 ヘルプセンターの
「ウィジェット」のセクションを参照してください。
1. 新規マッシュアップを作成します。名前を入力し、以前に作成したプロジェクトの名前を「プロジェクト」で追加します。
2. タグ TWXNavigate:AppMashup をマッシュアップに追加します。
3. 「設計」タブをクリックし、マッシュアップのレイアウトを設定します。ここでは、5 つのコンテナを使用します。4 つのコンテナを使用して 30 ピクセルの境界を作成し、1 つのコンテナを中央に配置します。
4. 必要なウィジェットを追加します。ここでは、「アドバンスグリッド」ウィジェットを中央のコンテナに追加します。
5. 「データ」パネルの
![](../../ThingWorx_Navigate/images/plus_icon.png)
をクリックして、新しいデータソースを追加します。
6. 「エンティティタイプ」で、「統合コネクタ」を選択します。「エンティティ」で、前に作成した統合コネクタを選択します。
7. 以前に作成したルートサービスを選択します。ここでは、サービスの名前は
getParts です。
「選択したサービス」テーブルにサービスを追加するには、
![](../../ThingWorx_Navigate/images/arrow_button.png)
をクリックするか、サービスをドラッグアンドドロップします。
8. 「ロード時に実行」チェックボックスをオンにし、「完了」をクリックします。
9. 「データ」タブで、getParts を展開し、「戻されたデータ」を展開します。「すべてのデータ」を選択し、「アドバンスグリッド」ウィジェットの Data プロパティにバインドします。
10. マッシュアップを保存します。
11. 「マッシュアップを表示」をクリックします。カスタムタスクが新しいウィンドウで開きます。
ThingWorx Navigate ランディングページにタスクを追加して、調整を加えることが可能になりました。
ホームページへのカスタムタスクの追加のトピックを参照してください。