ログと設定ファイル
「ログ・設定ファイル」タブでは、プラグインの動作ログを kintone アプリに残したり、設定内容を JSON ファイルとして書き出し・読み込みしたりできます。
設定ファイル入出力
設定画面の内容を benryReplacement-settings 形式の JSON としてエクスポート／インポートできます。
こんな場面で使う
- 設定変更前のバックアップ
- テスト環境で試した設定を、本番アプリへ反映する
- 複数アプリへ同じ置換表・対象フィールド設定を展開する
インポート後も保存が必要
JSON を読み込んでも、画面上に反映されるだけです。保存ボタンを押すまでアプリのプラグイン設定へ正式保存されません。
プラグインログ（オプション）
ログ記録を ON にすると、設定変更やエラーなどをログアプリへ記録できます。利用者の画面に出ない問題も、管理者が早期に把握しやすくなります。
かりんこラボ製プラグインと共通のログ仕様
ベンリー文字置換のプラグインログは、かりんこラボ株式会社の有料kintoneプラグインと共通のログ仕様です。すでにログアプリを運用している場合は、そのアプリをそのまま利用できます。
ログに記録される主なタイミング
- プラグイン設定を保存したとき（対象フィールド件数、置換表件数、ライセンス状態など）
- 保存時に置換対象が検出されたとき
- 一括置換を実行したとき（またはトライアルで対象確認のみ行ったとき）
- エラーやライセンス認証の問題が発生したとき
ライセンスキーそのものはログに出力されません。
ログアプリの設置
- ゲストスペース外のアプリ … ログアプリもゲストスペース外に置けます。複数アプリから1つのログアプリへ集約できます。
- ゲストスペース内のアプリ … ログアプリは同じゲストスペース内に作成してください。
認証方式の選び方
| 観点 | セッション認証 | APIトークン認証 |
|---|---|---|
| 書き込みに使う権限 | ログイン中の利用者の権限 | APIトークンの権限 |
| 利用者にログアプリの追加権限が必要か | 必要 | 不要 |
| ゲストユーザーの操作 | 本人に追加権限があれば記録可 | 記録されない |
ログアプリのテンプレートは設定画面からダウンロードできます。フィールドコードがテンプレートどおりか確認してください。
一括置換の CSV ログ
一括置換を実行したときは、ブラウザへ変換内容の CSV ログが自動ダウンロードされます。これはログアプリとは別の仕組みです。監査や事後確認用に保管してください。