Lire en anglais

Partager via


Méthode UpdateEx

Cette méthode permet de mettre à jour les propriétés en fonction des paramètres de clé d'entrée (key1, key2, … keyn). Lorsque vous utilisez UpdateEx, vous ne pouvez pas supprimer des éléments dans une collection. Une méthode distincte facilite la suppression. Pour plus d’informations, consultez DeleteOnly, méthode.

Syntaxe

UpdateEx (key1, key2, ... keyn, correctionMode, interactiveMode,  
    properties)  

Paramètres

Paramètre Description
key Un ensemble de paramètres qui doit exister dans la base de données du serveur, ou une erreur se produit. Ces clés correspondent au jeu de clés Get défini pour l'interface de composant spécifique.
correctionMode Indicateur booléen. Lorsqu'il est défini sur true, il permet d'apporter des modifications aux interfaces de composant avec des éléments ayant une date d'effet, soit en mettant à jour les valeurs de champ soit en insérant de nouveaux éléments dans une collection. Plus précisément, il permet de modifier les éléments dont l'EFFDT est antérieure à la date d'effet actuelle. Sans cet indicateur défini sur TRUE, toute modification apportée à ces éléments génère une erreur renvoyée par le serveur PeopleSoft.

L’argument correctionMode est exposé uniquement pour les interfaces de composant qui contiennent des éléments datés de l’effet. Dans le cas contraire, il n'apparaît pas dans le cadre de l'argument.

Vous devez éviter de définir correctionMode sur TRUE dans un environnement de production. (Il s’agit également de la recommandation de PeopleSoft.) Les événements qui se sont déjà produits comme déterminé par la clé EFFDT passée ne doivent pas être modifiés. Cela permet la création d'une piste d'audit. L’indicateur correctionMode dans UpdateEx permet de contourner ce mécanisme de sécurité. Pour les événements passés, la pratique recommandée consiste à les désactiver en définissant un champ dans l'élément et en ajoutant l'élément mis à jour (au lieu de le supprimer).
interactiveMode Indicateur utilisé pour la gestion des erreurs.

Lors de l’accès aux propriétés dans une interface de composant, l’adaptateur BizTalk pour PeopleSoft Enterprise utilise des API fournies par PeopleSoft qui lisent et écrivent des champs individuels dans l’interface du composant ; toutefois, ces modifications ne sont pas propagées au serveur PeopleSoft une par une. Au contraire, psjoa.jar (avec lequel l'adaptateur BizTalk pour PeopleSoft Enterprise interagit) regroupe toutes les modifications et les envoie au serveur dans un seul package. En cas d'échec d'une des mises à jour individuelles, une erreur générique est renvoyée, sans identifier l'erreur réelle. Si le mode interactif est défini sur TRUE, chaque mise à jour de champ est envoyée au serveur individuellement. Cela a un impact considérable sur les performances mais des informations spécifiques sur l'erreur sont fournies en cas d'échec de la mise à jour (par exemple, si une valeur non valide est utilisée pour la définition d'un champ).

fournit interactiveMode des performances maximales et fournit des rapports d’erreurs au niveau de la mise à jour du champ. Pour utiliser cette fonctionnalité correctement, il est recommandé d’effectuer des appels normaux avec interactiveMode la valeur FALSE. Cela ne doit avoir aucun impact sur les performances. Si une erreur est retournée, le même appel peut être retenté avec l’indicateur interactiveMode défini sur TRUE. Lorsque l'appel échoue, le serveur renvoie un message d'erreur plus précis.

Remarques

Lorsque vous appelez cette fonction, les propriétés de l'enregistrement correspondant aux clés sont remplacées par les propriétés du paramètre d'entrée. Toutes les collections comprenant les enregistrements originaux sont supprimées et remplacées par celles du paramètre d'entrée. Les tailles de ces collections n’ont pas besoin d’être identiques. La procédure à l’intérieur UpdateEx consiste à supprimer tous les éléments de collection existants, puis à insérer les éléments donnés.

Si les propriétés de l'interface de composant contiennent des éléments ayant une date d'effet, le paramètre des propriétés doit contenir tous les éléments ayant une date d'effet future car la liste d'origine est remplacée. Cela fournit le mécanisme d'ajout et de suppression des éléments ayant une date d'effet future. Cependant, si les propriétés contiennent aussi des éléments ayant une date d'effet passée, une erreur est renvoyée car de tels éléments ne peuvent pas être modifiés. Si l'élément ayant une date d'effet actuelle est également inclus, il est ignoré. Cela permet au client d’appeler Get() avec le getHistoryItems paramètre défini sur False et de modifier tous les éléments à date d’effet futurs ou d’ajouter de nouveaux éléments à date d’effet futurs, et de passer la structure en tant que paramètre pour la UpdateEx() fonction.

Si l’interface de composant n’a pas de clé, comme dans le cas où une seule instance peut exister, la UpdateEx() méthode a la forme :

UpdateEx(correctionMode, interactiveMode, properties)  

Notes

La méthode De l’adaptateur BizTalk pour PeopleSoft Enterprise UpdateEx() est fournie si les fonctions PeopleSoft Get et Save de l’interface du composant sont activées.

Voir aussi

Appendix A: méthodes relatives à l'interface de composant