Paik Labs

Design a process template

Templates are designed by Confluence admins in the LINA administration (tab Templates), and — if the app configuration allows it — by space admins for their own space (Space settings → Integrations → LINA → Process templates). The designer is the same in both places.

The quickest start is a copy of a sample template: select one marked Bundled and click Copy (the two-sheet icon). Then change what you need.

The designer at a glance

Each column can be folded to get more room for the canvas. The folded right panel still lists its tabs; click one to open it.

Create a template

  1. Create → Create process.
  2. Enter Name (unique) and optionally Description.
  3. Scope: Global (offered in every space) or Selected spaces.
  4. The template starts with a Start figure. Add figures and lines, then Save.

Add figures

Drag a figure from the Objects palette onto the canvas. Hover over an object in the palette to see what it is for. The last icon in the palette header switches between pictures and Text only. New figures get a name like Condition 1; rename them in Selected object — the name is what people see on the page (LINA · Review).

In the palette Figure
Condition (waits, then goes on) waits for tickets, a person or a due date
Manual fork a person chooses the branch
Automatic fork the branch follows the document state
Branch end an End
Subprocess (choose template) runs a subprocess template; saved subprocesses are also listed by name under Subprocesses

To delete a figure or line, select it and press Delete (or Delete in the panel). Start cannot be deleted.

Draw lines

  1. In the header of the Objects palette, click the line icon (Draw a line, two dots joined by a line).
  2. Click a figure, then another. A line joins them.
  3. After one line the designer goes back to moving and selecting (the hand icon, Move and select). For the next line, click the line icon again. Esc cancels.

You can also drag from the dot on a figure’s edge to another figure. Esc or a click on an empty spot cancels a half-drawn line.

Or right-click a figure and choose Add line, then click the figure the line leads to. Nothing leads out of an End, so there the item is greyed out.

Start, a Condition and a Subprocess have one line out. If you draw a second line from a Condition, LINA inserts a Manual fork after it, and both lines go from the fork.

Set what a Condition or End waits for

Select the figure. Under Goes on when (or Ends when for an End) tick any of:

All ticked must hold. Without A person confirms (clicks Continue), the process moves on by itself as soon as they do.

An End with nothing ticked ends the process as soon as it gets there. An End in a subprocess must wait for something — that says when the subprocess is over.

Forks

Manual fork: each line out needs a label — select the line and fill Condition (shown above the line), for example Approve. People see the labels as choices on the page. Tick Choosing this branch needs a comment where a reason is needed, for example for Reject.

Automatic fork: set Branches by to Document state. Each line out is For the document state of one state; mark one line Otherwise branch for all the other states and for a document without a state. The template needs document states first.

In this version, an automatic fork can branch only by the document state. The option Yes / no cannot be published yet.

Lines may lead back to an earlier figure, for example Reject back to Draft. The process then starts a new round there.

Add actions to a line

  1. Pick an action in the palette (Create ticket, Send e-mail, Set state) and click a line. Or select the line and use Add under Actions on this line.
  2. Fill the action in Selected object.

Actions on the first line (from Start) run when the process starts.

Create ticket

  1. Find project, then choose Project and Issue type. LINA loads the fields of the create screen from Jira.
  2. Fill Summary, Description and any mandatory fields.
  3. Tick Required for approval (the gate waits for this ticket) if the document must wait for it.
  4. Copy the due date of the figure this line leads to into the ticket’s Due date is on by default — see Due dates.

Tickets are created as the template’s Service account (see Settings), or by LINA itself when there is none.

Send e-mail

Write Text and choose people under Mention. LINA writes the text as a comment on the page mentioning them; Confluence sends the e-mail.

Set state

Choose the State. See Document states.

Placeholders

In ticket fields and e-mail texts you can write:

Placeholder Filled with
{page} page title
{link} link to the page
{user} who made the step
{date} today
{process} template name
{step} where this line leads
{due} due date

Subprocesses

A subprocess is a template of type Subprocess (Create → Create subprocess). Use it for a part that repeats in several processes, for example a language review with its own ticket.

Settings

Tab Settings of a template:

Save and publish

Runs that already started keep the version they started with.

Copy and delete

Sample templates

The list starts with ready-made samples marked Bundled: Document lifecycle, Procedure with proofreading (with its subprocess Proofreading), New procedures start by themselves, Specification to Jira work and Decision record. You can only view and copy them. What each is for and what to fill in after Copy: Examples.

Copying a sample that uses a subprocess copies the subprocess too, and the copy points at the copied subprocess. Publish the subprocess first.