よくある質問

kintone の構築を担当する方から寄せられやすい質問と、その回答です。

サービスの概要

カスタマイズ自動実行とは何ですか。

kintone のカスタマイズ JavaScript を、人が画面を開かなくても自動で動かすサービスです。スケジュール、レコードの追加・更新(kintone の Webhook)、または手動をトリガーに、弊社が運用する、お客様ごとに分かれた実行環境が、お客様の登録した自動実行ユーザーとして実際のブラウザで kintone の画面を開きます。カスタマイズ JavaScript は人が開いたときと同じように動き、その様子は録画されます。

kintone のカスタマイズ JavaScript を定期実行(スケジュール実行)できますか。

できます。トリガーに「スケジュール」を選ぶと、毎時・毎日・毎週・毎月の決まった時刻(日本時間)に、指定した画面を開いてカスタマイズ JavaScript を動かします。

レコードの追加や更新をきっかけに、バックグラウンドで実行できますか。

できます。トリガーに「レコード操作(Webhook)」を選ぶと、レコードの追加・編集・削除、ステータスの更新、コメントの書き込みをきっかけに実行します。操作されたレコードが自動で対象になります。kintone 側のアプリ設定で Webhook を登録する必要があります。

kintone の標準機能だけで、カスタマイズ JavaScript を決まった時刻に動かせますか。

kintone のカスタマイズ JavaScript は、本来だれかがブラウザで画面を開いたときにしか動きません。本サービスは、お客様の代わりにブラウザで画面を開くことで、決まった時刻やレコード操作のタイミングでカスタマイズ JavaScript を動かします。

既存のカスタマイズ JavaScript を書き換える必要はありますか。

処理そのものを書き換える必要はありません。処理の最後に完了の合図(window.__AUTO_EXECUTOR__?.done())を 1 行足す方法を推奨しています。JavaScript を書き換えられない場合は、「通信が止まったら完了」「指定した要素が現れたら完了」という判定方法を選べます。

自分で Puppeteer や Playwright を動かすのと何が違いますか。

ブラウザで kintone にログインして画面を開くという仕組みは同じです。本サービスでは、次のものを弊社が用意し、運用します。お客様がサーバーやブラウザを用意して保守する必要はありません。

  • ブラウザを動かす、お客様ごとに分かれた実行環境
  • スケジュール・Webhook・手動のトリガーと、実行の順番待ち
  • 録画、コンソールログ、失敗時のスクリーンショットの保存と、kintone の契約管理アプリへの記録
  • 失敗時の自動やり直しと、kintone の通知による失敗の連絡
  • kintone のプラグイン設定画面からのジョブ設定
  • kintone の画面変更(ログイン画面や保存ボタンの変更)への追従

REST API を使う外部バッチに書き直すのと何が違いますか。

本サービスは、画面用に書かれた既存のカスタマイズ JavaScript をそのまま動かします。処理を REST API 用のプログラムに書き直す必要も、そのプログラムを動かす環境を用意する必要もありません。

カスタマイズが画面に追加したボタンを押さないと始まらない処理も実行できますか。

できます。ジョブに「画面を開いた後の操作」として、入力・クリック・待つ、を順に設定できます。操作する要素は CSS セレクタで指定します。JavaScript が確認ダイアログを出す場合に、OK とキャンセルのどちらを押すかも設定できます。

利用の条件

kintone のどのコースで使えますか。

スタンダードコース以上が必要です。本サービスは JavaScript カスタマイズとプラグインの機能を使うためです。

導入にはどの権限が必要ですか。

手順によって異なります。契約管理アプリの作成には、テンプレートファイルからアプリを作成できる権限が必要です。お試しの開始と自動実行ユーザーの登録に、kintone システム管理者の権限は必要ありません。自動実行したいアプリを追加するときには、プラグインを kintone に読み込むため、kintone システム管理者の権限と、そのアプリの管理権限が必要です。

プラグインはどのように導入しますか。

契約管理アプリの「ジョブ」に、自動実行したいアプリの ID(アプリの URL の /k/ の後の数字)を入力して「追加してジョブを作成」を押すと、「カスタマイズ自動実行」プラグインが kintone に読み込まれ(すでにある場合は更新され)、そのアプリに追加されて、自動で接続されます。プラグインのファイルを別に入手して読み込む必要も、「アプリを更新」を押す必要もありません。契約管理アプリ自体には、プラグインは必要ありません。

自動実行ユーザーには何が必要ですか。

  • 人と兼用しない専用のユーザーであること。自分自身の操作を見分けて無限ループを防ぐために必要です。
  • ログイン名とパスワードでログインできること。
  • 自動実行したいアプリで、カスタマイズ JavaScript が行う操作に必要な権限(レコードの閲覧・編集など)を持つこと。
  • 契約管理アプリにレコードを追加できること。kintone の標準のアクセス権のままであれば、追加できます。
  • kintone の利用ユーザーとして登録されていること(kintone のライセンスを 1 ユーザー分使います)。

