プロジェクト
プロジェクトは ThingWorx 内のエンティティの整理に使用されます。プロジェクトで収集されたエンティティをまとめてエクスポートおよびインポートできます。1 つのエンティティは 1 つのプロジェクトにのみ属します。ThingWorx 9.1 以降では、すべてのエンティティがプロジェクトに割り当てられている必要があります。Composer でエンティティを作成する場合、「プロジェクト」フィールドは必須であり、プロジェクトが設定されるまでエンティティを保存することはできません。
デフォルトプロジェクト: PTCDefaultProject
ThingWorx 9.1 以降では、PTCDefaultProject が既成のプロジェクトとして含まれていますが、カスタムプロジェクトを作成することをお勧めします。PTCDefaultProject には以下のような動作があります。
• エンティティが API を介して作成され、プロジェクトが定義されていない場合、そのエンティティは PTCDefaultProject に追加されます。
• PTCDefaultProject はシステムオブジェクトであり、プロジェクトエンティティへの依存として追加することはできません。
• エンティティがサービスを介して作成されたか、9.1 以降にインポートまたはマイグレーションされたときに、プロジェクト名が指定されなかった場合、PTCDefaultProject がプロジェクトとして割り当てられます。
• エンティティが複製され、エンティティにプロジェクトが含まれている場合に、そのプロジェクトが除去されると、エンティティが保存された後でデフォルトで PTCDefaultProject が割り当てられます。
• SetProjectName サービスを使用して、編集可能な拡張エンティティのプロジェクトを設定できます。UI はまだ読み取り専用であり、プロジェクトを設定するにはこのサービスを呼び出す必要があります。ユーザーが作成したプロジェクトと同じ拡張機能の一部であるプロジェクトのどちらも、これらのエンティティに設定できます。
プロジェクトの作成
1. Composer で
「プロジェクト」をブラウズして、
アイコンをクリックして新しいプロジェクトを作成します。
2. プロジェクトの名前と説明を入力します。
3. 「プロジェクトタイプ」を選択します。以下のオプションを使用できます。
◦ 「コンポーネント」タイプのプロジェクトは、テンプレート、シェイプ、サービスなど、ソリューション/アプリケーションの再使用可能な要素を表します。これにはユーザーエクスペリエンス、モデル、ロジックが組み合わされていることがありますが、アプリケーションによって利用されるまでは、問題を解決したり結果を出したりすることはありません。「コンポーネント」がデフォルトのタイプです。
◦ 「ソリューション」タイプのプロジェクトは、完全なソリューション/アプリケーションを表します。ソリューション/アプリケーションはコンポーネントタイプのプロジェクトで構成されており、通常は問題を解決したり結果を出したりします。
| 「プロジェクトタイプ」は ThingWorx 9.1 以降で使用可能です。 |
4. 必要に応じて、適切な「タグ」を追加し、「ホームマッシュアップ」を選択します。
5. 「プロジェクト依存」フィールドを使用して、そのプロジェクトが依存するほかのプロジェクトのリストを指定します。
| 「プロジェクト依存」フィールドを使用して空のプロジェクト (エンティティがないプロジェクト) を別のプロジェクトに割り当てることはお勧めしません。プロジェクトに割り当てられた後で空のプロジェクトが削除された場合、既存のプロジェクトのインポートまたはエクスポート中にエラーが発生することがあります。 |
6. 「拡張機能依存」フィールドを使用して、プロジェクトをデプロイしてプロジェクトが意図したとおりに機能するためにプロジェクトが依存する拡張機能を指定します。拡張機能は
Solution Central にパブリッシュしたりそこからデプロイしたりできます。
7. プロジェクトにエンティティを追加するには、「エンティティ」領域で、「使用可能なエンティティ」リストからエンティティを選択またはサーチして、これらを「プロジェクトエンティティ」領域にドラッグアンドドロップします。
新しいプロジェクトの場合、「使用可能なエンティティ」リストには、別のプロジェクトにすでに割り当てられているエンティティのリストが表示されます。そのようなエンティティを新しいプロジェクトに追加した場合、それらは再割当され、以前のプロジェクトからは除去されます。
| フィルタ ( ) アイコンを使用して、タイプ、プロジェクト、タグ、Thing Template、Thing Shape、または説明に基づいてエンティティをフィルタすることもできます。 |
| ThingWorx 9.3.5 以上では、プロジェクトへのエンティティの追加に関して次の機能強化が行われました。 • 最大 5000 個のエンティティを追加できます。エンティティの数が 5000 を超える場合、プロジェクトは読み取り専用になります。 • 制限に達すると、「保存」ボタンは無効になります。 • 制限に達すると、エンティティの除去と追加がプロジェクトエンティティエディタで無効になります。 |
8. 必要に応じて、並べ替え (
) アイコンをクリックしてエンティティを並べ替えるか、タイマー (
) アイコンをクリックして最近使ったエンティティを表示します。
| プロジェクトエンティティからエンティティを除去するには、エンティティを選択して「除去」をクリックします。複数のエンティティを一度に選択して除去できます。除去されたエンティティは「使用可能なエンティティ」リストに再び表示されます。 |
プロジェクトを削除またはエクスポートする場合は、「その他」ボタンをクリックします。「その他」メニューでは、「プロジェクトビューで開く」を選択することもできます。
9. 「保存」をクリックします。
プロジェクトコンテキスト
ThingWorx 9.1 以降では、すべてのエンティティにプロジェクトが割り当てられている必要があります。エンティティの作成時間を節約するには、「プロジェクトのコンテキストを設定」オプションを使用できます。これを設定した後は、以降に作成されたエンティティはそのプロジェクトに割り当てられます。
プロジェクトコンテキストは、Composer の 2 つの場所で設定できます。
• Composer の左上:
• Composer で作成された新しいエンティティの「一般情報」セクション内:
◦ プロジェクトコンテキストを変更するには、任意のエンティティで「プロジェクトのコンテキストとして除去」を選択します。プロジェクトコンテキストの設定なしで作成されたエンティティでは、エンティティを保存するためにプロジェクトを設定する必要があります。