Active MQ への接続
アクティブ MQ 
キュー・プロバイダーに接続します。
コマンドの可用性: IBM RPA SaaS および IBM RPA オンプレミス
説明
アクティブな MQ キュー・プロバイダーに接続します。 Storaged Configurations オプションを有効にすることによって既存のアクティブな MQ 接続を使用することも、無効にしたままにして手動で構成することもできます。
スクリプト構文
IBM RPA の専有スクリプト言語の構文は、他のプログラミング言語と似ています。 スクリプト構文は、スクリプト・ファイル内のコマンドの構文を定義します。 この構文は、 IBM RPA Studioの 「スクリプト」 モードで操作できます。
connectActiveMQ --queueprovider(String) --address(String) [--fromconfiguration(Boolean)] [--port(Numeric)] [--timeout(TimeSpan)] (Boolean)=success (QueueConnection)=value
依存関係
- キュー・サービスを公開するサーバーへのアクセス権限が必要です。 Active MQ の場合、このコマンドを使用する前に、既存の Active MQ サーバーにアクセスできる必要があります。
Storaged Configurationsパラメーターを有効にする場合は、 IBM RPA Control Centerで事前にキュー・プロバイダーを構成しておく必要があります。 詳しくは、キュー・プロバイダーを参照してください。
入力パラメーター
以下の表は、このコマンドで使用可能な入力パラメーターのリストを示しています。 この表では、 IBM RPA Studioのスクリプト・モードで作業しているときのパラメーター名と、それに相当する Designer モードのラベルを確認できます。
| 「デザイナー」モードのラベル | 「スクリプト」モードの名前 | 必須 | 使用可能な変数タイプ | 説明 |
|---|---|---|---|---|
| キュー・プロバイダー | queueprovider |
Required when the Storage Configurations parameter is enabled |
Text |
IBM RPA Control Centerで構成されたキュー・プロバイダーに接続します。 このオプションは、キュー・プロバイダーが既に IBM RPA Control Centerに登録されている場合にのみ機能します。 |
| アドレス | address |
Required when the Storage Configurations parameter is not enabled |
Text |
キュー・プロバイダー・サーバーに接続するための URL アドレス。 |
| 保管された構成 | fromconfiguration |
Optional |
Boolean |
有効にすると、 IBM RPA Control Centerで以前に構成したキュー・プロバイダーを選択できます。 |
| ポート | port |
Optional |
Number |
キュー・プロバイダー・サーバーへの接続に使用されるポート番号。 |
| タイムアウト | timeout |
Optional |
Time Span |
キュー・サーバーへの接続を確立するための最大待機時間。 値が定義されていない場合は、デフォルトのタイムアウトである 5 秒が使用されます。 また、「タイムアウトの設定」 ( setTimeout) コマンドで定義されたタイムアウト値を使用することもできます。 |
出力パラメーター
| 「デザイナー」モードのラベル | 「スクリプト」モードの名前 | 使用可能な変数タイプ | 説明 |
|---|---|---|---|
| 成功 | success |
Boolean |
接続に有効な IP またはホスト名が含まれている場合は True を返し、含まれていない場合は Falseを返します。 |
| 接続 | value |
Queue Connection |
キュー・プロバイダーへの接続を持つ変数を返します。 |
例
このコマンドは、アクティブな MQ キュー・プロバイダーに接続し、 キューの取得 (getQueue) コマンドを使用して ClientQueue を取得し、 デキュー (dequeue) コマンドを使用してキューから最初の項目をデキューします。
defVar --name activemqConnection --type QueueConnection
defVar --name clientQueue --type MessageQueue
connectActiveMQ --address "127.0.0.1" --port 8161 activemqConnection=value
getQueue --connection ${activemqConnection} --name ClientQueue clientQueue=value
dequeue --collection "${clientQueue}"
制限
- このコマンドでは、新規キューは作成されません。 新しいキューを作成するには、
Message Queueタイプの新しい変数を作成し、 Enqueue (enqueue) コマンドを使用してキューに項目を追加するか、 IBM RPA Control Centerで以前に登録したキューを取得します。 successパラメーターは、接続が有効な場合はTrueを返しますが、接続が正常に確立されたかどうかは検査しません。