Skip to content

Create worklists from any source

Verified against source (12)

  • qbo4.Import.Bridge/TaskReader.cs
  • Installer/Setup.Import.Bridge.xml
  • Import/ImportFileTemplate.Popup.xslt
  • Import/ImportFile.BatchApply.xslt
  • Decision/SmartWorklist.Home.xslt
  • decision/ImportForm.cs
  • decision/ImportFormTemplate.cs
  • Config/ImportForm.config
  • Properties/Settings.settings
  • application/GenericObject.cs
  • application/AbstractObject.cs
  • Security/Collection.EditTeam.xslt

Work that’s tracked in spreadsheets gets lost: rows are skipped, two people call the same customer, and no one can say how much is left. QBO worklists fix that by turning each item into a task with an owner, a due date, and a status that everyone can see. This walkthrough covers three ways to fill a worklist, from quickest to most automated: drop a spreadsheet on the dashboard for one-off work, reuse that setup for a file you receive regularly, or query a data warehouse on a schedule. It finishes by routing the work to a team so people simply ask for their next item.

Who it’s for: operations managers and power users who hand out work.

Prerequisites

  • Access to the Worklists dashboard, with permission to create import templates and upload files.
  • For the data warehouse approach, a warehouse query set up as an operation, as in Launch workflows from a data warehouse query, and access to Import Files > Batch Apply.
  • Worklists: worklist templates, teams, and Next
  • Forms: the tasks behind each work item
  • Imports: import templates and batch processing
  • Templates: repeatability, which keeps one open task per record
  • Cases: a process to hold each record’s tasks

Every approach ends the same way. Each row becomes a task built from a task template, and each new task template gets its own worklist template automatically. Each open task becomes an item on a worklist, which a team can work through.

Approach 1: on the fly, from a spreadsheet

Section titled “Approach 1: on the fly, from a spreadsheet”

Use this for one-off work: a list a client sent over, or a cleanup project.

Put one item per row, and add a column named Template that holds the name of the task template to create or add to. Every row can use the same value.

A spreadsheet with CaseNumber, Name, Issue, AmountDue, DueDate, and Template columns; every Template cell reads Worklist Walkthrough.

Use letters and numbers in column names. Each column becomes a question on the task, and question names shouldn’t contain spaces, punctuation, or underscores.

From Home > Worklists, drag the spreadsheet onto the dashboard’s Current panel. QBO asks how to import it:

Prompt What to enter
Select a template Create a new template the first time. This is the import template, which remembers how to read this kind of file.
Worklist The name of the worklist the items go into, for example Client cleanup: October. It defaults to the file name.
New Template A name for the import template.
Applies To Leave it set to tasks (ImportForm).
Import Engine Leave it set to Task Reader.
Preview before import Check it to see the data before anything is created (available when the template has a preview).

Choose Submit.

  • A task template named after the Template column, with a question for each other column. Date and whole-number columns get date and number formats.
  • A worklist template for that task template.
  • An import template, and an import file that tracks each row.
  • A task for each row, left open, on the worklist you named.

Approach 2: from a spreadsheet you receive regularly

Section titled “Approach 2: from a spreadsheet you receive regularly”

When the same kind of file arrives every week, reuse the setup from approach 1:

  1. Drop the new file on the Worklists dashboard.
  2. In Select a template, choose the import template you created the first time.
  3. Enter a new Worklist name for this batch, such as Client cleanup: November, or reuse an open worklist’s name to add to it.

QBO finds the existing task template by the Template column and adds questions for any new columns. Naming a worklist per batch lets you track each file’s progress separately.

Use this when the list of work comes from a query, so the worklist refreshes itself. The example is an Insurance Policy Review worklist, with one process per policy and at most one open review task per policy.

Set up the warehouse query as an operation, as in steps 1 to 3 of Launch workflows from a data warehouse query. This example assumes Process/PoliciesToReview returns a PolicyID column.

From Templates > Tasks, add a task template named Insurance Policy Review:

  • Applies To: Process.
  • Repeatable: One active per parent. However often the job runs, a policy that already has an open review task doesn’t get a second one. Once a review is completed, the next run can open a new one if the policy still qualifies.

Tasks can stand alone, but they’re far more useful attached to a record. Here, a process acts as a folder for each policy and collects its reviews over time.

From Import Files > Batch Apply:

  • Operation: Process / PoliciesToReview, the query.

  • Action: Process / Save, called once per row, with the parameters:

    Process=Policy {PolicyID}&SubscriberID=acme.example-Policy-{PolicyID}

{PolicyID} is replaced with each row’s value. SubscriberID is a key you make up that identifies the policy’s process, so later runs find the existing process instead of creating another. A pattern of {source system}-{table}-{key} keeps keys unique.

Choose Query to see the rows and Preview to see the calls, then Apply.

On Batch Apply again, keep the same Operation, and set the Action to ImportForm / Pause (tasks), with the parameters:

Template=Insurance Policy Review&Object=Process&ObjectSubscriberID=acme.example-Policy-{PolicyID}&{*}
Parameter Effect
Template=Insurance Policy Review The task template.
Object=Process and ObjectSubscriberID=… Attaches the task to the process with that key.
{*} Copies every column of the row onto the task. Parameters that aren’t task columns are stored as answers.

To keep the worklist current, check Schedule on both batches and schedule the processes before the tasks, for example Daily at 5:00am and Daily at 5:30am. Check Audit Trail to track each run as a named batch.

From Home > Worklists, open Insurance Policy Review to see the new items. They aren’t assigned to anyone yet.

A team is a label of people. From Labels, create a label such as Insurance Review Team using a template for people, save it, and add its Members. Each member’s priority on the team decides which work they get first when they belong to several teams.

On the Worklists dashboard, open the worklist, select the items, and Assign them to the team. To route new items automatically, open the worklist template and set Assignment to Team.

Assign work to teams rather than to individual people. QBO hands out the next item to whoever is ready.

The Insurance Policy Review worklist, with every item assigned to the Insurance Review Team and a play icon beside each item.

Team members can start a specific item from the list with Start (the play icon beside it), which assigns it to them, marks it started, and opens it. Or they choose Next (the play icon in the main menu), and QBO picks the highest-priority item they’re eligible for, assigns it, marks it started, and opens it.

Whatever the source, the work is now in one place: each item is a task with an owner, a status, and a due date. A rep logs in, chooses Next, completes the task, and chooses Next again. Managers see what’s queued, started, and done on the dashboard, instead of in a shared spreadsheet.