Standardi

ECA dokumentaatio jakautuu neljään osa-alueeseen: Tarinat (Stories), Palvelut (Services), Rajapinnat (Interfaces) ja Infrastruktuuri (Infrastructure). Osa-alueiden dokumentaatio on kirjoitettu eri toimijoiden näkökulmasta aina käyttötarkoituksensa mukaisesti.

Dokumentaatio on kirjoitettu englanniksi.

Tarinat ovat keveimmän tason kuvauksia järjestelmän tarkoituksesta ja toiminnasta – käyttäjän näkökulmasta. Ne lähtevät liikkeelle tavoitteenasettelusta. Keitä ja millaisia ovat käyttäjämme, ja mitä käyttäjän ongelmaa olemme ratkaisemassa. Tarinat vastaavat myös kysymyksiin, mitkä ovat käyttäjän motivaattorit toiminnalleen, millaisessa ympäristössä ja millaisin sidosryhmin palvelua tai järjestelmää tullaan käyttämään.

Tarinat kuvaavat kaiken sen oleellisen tiedon, jonka pohjalta voidaan suunnitella palveluun haluttu käyttökokemus ja toiminnallisuus. Tarina ei kuitenkaan kuvaa yksittäistä palvelua sellaisenaan, vaan käyttäjälle näkyvän kokonaisuuden eri palveluineen ja niiden välille tarvittavine suhteineen.

Palveludokumentaatio kuvaa varsinaisen palvelun toiminnallisuuden ja rakenteen. Tämän tueksi standardi sisältää referenssitoteutuksen, jonka avulla voidaan testata standardin järkevyyttä.

Avoimen lähdekoodin referenssitoteutuksessa ylläpidetään dokumentaation mukaiset palvelut ja tarvittavat rajapinnat. Se toimiikin tukena eri toimijoille näiden rakentaessa varsinaisia palvelujaan. Standardi ei edellytä, että palvelut toteutetaan kuten referenssitoteutus. Lähdekoodi ja muut materiaalit on julkaistu lisensseillä, jotka sallivat vapaan käytön, joten voit halutessasi hyödyntää niitä oman palvelutuotteesi pohjana.

Rajapinnat mahdollistavat useista palveluista rakennettuja kokonaisuuksia, jotka ovat käyttäjälle miellyttäviä ja saumattomia käyttää. Rajapintojen avulla palvelut voivat keskustella keskenään ja vaihtaa tietoa, jolloin yhteentoimivat palvelut voivat paremmin palvella käyttäjiään.

Huippuluokan käyttäjäkokemus saavutetaan riittävän yhdenmukaisilla käytännöillä palvelusta toiseen. Tähän autat pääsemään seuraamalla palvelusuunnittelun ohjeistuksia omaa palvelua luodessasi.

Dokumentaatio määrittelee palveluita ja näiden välisiä yhteyksiä. Jokainen palvelu voi toimia itsenäisesti ja eri toimijan tuottamana. Niitä voi myös olla useita dokumentaation mukaan. Dokumentaatiossa palveluiden ja rajapintojen nimitykset ovat tarkoituksella yleisiä eikä ne ota kantaa yksittäiseen teknologiaan. Välttämättä jokainen kuvassa oleva laatikko ei ole pakko olla erillinen palvelu.

Yllä olevassa kuvassa oikealla puolella on käyttäjätiedon ja keskitetyn kirjautumisratkaisun määrittelyn mukaiset osat. Kirjautumispalveluita (Auth Source) voi olla useita ja niiden tarjoamat kirjautumismahdollisuudet ovat kaikkien muiden palveluiden käytettävissä välityspalvelun (Auth Proxy) välityksellä yhden rajapinnan kautta. Käyttäjät voivat hallita käytössään olevia kirjautumispalveluita hallintapalvelun (Auth Connector) kautta. Käyttäjätietolähteitä (Auth Data Source) voi myös olla useita ja niiden tarjoama käyttäjätieto on muiden palveluiden saatavilla keskitetyn käyttäjätietopalvelun (Auth Data) tarjoaman rajapinnan kautta.

Yllä olevassa kuvassa vasemmalla katkoviivojen sisällä on käyttäjälle tärkeimmät ja näkyvimmät palvelut. Kauppapalvelun (Bazaar) kautta käyttäjät voivat hankkia kaikkien sisällöntuottajien (CMS) tuottamia materiaaleja käytettäväksi muissa palveluissa (LMS). Termit CMS ja LMS voivat olla hämääviä, mutta niillä tarkoitetaan yksinkertaisesti tuottajaa ja kuluttajaa. Palveluita jotka tuottavat mitä tahansa ja palveluita jotka tarjoavat käyttäjälle mahdollisuuden kuluttaa mitä tahansa. Dokumentaatiossa ei oteta kantaa sen tarkemmin mitä nämä kaksi voisivat olla. Näiden lisäksi on koontipalvelu (Recipes) joka mahdollistaa materiaalien kokoamisen yhteen ja niistä keskustelemisen.

Yllä olevassa kuvassa alimpana on Meta-palvelut jotka keräävät ja välittävät (Meta Data) sekä analysoivat (Meta Analyzer) käyttäjien toimintaa.