Review this example to better understand how to create a sample queue called Employee-Bonus-Queue, and define its work item structure with employee details.

This example demonstrates a detailed configuration of a queue—from creating it, defining schema, and performing a CSV-based work item insertion.

Prerequisites

  • Ensure that you have the Workload > Create queues permission in Control Room.
  • Ensure that you have a user to add as queue owner. In this example, we will use acc-docs.
  • Ensure that you have a custom role to add as queue participant and consumer. In this example, we will use wlmCoustom.

Procedure

  1. Log in to the Control Room and navigate to Manage > Queues.
  2. Click Create queue at the top-right corner of the page.
  3. Enter the queue details:
    1. In the Queue name field, enter: Employee_Bonus_Queue
    2. In the Description field, enter: Annual bonus calculation and approvals
    3. Leave the Time required for a person to complete one work item field blank.
    4. Specify the value as 3 for Max auto retry attempt, which is the number of times a failed work item must be processed.
    5. Click Next.
  4. On the Add queue owners page, select the acc-docs user from the list and click the right arrow to add the selected user.
    In this example, we are using acc-docs as this is the custom user created in the Control Room. You can create your own users as required.
  5. Click Next.
  6. On the Add queue participants page, select the wlmCoustom role from the list and click right arrow to add the selected role.
    In this example, wlmCoustom is the custom role created in the Control Room. You can create your own custom role as required.
  7. Click Next.
  8. On the Add queue consumers page, select the wlmCoustom role from the list and click right arrow to add the selected role.
  9. Click Next.
  10. On the Define work item structure page, select the Use a CSV file option.
    1. Click Browse to select the local CSV file and click Next.
    2. In the Work item structure page, specify the Steps 1: Work item template details as Employee-Bonus-Queue-docstest
    3. In Step 2: Which columns should we include in each work item?, select all the columns and select the Show in Control Room option for the Employee ID, Employee Name, Salary, Performance Rating, and Bonus columns.
    4. In Step 3: Sort your data by up to 3 selected columns, select the Employee ID column with which we want to sort the data.
    5. Click Create queue.

    The Employee-Bonus-Queue is now created with a defined work item structure, and ready to insert work items.

  11. Navigate to Add work items tab, click Browse and select the local file (employee_bonus_queue_testSample excel file) from which you want to add work items to the queue.
    Note: Ensure that your local file have same data as of the defined work item structure, such as number of columns, column heading.
  12. Click Save changes.
    When you navigate to Employee-Bonus-Queue, all the inserted work items are displayed.

    See the following example video that demonstrates the queue configuration.

  13. From the left pane, navigate to Manage > Queues.
  14. On the Queues page, go to Employee-Bonus-Queue and click edit this queue.
  15. Click Browse to select a CSV file from which you want to insert the work items and click Save changes.
  16. Hover over the vertical ellipsis (three dots icon) next to the Employee-Bonus-Queue. Perform the require steps:
    • Click View queue to view the queue details.
    • Click Edit queue and to edit the queue. Here, we are updating the time filter.
    • Click Delete queues to delete the queue and all its work items.
    • Click Export queues to export a queue and save it to use in another Control Room.
    • Click Import queues to import a local queue to your Control Room.

    See the following video that demonstrates the queue management.

    For more details about managing a queue and actions performed on a queue, see Manage workload queues.