0 この頁の本文へ

関連ページ

ページ案内

別サイトとデータをやり取りする方法。

しらぎくモバイルシステムには、別サイトからのデータを、クエリの形で受取り、また逆に別サイトにクエリの形で引渡す機能を持っております。

予め設定ファイルで外部から受取るべき、或いは外部に引渡すべきクエリ名を指定する事で、しらぎくモバイルシステム内では外部から受取ったクエリを保持したままサイト内を移動出来るようになります。

この場合、保持したいクエリに関して、クエリ名を持つか持たないかで扱い方が異なります。

クエリ名: クエリを記述する際に、「XXX=YYY」とした際のXXXの部分。CGIなどのウェブプログラムではこの名前を用いてクエリの種類を判別します。
クエリ値: クエリを記述する際に、「XXX=YYY」とした際のYYYの部分。いわゆる"値"になります。
クエリ名を持たないクエリ: クエリを「XXX=YYY」と記述せずに「XXX」と値だけを記述したクエリ。一部のウェブプログラムでこのようなクエリを扱うものがあります。

クエリ名を用いたクエリの場合。

クエリを、

クエリ名=クエリ値

と言う形で用いる場合は、以下の要領でご利用になれます。

外部サイトとやり取り出来るクエリ名・クエリ値の制限。

しらぎくモバイルシステムが実際に利用しているクエリはやり取り出来ません。
- 具体的には、以下のクエリ名は使えません。
  - 「pdx」で始まるクエリ名…H"リンクではデータの受渡しにこれらのクエリ名を用います。従いまして、H"リンクからデータを受取る場合を除いて使わないようにして下さい。
  - ea
  - ia
  - im
  - a
  - anch
  - panch
  - lang
  - pcd
  - t
  - ctc
  - test
  - この他、プラグインで利用しているクエリ名。
