---
sourceDocument: チューリッヒのデータと自動化
sourceDocumentLink: https://www.servicenow.com/docs/r/ja-JP/zurich/integrate-applications

 Release :

    - zurich

ft:locale :

    - ja-JP

ft:publication_title :

    - チューリッヒのデータと自動化

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# JMS アクティビティを作成する

# JMS アクティビティを作成する {#ariaid-title1}

* リリースバージョン: Zurich
* 
* 更新日 2025年07月31日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：8分

Java Messaging Service を使用してメッセージを取得したり、外部システムにメッセージを送信したりするカスタム JMS アクティビティを作成します。

## 始める前に

必要なロール：activity_creator または workflow_admin

## このタスクについて

JMS アクティビティは、JMS クライアントアプリケーションが標準的な Java EE パターンで作成され、以下の操作をサポートできるサードパーティの JMS プロバイダーをサポートします。

* JNDI を使用して ConnectionFactory オブジェクトを検索する。
* JNDI を使用して 1 つまたは複数の宛先オブジェクトを検索する。
* ConnectionFactory を使用して JMS 接続オブジェクトを作成する。
* JMS 接続を使用して 1 つまたは複数の JMS セッション オブジェクトを作成する。
* JMS セッションと宛先を使用して MessageProducer オブジェクトと MessageConsumer オブジェクトを作成する。
* JMS 接続を開始して、メッセージの配信または消費を有効にする。

