Méthodes définies par l’utilisateur d’une 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 ont la forme suivante :

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

où :

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

• myRet est la valeur renvoyée.

  Les paramètres ne peuvent être que des paramètres d'entrée pour la méthode. Une seule valeur peut être renvoyée de la méthode comme paramètre de renvoi.

Notes

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 de composant inclut des clés, les méthodes personnalisées ne fonctionnent pas.

Limitation des interfaces de composant personnalisées

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

Solution de contournement

Créez une interface de composant sans clé et écrivez une nouvelle méthode personnalisée qui incorpore les clés dans le cadre des paramètres d'appel. Par exemple, vous pouvez utiliser la méthode personnalisée SetPassword dans l'interface de composant USER_PROFILE. USER_PROFILE inclut toutefois des clés. Vous pouvez créer une interface de composant sans clé, puis créer une méthode personnalisée dans votre nouvelle interface de composant. Cette méthode accepte deux paramètres : l'ID d'utilisateur et le mot de passe. La méthode personnalisée peut ensuite appeler USER_PROFILE avec un Get , 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 en tant que chaînes dans le code client.

Limitation des collections

Les méthodes définies par l'utilisateur ne peuvent pas renvoyer de collection, ou plus généralement, d'objet API. Vous pouvez uniquement renvoyer des types simples (par exemple, chaînes et nombres). Vous pouvez contourner cette limitation en envoyant une collection sous la forme d'une chaîne XML et en programmant le client pour analyser les chaînes et extraire les éléments au format correct. Pour consulter un exemple de ce contournement, vous pouvez examiner l'interface de composant personnalisée GET_CI_INFO.

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;  

Notes

Pour modifier plusieurs tables simultanément (à l'aide d'une commande), vous pouvez créer une autre interface de composant ou une méthode définie par l'utilisateur d'une interface de composant.

Voir aussi

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