「IF」関数を使用することでプラグインを利用せずに、同様の機能が実現できるため、こちらのプラグインの提供は停止します。

「IF」関数の設定方法については、詳細については、下記参照してください。

有償契約のお客様については、今後バージョンアップの予定はありませんが、ダウンロード済みプラグインは引き続きご利用可能です。プラグイン本体が必要な場合は、お問い合わせページからご連絡ください。


指定した日付の年度を数値フィールドまたは文字列(1行)フィールドに記録するプラグインです。
また、月、四半期、半期を記録することもできます。
カレンダーPlusプラグインに対応しています。

2020年1月に、kintoneの関数に「IF」が加わったことにより、この年度記録プラグインを使用しなくても計算式で、年度、半期、四半期、月が作れるようになりました!

下記は更新手段別に、正しく年度等が再計算されるかどうかの表です。kintone関数を利用することはメリットしかありませんので、ぜひ、関数を使用したアプリ構成に変更してみてください。

更新手段kintone関数を使用年度記録プラグインを使用
kintoneの登録画面・編集画面での入力
CSVファイルの読み込み
他プラグインでの更新
カレンダーPlusのみ対応
連携サービスからの更新

どういう考え方で関数を書けばよいかは、こちらの動画、およびkintoneヘルプ「年度単位で集計したい」をご覧ください!

動作イメージ

指定した日付の年度、月、四半期、半期を記録します。保存ボタンクリックのタイミングで値がセットされます。

【値変更時の使用イベント(参考 cybozu developer network)】
レコード追加画面の保存実行前イベント
レコード編集画面の保存実行前イベント
レコード一覧画面のインライン編集の保存実行前イベント

プラグイン設定

設定項目 説明
プラグインログ
ログアプリID
プラグインエラーが発生した場合
「プラグインログ機能について」のページを参照してください。
年度判定のフィールド 年度判定基準の日付または日時フィールドを選択します。
年度開始月 1〜12月のいずれかを選択します。
年度記録フィールド 年度を記録するフィールドを選択します。数値フィールドまたは文字列(1行)フィールドが選択できます。
月記録フィールド 月を記録する文字列(1行)フィールドを選択します。
月記録フォーマット 01:4月、4月、01:Apr、Aprのいずれかを選択します。頭の番号(01)は、年度開始月からの連番になります。
四半期記録フィールド 四半期を記録する文字列(1行)フィールドを選択します。
四半期記録フォーマット 第1四半期、1Q、Q1のいずれかを選択します。
半期記録フィールド 半期を記録する文字列(1行)フィールドを選択します。
半期記録フォーマット 1:上半期、上半期、1H、H1のいずれかを選択します。
  • 値を反映するフィールドには、ユーザーの編集権限が必要です。

制限事項等

  • ライセンス有効状況確認のため、外部サーバーと通信を行います。
  • 同一アプリに他のJavaScriptカスタマイズやプラグインが設定されている場合、正しく動作しない可能性があります。正しく動作しない場合は、他のJavaScriptカスタマイズやプラグインを外してご利用ください。
  • カレンダーPlusプラグイン対応について
    カレンダーPlusの画面で登録変更を行ったレコードについては、カレンダーPlusの開始日時のフィールドまたは終了日時のフィールドに年度判定フィールドが設定されているのみ動作します。

プラグインダウンロード

利用規約に同意いただいたうえで、ご利用ください。

更新情報

日付 バージョン 内容
2018/05/01 1 初回リリース
2018/07/23 2 有償版の機能として月、四半期、半期の記録を追加。(バージョン1との互換性はありません)
2018/07/27 3 ・開始月の選択肢を追加
・四半期と半期のフォーマットの見直し
2020/09/22 4 ・カレンダーPlusに対応(カレンダーPlus v12.0で動作確認)
・年度判定のフィールドに日時フィールドを追加
・部分的な無料機能を廃止し、全て有償機能とする
・ログ機能の追加

ログ記載内容・想定されるエラー等

保存実行前イベントカレンダーPlusイベントプラグイン設定保存イベント
【イベント】app.record.create.submit, app.record.edit.submit, app.record.index.edit.submit
想定されるエラー ログ記録
・フィールドが削除された
・フィールドコードが変更された
・フィールドの参照権限がない
・年度算出時に想定外エラーが発生
※プラグイン設定で「プラグインエラーが発生した場合」で「処理停止」を選択している場合は、処理が止まり保存ができません。「処理続行」を選択している場合は、記録先フィールドの値は変更されないまま登録されます。
Error
・記録先フィールドに更新権限がない
※エラーにはならず、記録先フィールドの値は変更されないまま登録されます。
なし
【イベント(カレンダーPlus)】cp.create.submit, cp.edit.submit, cp.duplicate.submit
想定されるエラー ログ記録
・フィールドが削除された
・フィールドコードが変更された
・フィールドの参照権限がない
※エラーにはならず、カレンダーPlusのデータ更新も行われますが、記録先フィールドの値変更は行われません。
なし
・記録先フィールドに更新権限がない
※カレンダーPlusのエラーメッセージが表示され、レコード登録できません。なお、かりんこラボプラグインではエラーが検知されません。
なし
【イベント(プラグイン設定保存)】caryncolabo.plugin.config.submit
ログ内容 ログ記録
・設定内容がJSON形式で書き込まれます。 Information