変更の始まり

nsprefix

nsprefix オプションは、 オプション ns=remove が指定された場合に XML 名から除去された名前空間の 値を RPG プログラムが判別することを可能にします。

nsprefix オプションは、名前空間の値を 受け取るサブフィールドの名前の接頭部を指定します。nsprefix オプション は、オプション ns=remove が指定されていない場合は無視されます。

例えば、XML エレメント <abc:def>hello</abc:def> と、 オプション ns=remove および nsprefix=PFX_ が指定されている場合、 RPG サブフィールド DEF は値「hello」を、 RPG サブフィールド PFX_DEF は値「abc」を受け取ります。

nsprefix オプションに関する規則:
  1. nsprefix サブフィールドは英数字タイプまたは UCS-2 タイプでなければなりません。
  2. XML データと突き合わせられるサブフィールドが配列である場合、nsprefix サブフィールド も、要素数が同じ配列でなければなりません。XML データと突き合わせ られるサブフィールドが配列ではない場合、nsprefix サブフィールド は配列であってはなりません。
  3. XML 要素に名前空間が付いていない場合、nsprefix サブフィールドには空ストリング '' が入れられます。
  4. nsprefix サブフィールドとして正しい名前を持つサブフィールド があるが、nsprefix サブフィールドであるための基準が満たされない場合、それはエラーとは見なされません。例えば、nsprefix=ns が 指定され、データ構造内に、要素が 2 つある配列サブフィールド NAME と、 要素が 3 つある英数字配列サブフィールド NSNAME がある場合、 サブフィールド NSNAMEnsprefix サブフィールドであるとは見なされず、 したがって、XML-INTO はその値を設定するための XML データが見つかることを予期します。
  5. case オプションは、 nsprefix サブフィールドに入れられる名前空間値に影響しません。例えば、case=convert オプション が指定されていて、XML 名が a--b:name の場合、値 "a--b" が nsprefix サブフィールドに入れられます。
  6. datasubf サブフィールドには nsprefix オプションは考慮されません。
変更の終わり