callServerMethod

Metodi dei servizi Web › Metodi vari › callServerMethod

callServerMethod

I parametri seguenti sono validi per il metodo callServerMethod:

Parametro	Tipo	Descrizione
SID	Numero intero	Identifica la sessione recuperata dall'accesso.
methodName	Stringa	Identifica il nome del metodo da richiamare.
factoryName	Stringa	Identifica il nome factory del tipo di oggetto che contiene il metodo.
formatList	Stringa	Identifica l'elenco dei formati, una serie di caratteri che descrive i tipi di dati previsti per i parametri in arrivo. Fa riferimento alla descrizione del metodo Parameter() in questa tabella.
parameters	String[]	Indica zero o più valori di parametro per il metodo.

Descrizione

Utilizzare questo metodo per richiamare un metodo arbitrario del server. Questi sono metodi definiti nel linguaggio proprietario di scripting "ortografia".

È possibile richiamare solo i metodi factory e il chiamante deve disporre di tutte le autorizzazioni di amministratore.

L'elenco dei formati è una serie di caratteri che indica (in ordine) i tipi di dati dei parametri a cui attenersi. I codici di carattere sono i seguenti:

0 S - stringa
0 I - intero (per data e durata)
0 N - Null

Ad esempio, si supponga che un metodo di ortografia sia definito nel modo seguente:

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

Richiamare il metodo nel modo seguente:

callServerMethod("DoStuff", "cr", "ISS", [3, "una stringa, "un'altra"]);

Questo metodo è destinato solo ai settori di sviluppo CA e ai servizi che si occupano della personalizzazione e non è consigliato per la maggior parte dei siti.

Valore restituito

Ognuno di essi restituisce il componente del messaggio nel proprio elemento XML. Gli elementi sono tutte rappresentazioni delle stringhe del valore. Gli elementi sono disposti nell'ordine di restituzione dal server utilizzando il formato seguente:

<ServerReturn>

<Paramx>

Questa chiamata non supporta le restituzioni del riferimento all'oggetto. Se il metodo di ortografia restituisce un riferimento all'oggetto, i dati restituiti sono rappresentati dalla stringa "OBJECT". In questo caso non si tratta di un errore e vengono restituiti anche gli altri parametri.

Elemento XML	Tipo	Descrizione
<ServerReturn>	N/D	Indica l'elemento esterno che contiene zero o più elementi <ParamX> per i valori di restituzione.
<Paramx>	Stringa	Indica zero o più per i valori di restituzione, dove x è un valore intero che parte da zero e aumenta a ogni elemento restituito.

È possibile convalidare i BOPSID mediante check_bopsid. Il richiamo avviene tramite callServerMethod nel modo seguente:

Stringa bopsid; // il valore BOPSID viene inserito in una determinata modalità
String [] stuff  = new String [] { bopsid };

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

Se la validazione BOPSID non riesce, viene restituito un errore SOAP. Se la validazione riesce, il valore restituito è una struttura XML di piccole dimensioni del modulo seguente:

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

CONTACT_PERSID: Definisce l'id persistente univoco del contatto convalidato/attendibile. Presenta il formato "cnt:<uuid>".
SESSION_TYPE: Definisce un piccolo id intero indicante il tipo di sessione che ha generato il BOPSID. In genere non viene utilizzato dagli integratori
SESSION_ID: Definisce un ID sessione facoltativo. Id della sessione che ha generato il BOPSID. È possibile scegliere se impostarlo o meno. Questa possibilità risulta utile per gestire una sessione logica dell'utente all'interno di CA SDM, soprattutto se l'utente viene restituito a CA SDM da un altro BOPSID.

Nota: se la validazione BOPSID restituisce un'operazione positiva, accedere a CA SupportBridge saltando la schermata di accesso. In caso contrario, verrà visualizzata la schermata di CA SupportBridge Login.

Contatta CA Technologies