RESTMessageV2 – Bereichsbezogen, Global

Die RESTMessageV2 Die API stellt Methoden bereit, mit denen Sie ausgehende REST-Nachrichten mit JavaScript senden können.

Verwenden Sie diese API, um die vom REST-Provider zurückgegebene Antwort zu verwalten.

Der Wert „Anwender-Agent“ ist „ServiceNow/1,0“. Um dies zu ändern, fügen Sie die Systemeigenschaft glide.http.user.agent in der Tabelle „Systemeigenschaften“ [sys_properties] hinzu.

Diese API wird in ausgeführt sn_WS Namespace.

RESTMessageV2 – RESTMessageV2()

Instantiiert ein leeres RESTMessageV2-Objekt.

Wenn Sie ein Objekt verwenden, das auf diese Weise instantiiert wurde, müssen Sie manuell eine HTTP-Methode und einen Endpunkt angeben.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Keine

var sm = new sn_ws.RESTMessageV2();

RESTMessageV2 – RESTMessageV2(String name, String methodName)

Instantiiert ein RESTMessageV2-Objekt unter Verwendung von Informationen aus einem REST-Nachrichtendatensatz.

Sie müssen einen REST-Nachrichtendatensatz definieren, bevor Sie diesen Konstruktor verwenden können. Anweisungen dazu finden Sie unter REST-Nachrichten erstellen.

Tabelle : 2. Parameter

Name	Typ	Beschreibung
Name	Zeichenfolge	Der Name des REST-Nachrichtendatensatzes in der Tabelle „REST-Nachricht“ [sys_Rest_message].
methodName	Zeichenfolge	Der Name der zu verwendenden HTTP-Methode, z. B. GET/GET oder PUT/PUT – Groß-/Kleinschreibung wird nicht beachtet.

Ersetzen Sie im folgenden Beispiel REST_message_record durch den Namen des REST-Nachrichtendatensatzes Ihrer Instanz.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get");
// Might throw exception if message doesn't exist or not visible due to scope.

RESTMessageV2 – disableForcedVariableSubstitution()

Deaktiviert erzwungene Variablensubstitution bei ausgehenden REST-Nachrichten.

Hinweis:

Die Verwendung geschweifter Klammern oder Dollarzeichen in Ihrer Anforderung kann versehentlich eine gekürzte Ausgabe zurückgeben. Wenn Ihre Anforderung die Antwort irrtümlich kürzt oder in neue Zeilen aufteilt, lesen Sie unter Dieser Community-artikel Für eine potenzielle Lösung.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 4. Ergebnisse

Typ	Beschreibung
void

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get");
sm.disableForcedVariableSubstitution();
var response = sm.execute();

RESTMessageV2 – execute()

Sendet die REST-Nachricht an den Endpunkt.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 6. Ergebnisse

Typ	Beschreibung
RESTResponse	Die vom REST-Provider zurückgegebene Antwort.

Ersetzen Sie im folgenden Beispiel REST_message_record durch den Namen des REST-Nachrichtendatensatzes Ihrer Instanz.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
var response = sm.execute(); //Might throw exception if http connection timed out or some issue with sending request itself because of encryption/decryption of password.

RESTMessageV2: executeAsync()

Sendet die REST-Nachricht asynchron an den Endpunkt. Die Instanz wartet nicht auf eine Antwort des Webservice-Providers, wenn asynchrone Aufrufe ausgeführt werden.

Tabelle : 7. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 8. Ergebnisse

Typ	Beschreibung
RESTResponse	Die vom REST-Provider zurückgegebene Antwort.

Ersetzen Sie im folgenden Beispiel REST_message_record durch den Namen des REST-Nachrichtendatensatzes Ihrer Instanz. Erwägen Sie bei der Verwendung von executeAsync die Verarbeitung des Antworttexts in einer separaten Business Rule, um den asynchronen Aufruf zu nutzen.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
var response = sm.executeAsync(); //Might throw exception if http connection timed out or some issue with sending request itself because of encryption/decryption of password.

RESTMessageV2 – getEndpoint()

Ruft die URL des Endpunkts für die REST-Nachricht ab.

Tabelle : 9. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 10. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Die URL des REST-Webservice-Providers.

