Propiedades de fecha efectiva
PeopleSoft Enterprise permite programar y realizar un seguimiento de los elementos planificados usando una propiedad especial denominada Fecha de vigencia (abreviada como EFFDT por sus siglas en inglés). Tales elementos están en vigor o meramente planificados, en función de si su fecha es anterior o posterior a la fecha actual de PeopleSoft.
Si las propiedades de una interfaz de componente contienen tales elementos con fecha de vigencia (es decir, un campo con el nombre EFFDT), el adaptador permite que quienes realizan llamadas recuperen el conjunto de valores completo o únicamente los valores que aún no están en vigor (los que aún pueden modificarse).
Parámetro getHistoryItems
En el caso de las interfaces de componentes con propiedades que incluyen una fecha efectiva, el adaptador proporciona un parámetro adicional, denominado getHistoryItems, a las operaciones Get. Este parámetro es del tipo booleano, y, si está configurado como True, se devolverán todos los elementos con fecha de vigencia. Entre ellos se incluyen todos los elementos pasados, actuales y futuros con fecha de vigencia.
Si el getHistoryItems parámetro se establece en False, solo se devuelven los elementos actuales y futuros con fecha efectiva. Elija False si su intención es agregar o cambiar estos elementos (porque no se puedan cambiar los elementos antiguos).
También es posible tener varios elementos con fecha de vigencia que tengan la misma fecha de vigencia. En tal caso, deberá proporcionarse asimismo una propiedad adicional, Secuencia de vigencia (EFFSEQ, por sus siglas en inglés). Los valores de EFFSEQ deben ser únicos para diferenciar elementos que tengan la misma fecha de vigencia. Consulte la documentación de PeopleSoft para obtener más información.
Modificación de los elementos cuya fecha de vigencia ya haya pasado
El correctionMode argumento de los métodos UpdateEx y DeleteOnly controlan si se pueden modificar los elementos con fecha efectiva pasada. Si se establece en true, todos los elementos se pueden modificar. En caso contrario, la modificación de los elementos con fecha de vigencia que ya haya pasado genera una excepción.
Al llamar al método en desuso Update en una interfaz de componente que tiene elementos con fecha efectiva, debe tener cuidado de no incluir ninguna fecha efectiva de un valor anterior a la fecha de vigencia actual de PeopleSoft o se produce un error en la llamada con una excepción. Sin embargo, se puede incluir el elemento con fecha de vigencia actual, pues se omite al configurar las propiedades. Si existe la Secuencia de vigencia, todos los elementos con fecha de vigencia actual cuyas Secuencias de vigencia coincidan en el servidor se omitirán al configurar las propiedades.