帳票の出力時に使用する帳票と入力データを保持するクラスです。
fujitsu.listcreator.FormBase
∟ fujitsu.listcreator.Forms
public class Forms : FormBaseFormsクラスのコンストラクタを以下に示します。
コンストラクタの概要 |
|---|
Forms(string formname, string assets)(*1) 帳票名と帳票格納ディレクトリを指定して、帳票と入力データのセットを保持するFormsを作成します。 |
Forms(string formname, string assets, string cbformname)(*1) 帳票名、帳票格納ディレクトリ、および組合せフォーム名を指定して、帳票と帳票データのセットを保持するFormsを作成します。 |
*1：
ファイル名、ファイルの格納先の指定に関する注意事項については、以下を参照してください。
Formsクラスのプロパティを以下に示します。
プロパティの分類 | プロパティ名（プロパティの設定内容） | データ型 |
|---|---|---|
string | ||
string | ||
string | ||
int |
Formsクラスのメソッドを以下に示します。
メソッドの分類 | メソッドの概要 | ||
|---|---|---|---|
W64 | void | 帳票を出力するための入力データとなるレコード（行）文字列を追加します。 | |
|
帳票名と帳票格納ディレクトリを指定して、帳票と入力データのセットを保持するFormsオブジェクトを生成します。
ここで指定した帳票名は、ChangeFormプロパティで帳票を切り替えるまでの間、指定されたデータの帳票として使用します。
帳票名を指定します。
マルチフォーム出力する場合は、一番目に出力する帳票の帳票名を指定します。
帳票格納ディレクトリをフルパスで指定します。
帳票格納ディレクトリは、アプリケーションサーバの帳票格納ディレクトリを指定してください。
PrintException
コネクタ連携時に帳票を転送しない場合、帳票出力サーバの帳票格納ディレクトリは、PrintPropertiesクラスのRemoteDirectoryプロパティで指定してください。
帳票格納ディレクトリ名を指定する場合、以下の注意事項があります。
マルチフォーム出力する場合、使用する帳票をChangeFormプロパティで切り替えてください。
組合せフォーム出力する場合は、Forms(string formname, string assets, string cbformname) コンストラクタを使用してください。
|
帳票名と帳票格納ディレクトリ、および組合せフォーム名を指定して、帳票と帳票データのセットを保持するForms オブジェクトを生成します。
ここで指定した帳票名と組合せフォーム名は、ChangeFormプロパティやChangeCbFormプロパティで切り替えるまでの間、指定されたデータの組合せフォーム、および指定されたデータの帳票として使用します。
帳票名を指定します。
一番目に出力する帳票名を指定します。
帳票格納ディレクトリをフルパスで指定します。
組合せフォーム名を指定します。
PrintException
コネクタ連携時に帳票を転送しない場合、帳票出力サーバの帳票格納ディレクトリは、PrintPropertiesクラスのRemoteDirectoryプロパティで指定してください。
組合せフォーム出力しない場合は、Forms(String formname, String assets) コンストラクタを使用してください。
マルチフォーム出力する場合、または組合せフォーム出力する場合、使用する帳票をChangeFormプロパティで切り替えてください。また、使用する組合せフォーム名を ChangeCbFormプロパティで切り替えてください。
マルチフォーム出力/組合せフォーム出力をする場合に、使用する帳票を切り替えます。このプロパティ以降にpushRecordメソッドで指定した入力データは、この帳票の入力データとなります。
注意
マルチフォーム出力、または組合せフォーム出力をする場合は、使用する帳票をこのプロパティで切り替えてから、pushRecordメソッドで帳票名や組合せフォーム名を含めずにレコード（行）文字列を指定してください。
複数の組合せフォーム出力する場合に、使用する組合せフォーム名を切り替えます。このプロパティ設定以降にpushRecord メソッドで指定した入力データは、この組合せフォームの入力データとなります。
注意
複数の組合せフォームを出力する場合は、使用する組合せフォーム名をこのプロパティで切り替えてください。
また、ChangeFormプロパティで使用する帳票を切り替えてから、pushRecordメソッドで組合せフォーム名と帳票名を含めずにレコード（行）文字列を指定してください。
組合せフォーム定義ファイル名をフルパスで指定します。
組合せフォーム定義ファイルとは、組み合わせて出力する帳票定義情報と、帳票定義情報の重なり順などが定義されたファイルです。
このプロパティの呼び出しを省略すると、帳票格納ディレクトリ配下の組合せフォーム定義ファイル(Lccbform.ini）が有効になります。
注意
組合せフォーム定義ファイルの文字コード系については、オンラインマニュアル“帳票設計編”を参照してください。
コネクタ連携時に、アプリケーションサーバから組合せフォーム定義ファイルを転送した場合、組合せフォーム定義ファイルは、このプロパティとLcFileプロパティの両方で指定してください。その場合、このプロパティには、ファイル名のみ指定してください。
入力データの文字コードを指定します。
Shift-JIS
UNICODE（UTF8）
注意
このプロパティは、pushRecordメソッドを指定する前に指定してください。pushRecordメソッド指定後、このプロパティは指定できません。
Unicodeの文字が定義されている帳票定義情報を使用する場合、「CODE_UTF8」を指定してください。
英語環境（英語ロケール）で帳票出力する場合は、「CODE_UTF8」を指定してください。
|
帳票を出力するための入力データとなるレコード（行）文字列を追加します。
レコード（行）文字列を指定します。
1レコード（行）ずつレコード（行）文字列をセットしてください。
レコード（行）文字列には改行コードを含めないでください。
PrintException
マルチフォーム出力/組合せフォーム出力する場合は、使用する帳票をChangeFormプロパティで切り替えてから、このメソッドで帳票名を含めずにレコード（行）文字列を指定してください。
複数の組合せフォームを出力する場合は、使用する組合せフォーム名をChangeCbFormプロパティで切り替えてから、このメソッドで組合せフォーム名と帳票名を含めずにレコード（行）文字列を指定してください。
帳票出力時の文字コードを指定する場合、このメソッド指定前にDataCodeプロパティで文字コードを指定してください。
帳票の入力データ形式が「XML形式」の場合は、このクラスを使用して帳票出力できません。FormsFileクラスを使用してください。
ファイル名、ファイルの格納先の指定に関する注意事項については、以下を参照してください。