KB: 既存の管理対象コンポーネントを新しいコンポーネントタイプとテンプレートに更新する
Updated: 9月 23, 2026
この記事では、既存の管理対象コンポーネントを更新し、新しいコンポーネントタイプ、テンプレート、フォルダー構成を適用する方法を説明します。組織によっては、サンプルのコンポーネントタイプやテンプレートを、社内要件に沿った独自の構成に置き換える必要があります。現在のワークスペースの設定や、実際に使用されているプロジェクトデータの有無に応じて、既存のテンプレートとタイプを更新する、サンプルデータを含まない新しいワークスペースを作成する、または新しいコンポーネントタイプとテンプレートを作成して既存のコンポーネントを移行する、といった方法を選択できます。この記事では、主な考慮事項と利用可能な選択肢に加え、一括編集を使用して既存のコンポーネントに新しいコンポーネントタイプとテンプレートを適用するための推奨手順を紹介します。
解決方法の詳細
既存コンポーネントの構造変更が必要な場合
組織がサンプルのコンポーネントタイプやテンプレートをカスタム設定に置き換える際、既存の管理対象コンポーネントの更新が必要になることがあります。その場合、コンポーネントを新しいコンポーネントタイプ、テンプレート、フォルダー構造に移行する必要があります。コンポーネントの構造を変更する際は、要件や初期状態がそれぞれ異なることを考慮することが重要です。そのため、決まった手順に沿う方法が必ずしも適しているとは限りません。
コンポーネントタイプによる分類とテンプレートの管理
コンポーネントタイプは通常、コンポーネントテンプレートおよびデフォルトのフォルダー構造に関連付けられています。コンポーネントテンプレートでは、パラメーターセット、パラメーターの表示設定、デフォルト値、必須パラメーターの設定を定義します。コンポーネントタイプを更新する際は、Workspace全体の一貫性を保つために、関連するテンプレートやフォルダー構造の更新も必要になることがよくあります。
コンポーネントの構造を変更する方法
- サンプルデータを含まない新しいWorkspaceを有効化し、カスタムのコンポーネントタイプ、テンプレート、フォルダー構造を作成します。ただし、現在のWorkspaceに実運用のプロジェクトデータをすでに作成している場合、この方法は使用できません。
- コンポーネントを作成する前に、既存のコンポーネントテンプレートとタイプを更新します。
- 新しいコンポーネントタイプ、テンプレート、フォルダー構造を作成し、一括編集を使用して既存のコンポーネントを新しい設定に更新します。
一括編集によるコンポーネントの更新
- 新しいコンポーネントタイプ、テンプレート、フォルダー構造を作成します。
- 旧テンプレートと新テンプレートを確認し、パラメーターの一貫性を確保します。パラメーター名とタイプを一致させることで、パラメーターの重複を防ぎ、移行後の整理作業を減らせます。パラメーターを追加しても問題ありませんが、主要なパラメーターは可能な限り一致させてください。新しいテンプレートパラメーターを作成する際は、対応するデータを手動で入力する場合を除き、必須に設定しないでください。
- 大規模なコンポーネントライブラリを更新する前に、少数のコンポーネントを使ったテストで手順を検証します。
- Explorerで、既存のコンポーネントを旧フォルダー構造から新フォルダー構造に移動します。
- 移行したコンポーネントを一括編集用に開きます。
- Models and Parametersセクションで、Addをクリックし、Template: Noneを選択します。これにより、既存のテンプレートパラメーターがユーザーパラメーターに変換されます。
- Addをもう一度クリックし、新しいコンポーネントテンプレートを選択します。
- 確認を求められたら、選択したすべてのコンポーネントのコンポーネントタイプを更新することを承認します。新しいテンプレートにより、ユーザーパラメーターがテンプレートのパラメーター名に置き換えられ、新たに定義されたパラメーターが追加されます。
- 更新は一括編集で段階的に行い、まずライフサイクル状態がDraftのコンポーネントから開始して、その後、他のライフサイクル状態のコンポーネントを更新します。
- 一括エディターでコンポーネントのリリース操作を行う際、ライフサイクル状態が維持されることを確認します。
- 移行したコンポーネントの検証が完了したら、混乱を防ぐために、不要になったコンポーネントタイプ、テンプレート、関連アイテムを削除します。
補足事項
- コンポーネントの移動とライフサイクル状態の管理は、段階的に進めることができます。
- 旧テンプレートと新テンプレートの間でパラメーターに不一致がある場合、一括編集ツールを使用した手動での整理が必要になることがあります。 リンク