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.
- Prvo čuvanje daje procesu sopstveni profil po imenu
name(do 60 znakova). Profil ulazi u grupu aplikacije sa onim što tamo imaeveryonei potpisuje sve što proces radi. Urednik koji je sačuvao pravilo je vlasnik procesa. - Bez
graphproces ništa ne pokreće. - Uklanjanje procesa iz pravila otkazuje njegove instance koje rade ili čekaju.
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.
idelementa: mala slova, cifre,-i_, počinje slovom, do 40 znakova.label(do 60) ga imenuje na crtežu i tamo gde instanca čeka ili je stala.- Tekstovi i imena mogu da sadrže polja vrednosti, kao
{{title}}ili{{a.q1}}, i odluku zadatka, kao{{task_id.outcome}}. - Trajanja su ISO 8601 (
PT30M,PT1H,P3D,P1W), od minuta do godine.
| Element | Šta radi | Traži |
|---|---|---|
startEvent, endEvent | početak (tačno jedan) i kraj (bar jedan) | |
exclusiveGateway | uzima 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 uloga | create_subgroups |
serviceTask, action: "push" | šalje text (do 240 znakova) ljudima uloge role, kao pominjanje uloge | mention_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:
outcome: zadatak izlazi tim tokom kad je izabran taj ishod (svaki ishod mora imati svoj tok);deadline: true: zadatak sa rokom izlazi ovuda kad rok prođe;condition: grananje uzima ovaj tok ako uslov važi:{field, op, value}saopjednim od=,!=,<,>, ili{field, op: "empty"}. Poredi kao brojeve kad su obe strane brojevi, inače kao tekst;default: true: grananje ide ovuda kad nijedan uslov ne važi.
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
statusrunning,waiting,done,failedilicancelled.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_completekaž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.
idsostavlja 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
| Kod | Kada |
|---|---|
invalid_process | graf ne može da važi (odeljak 10.4) |
not_waiting | completeTask: instanca više ne čeka taj zadatak |
invalid_outcome | completeTask: zadatak nema taj ishod |
process_inactive | completeTask: proces je uklonjen iz pravila |
not_failed | retryProcess: instanca nije pala |
not_running | cancelProcess: instanca se već završila |
not_here | openProcessForm, 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}:kindje"form"(forma saattributes) ili"decision"(odluka saoutcomes). 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 jetakes"entity"(atributi) ili"text"(naslov i tekst). openProcessStart(id, {prefill?})- Otvara potok-ov dijalog Start, sa
prefill(po atributu, ilititleitext) 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.
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.