kintone Café 福岡 Vol.2（kintone REST API・Excel連携）
•
2 likes•7,666 views
「kintone Café 福岡 Vol.2」で利用したスライドです。 ・kintoneの概要（振り返り） ・「kintone REST APIs」について（予備知識） ・Excel連携（イベントプロージャによるkintoneレコードルックアップ）の事例・デモ 関連記事 http://yamaryu0508.hatenablog.com/entry/2014/07/16/094724
Recommended
More Related Content
What's hot
What's hot (20)
Similar to kintone Café 福岡 Vol.2（kintone REST API・Excel連携）
Similar to kintone Café 福岡 Vol.2（kintone REST API・Excel連携） (20)
More from Ryu Yamashita
More from Ryu Yamashita (20)
kintone Café 福岡 Vol.2（kintone REST API・Excel連携）
- 1. kintone Café 福岡 Vol.2 2014年7月11日 kintone公認エバンジェリスト 山下 竜 ＃kintonecafe Twitter: @yamaryu0508 FB: https://www.facebook.com/ryu.yamashita.3 Blog: http://yamaryu0508.hatenablog.com/
- 2. • kintoneの概要（振り返り） • 「kintone REST API」について（予備知識） • Excel連携事例（デモ・ハンズオン） • 今始めると美味しいkintoneビジネスについて（サイボウズ 佐藤さま） • 今月のアップデートと進化するkintoneカスタマイズデモ（サイボウズ 後迫さま） • Tipsの現状と未来（サイボウズ 北川さま） • サイボウズでのkintoneの使われ方（サイボウズ 札辻さま） Menu for today ※太字：私のパート
- 3. kintoneの概要
- 5. • REST API • レコードやスペースの操作（登録・更新・削除等）、 バルクAPI • ユーザ・組織の操作 • JavaScript/CSSカスタマイズ • 各種イベントハンドル、情報取得 • プロキシによる外部API連携 • URL指定によるライブラリの読み込み（HTTPS対応） kintoneカスタマイズ機能（スタンダードコース） データ レコード スペース ユーザ UI 基幹システム Excel 他のクラウド REST API kintone.proxy
- 6. 「kintone REST API」 について （参考：「cybozu.com developer network > kintone API」）
- 7. • kintoneアプリのレコードやスペースの操作 kintone REST APIの概要 kintone REST APIの用途 プロトコル • HTTPSプロトコル フォーマット • JSON 文字コード • UTF-8 認証認証 • ユーザ認証（パスワード、APIトークン） • Basic認証 その他 • 同時処理レコード数100件 • API同時アクセス10件
- 8. • https://{subdomain}.cybozu.com/k/v1/{command}.json【通常】 • https://{subdomain}.cybozu.com/k/guest/{space id}/v1/ {command}.json【ゲストスペース】 kintone REST APIの概要（続き） URI リクエストヘッダ • Host: {subdomain}.cybozu.com:443 • Content-Type:application/json • 認証情報
- 9. リクエスト例（GET/records） 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」を利用しています
- 11. リクエスト例（GET/records：続き） レスポンス "{field code}": { "type" : "{field type}", "value" : "{value}" } 各フィールドはこのように記述されます ・複数値を取りうる{value}は配列になります ・POST/PUTの際はtypeが不要です フィールドの記述
- 15. • まずはエラーメッセージからヘッダかボディかを判別するところか らだと思います • ボディっぽい時には「ブラウザHTTPクライアント」に手組みで JSON入力していきながら試行錯誤となります • リクエストヘッダ・ボディを可視化するのも有効に感じます • 面倒ですが「ブラウザHTTPクライアント」と「kintone JavaScript API」と簡単なスクリプト言語の3者意見で絞り込める こともあります kintone REST API エラー潰し
- 16. Excel連携事例
- 18. Excelとkintoneを共存させるメリット（続き） ありがちな課題／得失 kintone Excel 同じようなデータを複数のExcelで重複管理されている。 データも散在状態になっている ○ （共有） （重複・散在） データを集中管理し、安全に同時入力したい ○ （同時入力可） （同時入力不可） ユーザーがExcelに慣れているとツールの変更に協力を得 づらいことがある ー ○ （馴染み） 既存の決まった帳票フォーマットがあり、ExcelやWord で存在する ー ○ （馴染み） Excel導入済み企業が多く、kintoneの共有機能をネイティ ブアプリ（実行環境の追加等が不要）として使える ○ （共有） ○ （裾野・馴染み）
- 19. 今回のアプリ作成シナリオ（物品貸出） 物品確認 書類作成 ②発送準備 ③物品情報 ステータス変更 ①貸出依頼 ④発送 ⑥返送⑦物品返却⑧物品一覧 ステータス変更 依頼 ⑤貸出 （申込書・貸出票） • 負担無き管理 • 手間無き書類作成 効率化のポイント （写真等含めてkintoneで 一覧を管理中）
- 29. ルックアップ元のkintoneアプリ フォーム項目 フィールドの種類 フィールドコード 会社名 文字列（1行） companyName 会社コード 文字列（1行） （重複禁止） companyCode 郵便番号 文字列（1行） zipCode 担当者 文字列（1行） inCharge 電話番号 文字列（1行） tel メール 文字列（1行） mail フォーム項目 フィールドの種類 フィールドコード 物品種別 ドロップダウン type メーカ ドロップダウン maker 型式 文字列（1行） model レコード番号 - recordNum 管理番号 文字列（1行） （重複禁止） id 稼働区分 ドロップダウン operationStatus 貸出・提供先 文字列（1行） ownerLocation 顧客情報 物品管理 ※Vol.1で作った「顧客情報」アプリの修正で対応可能です
- 30. • kintone REST APIを利用した基本的なレコード操作（Excel-VBAではMS XML） • Excel-VBAのイベントプロージャ（セル値変更）でExcelからkintoneのレコードをルッ クアップ • Excel-VBAでJSONパースにJSON-Libを利用（64bit版で廃止になったScriptControl の代用） • 運用に耐えられるアプリらしいExcel • ロックで入力セルを限定することで、ユーザーに対して入力箇所をガイドし、不用意 なシートの変更をさせない • オフライン時等のエラー処理 • 直近のステータス変更チェック（今回は運用フローでフォロー） ポイントまとめ
- 32. 今回のExcel-VBAの部分説明 ライブラリ読み込み （環境によっては不要） ①「ツール」「参照設定」を クリック ②「Microsoft XML v*」と「Microsoft Scripting Runtime」にチェック（*は環境によっ て異なるバージョン番号で、画面中は6.0） ③「OK」をクリック
- 33. 今回のExcel-VBAの部分説明（続き） IsOnline()関数@Module1 Modulue1冒頭でライブラリ等 の準備 Module1後半でインターネット 接続状況を確認する関数を定義
- 36. • 引数・戻り値 • 引数：貸出状態（貸出中／未使用）[String] • 戻り値：なし • 説明 • 貸出中／未使用（kintone側のドロップダウンフィールドに対応）の いずれかを引数として渡し、PUT/recordsでレコードの状態を変更 する 今回のExcel-VBAの部分説明（続き） changeStatus()関数@Module1の概要
- 37. 今回のExcel-VBAの部分説明（続き） changeStatus()関数@Module1のコード ②お客さま名と貸出状態を更新 ・・・ ①PUT/recordsを行うための JSON文字列の作成
- 39. • 引数・戻り値 • 引数：JSON文字列[String] • 戻り値：Excelオブジェクト[Object] • 説明 • JSONLibを用いたJOSNパーサ 今回のExcel-VBAの部分説明（続き） parseJSON()関数@Module1の概要
- 40. • 引数・戻り値 • 引数：クエリ文字列[String] • 戻り値：URIエンコード文字列[String] • 説明 • URIエンコードを行う 今回のExcel-VBAの部分説明（続き） URI_Encode()関数@Module1の概要
- 41. parseJON()関数@Module1のコード 今回のExcel-VBAの部分説明（続き） URI_Encode()関数@Module1のコード （引用：「cybozu.com developer network > Tips > kintone Excel」）
- 42. • 引数・戻り値 • 引数：メソッド[String]、URI[String]、ヘッダ[Dictionary]、ボ ディ[Variant] • 戻り値：Excelオブジェクト[Object] • 説明 • HTTPリクエストを行う 今回のExcel-VBAのポイント解説（続き） requestHttp()関数@Module1の概要
- 48. デモに関連する内容は以上です
- 49. • 開発コミュニティサイト「cybozu.com developer network」[https:// cybozudev.zendesk.com/hc/ja] • コミュニティ（質問等）、リファレンス、Tips、サンプル、開発者ライセン ス申込 • 「kintone REST APIs」[https://cybozudev.zendesk.com/hc/ja/articles/ 200812990-kintone-REST-APIs] • kintone REST APIsの公式情報（cybozu.com dev. nw.内） • 「cybozu.com developer network > Tips > kintone Excel」[https:// cybozudev.zendesk.com/hc/ja/sections/200377340-kintone-Excel] • Excel連携のTips（cybozu.com dev. nw.内） 参考情報
- 50. ご清聴ありがとうございました。