cybozu.com	
  conference	
  2013 【A-­‐4】	

kintone  REST  API,JavaScript  API
の実⼒力力
〜~API  の概要〜~

サイボウズ株式会社
システムコンサルティング本部
cybozu.com  ソリューション・グループ
浅賀  功次
1
Whatʼ’s  kintone  API?
▎ kintone  JavaScript  API

■  kintone  の画⾯面をカスタマイズ

▎ kintone  REST  API

■  アプリのレコード操作等が可能

copyright©cybozu

2
API  の利利⽤用イメージ

JavaScriptによるカスタマイズ

REST  APIによるデータ連携

フロントエンド

バックエンド

copyright©cybozu

3
JavaScript  読み込み
▎ 独⾃自に作成した  JavaScript  プログラムを  kintone  に読
み込む事が可能
▎ 標準機能には搭載されていない機能も実現できる
条件書式

ガントチャート

Google  Map  連携

copyright©cybozu

4
JavaScript  読み込み

	
  Cybozu	
  Inside	
  Out	
copyright©cybozu

5
kintone  JavaScript  API
▎ kintone  に読み込んだ  JavaScript  から利利⽤用可能
▎ kintone  REST  API  を実⾏行行できるため、アプリ間
でのデータ連携が可能
▎ 主な機能
■  レコード⼀一覧画⾯面の情報を取得
■  レコード詳細画⾯面の情報を取得
■  イベントハンドラ(⼀一覧表⽰示後、レコード保存前等)
■  kintone  REST  APIの実⾏行行
■  オブジェクト配置 11⽉月リリース
copyright©cybozu

6
kintone  REST  API
▎ REST  ⽅方式
▎ JSON  フォーマット
▎ 主な機能

■  レコード取得
■  レコード登録・更更新・削除
■  ファイルアップロード・ダウンロード
■  フォーム設計情報取得
■  アクセス権の制御
■  スペース・ゲストスペースの制御 11⽉月リリース
■  APIリスト・APIスキーマの取得
copyright©cybozu

7
kintone  REST  API  実⾏行行例例
▎ 「顧客リスト」アプリのレコードを取得

copyright©cybozu

8
kintone  REST  API  実⾏行行例例
▎ URI
https://example.cybozu.com/k/v1/record.json?app=100&id=1
お客様ごとのドメイン

レコードを取得

アプリの  ID レコード番号

▎ リクエストヘッダ
Host:  example.cybozu.com:443
X-‐‑‒Cybozu-‐‑‒Authorization:  QWRtaW5pc3RyYXRvcjpjeWJvenU=
API  実⾏行行時の認証情報

copyright©cybozu