{#t_CreateAJMSActivity__ul_mgt_1yv_rs}  
注:  
JMS アクティビティデザイナーは、JMS プロバイダー ActiveMQ および Tibco EMS でテストされています。JMS プロバイダーに接続する際には、サードパーティのユーザーマニュアルを参照してください。

## 手順

1. JMS 認証情報を作成または検証します。  
   JMS 認証情報には、ターゲットデータベースに対する権限と、対応する JMS 接続に対する適切な構成が必要です。JMS アクティビティを作成する前に、認証情報を設定する必要があります。
2. [JMS 接続](https://www.servicenow.com/docs/RLMN_IQUxIikd1WaRKuVxg#t_ConfigureAnInstanceToUseJMS "カスタム オーケストレーション JMS アクティビティで Java Messaging Service (JMS) を使用するようにシステムを設定します。")を作成または検証します。  
   JMS アクティビティを作成する前に、有効な JMS 認証情報を設定した JMS 接続を構成する必要があります。
3. [カスタムアクティビティ](https://www.servicenow.com/docs/kjGdhEfd~80EovVqUhw5sA "カスタム テンプレートを使用して、ワークフローエディターでさまざまなタイプのカスタムアクティビティを作成および更新できます。")を作成します。  
   このアクションにより、テンプレートを使用してカスタムアクティビティが作成されます。
4. [一般的なプロパティ](https://www.servicenow.com/docs/7xv0Bw5~wA4gwnn6ilv_Rg "次の一般プロパティ フィールドは、すべてのアクティビティデザイナーテンプレートに共通です。")を設定し、[入力変数を作成](https://www.servicenow.com/docs/CIsbNzcrccTjJcEBXzj0Sg#CreateInputVariables "アクティビティデザイナーの [入力] フォームで、アクティビティに渡す変数を作成します。")した後、JMS 実行コマンドを構成します。

   | オプション | 説明 |
   | 認証情報の設定 | データベース接続に必要なフィールドに入力します。 |
   | Connection Factory | JMS Connection Factory の名前。JMS 接続を作成または検証する必要があります。この設定では、初期コンテキスト ファクトリーの名前を JMS プロバイダーの URL とリンクします。 |
   | 宛先タイプ | このメッセージに使用される宛先のタイプ： * キュー：メッセージはポイントツーポイント通信のためにキューに入れられます。 注: GET 操作は、\[キュー\] 宛先タイプでのみサポートされます。 * トピック：メッセージはパブリッシュおよびサブスクライブ通信に使用されます。 {#t_CreateAJMSActivity__ul_e31_chy_ds} |
   | 宛先名 | JMS プロバイターで設定されているキューまたはトピックの宛先の名前。 |
   | メッセージ タイプ | JMS メッセージ タイプの値。\[テキスト メッセージ\] タイプのみサポートされます。キューまたはトピックの宛先は、テキスト メッセージのみを受信または送信するように設定する必要があります。他のメッセージ タイプは、JMS アクティビティが処理できないため、削除されます。 |
   | 運用 | 宛先で実行するプログラムによる操作。選択肢は PUT または GET です。 |
   | タイムアウト (秒) | メッセージ キュー内のメッセージを、タイムアウトするまでに待機する時間 (秒単位)。デフォルトは 30 です。 |
   | カスタム メッセージ ヘッダー | JMS 宛先で使用可能な名前/値のペア形式のカスタム ヘッダー値。 注: これは PUT 操作にのみサポートされます。 |
   | メッセージ ペイロード | JMS 宛先に送信される実際のメッセージ コンテンツまたはペイロード。 注: これは PUT 操作にのみサポートされます。 |
   | 認証情報タグ | オーケストレーション ワークフロー内の JMS アクティビティの個々の認証情報のタグ。 |
   | 必要な MID サーバー機能 | 使用する MID サーバー (機能別)。 |
   |-|-|

   {#t_CreateAJMSActivity__choicetable_py3_zmj_4y}
{#t_CreateAJMSActivity__steps_jbm_5qy_ds}

## 次のタスク

* [自動マッピング](https://www.servicenow.com/docs/LdnkQ~IzTpVXNr0C~QVKYw "テストペイロードのパラメーター値を、[出力] タブの変数に自動的にマッピングできます。")を使用して出力および解析ルールを生成する
* 自動マッピングを使用しない場合は、手動で[出力変数を作成](https://www.servicenow.com/docs/AWzQbZqjDpvTUWVnO5ItaA#t_CreateAnOutputVariable "デザイナーの [出力] フォームには、オブジェクトとアレイのデータ構造を作成するための変数ビルダが含まれています。")し、[解析ルールを作成](https://www.servicenow.com/docs/4pRwy_tiljdz8xWurQ_FMw#t_CreateAParsingRule "カスタムアクティビティで定義された出力変数に、外部ホストまたはエンドポイントでの入力テストから返されたペイロード データを取り込みます。")できる
{#t_CreateAJMSActivity__ul_u45_vbq_xz}

## オーケストレーション アクティビティの JMS 接続を作成する {#ariaid-title2}

カスタム オーケストレーション JMS アクティビティで Java Messaging Service (JMS) を使用するようにシステムを設定します。

### 始める前に

必要なロール：admin

### このタスクについて

MID サーバーには、組織に適切な JMS 接続ファクトリーが必要です。これらの値を、次にある mid.property.jms.command.allowed_factory_names プロパティで構成します。 MID サーバープロパティ. このプロパティのデフォルト値は、サードパーティの JMS プロバイダーが通知する任意の値またはカンマ区切りの値リストに変更できます。

### 手順

1. 移動先 MID サーバーJAR ファイル.
2. \[新規\] をクリックして、以下を追加します。

   | オプション | 説明 |
   | 名前 | インスタンス内のファイルを識別するためのわかりやすい一意の名前。 |
   | バージョン | ファイルのバージョン番号 (使用可能な場合)。 |
   | ソース | 参照用の JAR ファイルの場所。ソース情報はシステムで使用されません。 |
   | 説明 | インスタンス内の JAR ファイルとその目的の簡単な説明。 |
   |-|-|

   {#t_ConfigureAnInstanceToUseJMS__choicetable_yqs_2c4_5y}
3. バナーにあるクリップ アイコンをクリックして JMS ドライバー JAR ファイルを添付します。  
   JMS ドライバーの JAR ファイルは、JMS プロバイダーのインストールの一部として使用可能になっている必要があります。JMS ベンダーによっては、それらを別個の製品として使用可能にしている場合があります。クライアント アプリケーションが JMS プロバイダーに接続している必要がある JMS クライアント ドライバー JAR ファイルを判別するには、JMS プロバイターの資料を参照してください。たとえば、ActiveMQ V5.10 (JMS プロバイダー) に接続しようとしている場合は、activemq-all-5.10.1.jar ファイルが必要です。
4. 移動先 オーケストレーション認証情報 \& 接続JMS Connection Factory.
5. \[新規\] をクリックして、以下を追加し、\[送信\] をクリックします。

   | オプション | 説明 |
   | 名前 | この接続ファクトリーの一意の名前。 |
   | 初期コンテキスト ファクトリー | InitialContext の作成に使用する JNDI クラスの名前。 注: たとえば、ActiveMQ V5.10 (JMS プロバイダー) に接続する場合、値は org.apache.activemq.jndi.ActiveMQInitialContextFactory です。 |
   | プロバイダー URL | 実行中の JMS プロバイダーのインストールの場所。 注: たとえば、ActiveMQ V5.1 に接続するには、tcp：//ipAddressOrHostName：61616になります。 |
   |-|-|

   {#t_ConfigureAnInstanceToUseJMS__choicetable_gqc_pd4_5y}
6. 移動先 オーケストレーション認証情報.
7. \[新規\] をクリックして \[JMS 認証情報\] を選択し、MID で JMS プロバイダーとの通信に使用されるユーザー名とパスワードを入力します。  
   詳細は、「JMS 認証情報JMS 認証情報」を参照してください。
8. \[送信\] をクリックします。  
   これで、カスタム JMS アクティビティを作成する準備ができました。

## JMS テンプレート実行パラメーター {#ariaid-title3}

実行パラメーターを使用して、\[後処理\] フォームで入力プロセス スクリプトを作成します。
この表のすべての変数で `executionParam.` プリフィックスを使用する必要があります。{#r_JMSTemplateExecutionParameters__table_o2p_3q4_4r__entry__4}

| 名前 | 変数 | タイプ | 使用法 |
|-|-|-|-|
| Jms ds | jms_ds | 参照 | 選択された JMS データソース。 |
| 宛先タイプ | destination_type | 列挙 |   |
| 宛先名 | destination_name | 文字列 |   |
| メッセージ タイプ | message_type | 列挙 |   |
| 運用 | operation | 列挙 |   |
| タイムアウト | time_out | 整数 | クエリが結果を返すのを待機する時間。 |
| カスタム ヘッダー | custom_headers | JavaScript オブジェクトの配列 |   |
| メッセージ ペイロード | message_payload | 文字列 |   |
| 認証情報タグ | credential_tag | 文字列 | 必要な MID サーバー機能のリスト。 |
| MidCapabilities | midCapabilities | 文字列 (コンマ区切り) |   |
| ValueCapabilities | valueCapabilities | ハッシュマップの配列 | MID サーバーの選択に使用される機能値。詳細については、「[MID サーバーの機能](https://www.servicenow.com/docs/access?context=t_ConfigureCapabilities&version=zurich&pubname=zurich-servicenow-platform&section=r_MIDServerCapabilities&ft:locale=en-US)」を参照してください。値によって割り当てられる追加の機能がある場合は、次の例を使用して MID サーバーの選択をカスタマイズします。 var valueCapability = {'NEW_MID_CAPABIILTY':'NEW_MID_CAPABILITY_VALUE'}; executionParam.valueCapabilities.push(valueCapability); |
[表 : 1. JDBC 実行パラメーター]

{#r_JMSTemplateExecutionParameters__table_o2p_3q4_4r}

## JMS テンプレートの後処理パラメーター {#ariaid-title4}

これらのパラメーターを使用して、後処理スクリプトを作成します。
{#r_JMSTemplatePostProcessParams__table_grr_t2v_cr__entry__4}

| 名前 | 変数 | タイプ | 使用法 |
|-|-|-|-|
| ステータス | status | 文字列 | JMS 宛先での操作のステータス (Put または Get)。 |
| StandardHeaders | standardHeaders | 文字列 | Get 操作中に JMS メッセージの一部として取得される、JMS で指定されたすべての標準ヘッダー。このフィールドは、Get 操作にのみ適用されます。 |
| CustomHeaders | customHeaders | 文字列 | Get 操作中に JMS メッセージの一部として取得される、プロデューサーまたはパブリッシャー アプリケーションによって追加されたすべてのカスタム ヘッダー。このフィールドは、Get 操作にのみ適用されます。 |
| MessagePayload | messagePayload | 文字列 | Get 操作中に JMS メッセージの一部として取得されるメッセージ ペイロード。このフィールドは、Get 操作にのみ適用されます。 |
| EccSysID | eccSysID | 文字列 | アクティビティによって返された ECC キュー入力メッセージに関連付けられた参照 ID が含まれています。 |
| ErrorMessages | errorMessage | 文字列 | JMS コマンドから取得したエラーメッセージが含まれます。エラーメッセージがない場合、この値は null です。 |
[表 : 2. JMS 後処理パラメーター]

{#r_JMSTemplatePostProcessParams__table_grr_t2v_cr}