Index
レコード一覧のクエリ文字列を取得する
現在開いてるレコード一覧の絞り込み情報をクエリ文字列で取得できます。
- PCとモバイルで利用できます。
- スペースに貼りつけたアプリでは利用できません。
- 表示件数（limit）、表示開始位置（offset）、表示順（order by）を取得するには こちら を利用します。
- アプリの動作確認テスト画面、スペース内アプリも含まれます。
- 複数の条件の括弧がandやorでつなげられたクエリの場合、各括弧内の条件は最大で14個です。15個以上を指定したクエリの場合はエラーが発生します。表示するレコードの条件を指定と組み合わせて利用する場合にご注意ください。
→この時、左側と右側の各括弧内の条件は最大で14条件となります。
関数
| 環境 | 関数 |
|---|---|
| PC | kintone.app.getQueryCondition() |
| モバイル | kintone.mobile.app.getQueryCondition() |
引数
なし
返り値
- 文字列または null が返ります。
- レコード一覧画面で絞り込み条件がない場合は空文字列が返ります。
- 利用できない画面では null が返ります。
サンプル
利用できる画面
- レコード一覧画面
- グラフ画面
レコード一覧のクエリ文字列を取得する（オプション付き）
現在開いてるレコード一覧の絞り込み情報をクエリ文字列（オプション付き）で取得します。
- PCとモバイルで利用できます。
- スペースに貼りつけたアプリでは利用できません。
- アプリの動作確認テスト画面、スペース内アプリも含まれます。
関数
| 環境 | 関数 |
|---|---|
| PC | kintone.app.getQuery() |
| モバイル | kintone.mobile.app.getQuery() |
引数
なし
返り値
- 文字列または null が返ります。
- 利用できない画面では null が返ります。
- 絞り込みがない場合は、ソート順（order by）、表示件数（limit）、位置（offset）のクエリ文字列が返ります。 ※レコード一覧画面のみ
- ソート条件がない場合は、表示件数（limit）、位置（offset）のみのクエリ文字列が返ります。 ※レコード一覧画面のみ
- モバイルについて、アップデートオプションで「「モバイル版でレコードを絞り込む機能」を無効にする」を選択している場合に、表示件数（limit）、位置（offset）は取得されません。
サンプル
利用できる画面
- レコード一覧画面
- グラフ画面
フィールド要素を取得する
フィールドコードを指定して、レコード一覧から対応するフィールド要素の配列を取得します。
- PCとモバイルで利用できます。
- スペースに貼りつけたアプリでは利用できません。
- アプリの動作確認テスト画面、スペース内アプリも含まれます。
- 取得した DOM の style（装飾するための DOM）はサポート対象ですが、それ以外はサポート対象外となります
- DOM の内部構造を変更するような処理を行うと、kintone のバージョンアップ後に動作しなくなる可能性があります
関数
| 環境 | 関数 |
|---|---|
| PC | kintone.app.getFieldElements(fieldCode) |
| モバイル | kintone.mobile.app.getFieldElements(fieldCode) |
引数
| パラメータ名 | 指定する値 | 必須 | 説明 |
|---|---|---|---|
| fieldCode | 文字列 | 必須 | 取得するフィールドのフィールドコードを指定します。 |
返り値
- フィールド要素の配列または null が返ります。
- 利用できない画面では null が返ります。
- レコードが 1件もない場合は空配列が返ります。
- 該当するフィールドがない場合、表示されていないフィールドを指定した場合は null が返ります。
サンプル
取得できないフィールド
以下のフィールドを指定した場合は null が返ります。
- テーブル
- テーブルに含まれるフィールド
利用できる画面
- レコード一覧画面
その他
インライン編集中の状態で関数を使用した場合、編集 UI を含む要素が返ります。
レコード一覧のメニューの右側の空白部分の要素を取得する
- PCのみで利用できます。
- スペースに貼りつけたアプリでは利用できません。
関数
kintone.app.getHeaderMenuSpaceElement()
引数
なし
返り値
- メニュー（追加・一覧・絞り込み・グラフ）の右側の空白部分の要素を返します。
- 利用できない画面では null が返ります。
サンプル
利用できる画面
- レコード一覧画面
レコード一覧のメニューの下側の空白部分の要素を取得する
- PCのみで利用できます。
- スペースに貼りつけたアプリでは利用できません。
関数
kintone.app.getHeaderSpaceElement()
引数
なし
返り値
- メニュー（追加・一覧・絞り込みなど）とレコード一覧の間の空白部分の要素を返します
- 利用できない画面では null が返ります。
サンプル
利用できる画面
- レコード一覧画面
関連レコード一覧の参照先のアプリIDを取得する
関連レコード一覧のフィールドコードを指定して、参照先のアプリIDを取得します。
- PCのみで利用できます。
- スペースに貼りつけたアプリでは利用できません。
詳細は、レコード詳細情報取得 をご覧ください。
ルックアップフィールドの参照先のアプリIDを取得する
ルックアップフィールドのフィールドコードを指定して、参照先のアプリIDを取得します。
- PCのみで利用できます。
- スペースに貼りつけたアプリでは利用できません。
詳細は、レコード詳細情報取得 をご覧ください。
ヘッダーの下側の空白部分の要素を取得する
- モバイルのみで利用できます。
- スペースに貼りつけたアプリでは利用できません。
| カレンダービュー以外 | カレンダービュー |
|---|---|
 |
 |
