--- 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 JMS-Aktivität # Erstellen Sie eine JMS-Aktivität {#ariaid-title1} * Freigeben Version: Yokohama * * Aktualisiert 30. Januar 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 Minuten Lesedauer Erstellen Sie eine anwenderdefinierte JMS-Aktivität, um Nachrichten mit dem Java Messaging Service abzurufen oder an externe Systeme zu senden. ## 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 diese Vorgänge unterstützen kann: * Verwenden von JNDI, um ein ConnectionFactory-Objekt zu finden. * Verwenden von JNDI, um ein oder mehrere Zielobjekte zu finden. * Verwenden der ConnectionFactory zum Erstellen eines JMS-Verbindungsobjekts. * Verwenden der JMS-Verbindung, um ein oder mehrere JMS-Sitzungsobjekte zu erstellen. * Mithilfe einer JMS-Sitzung und der Ziele zum Erstellen der MessageProducer- und MessageConsumer-Objekte. * JMS-Verbindung wird gestartet, um die Zustellung oder den Verbrauch von Nachrichten zu aktivieren. {#t_CreateAJMSActivity__ul_mgt_1yv_rs} Hinweis: Der JMS-Aktivitätendesigner wurde mit den JMS-Providern ActiveMQ und Tibco EMS getestet. Informationen zum Herstellen einer Verbindung mit einem JMS-Anbieter finden Sie in der Anwenderdokumentation Ihrer Drittpartei. ## Prozedur 1. Erstellen oder verifizieren Sie [JMS-Anmeldeinformationen](https://www.servicenow.com/docs/access?context=r_JMSCredentialsForm&version=yokohama&pubname=yokohama-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 verifizieren Sie [JMS-Verbindung](https://www.servicenow.com/docs/803nOiHcFtSmbbJOivY52Q#t_ConfigureAnInstanceToUseJMS "Konfigurieren Sie Ihr System für die Verwendung des Java Messaging Service (JMS) mit einer anwenderdefinierten Orchestration-JMS-Aktivität."). Ihre JMS-Verbindung muss mit gültigen JMS-Anmeldeinformationen konfiguriert werden, bevor Sie eine JMS-Aktivität erstellen können. 3. 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. 4. 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 JMS-Ausführungsbefehl. | Option | Bezeichnung | | Konfigurieren Sie Ihre Anmeldeinformationen | Füllen Sie die für Ihre Datenbankverbindung erforderlichen Felder aus. | | Connection Factory | Name der JMS-Verbindungsfabrik. Sie sollten Ihre JMS-Verbindung erstellen oder überprüfen. Diese Konfiguration verknüpft den Namen der anfänglichen Kontext-Factory mit der URL des JMS-Providers. | | Zieltyp | Typ des für diese Nachricht verwendeten Ziels: * Warteschlange : Nachricht wird für Punkt-zu-Punkt-Kommunikation in die Warteschlange gestellt. Hinweis: Die ABRUFEN Vorgang wird nur für den Zieltyp der Warteschlange unterstützt. * Thema : Nachricht wird zum Veröffentlichen und Abonnieren der Kommunikation verwendet. {#t_CreateAJMSActivity__ul_e31_chy_ds} | | Zielname | Name der Warteschlange oder des Themenziels, die auf dem JMS-Provider konfiguriert ist. | | Nachrichtentyp | Der Wert des JMS-Nachrichtentyps. Nur die Textnachricht Typ wird unterstützt. Die Warteschlange oder das Themenziel muss so konfiguriert sein, dass nur Textnachrichten empfangen oder gesendet werden. Andere Nachrichtentypen werden verworfen, da sie von der JMS-Aktivität nicht verarbeitet werden können. | | Vorgang | Der programmatische Vorgang, der für das Ziel ausgeführt werden soll. Die Auswahlmöglichkeiten sind PLATZIEREN Oder ABRUFEN . | | Zeitüberschreitung (Sekunden) | Zulässige Wartezeit in Sekunden für eine Nachricht in der Nachrichtenwarteschlange, bevor eine Zeitüberschreitung auftritt. Der Standardwert ist 30 . | | Anwenderdefinierte Nachrichten-Header | Die anwenderdefinierten Headerwerte in einem Name/Wert-Paarformat, das im JMS-Ziel verfügbar ist. Hinweis: Dies wird nur für unterstützt PLATZIEREN Vorgang. | | Nachrichtennutzlast | Tatsächlicher Nachrichteninhalt oder Nutzlast, der an das JMS-Ziel gesendet wird. Hinweis: Dies wird nur für unterstützt PLATZIEREN Vorgang. | | Anmeldeinformations-Tag | Ein Tag für einzelne Anmeldeinformationen für eine JMS-Aktivität in einem Orchestration-Workflow. | | Erforderliche MID-Serverfä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 [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 * 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_CreateAJMSActivity__ul_u45_vbq_xz} ## Erstellen Sie eine JMS-Verbindung für OrchestrationAktivität {#ariaid-title2} Konfigurieren Sie Ihr System für die Verwendung des Java Messaging Service (JMS) mit einer anwenderdefinierten Orchestration-JMS-Aktivität. ### Vorbereitungen Erforderliche Rolle: Administrator ### 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 mid.property.jms.command.allowed_factory_namesEigenschaft, gefunden 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 Drittpartei-JMS-Anbieter veröffentlicht. ### Prozedur 1. Navigieren zu MID-ServerJAR-Dateienan. 2. Klicken Sie Auf Neu Und hinzufügen. | Option | Bezeichnung | | Name | Ein eindeutiger und beschreibender Name zur Identifizierung der Datei in der Instanz. | | Version | Eine Versionsnummer für die Datei, falls eine verfügbar ist. | | 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üroklammer-Symbol im Banner, und hängen Sie die JMS-Treiber-JAR-Datei an. Die JMS-Treiber-JAR-Datei muss als Teil der JMS-Anbieterinstallation verfügbar sein. Wenige JMS-Lieferanten stellen sie als separates Produkt zur Verfügung. In der JMS-Anbieterdokumentation finden Sie, welche JMS-Client-Treiber-JAR-Dateien erfordern, dass die Client-Anwendungen eine Verbindung zum JMS-Anbieter herstellen. Wenn Sie beispielsweise versuchen, eine Verbindung zu ActiveMQ V5.10 (JMS-Anbieter) herzustellen, benötigen Sie activemq-all-5.10.1.jar Datei. 4. Navigieren zu OrchestrationAnmeldeinformationen und VerbindungenJMS Connection Factoryan. 5. Klicken Sie Auf Neu Fügen Sie Folgendes hinzu, und klicken Sie auf Übermitteln . | Option | Bezeichnung | | Name | Eindeutiger Name dieser Connection Factory. | | Ursprüngliche Kontext-Werkseinstellung | Name der JNDI-Klasse, die zum Erstellen des InitialContext verwendet wird. Hinweis: Um beispielsweise eine Verbindung mit ActiveMQ V5.10 (JMS-Anbieter) herzustellen, ist der Wert Org.apache.activemq.jndi.ActiveMQInitialKontextFactory . | | URL de Anbieters | Speicherort der laufenden JMS-Anbieterinstallation. Hinweis: So stellen Sie beispielsweise eine Verbindung zu ActiveMQ V5.1 her: tcp://ipAddressOrHostName:61616 . | |-|-| {#t_ConfigureAnInstanceToUseJMS__choicetable_gqc_pd4_5y} 6. Navigieren zu OrchestrationAnmeldeinformationenan. 7. Klicken Sie Auf Neu , Auswählen JMS-Anmeldeinformationen , Und geben Sie den Anwendernamen und das Passwort an, 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=yokohama&pubname=yokohama-platform-security&ft:locale=en-US) [JMS-Anmeldeinformationen](https://www.servicenow.com/docs/access?context=r_JMSCredentialsForm&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US). 8. Klicken Sie auf Absenden. Sie sind bereit, eine anwenderdefinierte JMS-Aktivität zu erstellen. ## Ausführungsparameter der JMS-Vorlage {#ariaid-title3} Sie verwenden Ausführungsparameter, um das Eingabeprozessskript in zu erstellen Vorverarbeitung Formular. Sie müssen verwenden `ExecutionParameter. `Präfix mit allen Variablen in dieser Tabelle.{#r_JMSTemplateExecutionParameters__table_o2p_3q4_4r__entry__4} | Name | Variable | Typ | Nutzung | |-|-|-|-| | JMS-ds | jms_ds | Referenz | Ausgewählte JMS-Datenquelle. | | Zieltyp | Target_type | Aufgezählt | | | Zielname | Ziel_Name | Zeichenfolge | | | Nachrichtentyp | message_type | Aufgezählt | | | Vorgang | operation | Aufgezählt | | | Zeitüberschreitung | time_out | Ganzzahl | Wartezeit, bis die Abfrage Ergebnisse zurückgibt. | | Anwenderdefinierte Header | Anwenderdefinierte_Header | Array von JavaScript-Objekten | | | Nachrichtennutzlast | Message_Payload | Zeichenfolge | | | Anmeldeinformations-Tag | Credential_Tag | Zeichenfolge | Liste der erforderlichen MID-Serverfähigkeiten. | | MidCapabilities | MidCapabilities | Zeichenfolge (kommagetrennt) | | | 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."). Wenn zusätzliche Fähigkeiten vorhanden sind, die nach Wert zugewiesen werden, verwenden Sie dieses Beispiel, um die MID-Serverauswahl anzupassen: 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 der JMS-Vorlage {#ariaid-title4} Verwenden Sie diese Parameter, um ein Nachverarbeitungsskript zu erstellen. {#r_JMSTemplatePostProcessParams__table_grr_t2v_cr__entry__4} | Name | Variable | Typ | Nutzung | |-|-|-|-| | Status | Status | Zeichenfolge | Status des Vorgangs (PUT oder GET) für das JMS-Ziel. | | Standardheader | Standard-Header | Zeichenfolge | Alle Standard-Header, wie von JMS angegeben, die als Teil der JMS-Nachricht während eines GET-Vorgangs abgerufen werden. Dieses Feld gilt nur für GET-Vorgänge. | | Anwenderdefinierte Header | Anwenderdefinierte Header | Zeichenfolge | Alle anwenderdefinierten Header, die von einer Ersteller- oder Herausgeberanwendung hinzugefügt wurden und während eines GET-Vorgangs als Teil der JMS-Nachricht abgerufen werden. Dieses Feld gilt nur für GET-Vorgänge. | | Nachrichtennutzlast | MessagePayload | Zeichenfolge | Nachrichtennutzlast, die als Teil der JMS-Nachricht während eines Abrufvorgangs abgerufen wird. Dieses Feld gilt nur für GET-Vorgänge. | | EccSysID | EccSysID | Zeichenfolge | Enthält die Referenz-ID, die der von der Aktivität zurückgegebenen ECC-Warteschlangeneingabenachricht zugeordnet ist. | | Fehlernachrichten | errorMessages | Zeichenfolge | Enthält alle Fehlermeldungen, 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}