Vigia PDF Open Studio →

Vigia Studio · User guide

Design a live K2 dashboard, step by step

From the first template to the K2 form your colleagues open every morning: how to choose blocks, read the numbers, restrict a dashboard to a K2 folder and deploy it.

17templates
43blocks
15themes
1K2 package
Vigia Studio

Live dashboards
for Nintex K2
User guide

Design a dashboard from a template, set up its blocks, restrict it to a K2 folder and deploy it in K2 as a form.

ai.fluxcaster.com/vigiaNovember 2026 · AI FluxCaster

01Before you start

Vigia Studio builds a dashboard on the data K2 already records about your workflows. You design it in the Studio with sample data, then download one K2 package. Once deployed, the dashboard is a K2 form: people open it in K2 and see live numbers.

What you need in K2

  1. SmartObject OData enabled in K2 Management › Integration › APIs.
  2. The workflow reporting SmartObjects published in OData: Process Instance (requests), Activity Instance Destination (open tasks and decisions) and Activity Instance (steps); Process Set (deployed workflows) is optional. Vigia finds them by name, in the Workflow Reports category or in the Workflow Analytics category (…AnalyticsProcessInstance, …AnalyticsActivityInstanceDestination, …AnalyticsActivityInstance, …AnalyticsProcessSet). You can also give their entity-set names.
  3. The Workflow REST API enabled. It gives the signed-in person's own tasks (block “My tasks”, and a fallback when the worklist SmartObject is missing).
  4. The right to deploy a package (K2 Management › Packages, or the Deploy-Package command).
NoteYou can design and preview everything without K2: the Studio always uses sample data. K2 is only needed when you deploy.

Which SmartObject feeds what

SmartObject (Workflow Analytics)Data in VigiaIf it is not published
Process InstanceRequests: started, completed, cycle time, status, originator.Request blocks say which SmartObject to publish.
Activity Instance DestinationOpen tasks (no finish date) and decisions (Final_Action).The signed-in person's own tasks are used.
Activity InstanceSteps: pipeline, step durations, steps on time.Step blocks say which SmartObject to publish.
Process SetWorkflows deployed (catalogue, workflow filter).Workflows are taken from the requests.
Event InstanceEvents, human or automated; automated share. K2 lists the server events only when they are included in its reporting; otherwise the automated share is 0.Event blocks say which SmartObject to publish.
TaskActions of people (ActionName, Actioner).Used as decisions only when Final_Action is missing.
Process OverviewWorkflow bubbles, since deployment.Calculated from the period's requests.
User OverviewTeam scorecard (completes the open tasks).Calculated from the tasks and steps. Ignored when the dashboard is limited to a K2 folder.
Workflow StatusStatus by workflow.Calculated from the period's requests.
IPC DetailsSub-workflow map, sub-workflows started.The map says which SmartObject to publish.
Process Data AuditData values, data changes feed, data changes.Data blocks say which SmartObject to publish.
TemplateThe Workflow Analytics template puts every one of them on one page. Open it in the Studio to see each block with sample data.
Workflow AnalyticsVigia reads the OData $metadata to know each SmartObject's fields. It builds the workflow name from Folder and ProcessName when there is no full name, takes the workflow of a step from its request and the person from the task, and reads the decision of each completed task in Final_Action.

Words used in this guide

WordMeaning
RequestOne workflow instance (a purchase request, a leave request…).
StepOne activity of a request, once it has been done.
DecisionThe action chosen on a completed task (Approve, Reject, Send back…).
Open taskA task waiting in someone's worklist right now.
LateAn open task older than the late threshold you set (72 hours by default). The same threshold says whether a step was done on time.
PeriodThe time window of the dashboard: last 7, 30 or 90 days, or 12 months. Open tasks do not depend on it: they are the present state.

02Create a dashboard

Open ai.fluxcaster.com/vigia/studio and create an account with your name, email and a password. A Helvia Studio account works too.

