日付の有効期間

[アーティクル]
03/08/2023

この記事では、データエンティティとデータソースの開始日時に関する情報を提供し、エンティティの開始日時を作成する方法を示します。また、日付の有効性が読み取りおよび書き込みアクティビティに適用される方法についても説明します。

データエンティティを含む日付有効機能のデザインパターンはさまざまです。パターンは、次の 2 つの主要なカテゴリに分類されます。

有効日エンティティ - エンティティには少なくとも 1 つの有効日データソースがあり、エンティティ自体も日付が有効です。
有効日の対象外のエンティティ – エンティティ自体は、有効日ではありませんが、有効日データソースが含まれています。

次のセクションでは、プロパティの小さなリストとエンティティの日付を有効にする操作と有効日データソースを制御するメソッドについて説明します。

有効日のエンティティ

次のテーブルは、データエンティティの日付を有効にする操作を制御するプロパティを示しています。

エンティティのプロパティ名	プロパティのノード	先頭値	説明
ValidTimeStateEnabled	デザイナーのデータエンティティノード	はい (またはいいえ)	値 Yes は、エンティティの日付を有効にします。エンティティには、ValidFrom および ValidTo フィールドが必要です。これらのフィールドは、有効日データソースの ValidFrom フィールドおよび ValidTo フィールドにマップされます。値 No は、エンティティのデータソースである日付有効テーブルの日付有効性の強制を無効にしません。
ValidTimeStateKey	データエンティティノードの下の、キー>EntityKey	はい (またはいいえ)	値 Yes は、この特定のエンティティの日付有効値を実施するために必要なキーを識別します。

読み取りアクティビティ

日付の有効期限がデータエンティティレベルで設定されると、エンティティからの読み取りはテーブルからの読み取りと動作が同じです。エンティティには、システムが読み込み中に日付フィルターを適用する ValidFrom および ValidTo フィールドがあります。

クエリモードと X++ SQL 選択の validtimestate キーワード

日付有効なエンティティは、X++ validtimestate キーワードの使用方法が異なる次の 3 つのクエリモードをサポートします。

既定のモード - 現在のレコードは、select * from FMVehicleRateEntity; // X++ SQL. を使用して返されます。
AsOfDate モード - 指定された日付に有効なレコードは select validtimestate(d1) * from FMVehicleRateEntity; を使用して返されます。
AsOfDateRange モード - 指定された日付範囲に有効なレコードは select validtimestate(d1,d2) * from FMVehicleRateEntity; を使用して返されます。

重要: それら自体は有効日ではないデータエンティティでも、有効日のデータソースがある場合には、既定のクエリモードのみ使用できます。この概念については、この記事の後半で説明します。

データソースレベルで日付フィルターを適用する

日付実効フィルタリングが、データエンティティの外部、データソースレベルで必要とされるシナリオがあります。たとえば、顧客エンティティ (CustTableTestEntity) にはデータソースとして CustTable および LogisticsPostalAddress が含まれています。LogisticsPostalAddress は日付の有効なテーブルであり、CustTable は通常のテーブルです。顧客エンティティの目的は、顧客とそのアクティブなプライマリアドレスのリスト (プライマリアドレスがある場合) を含めることです。したがって、顧客エンティティ自体は日付有効ではありませんが、データソースの 1 つに日付フィルターが必要です。この場合、エンティティは ValidTimeStateEnabled にマークされません。代わりに、日付フィルターの適用プロパティがデータソースに追加されます。 日付フィルターの適用の値がはいに設定されている場合、日付フィルターがそのデータソースに自動的に適用されます。次のテーブルでは、データエンティティの有効日データソースの有効日動作を制御するプロパティについて説明します。

データソースのプロパティ名	プロパティのノード	先頭値	説明
日付フィルターの適用	エンティティの特定のデータソースのノード	はい (またはいいえ)	読み取りで、このプロパティは、エンティティデータソースで日付フィルターが適用されるかどうかを制御します。この場合、データソースを ValidTimeStateEnabled にマークする必要があります。このプロパティ値は、エンティティ自体が日付有効であるかどうかにかかわらず有効です。書き込みで、このプロパティは影響を与えません。

この記事では、これらの日付が有効なプロパティの使用方法とそれらの相互作用について説明します。

読み取り用の状態マトリックス

