📆

【kintone】 営業日計算プラグイン

に公開
12

概要

営業日計算プラグインです。
指定の フィールドX から 〇〇日前or後 の日付を指定の フィールドY に表示します。
計算元のフィールドと出力先のフィールド、何営業日分か、前か後かを指定できます。
https://github.com/gitowa12/business-day-calculator-plugin/releases/tag/1.0.0

↓こんな感じです

↓設定画面

使い方

インストール

ダウンロードは以下リンクから可能です。
リンク先のplugin.zipファイルをクリックしてダウンロードしてください。
ダウンロードしたZipファイルは解凍せず、そのままkintoneへインストールして下さい。
※詳しいプラグインインストール方法についは、kintoneの公式ドキュメントを参照してください。
https://github.com/gitowa12/business-day-calculator-plugin/releases/tag/1.0.0

事前準備

このプラグインでは、営業日計算を行う際に、営業日をまとめた日付情報を取得する必要があります.
以下に従って、日付情報を管理するアプリを事前に作成してください。

1. 祝祭日カレンダーアプリの作成

「祝祭日管理アプリ」という名前でアプリを作成し、以下、2つのフィールドを追加してください。

  • 祝日フィールドの追加
    このフィールドに祝日の日付を入力します。

    • フィールド名: 祝日
    • フィールドタイプ:日付
    • フィールドコード:祝日
  • 備考フィールドの追加
    このフィールドに祝日の名前を入力します。

    • フィールド名: 備考
    • フィールドタイプ:文字列
    • フィールドコード:備考

2.祝日情報の追加

先程作成したフィールドに、日付と祝日名を入力してレコードを追加します。
※手動で追加しても問題ありませんが、CSVのインポートで行うと一括で入力できるため便利です。
 インポート方法についてはkintoneの公式ドキュメントをご参照ください。
↓実際の画面

3.祝祭日カレンダーのアプリIDの設定

プラグインの設定画面に、作成した祝祭日カレンダーアプリのアプリIDを入力します。
アプリIDを設定しないと、正常に動作しません。
※アプリIDはkintoneのアプリを開いた際のURL https://hogehoge.cybozu.com//k/アプリID/  です。
↓実際の画面

操作の一覧

  • 設定の追加
    上段の項目を入力し、隣の追加ボタンをクリックすると、下の設定リストの最上段に追加されます。

  • 設定の編集・保存
    追加した設定を編集するには、右の編集ボタンをクリックしてください。クリックすると、編集ボタンが完了ボタンに切り替わるので、編集を終えたら完了ボタンをクリックしてください。

  • 設定の削除
    追加した設定を削除するには、右の削除ボタンをクリックしてください。

  • 設定の並べかえ
    設定リスト左端のハンドルでドラッグアンドドロップでの設定項目の並び替えが可能です。
    ↓実際の画面

  • 設定の保存・キャンセル
    設定が完了したら、画面下部の保存をクリックしてください。保存ボタンをクリックせず、画面を切り替えると設定内容は保存されずに破棄されます。
    設定を保存しない場合には、隣のキャンセルボタンをクリックしてください。設定を破棄し、プラグイン画面に遷移します。

仕様

対応画面

  • レコード追加画面
  • レコード編集画面

対応フィールド

指定できるフィールドタイプは以下です。

  • 日付フィールド
  • 日時フィールド

技術スタック

  • 言語
    HTMS, CSS, JavaScript, TypeScript
  • フレームワーク
    React, TailWindCSS,
  • ライブラリ
    dnd-kit(並び替え機能)

ご利用にあたって

ライセンスはMITライセンス。

Discussion

Hidden comment
Hidden comment
Hidden comment
Hidden comment
Hidden comment
北川北川

質問お願いします。
まずは有用なプラグインを作成していただきありがとうございます。
設定もうまくいき動作している状態なのですが、土日をすべて休日としてカウントしていると思いますが、月に1回程度、変則で土曜出勤の日があります。そこで、除外設定を行う、もしくは土日もすべてを祝日として登録するような改変をすることは可能でしょうか?
ご検討お願いいたします。

ちひろちひろ

こちら、制作ありがとうございます。インストールはできたのですが、うまく機能しません。
対処法を教えていただくことは可能でしょうか?

towa12towa12

利用していただきありがとうございます。
うまく機能しないというのは、状況もう少し詳しく教えていただけますでしょうか?

ちひろちひろ

ありがとうございます!
全ての設定が、マニュアル通り済んでいるはずですが、レコード保存時に設定箇所に日付反映されないのです。

towa12towa12

レコード保存時に設定箇所に日付反映されないのです。

このプラグインは計算元フィールドに日付を入力したタイミングで、出力先フィールドに計算後日付が即反映される動作をします。レコード保存時ということは、日付入力時点では動作するが、レコード保存後に日付は反映されていなということでしょうか?
※こちらは想定していない動きになりますね。

また、 日付計算元のフィールドと出力先のフィールドはフィールドコードで指定されていますでしょうか?フィールド名ではうまく動作しないためこちら確認いただけますか?

ちひろちひろ

入力したタイミングでの即範囲もせず、反映自体がされない状態です。

フィールドコードを指定しています。
ちなみに、フィールド名=フィールドコードとしています。

実は、こちらのプラグインを入れる前に、別のものを入れていました。現在はそちらは削除済みですが、何か影響ありますでしょうか?
必要であればこちらのプラグインを再インストールしてみます。

また、祝祭日管理アプリですが、こちらのアプリには土日の反映は不要でしょうか?
現在は、祝祭日に加えて土日もアプリ上登録しているため、それが要因でしたら、ご教示頂けますと幸いです。

ちひろちひろ

立て続けに失礼します。今再設定したところ、一部反映されました!

ご質問です。
1つの入力フィールドに入力した日付に対して、3つの別のフィールドにそれぞれ営業日別に反映させることはできないのでしょうか?
例えば、Aに入力した日付を、B,C,Dにそれぞれ1,2,3営業日前に反映させる、と言うものです。
今反映できているのは、Bのみで、Cと Dに反映されずに困っています。

お忙しい中恐れ入りますが、ご確認の程宜しくお願いしますm(_ _)m

ちひろちひろ

参照元を変更したら解決しました。
お騒がせいたしました。

改めまして、素晴らしいプラグインを作成、世の中にリリースしてくださり、心より御礼申し上げます。