UpdateEx, méthode

Utilisé pour 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 d’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 doivent exister dans la base de données du serveur ou une erreur se produit. Ces clés correspondent à l’ensemble de clés Get tel que défini pour l’interface de composant spécifique.
correctionMode	Indicateur booléen. Lorsque la valeur est true, autorise les modifications apportées aux interfaces de composant avec des éléments obsolètes effectifs en mettant à jour les valeurs de champ ou en insérant de nouveaux éléments dans une collection. Plus précisément, il permet de modifier les éléments qui ont EFFDT avant la date d’effet actuelle. Sans cet indicateur défini sur TRUE, toute modification apportée à ces éléments entraîne une erreur retournée par le serveur PeopleSoft. L’argument correctionMode n’est exposé que pour ces interfaces de composant qui contiennent des éléments obsolètes effectifs. Sinon, elle n’est pas affichée dans le cadre de l’argument. Vous devez éviter la valeur correctionMode 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. Le correctionMode drapeau dans UpdateEx permet à ce mécanisme de sécurité d’être contourné. La pratique recommandée consiste à désactiver les événements passés en définissant un champ dans l’élément et en ajoutant (au lieu de supprimer) l’élément mis à jour.
interactiveMode	Indicateur utilisé pour la gestion des erreurs. Lors de l’accès aux propriétés d’une interface de composant, BizTalk Adapter for 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 un par un. Au lieu de cela, le psjoa.jar (avec lequel BizTalk Adapter for PeopleSoft Enterprise interagit) empaquete toutes les modifications et envoie les modifications au serveur dans un package. Si l’une des mises à jour individuelles échoue, une erreur générique est retournée, ce qui n’identifie pas l’erreur réelle. Avec le mode interactif défini sur TRUE, chaque mise à jour de champ est envoyée individuellement au serveur. Cela a un impact considérable sur les performances, mais il fournit des informations d’erreur spécifiques si la mise à jour échoue (par exemple, si une valeur non valide est utilisée pour définir un champ). Offre 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. Il ne doit pas y avoir d’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 retourne 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 avec les enregistrements d’origine sont supprimées et remplacées par celles du paramètre d’entrée. Les tailles de ces collections n’ont pas besoin de correspondre à la procédure dans UpdateEx laquelle il faut 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 obsolètes effectifs, le paramètre de propriétés doit contenir tous les éléments obsolètes effectifs futurs, car la liste d’origine est remplacée. Cela permet d’ajouter et de supprimer des éléments obsolètes futurs ; Toutefois, si les propriétés contiennent également des éléments obsolètes, une erreur est retournée car les éléments obsolètes ne peuvent pas être modifiés. Si l’élément en vigueur 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 les éléments obsolètes effectifs futurs ou d’ajouter de nouveaux éléments obsolètes effectifs 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 suivante :

UpdateEx(correctionMode, interactiveMode, properties)  

Note

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

Voir aussi

Annexe A : Méthodes d’interface de composant