Sanomien haku

 

Sanomanäkymän saa auki hausta, visualisoinneista ja kuittausnäkymistä klikkaamalla hakutulosta. Sanomanäkymä esittää valitun sanoman käsittelytapahtumat sekä sanomahierarkian, mikäli sanomaan liittyy pääsanoma ja useampi lapsisanoma.


sanomanakyma

 

Sanomanäkymään liittyy seuraavia sanomavalvonnan termejä:

  • Sanoma: Sanomalla on yksikäsitteinen id. Sanoma vastaanotetaan lähdejärjestelmästä, sitä prosessoidaan ja se joko toimitetaan eteenpäin kohdejärjestelmään tai siitä generoidaan lapsisanomia.

  • Käsittelytapahtuma: Sanoman käsittelyn eri vaiheita (vastaanotto, prosessointi ym.) kutsutaan käsittelytapahtumiksi. Sanomavalvonnassa sanomaloki luokitellaan johonkin seuraavista käsittelytapahtumista:
    • New: Sanoma on vastaanotettu
    • Processing: Sanoman prosessointia (esim. konverointi toiseen tiedostomuotoon)
    • Warning: Varoitus sanoman prosessoinnissa, mikä ei estä sanoman käsittelyä
    • Failure: Sanoman prosessointi tai toimitus epäonnistui
    • Done: Sanoman toimitus kohdejärjestelmään onnistui (tai siitä generoitiin onnistuneesti lapsisanomat)

  • Tapahtumaketju: Sanoman käsittelytapahtumat muodostavat tapahtumaketjun kyseiselle sanomalle.

  • Pääsanoma: Pääsanoma on lähdejärjestelmästä tullut sanoma. Tyypillisesti prosessointivaiheessa sanoman sisällöstä tunnistetaan, mille vastaanottajalle / vastaanottajille sanoma tulee toimittaa. Mikäli toimitus tapahtuu useammalle vastaanottajalle, muodostetaan jokaisesta toimituksesta erillinen lapsisanoma.

  • Lapsisanoma: Lapsisanomalla on oma yksikäsitteinen id ja sen lisäksi viittaus pääsanoman id:hen.

  • Sanomahierarkia: Kuvaa pääsanoma-lapsisanoma hierarkiaa, joka voi olla monitasoinen tai myös yksitasoinen, mikäli pääsanoma toimitetaan suoraan kohdejärjestelmään.

Sanomanäkymässä sanomat ovat oletuksena kollapsoituina, jolloin jokainen sanomahierarkian sanoma näkyy vain yhdellä rivillä. Sanoma laajennetaan klikkaamalla sanomariviä, jolloin tulee näkyviin kaikki sanomalle lokitetut käsittelytapahtumat.


sanomanakyma_avattu

 

Jokaisesta sanomasta esitetään sanomarivillä seuraavat asiat:

  • Sanoman tila: New (harmaa), Processing (keltainen), Failure (punainen) tai Done (vihreä). Sanoman tila päätellään sanoman lokittamista käsittelytapahtumista.

  • Aikaleima: Sanomalle lokitettu viimeisin aikaleima, jolloin sanomaa on käsitelty.

  • Integraatio: Sanoman lokittama integraatiotieto.

  • ID: Sanoman lokittama ID.

  • Vastaanottaja: Sanoman lokittama vastaanottajatieto. Tyypillisesti sanoma lokittaa vastaanottajatiedon vasta prosessointi- tai lähetysvaiheessa. Mikäli sama sanoma lähetetään useammalle vastaanottajalle, pitäisi lähetykset lokittaa erillisinä lapsisanomina omilla ID-tiedoillaan.

  • Ikoneina näytetään, onko sanomalle lokitettu payloadia (paperiliitin-ikoni) ja onko sanomalle lokitettu Warning- tai Failure-tapahtumia (keltainen tai punainen varoituskolmio).

 

Huom! Sanomalle voidaan lokittaa Failure-tapahtuma, mutta myöhemmin uudelleenlähetyksen johdosta sanoma menee Done-tilaan. Tällöin rivi näkyy vihreänä Done-tilassa, mutta oikeassa laidassa näkyy punainen varoitusikoni kertomaan Failure-lokituksesta.