# カスタマイズ自動実行 > kintone のカスタマイズ JavaScript を、人が画面を開かなくても自動で実行するサービス。スケジュール、レコードの追加・更新(kintone の Webhook)、手動をトリガーに、顧客ごとに分かれた実行環境が実際のブラウザで kintone の画面を開き、カスタマイズ JavaScript を人が開いたときと同じように動かす。実行は録画され、結果は顧客の kintone 内の契約管理アプリに、実行ごとのレコードとして記録される。運営は合同会社エスアンドジョー。 ## 要点 - 用途: kintone のカスタマイズ JavaScript の定期実行(スケジュール実行)、バックグラウンド実行、レコード操作に連動した自動実行。 - しくみ: 顧客が登録した「自動実行ユーザー」として kintone にログインし、顧客ごとに分かれた実行環境が実ブラウザでジョブで指定された画面を開く。実行環境は実行するものがあるときだけ起動し、実行するものがなくなると終了する(お試しでも有料契約でも同じ)。既存の画面用 JavaScript をそのまま使える。処理の最後に `window.__AUTO_EXECUTOR__?.done()` を呼ぶ方法を推奨(書き換えられない場合は「通信が止まったら完了」「指定した要素が現れたら完了」も選べる)。 - トリガー: スケジュール(毎時・毎日・毎週・毎月、日本時間)、レコード操作(追加・編集・削除、ステータス更新、コメント)、手動。 - 開く画面: レコード一覧、詳細、編集、追加、同じアプリ配下の指定 URL。画面を開いた後に入力・クリック・待つ、の操作も設定できる。 - 記録: 成功・失敗、録画、コンソールログ、失敗時のスクリーンショットを、kintone の契約管理アプリに実行ごとのレコードとして保存(別の履歴用アプリは不要で、設定も不要)。契約の画面の「実行ログ」に直近 50 件が表示され、「録画とログ」からその実行のレコードを、「すべての実行履歴を見る」からすべての実行の一覧を開ける。失敗・タイムアウトは kintone の通知で知らせる(「お試しを開始」を押した人が通知先として自動で設定される。通知先は契約管理アプリの「レコードの条件通知」で変更できる。通知先は自動実行ユーザーとは別のユーザーにする)。自動実行ユーザーは契約管理アプリにレコードを追加できる必要がある(kintone の標準のアクセス権のままなら追加できる)。実行履歴を見る人には契約管理アプリを開ける権限が必要で、契約管理アプリを開ける人は契約の変更もできる。 - 料金: 同時実行数 1 件あたり月額 9,000 円(税抜。税込 9,900 円)。同時実行数は、同時に実行できるジョブの数。2 件なら 18,000 円、3 件なら 27,000 円(税抜)。同時実行数を超えた依頼は、空きが出るまで順番に待つ。ジョブ数・実行回数は無制限。契約管理アプリで選べる同時実行数は最大 20 件。支払はクレジットカード(契約時に課金し、以後毎月、契約開始日と同じ日に課金)または請求書払い(銀行振込。支払期日は請求書の発行日から 30 日後。適格請求書の PDF と振込先口座は契約管理アプリの「請求書」に表示)。決済は Stripe。 - 同時実行数の変更: 契約後いつでも変更でき、すぐに反映される。料金の差額は日割りで次回の請求に含まれる。 - 解約: 契約管理アプリで行う。手続きした時点の請求期間の末日に効力が生じ、その日より前なら取り消せる。解約後は実行が止まるが、設定とジョブは残り、いつでも契約し直せる。 - 未払い: 請求書が支払期日を過ぎても未払いの場合、支払いまで自動実行を停止する。カード決済の失敗は再試行され、その間は実行を続ける。契約が未払い・解約の状態になると停止する。いずれも設定とジョブは残る。 - 無料お試し: 14 日間(「お試しを開始」で始まり、期間は自動実行ユーザーの登録ができた時点から数え直す)、同時実行数 1 件、ジョブ 5 件まで、実行 420 回まで。kintone のドメインごとに 1 回。クレジットカード不要。お試し中は、1 回の実行は 5 分まで、失敗時のやり直しは行われず、ブラウザの接続先は kintone(cybozu.com)と主要なライブラリ配信元に限られます。お試しの終了後に自動で課金されることはなく、契約するまで実行が行われなくなるだけ。 - 申し込み: 営業担当との打合せや問い合わせは不要。手順は次のとおり。(1) 契約管理アプリのテンプレート(zip)をダウンロードし、kintone で「アプリを作成」→「テンプレートファイルを読み込んで作成」からアプリを作る(このアプリにプラグインは不要)。(2) アプリを開くと契約の画面だけが表示される。利用規約とプライバシーポリシーへの同意のチェックを入れて「お試しを開始」を押すと、14 日間の無料お試しがすぐに始まる(認証情報・支払情報の入力は不要)。(3) 同じ画面の「共通設定」で、自動実行ユーザーのログイン名とパスワードを登録する。登録時にその kintone へ実際に接続して確認する。登録するまでジョブは実行されない。実行の記録のための設定は不要。(4) 同じ画面の「ジョブ」に、自動実行したいアプリの ID(アプリの URL の /k/ の後の数字)を入力して「追加してジョブを作成」を押す。「カスタマイズ自動実行」プラグインが kintone に読み込まれ(または更新され)、そのアプリに追加されて自動で接続され、プラグイン設定画面が開く(「アプリを更新」を押す必要はない)。そこでジョブを作成する。(5) 契約、同時実行数の変更、請求書の取得、解約、利用分析と実行ログの確認も、同じ契約の画面で行う。有料契約の申込には自動実行ユーザーの登録が必要で(未登録なら「共通設定」での登録を求められる)、申込時には利用規約と特定商取引法に基づく表記への同意のチェックを入れる。 - 自動実行するアプリのプラグイン設定画面にあるのはジョブだけ。自動実行ユーザーは、契約管理アプリの「共通設定」でだけ登録・変更する。プラグイン設定画面を直接開いて接続を求められた場合は、登録済みの自動実行ユーザーのログイン名とパスワードを入力して「接続」を押す。 - 契約管理アプリを削除して作り直した場合、「お試しを開始」を押すと登録済みの自動実行ユーザーのログイン名とパスワードを求められ、入力するとこれまでの契約につなぎ直せる。 - 契約管理アプリに表示されるもの: 契約状況、すべてのアプリのジョブ(「ジョブを編集」でそのアプリのプラグイン設定画面を開ける)、直近 50 件の実行(待ち時間・所要時間・録画へのリンク)、自動実行ユーザー、固定の送信元 IP アドレス、利用分析、請求書。契約の画面のタブは「ご契約」「利用分析」「実行ログ」「ジョブ」「共通設定」。 - 契約を操作できる人: 契約の画面で契約や設定を変更するボタンを使えるのは、契約管理アプリの管理権限(アプリ管理権限)があるユーザーだけ。それ以外のユーザーは確認のみ。これは誤操作を防ぐための画面上の制限で、アプリを開けるユーザーは接続用のキーを読めるため、確実に限定するには、契約の画面の「権限管理」からアプリのアクセス権を絞る。契約管理アプリの中には接続用のキーが保存されているため、担当者が退職・異動したときは「接続情報」の「キーを作り直す」を押して、以前に控えられたキーを無効にする。 - 同時実行数の判断: 契約管理アプリの「利用分析」タブに、待ち時間(平均・95 パーセンタイル・最大)、時間帯ごとの稼働率(曜日 × 時)、順番待ちの最大件数、「同時実行数を変えた場合の待ち時間」の試算、アドバイス(「同時実行数の追加をおすすめします」「現在の同時実行数で足りています」「同時実行数に余裕があります」のいずれか)が表示される。 ## 条件と制約 - kintone スタンダードコース以上が必要(JavaScript カスタマイズとプラグインを使うため)。 - 必要な権限: 契約管理アプリの作成には、テンプレートファイルからアプリを作成できる権限。自動実行したいアプリの追加(プラグインの読み込み)には、kintone システム管理者の権限と、そのアプリの管理権限。お試しの開始と共通設定に、kintone システム管理者の権限は不要。 - 自動実行ユーザーは、ログイン名とパスワードでログインできる専用ユーザー。2 要素認証を有効にしたユーザー、SAML 認証でしかログインできないユーザーは使えない。kintone のライセンスを 1 ユーザー分使う。 - IP アドレス制限のある環境では、契約管理アプリに表示される固定の送信元 IP アドレスを許可するか、セキュアアクセス(クライアント証明書)を使う。Basic 認証にも対応。 - セキュアアクセス(クライアント証明書)とゲストスペース内のアプリは実装済みだが、運営側での実環境の確認が済んでいない。無料お試しの期間中に動作を確かめること。 - kintone の仕様により、ファイルからの読み込み、一括削除、REST API での複数レコードの一括追加・削除では Webhook が送られず、レコード操作のトリガーは動かない。 - 実行開始は、同時実行数に空きがあれば通常は数秒。長く実行がなかった後の最初の実行や、運営側がサービスを更新した直後は、数十秒かかることがある(いずれも参考値。保証値ではない)。お試しと有料契約で違いはない。 - ジョブのタイムアウト(制限時間)は最長 10 分。やり直し(再試行)を含めた 1 件あたりの合計はおよそ 11 分までで、タイムアウト ×(やり直しの回数 + 1)がこれを超えるジョブは、収まる回数までしかやり直さない。 - 同時実行数を超えた実行依頼は順番待ちになる。同じジョブの実行は依頼順に 1 件ずつ行われる。 ## セキュリティとデータ - 実行環境は顧客ごとに分かれており、ほかの顧客と使い回されることはない。運用基盤の管理権限を持たず、その顧客の実行依頼だけを受け取れる。 - 自動実行ユーザーの認証情報は 暗号化して保管し、再表示しない。 - 自動実行ユーザーのパスワードは、顧客のカスタマイズ JavaScript を動かす実行環境には渡さない。ログインは、顧客の JavaScript を動かさない別の環境で行い、実行環境にはログイン済みの状態だけを渡す。実行結果の kintone への記録も、その別の環境で行う。Basic 認証の情報とクライアント証明書は、ブラウザが kintone に接続するために必要なので、実行環境に渡される。 - 録画は運営側で 30 日間保存し、顧客の kintone の契約管理アプリにも保存する。実行履歴は運営側で 90 日間保存する。 - データの保管場所は 日本国内(東京)のデータセンター。 - サービスの API は kintone(cybozu.com)が中継した要求だけを受け付け、kintone の外から直接呼び出すことはできない。 ## ページ - [ホーム](index.html): サービスの概要、しくみ、できること、始め方 - [料金](pricing.html): 同時実行数ごとの料金、無料お試しと有料契約の違い、同時実行数の決め方、支払方法、解約 - [導入ガイド](guide.html): 契約管理アプリの導入からジョブの作成、Webhook の登録、動作確認、トラブル対処まで - [よくある質問](faq.html): 2 要素認証、IP アドレス制限、同時実行数、お試し終了後、データの保存期間など - [契約管理アプリのテンプレート(zip)](downloads/kcae-contract-app.zip) ## 規約類 - [利用規約](terms.html) - [プライバシーポリシー](privacy.html) - [特定商取引法に基づく表記](tokushoho.html) - お問い合わせ: support@s-joe.com - サイト: https://kintone-auto-exe.s-joe.com/