10. Procesi
Poglavlje 10

Procesi

Proces je niz koraka koji potok sam izvodi za svaku novu vrednost kolekcije: obavesti ulogu, sačeka odluku, napravi podgrupu, napiše poruku. Aplikacija proces opisuje grafom u pravilu kolekcije, prati njegove instance i izvršava zadatke. Na kraju poglavlja su procesi koje urednici crtaju u samom potok-u.

10.1. Proces u pravilu kolekcije

Pravilo kolekcije dobija process: {name, graph}, i potok za svaku novu vrednost te kolekcije pokreće jednu instancu.

10.2. Graf: elementi

Graf je {nodes, flows}, a elementi se zovu kao u BPMN-u. Instanca u svakom trenutku stoji na jednom elementu; paralelnih tokova nema.

ElementŠta radiTraži
startEvent, endEventpočetak (tačno jedan) i kraj (bar jedan)
exclusiveGatewayuzima prvi tok čiji condition važi, inače svoj default tok
serviceTask, action: "message"piše text u grupu aplikacije (in: "app", podrazumevano) ili u podgrupu koju je napravio element instance (in: njegov id)post_values
serviceTask, action: "subgroup"pravi podgrupu name; admins su ključevi uloga, "owner" i "triggered_by" (podrazumevano poslednja dva); sa inherits nasleđuje članove grupe aplikacije, sve ili, uz inherit_roles, samo nosioce tih ulogacreate_subgroups
serviceTask, action: "push"šalje text (do 240 znakova) ljudima uloge role, kao pominjanje ulogemention_roles
userTaskčeka da neko sa ulogom role izabere jedan od outcomes (do 10), do opcionog deadline
timerčeka duration

10.3. Graf: tokovi

Tok vodi from jednog elementa to drugog. Običan tok nema ništa više; ostali imaju tačno jedno od:

import type { PotokConfigData, PotokProcessGraph } from './potok';

const approval: PotokProcessGraph = {
  nodes: [
    { id: 'start', type: 'startEvent' },
    { id: 'big', type: 'exclusiveGateway', label: 'Veliki iznos?' },
    { id: 'notify', type: 'serviceTask', action: 'push', role: 'admin', text: 'Nova prijava: {{title}}' },
    { id: 'review', type: 'userTask', role: 'admin', outcomes: ['odobri', 'odbij'], deadline: 'P3D', label: 'Pregled' },
    { id: 'approved', type: 'serviceTask', action: 'message', text: 'Odobreno: {{title}}' },
    { id: 'rejected', type: 'serviceTask', action: 'message', text: 'Nije odobreno: {{title}}' },
    { id: 'end', type: 'endEvent' },
  ],
  flows: [
    { from: 'start', to: 'big' },
    { from: 'big', to: 'notify', condition: { field: 'amount', op: '>', value: 1000 } },
    { from: 'big', to: 'approved', default: true },
    { from: 'notify', to: 'review' },
    { from: 'review', to: 'approved', outcome: 'odobri' },
    { from: 'review', to: 'rejected', outcome: 'odbij' },
    { from: 'review', to: 'rejected', deadline: true },
    { from: 'approved', to: 'end' },
    { from: 'rejected', to: 'end' },
  ],
};

const data: PotokConfigData = {
  rules: { applications: { write: ['everyone'], process: { name: 'Prijave', graph: approval } } },
};

console.log(Object.keys(data.rules ?? {}));

10.4. Kad graf ne prolazi

Pravilo se čuva samo sa grafom koji instanca može da završi: jedan početak, svaki element dostižan od njega i u stanju da stigne do kraja, tok za svaki ishod i ključevi uloga koje grupa ima. Inače saveConfig vraća invalid_process sa collection, path (brojano od pravila, npr. process.graph.nodes.3.outcomes) i reason (npr. no_flow, unknown_role).

Urednici uz getConfig i saveConfig dobijaju process_warnings, po kolekciji: missing, prava koja profilu procesa fale za njegove akcije, i owner_left, da vlasnik više ne uređuje aplikaciju.

10.5. Instance

status
running, waiting, done, failed ili cancelled.
element, wake_at
Element na kome stoji i kad je budi tajmer ili rok zadatka.
value_id
Vrednost za koju radi.
error
{element, reason} kad je instanca pala.
groups
Podgrupe koje je napravila, po elementu.
task
Zadatak na koji čeka: {element, outcomes, deadline_at, can_complete}; can_complete kaže da li ga gledalac sme završiti.
log
Ko je šta odlučio, od najstarijeg: {at, element, outcome, comment, "form?", by}.

10.6. Pozivi

