付録A.2　テストケースのCSVファイル

(1)　テストケースのCSVファイルの規則

テストケースのCSVファイルの規則は次のとおりです。

• 行頭に「*」がある行はコメント行として扱います。

• 文字コードはシフトJISです。シフトJIS以外の文字コードで保存した場合の動作は保証しません。

• 1行にはデータ項目1つの情報を格納します。

• 1行の各項は半角のコンマ「,」で区切ります。1つの項は設定する値をそのまま記載するか，半角のダブルコーテーション「"」で囲みます。ただし，設定する値に次の文字が含まれる場合は，その項全体を半角のダブルコーテーション「"」で囲む必要があります。

  • 半角のコンマ「,」

  • 半角のダブルコーテーション「"」

• 半角のダブルコーテーション「"」で囲んだ中に，さらに半角のダブルコーテーション「"」を入れる場合は，「""」のように2つ並べて記述します。

  例を次に示します。

  項番	扱う文字	CSVファイルの記載方法	備考
  1	@'ALLOCATE,120'	"@'ALLOCATE,120'"	−
  2	@"ALLOCATE"	"@""ALLOCATE"""	−
  3	"AAA"	"""AAA"""	−
  4	"AA,A"	"""AA,A"""	−
  5	"AA""A"	"""AA""""A"""	代入値または期待値に指定すると，「AA"A」（文字列データ）として代入または比較されます。
  6	"""B""C"	"""""""B""""C"""	代入値または期待値に指定すると，「"BB"C」（文字列データ）として代入または比較されます。

• 単体テスト支援が出力するCSVファイルでは，必要な場合だけ半角のダブルコーテーション「"」で囲んで出力されます。

• 項目の値として改行は含めないでください。改行を含んでいた場合の動作は保証しません。

• 1行に含まれる項目数は，テストデータの設定に必要な項目数を超えてもエラーにはなりません。超えた分の内容は無視されます。ただし，1行に書ける最大バイト数を超えるとエラーになります。

• 項目によっては空欄にできますが，空欄ではなくコンマで区切られていないことで項目数が足りない状態にはできません。この状態のCSVファイルはエラーになります。

• 項目によっては，定数を使用している場合があります。定数は半角の英数字で，英大文字と英小文字の区別はしません。ただし，単体テスト支援がエクスポートする場合は，各項目の説明の表記で出力されます。項目で共通に使用する定数を次に示します。

  定数	意味
  true	該当の項目を有効にします。GUI画面上ではチェックボックスがオンになります。
  false	該当の項目を無効にします。GUI画面上ではチェックボックスがオフになります。

ページの先頭へ

(2)　テストケースのCSVファイルの形式

単体テスト支援でエクスポートする，テストケースのCSVファイルの1行のフォーマットは次のとおりです。

<データ項目の設定個所の情報>,<参照フラグ>,<データ項目のレベル番号>,<データ項目名>,<値の表示>,<期待値>,<代入値>,<設定個所固有情報>

各項目の意味とエクスポート時のデフォルト値について説明します。デフォルト値は，CSVファイルにエクスポートするときに，項目に対応する値が設定されていなかった場合に出力される値のことです。また，インポート時に項目が空欄の場合の扱いは，「空欄の扱い」として説明します。空欄の扱いでエラーになった場合は，エラーメッセージが出力され，その行はスキップされます。

行番号[.位置番号]

ページの先頭へ

(3)　ひな形の内容

ひな形としてエクスポートしたCSVファイルについて，各設定画面でテストデータとして出力する内容です。

例

COBOLプログラムのソーステキスト

IDENTIFICATION  DIVISION.
PROGRAM-ID. 'MAIN'.
ENVIRONMENT       DIVISION.
INPUT-OUTPUT      SECTION. 
FILE-CONTROL.
    SELECT  FILE01 ASSIGN TO 'FILE-B2046M1.txt'.
DATA DIVISION.
FILE              SECTION.
FD  FILE01.
01  REC0001 PIC X(5).
01  REC0002 PIC X(10).
WORKING-STORAGE  SECTION.
  01 DATA1 PIC X(10).
PROCEDURE  DIVISION.
  OPEN OUTPUT FILE01.
  WRITE REC0001.
  CLOSE FILE01.
END PROGRAM 'MAIN'.

ひな形CSVの内容

