连接到 IBM MQ
连接到 IBM MQ 队列提供程序服务器。
命令可用性: 本地 IBM RPA SaaS 和 IBM RPA
Description
连接到 IBM MQ 队列提供程序服务器。 您可以通过启用 Storaged Configurations 选项来使用现有 IBM MQ 连接，或者通过将其保持禁用状态来手动配置该连接。
脚本语法
IBM RPA 的专有脚本语言的语法与其他编程语言类似。 该脚本语法在脚本文件中定义命令的语法。 您可以在 IBM RPA Studio的 脚本 方式下使用此语法。
connectIbmMQ --queueprovider(String) --address(String) [--queuemanager(String)] [--channel(String)] [--cipherSpec(Nullable<IbmMqCipherSpec>)] [--fromconfiguration(Boolean)] [--port(Numeric)] [--timeout(TimeSpan)] (Boolean)=success (QueueConnection)=value
依赖关系
- 您必须具有对公开队列服务的服务器的访问权。 对于 IBM MQ，您必须具有对现有 IBM MQ 服务器的访问权，然后才能使用此命令。
- 如果启用
Storaged Configurations参数，那么必须在 IBM RPA Control Center中具有先前配置的队列提供程序。 请参阅队列提供程序以获取更多信息。
输入参数
下表显示了此命令中提供的输入参数的列表。 在表中，您可以看到在 IBM RPA Studio的脚本方式及其 Designer 方式等效标签中工作时的参数名称。
| 设计器方式标签 | 脚本方式名称 | 必需的 | 接受的变量类型 | Description |
|---|---|---|---|---|
| 队列提供程序 | 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 地址。 |
| 队列管理器 | queuemanager |
Optional |
Text |
连接到队列管理器。 要了解有关队列管理器的更多信息，请参阅 IBM MQ 队列管理器。 |
| 信道 | channel |
Optional |
Text |
队列服务器连接通道。 |
| 存储的配置 | fromconfiguration |
Optional |
Boolean |
启用后，您可以选择先前在 IBM RPA Control Center中配置的队列提供程序。 |
| 端口 | port |
Optional |
Number |
用于连接到队列提供程序服务器的端口号。 |
| 超时 | timeout |
Optional |
Time Span |
建立与队列服务器的连接的最长等待时间。 如果未定义任何值，那么将使用缺省超时值 5 秒。 它还可以使用设置超时 ( setTimeout) 命令中定义的超时值。 |
输出参数
| 设计器方式标签 | 脚本方式名称 | 接受的变量类型 | Description |
|---|---|---|---|
| 成功 | success |
Boolean |
如果成功建立与服务器的连接，那么返回 True；否则返回 False。 |
| 连接 | value |
Queue Connection |
通过与队列提供程序的连接返回一个变量。 |
示例
该命令使用存储在 IBM RPA Control Center上的设置连接到 IBM MQ 队列服务器。
defVar --name connectionSuccess --type Boolean
defVar --name ibmMqConnection --type QueueConnection
// Connects to the IBM MQ server with the stored settings.
connectIbmMQ --queueprovider testQueue --fromconfiguration ibmMqConnection=value connectionSuccess=success
// Displays whether you have successfully connected to the server.
logMessage --message "${connectionSuccess}" --type "Info"
限制
- 此命令不会创建新队列。 您可以通过创建类型为
Message Queue的新变量并使用 入队 (enqueue) 命令将项添加到队列，或者通过获取先前在 IBM RPA Control Center中注册的队列来创建新队列。 - 此命令仅支持公共连接。 如果连接受密码保护，那么 IBM RPA 将无法与 IBM WebSphere MQ 服务器连接。