Holarch

要求

ドキュメント

テンプレート、リッチテキスト、レポート、Word 出力を使い、モデルのライブビューとして仕様書を作成、構造化、採番、ベースライン化、公開します。

使い方 →

このページの内容
  1. 概要
  2. 概念
    1. ドキュメントの条件
    2. ドキュメントの種類
    3. 数値
    4. ベースライン
  3. 使い方
    1. 使う場面と理由
    2. テンプレートから要求仕様書を作成する
    3. 要求を書く
    4. 多数の要求をすばやく追加する
    5. 構成を変える
    6. レビュー、ベースライン化、公開
    7. 実例:CubeSat EO-1 のデモ
    8. ヒントとよい進め方
    9. よくある間違い
    10. 他の機能との関係
  4. ドキュメントの一覧
  5. ドキュメントページ
    1. ページヘッダー
    2. ツールバー
    3. アウトラインペイン
    4. ドキュメントの本文
    5. 右クリックメニュー
    6. クイック追加
    7. インスペクター
  6. 項目の追加
    1. 新しい項目
    2. その他のクラス
    3. Heading を使った構造化ドキュメント
    4. 既存のエンティティ
  7. 構成を変える
    1. インデント、インデント解除、移動
    2. ドラッグ アンド ドロップ
    3. 下に移動
  8. 番号付け
    1. 自動の番号振り直し
    2. 次の番号のルール
    3. 番号を振り直す
    4. ドキュメントの番号付け(メタ番号)
  9. テンプレート
    1. 組み込みテンプレート
    2. ドキュメントをテンプレートとして保存する
    3. テンプレートを管理する
    4. このブラウザーに保存されたテンプレート
    5. 既存のドキュメントにテンプレートを適用する
  10. リッチテキストエディター
    1. ツールバー
    2. 表
    3. 画像とファイル
    4. 代替テキスト
    5. リンクと埋め込みリンク
    6. ライブコンテンツ
    7. AI テキストツール
    8. 貼り付け
    9. リッチテキストのショートカット
  11. ドキュメント内を検索する
  12. 検索と置換
  13. 書くメニュー
    1. この分岐に属性を設定する
    2. 複数の項目に分割する
  14. チェックメニュー
    1. トレースステータス
    2. 略語を見つける
  15. 納品メニュー
    1. Word テンプレート
    2. 会社の Word ファイル
  16. 表示メニュー
  17. ベースライン
    1. ベースラインを作成する
    2. ベースラインを表示する
    3. バージョンを比較する
  18. レポート
  19. Word 出力
    1. キャプション、リスト、相互参照
    2. 納品物の設定
    3. ページ書式
    4. リッチテキストの変換
    5. 変更履歴版
    6. 印刷 / PDF
  20. コメント
  21. コンパイル
    1. 生成セクション
    2. Word でのコンパイル
  22. AI ツール
  23. キーボードショートカット
  24. このブラウザーに記憶される設定
  25. メッセージ
  26. 制限事項
  27. 関連

概要

ドキュメントとは、節と要求がモデル内のエンティティである仕様書、計画書、手順書です。ドキュメントページを使って、それらを書いて構成を変え、番号を付け、ベースライン化し、Word、Excel、ReqIF、Markdown などの形式で公開します。

ドキュメント内の各項目はエンティティです。そのため、同じ要求がデータベース、ダイアグラム、トレーサビリティマトリックス、品質チェックにも表示されます。どこで編集しても、ドキュメントに反映されます。

概念

ドキュメントの条件

  • ドキュメントとは、次の 2 つの条件のいずれかを満たす Artifact エンティティです。
    • ドキュメントの種類のラベル(名前が「Document」で終わる任意のラベル)を持っている。
    • 少なくとも 1 つの Statement または Heading の source of である。
  • ドキュメントの最上位の項目は、そのドキュメントが source of であるエンティティです。それより深い項目は、decomposed by 関係でその下に付きます。表示されるアウトラインは、この分解ツリーです。
  • 項目は通常、Statement(節、見出し、注記、仮定)と Requirement(とそのサブクラス)です。その他のクラスはその他のクラス…で追加します。
  • Heading(LML 2.0 の構造化ドキュメント)は、任意のクラスの項目を保持する節です。下位の節は Heading の下の Heading(decomposed by)です。Heading の下にあるその他の項目は節の内容です。Heading がそれを contains し、項目は自身の番号を保ち、下位の節より前に一覧表示されます。Heading を使った構造化ドキュメントを参照してください。
  • ドキュメントから項目を除去しても、エンティティは削除されません。データベースから削除すると削除されます。

ドキュメントの種類

種類は、ドキュメントのドキュメントの種類のラベルです。最初に提示されるテンプレートと、ドキュメントを用紙モードで開くかどうかが決まります。

種類組み込みテンプレート
Requirements DocumentRequirements Specification; Stakeholder Requirements Specification (StRS); System Requirements Specification (SyRS); Software Requirements Specification (SRS); Interface Requirements Specification (IRS)
Interface Control DocumentInterface Control Document (ICD)
Concept of Operations DocumentConcept of Operations
Needs Analysis DocumentNeeds Analysis
Concept Exploration DocumentConcept Exploration; Trade Study Report
Concept Definition DocumentConcept Definition; Architecture Description
Systems Engineering Management Plan DocumentSystems Engineering Management Plan
Test Plan DocumentTest Plan; Verification and Validation Plan; Test Procedure; Test Report
Independent Verification & Validation Plan DocumentIV&V Plan
Project Management Plan DocumentProject Management Plan; Risk Management Plan; Configuration Management Plan
Integrated Logistics Support Plan DocumentIntegrated Logistics Support Plan
Standard Operating Procedure DocumentStandard Operating Procedure

他の種類のテンプレートはその他のテンプレートの下に一覧表示されるため、どのテンプレートからでもどのドキュメントでも始められます。

ドキュメントの種類を追加するには、名前が「Document」で終わるラベルを Artifact クラスに追加します(スキーマ拡張を参照)。レビューパッケージのラベルが付いたドキュメントは、他のドキュメントをまとめます。コンパイルを参照してください。

数値

各項目には、名前の前に表示される 3.2 のような番号があります。番号はエンティティに保存されるため、同じ要求はどこでも同じ番号で表示されます。例外はドキュメントの番号付けで、ドキュメントごとに別の番号を保持します。

項目の追加や移動の後に自動で番号を振り直すがオンの間(既定。チェックボックスは書く ▾ → 番号を振り直す…にあります)、番号は自動的に順番どおりに保たれます。

ベースライン

ベースラインはドキュメントの読み取り専用のスナップショットです。次のものを保持します。

  • ドキュメントの項目、その属性と関係(ドキュメントの 1 ステップ外にあるエンティティへのリンクを含む)。
  • ドキュメントの設定。
  • 日付付きの承認記録。後から編集することはできません。

ベースラインは、変更レポートと、Word 出力の Revision History と Approvals の表に使われます。

ホスト型サービスでは:

  • 各承認記録には、ブラウザーの時計ではなく、サーバーの時刻と保存したアカウントが記録されます。記録には「(server time) · recorded by {name}」と表示され、保存は監査ログに書き込まれます。
  • ベースラインの名前の変更や削除ができるのは、プロジェクトのオーナーだけです。他のユーザーには、削除と名前フィールドが「Only a project owner can rename or delete a baseline.」とともに淡色表示されます。復元と元に戻す操作はこれまでどおり使えます。

デスクトップアプリでは、記録にはコンピューターが保存した日付が付きます。

使い方

使う場面と理由

成果物が、誰かが読んでレビューし署名する仕様書である場合にドキュメントを使います。例:

  • SRR のためのシステム要求仕様書。
  • コンセプト開発の初期の運用構想書。
  • 検証開始前のテスト計画書。
  • 運用のための手順書。

要求はここで書き、モデル内の別の場所で機能、アセット、テストにトレースします。ドキュメントは「この仕様書には何がどの順で書かれていて、承認以降に何が変わったか」に答えます。

システムズエンジニアリングの流れでは、ドキュメントが最初に来ます:ステークホルダーのニーズとシステム要求です。これらは機能分析と割り当てに使われます。レビューでは、トレーサビリティレポート付きの、ベースライン化され承認された成果物として戻ってきます。

テンプレートから要求仕様書を作成する

  1. ナビゲーションレールでニーズと要求 → ドキュメントを開きます。
  2. ページヘッダーの+ 新しいドキュメントをクリックします。

    新しいドキュメントが開きます。

  3. 名前(必須)を入力します。番号と説明は後でインスペクターで追加できます。
  4. テンプレートの下の対象のテンプレートには、1 つのドキュメントの種類(たとえば Requirements Document)のテンプレートが表示されます。各カードには最初の節がプレビューとして表示されます。次のいずれかを選択します。
    • 空白:表示されている種類の空のドキュメント。
    • 組織の管理者が公開した Organization templates の項目(Holarch サーバー、ホスト型またはセルフホスト型)。その種類の組織の既定があらかじめ選択されています。
    • このプロジェクトに保存されたプロジェクトのテンプレートの項目。
    • 組み込みテンプレートの項目。
    • その他のテンプレートの下にある、別のドキュメントの種類のテンプレート。

      ドキュメントには、選択したテンプレートの種類が付きます。

  5. 記述ガイダンスを含めるを選択すると、組み込みテンプレートの各節に短い記述ガイドが追加されます。
  6. 作成をクリックします。

    ドキュメントは、テンプレートの番号付きの節(たとえば 1 Document Control、1.1 Revision History、1.2 Approvals、2 Introduction …)とともに開きます。記述ガイダンスを含めた場合は、各節を書きながら削除します。

要求を書く

  1. 節の行をクリックして選択します。
  2. + 子をクリックするか、⌥⌘↵ / Ctrl+Alt↵ を押します。

    「New Requirement」という名前の新しい行が番号付きで表示され、名前を入力できる状態になります。

  3. 名前を入力して Enter を押します。
  4. 説明をクリックし、「shall」文を書きます。
  5. ⌘↵ / Ctrl↵ を押すか、別の場所をクリックして説明を保存します。
  6. 同じレベルに次の要求を追加するには、もう一度 ⌘↵ / Ctrl↵ を押します。

+ 新規 …(ページヘッダー)はドキュメントの末尾に項目を追加し、+ 後と+ 子は選択した項目の隣に追加します(+ 新規 …のツールチップにその旨が表示されます)。3 つとも、それぞれの ▾ メニューで最後に選んだクラス(既定は Requirement)を追加します。選択はこのブラウザーに記憶されます。

多数の要求をすばやく追加する

ドキュメントの下部にあるクイック追加を使って、要求を次々に入力します。

  1. クイック追加バーで、節(たとえば Under 4 Command and Data Handling)を選択します。
  2. 要求のテキストを入力します。
  3. Enter を押します。

    要求が追加され、「shall」の後の語から名前が付きます。カーソルは次の入力のためにフィールドに残ります。

構成を変える

アウトラインは、キー、ドラッグ、または右クリックメニューで変更します。自動の番号振り直しがオンの場合、移動のたびに番号が更新されます。

  • キーで:行を選択して、次のキーを押します。
    • ⌥⇧→ / Alt+Shift+→ で、上の項目の下にインデントします。
    • ⌥⇧← / Alt+Shift+← で、インデントを解除します。
    • ⌥ / Alt+↑ または ⌥ / Alt+↓ で、兄弟の間で移動します。
    • Tab はインデントには使われないため、常に次のフィールドに移動します。
  • ドラッグで:アウトラインペインで行をドラッグします。行の上端または下端にドロップすると、その前または後に項目を置きます。中央にドロップすると子になります。
  • メニューから:行を右クリックして下位へ移動 ▸を選び、一覧から新しい親を選択します(入力して絞り込めます)。子も一緒に移動します。

レビュー、ベースライン化、公開

  1. チェック ▾ → 品質をチェックを選択し、弱い要求を修正します(要求を参照)。
  2. チェック ▾ → トレースステータス…を選択し、まだ割り当てまたは検証されていない要求をリンクします。
  3. チェック ▾ → TBD/TBR 登録簿で未解決項目を解決します。
  4. チェック ▾ → 確認するリンクをレビューします。
  5. 表題欄でバージョン ▾をクリックし、ベースラインを保存…を選択します。
  6. 名前(たとえば「SRR Baseline」)を入力します。
  7. 承認者ごとに 1 行の承認行を、名前、役割、記述とともに追加します。
  8. 作成をクリックします。

    ベースラインがバージョン ▾に表示され、ボタンにはそれが最新のベースラインとして表示されます。

  9. 納品 ▾ → 仕様書(Word)をクリックします。

    Specification テンプレートのオプションで Word ファイルがダウンロードされます。ベースラインから埋められた Revision History と Approvals の表も含まれます。

  10. Word でファイルを開き、フィールドを更新する確認を承諾します。

    目次が埋まります。

ベースライン化の前にドキュメントをレビューしてもらうには、ドキュメントの種類の横にあるレビューを依頼をクリックします。プロジェクトのレビュー担当者は、マイワークのレビュー対象のドキュメントでそれを見つけ、そこまたはタイトルの下のストリップで承認または却下します。

