--- sourceDocument: Yokohama Now Platform-Fähigkeiten sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/yokohama/servicenow-platform Release : - yokohama ft:locale : - de-DE ft:publication_title : - Yokohama Now Platform-Fähigkeiten ft:clusterId : - platcap bundleId : - platcap workflow : - Platform --- # Erstellen Sie eine REST-Webservice-Aktivität # Erstellen Sie eine REST-Webservice-Aktivität {#ariaid-title1} * Freigeben Version: Yokohama * * Aktualisiert 30. Januar 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 11 Minuten Lesedauer Verwenden Sie dieses Verfahren, um einen anwenderdefinierten REST-Webservice zu erstellen OrchestrationAktivität. ## Vorbereitungen Erforderliche Rolle: Web_Service_admin, activity_admin, activity_creator ## Warum und wann dieser Vorgang ausgeführt wird So erstellen und verwenden Sie eine REST-Webservice-Workflow-Aktivität: * Erstellen Sie ein [Erstellen Sie eine REST-Nachricht](https://www.servicenow.com/docs/access?context=t_ConfiguringARESTMessage&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)Wenn noch kein entsprechender konfiguriert ist. * Weisen Sie die Rolle „Web_Service_admin" jedem Anwender zu, der eine anwenderdefinierte REST-Aktivität erstellen oder bearbeiten muss. * Bestimmen Sie eine Anwendung, oder [Anwendungsbereich](https://www.servicenow.com/docs/access?context=c_ApplicationScope&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US), Für diese Aktivität. * Bestimmen Sie [Erstellen Sie eine REST-Nachricht](https://www.servicenow.com/docs/access?context=t_ConfiguringARESTMessage&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)Für die Aktivität zu verwenden. Verwenden Sie diesen Wert, um den in der REST-Nachricht konfigurierten Endpunkt zu überschreiben. * Erstellen Sie optional [Anmeldeinformationen für Standardauthentifizierung](https://www.servicenow.com/docs/access?context=r_BasicAuthCredentialsForm&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US). Verwenden Sie diesen Wert, um die in der SOAP-Nachricht konfigurierten Anmeldeinformationen zu überschreiben. {#t_CreateARESTWebServiceActivity__ul_fqx_dt1_dr} ## Prozedur 1. Erstellen Sie ein [Anwenderdefinierte Aktivität](https://www.servicenow.com/docs/access?context=create-custom-activities&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US). Mit dieser Aktion wird eine anwenderdefinierte Aktivität mithilfe einer Vorlage erstellt. 2. Nach dem Einrichten [Allgemeine Eigenschaften](https://www.servicenow.com/docs/8Cpdry0JcigvvNih0vX2DQ "Die folgenden Felder für allgemeine Eigenschaften sind allen Aktivitätendesigner-Vorlagen gemeinsam.")Und [Eingabevariablen werden erstellt](https://www.servicenow.com/docs/U7vfL6CjuCzOMbAvRE5jqQ#CreateInputVariables "Erstellen Sie die Variablen, die an die Aktivität in übergeben werden sollen Eingaben Formular des Aktivitätendesigners."), Konfigurieren Sie den REST-Webservice-Ausführungsbefehl. | Option | Bezeichnung | | [Ordnen Sie die Eingabevariablen zu](https://www.servicenow.com/docs/U7vfL6CjuCzOMbAvRE5jqQ#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, die für diese Aktivität verwendet werden soll. | | Endpunkt | Endpunkt-URL für den REST-Webservice, den diese Aktivität verwendet. Geben Sie einen Endpunkt in dieses Feld ein, um den in der REST-Nachricht konfigurierten Endpunkt zu überschreiben. Klicken Sie auf die Sperre, um das Eingabefeld zu öffnen. | | Variablenersetzungen | 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. Parameter, die in der verwendeten REST-Nachricht definiert sind ${} Können Daten aus dieser Aktivitätsvorlage zugewiesen werden. Verwenden Sie Zusätzliches Attribut Spalte, um das System so zu konfigurieren, dass der Text nicht mit einem Escape-Zeichen versehen wird. Standardmäßig wird der an die REST-Nachricht gesendete Text mit Escape-Zeichen versehen. Wenn die Anwender Variablen mit angegeben haben [Variablenersetzung in ausgehenden REST-Nachrichten](https://www.servicenow.com/docs/access?context=c_VariableSubstitutionREST&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)In der REST-Nachricht dann Name Spalte wird automatisch ausgefüllt. | | Zusätzliche Header | Zusätzliche HTTP-Header-Parameter 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 bestimmt, ob ein MID-Server zum Aufrufen des REST-Webservice verwendet werden soll. Hinweis: Wenn die REST-Webservice-Nachrichtenfunktion einen MID-Server definiert, wird dieser MID-Server anstelle des hier ausgewählten Servers verwendet. | | Erforderliche MID-Serverfähigkeiten | MID-Server mit entsprechendem [MID-Serverfähigkeiten](https://www.servicenow.com/docs/pCP7ZnBZ56O_vTYXSOcgeA "MID-Server-Funktionen definieren die speziellen Funktionen eines MID-Servers innerhalb des Bereichs einer IP-Adresse.")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 Verwenden Sie den MID-Server Kontrollkästchen ist aktiviert. | | Zeitüberschreitung | Zulässige Dauer der REST-Webserviceanforderung vor 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. * Überschreiben Sie mit Anmeldeinformationen für die Standardauthentifizierung : Verwendet [Aktivieren Sie die Standardauthentifizierung für ausgehende SOAP](https://www.servicenow.com/docs/access?context=t_BasicAuthentication&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)Anmeldeinformationen zum Überschreiben der Anmeldeinformationen in der REST-Nachrichtendefinition. Anmeldeinformationen für die Standardauthentifizierung müssen bereitgestellt werden, bevor sie zur Auswahl verfügbar sind. * Überschreiben Sie mit Anmeldeinformationen für die Zertifikatauthentifizierung : Verwendet ein Zertifikat, z. B. einen privaten Schlüssel, um die Anmeldeinformationen in der REST-Nachrichtendefinition zu überschreiben. * Überschreiben Sie mit Anmeldeinformationen für Standard- und Zertifikatauthentifizierung : Verwendet sowohl die Standardauthentifizierung als auch die Zertifikatauthentifizierung, um die Anmeldeinformationen in der REST-Nachrichtendefinition zu überschreiben. * Überschreiben Sie mit Anmeldeinformationen für die OAuth-Authentifizierung : Verwendet [OAuth 2,0](https://www.servicenow.com/docs/access?context=c_OAuthApplications&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US)Anmeldeinformationen zum Überschreiben der Anmeldeinformationen in der REST-Nachrichtendefinition. Die für diese Aktivität ausgewählte REST-Nachricht muss Folgendes haben [OAuth 2,0-Tutorial: Erstellen Sie eine REST-Nachricht](https://www.servicenow.com/docs/access?context=t_OAuthDemoCreateRESTMessage&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)Auf festlegen OAuth 2,0 Und ist [OAuth-Profile und -Umfänge](https://www.servicenow.com/docs/access?context=c_OAuthProviderAndScope&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)Entsprechend konfiguriert. {#t_CreateARESTWebServiceActivity__ul_h3y_2sq_vz} | | Anmeldeinformationen | Erforderliche Anmeldeinformationen für Standardauthentifizierung des REST-Endpunkts. Dieses Feld ist verfügbar, wenn Überschreiben Sie mit Anmeldeinformationen für die Standardauthentifizierung Ist in ausgewählt Authentifizierung Feld. Nur Anmeldeinformationen für Standardauthentifizierung werden in der Auswahlliste angezeigt, die Anmeldeinformationen enthält, die in der Instanz gespeichert sind, und Anmeldeinformations-IDs aus einem externen Speichersystem. Wenn Sie Anmeldeinformationen verwenden, die in einem CyberArk Safe gespeichert sind, können Sie den in der MID-Server-Konfigurationsdatei definierten Standardsafe überschreiben. Siehe [Konfigurieren Sie den MID-Server für CyberArk](https://www.servicenow.com/docs/access?context=c_CyberArkIntegrationConfiguration&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US)Für Details. Fügen Sie der Anmeldeinformations-ID den Namen eines anderen Safe als Präfix hinzu, getrennt durch einen Doppelpunkt. Beispiel: newsafe:orch-test-f5. | | Protokollprofil | Zu verwendende Zertifikatauthentifizierung. Dieses Feld ist verfügbar, wenn die Auswahl in Authentifizierung Sind beide Überschreiben Sie mit Anmeldeinformationen für die Zertifikatauthentifizierung Oder Überschreiben Sie mit Anmeldeinformationen für Standard- und Zertifikatauthentifizierung . | | OAuth-Profil | Profil für den OAuth-Anbieter für diese REST-Nachricht. Siehe [Geben Sie ein OAuth-Profil an](https://www.servicenow.com/docs/access?context=t_SpecifyAnOAuthProfile&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)Für weitere Informationen. | |-|-| {#t_CreateARESTWebServiceActivity__choicetable_g3y_2sq_vz} Hinweis: Sie können Parameterwerte in einer Testnutzlast Variablen in zuordnen Ausgaben Automatisch Registerkarte. Siehe [Ausgabevariablen automatisch zuordnen](https://www.servicenow.com/docs/fbiAVF1nogc9VkrQ4~1qxg "Sie können Parameterwerte in einer Testnutzlast Variablen in zuordnen Ausgaben Automatisch Registerkarte."). ## Nächste Maßnahme Schließen Sie die Erstellung Ihrer Rest-Webservice-Aktivität bis ab [Ausgabevariablen werden erstellt](https://www.servicenow.com/docs/myRMeyEjy_Cb2DMZXui10w#t_CreateAnOutputVariable "Die Ausgaben Das Formular im Designer enthält einen Variablengenerator zum Erstellen von Datenstrukturen von Objekten und Arrays."), [Analyseregel wird erstellt](https://www.servicenow.com/docs/R24VxietU8S3QGRZ7e0GWw#t_CreateAParsingRule "Füllen Sie Ausgabevariablen, die in einer anwenderdefinierten Aktivität definiert sind, mit Nutzlastdaten aus, die von einem Eingabetest auf einem externen Host oder Endpunkt zurückgegeben werden."), Oder [Bedingungen](https://www.servicenow.com/docs/access?context=conditions&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US). Weitere Informationen finden Sie unter [Erstellen Sie anwenderdefinierte Aktivitäten](https://www.servicenow.com/docs/FmCtYTSeHrZqiRgyQ0gqhQ "Sie können verschiedene Arten von anwenderdefinierten Aktivitäten im Workflow-Editor mithilfe einer anwenderdefinierten Vorlage erstellen und aktualisieren.")Thema, um Ihre Vorlagenoptionen zu erfahren. ## REST-Aktivitätsausgabevariablen automatisch zuordnen {#ariaid-title2} Die ServiceNowMit dem Aktivitäts-Designer können Sie Parameterwerte in einer REST-Testnutzlast Variablen in zuordnen Ausgaben Phase automatisch. ### Vorbereitungen Erforderliche Rolle: Web_Service_admin, activity_admin, activity_creator ### Warum und wann dieser Vorgang ausgeführt wird Hinweis: Sie können Eingabevariablen aus jeder Phase im Aktivitätendesigner testen, wenn Sie genügend Informationen für die Orchestration bereitgestellt haben, um den Endpunkt zu kontaktieren und Daten zurückzugeben. In der Regel wird Ausführungsbefehl Phase ist der Punkt, an dem Ihre Eingaben zum Testen bereit sind. ### Prozedur 1. Fahren Sie im Aktivitätendesigner mit fort Ausführungsbefehl Phase. {#t_AutoMapRESTOutputVariables__s_TestVariableStep1} {#t_AutoMapRESTOutputVariables__s_TestVariableStep1} 2. Definieren Sie bei Bedarf einen entsprechenden MID-Server. Der Test schlägt fehl, wenn der MID-Server nicht gefunden werden kann oder wenn er keine Verbindung zum Ziel herstellen kann. {#t_AutoMapRESTOutputVariables__s_TestVariableStep2} {#t_AutoMapRESTOutputVariables__s_TestVariableStep2} 3. Klicken Sie Auf Testaktivität Zum Testen der Eingabeparameter. 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 die resultierende Nutzlast zurück. Wenn Sie Eingabevariablen Feldern und Parametern zugeordnet haben, zeigt das System ein Dialogfeld zum Zuweisen von Testwerten zu diesen Variablen an. 4. Geben Sie Testwerte an, falls angefordert, und klicken Sie auf OK Zum Anzeigen der Nutzlast. Die gesamte Nutzlast wird in angezeigt Rohausgabe Registerkarte des Antwortformulars. 5. Wählen Sie eine dieser Optionen für die automatische Zuordnung aus. * Automatisch lokal zuordnen : Ordnet Werte direkt einer lokalen Variable zur Verwendung innerhalb der Aktivität zu. * Automatisch der Ausgabe zuordnen : Ordnet der Ausgabevariablen Werte direkt Werte zu, um sie an andere Aktivitäten im Workflow zu übergeben. Durch die automatische Zuordnung zu einer Ausgabevariable wird ein Array von Objekten erstellt, die jeweils die Spaltennamen aus dem Abfrageergebnis enthalten. {#t_AutoMapRESTOutputVariables__ul_sfj_bgy_rs} ## REST-Vorlagenausführungsparameter {#ariaid-title3} Sie verwenden Ausführungsparameter, um das Eingabeprozessskript in zu erstellen Vorverarbeitung Formular des Aktivitätendesigners. Beschreibungen der REST-Webservice-Befehlsfelder finden Sie unter [Konfigurieren Sie den REST-Ausführungsbefehl](https://www.servicenow.com/docs/xIwpG~24CNesvQfOr9O7Qg#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 verwenden `ExecutionParameter. `Präfix mit allen Variablen in dieser Tabelle. {#r_RESTTemplateExecutionParameters__table_oyb_xdb_dr__entry__4} | Name | Variable | Typ | Nutzung | |-|-|-|-| | 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. | | Parameter | parameters | Array von JavaScript-Objekten | Array von JavaScript-Objekten, ausgedrückt mit `ExecutionParameter. `Präfix. Anweisungen zum Erstellen von Arrays mit diesem Parameter finden Sie unter [Erstellen Sie ein JavaScript-Array in einer REST-Vorlage](https://www.servicenow.com/docs/xIwpG~24CNesvQfOr9O7Qg#t_CrtJvScrArrRTemplate "Dies sind Anweisungen zum Erstellen von JavaScript-Arrays mit REST-Ausführungsparametern."). | | Mid-Server verwenden | use_mid_server | Boolean | Wählt aus, ob der MID-Server verwendet werden soll. Ein Wert von Wahr Verwendet den MID-Server und einen Wert von Falsch Verwendet nicht den MID-Server. | | MidCapabilities | MidCapabilities | Zeichenfolge (kommagetrennt) | Liste der Verweise auf erforderliche MID-Serverfähigkeiten. | | Zeitüberschreitung | Zeitüberschreitung | Zeichenfolge | Zulässige Zeitüberschreitungsdauer, ausgedrückt in Sekunden. | | Wertfähigkeiten | Wertfähigkeiten | Array von Hashmap | Fähigkeitswerte, die zum Auswählen des MID-Servers verwendet werden. Weitere Informationen finden Sie unter [MID-Serverfähigkeiten](https://www.servicenow.com/docs/pCP7ZnBZ56O_vTYXSOcgeA "MID-Server-Funktionen definieren die speziellen Funktionen eines MID-Servers innerhalb des Bereichs einer IP-Adresse."). Verwenden Sie dieses Beispiel, um die MID-Serverauswahl anzupassen, wenn zusätzliche Fähigkeiten vorhanden sind, die nach Wert zugewiesen werden: var valueCapability = {'NEW_MID_CAPABIILTY':'NEW_MID_CAPABILITY_VALUE'}; executionParam.valueCapabilities.push(valueCapability); | | Auth.typ | Auth-type | Boolean | Typ der zu verwendenden Anmeldeinformationen. Die Auswahlmöglichkeiten sind: * basic_auth_pick_credentials * Use_existing_credentials {#r_RESTTemplateExecutionParameters__ul_r1q_t2b_dr} | | Anmeldeinformationen | Anmeldeinformationen | Referenz | Enthält die Anmeldeinformationen, die für diese REST-Nachricht verwendet werden sollen, wenn Auth_type Ausgewählt ist basic_auth_pick_credentials . | [Tabelle : 1. REST-Vorlagenausführungsparameter] {#r_RESTTemplateExecutionParameters__table_oyb_xdb_dr} ## Erstellen Sie ein JavaScript-Array in einer REST-Vorlage {#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 Array des Parameters weitere Name-Wert-Paare hinzuzufügen, fügen Sie die Werte dem vorhandenen Array an. ### Prozedur 1. Erstellen Sie ein JavaScript-Objekt mit der folgenden Syntax, und fügen Sie es zu hinzu `ExecutionParam.Parameter `Array: var newParameter = {"name":"parameterName","value":"parameterValue","additional_attribute":"none"}; executionParam.parameters.push(newParameter); Durch Hinzufügen des neuen Parameter-JavaScript-Objekts zum Array stellen Sie sicher, dass alle Elemente, die bereits im Array verfügbar sind, nicht betroffen sind. 2. Stellen Sie sicher, dass Sie den Wert in festlegen Zusätzliches Attribut Spalte in REST-Nachrichtenparameter Eingabefeld bis Text nicht mit Escape-Zeichen versehen . In diesem Fall weist das System den für angegebenen Wert nicht mit einem Escape-Zeichen auf Wert Attribut. Ein Beispiel hierfür ist: var newParameter = {"name":"parameterName","value":"parameterValue","additional_attribute":"do_not_escape_text"}; executionParam.parameters.push(newParameter); Hinweis: Wenn der Wert für Additional_Attribute Feld ist Keine , Wird dann vom System der von angegebene Wert mit Escape-Zeichen versehen Wert Attribut. Im ersten Beispiel `ParameterWert `Ist mit Escape versehen. {#t_CrtJvScrArrRTemplate__steps_vvs_vfb_dr} ## Nachverarbeitungsparameter der REST-Vorlage {#ariaid-title5} Verwenden Sie diese Parameter, um ein Nachverarbeitungsskript zu erstellen. {#r_RTmpltPstPPrm__table_wsp_kjt_cr__entry__4} | Name | Variable | Typ | Nutzung | |-|-|-|-| | Statuscode | status_code | Ganzzahl | Enthält den Statuscode, der vom REST-Webservice zurückgegeben wird. | | Header | header | Hashmap des JavaScript-Objekts | Hashmap von Schlüssel-Wert-Paaren, die den an den Webservice übergebenen Headerwerten zugeordnet sind. Sie können mit auf jeden Wert zugreifen `ExecutionResult.Header[Schlüsselname] `. | | Textkörper | body | Zeichenfolge | Enthält einen Zeichenfolgenwert, der die Ausgabe der REST-Nachricht darstellt | | Fehler | Fehler | Zeichenfolge | Gibt die Fehlerzeichenfolge vom REST-Webservice zurück, es sei denn, es liegen keine Fehler vor. In diesem Fall wird die Zeichenfolge zurückgegeben Null . | [Tabelle : 2. Nachverarbeitungsparameter des Aktivitätendesigners] {#r_RTmpltPstPPrm__table_wsp_kjt_cr} ## Konfigurieren Sie den REST-Ausführungsbefehl {#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 die Eingabevariablen, die Sie benötigen, in Eingaben Formular, bevor Sie mit fortfahren können Ausführungsbefehl Phase. 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. Weitere Informationen finden Sie unter [Testvorlagenausgaben](https://www.servicenow.com/docs/U7vfL6CjuCzOMbAvRE5jqQ#test-template-inputs "Sie können die Eingabeparameter einer anwenderdefinierten Aktivität während ihrer 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 Befehlsfelder ab. Das System formatiert die Variable in der richtigen Syntax für den Befehl. Abbildung : 1. REST-Ausführung Befehl 2. Füllen Sie die in der Tabelle angezeigten Felder aus. {#t_MapRESTVariablesToExecutionComm__table_bmf_m1b_dr__entry__2} | Feld | Beschreibung | |-|-| | Eingabe | Eingabevariablengenerator. [Erstellen Sie Eingabevariablen](https://www.servicenow.com/docs/U7vfL6CjuCzOMbAvRE5jqQ#CreateInputVariables "Erstellen Sie die Variablen, die an die Aktivität in übergeben werden sollen Eingaben Formular des Aktivitätendesigners.")Zum Zuordnen zu verfügbaren Feldern. | | REST-Nachricht | Name einer vorhandenen REST-Nachricht, die in dieser Aktivität verwendet werden soll. Anwender müssen über die Rolle „Web_Service_admin" verfügen, um dieses Feld zu konfigurieren. | | REST-Nachrichtenfunktion | REST-Nachrichtenfunktion, die für diese Aktivität verwendet werden soll. Anwender müssen über die Rolle „Web_Service_admin" verfügen, um dieses Feld zu konfigurieren. | | Endpunkt | Endpunkt-URL für den REST-Webservice, den diese Aktivität verwendet. Geben Sie einen Endpunkt in dieses Feld ein, um den in der REST-Nachricht konfigurierten Endpunkt zu überschreiben. Klicken Sie auf die Sperre, um das Eingabefeld zu öffnen. | | Variablenersetzungen | Name-Wert-Paare, die an den REST-Endpunkt übergeben werden sollen. Sie können diese Parameter manuell erstellen oder Eingabevariablen per Drag-and-Drop in die Parameterfelder ziehen und dann einen Wert zuweisen. Parameter, die in der verwendeten REST-Nachricht definiert sind ${} Können Daten aus dieser Aktivitätsvorlage zugewiesen werden. Verwenden Sie Zusätzliches Attribut Spalte, um das System so zu konfigurieren, dass der Text nicht mit einem Escape-Zeichen versehen wird. Standardmäßig wird der an die REST-Nachricht gesendete Text mit Escape-Zeichen versehen. Die Name Spalte wird automatisch ausgefüllt, wenn die Anwender Variablen mit angegeben haben [Variablenersetzung in ausgehenden REST-Nachrichten](https://www.servicenow.com/docs/access?context=c_VariableSubstitutionREST&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)In der REST-Nachricht. | | Zusätzliche Header | Zusätzliche HTTP-Header-Parameter 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 bestimmt, ob ein MID-Server zum Aufrufen des REST-Webservice verwendet werden soll. Hinweis: Wenn die REST-Webservice-Nachrichtenfunktion einen MID-Server definiert, wird dieser MID-Server anstelle des hier ausgewählten Servers verwendet. | | Erforderliche MID-Serverfähigkeiten | MID-Server mit entsprechendem [MID-Serverfähigkeiten](https://www.servicenow.com/docs/pCP7ZnBZ56O_vTYXSOcgeA "MID-Server-Funktionen definieren die speziellen Funktionen eines MID-Servers innerhalb des Bereichs einer IP-Adresse.")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 Verwenden Sie den MID-Server Kontrollkästchen ist aktiviert. | | Zeitüberschreitung | Zulässige Dauer der REST-Webserviceanforderung vor 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. * Überschreiben Sie mit Anmeldeinformationen für die Standardauthentifizierung : Verwendet [Aktivieren Sie die Standardauthentifizierung für ausgehende SOAP](https://www.servicenow.com/docs/access?context=t_BasicAuthentication&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)Anmeldeinformationen zum Überschreiben der Anmeldeinformationen in der REST-Nachrichtendefinition. Anmeldeinformationen für die Standardauthentifizierung müssen bereitgestellt werden, bevor sie zur Auswahl verfügbar sind. * Überschreiben Sie mit Anmeldeinformationen für die Zertifikatauthentifizierung : Verwendet ein Zertifikat, z. B. einen privaten Schlüssel, um die Anmeldeinformationen in der REST-Nachrichtendefinition zu überschreiben. * Überschreiben Sie mit Anmeldeinformationen für Standard- und Zertifikatauthentifizierung : Verwendet sowohl die Standardauthentifizierung als auch die Zertifikatauthentifizierung, um die Anmeldeinformationen in der REST-Nachrichtendefinition zu überschreiben. * Überschreiben Sie mit Anmeldeinformationen für die OAuth-Authentifizierung : Verwendet [OAuth 2,0](https://www.servicenow.com/docs/access?context=c_OAuthApplications&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US)Anmeldeinformationen zum Überschreiben der Anmeldeinformationen in der REST-Nachrichtendefinition. Die für diese Aktivität ausgewählte REST-Nachricht muss Folgendes haben [OAuth 2,0-Tutorial: Erstellen Sie eine REST-Nachricht](https://www.servicenow.com/docs/access?context=t_OAuthDemoCreateRESTMessage&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)Auf festlegen OAuth 2,0 Und ist [OAuth-Profile und -Umfänge](https://www.servicenow.com/docs/access?context=c_OAuthProviderAndScope&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)Entsprechend konfiguriert. {#t_MapRESTVariablesToExecutionComm__ul_hj2_b5n_cr} | | Anmeldeinformationen | Erforderliche Anmeldeinformationen für Standardauthentifizierung des REST-Endpunkts. Dieses Feld ist verfügbar, wenn Überschreiben Sie mit Anmeldeinformationen für die Standardauthentifizierung Ist in ausgewählt Authentifizierung Feld. Nur Anmeldeinformationen für Standardauthentifizierung werden in der Auswahlliste angezeigt, die Anmeldeinformationen enthält, die in der Instanz gespeichert sind, und Anmeldeinformations-IDs aus einem externen Speichersystem. Wenn Sie Anmeldeinformationen verwenden, die in einem CyberArk Safe gespeichert sind, können Sie überschreiben [Konfigurieren Sie den MID-Server für CyberArk](https://www.servicenow.com/docs/access?context=t_ConfigureTheMIDServerForCyberArk&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US)Definiert in der MID-Server-Konfigurationsdatei, indem der Anmeldeinformations-ID der durch einen Doppelpunkt getrennten Namen eines anderen Safe als Präfix hinzugefügt wird. Beispiel: newsafe:orch-test-f5. | | Protokollprofil | Zu verwendende Zertifikatauthentifizierung. Dieses Feld ist verfügbar, wenn die Auswahl in Authentifizierung Feld ist entweder Überschreiben Sie mit Anmeldeinformationen für die Zertifikatauthentifizierung Oder Überschreiben Sie mit Anmeldeinformationen für Standard- und Zertifikatauthentifizierung . | | OAuth-Profil | Profil für den OAuth-Anbieter für diese REST-Nachricht. Siehe [Geben Sie ein OAuth-Profil an](https://www.servicenow.com/docs/access?context=t_SpecifyAnOAuthProfile&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)Für weitere Informationen. | [Tabelle : 3. REST-Ausführungsbefehlfelder] {#t_MapRESTVariablesToExecutionComm__table_bmf_m1b_dr} 3. Klicken Sie auf Speichern. 4. Klicken Sie Auf Fahren Sie Fort Um zu weiterzufahren Ausgaben Phase. {#t_MapRESTVariablesToExecutionComm__steps_l14_5sf_s5}