# BRM Queue Widget

A compact dashboard widget that surfaces the BRM background queue's most recent or most relevant records. Pick a status filter (e.g. *Pending* or *Errors*), set a row limit, and the widget shows that slice of the queue at a glance.

For full queue management — retry, edit payloads, trigger the processor — use **BRM Queue Report** instead. The Widget is the dashboard glance; the Report is the operations console.

## Available in

* Dashboard modules
* Reports modules
* Page modules

## When to use

* Operations dashboards where staff want a quick visibility on queue health alongside other widgets.
* Admin landing pages where one row tells you *do I need to act on the queue today?*.
* Reports modules when paired with BRM Queue Report — Widget for at-a-glance, Report below for action.

## Settings

The block opens a configuration modal:

| Setting                    | Description                                                                                                                                   |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **Title**                  | Widget heading. Default: *BRM Queue Widget*.                                                                                                  |
| **Status Mode**            | *Interactive* (user can flip status filter on the widget) or *Fixed* (status filter is locked to the configured value). Default: Interactive. |
| **Status Filter**          | Default status to show — Pending, Processing, Success, Error, Partial, All, or *Errors* (statuses 4 + 5 combined). Default: Pending.          |
| **Refresh Interval**       | Seconds between auto-refreshes. 0 = manual only. Default: 0.                                                                                  |
| **Max Rows**               | How many records to show. Default: 6.                                                                                                         |
| **Show Search**            | Show a small search input above the widget table. Default: off.                                                                               |
| **Use Current Subsidiary** | When on, the widget filters to the currently-active subsidiary. When off, you specify a subsidiary ID explicitly. Default: on.                |
| **Subsidiary ID**          | (Only when *Use Current Subsidiary* is off) The NetSuite subsidiary internal ID to filter by.                                                 |

## How it works

1. Reads queue records via the same data hook as BRM Queue Report.
2. Filters by the configured status and subsidiary.
3. Shows the top *Max Rows* with status badges, record type, and timestamp.
4. In **Interactive** mode, the user can click status badges at the top to flip the filter; in **Fixed** mode, the filter is locked to the configured value.
5. Auto-refreshes if Refresh Interval is set.

## Examples

**Operations landing page.** Title *Queue Errors*, Status Mode Fixed, Status Filter *errors*, Max Rows 6, Refresh Interval 30. The dashboard shows whether anything's broken — drill into Queue Report for full management.

**Pending-queue heads-up.** Status Filter *Pending*, Status Mode Interactive, Max Rows 10. Staff can flip to *Errors* with one click if needed.

## Common issues

* **No records appear** — the configured status may genuinely have zero records, or the user's NetSuite role lacks access to the queue record. Check role permissions.
* **Numbers don't match BRM Queue Report** — the Widget filters to the current subsidiary by default; the Report may not. Toggle *Use Current Subsidiary* off if you need cross-subsidiary visibility.

## Related

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>BRM Queue Report</strong></td><td>Full queue management — retry, edit payloads, trigger the processor.</td><td><a href="/pages/LGRoUlH9YMa4l8z1fA7F">/pages/LGRoUlH9YMa4l8z1fA7F</a></td></tr><tr><td><strong>Report Widget</strong></td><td>Generic report widget for dashboards.</td><td><a href="/pages/iL4LHW8eadVrU4Dz2iRe">/pages/iL4LHW8eadVrU4Dz2iRe</a></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.in8sync.com/client-admin-guide/active-workflows/getting-started/report-components/brm-queue-widget.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.