Ersetzen Sie im folgenden Beispiel REST_message_record durch den Namen des REST-Nachrichtendatensatzes Ihrer Instanz.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
var endpoint = sm.getEndpoint();

RESTMessageV2 – getRequestBody()

Ruft den Inhalt des REST-Nachrichtentexts ab.

Tabelle : 11. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 12. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Der REST-Nachrichtentext.

Ersetzen Sie im folgenden Beispiel REST_message_record durch den Namen des REST-Nachrichtendatensatzes Ihrer Instanz.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
var body = sm.getRequestBody();

RESTMessageV2 – getRequestHeader(String headerName)

Ruft den Wert für einen HTTP-Header ab, der in der REST-Nachricht angegeben ist.

Standardmäßig kann diese Methode den Wert für eine vom System automatisch festgelegte Kopfzeile nicht zurückgeben. Um dieser Methode Zugriff auf alle Kopfzeilen zu gewähren, setzen Sie die Eigenschaft „glide.http.log_debug“ auf „true“.

Tabelle : 13. Parameter

Name	Typ	Beschreibung
headerName	Zeichenfolge	Anforderungsheader, für den Sie den Wert abrufen möchten.

Tabelle : 14. Rückgaben

Typ	Beschreibung
Zeichenfolge	Der Wert der angegebenen Kopfzeile.

Ersetzen Sie im folgenden Beispiel REST_message_record durch den Namen des REST-Nachrichtendatensatzes Ihrer Instanz.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
var header = sm.getRequestHeader("Accept");

RESTMessageV2 – getRequestHeaders()

Ruft HTTP-Header ab, die vom REST-Client und den zugehörigen Werten festgelegt wurden.

Diese Methode gibt keine vom System automatisch festgelegten Kopfzeilen zurück. Um diese Methode so zu konfigurieren, dass alle Kopfzeilen zurückgegeben werden, setzen Sie die Eigenschaft „glide.http.log_debug“ auf „true“.

Tabelle : 15. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 16. Ergebnisse

Typ	Beschreibung
Objekt	Ein Objekt, das den Namen jeder Kopfzeile dem zugehörigen Wert zuordnet.

Ersetzen Sie im folgenden Beispiel REST_message_record durch den Namen des REST-Nachrichtendatensatzes Ihrer Instanz.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
var headers = sm.getRequestHeaders();

RESTMessageV2 – saveResponseBodyAsAttachment(String tableName, String recordSysId, String fileName)

Konfiguriert die REST-Nachricht, um den zurückgegebenen Antwort-Haupttext als Anhangsdatensatz zu speichern.

Wenn Sie diese Funktion mit einer REST-Nachricht verwenden, die über einen MID-Server gesendet wird, muss der MID-Server über alle Rollen verfügen, die zum Lesen und Schreiben von Anhangdatensätzen erforderlich sind, sowie über alle Rollen, die zum Lesen und Schreiben von Datensätzen in der in angegebenen Tabelle erforderlich sind tableNameParameter.

Der Antwort-Haupttext muss keine binäre Datei sein, um als Anhang gespeichert zu werden. Antwort-Haupttextkörper, die Textformate wie JSON oder XML verwenden, können ebenfalls gespeichert werden. Wenn die Instanz den Anhang nicht speichern kann, rufen Sie getErrorMessage() für das zugehörige RESTResponseV2-Objekt auf, um Fehlerdetails zu erhalten.

Tabelle : 17. Parameter

Name	Typ	Beschreibung
tableName	Zeichenfolge	Geben Sie die Tabelle an, die den Datensatz enthält, an den Sie die gespeicherte Datei anhängen möchten.
recordSysId	Zeichenfolge	Geben Sie die sys_id des Datensatzes an, an den Sie die gespeicherte Datei anhängen möchten.
fileName	Zeichenfolge	Geben Sie den Dateinamen für die gespeicherte Datei an.

Tabelle : 18. Ergebnisse

Typ	Beschreibung
void

