Méthodes User-Defined de l’interface de composant

L’adaptateur Microsoft BizTalk pour PeopleSoft Enterprise prend en charge les méthodes définies par l’utilisateur dans les interfaces de composant. Les signatures sont de la forme suivante :

myRet=myCI.myMethod(parameter1, parameter2, ...)  

où :

• parameter1, parameter2 sont des paramètres d’entrée.

• myRet est la valeur de retour.

  Les paramètres peuvent uniquement être des paramètres d’entrée dans la méthode. Une seule valeur peut être retournée à partir de la méthode en tant que paramètre de retour.

Note

L’interface de composant qui contient des méthodes définies par l’utilisateur doit uniquement avoir la fonction PeopleSoft Get activée. Si l’interface du composant possède des clés, les méthodes personnalisées ne fonctionnent pas.

Limitation de l’intégration continue personnalisée

L’adaptateur BizTalk pour PeopleSoft Enterprise peut gérer des méthodes PeopleSoft personnalisées, à condition que l’interface de composant n’ait pas de clés. Si l’interface du composant possède des clés, les méthodes personnalisées ne fonctionnent pas.

Solution de contournement

Créez une interface de composant qui n’a pas de clés et écrivez une nouvelle méthode personnalisée qui incorpore les clés dans le cadre des paramètres appelants. Par exemple, vous pouvez utiliser la méthode personnalisée SetPassword dans l’interface du composant USER_PROFILE ; toutefois, USER_PROFILE a des clés. Vous pouvez créer une interface de composant qui n’a aucune clé, puis créer une méthode personnalisée dans votre nouvelle interface de composant. Cette méthode accepterait deux paramètres, l’ID utilisateur et le mot de passe. La méthode personnalisée peut ensuite appeler USER_PROFILE avec un Get appel, puis appeler SetPassword. Pour plus d’informations, consultez la documentation PeopleSoft.

En raison d’une limitation dans PeopleSoft, Date, DateTimeet Time les types apparaissant dans les méthodes définies par l’utilisateur sont mappés sous forme de chaînes dans le code client.

Collection Limitation

Les méthodes définies par l’utilisateur ne peuvent pas retourner une collection, ou plus généralement, tout objet API. Cela signifie que vous ne pouvez retourner que des types simples, par exemple des chaînes et des nombres. Vous pouvez contourner cette limitation en envoyant une collection en tant que chaîne XML et en programmation du client pour analyser les chaînes afin d’extraire les éléments dans le format correct. Vous pouvez examiner l’interface de composant personnalisé GET_CI_INFO pour voir un exemple de cette solution de contournement.

Exemple de méthode personnalisée

Vous pouvez utiliser la méthode personnalisée de base suivante, SayHello, pour tester les fonctionnalités de votre interface de composant à l’aide de méthodes personnalisées.

La fonction PeopleCode suivante est une méthode définie par l’utilisateur d’une interface de composant PeopleSoft nommée ACB_EMPLOYEE. L’exemple retourne une chaîne où la valeur de retour est Hello suivie de la valeur du paramètre d’entrée.

Function SayHello(&sName As string) Returns string  
      &EOL = Char(10);  
      &sResult = "Hello " | &sName | &EOL;  
      Return &sResult;  
End-Function;  

Note

Pour modifier plusieurs tables en même temps (à l’aide d’une commande), vous pouvez créer une autre interface de composant ou créer une méthode définie par l’utilisateur de l’interface de composant.

Voir aussi

Annexe A : Méthodes d’interface de composant