* Version: 03-04
* テストプロジェクト名: SAMPLE_PROJECT
* プログラム名: MAIN
* COBOLソースファイル: C:\temp\main.cbl
***** ［プログラム開始時］画面の設定 *****
* <データ項目の設定個所の情報>,<参照フラグ>,<データ項目のレベル番号>,<データ項目名>,<値の表示>,<期待値>,<代入値>
StartPoint,,,RETURN-CODE,false,,
StartPoint,R,01,REC0001 OF FILE01,false,,
StartPoint,,01,REC0002 OF FILE01,false,,
StartPoint,,01,DATA1,false,,
***** ［プログラム終了時］画面の設定 *****
* <データ項目の設定個所の情報>,<参照フラグ>,<データ項目のレベル番号>,<データ項目名>,<値の表示>,<期待値>,<代入値>
EndPoint,,,RETURN-CODE,false,,
EndPoint,R,01,REC0001 OF FILE01,false,,
EndPoint,,01,REC0002 OF FILE01,false,,
EndPoint,,01,DATA1,false,,
***** ［ファイルシミュレーション］画面の設定 (FILE01(MAIN/MAIN)/OUTPUT/WRITE) *****
* <データ項目の設定個所の情報>,<参照フラグ>,<データ項目のレベル番号>,<データ項目名>,<値の表示>,<期待値>,<代入値>,<ファイル名>,<プログラム名>,<オープンモード>,<入出力文>,<テストデータセット番号>,<終了条件>
FileSim,R,01,REC0001 OF FILE01,false,,,FILE01,MAIN,OUTPUT,WRITE,1,
* FileSim,,01,REC0002 OF FILE01,false,,,FILE01,MAIN,OUTPUT,WRITE,1,
***** ［中断点］画面の設定 (0001000.1) *****
* <データ項目の設定個所の情報>,<参照フラグ>,<データ項目のレベル番号>,<データ項目名>,<値の表示>,<期待値>,<代入値>,<文番号>
* BreakPoint,,,RETURN-CODE,false,,,0001000.1
* BreakPoint,R,01,REC0001 OF FILE01,false,,,0001000.1
* BreakPoint,,01,REC0002 OF FILE01,false,,,0001000.1
* BreakPoint,,01,DATA1,false,,,0001000.1

ページの先頭へ

(4)　テストケースのCSVファイルに関する注意

1. テストケースのCSVファイルには，単体テスト支援の画面では制限値・限界値としている値を超えた設定ができますが，このように設定したCSVファイルをインポートしても，画面では制限値・限界値を超えた部分の値は参照できません。ただし，設定した内容はテスト実行時には反映され，実行結果としては参照できます。

   テストケースのCSVファイルの制限値・限界値を超えた値を設定した場合は，該当する行の読み込みをスキップし，エラーを表示し，次の行以降の読み込みを継続します。テストケースCSVの制限値・限界値については，「付録C　単体テスト支援の制限値と限界値」を参照してください。

2. 期待値のための情報が設定されていて，かつ「代入値」に値が設定されていた場合の動作は次のとおりです。

   期待値のための情報とは，「値の表示」の値がtrueで「期待値」が空，または，「値の表示」の値がtrueで「期待値」に値が設定されている場合のことです。

   StartPointの場合

   「代入値」の内容だけを適用します。

   EndPointの場合

   期待値用の情報だけを適用します。

   FileSimの場合

   設定個所固有情報の「入出力文」の内容によって使用するものが変わります。「入出力文」の値がREADの場合は，「代入値」の内容だけを適用します。「入出力文」の値がWRITEまたはREWRITEの場合は，期待値のための情報だけを適用します。

   BreakPointの場合

   両方適用します。

   どの場合でも，採用しなかった値について，エラーメッセージは出力されません。

3. 集団項目に対する設定をインポートした場合，「期待値」と「代入値」の項目は無視されます。エクスポートのときは空欄で出力されます。

4. インポートしたCSVファイルで次の内容が設定されている場合，設定する順番（CSVファイル内の行の順）に関係なく，集団項目に対する「値の表示」はtrueになります。

   • 集団項目に対して設定する行（CSVファイル内の行）がない。または，集団項目に対する「値の表示」がfalseまたは空欄。

   • 集団項目の下位要素の「値の表示」がtrue。

5. CSVファイル内で，同じデータ項目に対してテストデータを設定する行が複数ある場合は，最後の設定が有効になります。

6. 特殊レジスタのレベル番号は無視されます。エクスポートのときは，空欄で出力されます。

7. FILLERに対する設定をインポートした場合，その設定はすべて無視されます。

ページの先頭へ

(5)　テストケースのCSVファイルの例

COBOLプログラムのソーステキストとテストケースのCSVファイルの例の説明です。

