EFFDT-Eigenschaften
PeopleSoft Enterprise bietet die Möglichkeit der zeitlichen Planung und Nachverfolgung geplanter Elemente mithilfe der Spezialeigenschaft Effective Date (Abk. EFFDT). Diese Elemente sind entweder aktiv oder lediglich geplant, was davon abhängt, ob ihr Datum vor und hinter dem aktuellen PeopleSoft-Datum liegt.
Wenn die Eigenschaften einer Komponentenschnittstelle solche Elemente mit einem Feld vom Typ EFFDT enthalten, ermöglicht der Adapter allen Aufrufern das Abrufen des vollständigen Satzes von Werten oder nur der Werte, die noch nicht wirksam sind, also noch geändert werden können.
„getHistoryItems“-Parameter
Für Komponentenschnittstellen mit Eigenschaften, die ein Gültigkeitsdatum enthalten, stellt der Adapter einen zusätzlichen Parameter namens getHistoryItemsfür die Get-Vorgänge bereit. Dieser Parameter ist boolesche. Bei Festlegung auf True werden alle Elemente mit EFFDT-Feld zurückgegeben. Dazu zählen alle bisherigen, aktuellen und künftigen Elemente mit EFFDT-Feld.
Wenn der getHistoryItems Parameter auf False festgelegt ist, werden nur die aktuellen und zukünftigen elemente mit effektiver Datumsangaben zurückgegeben. Wählen Sie False, wenn Sie diese Elemente ergänzen oder ändern möchten (da frühere Elemente nicht geändert werden können).
Es ist auch möglich, dass mehrere Elemente mit EFFDT-Feld denselben Datumswert aufweisen. In diesem Fall muss die zusätzliche Eigenschaft Effective Sequence (EFFSEQ) angegeben werden. Der Wert von EFFSEQ muss eindeutig sein, damit Elemente mit demselben EFFDT-Wert unterschieden werden können. Weitere Informationen finden Sie in der PeopleSoft-Dokumentation.
Ändern früherer Elemente mit EFFDT-Wert
Das correctionMode Argument in der UpdateEx - und deleteOnly-Methode steuert, ob vergangene effektive elemente geändert werden können. Falls auf True festgelegt, können alle Elemente bearbeitet werden. Andernfalls wird bei einer Änderung früherer Elemente mit einem EFFDT-Wert eine Ausnahme ausgelöst.
Wenn Sie die veraltete Update Methode für eine Komponentenschnittstelle aufrufen, die elemente mit gültiger Datumsangabe enthält, müssen Sie darauf achten, keine effektiven Datumsangaben eines Werts vor dem aktuellen Datum von PeopleSoft einzuschließen, andernfalls schlägt der Aufruf mit einer Ausnahme fehl. Das aktuelle Element mit EFFDT-Wert kann jedoch eingeschlossen werden, da es beim Festlegen von Eigenschaften umgangen wird. Wenn Elemente mit EFFSEQ-Wert vorliegen, werden alle aktuellen Elemente mit EFFDT-Wert mit entsprechendem EFFSEQ-Wert im Server beim Festlegen von Eigenschaften übersprungen.