# uip rpa add-test-data-queue

> `uip rpa add-test-data-queue` wires an Orchestrator Test Data Queue into a test case as its data source. Studio adds an `IDictionary<string, object>` argument to the test case, named after the queue — at execution time, each iteration of the test pulls one item from the queue and feeds its key/value pairs into the argument.

`uip rpa add-test-data-queue` wires an Orchestrator Test Data Queue into a test case as its data source. Studio adds an `IDictionary<string, object>` argument to the test case, named after the queue — at execution time, each iteration of the test pulls one item from the queue and feeds its key/value pairs into the argument.

Studio drives the operation, so a Windows runner is required. The queue must already exist in Orchestrator; resolve its name, ID, and folder path first (the `uip or` Orchestrator commands list queues in your tenant).

## Synopsis

```
uip rpa add-test-data-queue --test-case-path <string> --queue-name <string> --folder-path <string> --queue-id <number>
```

## Options

| Flag | Description |
|---|---|
| `--test-case-path <string>` | Relative path to the test case file (`.xaml` or `.cs`) within the project directory. |
| `--queue-name <string>` | Name of the Test Data Queue in Orchestrator. |
| `--folder-path <string>` | Orchestrator folder path where the queue resides. |
| `--queue-id <number>` | Orchestrator ID of the Test Data Queue. |

For the complete option list on your installed tool version, run:

```bash
uip rpa add-test-data-queue --help
```

## Examples

```bash
# Bind a queue from the Shared folder to a XAML test case
uip rpa add-test-data-queue \
  --test-case-path Tests/InvoiceFlow.xaml \
  --queue-name InvoicesToProcess \
  --folder-path Shared \
  --queue-id 4271

# Bind a queue from a sub-folder to a coded test case
uip rpa add-test-data-queue \
  --test-case-path Tests/CustomerOnboarding.cs \
  --queue-name OnboardingFixtures \
  --folder-path "Finance/QA" \
  --queue-id 5106
```

## Related

- [`uip rpa add-test-data-entity`](./uip-rpa-add-test-data-entity.md) — bind a Data Service entity instead of a queue.
- [`uip rpa add-test-data-variation`](./uip-rpa-add-test-data-variation.md) — bind a CSV or Excel variation file.
- [`uip rpa create-project`](./uip-rpa-create-project.md) — scaffold the test project before adding data sources.
- [`uip tm testcases`](./uip-test-manager-testcases.md) — manage the matching test case in Test Manager.

## See also

- [RPA tool overview](./uip-rpa.md)
- [Global options](./global-options.md)
- [Exit codes](./exit-codes.md)