Propriétés relatives à la date d’effet
PeopleSoft Enterprise permet de planifier et d'assurer le suivi d'éléments planifiés à l'aide d'une propriété spécifique nommée Date d'effet (abrégée par EFFDT). De tels éléments sont soit effectifs, soit planifiés, selon que leur date soit antérieure ou ultérieure à la date actuelle de PeopleSoft.
Si les propriétés d'une interface de composant contiennent des éléments à date d'effet (c'est-à-dire un champ nommé EFFDT), l'adaptateur permet aux appelants de récupérer l'intégralité des valeurs ou uniquement les valeurs qui n'ont pas encore pris effet (et qui sont donc toujours modifiables).
Paramètre getHistoryItems
Pour les interfaces de composant avec des propriétés qui incluent une date d’entrée en vigueur, l’adaptateur fournit un paramètre supplémentaire, appelé getHistoryItems, aux opérations Get. Ce paramètre est de type booléen ; s'il est défini sur True, tous les éléments ayant une date d'effet sont renvoyés, Il s’agit de tous les éléments passés, actuels et futurs à date effective.
Si le paramètre a la getHistoryItems valeur False, seuls les éléments actuels et futurs à date effective sont retournés. Sélectionnez False si vous envisagez d'ajouter ou de modifier ces éléments (car il est impossible de modifier des éléments passés).
Il est également possible que plusieurs éléments à date d'effet possèdent la même date d'effet. Dans ce cas, une propriété supplémentaire, Séquence d'effet (EFFSEQ), doit également être fournie. Les valeurs de la propriété EFFSEQ doivent être uniques afin de différencier les éléments possédant la même date d'effet. Pour plus d'informations, consultez la documentation de PeopleSoft.
Modification des éléments passés ayant une date d'effet
L’argument correctionMode des méthodes UpdateEx et DeleteOnly contrôle si les éléments antérieurs de date effective peuvent être modifiés. S'il est défini sur True, tous les éléments peuvent être modifiés. Sinon, la modification d'un élément passé associé à une date d'effet génère une exception.
Lorsque vous appelez la méthode dépréciée Update sur une interface de composant qui contient des éléments à date d’effet, vous devez veiller à ne pas inclure de dates effectives d’une valeur antérieure à la date d’effet actuelle de PeopleSoft, sinon l’appel échoue avec une exception. Cependant, l'élément actuel ayant une date d'effet peut être inclus car il est contourné lors de la définition des propriétés. Si une séquence d'effet existe, tous les éléments actuels à date d'effet du serveur (dont les séquences d'effet correspondent) sont ignorés lors de la définition des propriétés.