Julkaisu-/lainaustyönkulut

Työnkulut alkavat vaikuttaa toimintaasi, kun olet julkaissut ne. Ennen kuin olet julkaissut kelvollisen työnkulun, suunnittelemasi työ pysyy luonnoksena:

Ennen kuin ESM sallii työnkulun ottamisen aktiiviseen toimintaan, se tarkistaa, onko työnkulun suunnittelussa merkittäviä virheitä, kuten puuttuvia ehtolausekkeita ehtotoiminnoista. Virheellisesti määritetyt elementit merkitään editorin kanvaasiin punaisilla reunuksilla, kunnes määritykset ovat kelvollisia.

Kun työnkulku on julkaistu aktiiviseen palveluun, kaikki uudet saapuvat ongelmat käynnistävät työnkulun suorittamisen, jos valintakriteerit täyttyvät.

Jos huomaat työnkulun julkaisemisen jälkeen, että se ei toimi odotetulla tavalla tai haluat poistaa sen käytöstä, voit poistaa työnkulun aktiivisesta palvelusta kirjaamalla sen ulos aktiivisesta palvelusta. Jos teet niin, työluonnos palautetaan uloskirjaamasi työnkulun määritelmän mukaiseksi. Kaikki uloskirjatun työnkulun käsittelemät keskeneräiset tehtävät pysyvät aktiivisina, ja ESM yrittää suorittaa ne loppuun uloskirjatun työnkulun määritelmän mukaisesti. Sinun on lopetettava kaikki tehtävät manuaalisesti, jos ne eivät valmistu itsestään. Uloskirjattu työnkulku ei enää käsittele mallipohjan uusia tehtäviä, vaan ne on käsiteltävä manuaalisesti tai korvaavalla työnkululla.

Työnkulun elinkaari

ESM seuraa saman työnkulun useita versioita:

• Työluonnos, joka on viimeisin tallentamasi versio.
• Viimeisin julkaistu työnkulku, jolla uudet tai päivitetyt tietokortit käsitellään, jos ne täyttävät työnkulun valintakriteerit.
• Kaikki aiemmin julkaistut työnkulkumääritysten versiot, kunhan datakortteja on vielä käsiteltävänä.

Kun avaat työnkulun työnkulkueditorissa, työskentelet oletusarvoisesti aina luonnosversion parissa. Jos päätät uloskirjata työnkulun aktiivisesta palvelusta (eli kumota julkaisutoiminnon), työnkulun luonnosversio palautetaan juuri uloskirjaamaksesi työnkulun versioksi.

Työluonnoksen muutoksia ei tallenneta automaattisesti tietokantaan. Sinun tulee tallentaa muutokset tai hylätä ne ennen kuin teet jotain muuta ESM:ssä.

Sinun on aina julkaistava muutoksesi, jotta ne aktivoituvat uusissa tai päivitetyissä datakorteissa. Kun julkaiset työnkulun aktiiviseen palveluun, kyseinen versio tallennetaan automaattisesti uutena luonnoksena.

Voit poistaa työnkulkuja ESM:stä valitsemalla Poista-painikkeen. Voit kuitenkin poistaa vain työnkulkuja, joissa ei ole avoimia ongelmia. Työnkulun poistaminen edellyttää, että ongelmat ovat joko käyneet läpi koko työnkulkusekvenssin tai ESM-käyttäjä on lopettanut ne. Et voi poistaa vanhoja työnkulkumääritysten versioita manuaalisesti. Järjestelmä poistaa ne, kun viimeinen datakortti on käsitelty.

Työnkulun uloskirjaaminen ei riitä poistamisen sallimiseen, koska työnkulussa saattaa olla edelleen aktiivisesti käsiteltävänä olevia ongelmia. ESM tarkistaa aina, onko ongelmia edelleen käynnissä, ennen kuin se sallii työnkulun poistamisen.

Työnkulkujen vienti/tuonti

Minkä tahansa työnkulun voi viedä työasemalle ja tuoda sitten uudelleen esimerkiksi tuotantojärjestelmään. Voit viedä ja tuoda työnkulkuja valitsemalla vastaavan toiminnon Työnkulku-pudotusvalikosta. Muista viedä ja tuoda myös vastaavat mallit.

