バージョン 4.2.5	検索   索引   目次   |   PDF ブック   |   ホーム   上へ   戻る   次へ

このドキュメントでは、次のトピックについて説明します。

• 機能

• 構文説明

• 受信／送信データのエンコード

• 例

構文図で使用されている記号については、「構文記号」を参照してください。

関連機能グループ：「インターネットと XML」

機能

REQUEST DOCUMENT ステートメントは、外部システムにアクセスする方法を提供します。『プログラミングガイド』の「インターネットおよび XML アクセス用のステートメント」を参照してください。

Unicode サポートの詳細については、『Unicode およびコードページのサポート』ドキュメントの「ステートメント」を参照してください。

プロトコルタイプに対する制限事項

技術的な理由で、HTTPS は z/OS でのみサポートされています。

クッキーに対する制限事項

HTTP プロトコル下では、クライアントワークステーションの状況についての情報を維持するために、サーバーはクッキーを使用します。

REQUEST DOCUMENT は、インターネットオプション設定を使用して実装されます。 これは、セキュリティ設定に依存してクッキーが使用されることを意味しています。

インターネットオプション設定 Disabled（使用不可）が設定されている場合、クッキーヘッダー（operand 4/5）が送信されても、クッキーは送信されません。

サーバー環境に対して、インターネットオプション設定 Prompt を使用しないでください。 クライアントはプロンプトに答えることができないため、この設定によりサーバーが "ハングアップ" します。

メインフレーム環境ではクッキーはサポートされていないため、無視されます。

構文説明

オペランド定義テーブル：

構文要素の説明

HTTP/1.0 200 OK

自動生成ヘッダー（operand4/5）

Request-Method

operand5 では、HEAD、POST、GET、および PUT がサポートされています。

次の表は、指定されたオペランドに応じた Request-Method の自動的な計算を示しています。

Content-Type

要求メソッドが POST の場合、コンテンツタイプヘッダーを HTTP 要求で配信する必要があります。 コンテンツタイプが明示的に設定されていない場合、operand5 に対して次の値が自動的に生成されます。

application/x-www-form-urlencoded

注意:
自動的に生成されたヘッダーを上書きすることは可能です。 Natural はエラーについてそれらをチェックしません。 予期しないエラーが起こるかもしれません。

URL エンコードに対する一般的な注意

コンテンツタイプ application/x-www-form-urlencoded で POST データを送信するとき、一定の文字が URL エンコードによって表される必要があります。これは、%16 進文字コードの文字で代用することを意味しています。 URL エンコードが必要なときとその理由の詳細については、RFC 1630、RFC 1738、RFC 1808 を参照してください。 ここでは、いくつかの基本的な詳細を示します。 すべての非 ASCII 文字（つまり、ASCII 文字でもない有効な ISO 8859/1 文字）は URL エンコードする必要があります。例えば、ファイル köln.html は URL で k%F6ln.html として表示されます。

Web ページが電子メールによって要求されるとき、いくつかの文字が "危険" と考えられます。

これらの文字は次のとおりです。

URL を記述するとき、これらの文字の URL エンコードが必要です。

いくつかの文字は URL で特別な意味を持っています。例えば、コロン（:）は URL の残りから URL スキームを区別し、2 つのスラッシュ（//）は URL が共通インターネットスキーム構文とパーセント記号（%）に対応することを示します。 一般的に、これらの文字がファイル名の一部として出現するときには、それらを URL の特別な意味と区別するために、URL エンコードが必要です。これは単純化のためです。詳細については、RFC を参照してください。

これらの文字は次のとおりです。

レスポンス番号の概要 - HTTP/HTTPS 要求

レスポンス 301～303（リダイレクション）

リダイレクションは、要求された URL が移動したことを意味しています。 レスポンスとして、LOCATION という名前の Return Header が表示されます。 このヘッダーには、要求されたページが移動した URL が含まれます。 新しい REQUEST DOCUMENT 要求は、移動したページを検索するために使用できます。

HTTP ブラウザは新しい URL に自動的にリダイレクトしますが、REQUEST DOCUMENT ステートメントはリダイレクションを自動的に処理しません。

レスポンス 401（拒否）

レスポンス Access Denied は、有効なユーザー ID とパスワードが要求で提供される場合にのみ、要求されたページにアクセスできることを意味しています。 レスポンスとして、WWW-AUTHENTICATE という名前の Return Header が、この要求に必要な領域で提供されます。

HTTP ブラウザは、通常、ユーザー ID とパスワードによってダイアログを表示しますが、REQUEST DOCUMENT ステートメントではダイアログは表示されません。

受信／送信データのエンコード

REQUEST DOCUMENT ステートメントを使用したデータ転送では、通常、コードページ変換は呼び出されません。 特定のコードページで受信／送信データをエンコードする場合、DATA ALL 節または RETURN PAGE 節でその指定を行います。

• DATA ALL 節

• RETURN PAGE 節

DATA ALL 節

送信データのエンコードには、DATA ALL 節を使用します。

構文の説明：

RETURN PAGE 節

