要件をインポート

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

AI Assisted Requirements Importer

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

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

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

AI Assisted Importer は Requirements Module()から、ページ右上の ボタンをクリックしてアクセスできます。または、現在表示している仕様に要件がない場合は、ページ上の 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 ファイルをダウンロードして、要件を構造化して取り込むこともできます。

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

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

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

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

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

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

従来のインポーター

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

仕様

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

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

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

使用したい方法に応じて、該当する領域をクリックします。

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

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

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

アップロード

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

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

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

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

レビュー

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

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

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

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

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

    • このオプションが無効で、インポートする要件の Identifier が現在のプロジェクト内にはすでに存在するものの、インポート先として選択した仕様には存在しない場合、Requirements Portal は識別子に警告アイコンを付け、同一プロジェクト内で 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 は、各要件に対して複数の値をインポートできます。その場合、各値はカンマで区切ってください。

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

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

実行レポート

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

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

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

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

  • Requirement Compliance Statement がプロジェクト内に存在しません

  • Requirement Type がプロジェクト内に存在しません

  • Requirement State がプロジェクト内に存在しません

  • Tag がプロジェクト内に存在しません

  • 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