callServerMethod

Méthodes de services Web › Méthodes diverses › callServerMethod

callServerMethod

Les paramètres suivants s’appliquent à la méthode callServerMethod :

Paramètre	Type	Description
SID	Nombre entier	Identifie la session extraite depuis la connexion.
methodName	Chaîne	Identifie le nom de la méthode à appeler.
factoryName	Chaîne	Identifie le nom de sous-objet du type d’objet contenant la méthode.
formatList	Chaîne	Identifie la liste de formats, une série de caractères décrivant les types de données destinés aux paramètres entrants. Lié à la description de Parameter() de ce tableau.
paramètres	Chaîne[]	Indique zéro, une ou plusieurs valeurs de paramètre pour la méthode.

Description

Utilisez cette méthode pour appeler une méthode côté serveur arbitraire. Ces méthodes sont définies dans le langage de script propriétaire spell.

Seules les méthodes par défaut peuvent être appelées, et l’appelant doit disposer des droits d’administrateur complets lorsqu’il se connecte.

La liste des formats est une série contenant zéro caractères et plus qui indique (dans l’ordre) les types de données des paramètres à suivre. Les codes de caractères sont les suivants :

0 S : chaîne
0 I : nombre entier (couvre les dates et la durée)
0 N : nul

Prenons l’exemple d’une méthode spell définie comme suit :

cr::DoStuff(int in_one, string in_two, string in_three);

Appelez cette méthode comme suit :

callServerMethod("DoStuff", "cr", "ISS", [3, "a string", "another one"]);

Cette méthode est destinée à l’équipe de développement CA et aux services de personnalisations uniquement ; elle est déconseillée sur la plupart des sites.

Eléments renvoyés

Chaque composant de message renvoyé est son propre élément XML. Ces éléments correspondent à toutes les représentations de chaîne de la valeur. Ils sont classés dans l’ordre de renvoi du serveur et sont au format suivant :

<ServerReturn>

<Paramx>

Cet appel ne prend pas en charge les renvois de références d’objet. Si une référence d’objet est renvoyée par la méthode spell, les données sont renvoyées sous la forme d’une chaîne OBJECT. Il ne s’agit pas d’une erreur, et tous les autres paramètres sont également renvoyés.

Elément XML	Type	Description
<ServerReturn>	N/A	Indique l’élément externe qui contient zéro, un ou plusieurs éléments <ParamX> pour les valeurs renvoyées.
<Paramx>	Chaîne	Indique zéro, une ou plusieurs valeurs renvoyées, où x est un nombre entier commençant à zéro et incrémenté à chaque élément renvoyé.

Vous pouvez valider BOPSID en utilisant check_bopsid. Cela est appelé avec callServerMethod comme suit :

Chaîne bopsid ; // est renseigné d'une manière ou d'une autre avec la valeur de BOPSID
String [] stuff  = new String [] { bopsid };

String ret = usd.callServerMethod
(sid, "check_bopsid", "api", "I", stuff);

Si la validation de BOPSID échoue, une erreur de SOAP est renvoyée. Si la validation réussit, la valeur renvoyée est une petite structure XML du formulaire suivant :

<ServerReturn>
<Param0>CONTACT_PERSID</Param0>
<Param1>SESSION_TYPE</Param1>
<Param2>SESSION_ID</Param2>
</ServerReturn>

CONTACT_PERSID: Définit l'ID persistant unique du contact validé/fiable. Il a la forme, "cnt:<uuid>".
SESSION_TYPE: Définit un ID de petit nombre entier indiquant le type de session qui générait le BOPSID. Cela n'est pas utilisé en général par des intégrateurs
SESSION_ID: Définit un ID de session facultatif. C'est l'ID de la session qui générait le BOPSID. Il peut être ou ne pas être défini. C'est utile pour préserver la session logique d'un utilisateur dans CA SDM, surtout si l'utilisateur "est transféré" de nouveau à CA SDM par un autre BOPSID.

Remarque : Si la validation de BOPSID renvoie une réussite, connectez-vous à CA SupportBridge en omettant la fenêtre de connexion, ou alors la fenêtre de connexion de CA SupportBridge sera affiché.