要件をインポート

Requirements Module で利用可能な Import Wizard を使用して、既存の要件データを Requirements Portal に素早く簡単にアップロードできます。

AI Assisted Requirements Importer

要件エンジニアリングは、多くの場合、PDF や Excel スプレッドシートなど、データが十分に構造化されていないドキュメントにステークホルダー要件を起草するところから始まります。こうした非構造化ドキュメントから要件データを手作業で抽出するのは手間がかかり、ミスも起こりやすくなります。Requirements Portal で要件を取り込むプロセスを迅速化するために、AI 機能を活用して、非構造化の PDF、Excel、Word、CSV ファイルから要件をインポートできます。

AI 支援 Importer 機能は現在ベータ版です。

Importer へのアクセス

AI Assisted Importer は Requirements Module()からアクセスできます。ページ左上の ボタンをクリックし、表示されるメニューから Create Requirement を選択します。または、現在表示している仕様に要件がない場合は、ページ上の Import ボタンをクリックして Importer にアクセスできます。

インポートの流れ

Importer にアクセスすると、Document Import ウィンドウが表示されます。AI Assisted Importer を続行するには、 ボタンをクリックします。

このウィンドウでは、必要に応じて open the legacy importer here リンクをクリックし、従来の Importer を使用することもできます。従来の Importer の使い方は、このページの下部にある described below に記載されています。

次のステージでは、サポートされている種類のファイル(*.pdf*.docx*.xlsx、または .*csv)をアップロードできます。アップロードするには、ウィンドウ内の該当領域にファイルをドラッグ&ドロップするか、select from your computer コントロールをクリックしてハードドライブから参照・選択します。

アップロード可能な最大ファイルサイズは 100 MB です。

アップロードするファイルは非構造化でも構いませんが、Excel template リンクから *.xlsx ファイルをダウンロードして、要件を構造化された形で取り込めるようにすることもできます。

ファイルが正常にアップロードされると、そのエントリがウィンドウに表示されます。 アイコンをクリックすると、ウィンドウから削除できます。あるいは、別のファイルをウィンドウにドラッグ&ドロップして、既存のファイルを置き換えることもできます。

 ボタンをクリックして次へ進みます。Importer がアップロードされたファイルを処理します。処理が完了すると、抽出されたデータが「提案要件」の表として表示されます。インポートしたい要件は、該当行の左側にあるチェックボックスを有効にして選択できます。

デフォルトでは、抽出された要件は Importer を起動した時点で表示していた仕様にインポートされます。Importer ウィンドウ上部のドロップダウンから対象の仕様を選択することも、ドロップダウンから As new (creates new specification) を選択し、表示される Specification name フィールドで新しい仕様名を定義して新規仕様を作成することもできます。

 ボタンをクリックして次へ進みます。インポートが完了すると、確認ウィンドウが表示されます。

Importer がインポートされた要件に問題を検出した場合、その旨がウィンドウ()に表示されます。リンクをクリックすると、検出された問題の理由を詳細に示すレポートをダウンロードできます。 

 ボタンをクリックして Importer のファイルアップロード段階に戻るか、 をクリックして Importer を終了します。

Legacy Importer

Importer にアクセスする際(learn more)、従来のインポートツールを使用して、構造化された要件データをアップロードすることもできます。このプロセスは、主に SpecificationUploadReview の 3 つのステージで案内されます。仕様のインポートが完了すると、サマリーが表示され、Valifying の実行や他ファイルのインポートなどの追加アクションも行えます。これらのステージとアクションについては、以下のセクションで説明します。

Specification

Import Wizard のこのステージでは、インポート先の仕様を定義できます。

  • Import Requirements ウィンドウ左側の Select a specification 領域を使用して、既存の仕様(必要に応じてそのセクションも)を選択します。

  • Import Requirements ウィンドウ右側の Create a specification 領域を使用して、インポートウィザードを終了せずに新しい仕様を作成し(さらに略称と割り当て先ブロックも定義し)ます。

希望する方法を使用するには、該当する領域をクリックします。

 
  • Import Wizard が Specification または Section のコンテキスト内で開始された場合、それがインポート先として事前選択された状態で表示されます。

  • 既存の仕様がない場合は、作成する必要があります。

  • 新しい Specification の命名定義では、命名規則を満たす必要があります。使用できるのは英数字と特殊文字 _ (アンダースコア)のみです。

Upload

Import Wizard のこのステージでは、サポートされている種類のファイルをアップロードできます。アップロードするには、Import Requirements ウィンドウ右側にファイルをドラッグ&ドロップするか、Drop file コントロールをクリックしてハードドライブから参照・選択します。ファイルが正常にアップロードされると、ウィンドウに通知が表示されます。

 
  • サポートされているのは Excel(.xls.xlsx)および Comma Separated Values(.csv)ファイルのみです。Excel マクロファイル(.xlsm)はサポートされていません。

  • サポートされていないファイルがアップロードされた場合は、エラーメッセージで通知されます。

  • ファイルをアップロードした後は、インポートプロセスを続行するか、新しいファイルをアップロードして(前のファイルを置き換えて)進めることができます。

Review

