Interstage Data Effector ユーザーズガイド

C.3.3 AsisExecuteAnalyze

■機能

入力ファイルよりグループごとにデータを集計し、結果をファイルに出力します。

■記述形式

#include "libAsis.h"                /* 公開ヘッダ                         */



int AsisExecuteAnalyze(

    ASISHANDLE      AHandle,         /* ハンドル                           */

    char            *CharacterCode,       /* 文字コード                         */

    char            *InFileType,     /* 入力ファイルタイプ                 */

    char            *InFile,         /* 入力ファイル                       */

    char            *OutFileType,    /* 出力ファイルタイプ                 */

    char            *OutFile,        /* 出力ファイル                       */

    char            *Gcondition,     /* グループ式                         */

    char            *Rcondition,     /* 集計式                             */

    char            *Gstring,        /* 出力用のグループキーの代替文字列 */

    char            *RootTagName,    /* 出力ルートタグ名                   */

    char            *Reserve2,       /* リザーブ(NULL)                     */

    char            *Reserve3)       /* リザーブ(NULL)                     */

■パラメタ

データ型	パラメタ	用途	説明
ASISHANDLE	AHandle	入力	ハンドルを指定します。
char*	CharacterCode	入力	検索対象となる文字列の文字コードを指定します。 本パラメタを省略した場合(NULL指定時)、UTF-8が指定されたとみなします。
char*	InFileType	入力	入力ファイルタイプを指定します。 本パラメタを省略した場合(NULL指定時)、CSVが指定されたとみなします。
char*	InFile	入力	入力ファイルを指定します。 本パラメタを省略した場合(NULL指定時)、標準入力より入力します。
char*	OutFileType	入力	出力ファイルタイプを指定します。 本パラメタを省略した場合(NULL指定時)、 CSVが指定されたとみなします。
char*	OutFile	入力	出力ファイルを指定します。 本パラメタを省略した場合(NULL指定時)、標準出力に出力します。
char*	Gcondition	入力	集計単位を指定するグループ式を指定します。 グループ式の詳細については、“A.2 グループ式”を参照してください。 1〜1024バイトの範囲で指定してください。
char*	Rcondition	入力	集計式を指定します。 集計式の詳細については、“A.3 集計式”を参照してください。 1〜65535バイトの範囲で指定してください。
char*	Gstring	入力	CSV形式で出力する場合に、グループ化に使用されていないグループ項目の値として、グループキーの代わりに出力される文字列を指定します。 出力ファイルタイプがCSV形式の場合に有効です。
char*	RootTagName	入力	集計結果を取りまとめるルートタグ名を指定します。 出力ファイルタイプがXML形式の場合に有効です。 本パラメタを省略した場合(NULL指定時)、出力結果を取りまとめるルートタグは出力されません。 詳細については、“4.4.3.2 集計結果をXML形式で出力する場合”を参照してください。
char*	Reserve2	-	NULLを指定します。
char*	Reserve3	-	NULLを指定します。

◆CharacterCode (文字コード)

設定	意味
UTF-8	UTF-8の場合
SHIFT-JIS	Shift_JISの場合
EUC	EUC-JPの場合

設定値を二重引用符(")で囲んで指定します。

◆InFileType/OutFileType (入力ファイルタイプ/出力ファイルタイプ)

設定	意味
CSV	CSVの場合
XML	XMLの場合

設定値を二重引用符(")で囲んで指定します。

◆InFile (入力ファイル)

[図：入力ファイルタイプがCSVの場合]

[図：入力ファイルタイプがXMLの場合]

• 本パラメタを省略した場合(NULL指定時)、または物理ファイル名を省略した場合は標準入力より入力します。
• 入力ファイルタイプがCSV形式の場合で、スキーマ情報を指定する場合は、スキーマ情報ファイル名と各物理ファイル名をセミコロン(;)で接続します。
• 入力ファイルタイプがCSV形式の場合で、スキーマ情報を指定しない場合は、各物理ファイル名をカンマ(,)で接続します。
• スキーマ情報を指定した場合、物理ファイル名に指定した各ファイルの先頭行には項目名が記述されていないものとみなし、データとして集計対象になります。
  スキーマ情報を指定しない場合、物理ファイル名に指定した各ファイルの先頭行には項目名が記述されているものとみなし、先頭行のデータを集計対象にしません。
• 入力ファイルタイプがXML形式で複数のファイルを指定する場合には 各物理ファイル名をカンマ(,)で接続します。

■復帰値

復帰値	説明
ASIS_SUCCESS	関数が正常に終了したことを示します。
ASIS_ERROR	関数の実行時に問題が検出されたことを示します。

■関数の利用規則

• OutFileパラメタで指定したファイルが存在する場合は上書きします。