管理画面の検索機能をDateTimeTypeに対応

[okazy]

概要(Overview・Refs Issue)

管理画面の検索機能をDateTimeTypeに対応

互換性を確保するため yyyy-MM-dd と yyyy-MM-dd HH:mm:ss のどちらのフォーマットでも検索可能なようにしました。

close #4618

Chrome

Safari

FireFox

方針(Policy)

• カスタマイズさてていることを考慮して既存の DateType は残しつつ DateTimeType を新たに追加
• ブラウザ間の差異をなくすためにUIは datetimepicker に統一
• 実装はできるだけ今のものを利用できるように配慮

実装に関する補足(Appendix)

• カレンダーのUIはブラウザごとにHTML5と datetimepicker が混在していたのを統一した
  • シンプルで使いやすいHTML5にしたかったが対応ブラウザが限られてしまうので諦めた
• datetimepicker で検索条件が消えてしまう課題にも対応
• ShippingRepository::getQueryBuilderBySearchDataForAdmin() は利用されていなかったので @ deprecated とした
• DateType と DateTimeType のどちらも指定されていた場合には DateTimeType を優先する

テスト（Test)

UnitTestを追加

相談（Discussion）

マイナーバージョン互換性保持のための制限事項チェックリスト

• 既存機能の仕様変更
• フックポイントの呼び出しタイミングの変更
• フックポイントのパラメータの削除・データ型の変更
• twigファイルに渡しているパラメータの削除・データ型の変更
• Serviceクラスの公開関数の、引数の削除・データ型の変更
• 入出力ファイル(CSVなど)のフォーマット変更

レビュワー確認項目

• 動作確認
• コードレビュー
• E2E/Unit テスト確認(テストの追加・変更が必要かどうか)
• 互換性が保持されているか
• セキュリティ上の問題がないか

[okazy]

２点修正が必要とのご意見をいただきました。

• 時分の補完時にDateTimeTypeかどうかのチェック（Formがカスタマイズされていた場合の考慮）
• datetimepicker の初期値の設定

[okazy]

クロスブラウザで日時入力UIの調整は地獄でした。

[k-yamamura]

各フォームタイプにある、

'class' => 'datetimepicker-input',

も不要になったので削除しておいてください。

[okazy]

@k-yamamura
指摘ありがとうございます！

いただいた指摘を試してみたところ、入力フォームのフォーカスを解いても明示的に閉じてやらないとカレンダーが消えなくなってしまいました。

原因の特定まではできなかったのですが、js で datetimepicker の対象のフォームを特定するのにも利用していますので、そのまま残す方向でどうでしょうか。

https://github.com/EC-CUBE/ec-cube/pull/4619/files#diff-81ef87e3d0e00a02b177bccd6fa3e517R47

[okazy]

カレンダー入力のライブラリ自体を変更するのはどうかという提案をいただきました。
ライブラリは以下
https://flatpickr.js.org/

[okazy]

カレンダー入力ライブラリの変更は影響範囲がこちらのプルリクの内容と異なりますので別でIssueを作成しました。
#4622

[kiy0taka]

検索条件に登録日(終了)2018/09/28 19:13 を指定すると、登録日が 2018/09/28 19:14 の商品が検索されてしまいます。

[okazy]

ありがとうございます！確認します。

[okazy]

Repository を変更する方針で考えています。

            $date = clone $searchData['order_date_end'];
            $date = $date
                ->modify('+1 days');

↓

            $date = $searchData['order_date_end'];

ShippingRepository->getQueryBuilderBySearchDataForAdmin() がどこにも使われていない気がするので対応考えます。

[okazy]

#4619 (comment)

こちらの修正方法にしようかと思っていたのですが、Repositoryの挙動が変わるのはさすがにまずいかと思いました。
冗長にはなってしまいますが、新しいFormを追加する対応がいいかと思いましたのでそちらで実装して見ます。

[okazy]

指摘いただいたこと

• 検索条件で引っかからないパターン or ２重で引っかかることはないか確認（ <= と < など）
• 今は分までとなっているが、秒まで指定したい

[okazy]

検索条件で引っかからないパターン or ２重で引っかかることはないか確認（ <= と < など）

開始は含み: >=
終了は含まない: <

ですので漏れなくだぶりなく検索可能です。

[okazy]

秒まで指定できるようにしました。
管理画面からも秒まで指定できるようにしています。
補完などは用意せず一旦シンプルな作りにしています。