--- 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 --- # JMS-Aktivitäten erstellen # JMS-Aktivitäten erstellen {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 Minuten Lesedauer Erstellen Sie eine benutzerdefinierte JMS-Aktivität zum Abrufen oder Senden von Nachrichten an externe Systeme mithilfe des Java Messaging Service. ## Vorbereitungen Erforderliche Rolle: activity_creator oder workflow_admin ## Warum und wann dieser Vorgang ausgeführt wird Die JMS-Aktivität unterstützt JMS-Drittanbieter, deren JMS-Client-Anwendung mit einem typischen Java-EE-Muster geschrieben ist und Folgendes unterstützen kann: * JNDI zum Suchen eines ConnectionFactory-Objekts * JNDI zum Suchen eines oder mehrerer Zielobjekte * ConnectionFactory zum Erstellen eines JMS-Verbindungsobjekts * JMS-Verbindung zum Erstellen eines oder mehrerer JMS-Sitzungsobjekte * JMS-Sitzung und die Ziele zum Erstellen der MessageProducer- und MessageConsumer-Objekte * Starten der JMS-Verbindung für die Zustellung oder Verwendung von Nachrichten {#t_CreateAJMSActivity__ul_mgt_1yv_rs} Hinweis: Der JMS-Aktivitätsdesigner wurde mit den JMS-Anbietern ActiveMQ und Tibco EMS getestet. Informationen zum Herstellen einer Verbindung zu einem JMS-Anbieter finden Sie in der Dokumentation Ihres Drittanbieters. ## Prozedur 1. Erstellen oder überprüfen Sie Ihre [JMS-Anmeldeinformationen](https://www.servicenow.com/docs/access?context=r_JMSCredentialsForm&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US). Ihre JMS-Anmeldeinformationen müssen über die Berechtigung für die Zieldatenbank und die richtige Konfiguration für die entsprechende JMS-Verbindung verfügen. Anmeldeinformationen müssen eingerichtet werden, bevor Sie eine JMS-Aktivität erstellen können. 2. Erstellen oder überprüfen Sie Ihre [JMS-Verbindung](https://servicenow-prod.fluidtopics.net/cH2VpFz5~GhrZ0W58lNbGg#t_ConfigureAnInstanceToUseJMS "Konfigurieren Sie Ihr System für die Verwendung von Java Messaging Service (JMS) mit einer benutzerdefinierten Orchestration-JMS-Aktivität."). Die JMS-Verbindung muss mit gültigen JMS-Anmeldeinformationen konfiguriert sein, bevor Sie eine JMS-Aktivität erstellen können. 3. 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. 4. 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 JMS-Ausführungsbefehl. | Option | Bezeichnung | | Konfigurieren Sie Ihren Berechtigungsnachweis | Füllen Sie die für Ihre Datenbankverbindung erforderlichen Felder aus. | | Connection Factory | Name der JMS Connection Factory. Sie sollten Ihre JMS-Verbindung erstellen oder überprüfen. Diese Konfiguration verknüpft den Namen der ursprünglichen Kontext-Werkseinstellung mit der URL des JMS-Anbieters. | | Zieltyp | Zieltyp für diese Nachricht: * Warteschlange: Die Nachricht wird für die Punkt-zu-Punkt-Kommunikation in die Warteschlange gestellt. Hinweis: Der GET-Vorgang wird nur für den Zieltyp „Warteschlange" unterstützt. * Thema: Die Nachricht wird für die Veröffentlichungs- und Abonnementkommunikation verwendet. {#t_CreateAJMSActivity__ul_e31_chy_ds} | | Zielname | Name der Warteschlange oder des Themenziels, das auf dem JMS-Anbieter konfiguriert ist. | | Nachrichtentyp | Der Wert für den JMS-Nachrichtentyp. Es wird nur der Typ Textnachricht unterstützt. Die Warteschlange oder das Themenziel muss so konfiguriert sein, dass nur Textnachrichten empfangen oder gesendet werden. Andere Nachrichtentypen werden gelöscht, da die JMS-Aktivität sie nicht verarbeiten kann. | | Operation | Der programmgesteuerte Vorgang, der auf dem Ziel ausgeführt werden soll. Die Auswahlmöglichkeiten sind PUT oder GET. | | Zeitüberschreitung (Sek.) | Zulässige Zeit in Sekunden, die auf eine Nachricht in der Nachrichtenwarteschlange vor der Zeitüberschreitung gewartet werden kann. Der Standardwert ist 30. | | Benutzerdefinierte Nachrichtenkopfzeilen | Die benutzerdefinierten Kopfzeilenwerte im Format „Name-Wert-Paar", die für das JMS-Ziel verfügbar sind. Hinweis: Wird nur für den PUT-Vorgang unterstützt. | | Nachrichten-Payload | Tatsächlicher Nachrichteninhalt oder tatsächliches Payload, das an das JMS-Ziel gesendet wird. Hinweis: Wird nur für den PUT-Vorgang unterstützt. | | Anmelde-Tag | Ein Tag für individuelle Anmeldeinformationen für eine JMS-Aktivität in einem Orchestration-Workflow. | | Erforderliche MID Server-Fähigkeiten | Zu verwendender MID Server nach Fähigkeiten | |-|-| {#t_CreateAJMSActivity__choicetable_py3_zmj_4y} {#t_CreateAJMSActivity__steps_jbm_5qy_ds} ## Nächste Maßnahme * Verwenden Sie die [automatische Zuordnung](https://servicenow-prod.fluidtopics.net/bcqgAOsKVNPv8G1c8hfewg "Sie können Parameterwerte in einem Test-Payload Variablen auf der Registerkarte Ausgaben automatisch zuordnen."), um Ausgaben und Analyseregeln zu generieren. * Wenn Sie die automatische Zuordnung nicht verwenden, können 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.") und [Analyseregeln](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.") manuell erstellen. {#t_CreateAJMSActivity__ul_u45_vbq_xz} ## JMS-Verbindungen für Orchestration-Aktivitäten erstellen {#ariaid-title2} Konfigurieren Sie Ihr System für die Verwendung von Java Messaging Service (JMS) mit einer benutzerdefinierten Orchestration-JMS-Aktivität. ### Vorbereitungen Erforderliche Rolle: admin ### Warum und wann dieser Vorgang ausgeführt wird Der MID Server muss über die richtigen JMS Connection Factorys für Ihre Organisation verfügen. Konfigurieren Sie diese Werte in der Eigenschaft mid.property.jms.command.allowed_factory_names in MID-ServerEigenschaftenan. Die Standardwerte für diese Eigenschaft können in einen beliebigen Wert oder eine durch Kommas getrennte Liste von Werten geändert werden, die der JMS-Provider eines Drittanbieters bekanntgibt. ### Prozedur 1. Navigieren zu MID-ServerJAR-Dateienan. 2. Klicken Sie auf Neu und fügen Sie hinzu. | Option | Bezeichnung | | Name | Ein eindeutiger und beschreibender Name zum Identifizieren der Datei in der Instanz. | | Version | Eine Versionsnummer für die Datei, sofern verfügbar. | | Quelle | Speicherort der JAR-Datei zu Referenzzwecken. Quellinformationen werden vom System nicht verwendet. | | Beschreibung | Kurzbeschreibung der JAR-Datei und ihres Zwecks in der Instanz | |-|-| {#t_ConfigureAnInstanceToUseJMS__choicetable_yqs_2c4_5y} 3. Klicken Sie auf das Büroklammersymbol im Banner, und hängen Sie die JMS-Treiber-JAR-Datei an. Die JMS-Treiber-JAR-Datei sollte als Teil der JMS-Anbieterinstallation verfügbar sein. Nur wenige JMS-Anbieter bieten sie als separates Produkt an. In der Dokumentation des JMS-Anbieters finden Sie Informationen dazu, für welche JMS-Client-Treiber-JAR-Dateien die Clientanwendungen eine Verbindung zum JMS-Anbieter herstellen müssen. Wenn Sie beispielsweise versuchen, eine Verbindung zu ActiveMQ V5.10 (JMS-Anbieter) herzustellen, benötigen Sie die Datei activemq-all-5.10.1.jar. 4. Navigieren zu OrchestrationAnmeldeinformationen und VerbindungenJMS Connection Factoryan. 5. Klicken Sie auf Neu, fügen Sie Folgendes hinzu, und klicken Sie auf Absenden. | Option | Bezeichnung | | Name | Eindeutiger Name für diese Connection Factory | | Ursprüngliche Kontext-Werkseinstellung | Name der JNDI-Klasse, die zum Erstellen des InitialContext verwendet wird. Hinweis: Um beispielsweise eine Verbindung zu ActiveMQ V5.10 (JMS-Provider) herzustellen, lautet der Wert org.apache.activemq.jndi.ActiveMQInitialContextFactory. | | Provider-URL | Speicherort der laufenden JMS-Provider-Installation. Hinweis: So stellen Sie beispielsweise eine Verbindung zu ActiveMQ V5.1 her: tcp://ipAdresseOderHostname: 61616. | |-|-| {#t_ConfigureAnInstanceToUseJMS__choicetable_gqc_pd4_5y} 6. Navigieren zu OrchestrationAkadem. Gradean. 7. Klicken Sie auf Neu, wählen JMS-Anmeldeinformationen aus, und geben Sie den Benutzernamen und das Passwort ein, die der MID für die Kommunikation mit dem JMS-Anbieter verwenden soll. Weitere Informationen finden Sie unter [JMS-Anmeldeinformationen](https://www.servicenow.com/docs/access?context=r_JMSCredentialsForm&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US) [JMS-Anmeldeinformationen](https://www.servicenow.com/docs/access?context=r_JMSCredentialsForm&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US). 8. Klicken Sie auf Absenden. Nun können Sie eine benutzerdefinierte JMS-Aktivität erstellen. ## Ausführungsparameter für JMS-Vorlagen {#ariaid-title3} Im Formular Vorverarbeitung erstellen Sie das Eingabeprozessskript mit Ausführungsparametern. Sie müssen das Präfix `executionParam.` mit allen Variablen in dieser Tabelle verwenden.{#r_JMSTemplateExecutionParameters__table_o2p_3q4_4r__entry__4} | Name | Variable | Typ | Verwendung | |-|-|-|-| | Jms ds | jms_ds | Referenz | Ausgewählt JMS-Datenquelle | | Zieltyp | destination type | Aufzählung | | | Zielname | destination_name | Zeichenfolge | | | Nachrichtentyp | message_type | Aufzählung | | | Operation | operation | Aufzählung | | | Time out | time_out | Ganzzahl | Zeit, die auf die Rückgabe von Abfrageergebnissen gewartet wird | | Benutzerdefinierte Header | custom_headers | Array von JavaScript-Objekten | | | Message payload | message_payload | Zeichenfolge | | | Anmelde-Tag | credential_tag | Zeichenfolge | Liste der erforderlichen MID Server-Fähigkeiten | | MidCapabilities | midCapabilities | Zeichenfolge (durch Kommas getrennt) | | | 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); | [Tabelle : 1. JDBC-Ausführungsparameter] {#r_JMSTemplateExecutionParameters__table_o2p_3q4_4r} ## Nachverarbeitungsparameter für JMS-Vorlagen {#ariaid-title4} Verwenden Sie diese Parameter, um ein Nachverarbeitungsskript zu erstellen. {#r_JMSTemplatePostProcessParams__table_grr_t2v_cr__entry__4} | Name | Variable | Typ | Verwendung | |-|-|-|-| | Status | status | Zeichenfolge | Status des Vorgangs (Put oder Get) auf dem JMS-Ziel | | StandardHeaders | standardHeaders | Zeichenfolge | Alle von JMS angegebenen Standardheader, die während einer Get-Operation als Teil der JMS-Nachricht abgerufen werden. Dieses Feld betrifft nur Get-Vorgänge. | | CustomHeaders | customHeaders | Zeichenfolge | Alle benutzerdefinierten Header, die von einer Produzenten- oder Herausgeberanwendung hinzugefügt wurden und als Teil der JMS-Nachricht während eines Abrufvorgangs abgerufen werden. Dieses Feld betrifft nur Get-Vorgänge. | | MessagePayload | messagePayload | Zeichenfolge | Nachrichten-Payload, das während einer Get-Operation als Teil der JMS-Nachricht abgerufen wird. Dieses Feld betrifft nur Get-Vorgänge. | | EccSysID | eccSysID | Zeichenfolge | Enthält die Referenz-ID, die der von der Aktivität zurückgegebenen Eingabenachricht der ECC-Warteschlange zugeordnet ist | | ErrorMessages | errorMessages | Zeichenfolge | Enthält alle Fehlernachrichten, die vom JMS-Befehl abgerufen wurden. Dieser Wert ist null, wenn keine Fehlermeldungen vorhanden sind. | [Tabelle : 2. JMS-Nachverarbeitungsparameter] {#r_JMSTemplatePostProcessParams__table_grr_t2v_cr}