その後の編集の後、何が変わったかを確認します。

  1. バージョン ▾ → 版を比較…をクリックします。
  2. From でベースラインを、To で現在のバージョンを選択します。

    レポートには、すべての追加、除去、編集が一覧表示されます。ダウンロードするには変更(Excel)を、変更履歴付きの Word ファイルには変更履歴版(Word)をクリックします。

実例:CubeSat EO-1 のデモ

プロジェクトを管理 → プロジェクトファイル ▾ → 新しいデモプロジェクトからデモを作成します。次にニーズと要求 → ドキュメント → EO-1 System Requirements Specification(番号 SRS-001)を開きます。

構造を読みます。6 つの節に要求があります。

  • 1 Mission Imaging
  • 2 Attitude Determination and Control
  • 3 Electrical Power
  • 4 Command and Data Handling
  • 5 Communications
  • 6 Ground Segment and Operations

要求 1.6 Revisit Time には、1.6.1 Ground Track Repeat と 1.6.2 Off-Nadir Imaging の 2 つの子があります。品質スコア列にはバーが表示されます。2.5 Safe Mode Recovery と 6.4 Operator Interface のスコアは低くなっています。

弱い表現を修正します。

  1. ⌘F / Ctrl+F を押して should と入力します。

    カウンターに一致件数が表示されます。

  2. 2.5 が強調表示されるまで Enter を押します。

    そのテキストは「The spacecraft should recover from safe mode quickly and resume imaging as appropriate」です。

  3. 書き直します。たとえば「The spacecraft shall resume imaging within 24 hours of a safe mode entry.」。

    チェックをもう一度実行するまで、スコア列には古いタグが表示されます。

複合要求を分割します。

  1. 6.4 Operator Interface(「…shall be user friendly and/or easy to use.」)を選択します。
  2. 右クリックして複数の項目に分割…を選択します。
  3. ✦ 分割を提案をクリックします。

    1 行につき 1 つの測定可能な要求が得られます。

  4. 不要な行のチェックを外すか、結合をクリックして行を次の行と結合し、適用をクリックします。

要求をすばやく追加します。

  1. クイック追加で Under 3 Electrical Power を選択します。
  2. 「The EPS shall provide a 5 V regulated bus within 3%.」と入力して Enter を押します。

    3.7 として追加され、「Provide A 5 V Regulated」という名前が付きます。

SRR 以降に何が変わったかを確認します。

  1. 表題欄のバージョン ▾をクリックし、SRR Baseline を選択します。

    バナーには「Baseline “SRR Baseline”, read-only, saved {date}」と表示されます。承認者は J. Rivera(Systems Lead)、R. Okafor(Mission Principal Investigator)、L. Brandt(Program Manager)です。

  2. 現在と比較をクリックします。

レポートには次の内容が一覧表示されます。

  • 3.1 Orbit Average Power:説明が 28 W から 30 W に変更され、新しい根拠が追加されました。
  • 2.4 Target Slew:Status が Draft → In Review。
  • 追加された 4.4 Downlink Encryption と、その 2 つの新しい satisfies リンク。
  • このセッションでのあなた自身の編集。

公開します。

  1. 現在に戻るをクリックします。
  2. 納品 ▾ → 仕様書(Word)をクリックします。

    Word ファイルはタイトルと「Requirements Document · No. SRS-001」で始まります。SRR Baseline の Revision History の行(「Initial baseline」)と 3 つの承認が続き、その後に番号付きの要求が続きます。

ヒントとよい進め方

  • 1 行に 1 つの要求を、「shall」を 1 つ使って書きます。複数の項目に分割…と品質チェックが、要求を単一に保つのに役立ちます。
  • 節は Statement に、要求は Requirement にします。品質チェックが採点するのは Requirement だけです。Requirement 専用のレポート(RVTM、VCRM、RTM)は Statement を対象外にします。
  • すべてのレビューの前と、大きな書き直しの前にベースラインを作成します。元に戻す操作と変更レポートはベースラインに依存します。
  • 行をクリックすると選択されます。編集するには、フィールド自体をクリックするか、選択した行で Enter または F2 を押します。
  • 表示 ▾ → 用紙を使うと、属性の列なしで、ページのようにドキュメントを読めます。列で属性を編集するにはオフにします。
  • トレースステータスの点に注意します:点が緑になれば、要求はレビューの準備ができています。

よくある間違い

  • 追加が淡色表示になっている。フィルターまたは並べ替えが有効(ツールバーにフィルター適用中: 編集できません。フィルターをクリア)か、ベースラインを表示しています。警告をクリックするか、現在に戻るをクリックします。
  • 移動後に番号が飛んだ。自動の番号振り直しは、兄弟グループの番号を書き直します。手動で設定した番号を保つには、書く ▾ → 番号を振り直す…で項目の追加や移動の後に自動で番号を振り直すをオフにするか、番号を変えてはならない項目をロックします。
  • 項目を除去したのにデータベースに残っている。Remove はドキュメントから外すだけです。削除するには、続いて表示されるメッセージで項目を削除…を選ぶか、⇧ / Shift キーを押しながら Remove をクリックするか、⇧Delete / Shift+Delete を押します。
  • 英字やローマ数字の番号が 10 進数になった。自動の番号振り直しと番号を振り直す…は 10 進数の番号(1、1.1、1.1.1)を生成します。英字の付録を保つには、自動の番号振り直しをオフにして手動で番号を付けます。

他の機能との関係

  • 入力元:
    • インポートは、Word、Excel、CSV、ReqIF、XMI、テキストからドキュメントを作成します。
    • テンプレートは骨組みを作成します。
    • AI ジェネレーターは要求を追加します。
  • 出力先:
  • 他のすべての場所:各項目はエンティティです。データベース、項目ビュー、Spider 図やツリー図などのダイアグラムに表示されます。

ドキュメントの一覧

ドキュメントの一覧には、プロジェクト内のすべてのドキュメントが、ダイアグラムページと同じギャラリーにカードとして表示されます。ニーズと要求 → ドキュメントで開きます。

各カードには次の内容が表示されます。

  • ドキュメントのアウトラインのサムネイル。
  • 名前、種類、最終編集日時(ドキュメントまたはいずれかの項目の最新の変更)。
  • 「N items · N requirements」。
  • 要求にスコアがある場合は Mean quality N%。
  • N TBD/TBR:未解決項目。
コントロール機能
Search documents…名前、番号、説明にそのテキストを含むカードを表示します。
並べ替え最近編集(既定)、番号(アウトライン順)、名前、クラス。
種類のピルすべてと、件数付きのドキュメントの種類ごとのピル。
Show more (N)さらにカードを表示します。
インポート(ページヘッダー)インポートページを開きます(インポートとエクスポート)。
+ 新しいドキュメント(ページヘッダー)新しいドキュメントを開きます。
カードの ⋯Open、Open in ▸ 項目ビュー、複製…、削除…。

削除…を選ぶとドキュメントを削除が開きます:「Deletes "…". Its N sections stay in the project as items.」(ドキュメントを削除します。その N 個の節は項目としてプロジェクトに残ります。)一部の節がほかのどのドキュメントにも含まれていない場合、Also delete the N sections that no other document uses でそれらも削除されます。元に戻すですべて復元されます。

カードをクリックするとドキュメントが開きます。

アドレス documents/<id> でドキュメントを直接開きます。?baseline=<id> または ?baseline=latest を付けるとベースラインを、?find=<text> を付けると検索を開始した状態で、?comments=1 を付けるとインスペクターにドキュメントのコメントを表示した状態で開きます。

ドキュメントページ

ドキュメントページには、1 つのドキュメントがアウトラインと表として表示され、選択した項目がインスペクターに表示されます。

  • + New {Class} は、現在のクラスの項目をドキュメントの末尾に追加します。その ▾ でクラスのメニューが開きます。
    • 既存の項目を追加…。
    • ドキュメントを挿入…と生成セクションを挿入…(コンパイルのみ)。
    • 見出し末尾に追加の下:すべての Statement クラスと 見出し(現在のクラスには ✔)、その他のクラス…。
  • ✦ AI ▾(上部バー)には、ドキュメントの AI ツールがあります(AI ツールを参照)。

ツールバー

コントロール機能
+ 後選択した項目の後に、同じレベルで項目を追加します(⌘↵ / Ctrl↵)。その ▾ には、既存の項目を追加…、Add Child (⌥⌘ / Ctrl+Alt↵)、選択した項目の後に追加の下のクラス一覧があります。
+ 子選択した項目の子を追加します(⌥⌘↵ / Ctrl+Alt↵)。その ▾ には、既存の項目を追加…と、子を追加の下のクラス一覧があります。
⇤ / ⇥選択した項目のインデントを解除(⌥⇧← / Alt+Shift+←)/ インデント(⌥⇧→ / Alt+Shift+→)します。
↑ / ↓選択した項目を兄弟の間で上下に移動します(⌥ / Alt+↑ / ⌥ / Alt+↓)。
除去選択した項目とそのサブツリーを一度にドキュメントから外します(Delete も同じ)。ドキュメントから除去しました。に元に戻すと項目を削除…が表示されます。⇧ / Shift+クリックまたは ⇧Delete / Shift+Delete は、削除されるものを示す確認の後、項目とその子を削除します。Esc またはインスペクターの × で選択を解除します。
書く ▾内容の追加、挿入、生成、編集(書くメニューを参照)。
チェック ▾このドキュメントの品質、モデルチェック、トレースステータス、確認するリンク、TBD/TBR、コメントを件数付きで表示します(チェックメニューを参照)。
納品 ▾成果物とページの設定、Word テンプレート、バージョン、出力ごとにまとめたエクスポート(納品メニューを参照)。
表示 ▾このドキュメントの直接の切り替え:用紙、アウトラインペイン、トレースステータス、列(表示メニューを参照)。
フィルター適用中: 編集できません。フィルターをクリアクラスまたはラベルのフィルターか列の並べ替えがオンの間に表示されます。クリックするとクリアされます。
検索検索ボックスを開きます(⌘F / Ctrl+F)。

構造のボタンは次の場合に無効になります。

  • 何も選択されていない。
  • 選択した項目がロックされている。
  • フィルターまたは並べ替えが有効になっている。
  • ベースラインを表示している。

アウトラインペイン

左側のアウトラインペインには、ドキュメントの階層が表示され、上部にフィルターがあります。タブはありません:ベースラインは表題欄のバージョン ▾にあり、コメントはインスペクターで開きます。

  • ‹ でペインを隠し、左端の › で再び表示します(表示 ▾ → アウトラインペインでも可)。
  • 右端をドラッグしてサイズを変更します(180~500 px)。
  • 項目を選択すると、ペインの横にインスペクターが開きます。ペインは開いたままです。
  • ペインとドキュメントの合計が 900 px 未満になると(項目を選択しても変わらないよう、インスペクターは開いているものとして数えます)、ペインは折りたたまれます。その後は › からオーバーレイとして開きます。外側をクリックすると閉じます。

ペインの上部のフィルター:

  • アウトラインを絞り込むは、番号または名前にそのテキストを含む項目(折りたたまれたものも含む)にアウトラインを絞り込みます。その親はコンテキストとして淡色でアウトラインに残ります。ドキュメント自体は絞り込みません。
  • クラスのチップ:ドキュメント内のクラスごとに件数付きで 1 つ(ドキュメントに複数のクラスがある場合に表示)。チップをクリックすると、そのクラスとサブクラスだけがドキュメントに表示されます。もう一度クリックするとすべてのクラスが表示されます。チップを右クリックすると、{Class} and subclasses、{Class} only、クラスフィルターをクリアが表示されます。
  • ラベルのチップ:ドキュメントで使われているラベルごとに件数付きで 1 つ。チップをクリックすると、選んだすべてのラベルを持つ項目だけが表示されます。複数のラベルのいずれかを持つ項目には、データベースのクエリを使います。
  • チップが 6 つを超えると、クラスまたはラベルで絞り込み(n)の後ろに折りたたまれます。折りたたまれている間は、適用中のチップだけが表示されます。フィルターを減らすで再び折りたたみます。選択はこのブラウザーに記憶されます。
  • フィルターまたは並べ替えがオンの間はフィルターをクリアが表示されます。絞り込まれた行はインデントを保ちます。フィルターまたは並べ替えがオンの間は編集できません。

アウトライン:

  • 各項目には、色見本、番号、名前、ロック時の 🔒、▾/▸ の切り替えがあります。
  • 項目をクリックすると、その項目が選択され、そこまでスクロールします。
  • ドラッグして並べ替えます(ドラッグ アンド ドロップを参照)。無効なドロップ先には印が付き、拒否されます:項目を自分の子の下、ロックされた項目の下、その項目で decomposed by できないクラスの下には置けません。
  • ドキュメントの表示中の部分に当たる行が強調表示され、アウトラインはドキュメントに合わせてスクロールします。ポインターを合わせている間、アウトライン内で作業している間、または直前の 2 秒以内にスクロールした場合は、その位置にとどまります。
  • 収まらない深いレベルには、インデントを増やす代わりに L{n} のレベルタグが表示されます。

ドキュメントの本文

