サイト定義仕様

以下に楽天カードのサイト定義のサンプルを示します。

サイト定義は、大きく次の4種類のパートに分けられます。

以下にサンプルの内容を説明します。

サイトの識別情報を指定しています。

指定可能なサイト分類とサイト種類の組み合わせは以下のとおりです。
サイト種類によってメイン画面でサイト情報が表示されるセクションが決まります。 また、指定可能なパラメータも異なります。
Siteポイント以外もポイント情報を取得することが可能です。 そのため、Siteポイントで指定可能なパラメータは、全てのサイト種類で指定可能です。

サイトにログインするために必要なIDやパスワード等の項目名を指定しています。 ここで指定された項目に対する入力フィールドがサイト登録画面に表示され、 入力された値がデータファイルに暗号化されて保存されます。
項目名の前に*を付けるとサイト登録画面の入力フィールドがパスワード表示になります (サイト定義画面ではパスワード表示になりません)。
項目名の前に-または@を付けると、サイト登録画面の入力フィールドが前の入力フィールドと 同じ列に表示され、項目名を表示しません(例: 三井住友銀行のサンプル)。

サイトのURLを指定しています。

②で定義したログイン情報をセットするタグを指定しています。 パラメータ名はログイン情報の名称、値にタグ指定を指定します。

ここではアカウントIDの取得のためのパラメータを指定しています。

ここでは、ログインボタンのタグ、ログアウトボタンのタグ、エラーメッセージの判定のためのタグと アカウントIDの取得、編集に関するタグを指定しています。
ログインボタンのタグとアカウントIDの取得のタグ以外は必須ではありません。
この他に、ログイン後のお知らせなどを取得するタグ等を指定することが出来ます。

ログイン後にアカウントIDを取得するために画面の遷移が必要な場合には、 パラメータのAccountNavigateを指定して画面の遷移をします。

残高情報が表示されている画面に遷移するアクションを指定しています。 残高情報が表示されている画面に遷移するために複数のアクションが必要な場合には、 AccountLoop1、AccountLoop2等の 連番を追加したパラメータを指定することが出来ます。

1つのアカウントに対して複数のカードが登録されている可能性があるので、 ナビゲートループのAccountLoop90を指定して、繰り返すようにしています。

残高情報を取得するタグを指定しています。 指定できるパラメータは、サイトの種類によって異なります。

確定済み請求明細を取得するタグを指定しています。 明細を取得するパラメータは、サイトの種類によって異なります。

明細データは、タブ区切りテキストになっている必要があります。
タブ区切りテキストは、

の順にする必要があります。
通常、明細はHTMLのテーブルで表現されていますので、 エディット指定の#formatでタブ区切りテキストに変換し、 #reorderでカラムの並べ替えをします。

ここでは、明細のリストが10件づつ表示されるサイト等への対応のために、 ナビゲートループを指定することも出来ます (例えば、次10件などのボタンが表示されている場合に、 ボタンをクリックして、次の明細を取得するためのアクションを指定することが出来ます)。
また、この例では全明細取得がtrueの時のためのパラメータも指定しています。 AllDetailKeysは、全明細取得がtrueの時たけに有効となるパラメータを指定します。

未確定の請求明細を取得するタグを指定しています。

明細表示のカスタマイズの指定することが出来ます。 明細のタイトルの変更、書式の変更などを指定できます。