--- 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 SOAP-Webservice-Aktivität # Erstellen Sie eine SOAP-Webservice-Aktivität {#ariaid-title1} * Freigeben Version: Yokohama * * Aktualisiert 30. Januar 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer Verwenden Sie diese Vorlage, um eine anwenderdefinierte SOAP-Aktivität zu erstellen. ## Vorbereitungen Erforderliche Rolle: Web_Service_admin, activity_admin, activity_creator ## Warum und wann dieser Vorgang ausgeführt wird Anweisungen zur Verwendung des Aktivitätsvorlagen-Prozess-Flows 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."). ## 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 Befehl zur Ausführung des SOAP-Webservice. | 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 im SOAP-Webservice ausführt. | | Webservicenachricht | Geben Sie die SOAP-Webservicenachricht an, die für diese Aktivität verwendet werden soll. Informationen zu SOAP-Webservices-Nachrichten finden Sie unter [SOAP-Nachricht](https://www.servicenow.com/docs/access?context=c_SOAPMessage&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US). | | Webservice-Nachrichtenfunktion | Geben Sie die SOAP-Nachrichtenfunktion an, die in Verbindung mit dem SOAP-Webservice verfügbar ist. | | Endpunkt | Wenn Sie in dieses Feld einen Endpunkt eingeben, überschreibt er die im SOAP-Nachrichtenwebservice konfigurierte Endpunkt-URL. Klicken Sie auf das Schlosssymbol, um das Eingabefeld zu öffnen und den Endpunkt hinzuzufügen. | | SOAP-Nachrichtenparameter | Name-Wert-Paare, die an den SOAP-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 SOAP-Nachricht definiert sind, die verwendet wird `${} `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 Text, der an die SOAP-Nachricht gesendet wird, mit einem 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_VariableSubstitutionSOAP&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)In der SOAP-Nachricht. | | MID-Server verwenden | Kontrollkästchen, das bestimmt, ob ein MID-Server zum Aufrufen des SOAP-Webservice verwendet werden muss. Wenn die SOAP-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 SOAP-Endpunkt. Standardmäßig wählt das System einen MID-Server mit SOAP-Fähigkeiten aus. Dieses Feld ist verfügbar, wenn Verwenden Sie den MID-Server Kontrollkästchen ist aktiviert. | | Zeitüberschreitung | Zulässige Dauer der SOAP-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: * Verwenden Sie vorhandene Anmeldeinformationen in der SOAP-Nachricht : Verwendet Anmeldeinformationsdefinitionen aus der SOAP-Nachrichtendefinition. * Mit Anmeldeinformationen für Standardauthentifizierung überschreiben: 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. Überschreibt die Anmeldeinformationen in der SOAP-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 : Überschreibt die Anmeldeinformationen in der SOAP-Nachrichtendefinition mit Anmeldeinformationen für die Zertifikatauthentifizierung. * Überschreiben Sie mit Anmeldeinformationen für Standard- und Zertifikatauthentifizierung : Überschreibt die Anmeldeinformationen in der SOAP-Nachrichtendefinition mit Anmeldeinformationen für Standardauthentifizierung oder Zertifikatauthentifizierung. * Überschreiben Sie mit WS-Security Anwendernamenprofil : Überschreibt die Anmeldeinformationen in der SOAP-Nachrichtendefinition mit Anmeldeinformationen In WS-Security definiert. {#t_CreateASOAPWebServiceActivity__ul_n3f_hcs_d1b} | | 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 Standardsafe überschreiben, der in der MID-Serverkonfigurationsdatei definiert ist, indem Sie der Anmeldeinformations-ID den Namen eines anderen Safe als Präfix hinzufügen, getrennt durch einen Doppelpunkt. Beispiel: newsafe:orch-test-f5. 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. | | Protokollprofil | [Gegenseitige Authentifizierung ausgehender Webservices](https://www.servicenow.com/docs/access?context=c_OutboundWebServicesMutualAuth&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)Zur Verwendung für die Authentifizierung. Dieses Feld ist verfügbar, wenn der Authentifizierungstyp entweder ist Überschreiben Sie mit Anmeldeinformationen für die Zertifikatauthentifizierung Oder Überschreiben Sie mit Anmeldeinformationen für Standard- und Zertifikatauthentifizierung . | |-|-| {#t_CreateASOAPWebServiceActivity__choicetable_m3f_hcs_d1b} 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 * Verwenden [automatische Zuordnung](https://www.servicenow.com/docs/fbiAVF1nogc9VkrQ4~1qxg "Sie können Parameterwerte in einer Testnutzlast Variablen in zuordnen Ausgaben Automatisch Registerkarte.")Dient zum Generieren von Ausgaben und Analyseregeln (empfohlen für JDBC) * Wenn Sie keine automatische Zuordnung verwenden, können Sie manuell [Erstellen Sie Ausgabevariablen](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.")Und [Erstellen Sie Analyseregeln](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.") {#t_CreateASOAPWebServiceActivity__ul_u45_vbq_xz} * **[SOAP-Aktivitätsausgabevariablen automatisch zuordnen](https://www.servicenow.com/docs/CY1MkkSXiEXSgsdgXGoK~A#t_AutoMapSOAPActivOutputVarble)** Die ServiceNowMit dem Aktivitäts-Designer können Sie Parameterwerte in einer SOAP-Testnutzlast Variablen in zuordnen Ausgaben Phase automatisch. * **[Konfigurieren Sie den SOAP-Ausführungsbefehl](https://www.servicenow.com/docs/24avVJmB4bu_M2iMrtSV0g)** Verwenden Sie die von Ihnen erstellten Eingabevariablen, um den Befehl zu konfigurieren, den Orchestration auf dem SOAP-Endpunkt ausführt. * **[Ausführungsparameter der SOAP-Vorlage](https://www.servicenow.com/docs/Q9D_88VfDdYrWgcXgHHdUA)** Sie verwenden Ausführungsparameter, um das Eingabeprozessskript in zu erstellen Vorverarbeitung Formular des Aktivitätendesigners. * **[Erstellen Sie ein JavaScript-Array in einer SOAP-Vorlage](https://www.servicenow.com/docs/euc~bXxF6vONHo0_DIPM3g)** Dies sind Anweisungen zum Erstellen von JavaScript-Arrays mit SOAP-Ausführungsparametern. * **[Nachverarbeitungsparameter für SOAP-Vorlage](https://www.servicenow.com/docs/aK5SIXpXWLlvH~8aTcIqGQ)** Verwenden Sie diese Parameter, um ein Nachverarbeitungsskript zu erstellen.