Vienti vie valitun työnkulun viimeksi julkaistun version. Työluonnos viedään vain, jos julkaistua versiota ei ole.

Työnkulun solmujen vienti/tuonti

Yksittäisen työnkulun solmun voi viedä ja käyttää sitä uudelleen toisen mallin toisessa työnkulussa. Työnkulun solmun viemiseksi valitse ensin vastaava työnkulun solmu ja valitse sitten Työnkulku-pudotusvalikosta "Vie työnkulun solmu". Työnkulun solmu ladataan sitten tietokoneellesi.

Työnkulkusolmun tuomiseksi sinun on ensin valittava työnkulku, johon haluat tuoda työnkulkusolmun. Määritteet ja määritteiden arvot, joilla ei ole vastaavia alkioita kohdemallissa, korvataan tyhjillä kentillä tuonnin jälkeen. Tavanomainen työnkulun validointi tunnistaa mahdolliset korjaukset, jotka on tehtävä tuodussa työnkulkusolmussa.

Ongelman työnkulun tilan tarkistaminen

Työnkulkumoottori ylläpitää kunkin ongelman työnkulun tilaa. Työnkulun tila näkyy itse ongelman datakorttinäkymässä. Mahdolliset tilat ovat: Käynnissä, Valmis, Virhe tai Peruutettu. Työnkulun tila on järjestelmäarvo, mutta se voidaan tehdä näkyväksi määrittämällä WorkflowStatusHandler-attribuutille.

Kaikki käyttäjät voivat peruuttaa työnkulun suorituksen manuaalisesti napsauttamalla työnkulun tilailmaisinta.

Työnkulun konfiguraatioiden auditointi

ESM seuraa automaattisesti työnkulkujen muutoksia koko järjestelmän kokoonpanolokissa. Uusien työnkulkujen luominen, poistaminen, julkaiseminen, muokkaaminen ja uloskirjaaminen kirjataan aikaleimalla ja käyttäjätunnuksella varustettuna. Voit tarkastaa työnkulkujen muutokset kokoonpanolokitiedostosta.

Työnkulun suorituksen lokikirjaus

Jokaiselle työnkulun suoritukselle luodaan lokimerkintöjä hallinnan ja vianmäärityksen helpottamiseksi. Nämä merkinnät tallennetaan workflow.log-tiedostoon. Voit ladata tämän lokitiedoston valitsemalla Hallinta > Ylläpito > Lokit > Lataa lokit . Alla on esimerkki siitä, miten työnkulkusolmun suoritus tallennetaan lokeihin. Lihavoituina korostetut osiot edustavat lokin keskeisiä osa-alueita. Viittauksen helpottamiseksi lokiote on numeroitu juoksevasti. Nämä numerot vastaavat lokiotteen jälkeen annettavan kyseisen työnkulun kuvakaappauksen numeroita.

