Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.

kintone café 福岡 vol6 第1部 7月 API情報

620 views

Published on

「kintone café 福岡 vol6 第1部 7月 API情報」の資料

Published in: Software
  • Be the first to comment

kintone café 福岡 vol6 第1部 7月 API情報

  1. 1. kintone API 7月 アップデート情報 2015/8/29 サイボウズ株式会社 竹内 能彦
  2. 2. kintone Café 福岡 Vol.6 自己紹介 名前: 竹内 能彦(たけうち よしひこ) 年齢: 32歳 出身: 香川県坂出市 経歴: 2014年 サイボウズ株式会社 中途入社 所属: システムコンサルティング本部 関西SCグループ(新大阪勤務)
  3. 3. kintone Café 福岡 Vol.6 サイボウズの製品
  4. 4. kintone Café 福岡 Vol.6 Garoon と Googleカレンダー連携 • GaroonのスケジュールをGoogleカレンダーに反映
  5. 5. kintone Café 福岡 Vol.6 Garoon と Googleカレンダー連携の公開場所
  6. 6. kintone Café 福岡 Vol.6 Garoon と Googleカレンダー連携の公開場所
  7. 7. kintone Café 福岡 Vol.6 Garoon と Googleカレンダー連携の公開場所
  8. 8. kintone Café 福岡 Vol.6 Garoon と Googleカレンダー連携の公開場所
  9. 9. kintone Café 福岡 Vol.6 拡大
  10. 10. kintone Café 福岡 Vol.6 developer networkのコミュニケーション
  11. 11. kintone Café 福岡 Vol.6 目次 • kintone API 7月のアップデート情報 • ステータス更新API + デモ • デプロイAPI + デモ
  12. 12. kintone API 7月のアップデート情報
  13. 13. kintone Café 福岡 Vol.6 JavaScript API • Promise対応 kintoneのリクエスト系APIは全て非同期 => 同期リクエストが必要な場合はXMLHttpRequestを利用 => XMLHttpRequestを使わなくて良くなる • テーブルの行追加・削除ボタンクリック時のイベント取得 • 分かりにくいエラーメッセージを修正 • 不具合改修
  14. 14. kintone Café 福岡 Vol.6 JavaScript API • Promise対応 kintoneのリクエスト系APIは全て非同期 => 同期リクエストが必要な場合はXMLHttpRequestを利用 => XMLHttpRequestを使わなくて良くなる • テーブルの行追加・削除ボタンクリック時のイベント取得 • 分かりにくいエラーメッセージを修正 • 不具合改修 地味な改修に見えてかなり有り難い ドツボにはまるということが少なくなりそう・・・
  15. 15. kintone Café 福岡 Vol.6 REST API • レコードのステータスを更新するAPI • アプリをデプロイするAPI • 日付のフォーマット仕様変更 • リクエストヘッダーにX-HTTP-Method-Overrideを指定 • 分かりにくいエラーメッセージを修正 • 不具合改修
  16. 16. kintone Café 福岡 Vol.6 REST API • レコードのステータスを更新するAPI • アプリをデプロイするAPI • 日付のフォーマット仕様変更 • リクエストヘッダーにX-HTTP-Method-Overrideを指定 • 分かりにくいエラーメッセージを修正 • 不具合改修 今回はこの2つのAPIについて詳しく説明
  17. 17. kintone Café 福岡 Vol.6 REST API • レコードのステータスを更新するAPI • アプリをデプロイするAPI • 日付のフォーマット仕様変更 • リクエストヘッダーにX-HTTP-Method-Overrideを指定 • 分かりにくいエラーメッセージを修正 • 不具合改修 月日を省略した場合は01で補完されます。 * 2015 -> 2015-01-01 * 2015-07 -> 2015-07-01 * 2015-7 -> 2015-07-01 * 2015-7-5 -> 2015-07-05
  18. 18. kintone Café 福岡 Vol.6・リクエストヘッダー GET /k/v1/records.json?app=oo&query=ほげほげ・・・ ・リクエストヘッダー POST /k/v1/records.json X-HTTP-Method-Override: GET ・リクエストボディ { "app": "oo", “query”: “ほげほげ・・・" } REST API • レコードのステータスを更新するAPI • アプリをデプロイするAPI • 日付のフォーマット仕様変更 • リクエストヘッダーにX-HTTP-Method-Overrideを指定 • 分かりにくいエラーメッセージを修正 • 不具合改修
  19. 19. ステータス更新API
  20. 20. kintone Café 福岡 Vol.6 kintoneのプロセス管理 • 複数のユーザーでレコードの編集や確認をするためのプロセス(ワークフロー)を設定できます。 • 各レコードのステータス(処理状況)が表示されるようになります。
  21. 21. kintone Café 福岡 Vol.6 例)ステータスの更新 • リクエスト curl -X PUT -H “X-Cybozu-Authorization: XXXX" -H “Authorization: XXXX” -H "Content-Type: application/json" -d ‘{“app”:OO, “id”:□□, “action”:“△△"}' "https://xxxxxxxx.cybozu.com/k/v1/record/status.json" | jq • レスポンス
  22. 22. kintone Café 福岡 Vol.6 例)ステータスの更新 • リクエスト curl -X PUT -H “X-Cybozu-Authorization: XXXX" -H “Authorization: XXXX” -H "Content-Type: application/json" -d ‘{“app”:OO, “id”:□□, “action”:“△△"}' "https://xxxxxxxx.cybozu.com/k/v1/record/status.json" | jq • レスポンス actionにはアクション名を指定
  23. 23. kintone Café 福岡 Vol.6 アクション名とは・・・ • 詳細画面 • 設定画面
  24. 24. kintone Café 福岡 Vol.6 ステータス更新APIの注意事項 例えば・・・ バッチ処理で特定期間経過後に 一括承認/却下したい場合 API TOKENでは実行できない • ユーザー認証でAPIを実行する場合、次の2つの条件にあてはまるレコードでAPIを実行できます。 • APIの実行ユーザーがレコードの閲覧権限を持つ • レコードに作業者が指定されていない、または、APIの実行ユーザーがレコードの作業者に指定されている • APIトークンでAPIを実行する場合、次の2つの条件にあてはまる場合にAPIを実行できます。 • レコードの閲覧を許可したAPIトークンを使用する • レコードに作業者が指定されていない、または、「Administrator」がレコードの作業者に指定されている
  25. 25. デモ① - ステータスの一括更新 -
  26. 26. デプロイAPI
  27. 27. kintone Café 福岡 Vol.6 新規追加、機能追加されたREST API • アプリの作成と設定変更 • アプリ設定の運用環境への反映 • アプリの設定情報の取得/変更 • 一般設定 • フォーム設定 • 一覧設定 • アクセス権設定(アプリ、レコード、フィールド) • JavaScript / CSSカスタマイズ設定
  28. 28. kintone Café 福岡 Vol.6 例)アプリの一般設定の取得 • リクエスト curl -X GET -H “X-Cybozu-Authorization: XXXX" -H “Authorization: XXXX” "https://xxxxxxxx.cybozu.com/k/v1/app/settings.json?app=OO" | jq • レスポンス API TOKENは使えない アプリの説明にはHTMLタグも含まれる
  29. 29. kintone Café 福岡 Vol.6 例)アプリのフォーム設定の取得 • リクエスト curl -X GET -H "X-Cybozu-Authorization: XXXX" -H "Authorization: XXXX” "https://xxxxxxxx.cybozu.com/k/v1/app/form/fields.json?app=OO" | jq API TOKENは使えない
  30. 30. kintone Café 福岡 Vol.6 例)日付フィールドの設定取得 • フィールドの設定 • レスポンス
  31. 31. kintone Café 福岡 Vol.6 例)ラジオボタンフィールドの設定取得 • フィールドの設定 • レスポンス
  32. 32. デモ
  33. 33. kintone Café 福岡 Vol.6 kintoneはファストシステム • すぐ作れる • すぐ使える • 変更も簡単
  34. 34. kintone Café 福岡 Vol.6 案件での対応は・・・ • 要件を確認 • 仕様を考えて • アプリを作って • 使ってみて • 修正して
  35. 35. kintone Café 福岡 Vol.6 案件での対応は・・・ • 要件を確認 • 仕様を考えて • アプリを作って • 使ってみて • 修正して とっても順調! 楽しい!
  36. 36. kintone Café 福岡 Vol.6 ですが・・・ • 検収には仕様書が必要な場合も・・・ 面倒
  37. 37. kintone Café 福岡 Vol.6 ですが・・・ • 検収には仕様書が必要な場合も・・・ アプリから仕様書 が作れないかなー
  38. 38. デモ② - アプリ設計情報をPDFに -
  39. 39. kintone Café 福岡 Vol.6 帳票サービス ・プリントクリエイター ・SVF Cloud for kintone ・OPROARTS Connector for kintone ・ReportsConnect for kintone ・kintone 楽々帳票 ・Excel – kintone 連携
  40. 40. kintone Café 福岡 Vol.6 連携サービスのTips
  41. 41. kintone Café 福岡 Vol.6 まとめ • 7月のアップデートでは開発者にとって嬉しい機能が多数追加 • kintoneではアプリの仕様書まで自身で作成 • 是非皆さんも使ってみてください

×