(function sampleRESTMessageV2() {
  try{
    var request  = new sn_ws.RESTMessageV2();        
    request.setHttpMethod('get');

    var attachment_sys_id  = '<attachment_record_sys_id>', 
      tablename = 'incident',
      recordSysId = '<incident_sys_id>',            
      response,            
      httpResponseStatus,             
      filename ='<filename>';

    //endpoint - ServiceNow REST Attachment API        
    request.setEndpoint('https://<instance_name>.service-now.com/api/now/attachment/' + attachment_sys_id  +'/file');        
    request.setBasicAuth('<username>', '<password>');

    //RESTMessageV2 - saveResponseBodyAsAttachment(String tableName, String recordSysId, String fileName)        
    request.saveResponseBodyAsAttachment(tablename, recordSysId, filename);        

    response = request.execute();        
    httpResponseStatus = response.getStatusCode();  
      
    gs.info(" http response status_code:  " + httpResponseStatus);    
  }
  catch(ex){
    var message  = ex.getMessage();        
    gs.info(message);    
  }
})();

RESTMessageV2 – saveResponseBodyAsAttachment(String tableName, String recordSysId, String fileName, String encryptContext)

Konfiguriert die REST-Nachricht, um den zurückgegebenen Antworttext als verschlüsselten Anhangsdatensatz zu speichern.

Wenn Sie diese Funktion mit einer REST-Nachricht verwenden, die über einen MID-Server gesendet wird, muss der MID-Server über alle Rollen verfügen, die zum Lesen und Schreiben von Anhangdatensätzen erforderlich sind, sowie über alle Rollen, die zum Lesen und Schreiben von Datensätzen in der in angegebenen Tabelle erforderlich sind tableNameParameter.

Der Antwort-Haupttext muss keine binäre Datei sein, um als Anhang gespeichert zu werden. Antwort-Haupttextkörper, die Textformate wie JSON oder XML verwenden, können ebenfalls gespeichert werden. Wenn die Instanz den Anhang nicht speichern kann, rufen Sie getErrorMessage() für das zugehörige RESTResponseV2-Objekt auf, um Fehlerdetails zu erhalten.

Tabelle : 19. Parameter

Name	Typ	Beschreibung
tableName	Zeichenfolge	Geben Sie die Tabelle an, die den Datensatz enthält, an den Sie die gespeicherte Datei anhängen möchten.
recordSysId	Zeichenfolge	Geben Sie die sys_id des Datensatzes an, an den Sie die gespeicherte Datei anhängen möchten.
fileName	Zeichenfolge	Geben Sie den Dateinamen für die gespeicherte Datei an.
encryptContext	Zeichenfolge	Geben Sie die sys_id eines Verschlüsselungskontextes an. Die gespeicherte Datei wird mit diesem Kontext verschlüsselt.

Tabelle : 20. Ergebnisse

Typ	Beschreibung
void

RESTMessageV2 – setAllowedRedirectURIs (Array-URIs)

Legt mindestens einen URIs fest, zu dem umgeleitet werden darf. Die Steuerung der zulässigen ausgehenden URIs reduziert Sicherheitsbedenken und hilft, URL-Umleitungsangriffe zu verhindern, die Anwender auf schädliche Websites senden.

Eine umfassendere Methode zur Umleitung von URIs finden Sie unter UriMatcher – Umfang.

Tabelle : 21. Parameter

Name	Typ	Beschreibung
Uris	Array	Mindestens ein URIs für die Umleitung zulässig. Jeder URI muss im Format „Zeichenfolge“ aufgeführt werden.

Tabelle : 22. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie eine oder mehrere URLs hinzugefügt werden, die für die Weiterleitung für eine REST-Nachrichtenmethode zulässig sind.

// Redirection URI Allow list
try{
	var rm = new sn_ws.RESTMessageV2('<REST_message_record>', '<REST_Msg_method_name>');
	rm.setAllowedRedirectURIs(['https://www.google.com']);

	var response = rm.execute();
	var responseBody = response.getBody();
	var httpStatus = response.getStatusCode();
	gs.info(responseBody);
	gs.info(httpStatus);
} catch(ex) {
	var message = ex.getMessage();
}

RESTMessageV2 – setAuthenticationProfile(String type, String profileId)

Legt die Anmeldeinformationen für die REST-Nachricht mithilfe einer vorhandenen Standardauthentifizierung oder eines OAuth 2,0-Profils fest.

Tabelle : 23. Parameter