このステージの Import Wizard では、アップロードしたファイルからデータを取り込んだ結果を確認し、ファイルオプションを設定し、ファイル内のデータを要件フィールドにマッピングできます。

Import Requirements ウィンドウの Destination 領域では、データがどこにインポートされるか(仕様またはセクションの観点)を視覚的に示します。

File options 領域では、次のオプションを提供します。

  • Update requirements – 有効にすると、インポート先仕様に既存の要件がある場合、それらはデータの置換によって上書きされます(ファイルのデータが仕様内のデータを置き換えます)。

    • このオプションが無効で、かつインポートする要件の Identifier がインポート先として選択した仕様にすでに存在する場合、Requirements Portal はインポートされた要件の Identifier に _import  というサフィックスを付与して区別します。

    • このオプションが無効で、かつインポートする要件の Identifier が現在のプロジェクト内には存在するものの、インポート先として選択した仕様には存在しない場合、Requirements Portal は Identifier に警告アイコンを付け、同一プロジェクト内で Identifier が重複していることを知らせます。

    • このオプションが有効な場合、インポートするファイル内の空欄値がサポートされます。つまり、ファイル内の値が空欄であれば、その値は要件から削除されます。これは Tags のような複数選択フィールドにも適用されます。

  • Use header row – アップロードしたファイルのヘッダー行を使用するか、Requirements Portal が提供する汎用参照ヘッダー行(列ヘッダーが A、B、C など)を使用するかを選択できます。

    Requirements Portal は、ヘッダー行をアップロードされたファイルの先頭行として扱います。

  • Sheet – 複数シートを含むファイルの場合、どのシートからインポートするかを選択できます。

  • Starting row – インポートするファイルの何行目からデータ収集を開始し、Requirements Portal に挿入するかを選択できます。

Import Requirements ウィンドウ下部の表では、アップロードしたファイルのプレビューを表示し、列を Requirements Portal のフィールドにマッピングします。これにより、各列について Map To ドロップダウンで適切なフィールドを選択し、ファイルのデータが Requirements Portal のどのフィールドに対応するかを定義できます。ファイルに Requirements Portal のデフォルトフィールドと同一のヘッダーが含まれている場合、それらのフィールドは自動的にマッピングされます。ただし、必要に応じてこの自動マッピングを上書き・調整できます。

  • マッピングで選択できるフィールドは次のとおりです。

    • Identifier

    • Text

    • Title

    • Rationale

    • Parents

    • Children

    • Path to Section

    • Type

    • State

    • Tags

    • Compliance

    • Compliance comment

    • Verification Methods

    • Applicability

    • Applicable Blocks

    • Owner

    • Tags

    • Custom Columns

  • Verification Methods、Applicability、Tags は、各要件に対して複数の値をインポートできます。その場合、各値はカンマで区切ってください。

  • インポートする verification method、applicable block、requirement type、state、compliance、または tag が Requirements Portal にまだ存在しない場合、インポート中に自動作成され、要件に追加されます。

  • Applicability では、複合ブロックタイプを / で参照できます。例:block_A/block_B

  • 少なくとも Identifier 列を選択する必要があります。選択されるまで警告メッセージが表示されます()。

  • 次のフィールドは大文字・小文字を区別します。

    • タイプ

    • 状態

    • コンプライアンス

    • タグ

    たとえば、タグTBDがRequirements Portalにすでに存在し、タグtbdをインポートする場合、新しいタグtbdが作成され、要件とともにインポートされます。

実行レポート

インポート処理が完了し、インポートが正常に完了した場合は、成功メッセージと、行われた変更内容が表示されます。インポートに失敗した場合は、失敗メッセージが表示されます。正常にインポートされた例を以下に示します。

ソフトエラーがある場合は、それらも表示されます()。発生し得るソフトエラーは次のとおりです。

  • 関係を確立できません → 親または子の識別子がプロジェクトに存在しません

  • 関係を確立できません → 親または子の識別子がプロジェクト内で重複しています

  • 要件コンプライアンスステートメントがプロジェクトに存在しません

  • 要件タイプがプロジェクトに存在しません

  • 要件状態がプロジェクトに存在しません

  • タグがプロジェクトに存在しません

  • 適用条件が存在しません

インポーターの成功/失敗にかかわらず、Import new file(成功)またはTry again(失敗)をクリックして再インポート、または新規インポートを実行できます。これによりステージ1(Specification)に戻ります。

インポートが成功した場合は、ウィンドウ上部のCheck nowコントロールをクリックしてValifyプロセスを開始することもできます。このプロセスでは、インポートされた要件テキストをスキャンし、要件内でValisに変換できる定量化可能なパラメータ候補を検出します。

詳細は、Valify Requirementsページを参照してください。

AI-LocalizedAI で翻訳
問題が見つかった場合、文字/画像を選択し、Ctrl + Enter キーを押してフィードバックをお送りください。
機能の可用性

利用できる機能は、所有する Altium ソリューション (Altium DevelopAltium Agile のエディション (Agile Teams、または Agile Enterprise)、または Altium Designer (有効な期間)) によって異なります。

説明されている機能がお使いのソフトウェアに表示されない場合、Altium の営業担当者にお問い合わせください

Content