9
kintone  REST  API  実⾏行行例例
▎ レスポンス(⼀一部を抜粋)
{
        "record":  {
                "Company":  {
                        "type":  "SINGLE_̲LINE_̲TEXT",
                        “value”:  “サイボウズ株式会社"
                },
                "Division":  {
                        "type":  "SINGLE_̲LINE_̲TEXT",
                        “value”:  “システムコンサルティング本部"
                },
                "Name":  {
                        "type":  "SINGLE_̲LINE_̲TEXT",
                        "value":  "佐藤  昇"
                },
                "Fax":  {
                        "type":  "SINGLE_̲LINE_̲TEXT",
copyright©cybozu
                        "value":  "03-‐‑‒5805-‐‑‒9036"

10
cybozu.com  developers

https://developers.cybozu.com/
copyright©cybozu

11
copyright©cybozu

12
kintone JavaScript APIの実力
-JavaScriptの活用事例-

帳票システムをシンプルに解決!
2013年	
日本オプロ株式会社
JavaScript読込機能で連携
OPROARTS
	

14	

Copyright © 2013 OPRO Japan Co., Ltd. All Rights Reserved.
会社概要	
商  号 日本オプロ株式会社	
l 
創  業 平成5年6月29日	
l 
設  立 平成9年4月4日	
l 
住  所 〒105-0014
        東京都港区芝3-43-15
        芝信三田ビル6F	
	
l 

Less is More.
より簡単に。もっと効率的に。	

OPROARTS	
前年比	

製品及びサービス
	
 	

新規顧客獲得伸び	

OPROARTS 利用中の企業数	

15	

Copyright © 2013 OPRO Japan Co., Ltd. All Rights Reserved.
OPROARTS とは・・・帳票☆クラウド
ビジネスの進化に伴い帳票も進化します。クラウドで利用することにより、帳票はビジネス・コミニュケーションに使われています。
このような帳票をビジネスドキュメントと言います。OPROARTSは、情報(インフォメーション)を形(デザイン)にして配信(デリバリー)
するクラウドサービスです。様々なシステム基盤から情報を連携が可能で、デザイン性が優れたビジネスドキュメントを作成でき、
多彩な配信方法を組み合わせられる“ビジネスコミニュケーション”環境をご提供します。	

OPROARTSは、
JavaScript連携による、
唯一のクラウドサービスです。	

16	

Copyright © 2013 OPRO Japan Co., Ltd. All Rights Reserved.
【参考】ORPOARTS Live (for kintone)
http://group.cybozu.jp/news/13103001.html	

kintoneと同様にブラウザーにて帳票開発が可能な「OPROARTS Live」をシームレスな連携を実現。JavaScript読込機能により、
kintoneの画面(フロント)から直接帳票出力が可能です。また、OPROARTSをご契約いただいたお客様には、JavaScriptの個別コー
ディングが不要な出力コンポーネントを提供しています。

帳票
	

画面
	

• パーツのドラッグ&ドロッ
プで⼊入⼒力力画⾯面を設計

17	

Copyright © 2013 OPRO Japan Co., Ltd. All Rights Reserved.
JavaScriptによる
kintoneの拡張性
	

18	

Copyright © 2013 OPRO Japan Co., Ltd. All Rights Reserved.
JavaScript開発の利用シーン	
モバイルビューを自動生成できる「kintone」なら、初期構築やメンテナンスコストを抑え
た基幹システムの新たなインターフェース開発が可能です。また、基幹システムと必要
なデータだけ同期させ、現場部門の集計・分析用ツールとして提供することも可能です。	

Webデータベース型のビジネスアプリケーションを自由に設計することができる「kintone
」なら、業務の変化に対応した柔軟なシステム運用が可能です。基幹システムのフロント
機能として、入力・運用効率を常に向上する仕組みへ対応可能です。	
見積
入力	

IF	
受注
入力	

DB	
ERP/基幹システム	

基幹への対応には、
複雑な業務ロジック
への対応が必要	

売上
入力	

19	

そこで・・JavaScriptの活用	

Copyright © 2013 OPRO Japan Co., Ltd. All Rights Reserved.
JavaScript活用事例(構築システム機能概要)	
売上・請求業務	

見積・受注業務	
2

1
営業	
  
担当	

案件登録

3

見積・受注
入力

見積・受注
入力

請求入力
(仮)
請求書

見積書 上司へ通知
請求へ移行

kintone	
  
業務アプリ	

営業	
  
上司	

回収業務	

請求書発行依頼

見積
照会

請求入力
(回収)

請求入力
経理	
請求書

kintone	
  
(データ)	

案件情報

顧客
マスタ

請求先
マスタ

見積情報

品目
マスタ

請求情報

請求部署
マスタ

20

Copyright © 2013 OPRO Japan Co., Ltd. All Rights Reserved.
事例のポイント①(見積書の出力)	
■帳票出力 (kintoneの画面から、ボタン操作で帳票出力)	
  ⇒効果:①業務効率化	

JavaScript	

見積画面	

21

Copyright © 2013 OPRO Japan Co., Ltd. All Rights Reserved.
事例のポイント②(アプリ間連携)	
■アプリ間のデータ転送 (見積アプリから請求アプリにデータ連携)	
  ⇒効果:①二重入力の抑制を実現  ②業務の柔軟性を向上(見積時の情報を上書き可能に)	
見積・受注アプリ	

見積内容が
コピーされます。	

請求アプリ	

JavaScript	

見積で入力した内容が
他アプリでも編集可能になります。

22	

Copyright © 2013 OPRO Japan Co., Ltd. All Rights Reserved.
事例のポイント③(権限による画面操作)	
■kintoneのアクセス権限と連動した、帳票出力機能	
■帳票出力に連動したタイムスタンプ設定	
	
営業担当は
(仮)発行となります。

営業	

	
⇒効果:権限の統制	
JavaScript	

• 請求書発行依頼

経理(管理)	

請求書の正式発行と連動し、
発効日を自動設定します。

23	

Copyright © 2013 OPRO Japan Co., Ltd. All Rights Reserved.
その他 JavaScript開発による事例	
■大・中・小分類による、選択項目の動的な絞込機能	
先に選択(入力)した項目から、次に
選択する項目を自動的に絞り込み
ます。

JavaScript	

■新規入力時に、伝票番号を採番	
  伝票番号マスタ及び、画面の新規登録イベントと連動し、欠番の発生を抑制	

JavaScript	

伝票番号マスタを参照し、入力した
レコードに採番を行います。

24	

Copyright © 2013 OPRO Japan Co., Ltd. All Rights Reserved.
業務システム開発基盤として	
kintone (JavaScript)は、 OPROARTS等の他クラウドサービスと連携が可能です。
JavaScriptの活用により、付加価値の高いクラウドシステム基盤を提供します。

基幹システム
データソース	

アプリ	
REST
API	

帳票生成	

CSV

JavaScript	
JavaScript
API	

•  Web Services
•  API calls

PDF	
連携企業様
	

配信	

25

Copyright © 2013 OPRO Japan Co., Ltd. All Rights Reserved.
http://www.opro.net/	
日本オプロ株式会社	
E-Mail:sales@jp.opro.net	
電話番号:03-5765-6510	

弊社の許諾なく、当資料の無断転用、複写、転送を行うことを禁じます。 本文中に記載している会社名および商品名は、各社の登録商標または商標です。	

26	

Copyright © 2013 OPRO Japan Co., Ltd. All Rights Reserved.
フロントエンドのカスタマイズ

JavaScriptによるカスタマイズ

REST  APIによるデータ連携

フロントエンド

バックエンド

copyright©cybozu

27
kintone  REST  API活用事例

DataSpiderソリューションの
ご紹介

株式会社アプレッソ
©	
  2012	
  APPRESSO	
  K.K.	
  All	
  Rights	
  Reserved.	
  
データ連携自由自在の便利なミドルウェア(EAI) 

  「つくる」から「つなぐ」へ
  開発・運用コストを大幅に削減!	

  
 ●企業内外に散在するシステム連携/データ連携を
    ビジュアルに開発、実行、運用管理
●環境設定~運用管理まで
    データ抽出・変換・加工のサービスを開発
    高速な実行と効果的な運用管理ツール
©	
  2012	
  APPRESSO	
  K.K.	
  All	
  Rights	
  Reserved.	
  

29	
  
デモ
【デモンストレーションシナリオ】
" kintone上にある案件管理システムと連携
"   顧客からきたメールの問い合わせを案件管理システムに登録
"   社内にある売上情報のExcelを元に案件管理システムを更新

案件管理理
システム

取り込み
オンプレミス/社内システム
売上情報

データクレンジング

メール問い合わせ

©	
  2012	
  APPRESSO	
  K.K.	
  All	
  Rights	
  Reserved.	
  

30	
  
kintoneAPIが持つ課題
•  プログラムを開発する必要がある
•  連携のたびに連携プログラムを開発する必要がある
•  メンテナンスコストがかかる

連携開発の外注化

開発コストの増大
©	
  2012	
  APPRESSO	
  K.K.	
  All	
  Rights	
  Reserved.	
  

31	
  
中野製薬様事例
中野製薬株式会社
事業内容 	
シャンプー、リンス、トリートメントク
リーム、スタイリング剤などヘアケア
用品の製造、販売

経緯
•  社内ワークフローシステムをリプレイス
•  外回りしている営業部隊もアクセスできるようなシステムを検討
•  外部からもアクセスできるkintoneを採⽤用

課題
•  各種ワークフローは基幹システムとの連携が必要
•  リプレイスのスケジュールが迫っており短期間で開発が必要
©	
  2012	
  APPRESSO	
  K.K.	
  All	
  Rights	
  Reserved.	
  

32	
  
中野製薬様事例
<<勤怠申請>>

<<旅費精算>>

商品コード	

出発日時	
行先(経路)	

△△△株式会社 大阪支店(山科~京都~大阪	
経費コード	

⼊入⼒力力する

品目	

0111	

残業申請

休暇申請

参照

シャンプー	
  

取引先コード	

~	
 1月23日 17:00	

A5001	

商品名	

帰着日時	
  

1月23日 10:00	

<<給与明細>>

<<返品/クレーム>>
51121	

取引先名	

△△△株式会社	

給与明細

参照する

社外(プレゼン)	

承認

マスタ連携

kintone
アダプタ

kintone
アダプタ

kintone
アダプタ

kintone
アダプタ

kintone
アダプタ

DB2  for  i
アダプタ

DB2  for  i
アダプタ

DB2  for  i
アダプタ

DB2  for  i
アダプタ

DB2  for  i
アダプタ

勤怠管理理システム

商品マスタ

経理理システム

基幹システム(AS400)  

⼊入⼒力力する

返品/クレームDB

約2ヶ⽉月半で構築

給与明細DB

©	
  2012	
  APPRESSO	
  K.K.	
  All	
  Rights	
  Reserved.	
  

33	
  
DataSpiderが実現できること
•  ノンプログラミングで短期間に開発が可能
•  メンテナンスもGUIでらくらく
•  追加処理もGUIで簡単に作成可能

連携処理の内製化

連携開発コストの大幅削減
©	
  2012	
  APPRESSO	
  K.K.	
  All	
  Rights	
  Reserved.	
  

34	
  
kintoneの可能性

+	
ノンプログラミングで簡単につながる!
短期間で構築可能!メンテナンスも楽々!

©	
  2012	
  APPRESSO	
  K.K.	
  All	
  Rights	
  Reserved.	
  
「つなぐ・つなげる・つながる」 
新たなビジョンとソリューションを展開します
お問い合わせは…

株式会社アプレッソ 営業部
TEL:03-4321-1111
E-mail:info@appresso.com
URL:http://www.appresso.com/

©	
  2012	
  APPRESSO	
  K.K.	
  All	
  Rights	
  Reserved.	
  

36	
  
バックエンドのデータ連携

JavaScriptによるカスタマイズ

REST  APIによるデータ連携

フロントエンド

バックエンド

copyright©cybozu

37
利利⽤用事例例
copyright©cybozu

38
cybozu.com  カンファレンス
参加登録システム

copyright©cybozu

39
copyright©cybozu

40
copyright©cybozu

41
システム構成
③登録
①申し込み

参加者様

REST  API

②サンクスメール

REST  API

バックエンドプログラム(Java)

⑥ログイン情報通知

マイページ
アプリ

④データ取得
  ・QRコード作成

REST  API
⑤QRコード登録

⑦マイページへログイン

copyright©cybozu

42
まとめ
▎ kintone  には2種類の  API  があります。
■  kintone  JavaScript  API
■  kintone  REST  API

▎ OPROARTS、DataSpider  を利利⽤用する事で、開発
の負担やコストを抑えて、API  連携の仕組みを
導⼊入する事ができます。

copyright©cybozu

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

copyright©cybozu

44

【A-4】kintone API、JavaScript APIの実力