callServerMethod

Métodos de servicios Web › Métodos variados › callServerMethod

callServerMethod

Los siguientes parámetros se aplican al método callServerMethod (métodoLlamarServidor):

Parámetro	Tipo	Descripción
SID	Entero	Identifica la sesión recuperada del inicio de sesión.
methodName	Cadena	Identifica el nombre del método que desea llamar.
factoryName	Cadena	Identifica el nombre de tabla del tipo de objeto que contiene el método.
formatList	Cadena	Identifica la lista de formatos, una serie de caracteres que describen los tipos de datos deseados para los parámetros entrantes. Está relacionado con la descripción de Parameter() en esta tabla.
parámetros	Cadena[]	Indica cero o más valores de parámetro para el método.

Descripción

Utilice este método para invocar un método de servidor arbitrario. Estos métodos están definidos en el lenguaje de comandos “de ejecución” del propietario.

Sólo se puede llamar a los métodos de tabla y el autor de la llamada debe iniciar sesión con todos los derechos administrativos.

La lista de formatos es una serie de cero o más caracteres que indican (en orden) los tipos de datos de los parámetros que se deben seguir. Los códigos de los caracteres son los siguientes:

0 S: cadena
0 I: entero (cubre fechas y duración)
0 N: nulo

Por ejemplo, si un método de ejecución se define de la siguiente forma:

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

deberá invocarlo como se muestra a continuación:

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

Este método está únicamente destinado al Desarrollo de CA y a los servicios para personalizaciones. No se recomienda para la mayoría de sitios.

Resultado

Cada componente del mensaje en su propio elemento XML. Los elementos son todas las representaciones de cadenas del valor. Los elementos se ordenan por orden de devolución del servidor con el siguiente formato:

<ServerReturn>

<Paramx>

Esta llamada no admite devoluciones de referencias de objetos. Si el método de ejecución devuelve una referencia de objeto, la devolución de datos es la cadena “OBJECT”. Esto no es un error y se devuelve también cualquier otro parámetro.

Elemento XML	Tipo	Descripción
<ServerReturn>	N/D	Indica el elemento externo que contiene cero o más elementos <ParamX> para valores devueltos.
<Paramx>	Cadena	Indica cero o más para los valores devueltos, donde x es un número entero que empieza en cero y aumenta por cada elemento devuelto.

Puede validar BOPSIDs mediante check_bopsid. Esto se invoca con callServerMethod de la siguiente forma:

String bopsid; // de algún modo se rellena con el valor de BOPSID
String [] stuff  = new String [] { bopsid };

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

Si se produce un error en la validación de BOPSID, se devuelve un error de SOAP. Si la validación es correcta, el valor devuelto es una pequeña estructura XML con el formato siguiente:

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

CONTACT_PERSID: Define el ID persistente exclusivo del contacto validado/de confianza. Tiene la forma "cnt:<uuid>".
SESSION_TYPE: Define un ID de entero pequeño que indica el tipo de sesión que generó el BOPSID. Por lo general, no lo usan los integradores.
SESSION_ID: Define un ID de sesión opcional. Éste es el ID de la sesión que generó el BOPSID. Puede o no estar definido. Esto es útil para mantener una sesión lógica de usuario dentro de CA SDM, especialmente si otro BOPSID "devuelve" al usuario a CA SDM.

Nota: Si la validación de BOPSID es correcta, inicie sesión en CA SupportBridge omitiendo la pantalla de inicio de sesión, de lo contrario se mostrará la pantalla de Inicio de Sesión de CA SupportBridge.