本文は表題欄から始まります:ドキュメントの種類とラベル、項目数、ドキュメントの番号がオンの場合は「numbered per document」、💬 n open comments(ある場合。コメントを参照)、バージョン ▾(ベースラインを参照)。バージョン ▾には現在のバージョン、現在 · 最新のベースライン {name}、またはベースライン: {name}と表示されます。その下には:

  • 番号とタイトル:クリックしてドキュメントの番号と名前を編集するか、Tab で移動して Enter または F2 を押します。
  • ドキュメントの説明:クリックしてリッチテキストエディターで編集するか、Tab で移動して Enter または F2 を押します。
  • 表。Entity 列には各項目(切り替え、番号、名前、バッジ、説明)があります。その他の列は表示 ▾ → 列 ▸で選んだ属性の列です。変更するまでは Status、Verification Method、品質スコアです。用紙ビューには列がありません。

各行には次のものが表示されます。

  • 子を折りたたむ・展開する ▾/▸。
  • 番号と名前。クリックして編集するか、Tab で移動して Enter または F2 を押します。Enter で保存し、Esc でキャンセルします。フォーカスはフィールドに残ります。貼り付けた改行はスペースになります。
  • バッジ:
    • 🔒:項目はロックされています。
    • ⚡:項目にガイダンスがあります。ポインターを合わせると読めます。
    • 💬 n:未解決のコメント。クリックするとインスペクターで開きます。
    • ⚠ レビュー:上流の要求が変更されました。
    • クラスのバッジ。
    • トレースステータスの点(要求のみ。トレースステータスを参照)。
  • 説明。リッチテキストエディターで編集します。
  • 左端の色付きのバー:最新のベースライン以降変更がなければ青、新規または変更済みなら琥珀色。
  • 属性のセル:
    • ラベルには、除去用の × と追加用の + 付きのチップが表示されます。メニューには、クラスで許可されたラベル、または「ほかにラベルはありません」が表示されます。
    • テキスト属性はその場で編集します。その他の属性は、その型のエディターを使います。
    • 品質スコアには色付きのバーが表示されます:67% 以上で緑、34% から 66% で琥珀色、それ未満で赤。前回のチェック後にテキストが変更された場合は、時計アイコン付きの古いタグが表示されます。ポインターを合わせると理由が表示されます。
    • 「—」は、そのクラスにその属性がないことを示します。

並べ替えと列幅:

  • 列の見出しをクリックすると昇順に、もう一度クリックすると降順に並べ替え、3 回目で並べ替えをオフにします。
  • 並べ替えると、項目は階層なしの平らな一覧になり、作成作業は一時停止します。
  • 見出しの右端をドラッグすると列の幅を変更できます。Entity 列は 300 px 以上、その他の列は 80 px 以上です。幅はドキュメントごとにこのブラウザーに保存されます。
  • 空白の区切り行が最上位の節を区切ります。

行の選択:

  • 行をクリックすると選択されます。クリックは選択だけです。編集するには、フィールドをクリックするか、行で Enter または F2 を押します。
  • 選択を解除するには、表の下の空白部分をクリックするか、Esc を押すか、✕ をクリックします。
  • ↑ と ↓ で行の間で選択を移動します。
  • ⌘ / Ctrl+クリック(Windows と Linux では Ctrl+クリック)で、項目を選択に追加または選択から外します。
  • ⇧ / Shift+クリックで、最後にクリックした項目からこの項目までの範囲を、表示順(並べ替えやフィルターがあればそれに従う)で選択します。⌘ / Ctrl+⇧ / Shift+クリックで、その範囲を選択に追加します。
  • フォーカスのある項目で(編集中でないとき)⌘A / Ctrl+A を押すと、表示中のすべての項目を選択します。⇧ / Shift+↑ と ⇧ / Shift+↓ で、フォーカスのある項目から選択範囲を広げます。
  • 同じ操作はアウトラインでも使えます。ツールバーに件数(「21 selected」)が表示されます。普通のクリックまたは Esc で 1 項目の選択に戻ります。
  • 編集中のフィールド内でのクリックは、テキストとしての動作を保ちます:そこで ⇧ / Shift+クリックすると、テキストの選択範囲が広がります。

右クリックメニュー

ドキュメント内の項目(番号、名前、バッジ、その周りの空白)またはアウトラインの項目を右クリックすると、ポインターの位置にメニューが開きます。キーボードからは、行またはアウトラインの項目にフォーカスを置き、Shift+F10 またはメニューキーを押します。メニューは項目の位置に開き、Esc でフォーカスがそこに戻ります。タッチスクリーンでは、項目を長押しします。その項目が選択されます。

メニューの先頭には、項目の状態から選ばれた最大 3 つのおすすめの操作があり、それぞれの右側に理由が表示されます。たとえば ✦ Add Measurable Criteria…(不合格:Unambiguous)、✦ テストケースを生成…(未検証)、リンクを確認…(上流が変更済み)、Resolve TBD…(未解決の TBD)です。修正するものがなければ、✦ AI でチェック…と✦ これについて AI に質問…が提案されます。✦ More AI ▸には、その項目に対するすべての AI の操作が一覧表示されます。ルールと完全な一覧はモデルとデータベースにあります。各 AI の操作は、何かが変わる前に結果をレビュー用に表示します。AI がオフの場合、AI の部分は理由を示す淡色の 1 行になります。

区切り線の後のコマンド。コマンドの右に表示されたキーで、キーボードから同じ操作ができます(キーボードショートカットを参照)。

コマンド機能
移動アウトラインのみ。ドキュメントをその項目までスクロールし、フォーカスを移します(アウトラインの項目で Enter)。
開く項目ビューを開きます。
名前を変更…名前を変更します。ドキュメント内のフォーカスのある項目で F2 を押すと、その場で名前を編集します。
Add {class} After+ 後と同じように、現在のクラスの項目をこの項目の後に追加します(⌘↵ / Ctrl↵)。
Add Child {class}+ 子と同じように、現在のクラスの項目をこの項目の下に追加します(⌥⌘↵ / Ctrl+Alt↵)。
インデント、インデント解除ツールバーの ⇥ と ⇤ と同じです(⌥⇧→ / Alt+Shift+→ と ⌥⇧← / Alt+Shift+←)。
上へ移動、下へ移動ツールバーの ↑ と ↓ と同じです(⌥ / Alt+↑ と ⌥ / Alt+↓)。
Status ▸、Priority ▸属性を設定します。現在の値にはチェックが付いています。
Relate To ▸そのクラスで最もよく使われる関係を最初に一覧表示し、続いてクラスで許可されたすべての関係を含むすべての関係 ▸を表示します。1 つ選ぶと、ターゲットのエンティティを選ぶピッカーが開きます。
Show in Diagram ▸その項目を表示できるダイアグラムの種類を一覧表示します。1 つ選ぶと開きます。
Copy Link項目の項目ビューへのリンクをコピーします。
Copy Number項目の番号をコピーします。
開く場所 ▸項目ビュー、履歴…、その項目を表示できるダイアグラム(Hierarchy、Tree、Spider、Action、Asset、Risk、Timeline)、トレーサビリティマトリックス、要求の品質、機能分析。
下位へ移動 ▸この項目を保持できる項目の、入力して絞り込める一覧(ドキュメント順にインデント)と、親がある場合はドキュメントの最上位。子も一緒に移動します。
複数の項目に分割…複数の項目に分割するを参照してください。
クラスを変更…クラスを変更を開きます(データベースと同じダイアログ。モデルとデータベースを参照)。
ここから番号を振り直す…この項目、その後の兄弟、それらの子に対して番号を振り直すを開きます。
この分岐に属性を設定…この分岐に属性を設定するを参照してください。
ロック / ロック解除項目を編集できないようにロックするか、ロックを解除します。
このドキュメントから除去項目とその子をドキュメントから外します(Delete)。エンティティはプロジェクトに残ります。メッセージに元に戻すと項目を削除…が表示されます。
項目を削除…確認の後、項目とその子を削除します(⇧Delete / Shift+Delete)。

各コマンドは 1 回の元に戻すで取り消せます。適用できないコマンドは淡色表示になり、ツールチップに理由が表示されます。

  • ベースラインの表示中、または閲覧のみのアクセスでは、移動、Open、Show in Diagram ▸、リンクをコピー、Copy Number だけが使えます。ベースラインでは、おすすめの操作と ✦ AI の操作も淡色表示になります。
  • ロックされた項目では、名前を変更…、Status ▸、Priority ▸、Relate To ▸、移動、項目を削除…が淡色表示になります。
  • フィルターまたは並べ替えが有効な間は、追加と移動が淡色表示になります(「Clear the filter or sort first」)。
  • 項目をそのレベルの先頭または末尾を越えて移動させるコマンドは淡色表示になります(たとえば最初の項目の上へ移動)。

複数の項目を選択している場合。選択内の項目を右クリックすると、選択したすべての項目に対して操作します。メニューには N selected が表示され、✦ の一括操作(✦ Check with AI (n requirements)…、✦ Rewrite (n) ▸、✦ Generate Test Cases (n)…、✦ Ask AI About These (n)…、✦ Suggest Traces (n)…。選択した複数の項目に対する AIを参照)、Set Status ▸、Set Priority ▸、Add to Document ▸、Remove n from This Document、Delete n Items…(確認の後。選択した項目の子も一緒に削除されます)があります。1 つの項目用のコマンド(移動、Open、名前を変更…、追加、インデント、移動)は一覧に残りますが、理由「Acts on one entity」とともに淡色表示されます。各コマンドは 1 回の元に戻す操作です。選択外の項目を右クリックすると、その項目だけが選択されます。

説明と編集中のフィールドでは、ブラウザー自身のメニューが使われるため、そこでコピー、貼り付け、スペルチェックができます。⌥ / Alt+右クリックで、どこでもブラウザーのメニューを表示します。

クイック追加

クイック追加を使うと、ツールバーを使わずに要求を続けて入力できます。ドキュメントの下のバーには、クイック追加、節の一覧、テキストフィールド、追加があります。節の一覧には、ドキュメントの末尾と、最上位の節ごとの Under {number name} があります。

要求を入力して Enter を押すか、追加をクリックします。新しい項目には次のものが付きます。

  • 現在のクラス。
  • 説明としてのテキスト。
  • 「shall」「must」「will」「should」の後の最初の語から作った名前:最大 5 語、タイトルケース。

フィールドには最大 2,000 文字まで入力できます。フィルターまたは並べ替えがオンの間、フィールドには「Clear the filter or sort to add entities」と表示されます。

インスペクター

選択した項目は、完全なエンティティパネルとともに右側のインスペクターで開きます(モデルとデータベースを参照)。

  • ドキュメント内では、decomposed by と decomposes の関係はそこでは読み取り専用です。アウトラインがそれらを管理するためです。
  • ヘッダーの ×(Esc)で選択を解除します。表示 ▾ → 子を折りたたむは、選択した項目の下の節を折りたたみます。
  • ロックされた項目は読み取り専用で開きます。

項目の追加

新しい項目

  • + New {Class} は末尾に追加します。
  • + 後は選択した項目の後に追加します。
  • + 子は選択した項目の最後の子を追加し、親が展開されます。
  • 選択がない場合、+ 後と+ 子は末尾に追加します。

新しい項目には「New {Class}」という名前が付きます。その項目が選択され、名前が編集可能になります。

その他のクラス

その他のクラス…を選ぶと、クラス(任意のクラス)と名前のあるドキュメントに項目を追加が開きます。Statement 以外の項目(たとえば Asset の説明や、テスト計画書内の Test Case)に使います。

Heading を使った構造化ドキュメント

見出し(Heading)はドキュメントの節です(LML 2.0 の構造化アーティファクトの手法)。節に複数のクラス(たとえば要求、アクション、リスク)が混在する場合や、同じ要求が複数のドキュメントに現れる場合に Heading を使います。

  1. クラスのメニュー(+ 新規 ▾、+ After ▾、+ Child ▾)で見出しを選択します。最上位の Heading は、ドキュメントがその source of です。別の Heading の下では、番号付きの下位の節になります。
  2. Heading を選択し、+ Child ▾ で内容を追加します:任意のクラスの新しい項目、または既存の項目を追加…。Heading がその項目を contains します。
  3. 内容は自身の番号を保ちます:追加、移動、番号を振り直す…は Heading に番号を付け、内容の番号はそのままにします。そのため、RQ.CLN.1 のような要求はどのドキュメントでも同じ番号で表示されます。節の内容は下位の節より前に一覧表示されます。

内容を別の Heading に移動すると(ドラッグ、Move under ▸)、その contains リンクが移動します。モデルチェックは、Heading が contains する要求をドキュメントに配置されたものとして数えます。

要求の出所を記録するには、originated by で出所の Artifact にリンクします(インスペクター → 関係。Artifact 側では originates の下に一覧表示されます)。Heading より前に作成されたプロジェクトはそのスキーマを保ちます。スキーマ → Add New Built-ins…で Heading、contains、originates が追加されます。

CubeSat EO-1 デモの例:EO-1 System Requirements Specification の節 7 Applicable Documents は Heading です。その内容はプロジェクトの 2 つの規格で、番号 STD-1 と STD-2 を保っています。STD-1 は要求 3.4 Bus Regulation を、STD-2 は 5.2 UHF Command Uplink を originates します。

既存のエンティティ

既存の項目を追加…はエンティティのピッカーを開きます。ピッカーには、そのドキュメントとその現在の項目は含まれません。エンティティは分解全体とともに追加されます。子も一緒に追加される場合、トーストに「Added {entity} with N child entities」と表示されます。

構成を変える