2 要素認証を有効にしたユーザーを自動実行ユーザーにできますか。

できません。2 要素認証を有効にしたユーザーと、SAML 認証でしかログインできないユーザーは、自動実行ユーザーにできません。ログイン名とパスワードでログインできる専用ユーザーを用意してください。

IP アドレス制限をしている環境でも使えますか。

使えます。弊社の送信元 IP アドレスは固定で、契約管理アプリに表示されます。この IP アドレスを cybozu.com 共通管理で許可するか、セキュアアクセス(クライアント証明書)を使ってください。

セキュアアクセス(クライアント証明書)に対応していますか。

対応しています。自動実行ユーザーのクライアント証明書(.pfx)とそのパスワードを登録すると、セキュアアクセス用の接続先で kintone を開きます。ただし、弊社での実環境の確認が済んでいません。セキュアアクセスでのご利用は、無料お試しの期間中に動作をお確かめください。

Basic 認証を設定している環境でも使えますか。

使えます。自動実行ユーザーの登録時に、Basic 認証のユーザー名とパスワードをあわせて登録してください。

ゲストスペース内のアプリでも使えますか。

ゲストスペース内のアプリかどうかは、設定画面が自動で判別する作りになっています。ただし、弊社での実環境の確認が済んでいません。ゲストスペースでのご利用は、無料お試しの期間中に動作をお確かめください。

実行のしくみ

同時実行数とは何ですか。何が 1 つに数えられますか。

同時に実行できるジョブの数です。1 つの実行(ブラウザで画面を開いてから完了するまで)が、同時実行数 1 件を使います。同時実行数が 1 件なら一度に 1 つ、3 件なら一度に 3 つまで実行できます。これを超えた依頼は、空きが出るまで順番に待ちます。ジョブの数や 1 か月の実行回数は、同時実行数には関係しません。

同時実行数を超える実行依頼が重なったら、どうなりますか。

順番待ちになり、空きしだい実行されます。同じジョブの実行は、依頼された順に 1 件ずつ行います。待ち時間がどのくらい発生しているかは、契約管理アプリの「利用分析」で確認できます。

トリガーから実行が始まるまで、どのくらいかかりますか。

実行環境は、実行するものがあるときだけ起動し、実行するものがなくなると終了します。同時実行数に空きがあれば、通常は数秒で始まります。長く実行がなかった後の最初の実行や、弊社がサービスを更新した直後は、数十秒かかることがあります(いずれも参考値です。保証する時間ではありません)。無料お試しでも有料契約でも同じです。

実行結果はどこで確認できますか。

お客様の kintone 環境にある契約管理アプリに、実行ごとに 1 件のレコードとして、結果(成功・失敗)、録画、コンソールログ、失敗時のスクリーンショットが記録されます。記録のために別のアプリを作成したり、設定したりする必要はありません。契約の画面の「実行ログ」では、直近 50 件の実行について、待ち時間と所要時間を確認でき、「録画とログ」からその実行のレコードを開けます。「すべての実行履歴を見る」を押すと、すべての実行の一覧が開きます。実行履歴を見る人には、契約管理アプリを開ける権限が必要です。契約や設定を変更するボタンを使えるのは、契約管理アプリの管理権限があるユーザーだけです。

実行が失敗したら通知されますか。

されます。「お試しを開始」を押すと、実行が失敗またはタイムアウトしたときに、押した人へ kintone の通知が届くように自動で設定されます。通知先は、契約管理アプリの「レコードの条件通知」で変更できます。kintone は操作した本人には通知を送らないため、通知先は自動実行ユーザーとは別のユーザーにしてください。

カスタマイズ JavaScript がレコードを更新すると、その更新でまた実行されて無限ループになりませんか。

レコード操作のトリガーには「自己起因を無視」の設定があり、有効にしておくと、自動実行ユーザー自身の操作はトリガーになりません。このために、自動実行ユーザーは人と兼用しない専用のユーザーにしてください。

Webhook のトリガーが動かない操作はありますか。

あります。kintone の仕様により、ファイルからの読み込み、一括削除、REST API での複数レコードの一括追加・削除では Webhook が送られないため、ジョブは動きません。こうした操作の後に処理したい場合は、スケジュールのトリガーをお使いください。

失敗した実行を自動でやり直せますか。