My dashboards: your dashboards on top, then the templates, each one shown live with sample data.
My dashboards: your dashboards on top, then the templates, each one shown live with sample data.
  1. Click a template, or + New dashboard.
  2. Give the dashboard a name. You can still change the template in the dialog.
  3. Click Create: the editor opens with the template's blocks already in place.
New dashboard dialog

Which template?

Pick the one closest to the question your readers ask, and to the screen they will use. Each template has its own theme; you can change the theme later without losing the blocks.

Up to 30 dashboards per account. Duplicate a dashboard from the list to start a variant.

FuturisticProcess controlHUD Night · Wall screens, operations rooms
ModernWhere the work isHUD Day · The everyday view of a K2 team
ContemporaryWeekly reportEditorial paper · A weekly page for managers
ContemporaryTeam boardPop studio · A team's own board
StandardControl roomControl room · Supervision: heat, waiting matrix, alerts
FuturisticExecutive pulseAurora glass · Executives: four numbers and the trend
ModernClean overviewSwiss minimal · Clean reports, printed or projected
StandardOperations overviewCorporate · Company intranet, familiar look
FuturisticOps terminalTerminal · IT and support teams
ContemporaryBento teamBento · Teams, friendly and warm
FuturisticCyber opsNeon cyber · Showrooms, big screens
ModernBold boardBrutalist · One message that must be seen
ContemporaryBoard meetingBlack & gold · Board meetings, quarterly reviews
FuturisticCommand centerHolo teal · Command centres, wall screens
FuturisticMission gridHolo blue · Control rooms, monitoring
All SmartObjectsWorkflow AnalyticsHUD Night · Every Workflow Analytics SmartObject on one page
Start emptyBlank dashboardHUD Day · A title and three numbers

03Arrange the blocks

The editor.1234567
The editor.
  • 1Blocks: the palette, with a filter. 43 blocks in five families.
  • 2Drag a block onto the dashboard, or click it to add it at the bottom.
  • 3The dashboard, drawn at 1,440 px wide (a usual screen) and scaled to fit.
  • 4A block: click to select it, drag to move it, drag its bottom-right corner to resize it.
  • 5Block and Dashboard panels: the settings.
  • 6Undo, redo and Preview (opens the dashboard alone, full screen).
  • 7K2 package…: download the package to deploy.

The grid

The dashboard is a grid of 12 columns. A row is 56 px high, with 14 px between blocks. When you drop or resize a block, the blocks in the way move down, then everything settles upwards: there are no holes to fix by hand.

Dragging a block from the palette: a dashed outline shows where it will land.
Dragging a block from the palette: a dashed outline shows where it will land.

Keyboard

KeysAction
← → ↑ ↓Move the selected block by one column or one row.
Delete / BackspaceRemove the selected block.
Ctrl Z (⌘ Z)Undo.
Ctrl Shift ZRedo.
TipChanges are saved as you go (“Saved” in the top bar). Nothing reaches K2 until you download and deploy a new package.

04Set up each block

Block panel
The Block panel of a donut.

Select a block to see its settings. Every block has a title, a width (columns) and a height (rows), and the buttons Duplicate and Delete. The other fields depend on the block:

FieldChoices
ValueOne of the 19 values (next chapters): open tasks, cycle time, steps on time…
DataOpen tasks (worklist), requests (workflow instances), steps (activity history), decisions (completed tasks and their action), events (human and automated), data changes or sub-workflow calls.
Group byWorkflow, step, person, status, started by, waiting time, cycle time, step duration, weekday, hour, day, week, month (depending on the data).
MeasureCount, late count, average waiting time or average duration.
ItemsHow many bars, slices or rows; the rest is grouped as “others”.
Lines / CountRequests started, requests completed, steps completed, tasks received; per day or per week.
WorkflowFor the pipeline and the funnel: empty means the busiest workflow.
Target, maximumFor gauges, dials and progress bars.
ColorLeave “Theme color” to follow the theme, or pick a color for this block.
NoteA block whose data is not available in K2 says which SmartObject to publish, instead of showing a wrong number.