Name	Typ	Beschreibung
Typ	Zeichenfolge	Der Typ des zu verwendenden Authentifizierungsprofils. Gültige Werte sind „basic“ zur Verwendung der Basic Authentication oder „oauth2“ zur Verwendung von OAuth 2.0.
profileId	Zeichenfolge	Die sys_id eines Authentifizierungsprofileintrags. Geben Sie bei Verwendung der Basic Authentication die sys_id eines Datensatzes der Konfiguration für Basic Authentication [sys_auth_profile_basic] an. Geben Sie bei Verwendung von OAuth 2.0 die sys_id eines Datensatzes des OAuth-Einheitenprofils [oauth_entity_profile] an.

Tabelle : 24. Ergebnisse

Typ	Beschreibung
void

Ersetzen Sie im folgenden Beispiel REST_message_record durch den Namen des REST-Nachrichtendatensatzes Ihrer Instanz.

var requestBody;
var responseBody;
var status;
var sm;
try{
       // Might throw exception if message doesn't exist or not visible due to scope.
	sm = new sn_ws.RESTMessageV2("<REST_message_record>", "get");  

       //set auth profile to an OAuth 2.0 profile record.
	sm.setAuthenticationProfile('oauth2', '1234adsf123212131123qasdsf'); 

	sm.setStringParameter("symbol", "NOW");
	sm.setStringParameterNoEscape("xml_data","<data>test</data>");

       //In milliseconds. Wait at most 10 seconds for response from http request.
	sm.setHttpTimeout(10000); 
       //Might throw exception if http connection timed out or some issue 
       //with sending request itself because of encryption/decryption of password.
	response = sm.execute();	
       responseBody = response.haveError() ? response.getErrorMessage() : response.getBody();
	status = response.getStatusCode();
} catch(ex) {
	responseBody = ex.getMessage();
	status = '500';
} finally {
	requestBody = sm ? sm.getRequestBody():null;
}

RESTMessageV2 – setBasicAuth(String userName, String userPass)

Legt die Basic Authentication-Kopfzeilen für die REST-Nachricht fest.

Das Festlegen von Sicherheitswerten mit dieser Methode überschreibt die Basic Authenticationwerte, die für den REST-Nachrichtendatensatz definiert sind.

Tabelle : 25. Parameter

Name	Typ	Beschreibung
userName	Zeichenfolge	Anwendername, den Sie zur Authentifizierung der REST-Nachricht verwenden möchten.
userPass	Zeichenfolge	Passwort für den angegebenen Anwender.

Tabelle : 26. Rückgaben

Typ	Beschreibung
void

Ersetzen Sie im folgenden Beispiel REST_message_record durch den Namen des REST-Nachrichtendatensatzes Ihrer Instanz.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setBasicAuth("username","password");

RESTMessageV2 – setEccCorrelator(String correlator)

Ordnet ausgehende Anforderungen und den resultierenden Antwortdatensatz in der ECC-Warteschlange zu. Diese Methode gilt nur für REST-Nachrichten, die über einen gesendet werden MID-Server.

Der bereitgestellte Korrelator füllt das Feld Agenten-Korrelator im ECC-Warteschlangendatensatz für die Antwort aus. Stellen Sie für jede ausgehende Anforderung einen eindeutigen Korrelator bereit, um die richtigen Ergebnisse in der ECC-Warteschlange mit der Anforderung zu verknüpfen, wenn Sie asynchrone Automatisierung über einen MID-Server entwerfen.

Tabelle : 27. Parameter

Name	Typ	Beschreibung
Korrelator	Zeichenfolge	Eindeutiger Bezeichner

Tabelle : 28. Rückgaben

Typ	Beschreibung
void

Ersetzen Sie im folgenden Beispiel REST_message_record durch den Namen des REST-Nachrichtendatensatzes Ihrer Instanz.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setEccCorrelator("unique_identifier");

RESTMessageV2 – setEccParameter(String name, String value)

Überschreibt einen Wert aus der Datenbank, indem in die REST-Nachrichtennutzlast geschrieben wird. Diese Methode gilt nur für REST-Nachrichten, die über einen MID-Server gesendet werden.

