一覧の設定の変更

フォローする

アプリの一覧の設定を変更します。

URI

https://(サブドメイン名).cybozu.com/k/v1/preview/app/views.json

ゲストスペースのアプリの場合:https://(サブドメイン名).cybozu.com/k/guest/(スペースのID)/v1/preview/app/views.json

HTTPメソッド

PUT

アクセス権

  • アプリに管理権限が必要です。
  • このAPIの実行には、APIトークンは使用できません。

リクエスト

パラメータ

指定するパラメータの一覧です。省略したパラメータの設定は変更されません。

パラメータ名 指定する値 必須 説明
app 数値 必須 アプリのIDを指定します。
views オブジェクト 必須 一覧の設定を表すオブジェクトです。複数の一覧を指定します。
views.(一覧名) オブジェクト 必須 各一覧の設定を表すオブジェクトです。「(一覧名)」には更新前の一覧名を指定します。
存在しない一覧を「(一覧名)」に指定した場合は、新規の一覧として追加します。
views.(一覧名).index 文字列 必須 一覧の表示順を数字で指定します。指定した数字の昇順に、一覧が並びます。
views.(一覧名).type 文字列 必須 一覧の表示形式を指定します。
  • 表形式の場合:LIST
  • カレンダー形式の場合:CALENDAR
  • カスタマイズ形式:CUSTOM
views.(一覧名).name 文字列 条件必須 一覧の名前を、64文字以内で指定します。新しい一覧を追加する場合は必須となり、「views(一覧名)」のキー名と同じ値を指定します。
views.(一覧名).fields 配列   表形式の一覧で、表示する各フィールドのコードを指定します。
views.(一覧名).date 文字列   カレンダー形式の一覧で、日付として使用するフィールドのコードを指定します。省略すると、更新日時フィールドが指定されます。
views.(一覧名).title 文字列   カレンダー形式の一覧で、タイトルとして使用するフィールドのコードを指定します。省略すると、レコード番号フィールドが指定されます。
views.(一覧名).html 文字列   カスタマイズ形式の一覧で、カスタマイズに使用するHTMLの内容を指定します。
views.(一覧名).pager 真偽値   カスタマイズ形式の一覧で、ページネーションを表示するかどうかを指定します。
  • 表示する場合(初期設定):true
  • 表示しない場合:false
views.(一覧名).filterCond 文字列   レコードの絞り込み条件をクエリ形式で指定します。クエリ形式については、次のページを参照してください。
レコードの一括取得(クエリで条件を指定)
views.(一覧名).sort 文字列   レコードのソート条件をクエリ形式で指定します。クエリ形式については、次のページを参照してください。
レコードの一括取得(クエリで条件を指定)
revision 数値   アプリの設定を変更する前のリビジョン番号を指定します。指定したリビジョンが最新ではない場合、リクエストはエラーになります。
指定を省略、または「-1」を指定すると、リビジョンはチェックされません。

リクエストの例

ヘッダ

PUT /k/v1/preview/app/views.json HTTP/1.1
Host: example.cybozu.com:443
X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=
Authorization: Basic QWRtaW5pc3RyYXRvcjpjeWJvenU=
Content-Type: application/json

ボディ

レスポンス

パラメータ

パラメータ名 値の種類 説明
revision 文字列 アプリの設定を変更したあとのリビジョン番号です。
views オブジェクト 一覧の情報を表すオブジェクトです。
views.(一覧名).id 文字列 ビューのIDです。

レスポンスの例

JavaScriptサンプル

kintone REST API

XMLHttpRequest

記事に関するフィードバック

直接的に記事と関連がないご質問はcybozu developer コミュニティをご活用ください。

ログインしてコメントを残してください。
Powered by Zendesk