05The 43 blocks

Default size in columns × rows. Every block can be resized.

BlockWhat it showsSize
Numbers9
NumberOne key figure, with its period or a caption you write.3×2
Number + trendA key figure with a small trend line of the period beside it.3×2
Number vs previous periodA figure compared with the previous period: arrow, percentage and previous value. Tick “Lower is better” for durations.3×2
GaugeA half-circle gauge with an optional target mark. Best for percentages such as steps on time.3×3
RingA full ring with the value in the middle. Good for shares (late share, completed / started).3×3
DialA round dial with graduations that light up to the value, a marker and an optional target.3×4
Progress to targetA bar towards a target you set (for example 1,500 completed requests this month).4×2
Four numbersFour small figures in one tile.4×3
Status lineA thin status line with up to eight figures across the full width.12×1
Charts15
Line chartLines over time: requests started, completed, steps completed or tasks received, per day or per week.6×4
Area chartThe same as the line chart, with filled areas.6×4
Bar chartVertical bars grouped by any field: workflow, step, person, weekday, week, month… The largest bar uses the second color.4×4
Ranked barsHorizontal ranked bars, the best way to compare names (workflows, steps, people).4×4
Stacked barsBars over time, split by workflow or by status.6×4
DonutShares of a whole, with the total in the middle and a legend.4×4
PieShares of a whole, as a pie.3×4
Duration histogramHow long things take: requests, steps or the waiting time of open tasks, in duration bands.4×4
Weekday × hourWeekday × hour of day: when requests start, when steps finish or when tasks arrive.6×4
CalendarOne square per day over several weeks, darker when more was done.6×3
TreemapRectangles sized by count, for example the open tasks of each person.4×4
Small multiplesOne small trend per workflow, side by side, with its total.12×2
Ridge wavesOne wave per workflow over 30 days, stacked like a relief. Each wave has its own scale (5-day average); the total is written next to the name.8×6
Workflow bubblesOne bubble per workflow: requests across, average cycle time up, open tasks as the size. Uses Process Overview when it is published, otherwise the period's requests.6×5
Data valuesThe latest value of one workflow data field in each request (Process Data Audit): total, average and spread for numbers, ranked values for text.4×4
Process6
Step pipelineThe steps of one workflow in order: open requests per step, average time and the slowest step highlighted.12×3
FunnelHow many requests reach each step of a workflow.4×4
Workflow × waiting timeWorkflows × waiting time of their open tasks (under 1 day, 1–3 days, 3–7 days, over 7 days).6×4
Status summaryCounts by status (requests, open tasks or steps) as coloured pills.4×2
Status by workflowEach workflow's requests split by status in one bar (Workflow Status, or the period's requests).6×4
Sub-workflow mapWhich workflow starts which sub-workflow, and how often (IPC Details). Band width = number of calls. When K2 gives only the calling workflow, the block ranks the workflows by sub-workflow calls.6×5
Lists7
TableA table of open tasks, requests or steps, sorted by oldest, newest or longest.6×4
PeoplePeople ranked by open tasks, late tasks or average waiting time.4×4
Live feedThe latest events: requests started and completed, steps done.4×4
My tasksThe tasks of the person who opens the dashboard, with a button to open each one in K2.4×4
Late tasksOpen tasks older than the late threshold, oldest first, with the person who has them.4×4
Team scorecardOne line per person: open tasks, late tasks, steps done and average step time (User Overview completes what the tasks show).6×5
Data changesThe latest changes of workflow data: field, new value, request and who changed it (Process Data Audit).4×4
Content6
TitleA section title and subtitle, without a frame.6×1
TextA short note for the readers.4×2
Image or logoAn image or a logo (PNG, JPEG, WebP, GIF or SVG, up to 300 KB), stored inside the K2 form.3×2
Date and timeThe date and time.3×2
K2 linksButtons that open K2 forms, by form name or address (for example “New purchase request”).4×2
DividerAn empty row, with or without a line, to separate sections.12×1

