メインコンテンツまでスキップ

方法 1: Web アプリでレビュー

CoBrain の Web アプリを使って仕様書(要求仕様書)をレビューする方法を説明します。

事前準備

まだログインしていない場合は、ログイン方法を参照して Web アプリにログインしてください。

サンプル仕様書

このチュートリアルでは、以下のサンプル USDM を使って体験できます:

サンプル USDM をダウンロード

1. 仕様書を取り込む

主な画面構成

alt text

仕様書の取り込みには、以下の2つの方法があります:

  1. テキストでの取り込み - Excelからコピーしたテキストを貼り付けて取り込み
  2. Excelファイルでの取り込み - Excelファイルをアップロードして取り込み
カスタム取り込みをご利用のお客様

カスタム取り込みの手順はこちらをご確認ください。

テキストでの取り込み

Step.1

Excel からテキストをコピーします。

ラベルから仕様までをコピーします。 画像の例では、A2からE45セルまでをコピーします。

alt text

Step.2

テキストを貼り付けます。

alt text

Step.3

「取り込み」ボタンをクリックします。

alt text

Step.4

テキストが USDM に変換されシステムに取り込まれます。

alt text

取り込みに関する制約

仕様書を取り込む際、セルの先頭から連続するダブルクォーテーション(")と末尾に連続するダブルクォーテーション(")は正しく取り込めません。 一方で文字列の途中に現れるダブルクォーテーションは正しく取り込めます。

alt text

Excelファイルでの取り込み

Step.1

ファイルをアップロードします。アップロード方法は以下の2通りがあります。

「アップロード」ボタンからのアップロード

画面右側の「アップロード」ボタンをクリックし、ファイル選択ダイアログから取り込みたい Excel ファイルを選択します。

alt text

ドラッグ&ドロップでのアップロード

取り込みたい Excel ファイルを画面右側のドロップエリアにドラッグ&ドロップします。

alt text

Step.2

ファイルが自動的に USDM に変換され、編集画面に表示されます。

alt text

Excel ファイルの取り込みに関する制約
  • 対応ファイル形式: .xlsx, .xls
  • ファイルサイズ上限: 5MB
  • 複数のシートがある場合、先頭のシートのみが取り込まれます
  • 文字数上限: 15万文字
取り込み時にダイアログが表示されたときは?

取り込みに関するエラーをご確認ください。

2. 仕様書をレビューする

レビューを実行する

Step.1

レビューボタンをクリックします。

alt text

レビューコメントを確認し、仕様書を修正する

しばらくすると、画面の右側にレビューコメントが表示されます。実際の仕様書ではその内容に沿って記述の修正をします。

alt text

レビューコメントを検索・フィルタリングする

レビューコメントが多い場合、検索やフィルタリング機能を使って目的のコメントを絞り込むことができます。

alt text

キーワード検索

検索フィールドにキーワードを入力すると、タイトルまたは内容にそのキーワードを含むコメントのみが表示されます。

alt text

カテゴリーフィルタ

カテゴリーチップをクリックすると、該当するカテゴリーのコメントのみが表示されます。
各チップにはコメントの総件数と確認済み件数が表示されます。選択中のチップを再度クリックすると、選択が解除されます。

alt text

フィルタのリセット

「リセット」ボタンをクリックすると、すべてのフィルタ(検索、カテゴリー)がクリアされ、全コメントが表示されます。

alt text

3. 添削結果をエクスポートする

エクスポート

Step.1

CoBrain で添削した仕様書とレビューコメントをエクスポートします。「レビュー」ボタンの右にある「↓」ボタンをクリックします。 alt text

Step.2

Excelファイルがダウンロードできます。

Excelファイルがダウンロードできます。

ファイルの構成

ファイルを開くとこのように修正後の要求仕様書(USDM)の内容が出力されます。

alt text

レビューコメントの一覧は「レビューコメント」シートに出力されています。

alt text

複数シートレビュー

ベータ版機能

複数シートレビューはベータ版の機能です。今後のアップデートにより、仕様が変更される場合があります。

複数の仕様書シートを含む Excel ファイルをアップロードすると、すべてのシートをまとめて取り込み・レビューできます。

アクセス方法

サイドバーから「複数シートレビュー」をクリックして、複数シートレビューページを開きます。

alt text

取り込み

複数シートの Excel ファイルをアップロードすると、各シートの取り込み結果(成功・一部スキップ・失敗)がダイアログに表示されます。

alt text

取り込み後は画面上部のシートタブで各シートを切り替えられます。

alt text

レビュー

レビュー対象シートの選択

「対象シート」ボタンからレビュー対象のシートを選択できます。「すべて選択」で一括選択・解除も可能です。

複数シートレビューに関する制約
  • レビュー対象の合計文字数上限: 15万文字

alt text

シートフィルタ

シートチップをクリックすると、該当するシートのコメントのみが表示されます。 「シート全体」を選択すると、シート横断で検出されたコメントが表示されます。

alt text

エクスポート

各シートが元のシート名でワークシートとして出力されます。

alt text

「レビューコメント」シートに「シート名」列が追加されます。

alt text

カスタム取り込み

限定公開

カスタム取り込みは、一部のお客様に限定してご提供している機能です。

フォーマット情報を入力することで、CoBrain 対応フォーマット以外の仕様書を取り込むことができます。

モードの切り替え

取り込み画面で「カスタム」タブを選択します。

alt text

カスタム取り込みの手順

Step.1

テキストの貼り付け、または Excel ファイルをアップロードします。操作方法は標準モードと同じです。

Step.2

フォーマット情報の入力画面が表示されます。お使いの仕様書の中から、各 USDM 項目に対応するセル位置を指定します。

alt text

複数シートの Excel ファイルをアップロードした場合、シート選択ボタンから参照するシートを切り替えられます。

alt text

  1. タブで要求と仕様を切り替えます。要求はLv5まで追加できます
  2. 「要求」「要求の理由」「要求の説明」「仕様」などの項目ごとに、該当する行をそれぞれ指定します
  3. 各項目(ID・見出し・本文など)に対応する列をドロップダウンから選択します
フォーマット情報の入力について

必須項目(* マーク付き)はすべて指定する必要があります。

Step.3

「取り込み」ボタンをクリックすると、入力したフォーマット情報に基づいて USDM として取り込まれます。

フォーマット情報の保存・再利用

カスタム取り込みが完了すると、入力したフォーマット情報をブラウザに保存するかを確認するダイアログが表示されます。保存しておくと、次回以降のカスタム取り込み時に再利用できます。

alt text

保存済みのフォーマット情報がある状態でカスタム取り込みを実行すると、再利用を確認するダイアログが表示されます。「はい」を選ぶと保存済みのフォーマット情報で取り込みが実行され、「いいえ」を選ぶとフォーマット情報の入力画面が表示されます。

alt text