kintone Café 東京 Vol.3 ハンズオン資料（kintone & AWS Lambda/S3）
•
3 likes•1,178 views
kintone Café 東京 Vol.3のハンズオンパートの資料です。
Recommended
Recommended
More Related Content
What's hot
What's hot (20)
Similar to kintone Café 東京 Vol.3 ハンズオン資料（kintone & AWS Lambda/S3）
Similar to kintone Café 東京 Vol.3 ハンズオン資料（kintone & AWS Lambda/S3） (20)
More from Ryu Yamashita
More from Ryu Yamashita (20)
kintone Café 東京 Vol.3 ハンズオン資料（kintone & AWS Lambda/S3）
- 1. AWSを活用したkintone開発 -kintoneとAWS最新のビッグアップデートを学ぼう！- kintone Café 東京 Vol.3 ＃kintonecafe Twitter: @yamaryu0508 FB: https://www.facebook.com/ryu.yamashita.3 2015年7月24日 株式会社ジョイゾー/kintoneエバンジェリスト/ kintone Café 運営事務局・東京支部 山下 竜
- 2. • kintoneとは？ • kintone3大要素とREST API • kintoneとAWS • kintone REST API • 概要 • リクエスト例 • Node.jsによるリクエスト例 • サンプルダウンロード Today s Café Mune 2 • AWS S3とLambda • S3・バケット設定 • Lambda・イベント設定 • Lambda関数の記述 • ハンズオン • シナリオ • サンプル（1つのアプリの更新） • ガチハンズオン（複数アプリの更新） ※スライド内リンクはPDFダウンロード時に有効になります
- 3. 自己紹介 3 2013.3 IOTとグループウェア（デヂエ）の連携を試みてkintone に出会う 2014.4 - kintoneエバンジェリストに 2014.11 kintone好きが高じて、界隈初のkintone転職 2015.2 kintone Café 運営事務局開設、事務局メンバーに 2014.5 - 2014.10 kintone Café 福岡 Vol.1 - 3を主催 現在（kintone歴2年ちょっと、AWS歴数週間） 多分、 日本で唯一100%kintoneでご飯食べてる人 株式会社ジョイゾー 山下 竜（33） 福岡県大牟田市出身 「ブルーウェーブ」 という共通点
- 4. kintone界隈のIoTの人 4 「2015/5/22 kintone hive 開催報告」より 今日はこれやめて おきます
- 6. • 会社名 株式会社ジョイゾー • 所在地 東京都江東区東陽３５５ラウクティビルディング3F • 設立年月日 2010年12月20日 • 社員数 7名（kinotneエバンジェリスト2名） • 主な事業 kintone導入支援、カスタマイズ開発他 • 主な取引先 カナディアン・ソーラー・ジャパン他 株式会社ジョイゾー 6
- 7. ジョイゾーの所在地 7
- 9. kintoneの概要
- 10. kintoneとは？（ざっくり） 10 • コンセプト •「ファストシステム」 •「3分で業務改善アプリ」 • 構成要素 •データ • プロセス管理（ワークフロー） •コミュニケーション （出典：「kintone公式サイト」） 「サイボウズプロダクト=チームを強くするツール」 の中でも汎用性と専門性を行き来しながら、様々な 業務シーンで活用出来るクラウドデータベース （WebDB）サービス
- 15. kintoneの2つのコース 15 • これまで作成したアプリをそのまま運用するためには「ラ イトコース」 • これから紹介するカスタマイズを適用するためには「ス タンダードコース」 （出典：kintone公式サイト[https://kintone.cybozu.com/jp/price/]） プログラミングなしで 簡単アプリ作成！ REST API、JavaScript/CSSで カスタマイズして更に便利に！ チームワークプラットフォームですので、5ユーザーからの利用です
- 16. • データ • ドラッグ&ドロップで簡単フォーム設計（豊富なフォームパーツ、ファイル添付） • 強化されたトップ画面（一覧、カレンダー、カスタムビュー） • グラフや集計機能（おすすめグラフ、定期レポート、クロス集計等） • 通知・リマインダー設定（メール、モバイルアプリ通知） • アプリ間データ連携（ルックアップ、関連レコード、アクション機能） • 全文検索による容易な情報の取り出し（添付ファイルの中も対象） • アクセス権設定（アプリグループ、アプリ・レコード・フィールド単位） kintoneとは？（ライトコース） 16 3分で業務改善アプリを作るためのユーザビリティ の高い標準機能（プログラミングなし）
- 19. • コミュニケーション • コメント（レコード単位、スペース単位のディスカッション） • スペース・スレッド（データとディスカッションの融合、情報の集約・蓄積） • ゲストスペース（社外・顧客等へのコミュニケーション範囲の拡大） • ピープル（SNSライクなコミュニケーション） • 通知・メンション（相手を指定したコミュニケーション） kintoneとは？（ライトコース） 19
- 21. • その他 • モバイル対応（モバイルビュー、モバイルアプリ） • kintoneアプリストア、アプリテンプレートによるアプリの授受共有・再利用 • 強固なセキュリティ（2ファクター認証、IPアドレス制限） • 安心のバックアップ • 国際化対応（日・英・中の3カ国語のフィールド名称を定義） • 専門の連携ソリューション（サードパーティー）が充実中 kintoneとは？（ライトコース） 21
- 23. kintoneカスタマイズ機能（スタンダードコース） 23 • REST API • レコードやスペースの操作（登録・更新・削除等）、 バルクAPI、アプリ作成、ワークフロー操作 • ユーザ・組織の操作 • JavaScript/CSSカスタマイズ • 各種イベントハンドル、情報取得 • プロキシによる外部API連携 • URL指定によるライブラリの読み込み（HTTPS対応） データ レコード スペース ユーザ UI 基幹システム Excel 他のクラウド REST API kintone.proxy
- 27. kintone3大要素とREST API 27 データベース プロセス管理 コミュニケーション 充実 今回実装 弱い APIからの操作も3大要素をバランスよく活用することが重要！ API操作で3大機能同士を密に結合できるようになると、更に便利になると期待しています！
- 28. kintone3大要素とREST API（ポータル画面） 28 スペースの 作成・メンバー更新等 アプリの作成・更新 （欲しい） （参考：「cybozu.com developer network > kintone API」）
- 29. kintone3大要素とREST API（詳細画面） 29 レコードの 取得・登録・更新・削除 添付ファイルの アップロード・ダウンロード レコードの ステータス変更 （欲しい） （参考：「cybozu.com developer network > kintone API」）
- 31. kintoneとAWS 31 • アプリケーション寄りPaaS(SaaS) • クライアントサイド/フロントエンド （UI/UX） • 行動的/解釈の共有でアクションを起こし、 コミュニケーションで業務を回す • インフラ寄りPaas(IaaS、BaaS) • サーバーサイド/バックエンド (コマンド) • 思考的/データを捌き事象を解釈する APIで 結合・補完
- 33. 王道っぽいAWSとkintoneの連携パターン 33 Amazon DynamoDB Stream Amazon SNS Amazon S3 Amazon Kinesis Amazon Lambda Amazon EC2 Lambda イベントソース REST API kintone on cybozu.com ・レコード操作 ・ワークフロー操作 ・スペース操作 ・アプリ操作 REST API kintone.proxy() & Amazon API Gateway 経由は良さそう・・・ R EST A PI プリミティブな連携 ・ホスティング ・バッチ処理
- 34. kintone.proxy() & Amazon API Gateway 経由は良さそう・・・ Today s Café Menu 34 Amazon DynamoDB Stream Amazon SNS Amazon Kinesis Amazon EC2 Lambda イベントソース ・レコード操作 ・ワークフロー操作 ・スペース操作 ・アプリ操作 REST API R EST A PI プリミティブな連携 ・ホスティング ・バッチ処理 Amazon S3 Amazon Lambda REST API kintone on cybozu.com ・アプリ操作
- 35. Today s Café Menu 35 Amazon S3 Amazon Lambda REST API kintone on cybozu.com S3 bucket kintoneカスタマイズ用 JSファイル Event P U T Node.js ①カスタマイズ用 ファイルをPUT ③カスタマイズ用 ファイルを更新 ②ファイルPUTで イベントドライブ モチベーション/ シナリオ カスタマイズ用ファイルを複数 アプリで一挙に更新したい！
- 36. ハンズオン （予備知識と準備）
- 37. kintone REST API （参考：「cybozu.com developer network > kintone API」）
- 38. kintone REST APIの概要 38 • kintoneアプリのレコードやスペースの操作 kintone REST APIの用途 プロトコル • HTTPSプロトコル フォーマット • JSON 文字コード • UTF-8 認証認証 • ユーザ認証（パスワード、APIトークン） • Basic認証 その他 • 同時処理レコード数100件 • API同時アクセス10件 ※GET/recordsのみ500件
- 39. kintone REST APIの概要（続き） 39 • https://{subdomain}.cybozu.com/k/v1/{command}.json【通常】 • https://{subdomain}.cybozu.com/k/guest/{space id}/v1/ {command}.json【ゲストスペース】 URI リクエストヘッダ • Host: {subdomain}.cybozu.com:443 • Content-Type:application/json • 認証情報
- 40. リクエスト例（GET/records） 40 QWRtaW5pc3RyYXRvcjpwYXNzd29y GETメソッドでは Content-Typeは不要 Basic認証を使用していない場合にも 空欄で入れておく分には問題ない様子 https://{subdomain}.cybozu.com/k/v1/records.json?app={app id} 【認証方法の記述】 X-Cybozu-Authorization : {BASE64-encoded "id:password"} Authorization : Basic {BASE64-encoded "id:password"} ※例の{base64-encoded "id:password"}はidをAdministrator、 passwordをpasswordとした場合の値としています HTTPクライアント設定画面 ※以降、Google Chromeのアドオン「POSTMAN」を利用しています
- 42. リクエスト例（GET/records：続き） 42 レスポンス "{field code}": { "type" : "{field type}", "value" : "{value}" } 各フィールドはこのように記述されます ・複数値を取りうる{value}は配列になります ・POST/PUTの際はtypeが不要です フィールドの記述
- 46. Node.jsによるリクエスト例（準備） 46 今回Node.jsでREST APIをコールする際に「request」モジュールを利用する 「npm install request」で コードを実行するフォルダに展開
- 48. ここからちょっと実践
- 56. AWS S3とLambda
- 57. まずはS3・バケットを設定
- 63. 次にLambda・イベントを設定
- 67. Lambda・イベントの設定（続き） 67 ④「Event source type」が 「S3」になっていることを確認 ⑤「Bucket」に、イベントソース にする設定済バケットを選択 ⑥「Event type」は 今回「PUT」を選択 ⑦「Next」をクリック
- 69. Lambda・イベントの設定（続き） 69 ⑩「Handler」は一旦そのまま ※ZIPコードをアップロードする際にファイル名と同一 である必要がある（index.handler → index.js） ⑪「Role」はS3実行権限を持つ既存 ロールか「S3 execution」を選択 ⑫S3実行権限を持つIAMロールを新 しく作る場合には「許可」をクリック ⑬「Memory」を512、Timeoutを5で設定 ⑭「Next」をクリック ※ポップアップの許可が必要な場合があります
- 70. Lambda・イベントの設定（続き） 70 ⑯「Create function」をクリック ⑮「Enable event source」は 「Enable later」のまま
- 72. Lambda・イベントの設定（続き） 72 ⑲「Sample event template」は「S3 PUT」を選択 「HappyFace.jpg」を先程アップしたファイル名に変更 「mybucket」と「sourcebucket」を 先程作成したバケット名に変更 「Submit」をクリックしてテスト実行
- 73. Lambda・イベントの設定（続き） 73 テスト実行が成功すると「Execution result」が「succeeded」 になり、アップしたファイルのContent-Typeが出力される
- 76. ここまでの設定による動き 76 Amazon S3 Amazon Lambda S3 bucket EventPUT Node.js①S3にファイルをPUT ②ファイルPUTで イベントドライブ ③S3にPUTされたファイルの Content-Typeを表示
- 79. Lambda関数の記述について
- 82. $ zip -r sample.zip index.js node_module Lambda関数の書き方（Node.js） 82 exports.handler = function(event, context) { // 正常として終了させたい時には context.succeed(); // 異常として終了させたい時には context.fail(); }; 記述テンプレート Node.jsモジュール利用時 Lambda関数のJSファイルとnode_modeule/を ZIPでパッケージング JSファイル名とHandler名を揃えるJSファイル名とHandler名を揃える context.succeed/fail の記述を忘れる とエラーの原因にもなるので注意
- 83. ここから ハンズオン本番です
- 86. ハンズオンシナリオ（続き） 86 Amazon S3 Amazon Lambda REST API kintone on cybozu.com S3 bucket kintoneカスタマイズ用 JSファイル Event P U T Node.js ①カスタマイズ用 ファイルをPUT ③カスタマイズ用 ファイルを更新 ②ファイルPUTで イベントドライブ モチベーション/ シナリオ カスタマイズ用ファイルを複数 アプリで一挙に更新したい！
- 88. • S3イベントドライブによるLambda関数の書き方 • Lambda関数におけるファイル処理 • Node.jsによるkintone REST APIのリクエストの書き方 • ファイルアップロード • アプリデプロイ 要求されるスキルセット（今日の成果） 88
- 94. S3イベントコードサンプルの部分解説（続き） 94 kintone REST APIコール用の関数 kintone REST APIコール用の関数 ファイルアップロード（form形式）と 通常（JSON）形式のボディを場合分け
- 95. Lambda関数のパッケージングとアップロード 95 $ zip -r sample.zip index.js node_module パッケージング
- 96. アップロード Lambda関数のパッケージングとアップロード（続き） 96 ①「Upload a .ZIP file」を選択する ②「Upload」を クリックする ③ZIPファイルを選択する ④「Save」をクリックする
- 97. サンプルを試してみましょう
- 104. Lambda関数のパッケージングとアップロード 104 $ zip -r sample.zip multi.js node_module パッケージング ※ここまでのサンプルはindex.jsでしたので、Handler名を 「multi.handler」と変更する必要があります（P82参照）
- 105. アップロード Lambda関数のパッケージングとアップロード（続き） 105 ①「Upload a .ZIP file」を選択する ②「Upload」を クリックする ③ZIPファイルを選択する ④「Save」をクリックする
- 106. ハンズオンは以上です
- 108. 参考情報 108 • 開発コミュニティサイト「cybozu.com developer network」[https:// cybozudev.zendesk.com/hc/ja] • コミュニティ（質問等）、リファレンス、Tips、サンプル、開発者ライセン ス申込 • 「kintone API」[https://cybozudev.zendesk.com/hc/ja/categories/ 200147600] • kintone APIのリファレンス（cybozu.com dev. nw.内） • 「アプリ作成と設定の変更」[https://cybozudev.zendesk.com/hc/ja/ articles/204693590] • kintoneアプリ作成系APIリファレンス（cybozu.com dev. nw.内）