Click to filter

In a deployed dashboard, and in the Preview, every bar, slice, bubble, cell, row and step can be clicked. The click filters all the other blocks; the block you clicked keeps all its values and shows yours highlighted.

  • Same value everywhere. A workflow, a step or a person filters every block that has it.
  • Linked by request. A block without that value keeps the requests concerned: click Reject in the decisions, and the requests, events, sub-workflows and data changes show only the rejected requests. Click a person, and you see the requests they worked on.
  • One request. A row of a table, a late task or a line of the feed filters the whole dashboard to that request.
  • Several filters add up. Each block holds one filter; filters from different blocks combine. They are listed under the header: click one to remove it, or Clear all. Click the highlighted item again, or press Esc.
  • Numbers follow. Key figures, gauges and the status line are calculated on the filtered data. The period, workflow and person lists at the top still apply.
NoteThe Studio editor does not filter: there a click selects the block to edit. Use Preview to try the filters.

06The values

The values used by number, gauge, ring, dial and progress blocks. “Period: yes” means the value follows the period filter; the others describe the present.

ValueMeaningDataPeriod
Open tasksTasks waiting in worklists right now.Open tasks—
Late tasksOpen tasks older than the late threshold (hours).Open tasks—
Late share of open tasksLate tasks as a share of open tasks.Open tasks—
Avg. wait of open tasksAverage age of the open tasks.Open tasks—
Oldest open taskAge of the oldest open task.Open tasks—
People with open tasksNumber of people who have at least one open task.Open tasks—
My tasksTasks of the person who opens the dashboard (Workflow REST API).My tasks—
Active requestsRequests still running.Requests—
Requests startedRequests started during the period.Requestsyes
Requests completedRequests completed during the period.Requestsyes
Completed / startedCompleted divided by started, for the period.Requestsyes
Requests in errorRequests in error.Requests—
Avg. cycle timeAverage time from start to end of the requests completed in the period.Requestsyes
Median cycle timeMedian of the same cycle times (less sensitive to a few very long requests).Requestsyes
Completed per dayRequests completed per day, on average, over the period.Requestsyes
Workflows in useNumber of different workflows with requests.Requests—
Steps done within SLAShare of the steps completed in the period that took less than the late threshold.Stepsyes
Avg. step durationAverage duration of the steps completed in the period.Stepsyes
Steps completedSteps completed during the period.Stepsyes
Decisions madeTasks completed with an action (Approve, Reject…) during the period.Decisionsyes
Rejected or sent back (share of decisions)Share of those decisions that rejected or sent the request back.Decisionsyes
Workflows deployedWorkflows deployed in the dashboard's folder (Process Set), or the workflows with requests.Requests—
Events completedEvents finished during the period, human and automated (Event Instance).Eventsyes
Automated share of eventsShare of those events done by the K2 server, with no person (e-mails, updates, documents…).Eventsyes
Avg. automated event timeAverage time of the automated events finished in the period.Eventsyes
Sub-workflows startedSub-workflows started by another workflow during the period (IPC Details).Sub-workflow callsyes
Data changesChanges of workflow data recorded during the period (Process Data Audit).Data changesyes
Data fields changedNumber of different data fields changed during the period.Data changesyes

Duration bands

Waiting time of open tasks: under 1 day, 1–3 days, 3–7 days, over 7 days. Durations of requests and steps: under 1 hour, 1–4 hours, 4–24 hours, 1–3 days, 3–7 days, over 7 days.

07Dashboard settings

Dashboard panel: look
Name, title, theme, colors, logo.

Look

  • Dashboard name: the name in your list in the Studio.
  • Title and subtitle: shown at the top of the dashboard, in K2.
  • Theme: 15 themes. Changing it keeps the blocks and resets the two colors.
  • Main color (lines, bars, rings) and second color (the largest bar, the first rank, the slowest step). Theme puts the theme's color back.
  • Logo: shown next to the title. PNG, JPEG, WebP, GIF or SVG; it is stored inside the K2 form.
