--- sourceDocument: Xanadu: Integrationen mit Anwendungen erstellen sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/integrate-applications Release : - xanadu ft:locale : - de-DE ft:publication_title : - Xanadu: Integrationen mit Anwendungen erstellen ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # REST-Webserviceaktivitäten erstellen # REST-Webserviceaktivitäten erstellen {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 10 Minuten Lesedauer Verwenden Sie dieses Verfahren, um eine benutzerdefinierte REST-Webserviceaktivität für Orchestration zu erstellen. ## Vorbereitungen Erforderliche Rolle: web_service_admin, activity_admin, activity_creator ## Warum und wann dieser Vorgang ausgeführt wird So erstellen und verwenden Sie eine Workflows-Aktivität für REST-Webservices: * Erstellen [Sie eine REST-Nachricht erstellen,](https://www.servicenow.com/docs/access?context=t_ConfiguringARESTMessage&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US) wenn noch keine geeignete konfiguriert ist. * Weisen Sie jedem Benutzer, der eine benutzerdefinierte REST-Aktivität erstellen oder bearbeiten muss, die Rolle „web_service_admin" zu. * Bestimmen Sie eine Anwendung oder einen [Anwendungsbereich](https://www.servicenow.com/docs/access?context=c_ApplicationScope&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US)für diese Aktivität. * Bestimmen Sie die [Option REST-Nachricht erstellen](https://www.servicenow.com/docs/access?context=t_ConfiguringARESTMessage&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US), die für die Aktivität verwendet werden soll. Verwenden Sie diesen Wert, um den in der REST-Nachricht konfigurierten Endpunkt zu überschreiben. * Erstellen Sie optional [Anmeldeinformationen](https://www.servicenow.com/docs/access?context=r_BasicAuthCredentialsForm&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US)für die Standardauthentifizierung. Verwenden Sie diesen Wert, um die in der SOAP-Nachricht konfigurierten Berechtigungsnachweise zu überschreiben. {#t_CreateARESTWebServiceActivity__ul_fqx_dt1_dr} ## Prozedur 1. Erstellen Sie eine [benutzerdefinierte Aktivität](https://servicenow-prod.fluidtopics.net/VIlMbh9w_bkZbqu0ipBH9g "Sie können verschiedene Arten von benutzerdefinierten Aktivitäten mit einer benutzerdefinierten Vorlage im Workflow-Editor erstellen und aktualisieren."). Diese Aktion erstellt eine benutzerdefinierte Aktivität mithilfe einer Vorlage. 2. Nach dem Einrichten [allgemeiner Eigenschaften](https://servicenow-prod.fluidtopics.net/t14SlD7ReBP~CKyn8CtcZw "Die folgenden allgemeinen Eigenschaftenfelder gelten für alle Aktivitätendesignervorlagen.") und dem [Erstellen von Eingabevariablen](https://servicenow-prod.fluidtopics.net/MQCgLHhx1MwbZDixCnzx6w#CreateInputVariables "Erstellen Sie im Formular Eingaben des Aktivitätendesigners die Variablen, die an die Aktivität übergeben werden sollen.")konfigurieren Sie den Ausführungsbefehl des REST-Webservice. | Option | Bezeichnung | | [Ordnen Sie die Eingabevariablen zu](https://servicenow-prod.fluidtopics.net/MQCgLHhx1MwbZDixCnzx6w#t_MapAnInputVariable "Nachdem Sie die Eingabevariablen erstellt haben, ordnen Sie sie den Feldern im Formular „Ausführungsbefehl“ zu.") | Verwenden Sie die von Ihnen erstellten Variablen, um den Befehl zu konfigurieren, den Orchestration ausführt. | | REST-Nachricht | Name einer vorhandenen REST-Nachricht, die in dieser Aktivität verwendet werden soll | | REST-Nachrichtenfunktion | REST-Nachrichtenfunktion für diese Aktivität | | Endpunkt | Endpunkt-URL für den von dieser Aktivität verwendeten REST-Webservice. Geben Sie einen Endpunkt in dieses Feld ein, um den in der REST-Nachricht konfigurierten Endpunkt zu überschreiben. Klicken Sie auf das Schlosssymbol, um das Eingabefeld zu öffnen. | | Variablensubstitutionen | Name-Wert-Paare, die an den REST-Endpunkt übergeben werden sollen. Sie können diese Parameter manuell erstellen oder Eingabevariablen in die Parameterfelder ziehen und dann einen Wert zuweisen. Parametern, die in der REST-Nachricht definiert sind und ${} verwenden, können Daten aus dieser Aktivitätsvorlage zugewiesen werden. Verwenden Sie die Spalte Zusätzliches Attribut, um das System so zu konfigurieren, dass der Text nicht mit Escape-Zeichen versehen wird. Der an die REST-Nachricht gesendete Text wird standardmäßig mit Escape-Zeichen versehen. Wenn die Benutzer Variablen mithilfe der [Variablenersetzung in ausgehenden REST-Nachrichten](https://www.servicenow.com/docs/access?context=c_VariableSubstitutionREST&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US) in der REST-Nachricht bereitgestellt haben, wird die Spalte „ Name " automatisch ausgefüllt. | | Zusätzliche Header | Zusätzliche HTTP-Headerparameter für die ausgewählte REST-Nachricht. Sie können diese Werte auch verwenden, um Parameter zu überschreiben, die von der REST-Nachricht geerbt wurden. | | Zusätzliche Abfrageparameter | Zusätzliche Abfrageparameter für die ausgewählte REST-Nachricht. Sie können diese Werte auch verwenden, um Parameter zu überschreiben, die von der REST-Nachricht geerbt wurden. | | MID Server verwenden | Kontrollkästchen, das festlegt, ob ein MID Server zum Aufrufen des REST-Webservice verwendet werden muss. Hinweis: Wenn die REST-Webservice-Nachrichtenfunktion einen MID Server definiert, wird dieser MID Server anstelle des hier ausgewählten verwendet. | | Erforderliche MID Server-Fähigkeiten | MID-Server mit den entsprechenden [MID-Server-Fähigkeiten](https://www.servicenow.com/docs/access?context=t_ConfigureCapabilities&version=xanadu&pubname=xanadu-servicenow-platform§ion=r_MIDServerCapabilities&ft:locale=en-US) für die Verbindung mit dem REST-Endpunkt. Standardmäßig wählt das System einen MID Server mit REST-Fähigkeiten aus. Dieses Feld ist verfügbar, wenn die Checkbox MID-Server verwenden aktiviert ist. | | Zeitüberschreitung | Zulässige Dauer der REST-Webserviceanforderung vor der Zeitüberschreitung in Sekunden. Der Standardwert ist 10. | | Authentifizierung | Bestimmt, welche Art von Authentifizierung für den Endpunkt erforderlich ist. Die Optionen sind: * Vorhandene Anmeldeinformationen in REST-Nachricht verwenden: Verwendet Anmeldeinformationsdefinitionen aus der REST-Nachrichtendefinition. * Mit Anmeldeinformationenfür Standardauthentifizierung überschreiben: Verwendet [Standardauthentifizierung für ausgehende SOAP](https://www.servicenow.com/docs/access?context=t_BasicAuthentication&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US) -Anmeldeinformationen aktivieren, um die Anmeldeinformationen in der REST-Nachrichtendefinition zu überschreiben. Anmeldeinformationen für die Standardauthentifizierung müssen bereitgestellt werden, bevor sie zur Auswahl verfügbar sind. * Mit Anmeldeinformationen für Zertifikatsauthentifizierung überschreiben: Verwendet ein Zertifikat, z. B. einen privaten Key, zum Überschreiben der Anmeldeinformationen in der REST-Nachrichtendefinition. * Mit Anmeldeinformationen für Basic Authentication und Zertifikatsauthentifizierung überschreiben: Verwendet sowohl Anmeldeinformationen der Basic Authentication als auch der Zertifikatauthentifizierung, um die Anmeldeinformationen in der REST-Nachrichtendefinition zu überschreiben. * Mit OAuth-Anmeldeinformationen überschreiben: Verwendet [OAuth 2.0](https://www.servicenow.com/docs/access?context=c_OAuthApplications&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US)-Anmeldeinformationen zum Überschreiben der Anmeldeinformationen in der REST-Nachrichtendefinition. Für die für diese Aktivität ausgewählte REST-Nachricht muss das [OAuth 2.0-Tutorial zum Erstellen einer REST-Nachricht](https://www.servicenow.com/docs/access?context=t_OAuthDemoCreateRESTMessage&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US) auf OAuth 2.0 festgelegt und die [OAuth-Profile und -Bereiche](https://www.servicenow.com/docs/access?context=c_OAuthProviderAndScope&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US) entsprechend konfiguriert sein. {#t_CreateARESTWebServiceActivity__ul_h3y_2sq_vz} | | Akadem. Grade | Erforderliche Anmeldeinformationen für Basic Authentication für den REST-Endpunkt. Dieses Feld ist verfügbar, wenn im Feld Authentifizierung Mit Anmeldeinformationen für Basic Authentication überschreiben ausgewählt ist. In der Auswahlliste werden nur Anmeldeinformationen für Basic Authentication angezeigt, die in der Instanz gespeicherte Anmeldeinformationen und Anmeldeinformations-IDs eines externen Speichersystems umfassen. Wenn Sie Anmeldeinformationen verwenden, die in einem CyberArk-Tresor gespeichert sind, können Sie den in der MID Server-Konfigurationsdatei definierten Standardtresor überschreiben. Details finden Sie unter [Konfigurieren der MID Server für CyberArk](https://www.servicenow.com/docs/access?context=c_CyberArkIntegrationConfiguration&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US). Fügen Sie der Anmeldeinformations-ID den Namen eines anderen Tresors als Präfix getrennt durch einen Doppelpunkt hinzu. Beispielsweise newsafe:orch-test-f5. | | Protokollprofil | Zu verwendende Zertifikatsauthentifizierung. Dieses Feld ist verfügbar, wenn im Feld Authentifizierung entweder Mit Anmeldeinformationen für Zertifikatsauthentifizierung überschreiben oder Mit Anmeldeinformationen für Basic Authentication und Zertifikatsauthentifizierung überschreiben ist. | | OAuth-Profil | Profil für den OAuth-Anbieter für diese REST-Nachricht. Weitere Informationen finden Sie [unter OAuth-Profil angeben](https://www.servicenow.com/docs/access?context=t_SpecifyAnOAuthProfile&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US). | |-|-| {#t_CreateARESTWebServiceActivity__choicetable_g3y_2sq_vz} Hinweis: Sie können Parameterwerte in einem Test-Payload Variablen auf der Registerkarte Ausgaben automatisch zuordnen. Siehe [Ausgabevariablen automatisch zuordnen](https://servicenow-prod.fluidtopics.net/bcqgAOsKVNPv8G1c8hfewg "Sie können Parameterwerte in einem Test-Payload Variablen auf der Registerkarte Ausgaben automatisch zuordnen."). ## Nächste Maßnahme Beenden Sie die Erstellung Ihrer REST-Webservice-Aktivität, [indem Sie Ausgabevariablen](https://servicenow-prod.fluidtopics.net/1Cm~oar0h2frIfYVOqh9jg#t_CreateAnOutputVariable "Das Formular Ausgaben im Designer enthält einen Variablen-Generator zum Erstellen von Datenstrukturen von Objekten und Arrays."), [eine Analyseregel](https://servicenow-prod.fluidtopics.net/_sTVMMro9MLtD_nhs7fmlw#t_CreateAParsingRule "Füllen Sie in einer benutzerdefinierten Aktivität definierte Ausgabevariablen mit Payload-Daten aus, die von einem Eingabetest auf einem externen Host oder Endpunkt zurückgegeben werden.")oder [Bedingungen](https://servicenow-prod.fluidtopics.net/IhQKPxk2KdAt2tPmcUjgQg "Erstellen Sie die Abbruchbedingungen für Ihre Aktivität in der Spalte Bedingung, und legen Sie die Reihenfolge für jede Bedingung fest.")erstellen. Im Thema [Benutzerdefinierte Aktivitäten erstellen](https://servicenow-prod.fluidtopics.net/VIlMbh9w_bkZbqu0ipBH9g "Sie können verschiedene Arten von benutzerdefinierten Aktivitäten mit einer benutzerdefinierten Vorlage im Workflow-Editor erstellen und aktualisieren.") finden Sie Informationen zu den Vorlagenoptionen. ## Automatische Zuordnung von REST-Aktivitätsausgabevariablen {#ariaid-title2} Mit dem ServiceNow-Aktivitätsdesigner können Sie Parameterwerte in einem REST-Test-Payload automatisch Variablen in der Stufe Ausgaben zuordnen. ### Vorbereitungen Erforderliche Rolle: web_service_admin, activity_admin, activity_creator ### Warum und wann dieser Vorgang ausgeführt wird Hinweis: Sie können Eingabevariablen von jeder Stufe des Aktivitätendesigners aus testen, wenn Sie genügend Informationen für Orchestration angegeben haben, um den Endpunkt zu kontaktieren und Daten zurückzugeben. Normalerweise ist die Stufe Ausführungsbefehl der Punkt, an dem Eingaben zum Testen bereit sind. ### Prozedur 1. Fahren Sie im Aktivitätsdesigner mit der Stufe Ausführungsbefehl fort. {#t_AutoMapRESTOutputVariables__s_TestVariableStep1} {#t_AutoMapRESTOutputVariables__s_TestVariableStep1} 2. Definieren Sie bei Bedarf einen geeigneten MID-Server. Der Test schlägt fehl, wenn der MID-Server nicht gefunden wird oder keine Verbindung zum Ziel hergestellt werden kann. {#t_AutoMapRESTOutputVariables__s_TestVariableStep2} {#t_AutoMapRESTOutputVariables__s_TestVariableStep2} 3. Klicken auf Testeingaben, um die Eingabeparameter zu testen. Wenn Sie tatsächliche Werte für die Parameter und Felder hinzugefügt haben, führt das System diese Werte für das angegebene Ziel aus und gibt das resultierende Payload zurück. Wenn Sie den Feldern und Parametern Eingabevariablen zugeordnet haben, zeigt das System ein Dialogfeld an, in dem Sie diesen Variablen Testwerte zuweisen können. 4. Geben Sie ggf. Testwerte an, und klicken Sie auf OK, um das Payload anzuzeigen. Die gesamte Payload wird auf der Registerkarte Rohausgabe des Antwortformulars angezeigt. 5. Wählen Sie eine dieser Optionen für die automatische Zuordnung aus. * Automatisch lokalen Variablen zuordnen: Ordnet Werte direkt einer lokalen Variable zur Verwendung in der Aktivität zu. * Automatisch Ausgabevariablen zuordnen: Ordnet Werte direkt der Ausgabevariable zu, um sie an andere Aktivitäten im Workflow zu übergeben. Durch die automatische Zuordnung zu einer Ausgabevariable wird ein Array mit Objekten erstellt, wobei jedes Objekt die Spaltennamen aus dem Abfrageergebnis enthält. {#t_AutoMapRESTOutputVariables__ul_sfj_bgy_rs} ## Ausführungsparameter für REST-Vorlagen {#ariaid-title3} Sie verwenden Ausführungsparameter, um das Eingabeprozessskript im Formular Vorverarbeitung des Aktivitätendesigners zu erstellen. Beschreibungen der REST-Webservice-Befehlsfelder finden Sie unter [REST-Ausführungsbefehle konfigurieren](https://servicenow-prod.fluidtopics.net/yFArxWY8mD4Fxpa80bptyg#t_MapRESTVariablesToExecutionComm "Verwenden Sie die von Ihnen erstellten Eingabevariablen, um den Befehl zu konfigurieren, den Orchestration auf dem REST-Endpunkt ausführt."). Hinweis: Sie müssen das Präfix `executionParam.` mit allen Variablen in dieser Tabelle verwenden. {#r_RESTTemplateExecutionParameters__table_oyb_xdb_dr__entry__4} | Name | Variable | Typ | Verwendung | |-|-|-|-| | Webservicenachricht | web_service_message | Referenz | Die sys_id der entsprechenden Webservicenachricht | | Webservice-Nachrichtenfunktion | web-service_message_function | Referenz | Die sys_id der REST-Nachrichtenfunktion | | Webservice-Endpunkt | web_service_endpoint | Zeichenfolge | URL des REST-Endpunkts | | Parameters | parameters | Array von JavaScript-Objekten | Array von JavaScript-Objekten, ausgedrückt mit dem Präfix `executionParam.`. Anweisungen zum Erstellen von Arrays mit diesem Parameter finden Sie unter [JavaScript-Arrays in REST-Vorlagen erstellen](https://servicenow-prod.fluidtopics.net/yFArxWY8mD4Fxpa80bptyg#t_CrtJvScrArrRTemplate "Dies sind Anweisungen zum Erstellen von JavaScript-Arrays mit REST-Ausführungsparametern."). | | MID Server verwenden | use_mid_server | Boolesch | Legt fest, ob der MID-Server verwendet werden soll oder nicht. Mit dem Wert wahr wird der MID-Server verwendet, und mit dem Wert falsch wird der MID-Server nicht verwendet. | | MidCapabilities | midCapabilities | Zeichenfolge (durch Kommas getrennt) | Liste der Referenzen für die erforderlichen MID Server-Fähigkeiten | | Time out | time-out | Zeichenfolge | Zulässige Dauer der Zeitüberschreitung, ausgedrückt in Sekunden | | ValueCapabilities | valueCapabilities | Hashmap-Array | Fähigkeitswerte zur Auswahl des MID Servers. Weitere Informationen finden Sie unter [MID Server-Fähigkeiten](https://www.servicenow.com/docs/access?context=t_ConfigureCapabilities&version=xanadu&pubname=xanadu-servicenow-platform§ion=r_MIDServerCapabilities&ft:locale=en-US). Verwenden Sie dieses Beispiel, um die Auswahl des MID Servers anzupassen, wenn zusätzliche Fähigkeiten nach Wert zugewiesen werden: var valueCapability = {'NEW_MID_CAPABIILTY':'NEW_MID_CAPABILITY_VALUE'}; executionParam.valueCapabilities.push(valueCapability); | | Auth Type | auth-type | Boolesch | Typ der zu verwendenden Anmeldeinformationen. Die Auswahlmöglichkeiten sind: * basic_auth_pick_credentials * use_existing_credentials {#r_RESTTemplateExecutionParameters__ul_r1q_t2b_dr} | | Berechtigungen | credentials | Referenz | Enthält die Anmeldeinformationen, die für diese REST-Nachricht verwendet werden sollen, wenn auth_type basic_auth_pick_credentials ist. | [Tabelle : 1. Ausführungsparameter für REST-Vorlagen] {#r_RESTTemplateExecutionParameters__table_oyb_xdb_dr} ## JavaScript-Arrays in REST-Vorlagen erstellen {#ariaid-title4} Dies sind Anweisungen zum Erstellen von JavaScript-Arrays mit REST-Ausführungsparametern. ### Vorbereitungen Erforderliche Rolle: web_service_admin, activity_admin, activity_creator ### Warum und wann dieser Vorgang ausgeführt wird Um dem Parameter-Array weitere Name-Wert-Paare hinzuzufügen, hängen Sie die Werte an das vorhandene Array an. ### Prozedur 1. Erstellen Sie ein JavaScript-Objekt mit der folgenden Syntax, und fügen Sie es dem Array `executionParam.parameter` hinzu: var newParameter = {"name":"parameterName","value":"parameterValue","additional_attribute":"none"}; executionParam.parameters.push(newParameter); Durch das Hinzufügen des neuen JavaScript-Objekts zu dem Array stellen Sie sicher, dass alle bereits im Array verfügbaren Elemente nicht betroffen werden. 2. Legen Sie den Wert in der Spalte Zusätzliches Attribut im Eingabefeld REST-Nachrichtenparameter auf Do not escape text fest. In diesem Fall versieht das System den für das Attribut value angegebenen Wert nicht mit Escape-Zeichen. Ein Beispiel dafür ist: var newParameter = {"name":"parameterName","value":"parameterValue","additional_attribute":"do_not_escape_text"}; executionParam.parameters.push(newParameter); Hinweis: Wenn der Wert für das Feld Zusätzliches Attribut None lautet, dann versieht das System den durch das Attribut value angegebenen Wert mit Escape-Zeichen. Im ersten Beispiel wird `parameterValue` mit Escape-Zeichen versehen. {#t_CrtJvScrArrRTemplate__steps_vvs_vfb_dr} ## Nachverarbeitungsparameter für REST-Vorlagen {#ariaid-title5} Verwenden Sie diese Parameter, um ein Nachverarbeitungsskript zu erstellen. {#r_RTmpltPstPPrm__table_wsp_kjt_cr__entry__4} | Name | Variable | Typ | Verwendung | |-|-|-|-| | Status code | status_code | Ganzzahl | Enthält den vom REST-Webservice zurückgegebenen Statuscode | | Header | header | Hashmap eines JavaScript-Objekts | Hashmap mit den Key-Wert-Paaren, die den an den Webservice übergebenen Headerwerten zugeordnet ist. Sie können auf jeden Wert mit `executionResult.header[keyName]` zugreifen. | | Body | body | Zeichenfolge | Enthält einen Zeichenfolgewert, der die Ausgabe der REST-Nachricht darstellt | | Error | error | Zeichenfolge | Gibt die Fehlerzeichenfolge vom REST-Webservice zurück, außer es liegen keine Fehler vor. In diesem Fall wird null zurückgegeben. | [Tabelle : 2. Nachverarbeitungsparameter des Aktivitätendesigners] {#r_RTmpltPstPPrm__table_wsp_kjt_cr} ## REST-Ausführungsbefehle konfigurieren {#ariaid-title6} Verwenden Sie die von Ihnen erstellten Eingabevariablen, um den Befehl zu konfigurieren, den Orchestration auf dem REST-Endpunkt ausführt. ### Vorbereitungen Erstellen Sie im Formular Eingaben die benötigten Eingabevariablen, bevor Sie mit der Stufe Ausführungsbefehl fortfahren. Erforderliche Rolle: web_service_admin, activity_admin, activity_creator Hinweis: Sie können die REST-Verbindung zwischen dem MID Server und dem Endpunkt testen, ohne die Aktivität in einem Workflow-Kontext ausführen zu müssen. Details dazu finden Sie unter [Vorlagenausgaben testen](https://servicenow-prod.fluidtopics.net/MQCgLHhx1MwbZDixCnzx6w#test-template-inputs "Sie können die Eingabeparameter einer benutzerdefinierten Aktivität während der Entwicklung testen, ohne die Aktivität in einem Workflow-Kontext ausführen zu müssen."). ### Prozedur 1. Ziehen Sie Variablen aus der Liste der Eingaben, und legen Sie sie in den Befehlsfeldern ab. Das System formatiert die Variablen in der richtigen Syntax für den Befehl. Abbildung : 1. REST-Ausführungsbefehl 2. Füllen Sie die in der Tabelle angegebenen Felder aus. {#t_MapRESTVariablesToExecutionComm__table_bmf_m1b_dr__entry__2} | Feld | Beschreibung | |-|-| | Eingabe | Generator für Eingabevariablen. [Eingabevariablen erstellen](https://servicenow-prod.fluidtopics.net/MQCgLHhx1MwbZDixCnzx6w#CreateInputVariables "Erstellen Sie im Formular Eingaben des Aktivitätendesigners die Variablen, die an die Aktivität übergeben werden sollen."), um sie verfügbaren Feldern zuzuordnen. | | REST-Nachricht | Name einer vorhandenen REST-Nachricht, die in dieser Aktivität verwendet werden soll Benutzer müssen über die Rolle web_service_admin verfügen, um dieses Feld konfigurieren zu können. | | REST-Nachrichtenfunktion | REST-Nachrichtenfunktion für diese Aktivität Benutzer müssen über die Rolle web_service_admin verfügen, um dieses Feld konfigurieren zu können. | | Endpunkt | Endpunkt-URL für den von dieser Aktivität verwendeten REST-Webservice. Geben Sie einen Endpunkt in dieses Feld ein, um den in der REST-Nachricht konfigurierten Endpunkt zu überschreiben. Klicken Sie auf das Schlosssymbol, um das Eingabefeld zu öffnen. | | Variablensubstitutionen | Name-Wert-Paare, die an den REST-Endpunkt übergeben werden sollen. Sie können diese Parameter manuell erstellen oder Eingabevariablen in die Parameterfelder ziehen und dann einen Wert zuweisen. Parametern, die in der REST-Nachricht definiert sind und ${} verwenden, können Daten aus dieser Aktivitätsvorlage zugewiesen werden. Verwenden Sie die Spalte Zusätzliches Attribut, um das System so zu konfigurieren, dass der Text nicht mit Escape-Zeichen versehen wird. Der an die REST-Nachricht gesendete Text wird standardmäßig mit Escape-Zeichen versehen. Die Spalte „ Name " wird automatisch ausgefüllt, wenn die Benutzer Variablen mithilfe der [Variablenersetzung in ausgehenden REST-Nachrichten](https://www.servicenow.com/docs/access?context=c_VariableSubstitutionREST&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US) in der REST-Nachricht bereitgestellt haben. | | Zusätzliche Header | Zusätzliche HTTP-Headerparameter für die ausgewählte REST-Nachricht. Sie können diese Werte auch verwenden, um Parameter zu überschreiben, die von der REST-Nachricht geerbt wurden. | | Zusätzliche Abfrageparameter | Zusätzliche Abfrageparameter für die ausgewählte REST-Nachricht. Sie können diese Werte auch verwenden, um Parameter zu überschreiben, die von der REST-Nachricht geerbt wurden. | | MID Server verwenden | Kontrollkästchen, das festlegt, ob ein MID Server zum Aufrufen des REST-Webservice verwendet werden muss. Hinweis: Wenn die REST-Webservice-Nachrichtenfunktion einen MID Server definiert, wird dieser MID Server anstelle des hier ausgewählten verwendet. | | Erforderliche MID Server-Fähigkeiten | MID-Server mit den entsprechenden [MID-Server-Fähigkeiten](https://www.servicenow.com/docs/access?context=t_ConfigureCapabilities&version=xanadu&pubname=xanadu-servicenow-platform§ion=r_MIDServerCapabilities&ft:locale=en-US) für die Verbindung mit dem REST-Endpunkt. Standardmäßig wählt das System einen MID Server mit REST-Fähigkeiten aus. Dieses Feld ist verfügbar, wenn die Checkbox MID-Server verwenden aktiviert ist. | | Zeitüberschreitung | Zulässige Dauer der REST-Webserviceanforderung vor der Zeitüberschreitung in Sekunden. Der Standardwert ist 10. | | Authentifizierung | Bestimmt, welche Art von Authentifizierung für den Endpunkt erforderlich ist. Die Optionen sind: * Vorhandene Anmeldeinformationen in REST-Nachricht verwenden: Verwendet Anmeldeinformationsdefinitionen aus der REST-Nachrichtendefinition. * Mit Anmeldeinformationenfür Standardauthentifizierung überschreiben: Verwendet [Standardauthentifizierung für ausgehende SOAP](https://www.servicenow.com/docs/access?context=t_BasicAuthentication&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US) -Anmeldeinformationen aktivieren, um die Anmeldeinformationen in der REST-Nachrichtendefinition zu überschreiben. Anmeldeinformationen für die Standardauthentifizierung müssen bereitgestellt werden, bevor sie zur Auswahl verfügbar sind. * Mit Anmeldeinformationen für Zertifikatsauthentifizierung überschreiben: Verwendet ein Zertifikat, z. B. einen privaten Key, zum Überschreiben der Anmeldeinformationen in der REST-Nachrichtendefinition. * Mit Anmeldeinformationen für Basic Authentication und Zertifikatsauthentifizierung überschreiben: Verwendet sowohl Anmeldeinformationen der Basic Authentication als auch der Zertifikatauthentifizierung, um die Anmeldeinformationen in der REST-Nachrichtendefinition zu überschreiben. * Mit OAuth-Anmeldeinformationen überschreiben: Verwendet [OAuth 2.0](https://www.servicenow.com/docs/access?context=c_OAuthApplications&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US)-Anmeldeinformationen zum Überschreiben der Anmeldeinformationen in der REST-Nachrichtendefinition. Für die für diese Aktivität ausgewählte REST-Nachricht muss das [OAuth 2.0-Tutorial zum Erstellen einer REST-Nachricht](https://www.servicenow.com/docs/access?context=t_OAuthDemoCreateRESTMessage&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US) auf OAuth 2.0 festgelegt und die [OAuth-Profile und -Bereiche](https://www.servicenow.com/docs/access?context=c_OAuthProviderAndScope&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US) entsprechend konfiguriert sein. {#t_MapRESTVariablesToExecutionComm__ul_hj2_b5n_cr} | | Akadem. Grade | Erforderliche Anmeldeinformationen für Basic Authentication für den REST-Endpunkt. Dieses Feld ist verfügbar, wenn im Feld Authentifizierung Mit Anmeldeinformationen für Basic Authentication überschreiben ausgewählt ist. In der Auswahlliste werden nur Anmeldeinformationen für die Standardauthentifizierung angezeigt, die in der Instanz gespeicherte Anmeldeinformationen und Anmeldeinformations-IDs eines externen Speichersystems umfassen. Wenn Sie Anmeldeinformationen verwenden, die in einem CyberArk-Safe gespeichert sind, können Sie die [Option MID-Server für CyberArk](https://www.servicenow.com/docs/access?context=t_ConfigureTheMIDServerForCyberArk&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US) konfigurieren überschreiben, die in der MID-Server-Konfigurationsdatei definiert ist, indem Sie den Namen eines anderen Safes als Präfix der Anmeldeinformations-ID hinzufügen, getrennt durch einen Doppelpunkt. Zum Beispiel newsafe:orch-test-f5. | | Protokollprofil | Zu verwendende Zertifikatsauthentifizierung. Dieses Feld ist verfügbar, wenn im Feld Authentifizierung entweder Mit Anmeldeinformationen für Zertifikatsauthentifizierung überschreiben oder Mit Anmeldeinformationen für Basic Authentication und Zertifikatsauthentifizierung überschreiben ist. | | OAuth-Profil | Profil für den OAuth-Anbieter für diese REST-Nachricht. Weitere Informationen finden Sie [unter OAuth-Profil angeben](https://www.servicenow.com/docs/access?context=t_SpecifyAnOAuthProfile&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US). | [Tabelle : 3. Felder für den REST-Ausführungsbefehl] {#t_MapRESTVariablesToExecutionComm__table_bmf_m1b_dr} 3. Klicken Sie auf Speichern. 4. Klicken Sie auf Fortsetzen, um mit der Stufe Ausgaben fortzufahren. {#t_MapRESTVariablesToExecutionComm__steps_l14_5sf_s5}