例1：集団項目を含むテストデータ設定

COBOLプログラムのソーステキスト（抜粋）

IDENTIFICATION DIVISION.
PROGRAM-ID. MAIN.
DATA DIVISION.
WORKING-STORAGE SECTION.
01 DATA01.
　05 SUBDATA01 PIC X(3).
　05 SUBDATA02 PIC S9(3).

テストケースのCSVファイルの例（抜粋）

* Version: 03-04
* テストプロジェクト名: SAMPLE_PROJECT
* プログラム名: MAIN
* COBOLソースファイル: C:\temp\main.cbl
***** ［プログラム開始時］画面の設定 *****
* <データ項目の設定個所の情報>,<参照フラグ>,<データ項目のレベル番号>,<データ項目名>,<値の表示>,<期待値>,<代入値>
StartPoint,R,01,DATA01,,,
StartPoint,R,05,SUBDATA01 OF DATA01,,,"""ABC"""
StartPoint,R,05,SUBDATA02 OF DATA01,,,123
***** ［プログラム終了時］画面の設定 *****
* <データ項目の設定個所の情報>,<参照フラグ>,<データ項目のレベル番号>,<データ項目名>,<値の表示>,<期待値>,<代入値>
EndPoint,R,01,DATA01,,,
EndPoint,R,05,SUBDATA01 OF DATA01,true,"""ABC""",
EndPoint,R,05,SUBDATA02 OF DATA01,true,123,

解説

行	データ項目の設定個所の情報	参照フラグ	レベル番号	データ項目名	値の表示	期待値	代入値
7	StartPoint	R	01	DATA01	−	−	−
8	StartPoint	R	05	SUBDATA01 OF DATA01	−	−	"""ABC"""
9	StartPoint	R	05	SUBDATA02 OF DATA01	−	−	123
12	EndPoint	R	01	DATA01	−	−	−
13	EndPoint	R	05	SUBDATA01 OF DATA01	true	"""ABC"""	−
14	EndPoint	R	05	SUBDATA02 OF DATA01	true	123	−

CSVファイルの7，8，9行目の設定で，テスト対象プログラム名（MAIN）の開始時用データとしてテストデータが設定されます。

• 7行目は集団項目用の設定のため，行自体はなくてもかまいません。代入値があっても無視されます。

• 8行目の内容で，SUBDATA01に文字列ABCが代入されます。また，データ構造から，SUBDATA01だけで名前解決が可能なら，OF修飾子以降は不要です。

• 9行目の内容で，SUBDATA02に数値123が代入されます。

CSVファイルの12，13，14行目の設定で，テスト対象プログラム名（MAIN）の終了時用データとしてテストデータが設定されます。

• 12行目は集団項目用の設定のため，行自体はなくてもかまいません。期待値があっても無視されます。

• 12行目では「値の表示」は空（＝false）ですが，13，14行目で値の表示をtrueにしているため，GUIで確認したときは，DATA01の「値の表示」にもチェックが入ります。

• 13，14行目で，SUBDATA01とSUBDATA02を期待値と比較しています。

例2：中断点の設定

COBOLプログラムのソーステキスト（抜粋）

000100 ID DIVISION.
000200 PROGRAM-ID. MAIN.
000300 DATA DIVISION.
000400 WORKING-STORAGE SECTION.
000500   01 SAMPLEDATA PIC 9(9) VALUE 1. 
000600 PROCEDURE DIVISION.
000800   DISPLAY SAMPLEDATA.
000900   IF SAMPLEDATA = 2
001000   :

テストケースのCSVファイルの例（抜粋）

* Version: 03-04
* テストプロジェクト名: SAMPLE_PROJECT
* プログラム名: MAIN
* COBOLソースファイル: C:\temp\main.cbl
***** ［中断点］画面の設定 (0000800.1) *****
* <データ項目の設定個所の情報>,<参照フラグ>,<データ項目のレベル番号>,<データ項目名>,<値の表示>,<期待値>,<代入値>,<文番号>
BreakPoint,R,01,SAMPLEDATA,true,1,,0000800.1
***** ［中断点］画面の設定 (0000900.1) *****
* <データ項目の設定個所の情報>,<参照フラグ>,<データ項目のレベル番号>,<データ項目名>,<値の表示>,<期待値>,<代入値>,<文番号>
BreakPoint,R,01,SAMPLEDATA,true,2,2,0000900.1

解説

行	データ項目の設定個所の情報	参照フラグ	レベル番号	データ項目名	値の表示	期待値	代入値	文番号
7	BreakPoint	R	01	SAMPLEDATA	true	1	−	0000800.1
10	BreakPoint	R	01	SAMPLEDATA	true	2	2	0000900.1