Dashboard panel: filters and data
Filters and data, with a K2 folder.

Filters and data

  • Default period: 7, 30, 90 days or 12 months.
  • Period, Workflow and Person filters: the lists readers get at the top of the dashboard.
  • Late after (hours): the late threshold. Use your real service level (for example 48 hours).
  • Refresh (seconds): how often the dashboard reads K2 again (15 seconds to 1 hour, 60 by default).
  • K2 folder: only the workflows of this folder and its sub-folders are read and shown. Several folders: separate them with “;”. In K2 it becomes the Vigia_Folder parameter.
  • Only these workflows: one workflow (Folder\Workflow) or folder per line, to narrow further.
  • K2 SmartObjects (OData): the entity-set names, if Vigia does not find them by itself.
TipOne K2 folder per audience: a Finance dashboard on Company\Finance, an HR dashboard on Company\HR. Duplicate the dashboard and change the folder, or keep one package and change Vigia_Folder in K2 Designer.

08Designing a good dashboard

A good dashboard answers one question in a few seconds. The Studio makes it easy to add blocks; the hard part is to leave some out.

Six rules

1 · Start from one question

“Where are purchase requests stuck?” is a dashboard. “Everything about K2” is not. Write the question in the subtitle.

2 · Key numbers first

People read from the top left. Put 3 or 4 numbers in the first row, 3 columns each, with their comparison or trend.

3 · Then the trend, then the detail

Middle rows: how it moves (line, area, bars per week). Bottom rows: what to act on (late tasks, oldest tasks, people).

4 · Six to twelve blocks

Beyond that, nobody reads the bottom. Make a second dashboard for another audience instead.

5 · Pick the theme for the screen

Dark themes for wall screens and big rooms, light themes for desks and printing, editorial themes for managers.

6 · Set the real thresholds

Late threshold, targets and maximums must match your service levels, or “late” and “on time” mean nothing.

Which block for which question

QuestionBlocks
How many, right now?Number, Four numbers, Status line
Better or worse than before?Number vs previous period, Number + trend
Are we on time?Gauge, Dial, Ring with “Steps done within SLA” or “Late share”
Where are requests stuck?Step pipeline, Funnel, Workflow × waiting time
Who has the most waiting?People, Ranked bars by person, Treemap
When does the work arrive?Weekday × hour, Calendar, Bar chart by weekday
How does each workflow move?Small multiples, Ridge waves, Stacked bars
What must I do now?Late tasks, My tasks, Table (oldest first)

Three layouts to copy

Weekly management page

Theme: Editorial paper, Swiss minimal or Black & gold. Read once a week.

TitleΔ cycleΔ on timeΔ doneΔ startedLine · per weekSlowest stepsSmall multiples · per workflow

Operations wall screen

Theme: HUD Night, Holo teal or Control room. Seen from far away, all day.

Status lineDialDialPipelineHeat · weekday × hourLate tasksLive feed

Team board

Theme: Pop studio, Bento or Corporate. Opened by the team every morning.

Open tasksMy tasksLateMy tasks listPeoplePer weekdayOldest tasks

Before you deploy

  • Open Preview and read the dashboard as a newcomer would: is every title clear without explanation?
  • Check the widths: numbers need 3 columns, charts 4 to 8, tables 6 or more.
  • Deploy a Demo package first if the Workflow Reports SmartObjects are not published yet, to show the dashboard in K2.

09Deploy in K2

Download the K2 package
  1. Click K2 package… in the top bar.
  2. Check the K2 form name (letters, digits and _, for example Vigia_Purchasing) and the K2 category. Use « / » for sub-categories: Vigia/Demo puts the form in the category Vigia › Demo. Both are kept in the dashboard (Dashboard settings › K2 form name, K2 category) and proposed again at the next export.
  3. Choose Live (real K2 data) or Demo (sample data, to show the dashboard before the SmartObjects are published).
  4. Click Download (.kspx).
  5. In K2 Management › Packages, deploy the file.
  6. Open the form in K2: from K2 Designer, or at /Runtime/Runtime/Form/<form name>/.