インデント、インデント解除、移動

  • インデントは、項目をすぐ上の兄弟の最後の子にします。グループの最初の項目はインデントできません。
  • インデント解除は、項目を親の次の兄弟にします。
  • 上へ/下へ移動は、項目を隣の項目と入れ替えます。ロックされた項目とロックされた隣の項目は移動しません。
  • 移動できない場合、トーストに「The selected entity cannot move further that way.」と表示されます。

ドラッグ アンド ドロップ

アウトラインペインでドラッグします。上端または下端の近くまでドラッグすると一覧がスクロールします。ドロップする場所で結果が決まります。

  • 行の上部 28%:項目はその前に置かれます。
  • 行の下部 28%:項目はその後に置かれます。
  • 行の中央:項目はその子になります。
  • 上部のドキュメント名:項目は末尾の最上位の項目になります。

下に移動

項目を右クリックして下位へ移動 ▸を選択します。一覧には、その項目を子にできる項目がドキュメント順にインデントされて表示され、項目に親がある場合はドキュメントの最上位も表示されます。入力して一覧を絞り込み、新しい親を選択します。子も一緒に移動します。トーストに「Moved {item}」と表示されます。

一覧には、項目自身のサブツリー、現在の親、ロックされた項目、スキーマで許可されていない親は含まれません。移動に失敗した場合は「The item cannot move there: the new parent is inside it, or the item is locked. Choose another parent or unlock it.」と表示されます。

番号付け

自動の番号振り直し

項目の追加や移動の後に自動で番号を振り直すは既定でオンです。書く ▾ → 番号を振り直す…で変更します。オンの間は、追加、移動、インデント、インデント解除、除去、分割の操作で、影響を受ける兄弟グループとすべての子孫の番号が振り直されます。

  • 最上位の項目には、ドキュメントの番号パターンと連番が付きます。連番はドキュメントの最初の番号から始まります:番号を振り直す…で変更しない限り 1 です。
  • 子には、親の番号、ピリオド、連番が付きます(3、3.1、3.1.1)。
  • ロックされた項目と用語集の項目(Acronym のラベルが付き、番号が用語である項目)は番号を保ちますが、位置は占めます。

オフの場合:

  • 新しい項目には、直前の項目の次の番号が付きます。最初の子には親の番号に .1 を付けた番号が付きます。
  • 既存の番号は変わりません。
  • 項目を移動すると、移動したサブツリーだけの番号が振り直されます。
  • 上へ/下へ移動は 2 つの番号を入れ替えます。

次の番号のルール

連番を続けるには、直前の番号の最後の部分を 1 つ増やします。区切り文字と、末尾のピリオド、コロン、かっこは保たれます。

  • 数字:1.9 → 1.10、2. → 3.
  • 英字:a → b、z → aa、Z → AA、Appendix A → Appendix B
  • 2 文字以上のローマ数字:IV → V、IX → X。1 文字の場合は英字として数えます(I → J)。
  • それ以外には .1 が付け加えられます。

番号を振り直す

書く ▾ → 番号を振り直す…は、ドキュメント全体の番号を 1 ステップで振り直します。項目の右クリックメニューのここから番号を振り直す…は、その項目、その後の兄弟、それらのすべての子の番号を振り直します。

ダイアログには次のものがあります。

  • パターン:{n} は位置で、{n:3} は 3 桁にゼロ埋めします。SYS-{n:3} では SYS-001、SYS-002 となり、その子は SYS-001.1、SYS-001.2 のように下に番号が付きます。{n} のないパターンでは、末尾に番号が付きます。項目から開いた場合、パターンと最初の番号はその項目の番号からあらかじめ入力されます。
  • 最初の番号(数字のみ)。それ以外を入力すると「Enter the first number as digits, for example 1.」と表示されます。
  • Item、Current、新規のプレビュー表(変更される番号は強調表示。最大 400 行)と、「12 of 40 numbers change.」のような件数。
  • 項目の追加や移動の後に自動で番号を振り直す(ドキュメント全体のみ)。
  • 注記「Locked items keep their numbers. Renumbering is one undo step.」(ロックされた項目は番号を保ちます。1 回の元に戻すで番号の振り直し全体を取り消せます。)用語集の項目も番号を保ちます。
  • 番号を振り直す。トーストに「Document numbers updated」と表示されます。

ドキュメント全体で実行すると、パターンと最初の番号がドキュメントとともに保存されます。以後の自動の番号振り直しではそれが使われます。

ドキュメントの番号付け(メタ番号)

ドキュメントの番号付けでは、ドキュメントごとに別の番号を保持します。同じ要求が 2 つのドキュメントに異なる番号で現れる場合に使います。

納品 ▾ → 納品物の設定… → 番号付け → ドキュメント番号(このドキュメントのみに保持)でオンにします。モデル番号(項目自身の番号)でオフにします。

  • オンにすると、各項目の現在の番号がドキュメントにコピーされます。
  • 以後、番号を編集しても変わるのはこのドキュメントだけです。
  • オンの間、表題欄に「· numbered per document」と表示されます。
  • エクスポートとレポートではドキュメントの番号が使われます。

テンプレート

テンプレートは 4 か所から提供されます。新しいドキュメントとテンプレートを使用では、この順に、このドキュメントの種類のテンプレートを先にして一覧表示されます。

グループ保存場所追加・変更できる人
Organization templates: {name}Holarch サーバー(ホスト型またはセルフホスト型)上、組織用組織の管理者
プロジェクトのテンプレートプロジェクトファイル内。プロジェクトのすべてのメンバーに表示されますプロジェクトのオーナー(デスクトップアプリでは、プロジェクトを開く人なら誰でも)
組み込みテンプレートHolarch 内誰も変更できません
このブラウザーに保存済みこのブラウザーのみ(バージョン 1.8.0 より前に保存されたテンプレート)プロジェクトにインポートします

組み込みテンプレート

各組み込みテンプレートには、最初から表(たとえば Revision History と Approvals の表)が入った番号付きの節があります。記述ガイダンスを含めるを選ぶと、各節の先頭に短い記述ガイドも入ります。

新しいドキュメントには各テンプレートの節の数が表示されます。たとえば Requirements Specification では「39 sections」です。

テンプレートは、ドキュメントの種類ごとのシステムズエンジニアリングの一般的な実務に沿っています:ステークホルダー、システム、ソフトウェア、インターフェースの要求仕様書、インターフェース管理文書、アーキテクチャ記述、検証と妥当性確認、テスト計画とリスク計画、テスト手順書とテスト報告書、トレードスタディ、構成管理。

多くの節には、ドキュメントを表示またはエクスポートするたびにモデルから更新されるライブブロックがあります。

ブロック含まれる製品
ドキュメント自身の要求の VCRM、レベル別 VCRM、RVTM、RTM要求仕様書(Verification と Traceability の節)
プロジェクト全体の VCRM と RVTMTest Plan、Verification and Validation Plan、Test Procedure、Test Report
インターフェースマトリックスとコンジットの一覧Interface Control Document、Architecture Description
割り当てマトリックス(機能からコンポーネントへ)Concept Definition、Architecture Description
Acronym ラベルの付いたステートメントすべての Acronyms 節
Reference ラベルの付いたアーティファクトすべての References 節
リスク、Trade Study のアーティファクトRisk Management Plan、Trade Study Report

「this document」を対象とするマトリックスは、新しいドキュメントを指します。Test Report では、Insert ▸ マトリックス… ▸ Test Report でテストサイクルの結果を追加し、テストスイートとサイクルを選択します。

ドキュメントをテンプレートとして保存する

ドキュメントの構造をテンプレートとして保存し、そこから新しいドキュメントを始めます。

  1. 書く ▾ → テンプレート ▸ テンプレートとして保存…を選択します。

    Save {Type} as Template が開きます。

  2. テンプレート名を入力します。
  3. 保存先で次のいずれかを選択します。
    • このプロジェクト:プロジェクトのすべてのメンバーが使えます。この選択肢はプロジェクトのオーナーにだけ表示されます。
    • Organization: {name}(Holarch サーバー、組織の管理者):組織のすべてのメンバーが使えます。Make it the organization's default for {Type} にチェックを入れると、新しいドキュメントであらかじめ選択されます。
  4. テンプレートにファイルと画像を残す場合は、ファイルと画像を含めるにチェックを入れます。
  5. 保存をクリックします。

テンプレートには、各項目のクラス、名前、番号、説明、レベル、ラベル、通常の属性値が保存されます。品質結果は含まれません。保存したドキュメントを対象とするマトリックスは、テンプレートを適用すると新しいドキュメントを対象にします。

どちらの種類も保存できない場合はダイアログにその旨が表示されます。プロジェクトのオーナーまたは組織の管理者に依頼してください。

テンプレートを管理する

書く ▾ → テンプレート ▸ テンプレートを管理…には、プロジェクトのテンプレートが一覧表示されます。オーナーは名前を変更とRemove ができます。除去したテンプレートは元に戻すで復元できます。テンプレートから作成したドキュメントは変わりません。

組織の管理者は、組織設定 → ドキュメントテンプレートで組織のテンプレートを管理します:組織を開き、ドキュメントテンプレートでテンプレートの名前を変更し、既定のオン・オフを切り替え(ドキュメントの種類ごとに既定は 1 つ)、または除去します。

このブラウザーに保存されたテンプレート

バージョン 1.8.0 より前は、カスタムテンプレートはブラウザーに保存されていました。プロジェクトのオーナーが初めてテンプレートの一覧を開くと、それらをプロジェクトにコピーするよう提案されます:プロジェクトにインポートまたは後で。それまではこのブラウザーに保存済みの下に一覧表示されます。テンプレートを管理…には、それらのためのプロジェクトにインポートとブラウザーから除去があります。

既存のドキュメントにテンプレートを適用する

書く ▾ → テンプレート ▸ テンプレートを適用…を選ぶと、ドキュメントの種類、テンプレート、このドキュメントをテンプレートとして保存…、テンプレートを管理…のあるテンプレートを使用が開きます。

適用は、テンプレートの節を番号と入れ子とともにドキュメントの末尾に追加します。トーストに「Added N sections.」と表示されます。元に戻すで除去されます。

リッチテキストエディター

リッチテキストエディターは、書式、表、画像、ライブコンテンツ付きの説明を編集します。説明(またはドキュメントの説明)をクリックして編集します。キーボードからは、Tab で説明に移動して Enter または F2 を押します。スクリーンリーダーは、項目名の付いたテキストフィールド(「Description of 1.2 Power Budget」)として読み上げます。