詳細は、ヘッダーの下側の空白部分の要素を取得する をご覧ください。
一覧画面にて、JSからREST APIを使ってレコード更新後、リロードをせずに即時一覧に反映させたいです。
具体的には、レコードごとに「検収日を今日に変更」みたいなボタンを設置し、押すとREST APIで更新して画面に反映させたい考えです。
リロードするラグが嫌なので、kintone側でajaxで同じページのrecord/list.jsonを再読込してDOM反映させてほしいのです。
このような方法はありますでしょうか？
ちなみに、これをやる前に試したのは'app.record.index.edit.show'のタイミングでもう中身をそのように変更してreturn eventして書き換えられたものが入力フォームに反映されるだろうと踏んでやってみたのですが、フォームにも反映されず値にも反映されず。app.record.index.edit.showで有効なのはdisabledくらいなのですかね、残念です。
Masayuki Ishikawa 様
お世話になっております。developer network事務局です。
一覧画面でリロードなしで値を変更することはできません。
ご期待に沿えず申し訳ございません。
お世話になっております。
一覧画面の各レコードに表示する内容を変更したいです。
具体的には、アプリAの「予算単位」という項目に、現状「予算単位」しか表示されていないですが、
アプリA「予算単位」 + アプリB「予算単位名称」
という表示に変更したいです。
このように一覧の描画処理のようなことは可能でしょうか？
Yuta様
お世話になっております。cybozu developer network 運営でございます。
別アプリのレコードの一括取得をした上で、カスタマイズビューを用いて表示することで可能かと思います。
恐れ入りますが、こちらのコメント欄は記事内容のフィードバック目的となっているため、
記事から派生した技術的なご質問はcybozu developer コミュニティをご活用ください。
よろしくお願い致します。
「レコード一覧のメニューの右側の空白部分の要素を取得する」の説明に
「利用できる画面
レコード一覧画面」
があった方がいいと思います。
Mogami Takafumi 様
お世話になっております。cybozu developer network 運営でございます。
フィードバックくださり、ありがとうございます。
ご指摘いただいた内容について検討させていただきます。
今後とも、cybozu developer network をよろしくお願いいたします。
この記事では「複数の条件の括弧がandやorでつなげられたクエリの場合、各括弧内の条件は最大で14個です。15個以上を指定したクエリの場合はエラーが発生します。」と、記載されていますが、例示された条件より 沢山の条件を指定しても、エラーにはなりませんでした。
実際、フィルタリング条件をQueryに指定数るとlist.jsonなるURLに遷移するようですが、そのHTTP statusコードは200 ｏｋで、エラーメッセージは出力されませんでした。
それは、「15個以上を指定したクエリの場合はエラーが発生します」という記述が誤記だということを示します。
多分、この記事の作成日2014/05/08当時より 沢山の条件を指定可能になったのであろうとは 推定できますが、フィルタリング条件を動的かつ簡単に検索できるようなプラグインの開発を使用とした場合、検索条件の個数の上限を決めることができかねます。
つきましては、現時点で 正しい、Queryの上限値を掲載してください。
追伸。
境界条件を探ろうとして、orで連結した条件が38個のqueryconditionが2706文字未満の場合は、絞込結果が表示されて、
条件の個数は変えないで、like条件に含まれるキーワードの文字数を増やしたら、下記のメッセージのみが含まれる白い画面に成りました。
「
Bad Message 431
reason: Request Header Fields Too Large
」