出队
动词：dequeue
从“队列”或“消息队列”集合中除去第一个项。
集合是可使用索引和键进行访问的可枚举数据结构。
语法
dequeue --collection(IQueue<Variant>) [--handleerror(Boolean)] (Boolean)=success (Variant)=value
输入
| 脚本 | 设计器 | 必需的 | AcceptedTypes | Description |
|---|---|---|---|---|
| --collection | 队列 | 必需的 | IQueue<Any> | 要从中除去项的队列。在此参数中，除了“队列”类型集合外，还接受“消息队列”类型的集合（通过连接到队列提供程序来获取）。 要处理“消息队列”变量，必须从获取队列命令的已获取队列参数中获取此变量。 |
| --handleerror | 处理错误 | 可选 | BOOLEAN | 启用后，如果在命令执行期间发生错误，那么当前脚本不会失败，并且会在输出中返回有关该错误的信息。 如果未启用，那么脚本会在发生错误时失败。 |
输出
| 脚本 | 设计器 | AcceptedTypes | Description |
|---|---|---|---|
| 成功 | 成功 | BOOLEAN | 如果成功从队列中除去项，那么返回“True”；否则，返回“False”。 |
| 值 | 除去的项 | 任何 | 返回从队列中除去的项。 |
示例
示例 1：使用出队命令从队列中除去第一个项，并将值存储在变量“removedValue”中。
defVar --name namesCollection --type Queue --innertype String --value "[Ana,Maria,Lucas,Victor]"
defVar --name removedValue --type String
dequeue --collection "${namesCollection}" removedValue=value
logMessage --message "Removed Value: ${removedValue}" --type "Info"
// Removed Value: Ana.
示例 2：使用 Active MQ 连接命令连接到队列提供程序并获取“消息队列”。然后，使用出队命令从该“消息队列”除去第一个项。
defVar --name connection --type QueueConnection
defVar --name obtainedQueue --type MessageQueue
defVar --name removedValue --type String
connectActiveMQ --queueprovider Training --fromconfiguration connection=value
getQueue --connection ${connection} --fromconfiguration --queue queueA obtainedQueue=value
dequeue --collection "${obtainedQueue}" removedValue=value