エディターはその場で開き、ツールバー、単語数と文字数のカウンター(「words: N · chars: N」)、ヒント「⌘↩ / Ctrl+Enter save · Esc cancel · Tab leave」が表示されます。

  • 保存するには、⌘↵ / Ctrl↵ を押すか、✓ をクリックするか、エディターの外側をクリックするか、Tab を押してエディターを離れます。
  • キャンセルするには Esc を押します。フォーカスは説明に戻ります。
  • 保存はそれぞれ 1 回の元に戻すで取り消せます。
  • Tab はインデントに使われないため、エディターから抜け出せなくなることはありません。リストのインデントには ⌘ / Ctrl+] / ⌘ / Ctrl+[ または ⇤ / ⇥ を使います。

ツールバー

ボタン機能
+挿入メニュー:✦ AI で作成…、画像…、代替テキスト…(テキストに画像がある場合)、Table…、コードブロック、Line、リンク…、ドキュメントへのリンク…、ファイル…、ダイアグラム…、ライブ値…、件数または合計…、ライブテーブル…、マトリックス…、相互参照…、記号…、テキストにダイアグラムの画像がある場合はダイアグラムの図版を更新
✦AI テキストツール(下記を参照)
¶ ▾段落スタイル:Text、見出し 1~見出し 4、引用、コードブロック
B / I / U太字(⌘B / Ctrl+B)、斜体(⌘I / Ctrl+I)、下線(⌘U / Ctrl+U)
⋯Underline (⌘U / Ctrl+U)、取り消し線、上付き、下付き、インラインコード、ハイライト、Clear formatting (⌘⇧M / Ctrl+Shift+M)
• / 1.箇条書き(⌘⇧8 / Ctrl+Shift+8)/ 番号付きリスト(⌘⇧7 / Ctrl+Shift+7)
⇤ / ⇥インデント解除(⌘[)/ インデント(⌘])
≡ ▾配置:左揃え、中央揃え、右揃え、両端揃え
▦表を挿入…と、表の中では表の操作
🔗リンク(⌘K / Ctrl+K)
A文字の色と背景の色見本(それぞれ 10 色)と色を除去
Aa選択範囲のフォント(Arial、Brush Script MT、Comic Sans MS、Garamond、Georgia、Helvetica、Impact、monospace、Times New Roman)とサイズ(10~60 px)
↶ / ↷エディター内での元に戻す(⌘Z / Ctrl+Z)/ やり直す(⇧⌘Z / Ctrl+Shift+Z)
</>HTML ソース(⌘/ / Ctrl+/)。戻すとソースはサニタイズされます
⤢全画面表示。Esc を押すと、まず全画面表示が終了します
✓保存(⌘↵ / Ctrl↵)

フォント、サイズ、選択範囲を囲むスタイルには選択範囲が必要です。選択範囲がない場合、トーストに「Select some text first.」と表示されます。

表

表を挿入では、行(既定 2)、列(既定 3)、見出し行(オン)を指定します。Tab と Shift+Tab でセル間を移動します。最後のセルで Tab(または最初のセルで Shift+Tab)を押すと、エディターを離れます。

表の中で ▦ をクリックするか、セルを右クリックすると、表の操作が表示されます。

  • 上に行を追加、下に行を追加、左に列を追加、右に列を追加。
  • 見出し行を追加、キャプションを追加、右のセルと結合。
  • 行を削除、列を削除、見出し行を除去、キャプションを除去、表を削除。

画像とファイル

  • 画像…は、画像ファイルを図として挿入します。画像を挿入ダイアログでは、代替テキスト(画像の内容)、または情報を追加しない画像の場合は装飾(代替テキスト不要)を指定します。
  • 画像を貼り付けたり、画像ファイルをエディターにドロップしたりすることもできます。この場合は代替テキストなしで始まり、トーストに「Image added without alt text. Add it with the + menu (Alt Text…).」と表示されます。
  • 画像のアドレス(.png、.jpg、.jpeg、.gif、.webp で終わるもの)を貼り付けると、画像が挿入されます。
  • 長辺が 4,000 px を超える画像は、収まるように縮小されます。通知には「Image reduced to W × H px (the limit is 4000 px on the longest side).」と表示されます。
  • ファイルごとの上限を超える画像ファイルは、幅 1,600 px の JPEG として描き直されます。それでも大きすぎる場合は、トーストに「画像が上限の N MB を超えています。」と表示されます。
  • ファイル…は、任意のファイルを種類のアイコン付きのダウンロードリンクとして添付します。上限を超えるファイルには「File exceeds the N MB limit.」と表示されます。

代替テキスト

代替テキストは、スクリーンリーダー向けと Word のアクセシビリティチェックで画像を説明します。

  • + → 代替テキスト…には、テキスト内のすべての画像が代替テキストとDecorative のボックスとともに一覧表示されます。代替テキストのない画像や、代替テキストがファイル名である画像には警告が表示されます。
  • 画像をダブルクリックするか、右クリックして代替テキストを編集…を選ぶと、その画像だけを編集できます。
  • ダイアグラムの画像(ダイアグラム…)の代替テキストは、キャプション(ダイアグラムの種類とエンティティ名)から取られます。
  • Word 出力では、代替テキストが各画像の説明に書き込まれます。装飾の画像には装飾の印が付きます。
  • リンク…(リンクを挿入)では、URL と Text を指定します。http:、https:、mailto:、# のないアドレスには https:// が付きます。リンクは新しいタブで開きます。
  • ドキュメントへのリンク…(ドキュメントリンクを挿入)は、別のドキュメントにリンクします。ドキュメント、バージョン(Current または Baseline: {name})、Text を指定します。
    • Word 出力では、この方法でリンクしたドキュメントを付録として追加できます。
    • 他のドキュメントがない場合、トーストに「This project has no other documents. Create one first.」と表示されます。

ライブコンテンツ

ライブコンテンツは、テキストが表示される場所(ドキュメント、インスペクター、エクスポート、検索)のどこでもモデルに合わせて最新の状態に保たれます。

  • ダイアグラム…(ダイアグラムを挿入):ダイアグラムの種類とエンティティ(またはホワイトボードやフレーム)を選択します。ダイアグラムにリンクする、キャプション付きのダイアグラムの画像が挿入されます。
    • 画像はライブです。モデルが変更されると、少ししてドキュメントに新しい画像が表示され、Word などのエクスポートでは新たに描画されます。
    • 現在の画像を保持するには、エディターで図をダブルクリックし(ダイアグラムの図版)、モデルが変更されたら画像を更新をオフにします。図はスナップショットになります。
    • ダイアグラムの図版を更新(+ 内)は、テキスト内のすべてのライブの図を今すぐ描き直します。
    • ダイアグラムのエンティティが削除されると、図は最後の画像を保ちます。
  • ライブ値…:エンティティと属性を選びます。エディターにはその「Live value」が表示されます。属性を変更するには、ライブ値をダブルクリックします(ライブ値を編集)。
  • 件数または合計…は、モデルから再計算される数値を挿入します。エグゼクティブサマリーや、「12 of 40 requirements are verified」(2 つの件数)のような状況を示す行に使います。フィールド:
    • クエリ:数えるエンティティ。たとえば class:Requirement AND Requirement:"Status=Approved"。検索構文を参照してください。
    • 範囲:プロジェクト全体、このドキュメント、または別のドキュメント。範囲としてのコンパイルは、そのすべての部分を対象にします。
    • Function:Count、合計、平均、最小値、Maximum。Count 以外では、Cost の Amount のような数値属性を指定します。合計する数値がない場合、値は N/A になります。
    • 現在の値。後で件数を変更するには、ダブルクリックします。
  • マトリックス…は、ライブの RTM、RVTM、VCRM、割り当て、その他のマトリックスを挿入します。ドキュメント生成を参照してください。
  • ライブテーブル…は、クエリによるエンティティの表を挿入します。行は、テキストが表示またはエクスポートされるたびに再計算されます。フィールド:
    • クエリ。たとえば class:Requirement AND label:"Functional Requirement"。既定は order:modified- です。検索構文を参照してください。
    • 範囲:プロジェクト全体、このドキュメント、または別のドキュメントやコンパイル。
    • 列(順番):既定は Number、Name。+ 属性を追加…は属性の列を追加します。+ 関係の列を追加…は、関連するエンティティを一覧表示する列(たとえば検証元)を追加します。
    • 上限:既定は 10。すべての行は一致するものをすべて一覧表示します。
    • 最大 50 行のプレビュー。
    • 後でライブテーブルを変更するには、ダブルクリックします。
  • スプレッドシートの範囲…は、スプレッドシートのセルを表として、または選んだ種類のグラフ(またはシート自身のグラフのいずれか)として、キャプション付きで挿入します。スプレッドシート、シート、範囲を選び、必要に応じて従う共有ビューを選びます。表とグラフは現在の値を表示し、セルが変わると更新されます。Word などのエクスポートでは、エクスポート時点の値が使われます。範囲が削除されると、表は最後の行を保ち、見つからないものとして印が付きます。
  • 相互参照…(相互参照を挿入)は、開いているドキュメントの一部を現在の番号で参照します。
    • セクションまたは項目は、項目の番号と名前(たとえば「3.2 Frost Warning」)を表示します。Other entity…は、ドキュメント外のエンティティを選びます。
    • 図と表には、キャプションのあるドキュメントの図と表が「Figure 2」や「Table 1」として一覧表示されます。参照キーがまだないものを選ぶと、キーが追加されます。
    • テキストは番号の振り直しに追従します。Word 出力では、相互参照は Word がキャプション番号で更新するフィールドになります。ターゲットが削除された相互参照は、テキストを保ち、印が付きます。
  • 記号…は、次のいずれかを挿入します:± ° µ Ω ≈ ≠ ≤ ≥ × ÷ √ ∞ ∑ π Δ、矢印、• … — –、© ® ™ § ¶、€ £ ¥ ¢、½ ¼ ¾ ² ³、✓ ✗。

AI テキストツール

✦ は、選択範囲を、何も選択していない場合は現在の段落を書き直します。対象がない場合、トーストに「There is no text to rewrite.」と表示されます。

ツール:

  • 表現を改善、簡潔にする、スペルと文法を修正、短くする、詳細を追加、文を完成させる。
  • トーンを変えて書き直す…:Academic、Assertive、Casual、Confident、Constructive、Empathetic、Exciting、Fluent、Formal、Friendly、Inspirational、Professional。
  • 翻訳…とテキスト全体を翻訳…:アラビア語、中国語、英語、フランス語、ドイツ語、ギリシャ語、イタリア語、日本語、韓国語、ポルトガル語、ロシア語、スペイン語、スウェーデン語、ウクライナ語。
  • AI で作成…。

プレビューには、現在、提案、変更点が表示されます。置換、再試行、破棄のいずれかを選びます。

貼り付け

書式付きのテキストを貼り付けると、構造(見出し、リスト、表、リンク)が保たれます。クラス、インラインスタイル(表のセルを除く)、Office のマークアップは失われます。スクリプト、フレーム、安全でないリンクは、すべてのリッチテキストから除去されます。

リッチテキストのショートカット

キーAction
⌘↵ / Ctrl↵保存して閉じる
Escキャンセル(または全画面表示を終了)
⌘B / Ctrl+B / ⌘I / Ctrl+I / ⌘U / Ctrl+U太字 / 斜体 / 下線
⌘K / Ctrl+Kリンク
⌘⇧7 / Ctrl+Shift+7 / ⌘⇧8 / Ctrl+Shift+8番号付きリスト / 箇条書き
⌘] / ⌘[インデント / インデント解除
Tab / Shift+Tab次 / 前の表のセル。それ以外の場所ではエディターを離れる(保存されます)
⌘⇧M / Ctrl+Shift+M書式を除去
⌥⌘0 / Ctrl+Alt+0テキストの段落
⌥⌘1 / Ctrl+Alt+1 から ⌥⌘4 / Ctrl+Alt+4見出し 1 から見出し 4
⌘/ / Ctrl+/HTML ソース
⌘Z / Ctrl+Z / ⇧⌘Z / Ctrl+Shift+Zエディター内での元に戻す / やり直す

ドキュメント内を検索する

検索をクリックするか ⌘F / Ctrl+F を押して、ドキュメントを検索します。検索ボックスには「n of m」と表示されます。

検索の対象は、各項目の番号、名前、説明、表示中の列の値、品質チェックのメッセージです。フィルターで非表示になっている項目は対象外です。

  • Enter または ▼ で次の一致に移動します。
  • Shift+Enter または ▲ で前の一致に移動します。
  • Esc でテキストをクリアし、× でボックスを閉じます。

折りたたまれた節は、一致を表示するために開きます。一致する行は強調表示され、現在の行には印が付きます。

検索と置換

書く ▾ → 検索と置換…で検索と置換が開きます。次のものがあります。

  • 検索と置換。
  • 検索するフィールド:名前、Number、説明。Number は既定でオフです。
  • 大文字と小文字を区別と単語単位。

フィールドの下の行には「N entities match (locked entities are skipped).」と表示されます。すべて置換は、ドキュメントの項目内のすべての一致を変更します。1 回の元に戻すですべて取り消せます。トーストに「Updated N entities」または「No matches」と表示されます。リッチテキストではテキストだけが変わり、書式、リンク、表記はそのまま残ります。

書くメニュー

書く ▾には、内容を追加・変更するコマンドがあります。項目を追加するコマンドは、ベースラインの表示中、閲覧のみのアクセス、フィルターまたは並べ替えがオンの間は淡色表示になります。ツールチップに理由が表示されます。

アイテム機能
項目を追加 ▸Statement のクラスとその他のクラス…。選択した項目の後に、何も選択していない場合は末尾に項目を追加します。選んだクラスが現在のクラスになります。
既存の項目を追加…既存のエンティティを参照してください。
挿入 ▸選択した項目の説明にライブコンテンツを挿入します:ライブ値…、件数または合計…、ライブテーブル…、マトリックス…、ダイアグラムの画像…、スプレッドシートの範囲…、相互参照…。説明エディターがテキストの末尾で、選んだダイアログとともに開きます(ライブコンテンツを参照)。ロックされていない項目を選択するまで淡色表示です(「Select an unlocked item first」)。コンパイルでは、ドキュメント…と生成セクション…もあります(コンパイルを参照)。
✦ 要求を生成…選択した項目の下、またはドキュメント全体に対する AI ジェネレーター。結果はすべて、追加前にプレビューされます。
✦ 子要求を生成…Statement または要求を選択している場合:その新しい子。
✦ リスクを生成…項目を選択している場合:その項目のリスク。
✦ テストケースを生成…要求を選択している場合:それを検証するテストケース。
✦ Summarize…ドキュメントの先頭に置かれる、番号のない要約の項目を書きます。
✦ 翻訳…プレビュー付きで、ドキュメントのテキストを翻訳します。
検索と置換…検索と置換を参照してください。
番号を振り直す…番号を振り直すを参照してください。
テンプレート ▸テンプレートを適用…(テンプレートを適用する)、テンプレートとして保存…(ドキュメントをテンプレートとして保存する)、テンプレートを管理…(テンプレートを管理する)。

この分岐に属性を設定する

項目を右クリックしてこの分岐に属性を設定…を選ぶと、その項目とすべての子孫に 1 つの値を設定できます。ラベルを追加、ラベルを除去、または属性を選び、次に値を選びます。ダイアログには「Applies to {item} and its N descendants. Locked entities are skipped.」と注記されます。トーストに「Updated N entities (k locked skipped)」と表示されます。

複数の項目に分割する

項目を右クリックして複数の項目に分割…を選ぶと、複合要求を単一の要求に分けられます。ダイアログのタイトルは複数の項目に分割: {item}です。

  1. 文で分割または段落で分割と、その子として新しい項目またはその後に新しい項目を選びます。

    表には、部分ごとに 1 つの提案された項目が、番号、編集可能な名前と Text とともに表示されます。

  2. または、✦ 分割を提案をクリックすると、AI が単一の要求(最大 20 件)を提案します。
    • テキストに Web アドレスを含む行は、最初はチェックされていません。
    • 元の項目が承認済み、ベースライン化済み、またはロック済みの場合、そのテキストの置き換えはチェックなしの任意選択になります。
    • 差分で 1 行目と元のテキストを比較できます。
  3. 名前とテキストを編集します。結合は、部分を次の部分と結合します。
  4. 不要な部分のチェックを外し、適用をクリックします。

部分 1(「keeps」)は元の項目に残ります。チェックした各部分は、同じクラスと同じラベルを持つ新しい項目になります。番号は自動的に提案され、自動の番号振り直しがオンの場合は分割後に振り直されます。1 回の元に戻すで分割全体を取り消せます。トーストに「Split into N items」と表示されます。

チェックメニュー

チェック ▾には、このドキュメントで対応が必要なものが、右側の件数とともに一覧表示されます。

アイテム機能
品質をチェックドキュメント内で現在のフィルターを通るすべての要求をチェックし、結果を開きます。要求を選択している場合、項目はこの要求の品質をチェックになります。要求がない場合:「This document has no Requirements to check. Statements are not scored.」
このドキュメントのモデルチェック…このドキュメントのモデルチェックを開きます:ドキュメントとその項目に対するモデルチェックの指摘(ルール、項目、指摘)と、存在しないものを指すライブコンテンツ。項目をクリックすると選択されます。ない場合:「No findings for this document.」モデルチェックを開くは、プロジェクト全体のページを開きます。
トレースステータス…「N of M complete」と表示し、トレースステータスを開きます:まだ割り当てまたは検証されていない要求が、それぞれの点と不足しているもの(satisfied by、verified by)とともに表示されます。1 つクリックすると選択されます。RVTM を開くは RVTM ページを開きます。ドキュメントに要求がある場合に表示されます。
確認が必要なリンクこのドキュメントの確認するリンクを開きます。
TBD/TBR 登録簿このドキュメントの TBD/TBR 登録簿を開きます。
略語を検索…略語を見つけるを参照してください。
コメント未解決のコメントの数を表示し、インスペクターで開きます(コメントを参照)。

トレースステータス

各要求のバッジの後の点が、そのトレースステータスを示します。

  • 緑:要求が何かに satisfied by され(割り当て済み)、何かに verified by されています。
  • 琥珀色:2 つのうち 1 つが欠けています。
  • 赤:どちらのリンクもありません。

点にポインターを合わせると、ステータスと不足しているものが表示されます。たとえば「Trace status: Partly traced. Missing: no verified by link (not verified).」。クリックするとメニューが開き、満たす項目(割り当て)と検証元の下の項目(クリックすると開きます)、RVTM で開く、Relate To ▸ が表示されます。Statement やその他のクラスには点がありません。ベースラインでは、点はベースラインのリンクを示します。点をオフにするには表示 ▾ → トレースステータスを使います。

略語を見つける

チェック ▾ → 略語を検索…は、ドキュメントの番号、名前、説明にある略語を見つけ、1 つのレビュー一覧でその用語集の節に追加します。

  • 略語とは、2 文字以上の大文字からなる 8 文字以下の語で、すべてが数字ではないものです。
  • 展開形は、プロジェクトの既存の項目から、または頭文字がその用語を綴る隣接した語(「Concept of Operations」→ CONOPS)から得られます。
  • 各行には Keep、用語、展開形、使用箇所があります(「N uses」をクリックすると、出現する各場所が表示されます)。すでに「in the Glossary」にある用語、「entry exists in the project」の用語、「no expansion found」の用語には注記が付きます。
  • 展開形があり、まだ用語集にない用語は、最初からチェックが入っています。見出しのボックスで、すべてにチェックを入れるか外します。
  • テキスト内の各使用箇所を用語集の項目にリンク(ライブ値)(オン)は、説明内の各使用箇所を、項目の番号のライブ値にして項目にリンクします。

用語集に追加をクリックします。チェックした各用語は、ドキュメントの最上位の Glossary 節の下に、Number = 用語、Name = 展開形の、Acronym ラベル付きの Statement になります(Glossary または Acronyms という名前の既存の節が使われ、なければ末尾に追加されます)。プロジェクトにすでにある項目は、2 つ目を作らずに再利用されます。1 回の元に戻すですべて取り消せます。何も見つからない場合は「No acronyms in this document. Acronyms are words with two or more capital letters, such as CONOPS.」、何もチェックしていない場合は「Tick at least one term.」と表示されます。番号の振り直しでは用語集の項目は変わりません。

納品メニュー

納品 ▾は、成果物を設定してエクスポートします。出力ごとにまとめられています。

アイテム機能
納品物の設定…番号付け、表紙、ランニングヘッダー、署名欄(納品物の設定を参照)。
ページ設定…区分表示、表紙、ページ番号(ページ書式を参照)。
Word テンプレート ▸Word テンプレート。このドキュメントで使われているものに ✔ が付き、Word テンプレートを編集…もあります。1 つ選ぶと、このドキュメントのテンプレートになります。
バージョン ▸ベースラインを保存…と版を比較…(ベースラインを参照)。
Word:Word テンプレートごとに 1 つの {template} (Word)そのテンプレートのオプションで、ドキュメントを Word ですぐにダウンロードします。ドキュメント自身のテンプレートには「this document」と表示されます。ベースラインからの場合、出力はベースラインです。
アウトライン(Word)…見出しとしてのアウトライン。必要に応じて目次付き。
変更履歴版(Word)…変更履歴版を参照してください。ベースラインが必要です。
Excel: Traceability Matrix…Excel、Word、CSV、または Web ページとしての標準のマトリックス(ドキュメント生成を参照)。
変更(Excel)…ベースラインからそれより後のベースラインまたは現在のバージョンまでの変更。ベースラインが必要です。
Exchange: Requirements (ReqIF)…、ドキュメントのデータ(JSON)…交換形式(レポートを参照)。
印刷または PDF…印刷 / PDFを参照してください。
すべてのエクスポート…オプション付きのすべてのエクスポート(レポートを参照)。

Word テンプレート

Word テンプレートは、Word エクスポートのオプションとページの名前付きのセットです。内容ではなく Word ファイルの形を決めます(内容はドキュメントテンプレートが埋めます。テンプレートを参照)。各ドキュメントは 1 つを使い、既定は仕様書です。納品 ▾ → Word テンプレート ▸で選択します。

組み込みテンプレート:

テンプレートオプション
仕様レベル 3 までの目次、番号付きのキャプション、図目次と表目次、ベースラインからの改訂履歴と承認、付録としてのリンクされたドキュメント。ドキュメントに属性の列が表示されている場合は属性の列も含みます。
章ごとの納品物仕様書と同様ですが、キャプションは章ごとに番号が付き(図 3-1)、説明内の見出しが目次に含まれます。
レビュー用コピー横向きのページで、各項目の下にドキュメントの属性の列があります。目次はレベル 2 まで、前付けの表はありません。
標準タイトル、見出し、テキスト:目次、キャプション番号、前付けの表はありません。

すべての組み込みテンプレートは Letter のページを使います。

Word テンプレートを編集…で Word テンプレートが開きます。組み込みテンプレートにはコピーがあります。コピーはプロジェクトのテンプレートになり、すべてのメンバーのためにプロジェクト内に保存されます。プロジェクトのテンプレートを選択して、次のものを変更します。

  • 名前、ページサイズ(Letter (8.5 × 11 in) または A4 (210 × 297 mm))、向き(縦向きまたは横向き)。
  • 目次(なし、レベル 1、レベル 1~2、レベル 1~3、レベル 1~4、すべてのレベル)とキャプション番号(図 1、表 1、章ごと: 図 3-1、オフ)。
  • 図目次と表目次(キャプションがある場合)、説明内の見出しは目次に表示されます、ドキュメントに表示されている属性の列(各項目の下)、付録としてのリンクされたドキュメント、ベースラインからの改訂履歴と承認。
  • テンプレートを削除。

保存をクリックします(1 回の元に戻すで取り消せます。トーストに「Word templates saved.」と表示されます)。テンプレートが削除されたドキュメントは仕様書に戻ります。

会社の Word ファイル

プロジェクトのテンプレートには、組織独自の Word ファイル(.docx または .dotx、最大 5 MB)を持たせられます。その場合、エクスポートではファイルの次のものが使われます。

  • スタイル:フォント、色、見出しと本文のスタイル。ファイルにないスタイル(キャプション、目次の項目)は追加されます。ファイルの見出しの番号付けは削除されます。Holarch が見出しに番号を付けるためです。
  • ページ:サイズ、向き、余白。ファイルを選ぶと、テンプレートのページサイズと向きがそれに合わせて設定されます。
  • ヘッダーとフッター(ロゴとページ番号を含む)。それぞれにプロジェクトまたはドキュメントの区分表示が追加されます。
  • 表紙:ファイルの最初のセクション区切りより前の内容、セクション区切りがない場合はファイル全体。Holarch の表紙の代わりになります。

表紙とヘッダー・フッターでは、次のプレースホルダーが埋められます:{{Title}}、{{Type}}、{{Number}}、{{Version}}、{{Date}}、{{Project}}、{{Organization}}、{{Contract}}、{{CDRL}}、{{Prepared For}}、{{Prepared By}}、{{Baseline}}。大文字と小文字、スペースは区別されません。その他の波かっこ内のテキストは書かれたとおりに残ります。

追加するには:

  1. 納品 ▾ → Word テンプレート ▸ → Word テンプレートを編集…を選択します。
  2. 会社の Word ファイルの行の選択…をクリックするか、プロジェクトのテンプレートを選択して会社の Word ファイルの下の選択…をクリックします。
  3. ファイルを選択します。保存をクリックします。

置換…はファイルを入れ替え、Remove は Holarch のスタイルと表紙に戻します。Word ドキュメントではないファイルは「The file is not a Word document (.docx or .dotx).」として拒否されます。ドキュメントの外部に及ぶ内容は除外されます:リンクされた画像、埋め込みオブジェクトとコントロール、INCLUDETEXT、INCLUDEPICTURE、DDE、LINK、IMPORT のフィールド。マクロは読み込まれません。

テンプレートのページは用紙ビューの幅も決めます:Letter のページは幅 816 px、A4 は 794 px で、横向きではさらに広くなります。すべてのエクスポート… → Document (Word) では、オプションはドキュメントのテンプレートから始まります。そこでの Word テンプレートは別のテンプレートからオプションを埋め、1 回のエクスポートについて変更することもできます。

表示メニュー

表示 ▾には、このドキュメントの直接の切り替えがあります。

  • 用紙(オンのとき ✔):属性の列なしで、Word テンプレートのページと同じ幅のページとしてドキュメントを表示します。Requirements Document は最初はオフ、その他の種類は最初はオンです。
  • アウトラインペイン:アウトラインペインを表示または非表示にします。
  • トレースステータス:トレースステータスの点を表示または非表示にします。既定でオンです。
  • 列 ▸(用紙ビューでは淡色表示):ドキュメント内のクラスのすべての属性と項目のフィールド(Class、Number、Created On、Modified On、Labels)。表示中の列には ✔ が付きます。1 つ選ぶと表示・非表示が切り替わります。新しい列は末尾に追加されます。既定の列は Status、Verification Method、品質スコアに戻します。
  • すべて折りたたむ、何かが折りたたまれているときはすべて展開。
  • 子を折りたたむ:選択した項目の下の節を折りたたみます(下位の節を持つ項目を選択するまで淡色表示)。
  • 表示をリセット:折りたたみ、フィルター、並べ替え、検索をクリアします。また、アウトラインペインを既定の幅で表示し、列の幅をリセットし、既定の列に戻します。
  • 開く場所 ▸:選択した項目を、何も選択していない場合はドキュメントを、別のビューで開きます:項目ビュー、履歴…(フィールドごとの単語単位の差分付きの、記録されたすべての変更)、それを表示できるダイアグラム、トレーサビリティマトリックス(ドキュメントを行の軸として)、要求の品質(ドキュメントに範囲を限定)、機能分析。
  • ヘルプ。

列の見出しを右クリックすると、左へ移動、右へ移動、列を非表示が表示されます。

列はドキュメントごとにこのブラウザーに記憶されます。最後の選択が、まだ設定していないドキュメントの出発点になります。用紙とトレースステータスはドキュメントとともに保存されます。行を選択しても、横スクロールの位置はそのまま保たれます。

ベースライン

表題欄のバージョン ▾には、現在のバージョン、このドキュメントのベースライン、プロジェクトのベースラインの下にプロジェクトのベースラインが一覧表示されます(それぞれ日付付き。表示中のものに ✔ が付きます)。最後にベースラインを保存…と版を比較…があります。納品 ▾ → バージョン ▸にも同じ 2 つのコマンドがあります。

ベースラインを作成する

  1. バージョン ▾ → ベースラインを保存…をクリックします(ベースラインの表示中は淡色表示:「先に現在のバージョンに戻ってください」)。

    ベースラインを保存が、注記「The baseline keeps this version of the document (its items, their attributes and relationships) to view, compare and restore later. Approval records are dated now and cannot be edited afterwards.」(ベースラインは、後で表示、比較、復元できるよう、このバージョンのドキュメント(項目、その属性と関係)を保持します。承認記録には現在の日付が付き、後から編集できません。)とともに開きます。

  2. 名前(必須)を入力します。既定は「{document} Baseline N」です。
  3. 承認の下で、承認者ごとに 1 行ずつ名前、役割、Statement を入力します。最初の行にはあなたの名前があらかじめ入っています。既定の記述は「Approved for release.」です。
  4. 行を増やすには+ 承認者を追加を、行を除去するには × をクリックします。名前のない行は無視されます。
  5. 作成をクリックします。

    トーストに「ベースラインを保存しました」と表示されます。

ベースラインを表示する

バージョン ▾でベースラインを選択します。バナーに「Baseline “{name}”, read-only, saved {date}」(プロジェクトのベースラインでは「· project baseline」付き)と承認者が表示されます。次の操作ができます。

  • 現在に戻る:作業コピーに戻ります。
  • 編集(ドキュメントのベースライン):ベースラインを編集を開きます。ベースラインの名前を変更するか、承認を追加の下で承認記録を追加します。「New records are dated now and added to the list. Existing records cannot be changed.」(新しい記録には現在の日付が付き、一覧に追加されます。既存の記録は変更できません。)
  • 現在と比較(ドキュメントのベースライン):このベースラインからバージョンを比較を開きます。
  • ベースラインを復元:「Overwrite this document's entities, order and structure with baseline "{name}"? Entities added since are removed from the document (not deleted). Undo is available.」(このドキュメントのエンティティ、順序、構造をベースラインで上書きしますか。その後に追加されたエンティティはドキュメントから除去されます(削除はされません)。元に戻せます。)と確認します。
    • プロジェクトのベースラインではプロジェクトをベースラインで置き換えが開きます:「Replace the entire project with project baseline "{name}"? Undo is available.」(プロジェクト全体をプロジェクトのベースラインで置き換えますか。元に戻せます。)
  • 削除:「Delete baseline "{name}"?」(ベースラインを削除しますか。)と確認します。

ベースラインでは、編集、クイック追加、構造のツールがオフになり、アウトラインに 🔒 が表示されます。納品 ▾はベースラインから出力を作成します(「Export (baseline “{name}”)」)。

ベースライン内のライブコンテンツは、画面上でも出力でもベースラインのモデルを表示します:ライブ値、件数と合計、ライブテーブル、マトリックス、相互参照はスナップショットに対して解決され、ダイアグラムの図はベースラインとともに保存された画像を保ちます。ドキュメントのベースラインは、ドキュメント、その項目、1 つの関係の先にあるエンティティを保持するため、その中の件数や表はそれらのエンティティを対象にします。ベースライン外のエンティティのライブ値は、その現在の値を表示します。

バージョンを比較する

バージョン ▾ → 版を比較…でバージョンを比較が開きます。From(ベースライン)と To(それより後のベースラインまたは現在のバージョン)を比較します。ベースラインがない場合は「This document has no baseline. Save one first.」と表示されます。

「N changes」が、Number、名前、種類を変更、フィールド、変更とともに一覧表示されます。変更されたテキストについては、変更に単語単位の差分が表示されます。

変更の種類:

  • Added と Removed。
  • Modified:フィールドは Name、Number、Description、Class、Image、または任意の属性です。
  • Label Added と Label Removed。
  • Relationship Added、Relationship Removed、Relationship Attribute。

変更(Excel)は、Number、Name、Class、Change Type、Field、Old Value、New Value の列でダウンロードします。変更履歴版(Word)は、同じ比較を Word の変更履歴版としてダウンロードします(変更履歴版を参照)。

レポート

納品 ▾は、ドキュメントを Word、PDF、スプレッドシートなどの形式にエクスポートします。{template} (Word) の項目はすぐにダウンロードします(Word テンプレートを参照)。Word の各項目には、名前の下に 1 行の説明があります。メニューの末尾にあるドキュメントを削除…は、ドキュメントを(必要に応じて、ほかのどのドキュメントでも使われていない節とともに)削除し(ドキュメントの一覧を参照)、一覧に戻ります。アウトライン(Word)…、変更履歴版(Word)…、変更(Excel)…、要求(ReqIF)…、ドキュメントのデータ(JSON)…、印刷または PDF…は、その選択でエクスポートダイアログを開きます。すべてのエクスポート…は、最後に選んだもので開きます。

  1. 納品 ▾ → すべてのエクスポート…をクリックします。

    エクスポートが開きます。

  2. エクスポート形式でエクスポートするものを選びます。選択肢は「<content> (<format>)」という名前で、出力ごとにまとめられています:Word、Excel、CSV、Web ページ、テキスト、交換、印刷。
  3. オプションを設定します。
  4. ファイル名を編集します(最大 99 文字)。
  5. エクスポートをクリックします。

プレビューには、スプレッドシートのレポートの最初の 60 行が表示されます。その他のエクスポートでは「プレビューに表示されるのはスプレッドシートのエクスポートだけです。Excel エクスポートを選択してください。」と表示されます。レポートではドキュメントの番号が使われ、ベースラインではベースラインの内容が使われます。

レポート出力オプション
Document (Word)Word のドキュメント(Word 出力を参照)Word テンプレート(ドキュメントのテンプレート。別のものを選ぶと、以下のオプションがそこから埋められます)、目次を追加、目次の深さ 1~6、キャプション番号(図 1、表 1、章ごと: 図 3-1、表 3-1、オフ)、図目次と表目次(ドキュメントにキャプションがある場合)、説明内の見出しは目次に表示されます、ドキュメントに表示されている属性の列を含める、リンクされたドキュメントを付録として追加、改訂履歴と承認の表をベースラインから作成。既定値はテンプレートから取られます。仕様書の場合:レベル 3 までの目次、単純なキャプション番号、目次類、表示されている場合の列、付録とベースラインの表はオン、見出しはオフ。ページサイズと向きはテンプレートのものです。
変更(Excel)2 つのバージョン間で追加、除去、変更されたすべての項目、属性、関係From(ベースライン。最初は最も古いものが選択されます)、To(現在のバージョンまたはベースライン)。ベースラインがない場合は「This document has no baseline. Save one first.」
Table (CSV)項目ごとに 1 行属性(列の順)(既定は Number、Name、Description と表示中の列。関連する項目を一覧表示する Relationship: {name} も指定可)、並べ替え(階層、Number、名前)
Comments (Excel)ドキュメントとその項目に対するコメントごとに 1 行。コメントの作成者付きクラス、名前、番号、説明を含める、日付、解決済み(すべてオン)
ドキュメントのデータ(JSON)再インポート用のドキュメントDirectly related entities(オフ)、コメント(オン)、ベースライン(オフ)、履歴(オフ)
アウトライン(Word)見出しのみ、番号付き目次を追加(オフ)
Document (Markdown)Markdown の見出しとテキストとしてのドキュメントなし
Document (Print or PDF)ブラウザーの印刷ダイアログ。そこで「PDF として保存」を選びますなし
変更履歴版(Word)Word の変更履歴付きのドキュメント(変更履歴版を参照)ベースラインから(最新のもの)、Target(それより後のベースラインまたは Current)
Quality findings (Excel)要求ごとに 9 行(基準ごとに 1 行)。メッセージと、緑の Yes または赤の No、最後に「Report score」その他の属性、作成日時、更新日時、グローバル ID を含める
Requirements (ReqIF)階層と、ドキュメント内の traced to、satisfied by、verified by、satisfies、verifies、traced from リンクを含む ReqIF XMLなし
RSM (Excel)Requirement → satisfied by の項目要求の属性(Number、Name)、Related entity attributes(Class、Number、Name、Description)
RTM (Excel)Requirement → traced to の項目RSM と同じ
RVM (Excel)Requirement → verified by の項目RSM と同じ
RVTM(Excel)Requirement → 検証する Test Case。ドキュメントのすべての行を含む要求の属性(Number、Name、Description、Verification Method(s))、Test Case の属性(Number、Name、Description、Status)
TVM (Excel)ドキュメント内の Test Case → それが検証する要求Test Case の属性(Number、Name、Status)、要求の属性(Number、Name、Description)
VCRM (Excel)要求 × 検証方法。X で表示要求の属性(Number、Name)、検証方法(すべて)
Traceability matrix (Excel)、(Word)、(CSV)、(HTML)ドキュメントまたはプロジェクト全体の標準のマトリックス(ドキュメント生成を参照)Matrix、Scope(このドキュメントまたはプロジェクト全体)

マトリックスのレポートでは:

  • リンクされた項目のない要求は赤で網掛けされます。VCRM では、方法のない要求が赤で網掛けされます。
  • 要求のセルは、関連する行にわたって結合されます。
  • 2 行の見出し行は固定されます。

Word 出力

Document (Word) は、次の順序で Word ファイルを作成します。

  1. 表紙(ページ設定でCover page、または納品物の設定でTitle pageがオンの場合)、それ以外の場合はタイトルと、種類と「No. {number}」を示す斜体の行。ベースラインからの場合、行に「Baseline: {name} ({date})」が加わります。区分表示の通知(ページ設定)は、タイトルの下のボックスに表示されます。
  2. 改訂履歴(Version、Date、Author、Changes):ドキュメントのベースラインごとに 1 行。古い順で、エクスポートするベースラインまで。
    • 最初の行は「Initial baseline」です。以降の行は「N added, N removed, N modified」または「No changes」です。
    • Author は、ベースラインの作成者またはその承認者です。
  3. 承認(Role、Name、Statement、Date):最新の(またはエクスポートする)ベースラインから。承認記録がない場合は、納品物の設定で予定された承認者に署名欄が付きます:Role、Name、Signature、Date と、署名用の空欄。
  4. ドキュメントの説明、続いて目次、List of Figures と List of Tables、改ページ。
  5. 各項目を、番号と名前付きの Word の見出しとし、続いてその説明。見出し 1~見出し 6 は深さに従い、それより深いレベルは見出し 6 のままです。Attribute/Value の表に、値のある選択した列が一覧表示されます。
  6. 付録:埋め込みリンクでリンクされた各ドキュメントは、新しいページで「{document} Appendix」とともに始まり、その内容が 1 レベル下に続きます。

生成される表は、先頭ではなく節の中に置くこともできます。ドキュメントに次のいずれかの名前の節がある場合です(組み込みテンプレートではこれらの名前を使っています)。

  • Revision History:「Revision History」または「Document Revision History」。
  • Approvals:「Approvals」「Approval」「Sign-off」「Signoff」「Signatures」「Signature」。

キャプション、リスト、相互参照

  • 図のキャプション(画像のキャプション、ダイアグラムの図)は、画像の下に「Figure 1: {caption}」と表示されます。表のキャプション(マトリックスブロックのタイトル、表のキャプション)は、表の上に「Table 1: {caption}」と表示されます。
  • 章ごとでは、最上位の節ごとに番号が付きます:「Figure 3-1」は節 3 の最初の図です。キャプションのない表には番号が付きません。
  • 番号は Word の SEQ フィールドで、List of Figures と List of Tables はキャプションに対する Word のフィールドです。これらは、ドキュメントに図または表のキャプションがある場合にだけ表示されます。Word がフィールドを更新するまで、一覧にはページ番号なしでキャプションが表示されます。
  • すべての見出し、図のキャプション、表のキャプションにはブックマークが付きます。説明内の相互参照はブックマークへの Word の REF フィールドになるため、Word がフィールドを更新した後は、現在の見出し(「3.2 Frost Warning」)またはラベル(「Figure 2-1」)が表示されます。エクスポートしたドキュメントにない項目への相互参照は、テキストを保ちます。
  • 説明内の見出しは目次に表示されますは、説明内の見出しを、項目の 1 レベル下の本物の Word の見出しにします。オフの場合は太字の段落のままです。

納品物の設定

納品 ▾ → 納品物の設定…には、契約上の成果物に通常記載されるデータがあります。適用で保存し、⌘Z / Ctrl+Z で 1 ステップで元に戻します。

フィールド表示される場所
番号付けモデル番号(項目自身の番号)(既定)またはドキュメント番号(このドキュメントのみに保持)(ドキュメントの番号付けを参照)。
表紙表紙をオンにします(ページ設定のCover pageと同じスイッチ)。
バージョン、作成者表紙とランニングヘッダー(ページ設定と同じフィールド)。
組織、提出先、契約番号、CDRL 項目、DID 番号表紙。CDRL 項目はランニングフッターにも表示されます。
ロゴ表紙の上部。PNG、JPEG、GIF、最大 400 KB。
表紙の通知表紙の下部のボックス。たとえば配布に関する記述。空の場合:ページ設定の区分表示の通知。
ランニングヘッダーとフッター既定でオン。ヘッダーには「{number}, Version {version}」とタイトルが、フッターには日付、「Page X of Y」、「CDRL {item}」が表示されます。ドキュメント番号またはバージョンが必要です。
予定された承認者承認者ごとの役割と名前。ベースラインに承認が記録されるまで、署名欄が付きます。

ドキュメント番号は、ドキュメントのタイトルの横にある番号フィールドです。

ページ書式

  • Word テンプレートのページ:US Letter または A4、縦向きまたは横向き。上下の余白は 1 インチ、左右の余白は 0.875 インチ。
  • Calibri 11 pt。
  • 本物の見出しスタイル。そのため Word のナビゲーションウィンドウと目次が機能します。
  • 表の見出し行は網掛けされ、各ページで繰り返されます。
  • ページのバナー(区分表示)は、表紙を含むすべてのページのヘッダーとフッターで繰り返されます。
  • 表紙がある場合、ファイルには 3 つのセクションがあります:表紙(バナーのみ。ランニングヘッダーとページ番号なし)、前付け(改訂履歴、承認、説明、目次と一覧。i、ii、iii の番号)、本文(1 から番号付け。「Page X of Y」は本文を数えます)。
  • Word はファイルを開くときにフィールドを更新するよう確認します。それまで、目次には「Right-click and choose Update Field to build the table of contents.」と表示されます。

リッチテキストの変換

  • 保持されるもの:太字、斜体、下線、取り消し線、上付き、下付き、インラインコード(Consolas)、ハイライト、文字の色、Web リンク。
  • 説明内の見出しは太字の段落になるか、上記のオプションで Word の見出しになります。
  • リストは、インデントされた「•」または「1.」の段落になります。
  • コードブロックは網掛けされた等幅の行になります。引用はインデントされた斜体になります。
  • 表は、結合された列と見出しの網掛けを保ちます。
  • PNG、JPEG、GIF の画像は、幅約 6.5 インチまでで埋め込まれ、代替テキストが画像の説明になります。SVG と WebP の画像は Word ファイルから除外されます。

変更履歴版

納品 ▾ → 変更履歴版(Word)…は、Word の変更履歴付きでドキュメントを書き出します。ベースラインからと Target(それより後のベースラインまたは Current)を選びます。バージョンを比較の変更履歴版(Word)は、そこに表示されている 2 つのバージョンについて同じことを行います。

  • ファイルは変更の概要の表で始まります:属性、ラベル、関係を含む、変更レポートのすべての変更です。
  • 続いて対象バージョンのドキュメント:追加された項目は挿入の変更履歴、除去された項目は削除の変更履歴としてその前の項目の後に置かれ、変更された名前や説明には削除された語と挿入された語が表示されます。
  • Word のReviewタブで変更を承諾または却下します。変更された説明はプレーンテキストとして表示され、変更されていない説明は書式を保ちます。
  • 変更は、対象のベースラインの作成者、または Current の場合はあなたの名前によるものとされます。

印刷または PDF…は、ブラウザーでドキュメントのページを印刷します。バナーは各ページの上部と下部に印刷されます。ランニングヘッダー(納品物の設定)がある場合、「{number}, Version {version}」とタイトルが各ページの上部に、日付と CDRL 項目が下部に繰り返されます。コンパイルでは、各パートが新しいページから始まります。ページ番号、目次、キャプション番号は Word 出力にのみあります。

コメント

項目へのコメントは、インスペクターのエンティティパネル(ディスカッションの部分)で行います。チェック ▾ → コメント、または表題欄の 💬 n open comments で、インスペクターにコメントが表示されます。

  • ドキュメントとその項目に対するすべてのコメントが、項目ごとにまとめられ、「(N open)」とともに表示されます。返信は、返信先のコメントの下にインデントされます。項目の名前をクリックすると選択されます。
  • 解決済みを表示は、解決済みのコメントを含めます。
  • 各スレッドの最初のコメントには解決/再オープンが、各コメントには ×(削除)があります。
  • ドキュメント自体にコメントするには、このドキュメントにコメント…に入力し、コメントを追加をクリックします。
  • 上部の × でコメントを閉じます。項目を選択すると、代わりにそのエンティティパネルが表示されます。
  • 未解決のコメントがある行には 💬 n が表示されます。クリックすると項目のディスカッションが開きます。
  • コメントの解決、再オープン、削除はどちらの場所でもできます。
  • すべてのエクスポート…の Comments (Excel) でまとめて取り出せます。

コメントとレビューを参照してください。

コンパイル

コンパイルは他のドキュメントをまとめます。レビューページまたはレビューパッケージを作成で新たに作成したものにはレビューパッケージのラベルが付きます。以前に作成したパッケージには Compilation のラベルが付き、同じように動作します。レビューを参照してください。

ドキュメントを挿入…はドキュメントを追加します。書く ▾ → 挿入 ▸と + 新規 ▾ メニューにあります。

  • まだ含まれていないドキュメントが一覧表示されます。
  • 挿入したドキュメントは、その内容を下に持つ最上位の項目として表示されます。トーストに「Inserted {document}」と表示されます。
  • 他のドキュメントがない場合は「No other documents to insert.」と表示されます。

生成セクション

生成セクションを挿入…(書く ▾ → 挿入 ▸と + 新規 ▾ メニューにあります)は、コンパイルが表示またはエクスポートされるたびにモデルから内容が作り直されるパートを追加します。

内容パートの内容
Matrix or Test Report…挿入でマトリックスを挿入が開きます。そこでマトリックス(または Test Report)とその範囲を選びます。範囲 Compilation (all parts) はすべてのパートを対象にします。マトリックス名を使うにはセクション名を空のままにします。
略語の一覧Acronym のラベルが付いたステートメントの表(Number、Name)。番号順。
クエリの表クエリに一致するエンティティの、指定した列(属性名、カンマ区切り)による表。

パートは最後のパートの後に番号が付くため、パートのドキュメントは番号を保ちます。⌘Z / Ctrl+Z で 1 ステップで除去します。名前がない場合は「Enter a section name.」、クエリまたは列のないクエリの表では「Enter a query and at least one column.」と表示されます。

Word でのコンパイル

コンパイルの Word エクスポートでは、最上位の各項目がパートとしてエクスポートされます。

  • パートの見出しは「Part A: {document}」(見出し 1)で、ドキュメントの種類、番号、固定されたベースラインを示す行が付きます。
  • パート内の節番号にはパートの文字が付きます:「A.1 Scope」「B.1 Scope」。節番号が重複することはありません。
  • 最初のパート以降の各パートは、新しいページから始まります。
  • 章ごとのキャプションでは、パート B の図は「Figure B-1」となります。

コンパイルの納品物の設定…には編集版のパートが加わります。

設定選択肢
パートのラベルパート A、パート B、…(既定)、第 1 巻、第 2 巻、…、付録 A、付録 B、…、パートのラベルなし
節番号パートごと、パートの文字または番号付き(A.1、B.1)(既定)、パートをまたいで連番(1、2、3)、ドキュメントごとに独自の番号を保持
各パートを新しいページから始める既定でオン
パートごとの表紙パートの見出しとその行を独立したページに置く
各パートのエクスポート元Current、またはパートのドキュメントのベースラインのいずれか。固定されたパートの行には 📌 とベースライン名が表示され、そのベースラインの内容がエクスポートされます。

AI ツール

上部バーの ✦ AI ▾ には、選択とドキュメントに対する AI ツールが一覧表示されます。AI の結果はすべてまずプレビューされ、1 回の元に戻すですべて取り消せます。ベースラインではツールは無効です。AIを参照してください。

  • 選択した Requirement または Statement:わかりやすく書き直し…、測定可能な基準を追加…(要求)、簡潔にする…、複合要求を分割…、根拠の下書きを作成…、名前を提案…、AI でチェック(この要求)…、子要求を生成…、テストケースを生成…(要求)。
  • 選択した任意の項目:リスクを生成…。
  • ドキュメント:要求を生成…、ドキュメントを要約…、ドキュメントを翻訳…、Check with AI (N requirements)…。

キーボードショートカット

キーAction
⌘F / Ctrl+Fドキュメント内を検索する
Enter / Shift+Enter次 / 前の一致(検索ボックス内)
⌘↵ / Ctrl↵選択した項目の後に項目を追加
⌥⌘↵ / Ctrl+Alt↵選択した項目の子を追加
⌥⇧→ / Alt+Shift+→ / ⌥⇧← / Alt+Shift+←選択した項目をインデント / インデント解除
⌥ / Alt+↑ / ⌥ / Alt+↓選択した項目を上 / 下に移動
↑ / ↓前 / 次の行を選択。フォーカスも一緒に移動
Tab次のフィールド:選択した行、続いてその番号、名前、説明
Enter / F2行ではその名前を編集。番号、名前、説明ではそれを編集
Delete または Backspace選択した項目をドキュメントから除去(メッセージで元に戻せます)
⇧Delete / Shift+Delete確認の後、選択した項目とその子を削除
Esc選択を解除。検索ボックスでは検索をクリア
Enter / Esc番号または名前の編集を保存 / キャンセル(フォーカスはフィールドに残ります)
アウトライン内での ↑ ↓ Home Endアウトラインの項目間を移動
アウトライン内での → / ←項目を展開 / 折りたたむ、またはその最初の子 / 親に移動
アウトライン内での Enter / Spaceドキュメント内で項目を開く(フォーカスがその行に移動)/ 選択する
⌘Z / Ctrl+Z / ⇧⌘Z / Ctrl+Shift+Z元に戻す / やり直す(エディターの外)

Windows と Linux では、⌘ / Ctrl に Ctrl を、⌥ / Alt に Alt を使います。行のショートカットは、どのフィールドにもフォーカスがないときに機能します。⌘↵ / Ctrl↵ と ⌥⌘↵ / Ctrl+Alt↵ は、番号や名前の編集中にも機能します。キーボードショートカットと、上記のリッチテキストのキーを参照してください。

このブラウザーに記憶される設定

このブラウザーに保存されるもの:

  • アウトラインペインが非表示かどうかと、その幅。
  • ドキュメントごとの列と列幅。
  • 一覧の並べ替え。
  • 新しい項目の現在のクラス。
  • 最後に使ったレポートの種類。
  • バージョン 1.8.0 より前に保存されたテンプレート(プロジェクトにインポートするまで)。

ドキュメントとともに保存され、プロジェクトの全員と共有されるもの:用紙、トレースステータス、Word テンプレート、ドキュメントの番号付け、番号パターンと最初の番号、自動の番号振り直し。プロジェクトの Word テンプレートはプロジェクトとともに保存されます。

メッセージ

メッセージ意味と対処法
ドキュメントなし / 「「+ 新しいドキュメント」でドキュメントを作成するか、「インポート」で Word、Excel、CSV、ReqIF をインポートしてください。」プロジェクトにまだドキュメントがありません。
「No documents match. Clear the search or choose All.」(一致するドキュメントはありません。検索をクリアするか、すべてを選択します。)Search documents… をクリアするか、すべてをクリックします。
ドキュメントが見つかりませんアドレスが削除されたドキュメントを指しています。ドキュメントに戻るを使います。
このドキュメントは空です / 「Add a requirement with “+ New Requirement”, or fill the document from a template with Write → Apply Template….」(「+ New Requirement」で要求を追加するか、書く → テンプレートを適用… でテンプレートからドキュメントを埋めます。)項目を追加するか、テンプレートを適用します。
「フィルターに一致する項目はありません。すべての項目を表示するには、フィルターをクリアしてください。」クラスとラベルのチップを変更またはクリアします。
フィルター適用中: 編集できません。フィルターをクリア / 「Clear the filter or sort to add entities」作成作業は一時停止しています。警告をクリックするとクリアされます。
「先にテキストを入力してください。」クイック追加が空のまま送信されました。
「The selected entity cannot move further that way.」(選択したエンティティはその方向にこれ以上移動できません。)項目が最初または最後にある、ロックされている、またはロックされた項目の隣にあります。
「An entity cannot go under its own child. Choose another parent.」(エンティティを自分の子の下に置くことはできません。別の親を選択してください。)項目のサブツリーの外にあるターゲットを選びます。
古い(品質スコア列)前回の品質チェック後にテキストが変更されました。もう一度実行します。
「ドキュメントテンプレートを読み込めませんでした。」テンプレートのカタログを読み込めませんでした。ページを再読み込みします。
「プレビューに表示されるのはスプレッドシートのエクスポートだけです。Excel エクスポートを選択してください。」プレビューは Excel のレポートでのみ機能します。
「This document has no baseline. Save one first.」(このドキュメントにはベースラインがありません。先に保存してください。)変更レポートを実行する前にベースラインを作成します。
「エクスポートに失敗しました: …。Word テンプレートを確認して、もう一度エクスポートしてください。」ワンクリックの Word エクスポートに失敗しました。Word テンプレートを編集…でテンプレートを確認します。
「画像が上限の N MB を超えています。」/「File exceeds the N MB limit.」(ファイルが上限の N MB を超えています。)ファイルがサーバーのファイルごとの上限を超えています。

制限事項

上限:ドキュメントの行で編集する名前は 200 文字まで、番号は 139 文字までです。クイック追加では 2,000 文字まで入力できます。

上限:画像は長辺 4,000 px に縮小されます。添付ファイルと画像は、サーバーのファイルごとの上限(Free プランで 10 MB、Individual で 25 MB、Team で 100 MB)とプロジェクトのストレージ容量によって制限されます。

上限:Word 出力に埋め込まれるのは PNG、JPEG、GIF の画像だけです。6 より深い見出しレベルは見出し 6 として表示されます。

上限:組織のテンプレートは Holarch サーバー(ホスト型またはセルフホスト型)にあり、デスクトップアプリにはありません。デスクトップアプリでは、プロジェクトのテンプレートをプロジェクトファイルに保存します。組織は、それぞれ最大 3,000 節のテンプレートを最大 200 件保持できます。あるプロジェクトに保存したテンプレートは、他のプロジェクトでは提示されません:テンプレートを組織に保存するか、もう一方のプロジェクトにもう一度保存します。