ユーザマニュアル




2023/09/22

MANUAL

開発者向け機能:スクリプト:$p.apiGet

## 概要 指定したサイトのレコード情報を取得します。[サイト統合](/ja/manual/table-site-integration)を設定しているテーブルの場合は、統合された各レコードの情報もあわせて取得します。 ## 制限事項 1. 取得できるレコードの件数は Api.json の PageSize(デフォルトで 200) が最大となります。200件以上のレコードを取得する場合は、[FAQ:API で 200 レコードを超えるデータを取得したい](/ja/manual/faq-api-paging)をご参照ください。 ## 構文 ##### JavaScript ``` $p.apiGet({ id: <サイトID>, data: { <取得条件> }, done: <任意の処理>, fail: <任意の処理>, always: <任意の処理> }); ``` ## 各パラメータの説明 |パラメータ名|説明|必須| |:--|:--|:--:| |id|操作対象のサイトID、またはレコードIDを指定。|○| |data|POSTするJSONデータを指定。[JSONデータレイアウト:View](/ja/manual/api-view)、テーブル種類(TableType)を指定することが可能。指定可能なテーブル種類については下記の "テーブル種類について" をご確認ください。 |-| |done|API通信成功時の処理を記述。|-| |fail|API通信失敗時の処理を記述。|-| |always|API通信の最後に行う処理を記述。|-| ### テーブル種類について テーブル種類(TableType)に指定可能な値は以下の通りです。 |値|説明| |:--|:--| |Normal|指定したサイトのレコード情報を取得する場合に指定します。取得するレコード情報は履歴が最新バージョンです。また、こちらの値はTableTypeの既定値で、TableTypeを指定しない場合は、内部ではこの値が設定されて処理が行われます。| |History|指定したサイトのレコードの履歴情報を取得する場合に指定します。取得するレコード情報は履歴が過去バージョン(最新バージョンは含まない)です。| |NormalAndHistory|指定したサイトのレコード情報と履歴情報を合わせて取得する場合に指定します。取得するレコード情報は履歴が全てのバージョンです。| ## 使用例① POSTするデータに "View" のJSONデータレイアウトを指定する場合は以下のように記述します。"View" のレイアウトについては[JSONデータレイアウト:View](/ja/manual/api-view)をご確認ください。 ##### JavaScript ``` $p.apiGet({ id: 123, data: { View: { ApiDataType: "KeyValues", GridColumns: ["Title", "ClassA"] } }, done: function (data) { alert('通信が成功しました。'); } }); ``` ## 使用例② POSTするデータに テーブル種類 "TableType" を指定する場合は以下のように記述します。 ##### JavaScript ``` $p.apiGet({ id: 123, data: { TableType: 'History' }, done: function (data) { alert('通信が成功しました。'); } }); ``` ## 使用例③ POSTするデータに "View" のJSONデータレイアウト、テーブル種類 "TableType" を指定する場合は以下のように記述します。 ##### Javascript ``` $p.apiGet({ id: 123, data: { View: { ColumnFilterHash:{ ClassA: '中野区' } }, TableType: 'History' }, done: function (data) { console.log(data); } }); ```
TOP
このページをシェアする
記載された商品名、各製品名は各社の登録商標または商標です。 © Implem Inc.