バージョン 6.3.3	検索   索引   目次   |   PDF BOOKS   |   ホーム   上へ   戻る   次へ

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

• 機能

• 構文説明

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

• 例

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

機能

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

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

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

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

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

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

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

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

Windows 環境では、クッキーは Windows API により自動的に処理されます。 これは、ブラウザでクッキーが有効にされると、すべての受信クッキーが保存され、次の要求で自動的に送信されることを意味しています。

構文説明

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

構文要素の説明

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 要求

レスポンス 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 の現在のコードページへの自動変換を行います。

構文の説明：

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

例

• 例 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 1992-2008. All rights reserved.

検索   索引   目次   |   PDF BOOKS   |   ホーム   上へ   戻る   次へ