受信データのエンコードには、RETURN PAGE 節を使用します。

HTTP/HTTPS 要求のレスポンスとして、受信データにバイナリデータ（例えば image/gif）または文字データ（例えば text/html）が含まれることがあります。 REQUEST DOCUMENT ステートメントは、レスポンスとともに、要求したドキュメントのコンテンツタイプ（MIME タイプ）を指定するパラメータを受け取ります。 このパラメータには、ドキュメントのエンコードに使用されるコードページに関する情報が含まれることがあります。

この節により、Natural セッションのデフォルトコードページ（システム変数 *CODEPAGE の値）への自動変換が実行されます。

構文の説明：

注意:
"返される MIME タイプにエンコードが含まれる" ということは、HTTP サーバーから charset= 節（例：charset=ISO-8859-1）を含むコンテンツタイプヘッダーが返されることを意味します。

RETURN PAGE ENCODED 節の使用サンプル

1. サーバーからヘッダー 'Content-type: text/html;charset=UTF-8' が返されます。

   プログラムコードサンプル 1：

   ... RETURN PAGE operand13

   処理結果：

   operand13 は UTF-8 エンコードのまま変わりません。

   プログラムコードサンプル 2：

   ... RETURN PAGE operand13 ENCODED [..]

   処理結果：

   operand13 は、後で指定される operand15 および operand14 に関係なく、UTF-8 からデフォルトコードページに変換されます。 つまり、返されたコンテンツタイプヘッダーで有効なエンコードが見つかったため、operand14 と operand15 は評価されません。

2. サーバーからヘッダー 'Content-type: text/xml' が返されます。

   プログラムコードサンプル 1：

   ... RETURN PAGE operand13 ENCODED

   処理結果：

   コンテンツタイプヘッダーに有効なエンコードが含まれていないため、operand13 は未変換のまま変わりません。

   プログラムコードサンプル 2：

   ... RETURN PAGE operand13 ENCODED FOR TYPES 'text/xml' IN CODEPAGE 'USASCII' 

   処理結果：

   operand13 は、USASCII コードページからデフォルトコードページに変換されます。 この場合、受け取るページのエンコードに関するプログラマの想定に基づいて変換が行われます。

   プログラムコードサンプル 3：

   ... RETURN PAGE operand13 ENCODED FOR TYPES 'text/html' IN CODEPAGE ' ' 

   処理結果：

   operand14 で指定された MIME タイプ 'text/html' が、コンテンツタイプヘッダーで返された MIME タイプ 'text/xml' と一致しないため、operand13 は未変換のまま変わりません。

   プログラムコードサンプル 4：

   ... RETURN PAGE operand13 ENCODED IN CODEPAGE ' ' 

   処理結果：

   operand13 は、プロファイルパラメータ XML のサブパラメータ RDCP で指定されたデフォルトコードページからデフォルトコードページに変換されます。

   注意:
   RDCP サブパラメータのデフォルト値は 'ISO-8859-1' で、明示的な指定が何もない場合に適用されます。 『パラメータリファレンス』の「XML - PARSE XML および REQUEST DOCUMENT ステートメントの有効化」も参照してください。

例

• 例 1 - 一般的な要求

• 例 2 - 単純な Get 要求（データなし）

• 例 3 - 単純な Head 要求（戻りページなし）

• 例 4 - 単純な Post 要求（デフォルト）

• 例 5 - 単純な Put 要求（すべてのデータを処理）

注意:
このステートメントのダイアログ例 V5-RDOC がライブラリ SYSEXV にあります。

例 1 - 一般的な要求

REQUEST DOCUMENT FROM "http://bolsap1:5555/invoke/sap.demo/handle_RFC_XML_POST" 
  WITH
    USER #User PASSWORD #Password
    DATA
    NAME 'XMLData'       VALUE #Queryxml
    NAME 'repServerName' VALUE 'NT2'
  RETURN
    PAGE #Resultxml
RESPONSE #rc

例 2 - 単純な Get 要求（データなし）

REQUEST DOCUMENT FROM "http://pcnatweb:8080"
  RETURN
    PAGE #Resultxml
RESPONSE #rc

例 3 - 単純な Head 要求（戻りページなし）

REQUEST DOCUMENT FROM "http://pcnatweb"
RESPONSE #rc

例 4 - 単純な Post 要求（デフォルト）

REQUEST DOCUMENT FROM "http://pcnatweb/cgi-bin/nwwcgi.exe/sysweb/nat-env"
  WITH 
    DATA 
    NAME 'XMLData'       VALUE #Queryxml
    NAME 'repServerName' VALUE 'NT2'
  RETURN
    PAGE #Resultxml
RESPONSE #rc

例 5 - 単純な Put 要求（すべてのデータを処理）

REQUEST DOCUMENT FROM "http://pcnatweb/test.txt"
  WITH 
    DATA ALL     #document
  RETURN
    PAGE #Resultxml
RESPONSE #rc

www.softwareag.com

Copyright © Software AG 1979-2009. All rights reserved.

検索   索引   目次   |   PDF ブック   |   ホーム   上へ   戻る   次へ