Data Model URIs

概要と開発の背景

DOORS Next プロジェクトの成果物タイプ、属性、データ型、列挙値には、それぞれ URI を設定できます。レポート、パブリッシング・テンプレート、OSLC 統合、グローバル構成は、この URI を手がかりに、異なるプロジェクトやストリームにある「同じ」属性やタイプを識別します。URI がなければ、各プロジェクトは独自の内部識別子しか持たず、プロジェクトをまたいだ作業が成り立たなくなります。

プロジェクト・プロパティーで URI を手作業で設定するには、定義を 1 つずつ開いて URI を入力し、命名の一貫性を保たなければなりません。実際のデータ・モデルでは数百の項目があり、入力ミスの入り込みやすい作業に何時間もかかります。Data Model URIs は、モデル全体に 1 つの命名規則を適用し、これを 1 回の操作で行います。

解決する課題

• データ・モデルに URI がなく、レポート、統合機能、グローバル構成がプロジェクト間でタイプを照合できない。
• 手入力の URI で、つづり、接頭辞、大文字・小文字がばらばらになっている。
• 重複した URI がデータ・モデルの妨げになったり、レポートを混乱させたりする。
• 単純なルールに従うだけの作業に、プロジェクト・プロパティーで何時間も費やしている。

メリット

• モデル全体に 1 つのパターン: ドメインまたはサーバー、グループごとの接頭辞、名前の形式 (camelCase、PascalCase、snake_case、kebab-case) を指定します。
• 変更前に確認: パターンを設定している間にリアルタイムで例が表示され、すべての URI とそのステータスをプレビューできます。
• 安全な設計: 置き換えを選択しない限り既存の URI は保持され、競合する URI が書き込まれることはありません。
• 列挙値とリンク・タイプにも対応し、各列挙値はそのデータ型の URI の下に置かれます。
• Excel エクスポート: プレビューと各実行での変更内容を出力でき、レビューや監査に利用できます。

使い方

1. 変更セット (推奨) またはストリームでプロジェクトを開きます。ウィジェットがそのデータ・モデルを読み込みます。
2. URI pattern の Change をクリックし、ドメインまたはサーバー (例: https://example.com/ns) を入力してから、グループごとに接頭辞と名前の形式を選択します。例は選択内容に合わせて変わります。
3. プレビューを確認します: 新しい URI、設定済みの URI、保持される URI、競合。既存の URI を変更する場合は Replace URIs that are already set にチェックを付けます。ほかの人にも確認してもらう場合はプレビューを Excel にエクスポートします。
4. Set URIs (URI を設定) をクリックして確定します。進行状況が表示され、いつでも停止できます。
5. 結果ブロックの Log で変更レポートをダウンロードし、内容に問題がなければ変更セットをデリバーします。

知っておきたいこと

• 変更セットで作業することをお勧めします。そうすれば、新しい URI をデリバーの前にレビューしたり破棄したりできます。ベースラインは変更できません。
• 名前はきれいな URI の単語に変換されます。アクセント記号は削除され、スペース、ダッシュ、大文字が単語の区切りになります。
• 主な使用場面: プロジェクト・テンプレートの準備、グローバル構成の前のプロジェクトの統一、レポートや OSLC 統合の実現。
• システム属性など DOORS Next 自身が所有する定義は読み取り専用として表示され、変更されることはありません。ワークフローの状態は一覧に表示されません。DOORS Next ではこの方法でそれらの URI を保存できないためです。