要件をインポート

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

AI Assisted Requirements Importer

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

AI 支援インポーター機能は現在ベータ版です。

AI 支援インポーターで要件にインポートできるフィールドは次のとおりです。

  • Identifier

  • Text

  • Methods

  • Applicable Blocks

  • Title

  • Rationale

  • Parents

  • Children

  • Type

  • State

  • Compliance

  • Compliance comment

  • Owner

  • Tags

  • Path to Section

インポーターへのアクセス

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

インポートの流れ

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

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

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

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

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

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

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

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

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

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

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

従来のインポーター

インポーターにアクセスする際(learn more)、従来のインポートツールを使用して、構造化された要件データをアップロードすることもできます。このプロセスでは、主に 3 つのステージ(SpecificationUploadReview)に沿ってガイドされます。仕様のインポートが完了すると、サマリーが表示され、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

    • V&V Methods

    • Applicability

    • Applicable Blocks

    • Owner

    • Tags

    • Custom Columns

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

  • インポート対象の検証方法、適用ブロック、要件タイプ、状態、コンプライアンス、またはタグが Requirements Portal に現在存在しない場合、インポート中に自動的に作成され、要件に追加されます。

  • 適用性(Applicability)については、複合ブロックタイプを / で参照できます。例:block_A/block_B

  • カスタム列では、次のタイプを使用できます: 選択(Select)、複数選択(Multiselect)、テキスト(Text)、日付(Date)、数値(Number)。

  • 少なくとも Identifier 列を選択する必要があります。選択されていない場合、その条件が満たされるまで警告メッセージが表示されます()。

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

    • Type

    • State

    • Compliance

    • Tags

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

実行レポート

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

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

  • 関連付けを確立できません → 親または子の Identifier がプロジェクトに存在しません

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

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

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

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

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

  • 適用条件(Applicability Condition)が存在しません

インポートの成否にかかわらず、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