更改应用的图表设置。
如应用中存在两个名字一样的图表，或者更新后发生了图表名字重复的情况，执行该API时会报错。

此API仅将应用的更改反映到确认应用各动作的测试环境中。
如需反映到正式环境，执行本API后，需要执行将应用的设置反映到正式环境中API。

URI

https://(子域名).cybozu.cn/k/v1/preview/app/reports.json

来宾空间内的应用

https://(子域名).cybozu.cn/k/guest/(空间ID)/v1/preview/app/reports.json

HTTP 方法

PUT

必要的访问权限

应用的管理权限

请求参数

应答的范例

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

正文

{
  "app": "1",
  "reports": {
    "初始设置": {
      "chartType": "BAR",
      "chartMode": "NORMAL",
      "name": "初始设置",
      "index": "0",
      "groups": [
        {
          "code": "单选框"
        }
      ],
      "aggregations": [
        {
          "type": "COUNT"
        }
      ],
      "filterCond": "",
      "sorts": [
        {
          "by": "TOTAL",
          "order": "DESC"
        }
      ],
      "periodicReport": null
    },
    "各种图表的设置": {
      "chartType": "TABLE",
      "name": "各种图表的设置",
      "index": "1",
      "groups": [
        {
          "code": "单选框"
        },
        {
          "code": "创建时间",
          "per": "YEAR"
        },
        {
          "code": "时间",
          "per": "MINUTE"
        }
      ],
      "aggregations": [
        {
          "type": "COUNT"
        },
        {
          "type": "SUM",
          "code": "数值"
        },
        {
          "type": "AVERAGE",
          "code": "计算"
        },
        {
          "type": "MAX",
          "code": "创建时间"
        },
        {
          "type": "MIN",
          "code": "时间"
        }
      ],
      "filterCond": "记录编号 = \"1\" and 文本编辑器 like \"aaa\"",
      "sorts": [
        {
          "by": "TOTAL",
          "order": "DESC"
        },
        {
          "by": "GROUP1",
          "order": "ASC"
        },
        {
          "by": "GROUP2",
          "order": "DESC"
        }
      ],
      "periodicReport": null
    },
    "定期报表ON": {
      "chartType": "BAR",
      "chartMode": "NORMAL",
      "name": "定期报表ON",
      "index": "2",
      "groups": [
        {
          "code": "单选框"
        }
      ],
      "aggregations": [
        {
          "type": "COUNT"
        }
      ],
      "filterCond": "",
      "sorts": [
        {
          "by": "TOTAL",
          "order": "DESC"
        }
      ],
      "periodicReport": {
        "active": true,
        "period": {
          "every": "QUARTER",
          "pattern": "JAN_APR_JUL_OCT",
          "dayOfMonth": "END_OF_MONTH",
          "time": "23:30"
        }
      }
    }
  },
  "revision": "2"
}

应答

参数

应答的范例

{
  "revision": "2",
  "reports": {
    "初始设置": {
      "id": "7319"
    },
    "各种图表的设置": {
      "id": "7321"
    },
    "定期报表ON": {
      "id": "7323"
    }
  }
}

JavaScript 范例

使用API请求发送 kintone REST API 请求