Verwenden Sie diese Methode, wenn ein Wert aus der REST-Nachricht in der Datenbank ungültig ist, z. B. wenn die Endpunkt-URL länger als die maximale REST-Endpunktfeldlänge ist. Sie können nur die Endpunkt-URL mit dieser Methode festlegen, indem Sie „source“ als Namensparameter übergeben.

Tabelle : 29. Parameter

Name	Typ	Beschreibung
Name	Zeichenfolge	Der Name des Parameters, z. B. „source“.
Wert	Zeichenfolge	Der Wert, der dem angegebenen Parameter zugewiesen werden soll.

Tabelle : 30. Ergebnisse

Typ	Beschreibung
void

Ersetzen Sie im folgenden Beispiel REST_message_record durch den Namen des REST-Nachrichtendatensatzes Ihrer Instanz.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setEccParameter("source","http://very.long.endpoint.url");

RESTMessageV2 – setEndpoint(String endpoint)

Legt den Endpunkt für die REST-Nachricht fest.

Standardmäßig verwendet die REST-Nachricht den im REST-Nachrichtendatensatz angegebenen Endpunkt. Verwenden Sie diese Methode, um diesen Standardwert zu überschreiben. Sie müssen diese Methode bei der Verwendung des RESTMessageV2 – RESTMessageV2()-Konstruktors ohne Parameter aufrufen.

Tabelle : 31. Parameter

Name	Typ	Beschreibung
endpoint	Zeichenfolge	Die URL des REST-Providers, mit dem Sie eine Schnittstelle herstellen möchten.

Tabelle : 32. Ergebnisse

Typ	Beschreibung
void

var sm = new sn_ws.RESTMessageV2();
sm.setEndpoint("http://web.service.endpoint");

RESTMessageV2 – setHttpMethod(String method)

Legt die HTTP-Methode fest, die diese REST-Nachricht ausführt, z. B. GET oder PUT.

Sie müssen eine HTTP-Methode festlegen, wenn Sie den RESTMessageV2 – RESTMessageV2()-Konstruktor ohne Parameter verwenden.

Tabelle : 33. Parameter

Name	Typ	Beschreibung
method	Zeichenfolge	Legt die HTTP-Methode fest, die diese REST-Nachricht ausführt. Bei der angegebenen HTTP-Methode wird die Groß-/Kleinschreibung nicht beachtet. Die folgenden HTTP-Methoden werden unterstützt: GET POST PUT PATCH LÖSCHEN HEAD

Tabelle : 34. Rückgaben

Typ	Beschreibung
void

var sm = new sn_ws.RESTMessageV2();
sm.setHttpMethod("post");

RESTMessageV2 – setHttpTimeout(Number timeoutMs)

Legt fest, wie lange die REST-Nachricht auf eine Antwort des Webservice Providers wartet, bevor die Anforderung abläuft.

Tabelle : 35. Parameter

Name	Typ	Beschreibung
timeoutMs	Anzahl	Zeit in Millisekunden, bis der Anruf beim REST-Provider abläuft. Hinweis: Dieser Wert legt eine Zeitüberschreitung für den Socket fest und führt nur dann eine Zeitüberschreitung durch, wenn der Socket keine Daten innerhalb der angegebenen Zeit empfängt. Für Umgebungen, in denen Antworten gestreamt werden, ist es möglich, dass Verbindungen viel länger dauern als der Zeitüberschreitungswert.

Tabelle : 36. Rückgaben

Typ	Beschreibung
Keine

Um das folgende Beispiel zu verwenden, ersetzen Sie <REST_message_record> Mit dem Namen des REST-Nachrichtendatensatzes aus Ihrer Instanz.

// Might throw exception if message doesn't exist or not visible due to scope.
var sm = new sn_ws.RESTMessageV2("<REST_message_record>", "get");
sm.setHttpTimeout(6000);

RESTMessageV2 – setLogLevel(String level)

Legt die Protokollebene für diese Nachricht und die entsprechende Antwort fest.

Durch das Festlegen einer Protokollebene mithilfe der RESTMessageV2-API wird die für den REST-Nachrichtendatensatz konfigurierte Protokollebene überschrieben. Diese Protokollebene gilt möglicherweise nicht, wenn die Endpunktdomäne oder die Eigenschaft ausgeschlossen ist glide.outbound_http_log.overrideIst „wahr“. Um Protokolle ausgehender Webservices anzuzeigen, navigieren Sie zu Systemprotokolle > Ausgehende HTTP-Anforderungenan.

