kintone REST API client package for R

2014年7月12日 fukuoka.R #2 kintoneエバンジェリスト　山下 竜Twitter: @yamaryu0508 FB: https://www.facebook.com/ryu.yamashita.3 Blog: http://yamaryu0508.hatenablog.com/

× ⇌

• kintoneの概要

• 「R × kintone」連携・ライブラリ

• ライブラリの使い方

• 活用事例、その他の活用例

アジェンダ

•コンセプト

•「ファストシステム」

•「3分で業務改善アプリ」

•構成要素

•データ

•ワークフロー

•コミュニケーション

kintone概要

「サイボウズプロダクト=チームを強くするツール」の中でも汎用性と専門性を行き来しながら、様々な 業務シーンで活用出来るクラウドデータベース（WebDB）サービス

（出典：「kintone公式サイト」）

kintone基本機能（ライトコース）• データ（ピックアップ）

ドラッグ&ドロップでフォーム作成

フォーム編集

おすすめグラフ

グラフの種類や集計方法の候補を自動生成

kintone基本機能（ライトコース：続き）• ワークフロー（プロセス管理）

• 柔軟なワークフロー（電子申請・承認）設定

ステータス設定 プロセス設定ワークフローの実行

ステータス名や条件分岐を自由に設定

kintone基本機能（ライトコース：続き）• コミュニケーション（ピックアップ）

アプリ内コメント

スペース

ピープル

アプリやコミュニケーションの融合

個人間のコミュニケーション

スマホ通知

kintone基本機能（ライトコース：続き）• その他（ピックアップ）

モバイルビュー

2ファクター認証

4重冗長化「Square」

（出典：「cybozu.comのクラウド基盤」）

これでもか！と言うくらいのBU

[subdomain]

モバイルで使ってこそのクラウド

※地図はJavaScript カスタマイズです

• REST API

• レコードやスペースの操作（登録・更新・削除等）、バルクAPI

• ユーザ・組織の操作

• JavaScript/CSSカスタマイズ

• 各種イベントハンドル、情報取得

• プロキシによる外部API連携

• URL指定によるライブラリの読み込み（HTTPS対応）

kintoneカスタマイズ機能（スタンダードコース）

データ レコード スペース ユーザ

UI

基幹システム Excel

他のクラウドREST API

kintone.proxy

データ （テキスト、 添付ファイル）

UI

「R × kintone」連携

RDBMS

Hadoop

kintone

REST API

データビュー （フロントエンド）

データ処理 （バックエンド）

・・・

ここのラッパを作りました！！

Excel/CSV

「R × kintone」ライブラリkintone@CRAN

r-kintone@GitHub

https://github.com/yamaryu0508/r-kintonehttp://cran.r-project.org/web/packages/kintone/

※現在アップデート審査中

「R × kintone」ライブラリ（続き）• 対応REST API

• レコードの取得／登録／更新／削除

• ファイルアップロード／ダウンロード（ダウンロードはテキストのみ）

• ゲストスペースへのリクエスト対応※R 1.1.1（コマンドライン）では日本語対応していますが、RStudio 0.98では文字化けしますので、 ご注意ください

ライブラリの使い方（インストール・初期化）

詳しくは https://github.com/yamaryu0508/r-kintone に記載していますが、

【 Mac OSX/Linuxコンソール】 R CMD INSTALL kintone_0.1.tar.gz

インストール

【Rコンソール】 install.packages("kintone")

初期化

library(kintone) kintone <- Kintone("cybozu.com domain", "user id", "user password")

ライブラリの使い方（GET/recordsの例）

app <- 560 query <- 'createDay = "2014-07-05"' fields <- list("createDay", "tempC", "baseIpAddress") kintone@getRecords(app, query=query, fields=fields)

レスポンス（レコード取得）例

リクエスト例

$records[[6]] $records[[6]]$tempC $records[[6]]$tempC$type [1] "NUMBER" !

$records[[6]]$tempC$value [1] "27.9"

【従来のレスポンス（JSON）】

活用事例

https://github.com/yamaryu0508/r-kintone/tree/master/examples

Machine to machine to human

活用事例（続き）

①現地データの収集・連携

太陽光発電所（現場）

モバイル

オフィス

②収集データの加工 ③加工データの連携

その他の活用例（教育・研究機関）

シミュレーション

シミュレーション結果をkintoneへ渡す【連携】

シミュレーション終了を通知し、確認・次の行動へ繋げる【通知機能】

・結果を議論する【コミュニケーション機能】 　※共同研究等ではゲストスペースも有効です ・結果確認を促す【ワークフロー機能】

その他の活用例（データ分析分野）

データ （テキスト、 添付ファイル）

UI

データビュー （フロントエンド）

データ処理 （バックエンド）

JavaScriptカスタマイズ機能を用いてデータをビジュアライズする

パラメータをkintoneから登録しておき、分析エンジンに食わせて結果をkintoneに返す

RDBMS

Hadoop

kintone

・・・

Excel/CSV

REST API

kintone無償開発者ライセンス「cybozu.com developer network」にて、無償の開発者ライセンス（2ユーザ、1年間）を

お申込頂けますので、是非ともお試しください！

参考情報• 開発コミュニティサイト「cybozu.com developer network」[https://cybozudev.zendesk.com/hc/ja]

• コミュニティ（質問等）、リファレンス、Tips、サンプル、開発者ライセンス申込

• 「r-kintone@GitHub」[https://github.com/yamaryu0508/r-kintone/]

• ライブラリの使い方、サンプル等

• 「kintone@CRAN」[http://cran.r-project.org/web/packages/kintone/]

• PDFマニュアル

ご清聴ありがとうございました。