AMQP Declare Queue

Applies to ReadyAPI 3.56, last modified on October 29, 2024

About AMQP Declare Queue test step

Use this test step to create a queue on an AMQP broker.

Note: To use the test step, you must have the AMQP Support Plugin installed. You can install it on the Integrations tab.

Requirements

To use this test step, you need a ReadyAPI Test license. If you do not have it, you can request it on our web site or start a trial.

Editing AMQP Declare Queue test step

You can modify the settings of the test step in its editor:

AMQP Testing: Declaring queue

Click the image to enlarge it.

Connection

Choose a configured connection to the broker from the drop-down list, or select [Create new connection] to create a new connection using the Create AMQP Connection dialog. Click the Edit button to customize properties of the selected connection in the Edit AMQP Connection dialog.

Queue

The name of the queue.

Note: This field supports property expansions.

durable

If the option is checked, the queue will survive broker restart. If the option is unchecked, the queue will be deleted when the broker shuts down and will have to be redeclared when it comes back online.

exclusive

If the option is checked, the queue will be used only for one connection; when the connection is closed, the queue will be deleted.

auto delete

If the option is checked, the queue will be deleted when the last consumer unsubscribes from it.

Create/Edit AMQP Connection dialog

Use the Create AMQP Connection and Edit AMQP Connection dialogs to configure connections used by the test step. Both dialogs have the same set of options.

Note: ReadyAPI stores AMQP connections at the project level. This means that a connection defined for one test step can be used for all the test steps in other test cases and test suites of the project.
AMQP Testing in ReadyAPI: Create AMQP Connection dialog

Connection name

The unique name used to identify the connection.

Host

The AMQP server's host address.

Port

The port on the host through which the AMQP server is available.

User name

The username used to connect to the AMQP server. This field is optional.

Password

The user password used to connect to the AMQP server. This field is required if the username is specified.

Property list

You can also change the test step behavior by using the step properties on the AMQPDeclareQueueTestStep Properties and Custom AMQP Declare Queue Test Step Properties tabs.

Name Description
Name

The test step’s name.

Description

Text that describes the test step.

The values on the Custom AMQP Declare Queue Test Step Properties tab are available to other test steps in your project. For instance, you can verify these property values with the Assertion test step, or check them and change the execution flow with the Conditional GoTo test step.

You can load values of custom properties from a file or save them to a file. To learn more, see About Properties.

This tab contains the following properties that provide access to the request and response data:

Name Description
queueName

Specifies the name of the queue.

Note: Corresponds to the Queue option specified in the test step editor.
queueDurable

Specifies whether the queue will survive broker restart. Possible values: true, false.

Note: Corresponds to the durable option specified in the test step editor.
queueExclusive

Specifies whether the queue will be used for one connection exclusively. Possible values: true, false.

Note: Corresponds to the exclusive option specified in the test step editor.
queueAutoDelete

Specifies if the queue will be deleted when the last consumer unsubscribes. Possible values: true, false.

Note: Corresponds to the auto delete option specified in the test step editor.

Logging

If the test step is run as part of a test case, you can see the test log in the Transaction Log panel.

See Also

AMQP Testing
AMQP Declare Exchange
AMQP Bind Queue
AMQP Publish
AMQP Receive
Test Steps

Highlight search results