Tabelle : 37. Parameter

Name	Typ	Beschreibung
level	Zeichenfolge	Die Protokollebene. Gültige Werte sind „basic“, „elevated“ und „all“.

Tabelle : 38. Ergebnisse

Typ	Beschreibung
void

var rm = new sn_ws.RESTMessageV2();
rm.setLogLevel('all');

RESTMessageV2 – setMIDServer(String midServer)

Konfiguriert die REST-Nachricht für die Kommunikation über einen MID-Server.

Tabelle : 39. Parameter

Name	Typ	Beschreibung
midServer	Zeichenfolge	Name des MID-Server Zu verwenden. Ihre Instanz muss einen aktiven haben MID-Server Mit dem angegebenen Namen.

Tabelle : 40. Rückgaben

Typ	Beschreibung
void

Ersetzen Sie im folgenden Beispiel REST_message_record durch den Namen des REST-Nachrichtendatensatzes Ihrer Instanz.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setMIDServer("mid_server_name");

RESTMessageV2 – setMutualAuth(String profileName)

Legt das Protokoll für die gegenseitige Authentifizierung für die REST-Nachricht fest.

Durch das Festlegen eines Protokollprofils mit dieser Methode wird das für den REST-Nachrichtendatensatz ausgewählte Protokollprofil überschrieben.

Tabelle : 41. Parameter

Name	Typ	Beschreibung
profileName	Zeichenfolge	Der Name des Protokollprofils für die gegenseitige Authentifizierung.

Tabelle : 42. Ergebnisse

Typ	Beschreibung
void

Ersetzen Sie im folgenden Beispiel REST_message_record durch den Namen des REST-Nachrichtendatensatzes Ihrer Instanz.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setMutualAuth("mutual_auth_profile_name");

RESTMessageV2 – setQueryParameter(String name, String value)

Hängt an das Ende der Anforderungs-URL einen Parameter mit dem Formularnamen=Wert an.

So hängt zum Beispiel der Code „setQueryParameter("sysparm_query","active=true^ORDERBYnumber^ORDERBYDESCcategory");“ den Text „sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory“ an die Anforderungs-URL an.

Tabelle : 43. Parameter

Name	Typ	Beschreibung
Name	Zeichenfolge	Name des zu übergebenden URL-Parameters.
Wert	Zeichenfolge	Wert zum Zuweisen des URL-Parameters.

Tabelle : 44. Rückgaben

Typ	Beschreibung
void

var sm = new sn_ws.RESTMessageV2();
//Set up message, including endpoint and authentication
sm.setQueryParameter("sysparm_query","active=true^ORDERBYnumber^ORDERBYDESCcategory");

RESTMessageV2 – setRequestBody(String body)

Legt den Textkörper fest, der bei Verwendung von PUT- oder POST-HTTP-Methoden an den Webservice Provider gesendet werden soll.

Wenn Sie den Textkörperinhalt mit dieser Methode festlegen, werden Variablen im Textkörper nicht durch Parameter aus dem REST-Nachrichtenfunktions-Datensatz ersetzt. Sie müssen alle Werte innerhalb des REST-Nachrichtentexts explizit definieren.

Tabelle : 45. Parameter

Name	Typ	Beschreibung
body	Zeichenfolge	Anforderungstext zum Senden.

Tabelle : 46. Rückgaben

Typ	Beschreibung
void

var sm = new sn_ws.RESTMessageV2("Update user","post"); //Might throw exception if message doesn't exist or not visible due to scope.
var body = "<Message body content>";
sm.setRequestBody(body);

RESTMessageV2 – setRequestBodyFromAttachment(String attachmentSysId)

Legt den Anforderungstext mithilfe eines vorhandenen Anhangdatensatzes fest.

Wenn Sie diese Funktion mit einer REST-Nachricht verwenden, die über eine gesendet wird MID-Server, MID-Server Der Anwender muss über alle Rollen verfügen, die zum Lesen von Anhangdatensätzen erforderlich sind.

Tabelle : 47. Parameter

