Skip to content

Latest commit

 

History

History

cast-example-kintone-app

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 

Kintone APIとのCast連携

概要

Kintoneはサイボウズ株式会社が提供するサービスであり、特定のイベントや条件に基づいて、Kintone内のアプリへデータを送ることができます。

Kintoneに関する最新の情報や詳細については、以下の公式URLをご参照ください。

Kintone公式サイト

Kintoneと連携することにより、任意の内容をCast機能を通じて送信することができます

Untitled

制約(2024/04/01現在)

Kintoneヘルプのページ内に制限値一覧の項目がございますので、そちらをご確認ください

制限値一覧|kintone ヘルプ

連携方法

設定されているKintoneのログインページよりログインを行ってください

下図赤枠のアイコンをクリックして、Kintoneのアプリを作成を開始します

Untitled

アプリの名前を入力し、必要なフィールドをドラッグアンドドロップで追加していきます

Untitled

フィールドの歯車アイコンをクリックし、各フィールドの詳細設定を行っていきます

Untitled

Kintone上のGUIに従ってフィールド情報を入力します。

大体の場合、必須情報は以下2つです

フィールド名:

Kintone上で表示されるフィールド名(カラム名)です。

フィールドコード:

APIなどからフィールドを指定する場合このコードを使用します。

例)

Untitled

Untitled

すべてのフィールドの設定が終わったら、アプリを公開します

Untitled

アプリの設定を開き、「設定」タブから「APIトークン」の設定画面を開きます

Untitled

「生成する」ボタンをクリックしてAPIトークンを発行します。 アクセス権の設定チェックボックスで許可したい操作をチェックしてください。

Untitled

Actcastアプリとの連携設定を行う場合は、kintoneのサブドメイン名とアプリID 前項で作成したトークンを控え、actcastのCast設定からご利用ください

Untitled

Cast設定

actcastにログイン後、左メニューから任意のアプリケーション > Castsを選択し、Make New Castボタンをクリックしてください。

make_new_cast.png

まずはトリガーを設定します。 ここでは無条件ですべてのデータを送信させるために、何も設定せずにConfigure Actionをクリックします。

続いてアクションを設定します。

cast_config.png

Webhookを選択し、 Webhook 用の設定画面を表示します

Untitled

以下のように設定を行ってください。

URL:https://【YourDomain】.cybozu.com/k/v1/record.json
Method:POST
Headers:Content-Type:application/json
X-Cybozu-API-Token:【YourToken】
Body:{ "app": 【YourAppID】,
 "record": {
"timestamp"   : {"value": "{{ data.timestamp }}"   },  
"line_id"     : {"value": "{{ data.line_id }}"        },       
"forward"     : {"value": "{{ data.forward }}"      },       
"backward"    : {"value": "{{ data.backward }}" }
}
}

取得したサブドメイン名を【YourDomain】に、APIトークンを【YourToken】に、アプリIDを【YourAppID】に設定してください。

入力が完了すると、以下の図のような状態になります。

Untitled

ここで、設定にミスがないかを確認する場合は、ダミーデータを送信してみましょう。 Connectivity TestTry nowボタンをクリックして200 OKと表示されることを確認してください。

Untitled

Untitled

Kintoneのアプリページを開き、入力したデータがアプリに追加されていることを確認してください。

Finishをクリックすると Cast が作成されます。

以上で連携作業は完了となります。

Castについて詳しい設定や仕様が知りたい場合には、Actcast Documents内のCast の項目をご確認ください。

rate limitについて

アクションが Webhook である Cast はレート制限の設定を持ちます。 レート制限の設定値とは Cast の URL が指す Cast 対象サービスに対して一定期間内に送出できるリクエストの回数の上限を表します。 Act に登録されているデバイスたちがこの上限以上の Act Log を送出しようとした場合、Actcast は上限を超える分を Cast 対象サービスにリクエストすることなく破棄します。 レート制限やその解除方法についてはActcast Documents内のCastのレート制限に関する項目をご参照ください

免責

当社は、当社以外の第三者により管理・運営されるサービス(以下「第三者サービス」といいます。「Kintone」はこれに該当します。)と当社サービスをCastを用いて連携させる機能を提供していますが、その連携や連携の継続を保証するものではありません。

当社は、当社サービスと連携またはリンクされている第三者サービスの正確性、信頼性、完全性、有用性およびセキュリティにつき、いかなる保証もいたしません。第三者サービスの詳細や仕様、最新の情報については、第三者サービスの管理・運営者の公式サイト等を参照し、最新の情報を確認いただくことを強くお勧めします。

お客様は、第三者サービスの利用をお客様の責任において行うものとし、当社は第三者サービスの利用によりお客様又は第三者に生じた一切の損害について何らの責任を負いません。また、お客様は、第三者サービスの利用について当該第三者サービスの利用規約、契約等に従うものとし、自らの責任でこれらの内容を確認し、遵守してください。

Castを用いた当社サービスと第三者サービスとの連携に関して問題や疑問が生じたときは、当社までお問合せいただければ、可能な範囲でサポートさせていただきます。しかし、第三者サービスの使用方法やサービスに関するお問合せについては、第三者サービスの公式サポート窓口等をご利用いただきますようお願いいたします。