The dashboard in K2: live data, read with the session of the person who opens the form.
The dashboard in K2: live data, read with the session of the person who opens the form.

What the package contains

One K2 view and one K2 form, in the category you chose. The view holds three data labels you can read in K2 Designer: Vigia HTML, Vigia CSS (with the fonts) and Vigia JS (the engine and your dashboard). Deploying a new package of the same dashboard updates the view and the form in place.

Form parameters

Change them in K2 Designer › form › Parameters, without a new export.

ParameterDefaultUse
Vigia_FolderThe K2 folder set in the StudioOnly the workflows of this folder (and sub-folders) are read and shown, for example Demo 3D or Finance\Purchasing (a leading or trailing “/” or “\” is ignored). Several folders: separate them with “;”. It cannot be changed from the address bar. The folder appears under the dashboard title when it is applied.
Vigia_OData_InstancesemptyEntity set of Process Instance. Empty: found automatically.
Vigia_OData_TasksemptyEntity set of Activity Instance Destination (open tasks).
Vigia_OData_ActivitiesemptyEntity set of Activity Instance (steps).
Vigia_Refresh_Seconds60How often K2 is read again (15 at least).
Vigia_Max_RowsemptyNo limit: K2 returns only the period chosen at the top of the dashboard. A number caps the rows read per SmartObject.

10Data and security

  • The data stays in K2. Once deployed, the form reads K2 from the browser of the person who opens it, with that person's own K2 session. No server in between, no copy elsewhere. The Studio only stores the layout of your dashboards.
  • K2 permissions apply. Each reader sees what their K2 rights on the SmartObjects allow. Someone who cannot read the worklist SmartObject still sees their own tasks.
  • The K2 folder is asked of K2 itself ($filter on the workflow's full name). If K2 refuses that filter, the rows of other folders are dropped as soon as they arrive, before any calculation.
  • The period decides what is read. K2 returns what started, finished or changed during the period chosen at the top (7 days, 30 days, 90 days or 12 months) and the period before it (for the comparisons), plus everything still running. There is no row limit; Vigia follows K2's pages. Choosing another period reads K2 again.
ImportantThe K2 folder is a display restriction, not a security barrier: when K2 refuses the filter, the browser still receives the other rows before dropping them. To truly protect data, set the K2 rights on the Workflow Reports SmartObjects and on the workflows.

11Troubleshooting

You seeWhyWhat to do
“The K2 OData API does not answer”SmartObject OData is not enabled.Enable it in K2 Management › Integration › APIs.
“No Process Instance SmartObject published in OData”The SmartObject is not published, or has another name.Publish it, or give its entity-set name in Vigia_OData_Instances.
Status “K2 · data missing”None of the three SmartObjects could be read.Hover the status to read the reason of each one.
Notes say “your tasks” instead of “right now”The worklist SmartObject is not readable: the person's own tasks are used instead.Publish Activity Instance Destination, or give its name in Vigia_OData_Tasks.
“Your K2 tasks are not readable”The Workflow REST API is off.Enable it in K2 Management › Integration › APIs.
Empty dashboard after setting a K2 folderThe folder does not match the full workflow names.Use the folder path as K2 shows it (for example Company\Finance); case does not matter.
Totals seem too low on long periodsVigia_Max_Rows is filled in and caps the rows read.Empty Vigia_Max_Rows in K2 Designer › Parameters.
Studio changes are not in K2K2 runs the last package deployed.Download the package again and deploy it.
“Vigia could not start”A data label of the view was changed or removed.Deploy the package again.
HelpWrite to contact@fluxcaster.com with a screenshot and the text of the status (hover it in the dashboard).