---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# RESTMessageV2: Bereichsbezogen, global

# RESTMessageV2: Bereichsbezogen, global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 14 Minuten Lesedauer

Die RESTMessageV2 Die API bietet Methoden, 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() {#ariaid-title2}

Instanziiert ein leeres RESTMessageV2-Objekt.
Wenn Sie ein auf diese Weise instanziiertes Objekt verwenden, müssen Sie manuell eine HTTP-Methode und einen Endpunkt angeben.
{#r_RMV2-RESTMessageV2__table_vy2_525_jqf__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 1. Parameter]

{#r_RMV2-RESTMessageV2__table_vy2_525_jqf}  

    var sm = new sn_ws.RESTMessageV2();

## RESTMessageV2: RESTMessageV2(Zeichenfolgenname, Zeichenfolgenmethodenname) {#ariaid-title3}

Instanziiert ein RESTMessageV2-Objekt mithilfe von Informationen aus einem REST-Nachrichtendatensatz.
Sie müssen einen REST-Nachrichtendatensatz definiert haben, bevor Sie diesen Konstruktor verwenden können. Anweisungen finden Sie unter [Erstellen Sie eine REST-Nachricht](https://servicenow-prod.fluidtopics.net/FXDXHeKq6uuuBzS9WuH6ag "Senden Sie Anforderungen an einen REST-Webservice-Endpunkt, indem Sie einen REST-Nachrichtendatensatz erstellen.").
{#r_RMV2-RESTMessageV2_S_S__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Der Name des REST-Nachrichtendatensatzes in der Tabelle „REST Message" \[sys_Rest_message\]. |
| methodName | Zeichenfolge | Der Name der zu verwendenden HTTP-Methode, z. B. GET/GET oder PUT/PUT -- Groß-/Kleinschreibung wird nicht berücksichtigt. |
[Tabelle : 2. Parameter]

{#r_RMV2-RESTMessageV2_S_S__table_vy2_525_jq}

Ersetzen Sie im folgenden Beispiel <var class="keyword varname">REST_message_Record </var>Mit dem Namen des REST-Nachrichtendatensatzes aus 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() {#ariaid-title4}

Deaktiviert die erzwungene Variablenersetzung in 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, finden Sie weitere Informationen unter [Dieser Community-artikel](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB1442596)Für eine potenzielle Lösung.
{#RestMessageV2-disableForcedVariableSubstitution__table_bvg_43g_z2b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 3. Parameter]

{#RestMessageV2-disableForcedVariableSubstitution__table_bvg_43g_z2b} {#RestMessageV2-disableForcedVariableSubstitution__table_cvg_43g_z2b__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 4. Rückgaben]

{#RestMessageV2-disableForcedVariableSubstitution__table_cvg_43g_z2b}  

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

## RESTMessageV2 -- execute() {#ariaid-title5}

Sendet die REST-Nachricht an den Endpunkt.
{#r_RMV2-execute__table_vy2_525_jqa__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 5. Parameter]

{#r_RMV2-execute__table_vy2_525_jqa} {#r_RMV2-execute__table_qlp_mhh_dr__entry__2}

| Typ | Beschreibung |
|-|-|
| RESTAntwort | Die vom REST-Provider zurückgegebene Antwort. |
[Tabelle : 6. Rückgaben]

{#r_RMV2-execute__table_qlp_mhh_dr}

Ersetzen Sie im folgenden Beispiel <var class="keyword varname">REST_message_Record </var>Mit dem Namen des REST-Nachrichtendatensatzes aus 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() {#ariaid-title6}

Sendet die REST-Nachricht asynchron an den Endpunkt. Die Instanz wartet bei asynchronen Aufrufen nicht auf eine Antwort des Webservice Providers.
{#r_RMV2-executeAsync__table_vy2_525_jqb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 7. Parameter]

{#r_RMV2-executeAsync__table_vy2_525_jqb} {#r_RMV2-executeAsync__table_rys_lhh_dr__entry__2}

| Typ | Beschreibung |
|-|-|
| RESTAntwort | Die vom REST-Provider zurückgegebene Antwort. |
[Tabelle : 8. Rückgaben]

{#r_RMV2-executeAsync__table_rys_lhh_dr}

Ersetzen Sie im folgenden Beispiel <var class="keyword varname">REST_message_Record </var>Mit dem Namen des REST-Nachrichtendatensatzes aus Ihrer Instanz. Bei Verwendung `ExecuteAsync `, Erwägen Sie, den Antworttext in einer separaten Business-Regel zu verarbeiten, 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() {#ariaid-title7}

Ruft die URL des Endpunkts für die REST-Nachricht ab.
{#r_RMV2-getEndpoint__table_vy2_525_jqc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 9. Parameter]

{#r_RMV2-getEndpoint__table_vy2_525_jqc} {#r_RMV2-getEndpoint__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Die URL des REST-Webservice-Providers. |
[Tabelle : 10. Rückgaben]

{#r_RMV2-getEndpoint__table_qpt_3f5_jq}

Ersetzen Sie im folgenden Beispiel <var class="keyword varname">REST_message_Record </var>Mit dem Namen des REST-Nachrichtendatensatzes aus 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() {#ariaid-title8}

Ruft den Inhalt des REST-Nachrichtentexts ab.
{#r_RMV2-getRequestBody__table_vy2_525_jqd__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 11. Parameter]

{#r_RMV2-getRequestBody__table_vy2_525_jqd} {#r_RMV2-getRequestBody__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der REST-Nachrichtentext. |
[Tabelle : 12. Rückgaben]

{#r_RMV2-getRequestBody__table_qpt_3f5_jq}

Ersetzen Sie im folgenden Beispiel <var class="keyword varname">REST_message_Record </var>Mit dem Namen des REST-Nachrichtendatensatzes aus 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(Zeichenfolge headerName) {#ariaid-title9}

Ruft den Wert für einen in der REST-Nachricht angegebenen HTTP-Header ab.
Standardmäßig kann diese Methode den Wert für einen automatisch vom System festgelegten Header nicht zurückgeben. Um dieser Methode Zugriff auf alle Header zu gewähren, legen Sie die Eigenschaft „Glide.http.log_debug" auf „wahr" fest.
{#r_RMV2-getRequestHeader_S__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| headerName | Zeichenfolge | Anforderungsheader, für den Sie den Wert abrufen möchten. |
[Tabelle : 13. Parameter]

{#r_RMV2-getRequestHeader_S__table_vy2_525_jq} {#r_RMV2-getRequestHeader_S__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Wert des angegebenen Headers. |
[Tabelle : 14. Rückgaben]

{#r_RMV2-getRequestHeader_S__table_qpt_3f5_jq}

Ersetzen Sie im folgenden Beispiel <var class="keyword varname">REST_message_Record </var>Mit dem Namen des REST-Nachrichtendatensatzes aus 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() {#ariaid-title10}

Ruft HTTP-Header ab, die vom REST-Client festgelegt wurden, und die zugehörigen Werte.
Diese Methode gibt nicht automatisch vom System festgelegte Header zurück. Um diese Methode so zu konfigurieren, dass alle Header zurückgegeben werden, legen Sie die Eigenschaft „Glide.http.log_debug" auf „wahr" fest.
{#r_RMV2-getRequestHeaders__table_vy2_525_jqe__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 15. Parameter]

{#r_RMV2-getRequestHeaders__table_vy2_525_jqe} {#r_RMV2-getRequestHeaders__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Ein Objekt, das den Namen jedes Headers dem zugeordneten Wert zuordnet. |
[Tabelle : 16. Rückgaben]

{#r_RMV2-getRequestHeaders__table_qpt_3f5_jq}

Ersetzen Sie im folgenden Beispiel <var class="keyword varname">REST_message_Record </var>Mit dem Namen des REST-Nachrichtendatensatzes aus 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 (Zeichenfolge tableName, Zeichenfolge-Datensatz-SysId, Zeichenfolge-Dateiname) {#ariaid-title11}

Konfiguriert die REST-Nachricht, um den zurückgegebenen Antworttext 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 Anhangsdatensätzen erforderlich sind, sowie über alle Rollen, die zum Lesen und Schreiben von Datensätzen in der in angegebenen Tabelle erforderlich sind tableNameParameter.{#r_RMV2-saveRespBodyAsAttach_S_S_S__p_RMv2_MID_role_req_save}

Der Antworttext muss keine Binärdatei sein, um als Anhang gespeichert zu werden. Antworttexte in Textformaten wie JSON oder XML können ebenfalls gespeichert werden. Wenn die Instanz den Anhang nicht speichern kann, rufen Sie auf GetErrorMessage() Im zugehörigen RESTResponseV2-Objekt für Fehlerdetails.
{#r_RMV2-saveRespBodyAsAttach_S_S_S__table_yg1_rp3_5s__entry__3}

| 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 an, der der gespeicherten Datei zugewiesen werden soll. |
[Tabelle : 17. Parameter]

{#r_RMV2-saveRespBodyAsAttach_S_S_S__table_yg1_rp3_5s} {#r_RMV2-saveRespBodyAsAttach_S_S_S__table_zg1_rp3_5s__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 18. Rückgaben]

{#r_RMV2-saveRespBodyAsAttach_S_S_S__table_zg1_rp3_5s}  

    (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 (Zeichenfolge tableName, Zeichenfolge-Datensatz-SysId, Zeichenfolgendateiname, Zeichenfolge verschlüsseltContext) {#ariaid-title12}

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 Anhangsdatensätzen erforderlich sind, sowie über alle Rollen, die zum Lesen und Schreiben von Datensätzen in der in angegebenen Tabelle erforderlich sind tableNameParameter.

Der Antworttext muss keine Binärdatei sein, um als Anhang gespeichert zu werden. Antworttexte in Textformaten wie JSON oder XML können ebenfalls gespeichert werden. Wenn die Instanz den Anhang nicht speichern kann, rufen Sie auf GetErrorMessage() Im zugehörigen RESTResponseV2-Objekt für Fehlerdetails.{#r_RMV2-saveRespBodyAsAttach_S_S_S_S__p_k4n_p22_vs}
{#r_RMV2-saveRespBodyAsAttach_S_S_S_S__table_yg1_rp3_5s__entry__3}

| 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 an, der der gespeicherten Datei zugewiesen werden soll. |
| VerschlüsselnContext | Zeichenfolge | Geben Sie die sys_ID eines Verschlüsselungskontexts an. Die gespeicherte Datei wird mit diesem Kontext verschlüsselt. |
[Tabelle : 19. Parameter]

{#r_RMV2-saveRespBodyAsAttach_S_S_S_S__table_yg1_rp3_5s} {#r_RMV2-saveRespBodyAsAttach_S_S_S_S__table_zg1_rp3_5s__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 20. Rückgaben]

{#r_RMV2-saveRespBodyAsAttach_S_S_S_S__table_zg1_rp3_5s}

## RESTMessageV2 -- setAllowedRedirectURIs (Array-URIs) {#ariaid-title13}

Legt einen oder mehrere URIs fest, an die 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](https://servicenow-prod.fluidtopics.net/XsXCNd84yetBw~67Vsxywg#UriMatcherScopedAPI "Stellt eine Methode bereit, um zu überprüfen, ob ein URI den angegebenen Kriterien für Schema, Host, Pfad, Fragmente und Vorhandensein von Abfrageparametern entspricht.").
{#r_RMV2-setAllowedRedirectURIs_A__table_qym_34c_jt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Uris | Array | Mindestens ein URIs für die Umleitung zulässig. Jeder URI muss im Format „Zeichenfolge" aufgeführt werden. |
[Tabelle : 21. Parameter]

{#r_RMV2-setAllowedRedirectURIs_A__table_qym_34c_jt} {#r_RMV2-setAllowedRedirectURIs_A__table_rym_34c_jt__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 22. Rückgaben]

{#r_RMV2-setAllowedRedirectURIs_A__table_rym_34c_jt}  
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(Zeichenfolgentyp, Zeichenfolgenprofil-ID) {#ariaid-title14}

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

| Name | Typ | Beschreibung |
|-|-|-|
| Typ | Zeichenfolge | Der Typ des zu verwendenden Authentifizierungsprofils. Gültige Werte sind „Standard", um die Standardauthentifizierung zu verwenden, oder „oauth2", um OAuth 2,0 zu verwenden. |
| profileId | Zeichenfolge | Die sys_ID eines Authentifizierungsprofildatensatzes. Geben Sie bei Verwendung der Standardauthentifizierung die sys_ID eines Datensatzes für die Standardauthentifizierungskonfiguration \[sys_auth_profile_basic\] an. Geben Sie bei Verwendung von OAuth 2,0 die sys_ID eines OAuth-Entitätsprofils \[oauth_Entity_Profile\]-Datensatzes an. |
[Tabelle : 23. Parameter]

{#r_RMV2-setAuthenticationProfile_S_S__table_qym_34c_jt} {#r_RMV2-setAuthenticationProfile_S_S__table_rym_34c_jt__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 24. Rückgaben]

{#r_RMV2-setAuthenticationProfile_S_S__table_rym_34c_jt}

Ersetzen Sie im folgenden Beispiel <var class="keyword varname">REST_message_Record </var>Mit dem Namen des REST-Nachrichtendatensatzes aus 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 (Zeichenfolge Anwendername, Zeichenfolge userPass) {#ariaid-title15}

Legt Header für Standardauthentifizierung für die REST-Nachricht fest.
Das Festlegen von Sicherheitswerten mit dieser Methode überschreibt die Standardauthentifizierungswerte, die für den REST-Nachrichtendatensatz definiert sind.
{#r_RMV2-setBasicAuth_S_S__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| userName | Zeichenfolge | Anwendername, den Sie zum Authentifizieren der REST-Nachricht verwenden möchten. |
| UserPass | Zeichenfolge | Passwort für den angegebenen Anwender. |
[Tabelle : 25. Parameter]

{#r_RMV2-setBasicAuth_S_S__table_vy2_525_jq} {#r_RMV2-setBasicAuth_S_S__table_arp_cmh_dr__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 26. Rückgaben]

{#r_RMV2-setBasicAuth_S_S__table_arp_cmh_dr}

Ersetzen Sie im folgenden Beispiel <var class="keyword varname">REST_message_Record </var>Mit dem Namen des REST-Nachrichtendatensatzes aus 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 (Zeichenfolgenkorrelator) {#ariaid-title16}

Ordnet ausgehende Anforderungen und den resultierenden Antwortdatensatz in der ECC-Warteschlange zu. Diese Methode gilt nur für REST-Nachrichten, die über gesendet werden MID-Server.
Der angegebene Korrelator füllt aus Agent-Korrelator Feld im ECC-Warteschlangendatensatz für die Antwort. Geben Sie für jede ausgehende Anforderung einen eindeutigen Korrelator an, um die richtigen Ergebnisse in der ECC-Warteschlange der Anforderung zuzuordnen, wenn Sie die asynchrone Automatisierung über einen MID-Server entwerfen.
{#r_RMV2-setEccCorrelator_S__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Korrelator | Zeichenfolge | Eindeutiger Bezeichner |
[Tabelle : 27. Parameter]

{#r_RMV2-setEccCorrelator_S__table_vy2_525_jq} {#r_RMV2-setEccCorrelator_S__table_x3m_cmh_dr__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 28. Rückgaben]

{#r_RMV2-setEccCorrelator_S__table_x3m_cmh_dr}

Ersetzen Sie im folgenden Beispiel <var class="keyword varname">REST_message_Record </var>Mit dem Namen des REST-Nachrichtendatensatzes aus 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 (Zeichenfolgenname, Zeichenfolgenwert) {#ariaid-title17}

Überschreibt einen Wert aus der Datenbank, indem er in die REST-Nachrichtennutzlast schreibt. 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 Länge des REST-Endpunktfelds ist. Sie können mit dieser Methode nur die Endpunkt-URL festlegen, indem Sie die Quelle als Namensparameter übergeben.
{#r_RMV2-setEccParameter_S_S__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Der Name des Parameters, z. B. Quelle. |
| Wert | Zeichenfolge | Der Wert, der dem angegebenen Parameter zugewiesen werden soll. |
[Tabelle : 29. Parameter]

{#r_RMV2-setEccParameter_S_S__table_vy2_525_jq} {#r_RMV2-setEccParameter_S_S__table_b1j_cmh_dr__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 30. Rückgaben]

{#r_RMV2-setEccParameter_S_S__table_b1j_cmh_dr}

Ersetzen Sie im folgenden Beispiel <var class="keyword varname">REST_message_Record </var>Mit dem Namen des REST-Nachrichtendatensatzes aus 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 (Zeichenfolgenendpunkt) {#ariaid-title18}

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 Standard zu überschreiben. Sie müssen diese Methode aufrufen, wenn Sie verwenden [RESTMessageV2 -- RESTMessageV2()](https://servicenow-prod.fluidtopics.net/Bairn7s6miXdcdp2w1TIFw#r_RMV2-RESTMessageV2 "Instanziiert ein leeres RESTMessageV2-Objekt.")Konstruktor ohne Parameter.
{#r_RMV2-setEndpoint_String_endpoint__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| endpoint | Zeichenfolge | Die URL des REST-Providers, mit dem Sie eine Schnittstelle herstellen möchten. |
[Tabelle : 31. Parameter]

{#r_RMV2-setEndpoint_String_endpoint__table_vy2_525_jq} {#r_RMV2-setEndpoint_String_endpoint__table_utf_cmh_dr__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 32. Rückgaben]

{#r_RMV2-setEndpoint_String_endpoint__table_utf_cmh_dr}  

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

## RESTMessageV2 -- setHttpMethod(Zeichenfolgenmethode) {#ariaid-title19}

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 verwenden [RESTMessageV2 -- RESTMessageV2()](https://servicenow-prod.fluidtopics.net/Bairn7s6miXdcdp2w1TIFw#r_RMV2-RESTMessageV2 "Instanziiert ein leeres RESTMessageV2-Objekt.")Konstruktor ohne Parameter.
{#r_RMV2-setHttpMethod_String_method__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| method | Zeichenfolge | Auszuführende HTTP-Methode. |
[Tabelle : 33. Parameter]

{#r_RMV2-setHttpMethod_String_method__table_vy2_525_jq} {#r_RMV2-setHttpMethod_String_method__table_bqb_cmh_dr__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 34. Rückgaben]

{#r_RMV2-setHttpMethod_String_method__table_bqb_cmh_dr}  

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

## RESTMessageV2 -- setHttpTimeout(Anzahl Zeitüberschreitungen) {#ariaid-title20}

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

| Name | Typ | Beschreibung |
|-|-|-|
| Zeitüberschreitungen | Nummer | Zeit in Millisekunden, bis der Anruf beim REST-Provider abläuft. Hinweis: Dieser Wert legt eine Zeitüberschreitung für den Socket und eine Zeitüberschreitung fest, 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 : 35. Parameter]

{#r_RMV2-setHttpTimeout_N__table_vy2_525_jq} {#r_RMV2-setHttpTimeout_N__table_tcy_bmh_dr__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 36. Rückgaben]

{#r_RMV2-setHttpTimeout_N__table_tcy_bmh_dr}  
Um das folgende Beispiel zu verwenden, ersetzen Sie <var class="keyword varname">&lt;REST_message_record&gt; </var>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 (Zeichenfolgenebene) {#ariaid-title21}

Legt die Protokollebene für diese Nachricht und die entsprechende Antwort fest.
Das Festlegen einer Protokollebene mithilfe der RESTMessageV2-API überschreibt die für den REST-Nachrichtendatensatz konfigurierte Protokollebene. Diese Protokollebene gilt möglicherweise nicht, wenn die Endpunktdomäne oder die Eigenschaft ausgeschlossen ist glide.outbound_http_log.overrideIst „wahr". Navigieren Sie zum Anzeigen ausgehender Webserviceprotokolle zu SystemprotokolleAusgehende HTTP-Anforderungenan.
{#RMV2-setLogLevel_S__table_jsf_y55_rw__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| level | Zeichenfolge | Die Protokollebene. Gültige Werte sind „Standard", „erhöht" und „alle". |
[Tabelle : 37. Parameter]

{#RMV2-setLogLevel_S__table_jsf_y55_rw} {#RMV2-setLogLevel_S__table_ksf_y55_rw__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 38. Rückgaben]

{#RMV2-setLogLevel_S__table_ksf_y55_rw}  

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

## RESTMessageV2 -- setMIDServer (Zeichenfolge midServer) {#ariaid-title22}

Konfiguriert die REST-Nachricht für die Kommunikation über einen MID-Server.
{#r_RMV2-setMIDServer_S__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Mid-Server | Zeichenfolge | Name von MID-ServerZu verwenden. Ihre Instanz muss aktiv sein MID-ServerMit dem angegebenen Namen. |
[Tabelle : 39. Parameter]

{#r_RMV2-setMIDServer_S__table_vy2_525_jq} {#r_RMV2-setMIDServer_S__table_el5_bmh_dr__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 40. Rückgaben]

{#r_RMV2-setMIDServer_S__table_el5_bmh_dr}  
Ersetzen Sie im folgenden Beispiel <var class="keyword varname">REST_message_Record </var>Mit dem Namen des REST-Nachrichtendatensatzes aus 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(Zeichenfolge profileName) {#ariaid-title23}

Legt das Protokoll für die gegenseitige Authentifizierung für die REST-Nachricht fest.
Das Festlegen eines Protokollprofils mit dieser Methode überschreibt das für den REST-Nachrichtendatensatz ausgewählte Protokollprofil.
{#r_RMV2-setMutualAuth_S__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| profileName | Zeichenfolge | Die Name Des Protokollprofils, das für die gegenseitige Authentifizierung verwendet werden soll. |
[Tabelle : 41. Parameter]

{#r_RMV2-setMutualAuth_S__table_vy2_525_jq} {#r_RMV2-setMutualAuth_S__table_r1r_bmh_dr__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 42. Rückgaben]

{#r_RMV2-setMutualAuth_S__table_r1r_bmh_dr}  
Ersetzen Sie im folgenden Beispiel <var class="keyword varname">REST_message_Record </var>Mit dem Namen des REST-Nachrichtendatensatzes aus 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 (Zeichenfolgenname, Zeichenfolgenwert) {#ariaid-title24}

Hängt einen Parameter an das Ende der Anforderungs-URL mit dem Formularname=value an.
Beispiel: Der Code setQueryParameter("sysparm_query","Active=true\^ORDERBYnumber\^ORDERBYDESCcategory"); fügt den Text sysparm_query=Active=true\^ORDERBYnumber\^ORDERBYDESCcategory an die Anforderungs-URL an.
{#r_RMV2-setQueryParameter_S_S__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Name des zu übergebenden URL-Parameters. |
| Wert | Zeichenfolge | Wert zum Zuweisen des URL-Parameters. |
[Tabelle : 43. Parameter]

{#r_RMV2-setQueryParameter_S_S__table_vy2_525_jq} {#r_RMV2-setQueryParameter_S_S__table_cnm_bmh_dr__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 44. Rückgaben]

{#r_RMV2-setQueryParameter_S_S__table_cnm_bmh_dr}  

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

## RESTMessageV2 -- setRequestBody (Zeichenfolgentext) {#ariaid-title25}

Legt den Textkörper fest, der an den Webservice-Provider gesendet werden soll, wenn HTTP-Methoden zum PUT oder POST verwendet werden.
Wenn Sie den Textinhalt mit dieser Methode festlegen, werden Variablen im Textkörper nicht durch Parameter aus dem Datensatz der REST-Nachrichtenfunktion ersetzt. Sie müssen explizit alle Werte im REST-Nachrichtentext definieren.
{#r_RMV2-setRequestBody_String_body__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| body | Zeichenfolge | Anforderungstext zum Senden. |
[Tabelle : 45. Parameter]

{#r_RMV2-setRequestBody_String_body__table_vy2_525_jq} {#r_RMV2-setRequestBody_String_body__table_gft_1mh_dr__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 46. Rückgaben]

{#r_RMV2-setRequestBody_String_body__table_gft_1mh_dr}  

    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(Zeichenfolge anhangSysId) {#ariaid-title26}

Legt den Anforderungstext mithilfe eines vorhandenen Anhangsdatensatzes fest.
Wenn Sie diese Funktion mit einer REST-Nachricht verwenden, die über gesendet wird MID-Server, MID-ServerDer Anwender muss über alle Rollen verfügen, die zum Lesen von Anhangsdatensätzen erforderlich sind.{#r_RMV2-setReqBodyFromAttachment_S__p_RMv2_MID_roles_req}
{#r_RMV2-setReqBodyFromAttachment_S__table_kn2_bp3_5s__entry__3}

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

{#r_RMV2-setReqBodyFromAttachment_S__table_kn2_bp3_5s} {#r_RMV2-setReqBodyFromAttachment_S__table_ln2_bp3_5s__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 48. Rückgaben]

{#r_RMV2-setReqBodyFromAttachment_S__table_ln2_bp3_5s}  

    (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 (Zeichenfolgenname, Zeichenfolgenwert) {#ariaid-title27}

Legt einen HTTP-Header in der REST-Nachricht auf den angegebenen Wert fest.
{#r_RMV2-setRequestHeader_S_S__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Name des Headers. |
| Wert | Zeichenfolge | Wert, der dem angegebenen Header zugewiesen werden soll. |
[Tabelle : 49. Parameter]

{#r_RMV2-setRequestHeader_S_S__table_vy2_525_jq} {#r_RMV2-setRequestHeader_S_S__table_ryx_1mh_dr__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 50. Rückgaben]

{#r_RMV2-setRequestHeader_S_S__table_ryx_1mh_dr}  
Ersetzen Sie im folgenden Beispiel <var class="keyword varname">REST_message_Record </var>Mit dem Namen des REST-Nachrichtendatensatzes aus 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) {#ariaid-title28}

Ü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 unnötig.
{#r_RMv2-setRequestorProfile_S_S__table_c4t_2my_lt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Request-Kontext | Zeichenfolge |   |
| Request-ID | Zeichenfolge |   |
[Tabelle : 51. Parameter]

{#r_RMv2-setRequestorProfile_S_S__table_c4t_2my_lt} {#r_RMv2-setRequestorProfile_S_S__table_d4t_2my_lt__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 52. Rückgaben]

{#r_RMv2-setRequestorProfile_S_S__table_d4t_2my_lt}

## RESTMessageV2 -- setStringParameter (Zeichenfolgenname, Zeichenfolgenwert) {#ariaid-title29}

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 Zeichen mit Escape-Zeichen konvertiert. Verwenden SetStringParameterNoEscape Dient zum Festlegen einer Variable, ohne dass für XML reservierte Zeichen mit Escape-Zeichen versehen werden.
{#r_RMV2-setStringParameter_S_S__table_vy2_525_jq__entry__3}

| 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 : 53. Parameter]

{#r_RMV2-setStringParameter_S_S__table_vy2_525_jq} {#r_RMV2-setStringParameter_S_S__table_c1n_zlh_dr__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 54. Rückgaben]

{#r_RMV2-setStringParameter_S_S__table_c1n_zlh_dr}  
Ersetzen Sie im folgenden Beispiel <var class="keyword varname">REST_message_Record </var>Mit dem Namen des REST-Nachrichtendatensatzes aus 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 (Zeichenfolgenname, Zeichenfolgenwert) {#ariaid-title30}

Legt eine REST-Nachrichtenfunktionsvariable mit dem angegebenen Namen aus dem REST-Nachrichtendatensatz auf den angegebenen Wert fest.
Diese Methode entspricht SetStringParameter Jedoch werden für XML reservierte Zeichen nicht mit Escape-Zeichen versehen.
{#r_RMV2-setStrParamNoEscape_S_S__table_vy2_525_jq__entry__3}

| 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 : 55. Parameter]

{#r_RMV2-setStrParamNoEscape_S_S__table_vy2_525_jq} {#r_RMV2-setStrParamNoEscape_S_S__table_yrh_zlh_dr__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 56. Rückgaben]

{#r_RMV2-setStrParamNoEscape_S_S__table_yrh_zlh_dr}  
Ersetzen Sie im folgenden Beispiel <var class="keyword varname">REST_message_Record </var>Mit dem Namen des REST-Nachrichtendatensatzes aus 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");