できます。ジョブごとに、失敗時にやり直す回数を設定できます。途中まで進んだ処理をやり直すと二重に処理されることがあるため、やり直しても問題のない処理でだけお使いください。ジョブのタイムアウト(制限時間)は最長 10 分で、やり直しを含めた 1 件あたりの合計は、およそ 11 分までです。タイムアウト ×(やり直しの回数 + 1)がこれを超えるジョブは、収まる回数までしかやり直しません。無料お試し中は、やり直しは行われません。

複数のアプリで使うには、どうすればよいですか。

契約管理アプリの「ジョブ」で、アプリごとに、アプリ ID を入力して「追加してジョブを作成」を押します。プラグインがそのアプリに追加されて自動で接続され、そのアプリのプラグイン設定画面が開きます。ジョブはアプリごとに、そのアプリのプラグイン設定画面で管理します。自動実行ユーザーは契約全体に共通で、契約管理アプリの「共通設定」でだけ登録・変更できます。契約管理アプリには、すべてのアプリのジョブが一覧表示され、「ジョブを編集」からそのアプリのプラグイン設定画面を開けます。

プラグイン設定画面を直接開いたら、接続を求められました。どうすればよいですか。

登録済みの自動実行ユーザーのログイン名とパスワードを入力して「接続」を押してください。契約管理アプリの「ジョブ」からアプリを追加した場合は、自動で接続されます。

スケジュールで、条件に合う複数のレコードを順に処理できますか。

できます。レコード詳細・レコード編集の画面を開くジョブでは、絞り込みクエリを指定すると、条件に合うレコードを 1 件ずつ順に開きます。一度に処理する件数の上限も設定できます。

料金と契約

料金はいくらですか。

同時実行数 1 件あたり月額 9,000 円(税抜)です。同時実行数は、同時に実行できるジョブの数です。これを超えた依頼は、空きが出るまで順番に待ちます。同時実行数は、ご契約後いつでも変更できます。ジョブの数と実行回数に上限はありません。

無料お試しでは何ができますか。

14 日間、同時実行数 1 件、ジョブ 5 件まで、実行 420 回までを無料で使えます。お試し中は、1 回の実行は 5 分まで、失敗時のやり直しは行われず、ブラウザの接続先は kintone(cybozu.com)と主要なライブラリ配信元に限られます。

無料お試しにクレジットカードの登録は必要ですか。

必要ありません。契約管理アプリを開き、利用規約とプライバシーポリシーへの同意のチェックを入れて「お試しを開始」を押すと、その場で始まります。この時点では、認証情報も支払情報も入力しません。14 日間の期間は、その後に自動実行ユーザーを登録した時点から数えます。

無料お試しの 14 日間は、いつから数えますか。

自動実行ユーザーの登録ができた時点からです。契約管理アプリで「お試しを開始」を押すとお試しが始まり、その後「共通設定」で自動実行ユーザーを登録した時点から、14 日間を数え直します。自動実行ユーザーを登録するまで、ジョブは実行されません。

無料お試しは何回利用できますか。

kintone のドメイン(サブドメイン)ごとに 1 回です。

無料お試しの期間や上限を過ぎると、どうなりますか。

実行が行われなくなります。自動的に有料契約へ切り替わることはなく、料金が自動で請求されることもありません。期間の終了後、またはジョブ数・実行回数の上限を超えた分の実行は、画面を開かずに「失敗」として記録され、気づけるように同じ理由の最初の 1 件は契約管理アプリにも記録されます。続けて使う場合は、契約管理アプリから有料契約の手続きをしてください。

申し込みに、問い合わせや打合せは必要ですか。

必要ありません。お試しの開始、契約、同時実行数の変更、請求書の取得、解約まで、すべてお客様の kintone 内の契約管理アプリで行えます。

有料契約を申し込む前に、済ませておく設定はありますか。

自動実行ユーザーの登録が必要です。未登録の場合は、契約管理アプリが「共通設定」での登録を求めます。申込のときには、利用規約と特定商取引法に基づく表記への同意のチェックを入れます。

支払方法は何がありますか。

クレジットカード払いと、請求書払い(銀行振込)を選べます。どちらも契約管理アプリで手続きします。クレジットカード払いは、契約時に最初の課金を行い、以後は毎月、契約開始日と同じ日に課金します。請求書払いの支払期日は、請求書の発行日から 30 日後です。決済の処理には Stripe を利用しています。

請求書(適格請求書)は発行されますか。

発行されます。適格請求書(PDF)を、契約管理アプリの「請求書」からダウンロードできます。請求書払いの場合は、振込先の口座も同じ場所に表示されます。振込は自動で照合されるため、振込後の連絡は必要ありません。

支払いが遅れた場合や、カードの決済に失敗した場合はどうなりますか。