このセクションは、データエンティティからの読み取りのみに関係します。以下の一対の参照マトリックスは、データエンティティとそのデータソースとの間に存在できる日付有効状態の組み合わせについて説明します。各テーブルには、4 つのクラスが含まれ、各ケースでは、2 つの異なるターゲットについて説明します。理解しておく必要がある主要なポイントを次に示します。

エンティティから指定された読み取りで、クエリモードはエンティティと有効日データソースの両方で同じです。
エンティティの日付が有効ではない場合、クエリモードは既定のモードに限定されます。したがって、日付が有効なデータソースは現在の日付のみにアクセスされます。
有効日データソースで、日付フィルターの適用プロパティをいいえに設定すると、過去、現在、未来のすべてのデータをデータソースに戻すことができます。
OData で、日付の有効なフィルターはデータエンティティには適用されません。ただし、データソースのフィルターはすべてのコードパスに適用されます。

A. エンティティは有効日である、なぜならば ValidTimeStateEnabled = はい

データソースは日付が有効

データソースは日付が有効ではない

日付フィルターの適用 = はい

エンティティ 日付フィルターが適用されます。すべてのクエリモードがサポートされています。
データソース: フィルターが適用されます。クエリモードはサポートされていますが、モードはエンティティのコードと同じです。

有効日の対象外のデータソースは影響しません。

日付フィルターの適用 = いいえ

エンティティ 日付フィルターが適用されます。すべてのクエリモードがサポートされています。
データソース: 日付フィルターは適用されません。

有効日の対象外のデータソースは影響しません。

B. エンティティは有効日ではない、なぜならば ValidTimeStateEnabled = いいえ

データソースは日付が有効

データソースは日付が有効ではない

日付フィルターの適用 = はい

エンティティ 日付フィルターが適用されません。
データソース: 日付フィルターが適用されます。既定のクエリモードのみサポートされ、X++ validtimestate キーワードは省略されます。

有効日の対象外のデータソースは影響しません。

日付フィルターの適用 = いいえ

エンティティ 日付フィルターが適用されません。
データソース: 日付フィルターは適用されません。

有効日の対象外のデータソースは影響しません。

次のスクリーンショットは、日付フィルターの適用 プロパティをはいに設定したものです。したがって、Address データソースの読み取りに日付フィルターが適用されます。

活動の記述

このセクションでは、有効日エンティティとその有効日データソースの動作を設定するオプションについて説明します。有効日テーブルの概念を確認し、それを有効日エンティティと対比させることから開始します。 有効日テーブル: データが有効日テーブルに挿入または更新されると、プロセスは、xRecord.validTimeStateUpdateMode メソッドをテーブルバッファーで呼び出すことができます。このメソッドは、ValidTimeStateUpdate 列挙型の要素を受け入れます。使用可能な要素値を次に示します。

CreateNewTimePeriod
訂正
EffectiveBased

有効日エンティティ: 対照的に、データが有効日データエンティティに挿入または更新されると、validTimeStateUpdateMode メソッドはエンティティレベルで使用されません。書き込みについては、データエンティティは、テーブルレベルに有効日プロセスを残します。エンティティデータソース上で 有効時間状態の更新 プロパティを使用すると、データエンティティの各データソースのために validTimeStateUpdateMode メソッドを使用することを指定することができます。

日付有効なエンティティを作成しています

このセクションでは、有効日のあるエンティティを作成する方法を示します。

新しいプロジェクトの作成

ファイル>新規>プロジェクトをクリックし、新しいプロジェクトを作成します。
ソリューションエクスプローラーで、プロジェクトを右クリックしてからプロパティをクリックします。プロジェクトの プロパティページ ダイアログボックスが開きます。
ビルドでのデータベースの同期プロパティの値を True に変更し、OK をクリックします。このプロパティはプロジェクトごとに 1 回のみ設定する必要があります。

プロジェクトへの新しいデータエンティティの追加

FMVehicleRateEntity という名前の新しいエンティティを作成し、プロジェクトに追加します。

左ウィンドウで Microsoft Dynamics 365 アーティファクトを選択してから、メインウィンドウの左側にあるデータエンティティをクリックします。
追加をクリックします。 データエンティティビュー ウィザードが起動します。
次のスクリーンショットに表示される作成するデータエンティティのプロパティ値を指定します。最も重要なフィールドは、FMVehicleRate を選択する プライマリデータソース です。

次へをクリックします。
プライマリデータソース、FMVehicleRate からエンティティにフィールドを追加します。
すべてのフィールドを選択し、完了をクリックします。