受取ったクエリはURLの後ろに附加されます。従いまして、クエリを受取った結果URLが長くなり過ぎる場合(512バイトを超えた場合、H"リンクでは255バイトを超えた場合)、クエリを維持出来なくなる可能性があります。

クエリ名を持つクエリの取扱い方。

予めやっておく事。

先ず、予め設定ファイルで外部から受取るべき、或いは外部に引渡すべきクエリ名を指定しておいて下さい。

クエリ名を用いないクエリの場合。

クエリ名を用いずにクエリを記述する場合、すなわち、URLの後ろにクエリの値のみを記述する場合は、以下の要領に従います。

外部サイトとやり取り出来るクエリ値の制限。

クエリ名を持たないクエリ値には、「=」「;」「&」を含める事は出来ません。含めた場合はクエリ値そのものが無効になるか、これらの文字で価が切り捨てられるかのどちらかとなります。
受取ったクエリはURLの後ろに附加されます。従いまして、クエリを受取った結果URLが長くなり過ぎる場合(512バイトを超えた場合、H"リンクでは255バイトを超えた場合)、クエリを維持出来なくなる可能性があります。

クエリ名を用いないクエリの取扱い方。

予めやっておく事。

先ず、予め設定ファイルで$noNameQuery変数に1を入れておいて下さい。

これの設定により、名前を持たないクエリを内部で保持する事が出来ます。

クエリの引渡し方。

外部サイトがクエリを引渡すには。

外部サイトがしらぎくモバイルシステムで構築されたサイトにクエリを引渡すには以下の二つの方法が使えます。

名前を持つクエリを引渡す場合。

<a>要素のhref属性に渡したいクエリを付けたURLを記述する

この場合、クエリ値が非アスキィ文字を含む場合は、URLエンコードしておく事をお勧めします。

具体的には以下のようにします(userIDクエリを渡す場合)。

<a href="しらぎくモバイルシステムで構築されたサイトのURL?userID=○○"> … </a>

<form>要素を用いて引渡す

この場合、メソッドがGETでもPOSTでも、<input type="hidden">要素で引渡しが可能になります。

action属性値のURLにクエリを付けて記述する事も可能ですが、ソフトバンクで不具合が起こり得ますので推奨しません。
<input type="hedden">要素で引渡す場合は、URLエンコードはしないで下さい。

具体的には以下のようにします(userIDクエリを渡す場合)。

<form action="しらぎくモバイルシステムで構築されたサイトのURL" method="post">
    <p>
        <input type="hidden" name="userID" value="○○">
            …
        </p>
    </form>

名前を持たないクエリを引渡す場合。

<a>要素のhref属性に渡したいクエリを付けたURLを記述する(1)

この場合、クエリ値が非アスキィ文字を含む場合は、URLエンコードしておく事をお勧めします。

また、名前の無いクエリでは、以下の二つの方法で扱う事が出来ます(XXXXXXクエリ値を渡す場合)。

名前をつけずにそのまま記述する

具体的には以下のようになります。

<a href="しらぎくモバイルシステムで構築されたサイトのURL?XXXXXX"> … </a>

クエリ名として「pdxEX」を用いる

「pdxEX」は内部で名前の無いクエリを扱うためのクエリ名ですが、このクエリ名を外部からも受け付けております。

具体的には以下のようになります。

<a href="しらぎくモバイルシステムで構築されたサイトのURL?pdxEX=XXXXXX"> … </a>

いずれの場合も、「;」または「&」で区切って他のクエリ名を持ったクエリを併記する事が出来ます。

例えば、前者の場合、名前の無いクエリと併せて「UserID=YYYYYY」と言うクエリと組合わせる場合は以下のいずれかで記述出来ます。

<a href="しらぎくモバイルシステムで構築されたサイトのURL?XXXXXX;UserID=YYYYYY"> … </a>

<a href="しらぎくモバイルシステムで構築されたサイトのURL?UserID=YYYYYY;XXXXXX"> … </a>

<form>要素によるフォームを通じて引渡す

この場合、メソッドがGETでもPOSTでも、<input type="hidden">要素で引渡しが可能になります。

また、name属性としては「pdxEX」を用います。

action属性値のURLにクエリを付けて記述する事も可能ですが、ソフトバンクで不具合が起こり得ますので推奨しません。
<input type="hedden">要素で引渡す場合は、URLエンコードはしないで下さい。

具体的には以下のようにします(XXXXXXクエリ値を渡す場合)。

<form action="しらぎくモバイルシステムで構築されたサイトのURL" method="post">
    <p>
        <input type="hidden" name="pdxEX" value="XXXXXX">
            …
        </p>
    </form>

外部サイトにクエリを引渡すには。

しらぎくモバイルシステムで構築されたサイトでは、予め指定されたクエリをサイト内外を問わず全てのリンクに附加します。

従いまして、しらぎくモバイルシステムで構築されたサイトから外部サイトにクエリを引渡したい場合は、<a>要素でも<form>要素でも引渡したいクエリ名は一切指定する必要はありません。

但し、端末の実装上の問題から、名前を持たないクエリに関しては、<form>要素を通じての引渡しは動作が保障出来ません。名前を持たないクエリを引渡す場合は<a>要素をお使い下さい。
- 特にgetメソッドの場合には、引渡されない場合があります。また、ソフトバンクの初期端末では、postメソッドでも値が受取れない場合があります。
URLに当該クエリを指定した場合、当該クエリの値を上書きしてしまいますので、引渡したいクエリ名を指定しないようにして下さい。
逆に当該クエリを引渡したくない場合は、action属性のURLに空のクエリ値を与えたクエリを付けて下さい(例：http://～?userID=)。この場合、名前をもたないクエリの場合は、クエリ名として「pdxEX」を用います。

尚、<form>要素でクエリを引渡した場合、ソフトバンクの非パケット・ステーション対応機(旧ジェイフォン初期端末を除く非パケット機)以外ではURLにクエリの形で附与されます。

ソフトバンクの非パケット・ステーション対応機の場合は、method="get"属性を与えているフォームでは標準入力にポストされます。その他の場合は他機種同様クエリの形となります。

ページ外へのご案内。

制作者へのご連絡