Name	Typ	Beschreibung
attachmentSysId	Zeichenfolge	SYS_ID des Anhangs [sys_attachment]-Datensatzes, den Sie in dieser REST-Nachricht senden möchten.

Tabelle : 48. Rückgaben

Typ	Beschreibung
void

(function sampleRESTMessageV2() {
    try {
        var request = new sn_ws.RESTMessageV2();
        request.setHttpMethod('post');
        request.setEndpoint('<web service endpoint URL>');
        request.setRequestBodyFromAttachment('<attachment sys_id>');
        
        var response = request.execute();
        var httpResponseStatus = response.getStatusCode();
      
        gs.info("http response status_code: " + httpResponseStatus);        
    }
    catch (ex) {
        var message = ex.getMessage();
        gs.info(message);
    }
})();

RESTMessageV2 – setRequestHeader(String name, String value)

Legt einen HTTP-Header in der REST-Nachricht auf den angegebenen Wert fest.

Tabelle : 49. Parameter

Name	Typ	Beschreibung
Name	Zeichenfolge	Name des Headers.
Wert	Zeichenfolge	Wert, der dem angegebenen Header zugewiesen werden soll.

Tabelle : 50. Rückgaben

Typ	Beschreibung
void

Ersetzen Sie im folgenden Beispiel REST_message_record durch den Namen des REST-Nachrichtendatensatzes Ihrer Instanz.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setRequestHeader("Accept","Application/json");

RESTMessageV2 – setRequestorProfile(Zeichenfolge requestorContext, Zeichenfolge requestorId)

Überschreibt das Standardanfordererprofil für die REST-Nachricht, um ein OAuth-Zugriffstoken abzurufen, das einer anderen anfordernden Person zugeordnet ist.

Diese Methode gilt nur für REST-Nachrichten, die für die Verwendung der OAuth 2.0-Authentifizierung konfiguriert sind. Diese Methode ist optional und in den meisten Konfigurationen nicht erforderlich.

Tabelle : 51. Parameter

Name	Typ	Beschreibung
requestorContext	Zeichenfolge
requestorId	Zeichenfolge

Tabelle : 52. Ergebnisse

Typ	Beschreibung
void

RESTMessageV2 – setStringParameter(String name, String value)

Legt eine REST-Nachrichtenfunktionsvariable mit dem angegebenen Namen aus dem REST-Nachrichtendatensatz auf den angegebenen Wert fest.

Reservierte XML-Zeichen im Wert werden in die entsprechenden Escape-Zeichen umgewandelt. Verwenden Sie setStringParameterNoEscape, um eine Variable festzulegen, ohne für XML reservierte Zeichen in Escape-Zeichen umzuwandeln.

Tabelle : 53. Parameter

Name	Typ	Beschreibung
Name	Zeichenfolge	Name der REST-Nachrichtenvariablen. Dieser Parameter muss im REST-Nachrichtendatensatz definiert werden, bevor Sie ihm einen Wert zuweisen können.
Wert	Zeichenfolge	Wert zum Zuweisen der Variable.

Tabelle : 54. Rückgaben

Typ	Beschreibung
void

Ersetzen Sie im folgenden Beispiel REST_message_record durch den Namen des REST-Nachrichtendatensatzes Ihrer Instanz.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setStringParameter("s","NOW");

RESTMessageV2 – setStringParameterNoEscape(String name, String value)

Legt eine REST-Nachrichtenfunktionsvariable mit dem angegebenen Namen aus dem REST-Nachrichtendatensatz auf den angegebenen Wert fest.

Diese Methode ist äquivalent zu setStringParameter, schließt reservierte XML-Zeichen jedoch nicht in Escape-Zeichen ein.

Tabelle : 55. Parameter

Name	Typ	Beschreibung
Name	Zeichenfolge	Name der REST-Nachrichtenvariablen. Dieser Parameter muss im REST-Nachrichtendatensatz definiert werden, bevor Sie ihm einen Wert zuweisen können.
Wert	Zeichenfolge	Wert zum Zuweisen der Variable.

Tabelle : 56. Rückgaben

Typ	Beschreibung
void

Ersetzen Sie im folgenden Beispiel REST_message_record durch den Namen des REST-Nachrichtendatensatzes Ihrer Instanz.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setStringParameterNoEscape("s","NOW");