項目がソリューションエクスプローラーのプロジェクトに追加されます。

プロジェクトの構築

ビルド>ソリューションのビルドをクリックし、プロジェクトを構築します。
ビルドにエラーが含まれていないことを確認します。プロセスのこの段階では、警告を容認する必要があります。

プロパティ値の検証

ソリューションエクスプローラーで、FMVehicleRateEntity ノードを選択し、FMVehicleRateEntity エンティティのプロパティをプロパティ ウィンドウの値と比較して確認します。

エンティティの日付を有効にする

ソリューションエクスプローラーで、FMVehicleRateEntity ノードを右クリックしてから開くをクリックします。エンティティのデザイナーが中央のウィンドウに開きます。
時間状態が有効であるかどうかを検証するプロパティの値をはいに変更します。

有効日データソースの有効時間状態の更新プロパティのコンフィギュレーション

FMVehicleRate データソースを選択し、有効時間状態の更新 プロパティを CreateNewTimePeriod に設定します。

プロジェクトをテスト

プロジェクトを再度構築し、次の X++ コードを実行してプロジェクトをテストします。

/// <summary>
    /// Runs the class with the specified arguments.
    /// </summary>
    /// <param name = "_args">The specified arguments.</param>
    public static void main(Args _args)
    {
        FMVehicleRateEntity FMVehicleRateEntity;
        FMCarClass          vehicle;
        FMVehicleModel      model;
        FMVehicleRate       vehicleRateTable;
        TransDate           d1=1\1\1999,d2=31\12\2014;

        ttsbegin;

        select count(RecId) from FMVehicleRateEntity;
        info(strfmt("Entity - Valid today before insert %1",FMVehicleRateEntity.RecId));

        select count(RecId) from vehicleRateTable;
        info(strfmt("Table - Valid today before insert %1",vehicleRateTable.RecId));

        select firstonly model;

        vehicle.VehicleModel = model.RecId;
        vehicle.VehicleId = "TestV1001";
        vehicle.insert();

            if (vehicle)
            {
                FMVehicleRateEntity.clear();
                FMVehicleRateEntity.FMVehicle_VehicleId = vehicle.VehicleId;
                FMVehicleRateEntity.ValidFrom = d1;
                FMVehicleRateEntity.ValidTo = d2;
                FMVehicleRateEntity.RatePerDay = 100;
                FMVehicleRateEntity.RatePerWeek = 600;
                FMVehicleRateEntity.insert();

                // Should increase by one as compared to before insert numbers
                select count(RecId) from FMVehicleRateEntity;
                info(strfmt("Entity - Valid today after insert %1",FMVehicleRateEntity.RecId));

                // Should increase by one as compared to before insert numbers
                select count(RecId) from vehicleRateTable;
                info(strfmt("Table - Valid today after insert %1",vehicleRateTable.RecId));

                // New record should show in count
                select validtimestate(d1) count(RecId) from FMVehicleRateEntity;
                info(strfmt("Entity - Valid 1999 %1",FMVehicleRateEntity.RecId));

                // New record should show in count
                select validtimestate(d1) count(RecId) from vehicleRateTable;
                info(strfmt("Table - Valid 1999 %1",vehicleRateTable.RecId));

                // update newly created record
                // This should split record into two - 2009 to Today, today to 2014
                // Split happens because of mode in saveEntityDatasource
                select forupdate validtimestate(d1,d2) FMVehicleRateEntity 
                     where FMVehicleRateEntity.FMVehicle_VehicleId == vehicle.VehicleId &&
                           FMVehicleRateEntity.ValidFrom == d1 &&
                           FMVehicleRateEntity.ValidTo == d2;
                FMVehicleRateEntity.RatePerDay = 200;
                FMVehicleRateEntity.update();

                // validate the split
                while select validtimestate(d1,d2) FMVehicleRateEntity
                     where FMVehicleRateEntity.FMVehicle_VehicleId == vehicle.VehicleId
                {
                    info(strfmt("Entity - %1 to %2 , RatePerDay-%3, RatePerWeek-%4",
                            FMVehicleRateEntity.ValidFrom,
                            FMVehicleRateEntity.ValidTo,
                            FMVehicleRateEntity.RatePerDay,
                            FMVehicleRateEntity.RatePerWeek));
                }
                ttsabort;
            }
        }

次の方法で共有

日付の有効期間

有効日のエンティティ