1. WorkflowLogger|INFO|2023-03-22 10:12:12,123|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} run workflow {id: 371441422, name: Checklist approval workflow NEW , templateId: 119733870, wrapperId: 366102831}
2. WorkflowLogger|INFO|2023-03-22 10:12:12,123|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running StartpointNode {id: 371440955, name: Begin}
3. WorkflowLogger|INFO|2023-03-22 10:12:12,273|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running ConditionNode {id: 371441271, name: LOB SMB escalation or risk amount 1,5m}
4. WorkflowLogger|INFO|2023-03-22 10:12:12,275|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} run then path:Then
5. WorkflowLogger|INFO|2023-03-22 10:12:12,430|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running ApprovalNode {id: 371441119, name: LOB SMB Approval }
WorkflowLogger|INFO|2023-03-29 13:46:25,469|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running ApprovalNode {id: 371441119, name: LOB SMB Approval}
WorkflowLogger|INFO|2023-03-29 13:49:40,790|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running ApprovalNode {id: 371441119, name: LOB SMB Approval}
6. WorkflowLogger|INFO|2023-03-29 13:49:41,748|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running ApprovalNode {id: 371441165, name: Credit Committee Approval }'
WorkflowLogger|INFO|2023-03-31 06:47:55,392|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running ApprovalNode {id: 371441165, name: Credit Committee Approval}
7. WorkflowLogger|INFO|2023-03-31 06:47:56,496|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running EmailNode {id: 371441190, name: Notify onboarding team }
8. WorkflowLogger|INFO|2023-03-31 06:47:56,748|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running ConditionNode {id: 371440832, name: Check risk amount }
9. WorkflowLogger|INFO|2023-03-31 06:47:56,748|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} run then path:Then
10. WorkflowLogger|INFO|2023-03-31 06:47:56,892|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running WaitConditionNode {id: 371440854, name: Waiting for initial approval }
WorkflowLogger|INFO|2023-03-31 06:47:56,892|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} Conditions were not met. NodeId: WaitConditionNode{id='371440854', name='Waiting for initial approval', criteria=ConditionCollection[booleanOperator=AND,conditions=[SimpleCondition[operator=EQUAL_TO,leftOperand=AttributeOperand[groupAttributeId=119738157,ids=[371440842]],rightOperand=StaticValueOperand[value=StaticValueDTO[value=Initial approval,code=initial_approval,staticValueId=133859530],isOpen=false,id=371440844],id=371440847]],id=371440851]}. Workflow is pending for conditions of this node to be met before continuing.
11. WorkflowLogger|INFO|2023-03-31 08:53:03,606|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running WaitConditionNode {id: 371440854, name: Waiting for initial approval }
WorkflowLogger|INFO|2023-03-31 08:53:03,606|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} Conditions were met. NodeId: WaitConditionNode{id='371440854', name='Waiting for initial approval', criteria=ConditionCollection[booleanOperator=AND,conditions=[SimpleCondition[operator=EQUAL_TO,leftOperand=AttributeOperand[groupAttributeId=119738157,ids=[371440842]],rightOperand=StaticValueOperand[value=StaticValueDTO[value=Initial approval,code=initial_approval,staticValueId=133859530],isOpen=false,id=371440844],id=371440847]],id=371440851]}. Workflow proceeds.
12. WorkflowLogger|INFO|2023-03-31 08:53:03,883|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running SetValueNode {id: 371441300, name: Set decision to approved }
13. WorkflowLogger|INFO|2023-03-31 08:53:04,060|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running EndpointNode {id: 371440960, name: Closed }

Esimerkki työnkulusta, jossa on numeroidut viittaukset työnkulun lokitiedostoon:

Työnkulun suorituksen ja epäonnistuneiden datakorttitallennusten lokikirjaus

Kun kuuntelija tai käsittelijä estää työnkulkua tallentamasta datakorttia, tapahtuma dokumentoidaan itsm.log-tiedostoon työnkulun lokin sijaan. Tällaiset virheet tallennetaan lokimerkintöihin, jotka yleensä näyttävät seuraavilta:

ErrorLogger|ERROR|2023-05-25 13:43:14,116|QuartzScheduler_Worker-3||Job (workflow.7548098#7546966#7546920#0 threw an exception.
org.quartz.SchedulerException: Job threw an unhandled exception. [See nested exception: com.bitmount.boas.exception.PersistenceException: com.efecte.datamodel.entity.action.FatalDataCardActionException: Data card save failed due to fail_card attribute having a value.]
at org.quartz.core.JobRunShell.run(JobRunShell.java:213)
at org.quartz.simpl.SimpleThreadPool$WorkerThread.run(SimpleThreadPool.java:573)
Caused by: com.bitmount.boas.exception.PersistenceException: com.efecte.datamodel.entity.action.FatalDataCardActionException: Data card save failed due to fail_card attribute having a value.

Ensimmäisen rivin viimeinen tunniste osoittaa tietyn työnkulun solmun, jossa prosessi pysähtyy.

Työnkulun lokissa tämä näyttää siltä, että kortti pysähtyy solmuun, jossa epäonnistunut tallennus tapahtuu. Käyttöliittymässä (UI) työnkulun vaihe (joka näkyy korttinäkymän oikeassa yläkulmassa) osoittaa kuitenkin, että se on edellisessä solmussa. Tämä ristiriita johtuu siitä, että kortti itse asiassa palaa ensimmäiseen edeltävään ajastin- tai odotusehtosolmuun ennen tallennusvirhettä.