Lire en anglais

Partager via


Méthode CreateEx

Crée un enregistrement à l'aide d'un jeu de clés uniques et des propriétés spécifiées.

Syntaxe

CreateEx  
(key1, key2, ..., keyn, interactiveMode, properties)  

Paramètres

Paramètre Description
Key in/out parameter Paramètres de clé individuelle (key1, key2, ... keyn) devant être fournis.

Ce jeu de clés ne doit pas exister dans la base de données du serveur : ils doivent donc être uniques.

Ces clés correspondent au jeu de clés CreateEx défini pour l'interface de composant spécifique.
interactiveMode Gestion des erreurs.

Lorsqu'il accède aux propriétés dans une interface de composant, l'adaptateur Microsoft BizTalk pour PeopleSoft Enterprise utilise les API fournies par PeopleSoft qui lisent et écrivent des champs individuels dans l'interface de composant. Cependant, ces modifications ne sont pas propagées au serveur PeopleSoft les unes après les autres. Au lieu de cela, psjoa.jar (avec lequel l’adaptateur BizTalk pour PeopleSoft Enterprise interagit) empaque toutes les modifications et envoie les modifications 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).

InteractiveMode offre des performances optimales et fournit des rapports d'erreurs au niveau de la mise à jour du champ. Pour utiliser correctement cette fonctionnalité, il est recommandé d'effectuer des appels normaux lorsque interactiveMode est défini sur False. Cela ne doit avoir aucun impact sur les performances. Si une erreur est renvoyée, le même appel peut faire l'objet d'une nouvelle tentative avec l'indicateur interactiveMode défini sur TRUE. Lorsque l'appel échoue, le serveur renvoie un message d'erreur plus précis.
properties Structure contenant toutes les propriétés de l'interface de composant. Lorsque la CreateEx méthode est appelée, ces propriétés sont insérées dans l’enregistrement créé avec la ou les clés spécifiées.

Remarques

Dans certaines situations, il est courant d’appeler CreateEx() sans ensemble de clés explicites, mais la CreateEx fonction retourne les clés. Ce comportement est pris en charge avec PeopleCode, qui est déclenché sur le serveur. Par exemple, pour créer un bon de commande, il est possible que le client ignore quel est le prochain numéro de bon de commande disponible. En spécifiant NEXT comme clé de numéro de bon de commande, l'appel déclenche PeopleCode, qui détermine le prochain bon de commande disponible. Ces informations doivent être renvoyées vers le client appelant, à l'aide des paramètres de clés d'entrée/sortie.

Notes

Pour que ce mécanisme fonctionne, la clé doit également être une propriété au niveau 0. Sinon, la clé d’origine est retournée.

La méthode Adaptateur BizTalk pour PeopleSoft Enterprise CreateEx() est fournie si les fonctions PeopleSoft Create et Save de l’interface du composant sont activées.

Voir aussi

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