Mashup Awards 2016 での kintone ハンズオン資料です。

1. kintone ハンズオン
サイボウズ株式会社
#kintone

2. やること
▌アプリ作成
▌REST API
▌REST APIを使ったデモ

3. kintone の環境がない方は挙手

4. kintone の環境はこちら（発行まで2,３日必要）
これから何度も利用するのでブックマーク
「kintone developer」で検索
ここをクリック！

5. アプリ作成

6. kintoneにログイン
▌kintone環境https://xxxx.cybozu.com/に移動
▌ログイン名、パスワードを入力し、ログイン

7. ▌kintone をクリック

8. kintone のポータル
お知らせ
通知
スペース
（ディスカッションする場所）
アプリ（業務システム）

9. ▌アプリ横の「+」をクリック

10. ▌「はじめから作成」をクリック

11. ▌アプリ名を適当に入力（例では案件管理）

12. ▌「文字列（1行）」をドラッグ＆ドロップ
ドラッグ&
ドロップ

13. ▌「歯車」にフォーカスを合わせて、「設定」をクリック

14. ▌「フィールド名」を「案件名」に変更
▌「フィールドコード」を「title」に変更
▌「保存」をクリック

15. 設定後の画面

16. ▌他にも3つほど適当にドラッグ＆ドロップ
フィールド名＆コードは適当に

17. ▌「フォームを保存」をクリック

18. ▌「一覧」をクリックして、「+」をクリック

19. ▌一覧名を適当に入力（例では案件一覧）
▌一覧画面に表示したいフィールドをドラッグ＆ドロップ
ドラッグ&
ドロップ

20. ▌「保存」をクリック

21. ▌「アプリを公開」をクリックして、「OK」をクリック

22. レコード一覧画面

23. データ登録

24. ▌「+」をクリックして、データ登録画面に遷移

25. ▌適当に入力して、「保存」をクリック

26. レコード詳細画面
一覧画面に遷移
追加 複製
編集

27. kintone REST API

28. ▌https://cybozudev.zendesk.com/に移動し、ブックマーク
▌「API関連」をフォーカス
▌「kintone REST API」をクリック
これから何度も利用するのでブックマーク
「kintone developer」で検索

29. レコード（アプリのデータ）操作でやれること
▌「レコード」をクリック
取得、登録、更新、削除・・・
今回のハンズオンでは取得にトライ！

30. 実行の準備

31. 準備1 Postmanのインストール
▌Google Chromeを起動
▌左上の「アプリ」をクリック
▌「ウェブストア」をクリック

32. ▌「postman」で検索
▌「ADD TO CHROME」をクリック

33. ▌左上の「アプリ」をクリック
▌「Postman」をクリック

34. ▌「Skip this, go straight to the app」をクリック

35. ▌この画面が表示されればPostman利用の準備は完了

36. 準備2 アプリIDの確認
▌アプリを開く
▌URLからアプリIDを確認（要メモ）
「/k/xxx/」の「xxx」がアプリID

37. レコードの取得

38. ▌「API関連」をクリック
▌「kintone REST API」をクリック

39. ▌「レコード」をクリック
▌「レコードの取得（GET）」をクリック
▌「レコードの取得（1件）」をクリック

40. リクエストに必要な情報を確認

41. リクエストの作成
▌メソッドは「GET」を選択
▌URIは
「https://xx.cybozu.com/k/v1/record.json?app=x&id=xx」
▌「Send」をクリック
app=xの「x」には先ほど確認したアプリIDを指定
id=xxの「xx」には取得したいデータのレコード番号を指定
パラメータはURIの後に「?」で繋ぎ、
パラメータは「&」で繋ぐ

42. レコードの取得は失敗するけど、一応成功
▌「ログインしてください。」というメッセージが表示されれば成功
認証が必要

43. kintone REST API の認証
▌下記いずれかの認証が必要
パスワード認証 トークン認証
認証情報
「ログイン名:パスワード」を
BASE64エンコード
APIトークン
認証情報の付加場所 リクエストヘッダ
利用可能な API 全部 一部
どのユーザーでの操作 「ログイン名」で指定したユーザー Administrator
注意事項
セキュアアクセス環境か
らは利用できない

44. APIトークンの生成

45. 準備3 APIトークンの生成
▌「・・・」をクリック
▌「アプリの設定を変更」をクリック

46. ▌「API トークン」をクリック

47. ▌「生成する」をクリックして、「レコード閲覧」にチェック
▌「APIトークン」をメモ帳にコピーし、「保存」をクリック
メモ帳にコピー

48. ▌「アプリを更新」をクリックして、「OK」をクリック

49. APIトークンの指定方法

50. ▌「共通仕様」をクリック
▌「REST APIの共通仕様」をクリック
▌「ユーザー認証」をクリック

51. 指定方法を確認

52. APIトークンをHeadersにセット
▌「Headers」タブを選択
▌項目には「X-Cybozu-API-Token」を指定
▌値には先ほどコピーしたAPIトークンを指定
▌Sendをクリック

53. 成功
▌データの内容が表示されている事を確認

54. ハンズオンは以上になります