(2017/6/09 追記)6月11日に予定しておりましたAPI更新は延期になりました。
(2017/5/24 追記)5月14日に予定しておりましたAPI更新は6月11日に延期になりました。
(2017/6/14 追記)6月11日に予定しておりましたAPI更新は6月25日に延期になりました。
詳細はこちらをご確認ください。
2017年5月14日の定期メンテナンスの、kintone API、Garoon SOAP API、User APIの更新に関する情報をお知らせします。
お知らせの内容に追加、変更等ありましたら、こちらのコメントにて変更箇所を追記します。
また、APIドキュメントには仕様を順次公開していきます。
kintone REST API
追加される機能
- なし
修正される不具合
- 存在しないフィールドコードでテーブルの行を追加したときの挙動が不正
- 対象APIは次のとおりです。
- 挙動例1) テーブルに1行追加し、存在しないフィールドコードだけ指定した場合
- 修正前:空の行が2行できる
- 修正後:空の行が1行できる
- 挙動例2) テーブルに1行追加し、存在するフィールドコードと存在しないフィールドコードを指定した場合
- 修正前:値のある行と空の行が1行ずつできる
- 修正後:値のある行が1行できる
- スペース情報の取得APIのスキーマ情報が正しくない
スペース情報の取得APIのスキーマ情報をスキーマ情報の取得APIで取得した場合(/k/v1/apis/space/get.jsonで取得) - 修正前:
返却結果のresponse > properties > memberCountが以下のとおりになります。"memberCount":{"type":"integer"}
- 修正後:
返却結果のresponse > properties > memberCountが以下のとおりになります。
"memberCount":{"format":"long""type":"string"}
- レコードコメントの削除APIで、他のユーザーのコメントが削除できないエラーメッセージのコメントIDが不正(レコードIDになっている)
- 修正前:
「他のユーザーのコメント(id: <レコードID>)は削除できません。」
-
修正後:
「他のユーザーのコメント(id: <コメントID>)は削除できません。」
修正されるメッセージ
- アプリ情報の取得APIで、テンプレート化されたアプリのアプリID※を指定したときのエラーメッセージ
※アプリがテンプレート化される際にアプリIDが付与される従来の仕様のため - 修正前:
「不正なリクエストです。」
- 修正後:
「指定したアプリ(id: <アプリID>)が見つかりません。削除されている可能性があります。」
kintone JavaScript API
追加される機能
- なし
修正される不具合
- レコードを変更して画面に描画されるAPIで、一部のフィールドの種類で、順番だけを変更することができない
- 対象APIは次のとおりです。※スマートフォン用APIへの影響はありません。
- レコードに値をセットする
- レコード一覧画面の表示後イベント
- レコード一覧画面のフィールド値変更時イベント
- レコード追加画面が表示された時のイベント
- レコード追加画面のフィールド値変更時イベント
- レコード編集画面が表示された時のイベント
- レコード編集画面のフィールド値変更時イベント
- 対象フィールドは次のとおりです。
- ユーザーフィールド
- 組織フィールド
- グループ選択フィールド
- 対象APIで対象フィールドに対して、値の種類や数が同じまま順番だけ変更した場合
- 修正前:順番が反映されない。また、フィールド値変更時イベントが発生しない
- 修正後:順番が反映される。また、フィールド値変更時イベントが発生する
- 取得した計算フィールドの値が画面と異なる場合がある
計算フィールドを持つアプリについて以下の操作をしたときに、取得した値が画面上の値と異なる場合があります。 - レコードの値を取得するを実行したとき
- イベントハンドラで登録したコールバックが実行されるとき
- 挙動例1) 数値表示で値が大きいとき
- 修正前:取得した値は"987654321011.9999220736"、画面上は"987654321012"
- 修正後:取得した値は画面上と同じ"987654321012"
- 挙動例2) 日時表示で値が小数点表示のとき
- 修正前:取得した値は".1234"
- 修正後:取得した値は"0.1234"
- フィールド値変更時イベントのハンドラで計算フィールドの値をテーブルにセットできない場合がある
- 対象イベントは次のとおりです。※スマートフォン用APIへの影響はありません。
- 対象イベントのハンドラで計算フィールドの値をテーブルにセットしたとき
- 修正前:値が意図した計算結果にならない場合がある
- 修正後:値が常に意図した計算結果になる
- 関連レコードの「表示するレコードの条件」に計算フィールドを設定し、フィールド値変更時イベントを発生させると関連レコードの一覧がクリアされる
- 対象イベントは次のとおりです。
- 関連レコードの「表示するレコードの条件」に計算フィールドを設定し、対象イベントを発生させたとき
- 修正前:関連レコード一覧の表示がクリアされる
- 修正後:関連レコードの一覧の表示がクリアされない
- スマートフォン用イベントAPIでラジオボタンの値に空文字列を指定しても初期値の選択肢に書き換わらない
- 対象イベント(スマートフォン用)は次のとおりです。
- レコード追加画面が表示された時のイベント(※ラジオボタンの初期値以外が選択されたレコードの再利用時)
- レコード追加画面のフィールド値変更時イベント
- レコード編集画面が表示された時のイベント
- レコード編集画面のフィールド値変更時イベント
- 対象イベントでラジオボタンの値に空文字列("")を指定したとき
- 修正前:イベント発生前に選択されていた値のまま
- 修正後:初期値の選択肢になる
- (参考)フィールドの値を書き換える
「ラジオボタンフィールドで空文字列を指定した場合、初期値の選択肢となります。」
修正されるメッセージ
- インライン編集で編集権限のないフィールドのerrorプロパティに値を入れたときのエラーメッセージが不適切
- 対象イベントは次のとおりです。
- 対象イベントで、編集権限のないフィールドのerrorプロパティに値を入れたとき
- 修正前:「レコードを保存できません。入力が必須のフィールドが空です。」
- 修正後:「レコードを保存できません。フィールドの入力内容が正しくありません。なお、このフィールドに対する編集権限は付与されていないため、アプリの管理者にお問い合わせください。」
Garoon SOAP API
追加される機能
- 掲示板を更新するAPIに更新通知をするかどうかを表す以下のフラグを追加
- BulletinModifyTopicType データ型に @is_notified パラメータ
仕様変更
- ワークフローの申請情報を取得するAPIで数値項目へのアクセス権がない場合はvalueが空になる
- 変更前:ワークフローの数値項目にアクセス権を設定できませんでした。
- 変更後:ワークフローの数値項目にアクセス権を設定できるようになったため、数値項目へのアクセス権がない場合は項目値(value)が空("")になります。
User API
追加される機能
- 次のAPIについて、JSON形式のAPIを追加
- ユーザーインポートAPI
- ユーザー利用サービスインポートAPI
修正される不具合
- ユーザーエクスポート API(JSON)でsortOrderが未設定の時に出力される値が不正
- 修正前:最大値が表示されます。
- 修正後:nullが表示されます。
仕様変更
- 組織インポートAPIで組織情報 CSVの取り込む順番の変更
- 変更前:新たに追加された組織が1番下になります。
- 変更後:CSVの行の順を並び順として取り込みます。
<お詫び>2017年06月25日の定期メンテナンスでお知らせ内容に不足がございました。お詫びして訂正申し上げます。
不足していた内容は以下です。
Garoon SOAP API
追加される機能