CSVファイルの7行目で，プログラムの800行目のDISPLAY文に中断点を設定して，SAMPLEDATAを期待値と比較しています。

CSVファイルの10行目で，プログラムの900行目のIF文に中断点を設定し，次を設定しています。

• SAMPLEDATAを期待値と比較している（中断してすぐ）。

• SAMPLEDATAに2を代入している（上記の比較が終わったあと）。

例3：ファイルシミュレーション用テストデータの設定

COBOLプログラムのソーステキスト（抜粋）

000100 IDENTIFICATION DIVISION.
000200 PROGRAM-ID. MAIN.
000300 ENVIRONMENT DIVISION.
000400 INPUT-OUTPUT SECTION.
000500 FILE-CONTROL.
000600 SELECT FILE001 ASSIGN TO SYS010.
001000 DATA DIVISION.
001100 FILE SECTION.
001200 FD FILE001.
001300 01  USER.
001400   02 USERID   PIC 9(9).
001500   02 USERNAME PIC X(30).
002300 PROCEDURE DIVISION.
002400   OPEN INPUT FILE001.
002500 FILE-READ.
002600   READ FILE001
002700   AT END
002800     GO TO END-OF-FILE-READ 
002900   NOT AT END
           :
004000     GO TO FILE-READ
004100   END-READ.
004200 END-OF-FILE-READ.
004300   CLOSE FILE001.

テストケースのCSVファイルの例（抜粋）

* Version: 03-04
* テストプロジェクト名: SAMPLE_PROJECT
* プログラム名: MAIN
* COBOLソースファイル: C:\temp\main.cbl
***** ［ファイルシミュレーション］画面の設定 (FILE001(MAIN/MAIN)/INPUT/READ) *****
* <データ項目の設定個所の情報>,<参照フラグ>,<データ項目のレベル番号>,<データ項目名>,<値の表示>,<期待値>,<代入値>,<ファイル名>,<プログラム名>,<オープンモード>,<入出力文>,<テストデータセット番号>,<終了条件>
FileSim,R,01,USER OF FILE001,,,,FILE001,MAIN,INPUT,READ,1,
FileSim,R,02,USERID OF USER OF FILE001,,,1,FILE001,MAIN,INPUT,READ,1,
FileSim,R,02,USERNAME OF USER OF FILE001,,,"""user1""",FILE001,MAIN,INPUT,READ,1,
FileSim,R,01,USER OF FILE001,,,,FILE001,MAIN,INPUT,READ,2,
FileSim,R,02,USERID OF USER OF FILE001,,,2,FILE001,MAIN,INPUT,READ,2,
FileSim,R,02,USERNAME OF USER OF FILE001,,,"""user2""",FILE001,MAIN,INPUT,READ,2,
FileSim,,,,,,,FILE001,MAIN,INPUT,READ,,AtEnd

解説

行	データ項目の設定個所の情報	参照フラグ	レベル番号	データ項目名	値の表示	期待値	代入値	ファイル名	プログラム名	オープンモード	入出力文	テストデータセット番号	終了条件
7	FileSim	R	01	USER OF FILE001	−	−	−	FILE001	MAIN	INPUT	READ	1	−
8	FileSim	R	02	USERID OF USER OF FILE001	−	−	1	FILE001	MAIN	INPUT	READ	1	−
9	FileSim	R	02	USERNAME OF USER OF FILE001	−	−	"""user1"""	FILE001	MAIN	INPUT	READ	1	−
10	FileSim	R	01	USER OF FILE001	−	−	−	FILE001	MAIN	INPUT	READ	2	−
11	FileSim	R	02	USERID OF USER OF FILE001	−	−	2	FILE001	MAIN	INPUT	READ	2	−
12	FileSim	R	02	USERNAME OF USER OF FILE001	−	−	"""user2"""	FILE001	MAIN	INPUT	READ	2	−
13	FileSim	−	−	−	−	−	−	FILE001	MAIN	INPUT	READ	−	AtEnd

7〜12行目でテストデータを設定しています。

• 7，8，9行目で1回目のREAD文で代入する値を指定しています。

• 10，11，12行目で2回目のREAD文で代入する値を指定しています。

13行目では，終了条件を指定しています。

この内容でテストすると，READ文が3回実行され，最初の2回ではデータが設定され（入力文のシミュレーション），3回目のREAD文でAT END側の処理に移ります。

ページの先頭へ