生成されたレポート結果を追跡し、ベースライン値と比較する
送信する電子ドキュメントを生成する電子申告 (ER) 形式の結果をトレースできます。 トレースの生成が有効である場合 (デバッグ モードで実行 ER ユーザー パラメーターを使用することによって)、ER レポートが実行されるたびに ER 形式実行ログで新しいトレース レコードが生成されます。 生成される各トレースには、次の情報が格納されます。
- 検証ルールによって生成されたすべての警告
- 検証ルールによって生成されたすべてのエラー
- トレース レコードの添付ファイルとして格納されるすべての生成されたファイル
任意の ER 形式の個々のベースライン アプリケーション ファイルを格納できます。 ファイルは、実行されるレポートの予期される結果の説明時にベースライン ファイルと見なされます。 トレースの生成がオンである間に実行される ER 形式に対してベースライン ファイルが使用可能な場合、トレースは、前述した詳細内容に加えて、生成された電子ドキュメントとベースライン ファイルとの比較の結果を格納します。 ワンクリックで、生成された電子ドキュメントおよびそのベースライン ファイルを単一の zip ファイルで取得することもできます。 WinDiff などの外部ツールを使用して詳細な比較を行うことができます。
生成される電子ドキュメントが予想されるコンテンツを含むかどうかを分析するトレースを評価できます。 コード ベースが変更されたとき (たとえば、アプリケーションの新しいインスタンスに移行したとき、修正プログラム パッケージをインストールしたとき、またはコード変更を配置したとき)、ユーザー受け入れテスト (UAT) 環境でこの評価を行うことができます 。 この方法で、評価は使用される ER レポートの実行に影響しないことを確認できます。 多くの ER レポートについては、無人モードで評価を実行できます。
この機能の詳細については、7.5.4.3 IT サービス/ソリューションのテスト (10679) 業務プロセスの一部である、ER レポートの生成および結果の比較 (第 1 部) および ER レポートの生成および結果の比較 (第 2 部) タスク ガイドを再生し、Microsoft ダウンロード センター からダウンロードできます。 これらのタスク ガイドでは、生成される電子ドキュメントを評価するためにベースライン ファイルを使用して、ER フレームワークを構成するプロセスについて説明します。
例: 生成されたレポート結果をトレースし、ベースライン値と比較する
この手順では、ER 形式の実行に関する情報を収集し、それらの実行の結果を評価するように ER フレームワークを構成する方法について説明します。 この評価の一部として、生成されたドキュメントがベースライン ファイルと比較されます。 この例では、サンプル会社 Litware, Inc. に必要な ER 構成を作成します。 この手順は、「システム管理者」または「電子レポート開発者」ロールが割り当てられているユーザーを対象としています。 これらのステップは、任意のデータ セットを使用することによって完了できます。
この例の手順を完了するには、まず、コンフィギュレーション プロバイダーを作成し、それを有効としてマークする にある手順を完了する必要があります。
- 組織管理>ワークスペース>電子申告の順に移動します。
- ローカライズの構成ページの 構成プロバイダー セクションで、Litware, Inc. サンプル会社の構成 プロバイダーが一覧に表示されていること、およびアクティブとマークされていることを確認します。 このコンフィギュレーション プロバイダーが表示されない場合は、コンフィギュレーション プロバイダーを作成し、それを有効としてマークする の手順に従います。
ドキュメント管理パラメーターのコンフィギュレーション
- 組織管理>ドキュメント管理>ドキュメント タイプに移動して、ベースライン ファイルを保存するための新しいドキュメント タイプを作成します。
- クラス フィールドに、ファイルの添付と入力します。
- グループ フィールドには、ファイルと入力します。
メモ
ER ベースライン機能を使用する予定のデータ セットごとに、同じ名前を持つ新しいドキュメント タイプを構成する必要があります。
ER パラメーターを構成して、ベースライン機能の使用を開始する
関連リンクセクションの電子申告ワークスペースで、電子申告パラメーターを選択します。
ベースライン フィールドの添付ファイル タブで、作成したドキュメント タイプを入力または選択します。
保存を選択して、電子申告パラメーター ページを閉じます。
新しい ER モデル コンフィギュレーションの追加
- 構成セクションの、電子申告ワークスペースで、申告の構成タイルを選択します。
- アクション ウィンドウで、構成の作成を選択します。
- 名前フィールドのドロップダウン ダイアログ ボックスに、ER ベースラインを学習するためのモデルと入力します。
- 構成の作成を選択して、新しい ER データ モデル エントリの作成を確認します。
データ モデルのデザイン
- アクション ウィンドウの構成ページで、デザイナーを選択します。
- 新規 を選択します。
- ドロップダウン ダイアログボックスの名前フィールドにルートと入力します。
- 追加を選択します。
- ルート参照を選択します。
- OK を選択してから、保存を選択します。
- モデル デザイナー ページを閉じます。
- ステータスの変更を選択します。
- 完了を選択し、OK を選択します。
新しい ER 形式コンフィギュレーションを追加する
- アクション ウィンドウの構成ページで、構成の作成を選択します。
- ドロップダウン ダイアログ ボックスにある新しいフィールド グループで、ER ベースラインを学習するためのモデル データ モデルに基づく形式を選択します。
- 名前フィールドに、ER ベースラインを学習するための形式を入力します。
- 構成の作成を選択して、新しい ER 形式エントリの作成を確認します。
形式のデザイン
この例では、XML ドキュメントを生成するための単純な ER 形式を作成します。
アクション ウィンドウの構成ページで、デザイナーを選択します。
ルートの追加を選択します。
ドロップダウン ダイアログ ボックスで、次の手順に従います。
- ツリーで、Common\File を選択します。
- 名前フィールドに、アウトプットと入力します。
- OKを選択します。
追加を選択します。
ドロップダウン ダイアログ ボックスで、次の手順に従います。
- ツリーで、XML\Element を選択します。
- 名前フィールドに、ドキュメントと入力します。
- OKを選択します。
ツリーで、出力\ドキュメントを選択します。
追加を選択します。
ドロップダウン ダイアログ ボックスで、次の手順に従います。
- ツリーで、XML\Attribute を選択します。
- 名前フィールドに、ID と入力します。
- OKを選択します。
マッピング タブで、削除 を選択します。
ルートの追加を選択します。
ドロップダウン ダイアログボックスのツリーで、一般\ユーザー入力パラメーターを選択し、次の手順を実行します。
- 名前フィールドに、ID と入力します。
- ラベル フィールドで、ID の入力 と入力します。
- OKを選択します。
ツリーで、出力\ドキュメント\ID を選択します。
バインドを選択してから、保存を選択します。
デザインされた構造に基づいて、構成された形式が XML ファイルを生成します。 この XML には、ユーザーが ER ランタイム ダイアログ ボックスに入力した値に設定された ID 属性を持つルート要素が含まれています。
デザインされた ER 形式の新しいベースライン ファイルの生成
バージョン クイックタブの構成ページで、実行を選択します。
ID を入力フィールドで、1 と入力します。
OKを選択します。
生成された out.Admin.xml ファイルのローカル コピーを保存して、後でこの ER 形式のベースラインとして使用できるようにします。
ER パラメーターを構成して、ベースライン機能を使用する
- 構成ページのアクション ウィンドウの構成タブで、ユーザー パラメーターを選択します。
- デバッグモードで実行するオプションをはいに設定します。
- OKを選択します。
デザインされた ER 形式の新しいベースライン ファイルの追加
組織管理>電子申告>コンフィギュレーションに移動します。
アクション ウィンドウで、ベースラインを選択します。
アクション ウィンドウで、新規を選択します。
以前に設計した ER ベースライン形式を学ぶための形式 ER 形式を選択します。
保存を選択します。
ベースラインは ER ベースラインを学習するための形式形式に追加されます。
追加したベースラインのベースライン ルールを構成する
電子申告形式のベースライン ページのアクション ウィンドウで、添付ファイル ボタン (紙クリップのアイコン) を選択します。
アクション ウィンドウで、新規>ファイルを選択します。 ER パラメーターでは、ファイル ドキュメント タイプは、ベースライン ファイルの保存に使用されるドキュメント タイプとしてあらかじめ選択されている必要があります。
参照を選択し、構成された ER 形式を先ほど実行したときに生成された、out.Admin.xml ファイルを選択します。
添付ファイル ページを閉じます。
ベースライン クイックタブで新規を選択します。
名前フィールドに、ベースライン 1 と入力します。
ファイル コンポーネント名フィールドで、出力を入力または選択します。 この値は、構成されたベースラインが出力形式要素を使用して生成されたファイルと比較されることを示します。
ファイル名マスク フィールドに、*.xml と入力します。
メモ
ファイル名マスクを定義できます。 ファイル名のマスクが定義されている場合、生成される出力ファイルの名前がそのマスクを満たす場合にのみ、ベースライン レコードは生成された出力を評価するために使用されます。
特定の会社にサインインしているユーザーによって ER ベースラインを学習するための形式 ER 形式が実行される場合にのみ、構成されたベースラインを使用する必要がある場合は、会社フィールドでそれらの会社を選択してください。
ベースライン フィールドで、out.Admin 添付ファイルを入力または選択します。
保存を選択します。
デザインされた ER 形式を実行し、ログを確認して結果を分析する
組織管理>電子申告>コンフィギュレーションに移動します。
ツリーで、ER ベースラインを学習するためのモデルを展開して、ER ベースラインを学習するためのモデル\ER ベースラインを学習するための形式を選択します。
バージョン クイック タブで、実行を選択します。
ID を入力フィールドで、1 と入力します。
OK を選択します。
組織管理>電子申告>構成デバッグ ログの順に移動します。
メモ
実行ログには、生成されたファイルと構成されたベースラインとの比較の結果に関する情報が含まれます。 この例では、ログは、生成されたファイルとベースラインが同じであることを示しています。
すべて削除を選択します。
デザインされた ER 形式を実行し、ログを確認して結果を分析する
組織管理>電子申告>コンフィギュレーションに移動します。
ツリーで、ER ベースラインを学習するためのモデルを展開して、ER ベースラインを学習するためのモデル\ER ベースラインを学習するための形式を選択します。
バージョン クイック タブで、実行を選択します。
ID を入力フィールドで、2 と入力します。
OK を選択します。
組織管理>電子申告>構成デバッグ ログの順に移動します。
メモ
実行ログには、生成されたファイルと構成されたベースラインとの比較の結果に関する情報が含まれます。 この例では、ログは、生成されたファイルとベースラインが異なることを示しています。
比較を選択します。
メモ
生成されたファイルとベースライン ファイルは、ZIP ファイルとして提供されます。 WinDiff などの外部比較ツールを使用して、ファイルを比較し、相違点を確認することができます。