「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 |