InboundSeparatedValueハンドラーは、ポストされた区切り値を受信し、区切り値を応答として送信する場合に使用されます。
構文:
コマンド | キーワード | 値 | 開発者用メモ |
|---|---|---|---|
RECEIVE | HANDLER | InboundSeparatedValue | |
ARCHIVE | 任意。詳細は、「ARCHIVE」を参照してください。 | ||
SVROW | 任意。詳細は、「SVROW」を参照してください。 | ||
SVROWLIMIT | 任意。詳細は、「SVROWLIMIT」を参照してください。 | ||
SVMODE | 任意。詳細は、「SVMODE」を参照してください。 | ||
SVHEAD | 任意。詳細は、「SVHEAD」を参照してください。 | ||
ENCODING | 任意。詳細は、「ENCODING」を参照してください。 | ||
NUMBERFORMAT | 任意。詳細は、「NUMBERFORMAT」を参照してください。 | ||
CONTENT | 任意。詳細は、「CONTENT」を参照してください。 | ||
SEPARATOR | 任意。詳細は、「SEPARATOR」を参照してください。 |
このコンテンツ・ハンドラーのRECEIVEコマンドが実行されると、以下のステップが行われます。
- コンテンツやリスト引数がない場合、OKステータスが返されます。
- ハンドラーは、コンテンツ・タイプが区切り値グループに属しているかをチェックします。コンテンツ・タイプがサポートされていない場合、エラーがプログラムに返されます。このチェックをオーバーライドして、ハンドラーがデータを受信できるようにするにはCONTENTキーワードを使用します。データはCSVであることが前提です。
- ハンドラーは、受信バイト・ストリームのUnicode変換に適用されるエンコーディングを決定します。
- ハンドラーは、このUnicodeデータを保管する必要があるかどうかを判断します。
- ハンドラーは区切り値を読み込み、作業リストに入れます。
例
RECEIVE HANDLER(InboundSeparatedValue) SVHEAD(ORDER) #WRKLST
このコンテンツ・ハンドラーのSENDコマンドが実行されると、以下のステップが行われます。
- ハンドラーはCONTENTキーワードの値を使用して、作成する区切り値のタイプを決定します。
- コンテンツ値が使用できない場合、ハンドラーはapplication/comma-separated-valuesがデフォルトになります。
- コンテンツ値が*CSVの場合、コンテンツ・タイプはapplication/comma-separated-valuesになります。
- コンテンツ値が*TEXTCSVの場合、コンテンツ・タイプはtext/comma-separated-valuesになります。
- コンテンツ値が*TSVの場合、コンテンツ・タイプはapplication/tab-separated-valuesになります。
- コンテンツ値が*TEXTTSVの場合、コンテンツ・タイプはtext/tab-separated-valuesになります。
- コンテンツ値が有効な区切り値のコンテンツ・タイプではない場合、CSVデータは作成されますが、指定のコンテンツ・タイプが送信されます。
- オプションのSVHEADキーワードを使用すると、データの開始時にヘッダー・レコードを挿入できます。
- ハンドラーはリスト内のすべてのエントリーを使用してUnicodeデータを作成します。リスト引数がない場合、長さゼロのコンテンツが作成されます。
- ハンドラーは、このUnicodeデータを保管する必要があるかどうかを判断します。
- ハンドラーは、リモート・クライアントに返すHTTP応答を作成します。
オプションのUAFILEキーワードとUAPATHキーワードを使用して、コンテンツの推奨パスとファイル名をリモート・クライアント・プログラムに通知することができます。LANSA Integratorユーザー・エージェントは、これらのファイル名とパス名を、応答パネルの保存ポップアップ・メニューに追加します。
構文:
コマンド | キーワード | 値 | 開発者用メモ |
|---|---|---|---|
SEND | HANDLER | InboundSeparatedValue | |
STATUS | 値 | オプションHTTPステータス番号 | |
MESSAGE | 値 | オプションHTTPステータス・メッセージ | |
UAPATH | 値 | 任意。ユーザー・エージェント保存応答パス | |
UAFILE | 値 | 任意。ユーザー・エージェント保存応答ファイル名 | |
UACACHE | 値 | 任意。キャッシュ制御最大期間 | |
UADISPOSITION | 値 | 任意。コンテンツ処理のファイル名 | |
NUMBERFORMAT | 任意。詳細は、「NUMBERFORMAT」を参照してください。 | ||
CONTENT | *CSV | デフォルト | |
*TSV | TSVコンテンツを作成します。 | ||
ENCODING | 任意。詳細は、「ENCODING」を参照してください。 | ||
SVHEAD | 任意。詳細は、「SVHEAD」を参照してください。 | ||
SVEXCLUDE | 任意。詳細は、「SVEXCLUDE」を参照してください。 | ||
ARCHIVE | 任意。詳細は、「ARCHIVE」を参照してください。 | ||
CHARSET | *YES | 任意。charset属性を含めます。 | |
*NO | charset属性を含めません。 | ||
*TEXT | デフォルト | ||
SEPARATOR | 値 | 任意。詳細は、「SEPARATOR」を参照してください。 |
例
SEND HANDLER(InboundSeparatedValue) CONTENT(*CSV) UAFILE(order.csv) #WRKLST