listProcesses(collection, {ids?})
Instance koje gledalac sme da vidi (vrednosti koje čita u celosti i svoje), od najnovije, najviše 100. ids ostavlja instance tih vrednosti.
completeTask(id, element, outcome, {comment?})
Završava zadatak na kome instanca id čeka, za nekoga sa ulogom zadatka. comment (do 1000 znakova) ide u dnevnik.
retryProcess(id)
Za urednike: pokreće palu instancu tamo gde je stala.
cancelProcess(id)
Za urednike: otkazuje instancu koja radi, čeka ili je pala.

Kad se instanca pomeri, onValues javlja {event: "process", collection, id} i ništa više: aplikacija je ponovo čita sa listProcesses, koji pokazuje samo ono što gledalac sme.

async function decide(valueId: number, outcome: string) {
  const reply = await window.potok.listProcesses('applications', { ids: [valueId] });
  if (!reply.ok) return console.error(reply.error);

  const run = reply.processes[0];
  if (!run?.task?.can_complete) return;   // nothing waits on this viewer
  const done = await window.potok.completeTask(run.id, run.task.element, outcome, { comment: 'Pregledano.' });
  if (!done.ok) console.error(done.error);
}

const stop = window.potok.onValues((change) => {
  if (change.event === 'process') console.log('instanca', change.id, 'se pomerila');
}, { collection: 'applications' });

void decide(42, 'odobri');
window.addEventListener('pagehide', stop, potok.eventListenerOptions);

Ko je pokrenuo korak (triggered_by) je na početku autor vrednosti (niko za anonimnu), zatim onaj ko je završio zadatak, a niko posle tajmera ili roka. Instanca napravi najviše 1000 koraka u životu, a proces najviše 60 u minuti; ostalo čeka sledeći prolaz, na svakih 30 sekundi. Korak koji ne uspe zaustavlja instancu, sa opisom u error.

10.7. Greške procesa

KodKada
invalid_processgraf ne može da važi (odeljak 10.4)
not_waitingcompleteTask: instanca više ne čeka taj zadatak
invalid_outcomecompleteTask: zadatak nema taj ishod
process_inactivecompleteTask: proces je uklonjen iz pravila
not_failedretryProcess: instanca nije pala
not_runningcancelProcess: instanca se već završila
not_hereopenProcessForm, openProcessStart iz lista preko druge strane (showGroup)

10.8. Procesi nacrtani u potok-u

Urednici grupe mogu i sami da nacrtaju procese u potok-u, na kartici Procesi. Ti procesi nisu aplikacijini: listProcesses ih izostavlja, a njihovi pomaci ne šalju događaj process. Aplikacija sme da vidi samo ono što od gledaoca traže, a popunjavaju ga potok-ovi dijalozi:

listWaiting()
Šta čeka gledaoca u grupi, najbliži rok prvi; samo za članove. Svaki zadatak je {id, process, element, label, kind, title, text, deadline_at, outcomes, attributes, started_by_viewer}: kind je "form" (forma sa attributes) ili "decision" (odluka sa outcomes).
openProcessForm(id)
Otvara potok-ov dijalog forme preko aplikacije. Aplikacija formu čita, ali je nikad sama ne popunjava.
completeTask(id, element, outcome, {comment?})
Završava i nacrtanu odluku koja čeka gledaoca.
listStartable()
Nacrtani procesi koje gledalac sme ručno da pokrene: {id, name, takes, attributes}, gde je takes "entity" (atributi) ili "text" (naslov i tekst).
openProcessStart(id, {prefill?})
Otvara potok-ov dijalog Start, sa prefill (po atributu, ili title i text) koji gledalac može da promeni.
onWaiting(listener)
Javlja da se promenilo ono što čeka gledaoca; pročitaj ponovo sa listWaiting. Vraća funkciju za odjavu.
async function showWaiting() {
  const reply = await window.potok.listWaiting();
  if (!reply.ok) return console.error(reply.error);
  for (const task of reply.tasks) {
    console.log(task.kind, task.title ?? task.label, task.deadline_at);
  }
}

async function openFirstForm() {
  const reply = await window.potok.listWaiting();
  const form = reply.ok ? reply.tasks.find((task) => task.kind === 'form') : undefined;
  if (form) await window.potok.openProcessForm(form.id);
}

const stop = window.potok.onWaiting(() => void showWaiting());
void showWaiting();
void openFirstForm();
window.addEventListener('pagehide', stop, potok.eventListenerOptions);

Kako aplikacije, procesi i potok razgovaraju i gde svako staje objašnjava strana pomoći Potok, procesi i aplikacije.

Dev mock

Proces kolekcije radi u samoj stranici, a instance stoje pod ključem potok-dev:processes. Servisni koraci samo pišu u konzolu šta bi potok uradio. Poruka čiji tekst ispadne prazan obara instancu sa empty_text, kao u potok-u, pa retryProcess ima šta da pokrene. Tajmeri i rokovi bude instancu dok je stranica otvorena, ili pri sledećem pozivu. Od nacrtanih procesa (listWaiting) gledaoca čekaju dva stalna primera, forma i odluka.