var body = {
  'app': kintone.app.getId(),
  'reports': {
    '初始设置': {
      'chartType': 'BAR',
      'chartMode': 'NORMAL',
      'name': '初始设置',
      'index': '0',
      'groups': [
        {
          'code': '单选框'
        }
      ],
      'aggregations': [
        {
          'type': 'COUNT'
        }
      ],
      'filterCond': '',
      'sorts': [
        {
          'by': 'TOTAL',
          'order': 'DESC'
        }
      ],
      'periodicReport': null
    },
    '各种图表的设置': {
      'chartType': 'TABLE',
      'name': '各种图表的设置',
      'index': '1',
      'groups': [
        {
          'code': '单选框'
        },
        {
          'code': '创建时间',
          'per': 'YEAR'
        },
        {
          'code': '时间',
          'per': 'MINUTE'
        }
      ],
      'aggregations': [
        {
          'type': 'COUNT'
        },
        {
          'type': 'SUM',
          'code': '数值'
        },
        {
          'type': 'AVERAGE',
          'code': '计算'
        },
        {
          'type': 'MAX',
          'code': '创建时间'
        },
        {
          'type': 'MIN',
          'code': '时间'
        }
      ],
      'filterCond': '记录编号 = \'1\' and 文本编辑器 like \'aaa\'',
      'sorts': [
        {
          'by': 'TOTAL',
          'order': 'DESC'
        },
        {
          'by': 'GROUP1',
          'order': 'ASC'
        },
        {
          'by': 'GROUP2',
          'order': 'DESC'
        }
      ],
      'periodicReport': null
    },
    '定期报表ON': {
      'chartType': 'BAR',
      'chartMode': 'NORMAL',
      'name': '定期报表ON',
      'index': '2',
      'groups': [
        {
          'code': '单选框'
        }
      ],
      'aggregations': [
        {
          'type': 'COUNT'
        }
      ],
      'filterCond': '',
      'sorts': [
        {
          'by': 'TOTAL',
          'order': 'DESC'
        }
      ],
      'periodicReport': {
        'active': true,
        'period': {
          'every': 'QUARTER',
          'pattern': 'JAN_APR_JUL_OCT',
          'dayOfMonth': 'END_OF_MONTH',
          'time': '23:30'
        }
      }
    }
  },
  'revision': '2'
};
kintone.api(kintone.api.url('/k/v1/preview/app/reports', true), 'PUT', body, function(resp) {
  // success
  console.log(resp);
}, function(error) {
  // error
  console.log(error);
});

使用 XMLHttpRequest 的请求

var body = {
  'app': kintone.app.getId(),
  'reports': {
    '初始设置': {
      'chartType': 'BAR',
      'chartMode': 'NORMAL',
      'name': '初始设置',
      'index': '0',
      'groups': [
        {
          'code': '单选框'
        }
      ],
      'aggregations': [
        {
          'type': 'COUNT'
        }
      ],
      'filterCond': '',
      'sorts': [
        {
          'by': 'TOTAL',
          'order': 'DESC'
        }
      ],
      'periodicReport': null
    },
    '各种图表的设置': {
      'chartType': 'TABLE',
      'name': '各种图表的设置',
      'index': '1',
      'groups': [
        {
          'code': '单选框'
        },
        {
          'code': '创建时间',
          'per': 'YEAR'
        },
        {
          'code': '时间',
          'per': 'MINUTE'
        }
      ],
      'aggregations': [
        {
          'type': 'COUNT'
        },
        {
          'type': 'SUM',
          'code': '数值'
        },
        {
          'type': 'AVERAGE',
          'code': '计算'
        },
        {
          'type': 'MAX',
          'code': '创建时间'
        },
        {
          'type': 'MIN',
          'code': '时间'
        }
      ],
      'filterCond': '记录编号 = \'1\' and 文本编辑器 like \'aaa\'',
      'sorts': [
        {
          'by': 'TOTAL',
          'order': 'DESC'
        },
        {
          'by': 'GROUP1',
          'order': 'ASC'
        },
        {
          'by': 'GROUP2',
          'order': 'DESC'
        }
      ],
      'periodicReport': null
    },
    '定期报表ON': {
      'chartType': 'BAR',
      'chartMode': 'NORMAL',
      'name': '定期报表ON',
      'index': '2',
      'groups': [
        {
          'code': '单选框'
        }
      ],
      'aggregations': [
        {
          'type': 'COUNT'
        }
      ],
      'filterCond': '',
      'sorts': [
        {
          'by': 'TOTAL',
          'order': 'DESC'
        }
      ],
      'periodicReport': {
        'active': true,
        'period': {
          'every': 'QUARTER',
          'pattern': 'JAN_APR_JUL_OCT',
          'dayOfMonth': 'END_OF_MONTH',
          'time': '23:30'
        }
      }
    }
  },
  'revision': '2',
  // CSRF TOKEN: 在kintone上执行API（POST，PUT，DELETE）时必须设置
  '__REQUEST_TOKEN__': kintone.getRequestToken()
};
var url = 'https://{subdomain}.cybozu.cn/k/v1/preview/app/reports.json';
var xhr = new XMLHttpRequest();
xhr.open('PUT', url);
xhr.setRequestHeader('X-Requested-With', 'XMLHttpRequest');
xhr.setRequestHeader('Content-Type', 'application/json');
xhr.onload = function() {
  if (xhr.status === 200) {
    // success
    console.log(JSON.parse(xhr.responseText));
  } else {
    // error
    console.log(JSON.parse(xhr.responseText));
  }
};
xhr.send(JSON.stringify(body));