PDF文書をスキャンする

お客様のアプリケーションにはさまざまな制御が備わっていますが、それらはテストを実行する際に Tosca Cloud が情報をやりとりする要素です。これを実現するためには、まずアプリケーションをスキャンする必要があります。これにより、必要な技術データがTosca Cloudに取り込まれます。

This topic explains how to scan PDF ドキュメントは、次のユースケースで必要になります：with ARA to record your actions into a test case.

PDFファイル内のテキスト、画像、またはテーブルをテストしたい。
PDF比較から特定の領域を除外したい。

壊れたリンクをチェックするなど、その他のすべてのユースケースでは、代わりに標準モジュールを使用します。詳細については、リンク、バーコード、QRコードのテストの作成をご確認ください。

スキャンを開始する

スキャンを開始するには、以下の手順に従ってください。

Open the test case building area by selecting Create in the menu bar on the left.ダイアログでテストケースを見つけて、再び作成を選択します。
Modulesを選択し、その後+ Create moduleを選択します。
ドロップダウンメニューからPDFドキュメントを選択します。

コンテンツのプレビューを追加する

デフォルトでは、PDFスキャンのウィンドウには以下が表示されます。

PDFファイル。
スキャン中に選択したPDFコントロールの名前と種類。

選択したコントロールのコンテンツを表示するには、リボンメニューで「コンテンツのプレビューを表示」を選択します。

これで、正しいコンテンツを選択していることを確認できます。また、Tosca Cloudがコントロールのコンテンツを正しく認識しない場合に備えて、「光学式認識を強制実行」するオプションにアクセスすることもできます。

スキャンインターフェースの追加オプション

「PDFスキャン」メニューには、以下のオプションも用意されています。

リボンメニューのオプション	説明
ズーム	PDF Viewのズームレベルを変更します。
ズームフィット	スキャンしたPDFをPDFビューに合わせて拡大します。
Show/Hide scanned areas	スキャンした領域をPDFビューで表示または非表示にします。
Select Document Language	スキャンしたPDFの言語を選択します。PDFスキャンは、光学式文字認識（OCR）にこの言語を使用します。

コントロールを選択する

モジュールに追加するPDFコントロールにはいくつかの定義方法があります。

絶対位置でコントロールを定義する。
別の要素に対する相対位置でコントロールを定義する。これは、PDF要素が絶対位置を持たない場合に便利です。ただし、常に別のPDF要素に対して特定の位置に表示されます。

請求書をテスト中で、正味価格が正しく表示されているかを確認するとします。アイテムリストの長さに応じて、正味価格がページの上部に表示されたり下部に表示されたりします。その場合、正味価格に絶対位置はありません。しかし、常に総額のすぐ上に表示されます。つまり、常に他の要素に対して特定の位置に表示されているのです。
反復範囲を定義する。これは、要素がドキュメントの複数のページで同じ領域に表示される場合に便利です。

全ページの下部に著作権表示が配置されていることを確認するとします。1ページごとに個別にコントロールを定義するのではなく、ドキュメント全体に対して反復範囲を作成することが可能です。

ユースケースを選択してください。

絶対位置でコントロールを定義したいです。

このオプションを選択した場合、Tosca Cloudは、PDFファイル内の位置によってコントロールを識別します。

スキャンするには、以下の手順に従ってください。

PDFスキャンのリボンメニューで、モジュールに追加するコントロールの種類（テキスト、画像、またはテーブル）を選択します。
スキャンのPDFビューで、それぞれの領域をマウスで強調表示します。これで、モジュールに新しいコントロールが追加されます。
「テーブル」コントロールの場合は、以下の追加操作を行ってください。
- 「コンテンツプレビュー」を追加します。
- 該当する場合は、行または列のヘッダー数を指定します。
- グリッドラインがテーブルと一致しない場合は、「テーブルを編集」を選択して、列の線を移動し、行のサイズを再調整してください。You can hold C and click where you want to create a new column, or hold R and click to create a new row.行を正確に移動する必要がある場合は、「行を編集」を選択してください。
まだの場合は、「コンテンツプレビュー」を追加してください。次に、「テキスト」コントロールと「テーブル」コントロールに正しいコンテンツが含まれていることを確認します。
- コントロールにスペースなどの重要な文字の欠落はありません。
- コントロールのコンテンツのプレビューは、PDF内の元のコンテンツと一致します。一致しない場合は、代わりの認識方法として「光学式認識を強制実行」するという選択肢があります。
モジュールに追加するすべてのコントロールを定義したら、保存してください。次に、「新しいドキュメントをスキャン」または「閉じる」を選択します。

相対位置でコントロールを定義したいです。

このオプションを選択した場合、Tosca Cloudは、別の要素（「アンカー制御」）に対する相対的な位置によってコントロール（「ターゲット制御」）を識別します。

このアンカー制御は、以下の要件を満たす必要があります。

テキストまたは画像であること。
一意に識別可能であること。その結果、反復範囲をアンカー制御として使用することはできません。
ターゲット制御と同じページにあること。

スキャンするには、以下の手順に従ってください。

PDFスキャンで、絶対位置によって2つのコントロール（アンカー制御とターゲット制御）を定義します。
コントロールのリストで、アンカー制御を右クリックします。次に、以下の操作を行ってください。
- アンカー制御の種類に応じて、「…のテキストアンカーとして使用」を選択するか、「…の画像アンカーとして使用」を選択します。コンテキストメニューから選択してください。
- リストからターゲット制御を選択します。
注：アンカー制御を通常のコントロールに戻すことはできません。
モジュールに追加するすべてのコントロールを定義したら、保存してください。次に、「新しいドキュメントをスキャン」または「閉じる」を選択します。

実行時に、Tosca Cloudは、アンカー制御のPDFファイルを検索し、その後、ターゲット制御の位置を算出します。

デフォルトでは、Tosca Cloudは、定義したテキストまたは画像と完全一致するアンカー制御を探します。これがテストに問題を引き起こす場合は、精度を下げて設定することが可能です。詳細については、アンカーコントロールをご確認ください。このトピックでは、アンカー制御の編集方法やこれらを固有のコントロールにする方法についても説明しています。

スキャン中にコントロールを編集する

以下のように、スキャン中にコントロールを編集することができます。

領域を選択するには、PDFビューまたはコントロールのリストで選択します。
PDFビュー内のコントロールにジャンプするには、リスト上のコントロールをダブルクリックするか、「ジャンプ」アイコンを使用します。
コントロールの名前を変更するには、その名前をダブルクリックします。
領域のサイズを変更したり、移動したりするには、PDFビューで長方形を操作します。
コントロールのタイプを変更するには、PDFビューでコントロールを右クリックし、コンテキストメニューで新しいタイプを選択します。
コントロールを再描画するには、コントロールのリストで「再描画」アイコンを選択します。
コントロールを削除するには、コントロールのリストで「削除」アイコンを選択するか、PDFビュー内の領域を右クリックし、コンテキストメニューで「このコントロールを削除」を選択します。

再スキャン

モジュールでコントロールを追加または変更する場合は、PDFファイルを再スキャンします。以下の制限事項に注意してください。

再スキャン中にコントロールを削除することはできません。
再スキャン中にコントロールタイプを変更することはできません。

PDFモジュールを作成しました。これでPDFテストケースの作成を開始できます。