callServerMethod

Web-Service-Methoden › Sonstige Methoden › callServerMethod

callServerMethod

Die folgenden Parameter gelten für die Methode „callServerMethod“:

Parameter	Typ	Beschreibung
SID	Ganzzahl	Gibt die Sitzung an, die durch die Anmeldung abgerufen wurde.
methodName	Zeichenfolge	Gibt den Namen der aufzurufenden Methode an.
factoryName	Zeichenfolge	Gibt den Factory-Namen des Objekttyps an, der die Methode enthält.
formatList	Zeichenfolge	Gibt die Formatliste an - eine Folge von Zeichen zur Beschreibung der vorgesehenen Datentypen für die eingehenden Parameter. Dies ist mit der Beschreibung von „Parameter()“ in dieser Tabelle verbunden.
parameters	Zeichenfolge[]	Gibt keinen Parameterwert oder mehrere Parameterwerte für die Methode an.

Beschreibung

Verwenden Sie diese Methode, um eine beliebige serverseitige Methode aufzurufen. Diese Methoden sind in der proprietären „Rechtschreibungs“-Skriptsprache definiert.

Es können nur „factory“-Methoden aufgerufen werden, wobei der Anrufer mit vollständigen Administratorrechten angemeldet sein muss.

Die Formatliste ist eine Serie von keinen oder mehreren Zeichen, die (in Reihenfolge) die Datentypen der nachfolgenden Parameter angeben. Die Zeichencodes lauten folgendermaßen:

0 S - Zeichenfolge
0 I - Ganzzahl (Datums- und Dauerangaben)
0 N - Null

Eine Rechtschreibmethode kann beispielsweise folgendermaßen definiert sein:

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

Rufen Sie sie folgendermaßen auf:

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

Diese Methode ist nur für CA-Entwicklung und Anpassungsdienste vorgesehen und wird für die meisten Standorte nicht empfohlen.

Rückgabe

Jede Rückgabemeldungskomponente in einem eigenen XML-Element. Alle Elemente sind Zeichenfolgedarstellungen des Werts. Die Elemente werden in der Reihenfolge der Rückgabe vom Server in folgendem Format geordnet:

<ServerReturn>

<Paramx>

Dieser Aufruf unterstützt keine Objekreferenzrückgaben. Gibt die Rechtschreibmethode einen Objektreferenz zurück, wird die Zeichenfolge "OBJECT" zurückgegeben. Dies ist kein Fehler; jegliche anderen Parameter werden ebenfalls zurückgegeben.

XML-Element	Typ	Beschreibung
<ServerReturn>	N. rel.:	Gibt das äußere Element an, das keine oder mehrere <ParamX>-Elemente für Rückgabewerte enthält.
<Paramx>	Zeichenfolge	Gibt null oder mehr für die Rückgabewerte an, wobei „x“ eine Ganzzahl ist, die bei null beginnt und für jedes zurückgegebene Element um den Wert eins zunimmt.

Sie können BOPSIDs mithilfe von "check_bopsid" validieren. Dies wird wie folgt mit "callServerMethod" aufgerufen:

String bopsid; // wird irgendwie mit dem BOPSID-Wert gefüllt
String [] stuff = neue Zeichenfolge [] { bopsid };

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

Wenn die BOPSID-Validierung fehlschlägt, wird ein SOAP-Fehler zurückgegeben. Ist die Validierung erfolgreich, wird eine kleine XML-Struktur mit folgendem Format zurückgegeben:

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

CONTACT_PERSID: Definiert die eindeutige permanente ID des validierten/vertrauenswürdigen Kontakts. Sie hat das Format "cnt:<uuid>".
SESSION_TYPE: Definiert eine kleine ganzzahlige ID, die anzeigt, welcher Sitzungstyp die BOPSID generiert hat. Diese wird von Integratoren normalerweise nicht verwendet.
SESSION_ID: Definiert eine optionale Sitzungs-ID. Dies ist die ID der Sitzung, die die BOPSID generiert hat. Sie kann gesetzt werden oder auch nicht. Dies ist nützlich, um eine logische Benutzersitzung innerhalb von CA SDM beizubehalten, und zwar insbesondere dann, wenn der Benutzer von einer anderen BOPSID an CA SDM "zurückgegeben" wird.

Hinweis: Wenn die BOPSID-Validierung einen Erfolg zurückgibt, melden Sie sich bei CA SupportBridge an, indem Sie den Anmeldebildschirm umgehen. Anderenfalls wird der Anmeldebildschirm von CA SupportBridge angezeigt.