More Related Content
Similar to kintoneとMicrosoft Flowで学ぶイマドキのシステム間連携 (20)
More from Sakae Saito (20)
kintoneとMicrosoft Flowで学ぶイマドキのシステム間連携
- 2. 1
自己紹介
• NTTデータ ➡ データクラフト ➡ ラジカルブリッジ
• kintone Café 創始者、運営事務局/札幌支部メンバー
• TwilioJP-UG 札幌コアメンバー
代表 “クラウドおじさん”
サイボウズ公認kintoneエバンジェリスト
斎藤 栄(さいとう さかえ)
- 6. 5
Let’s enjoy kintone together!
ログミーの書き起こし記事
http://logmi.jp/222516
2017年5月19日
kintone hive tokyo vol.5
kintone hack
@六本木ヒルズ
- 17. 16
3.kintoneのWebhook
■送信される通知の内容
Webhookを有効にすると、kintoneからJSON形式の通知が送信されます。
●レコードの追加/編集/ステータスの変更
パラメーター 値の型 説明
id 文字列 通知ごとに割り当てられる固有のIDです。
type 文字列
操作の種類です。
レコードを追加した:ADD_RECORD
レコードを編集した:UPDATE_RECORD
レコードのステータスを変更した:UPDATE_STATUS
app 配列 アプリの情報を表す配列です。
app[].id 文字列 アプリのIDです。
app[].name 文字列 アプリ名です。
record 配列
レコードの情報を表す配列です。
配列の形式は、レコードを取得するREST APIと同様です。
レコードの取得(GET)(cybozu developer network)
recordTitle 文字列
レコードのタイトルです。
タイトルにするフィールドは変更できます。
レコードタイトルを設定する
url 文字列 レコードのURLです。
{
"id":"01234567-0123-0123-0123-0123456789ab",
"type":"ADD_RECORD",
"app":{
"id":"1",
"name":"案件管理"
},
"record":{
"レコード番号":{
"type":"RECORD_NUMBER",
"value":"2"
},
~~
"$revision":{
"type":"__REVISION__",
"value":"3"
},
"$id":{
"type":"__ID__",
"value":"2"
}
},
"recordTitle":"往訪:サイボウズ株式会社",
"url":"https://example.cybozu.com/k/1/show#record=2"
}
- 19. 18
3.kintoneのWebhook
●コメントの書き込み
{
"app":{
"id":"1",
"name":"案件管理"
},
"comment":{
"createdAt":"2012-02-03T09:38:09Z",
"creator":{
"code":"kato",
"name":"加藤 美咲"
},
"id":"11",
"mentions":[{
"code":"kato",
"type":"USER"
},{
"code":"org1",
"type":"ORGANIZATION"
},{
"code":"group1",
"type":"GROUP"
}],
"text":"サイボウズ株式会社に往訪してきました。"
},
"id":"01234567-0123-0123-0123-0123456789ab",
"recordId":"2",
"type":"ADD_RECORD_COMMENT",
"url":"https://example.cybozu.com/k/1/show#record=2&comment=11"
}
パラメーター 値の型 説明
app 配列 アプリの情報を表す配列です。
app[].id 文字列 アプリのIDです。
app[].name 文字列 アプリ名です。
comment 配列
コメントの情報を表す配列です。
配列の形式は、レコードを取得するREST APIと同様です。
レコードコメントの一括取得(cybozu developer network)
id 文字列 通知ごとに割り当てられる固有のIDです。
recordId 文字列 レコード番号です。
type 文字列
操作の種類です。
コメントを書き込んだ:ADD_RECORD_COMMENT
url 文字列 コメントのURLです。
ハンズオンでは
これを使います
- 20. 19
4.Microsoft Flow
Webサービス連携サービス
• 画面操作でWebサービス同士を繋ぐサーバーサイド処理を構築できるサービス
• IFTTT, Zapier, Microsoft Flowが有名どころ
• 様々なクラウドサービスへの接続パーツが用意されており、画面操作で何かと
何かを繋いで何かをする処理を作れる。
• Flowは後発でもあり、連携サービス数が少なめか。。
但し、日本語対応が進んでいるのと、Microsoft提供というアドバンテージ。
- 21. 20
4.Microsoft Flow
Microsoft Flowにおける言葉の定義
• トリガー・・・処理を開始するきっかけとなるパーツ群
例)メール受信時、ツイート時、定期実行、Flowボタン・・・・
• アクション・・・各クラウドサービスに操作を行うパーツ群
例)メール送信、Dropboxファイル保存、天気情報の取得、翻訳・・・・
• コネクタ・・・トリガーとアクションの各パーツ群の総称
• フロー・・・コネクタを組み合わせて作成した一連の処理のこと
• テンプレート・・・予め提供されているフローのサンプル
- 22. 21
4.Microsoft Flow
フロー作成の基本的な流れ
① トリガーとなるコネクタを設定
(定期実行、メール受信時、ファイル作成時、HTTPリクエスト受信時、等)
② アクションのコネクタを設定
(メール送信、ファイル作成、HTTPレスポンス送信、ツイートの投稿、等)
③ 必要に応じてアクションを追加
➢ 条件分岐やループも設定可能。
➢ kintone用のコネクタは無いので、 HTTPリクエスト受信時といった汎用的なコ
ネクタを使います。
★近日中にkintoneの公式コネクタが提供されるらしいです。
- 26. 25
5.ハンズオン
② Microsoft Flowの設定
1. Flowにログイン
2. 「マイフロー」をクリック
3. 「一から作成」をクリック
4. 「多数のコネクタやトリガーを検索する」をクリック
5. 「すべてのコネクタとトリガーを検索する」に「HTTP」と入力
6. 「要求 - HTTP要求の受信時」をクリック
7. 「要求本文の JSON スキーマ」にコメント書き込み時に送信されるJSONデー
タのJSON Schemaを入力(次ページ参照)
- 27. 26
5.ハンズオン
{
"type": "object",
"properties": {
"comment": {
"type": "object",
"properties": {
"text": {
"type": "string"
}
}
},
"recordId": {
"type": "string"
}
}
}
コメント書き込み時に送信されるJSONデータの
JSON Schema(一部抜粋){
"app":{
"id":"1",
"name":"案件管理"
},
"comment":{
"createdAt":"2012-02-03T09:38:09Z",
"creator":{
"code":"kato",
"name":"加藤 美咲"
},
"id":"11",
"mentions":[{
"code":"kato",
"type":"USER"
},{
"code":"org1",
"type":"ORGANIZATION"
},{
"code":"group1",
"type":"GROUP"
}],
"text":"サイボウズ株式会社に往訪してきました。"
},
"id":"01234567-0123-0123-0123-0123456789ab",
"recordId":"2",
"type":"ADD_RECORD_COMMENT",
"url":"https://example.cybozu.com/k/1/show#record=2&comment=11"
}
コメント書き込み時に送信されるJSONデータ
こっちを入力
- 33. 32
5.ハンズオン
④ 動作確認
1. 適当なレコードを作成し、詳細画面を開く
2. コメント欄に日本語文章を入力
3. Microsoft Flowのアカウントのメールアドレスに翻訳結果のメールが届いてい
ることを確認
※メールが届かない場合
• Flowの実行履歴を確認(Flowの画面をリロードすると確認できます)
• kintoneのWebhookログを確認(Webhook設定画面の「ログを確認」で確認で
きます)
- 36. 35
5.ハンズオン
② Microsoft Flowの編集
1. 「フローの編集」をクリック
2. 「新しいステップ」をクリック
3. 「アクションの追加」をクリック
4. 「すべてのコネクタとアクションを検索する」に「HTTP」と入力
5. 「HTTP - HTTP」をクリック
6. 「方法」は「POST」を選択
7. 「URI」に以下を入力
https://(自身のサブドメイン名).cybozu.com/k/v1/record/comment.json