在对日软件开发公司工作的各位同学们,不知道你们在看式样书的时候有没有遇到过表达不清楚的语法问题,或者自己写出来的文章别人看不懂呢。在式样书的书写上有一些语法,词汇的使用时需要注意的。掌握了这些才能写出一本好的式样书。下面提醒大家写式样书时的注意点。
●CHECK方法要明确记述
错误范例:氏名のチェックを行う。
这样写过后,制造的人并不清楚具体要进行什么样的CHECK。因此正确的说法为:
(1)入力必須かどうか
(2)入力可能な文字種別か
(3)半角、全角のどちらか
(4)英大文字、小文字かのどちらか
(5)未入力時は、エラーにするか、デフォルトにするか
●对0件的处理条件不要漏
错误范例:
抽出後データ件数:1~100件→処理Aを実行
抽出後データ件数:01件以上→処理Bを実行
这样的记述没有明确给出再怎样的要条件下要进行以上处理。因此正确的说法:
抽出後データ件数:抽出エラー時→エラー処理Aを実行
抽出後データ件数:0件→エラー処理Bを実行
抽出後データ件数:1~100件→処理Aを実行
抽出後データ件数:101件以上→処理Bを実行
●有关空白的记述方式
错误范例:SQLを以下の抽出条件にて発行する→出力SEQ≠空白
空白分为1Byte space(半角)、2Byte space(全角)、Null、0字符串4种,
如果不能明确给出,会导致程序混乱。
因此正确的说法:
SQLを以下の抽出条件にて発行する→出力SEQ≠Null