SOAP_HEADER( header-key [, index, header-attribute ] )

LONG VARCHAR

この関数は、単一のパラメータ header-key を使用してヘッダエントリを返すときに使用します。ヘッダエントリは、SOAP ヘッダに含まれている要素と、その要素に含まれるすべての部分要素を XML 文字列で表現したものです。

この関数は、オプションの index と header-attribute パラメータを指定して、ヘッダエントリ属性を抽出するときにも使用できます。

この関数は、指定された SOAP ヘッダフィールドの値を返します。SOAP サービスから呼び出されていない場合は NULL を返します。Web サービスを介して SOAP 要求を処理する場合に使用します。

指定した header-key のヘッダが存在しない場合、戻り値は NULL です。

• NEXT_SOAP_HEADER 関数 [SOAP]
• sa_set_soap_header システムプロシージャ
• チュートリアル：SQL Anywhere を使用した SOAP/DISH サービスへのアクセス
• Web サービス関数
• Web サービスシステムプロシージャ

HTTP Web サービスによって呼び出されるストアドプロシージャ内で使用された場合、次の例は SOAP 要求ヘッダにあるすべてのキーを処理します。Authentication キーを処理するときに、キーの値も取得します。

BEGIN
  DECLARE hd_key LONG VARCHAR;
  DECLARE hd_entry LONG VARCHAR;
header_loop:
  LOOP
    SET hd_key = NEXT_SOAP_HEADER( hd_key );
    IF hd_key IS NULL THEN
      -- no more header entries
      LEAVE header_loop;
    END IF;
    IF hd_key = 'Authentication' THEN
      SET hd_entry = SOAP_HEADER( hd_key );
    END IF;
  END LOOP header_loop;
END;