請求書払いでは、支払期日を過ぎても未払いの請求書があると、支払いが確認されるまで自動実行を停止します。クレジットカード払いでは、決済に失敗すると再試行を行い、再試行の間は実行を続けます。再試行しても決済できず、契約が未払いまたは解約の状態になると、実行を停止します。どちらの場合も、設定とジョブは残ります。

同時実行数はいくつで契約すればよいですか。

まず 1 件で始め、契約管理アプリの「利用分析」を見て判断することをお勧めします。「利用分析」には、待ち時間(平均・95 パーセンタイル・最大)、時間帯と曜日ごとの稼働率、順番待ちの最大件数に加えて、「同時実行数を変えた場合の待ち時間」の試算と、同時実行数を増やす・そのままにする・減らすのどれがよいかのアドバイスが表示されます。契約管理アプリで選べる同時実行数は、最大 20 件です。

同時実行数は後から変更できますか。

できます。契約管理アプリの「同時実行数の変更」から、増やすことも減らすこともできます(最大 20 件)。ご契約後いつでも変更でき、変更はすぐに反映されます。料金の差額は日割りで計算し、次回の請求(または課金)に含めます。

解約はどのように行いますか。

契約管理アプリから行えます。解約は、手続きをした時点の請求期間の末日に効力を生じ、それまでは引き続き利用できます。その日より前であれば、解約の手続きを取り消せます。解約の効力が生じると実行は停止しますが、設定とジョブは残ります。

解約や停止の後に、もう一度契約できますか。

できます。契約管理アプリから、いつでも契約し直せます。設定とジョブは残っているため、作り直す必要はありません。

契約の手続きや同時実行数の変更は、だれが操作できますか。

契約の画面で契約や設定を変更するボタンを使えるのは、契約管理アプリの管理権限(アプリ管理権限)があるユーザーだけです。それ以外のユーザーは、内容の確認だけができます。これは誤操作を防ぐための画面上の制限です。契約管理アプリを開けるユーザーは、アプリの中に保存されている接続用のキーを読めるため、変更を確実に防ぎたい場合は、契約の画面の「権限管理」から契約管理アプリのアクセス権の設定を開き、アプリを開けるユーザーを絞ってください。

契約管理アプリを使っていた担当者が退職・異動したら、何をすればよいですか。

契約管理アプリのアクセス権からその人を外したうえで、契約の画面の「接続情報」にある「キーを作り直す」を押してください。契約管理アプリの中には、弊社のサービスに接続するためのキーが保存されています。作り直すと、それ以前に控えられていたキーは使えなくなります。

契約管理アプリを削除してしまいました。作り直せますか。

作り直せます。テンプレートからもう一度アプリを作成し、「お試しを開始」を押してください。その kintone で自動実行ユーザーがすでに登録されている場合は、登録済みの自動実行ユーザーのログイン名とパスワードの入力を求められます。入力すると、これまでの契約につなぎ直せます。

セキュリティとデータ

データはどこに保管されますか。

日本国内(東京)のデータセンターに保管します。

自動実行ユーザーのパスワードはどのように保管されますか。

暗号化して弊社のサービス側に保管します。登録後に画面へ再表示されることはなく、kintone にも保存しません。契約管理アプリの中に保存されるのは、接続用のキーだけです。パスワードは、お客様のカスタマイズ JavaScript を動かす実行環境には渡しません。ログインは、お客様の JavaScript を動かさない別の環境で行い、実行環境にはログイン済みの状態だけを渡します。実行結果の kintone への記録も、その別の環境で行います。Basic 認証の情報とクライアント証明書は、ブラウザが kintone に接続するために必要なので、実行環境に渡されます。

実行環境はほかの顧客と共有されますか。

共有されません。ブラウザを動かす実行環境はお客様ごとに分かれており、ほかのお客様と使い回されることはありません。実行環境には運用基盤の管理権限を持たせておらず、そのお客様自身の実行依頼だけを受け取れる構成にしています。

カスタマイズ自動実行の API を、kintone の外から直接呼び出せますか。

できません。弊社のサービスの API は、kintone(cybozu.com)が中継した要求だけを受け付けます。

録画や実行履歴はどのくらいの期間保存されますか。

弊社側では、録画を 30 日間、実行履歴を 90 日間保存します。録画と実行結果はお客様の kintone の契約管理アプリにも記録されるため、そちらはお客様が削除するまで残ります。

録画は kintone のディスク容量を使いますか。

使います。契約管理アプリのレコードに録画ファイルを保存するためです。容量が気になる場合は、ジョブごとに録画を「失敗時のみ保存」または「保存しない」にできます。

ここにない内容を確かめるには

設定の手順は導入ガイド、料金は料金のページにまとめています。お客様の環境で動くかどうかは、14 日間の無料お試しで実際に確かめられます。