AX 2012: ValidTimeState

heinz.schweda@schweda.net (Heinz Schweda) — Fri, 27 May 2011 18:08:00 +0200

Wer schon einmal eine Tabelle aufbauen musste, wo die einzelnen Datensätze über Datumsfelder nur für einen bestimmten Zeitraum gültig sind - ähnlich den Handelsvereinbarungen -, weiß wieviel Entwicklungsaufwand daintersteckt, wenn sichergestellt werden muss, daß sich die Gültigkeitsbereiche der einzelnen Datensätze nicht überschneiden.

Dynamics AX 2012 stellt hierfür eine neue Tabelleneigenschaft validTimeStateFieldType zur Verfügung, mit deren Hilfe sich Dynamics AX selbst um vieles kümmert.

Beim Anlegen einer solchen Tabelle muss nur auf die folgenden Punkte geachtet werden:

Eigenschaft ValidTimeStateFieldType der Tabelle auf Date oder UtcDateTime setzen. Dadurch erstellt AX zwei neue Felder ValidFrom und ValidTo in der Tabelle.
Man muss einen eindeutigen Index erstellen, der die entscheidenden Felder der Tabelle sowie die Felder ValidFrom und ValidTo enthält.
Bei diesem Index müssen bestimmte Eigenschaften gesetzt werden.

Ab diesem Zeitpunkt kümmert sich Dynamics AX vollständig um das Aktualisieren von nicht mehr gültigen Datensätzen und die entscheidenden Prüfungen beim Anlegen von neuen Datensätzen.

Aber auch das Selektieren des jeweils gültigen Datensatzes für ein bestimmtes Datum wird wesentlich erleichert. Dafür stellt Dynamics AX das Keyword validTimeState zur Verfügung.

static void AX2012_ValidTimeStateUtcDateTime(Args _args)
{
    AX2012_ValidTimeStateUtcDateTime AX2012_ValidTimeStateUtcDateTime;
    utcDateTime myUtcDateTime = 1988-07-20T13:34:45;
    ;
    select validTimeState(myUtcDateTime) *
  from AX2012_ValidTimeStateUtcDateTime;

    info(strFmt("%1", AX2012_ValidTimeStateUtcDateTime.salesPrice));
}

schweda.net - Blog

AX 2012: ValidTimeState