Luonnos, odottaa hyväksyntää

Tietojen vienti ja siirrettävyys

Luonnos 27.10.2026, ei vielä voimassa

Kuvaus koskee tuotantopalvelua, ja se tulee voimaan käyttöehtojen kanssa. Luonnos 27.10.2026.

Asiakkaan tiedot kuuluvat Asiakkaalle. Tällä sivulla kerromme, mitkä tiedot voi viedä, missä muodoissa ja miten vientiä pyydetään. Sivu täyttää EU:n datasäädöksen (2023/2854) 26 artiklan mukaisen vaatimuksen osoittaa, missä tietorakenteet ja -muodot on kuvattu. Se perustuu käyttöehtojen kohtaan 9 ja käsittelysopimuksen kohtaan 17. Jos tekstit poikkeavat toisistaan, sovelletaan sopimusta.

Lyhyesti

Mitä ylläpitäjä voi viedä itse

Tiedot Muoto Mistä
Julkaistut tietokortit ja niiden arkistoidut versiot lähteineen (asiantuntija tai "Entinen asiantuntija" ja päivämäärät) sekä korttien varoitukset vanhentuneesta tai virheellisestä tiedosta ilman ilmoittajan tietoja JSON ja Markdown Organisaatio-sivu, Tietojen vienti
Kaikki tiedot yhtenä tiedostona: julkaistut tietokortit kuten yllä; avainhenkilöt ja heidän osaamisalueensa (lähtöpäivä ja sen vahvistus, kriittisyys, ainoa osaaja, seuraaja ja kytkentä osaamispakettiin); Asiakkaan omat osaamispaketit ja Asiakkaan muutokset Tarumon paketteihin versioineen sekä asiantuntijoiden lähettämät Kartoituksen pakettiehdotukset; kattavuus osaamisalueittain ja osa-alueittain; käyttäjät ja heidän roolinsa, kirjanpitäjä, tiimit, tiimien haasteet, palkintojen asetukset ja organisaation muut asetukset; organisaation koko loki, lukuun ottamatta korttien avauksia ja korttien ilmoituksia ZIP-tiedosto, jossa JSON-tiedostot Organisaatio-sivu, Tietojen vienti, Lataa kaikki tiedot
Organisaation loki CSV-muodossa (enintään 10 000 uusinta tapahtumaa), lukuun ottamatta korttien avauksia ja korttien ilmoituksia CSV Loki-sivu
Kartoituksen loppuraportti, jos Asiakkaalla on ollut Kartoitus Markdown Kartoitus-sivu, Loppuraportti
Laskut PDF Organisaatio-sivun Laskut (laskulla maksavat) tai Stripen maksuportaali (kortilla maksavat). Myös kirjanpitäjä voi ladata ne.

Vienti on käytettävissä myös silloin, kun palvelu on keskeytetty maksamatta jättämisen vuoksi, ja sopimuksen päätyttyä vientiajan loppuun asti. Kaikkien tietojen lataaminen vaatii, että ylläpitäjä on kirjautunut viimeisen 15 minuutin aikana, ja sen voi tehdä enintään viisi kertaa tunnissa. Palvelussa tehdyt lataukset kirjataan organisaation lokiin. Kun laskut ladataan Stripen maksuportaalista, lokiin kirjataan vain portaalin avaaminen.

Mitä Tarumo toimittaa pyynnöstä

Tarumo toimittaa pyynnöstä JSON-muodossa viimeistään 14 päivän kuluessa:

Jos pyyntö tehdään vienti- tai noutoajan kuluessa, Tarumo toimittaa tiedot, vaikka toimitus osuisi ajan päättymisen jälkeen, eikä poista niitä ennen toimitusta.

Mitä ei viedä ja miksi

Tiedostojen muodot ja rakenne

Kaikki tiedostot ovat yleisesti käytettyjä, koneluettavia muotoja: JSON (UTF-8), Markdown (UTF-8), CSV (UTF-8, pilkuin erotettu) ja PDF. Tietokorttien JSON-tiedoston rakenne on sopimus, ja se on kuvattu tässä. Markdown-tiedosto sisältää saman sisällön ihmisen luettavaksi, eikä sen asettelu ole sopimus.

Tietokorttien JSON-tiedosto (versio 1)

Kenttä Tyyppi Merkitys
schemaVersion kokonaisluku Rakenteen versio (nyt 1).
generatedAt merkkijono Viennin ajanhetki, ISO 8601 (UTC).
organization objekti { name, slug }: organisaation nimi ja tunnus.
cardCount luku Nykyisten korttien määrä (arkistoituja versioita ei lasketa).
cards taulukko Nykyiset kortit, järjestettynä osaamisalueen, kategorian ja otsikon mukaan.

Kortti (cards-taulukon alkio):

Kenttä Tyyppi Merkitys
id merkkijono (uuid) Kortin tunniste. Pysyvä: myöhemmässä viennissä saman version tunniste on sama.
title merkkijono Asiantuntijan hyväksymä otsikko.
items merkkijonotaulukko Kortin kohdat asiantuntijan sanoin, järjestyksessä.
source objekti { name, publishedAt }: asiantuntijan nimi hyväksymishetkellä ja hyväksymisen ajanhetki (ISO 8601).
topic objekti { area, category }: osaamisalue ja osaamispaketin kategoria tai null, jos alueella ei ole pakettia.
locale merkkijono Kieli, jolla kortti on kirjoitettu (fi, en).
status merkkijono published nykyiselle kortille.
warning objekti tai null Varoitus, jonka jokainen jäsen näkee kortissa: kind (marked tai reported), reason (outdated tai incorrect), on (päivä VVVV-KK-PP) ja note (ilmoittajan sanoin tai null).
history taulukko Aiemmat versiot, jotka kortti korvasi, uusin ensin. Kentät id, title, items, source, topic, locale ja archivedAt.

Tiedostossa ei koskaan ole luonnoksia eikä hylättyjä kortteja, ilmoittajan tietoja, käyttäjätunnisteita tai sähköpostiosoitteita, lukukertoja eikä "hyödyllinen"-merkintöjä. Siinä ei ole muita henkilötietoja kuin kortin lähteen nimi.

Kaikkien tietojen ZIP-tiedosto (versio 1)

Tiedosto Sisältö Kentät
organization.json Organisaation asetukset (toimiala, äänitteiden säilytysaika, kannustimet, tila), paketti ja avainhenkilöraja, Microsoft Teams -asetukset, Entra ID -käyttäjähallinnan asetukset, HR-liittymät ja rajapinta-avaimet ilman salaisuuksia. settings { industry, audioRetentionDays, incentivesEnabled, status, eraseAfter, createdAt }, plan { package, keyPersonLimit, keyPersonsUsed, startsOn, endsOn, invoiceReference } tai null, microsoftTeams { enabled, allowedTenantIds }, entraProvisioning { entraTenantId, tenantConfirmed, defaultRole, groupRoles }, hrConnectors[] { id, kind, name, enabled, settings, hasCredentials, lastSyncAt, lastStatus }, integrationTokens[] { id, kind, name, scopes, createdBy, createdAt, expiresAt, lastUsedAt, revokedAt }
users.json Jäsenet rooleineen ja liittymis- ja poistopäivineen (poistetun jäsenen nimeä ja osoitetta ei enää näytetä), avoimet kutsut ja kirjanpitäjä. members[] { userId, name, email, role, status, joinedAt, removedAt }, invitations[] { id, email, role, expiresAt, expired }, accountants[] { userId, name, email, status, since, removedAt, removedReason }
key-persons.json Avainhenkilöt (myös arkistoidut), heidän lähtötietonsa (lähtötapa, päivä, vahvistus ja seuraaja) ja osaamisalueensa (kriittisyys, ainoa osaaja ja kytketty osaamispaketti). keyPersons[] { id, displayName, jobTitle, startYear, userId, teamId, createdAt, archivedAt, departure { type, date, confirmed, successor { userId, name } }, areas[] { id, name, criticality, soleExpert, pack { packId, packKey, version, locale, name, own }, createdAt, archivedAt } }
coverage.json Kattavuus osaamisalueittain: kytketty paketti, käsitellyt ja kaikki osa-alueet, osuus sekä jokainen osa-alue ja milloin se käsiteltiin. areas[] { areaId, areaName, keyPersonId, keyPersonName, pack, covered, total, share, categories[] { key, name, covered, coveredAt } }
packs.json Asiakkaan omat osaamispaketit ja Asiakkaan muokkaamat Tarumon paketit kaikkine versioineen ja osa-alueineen, keskeneräiset pakettiluonnokset ja asiantuntijoiden lähettämät Kartoituksen pakettiehdotukset. Tarumon yleiset paketit vain nimettyinä viittauksina. packs[] { id, packKey, basedOn { packId, packKey }, createdAt, versions[] { id, version, locale, name, description, vocabulary, reviewStatus, reviewedBy, contentHash, basedOnVersion { packKey, version }, createdAt, categories[] { key, position, name, description, questions } } }, drafts[] { id, packKey, packId, origin, locale, content, aiUnreviewedCategoryKeys, moderationStatus, revision, createdAt, updatedAt }, mappingSuggestions[] { id, author { userId, name }, locale, fit, targetPackKey, content, receivedOn, status, draftId, createdAt }
incentives.json Tiimit, tiimien haasteet sellaisina kuin ne on asetettu, palkintojen asetukset ja palkintojen myöntäjät. Ei haasteiden tuloksia, henkilökohtaisia pisteitä eikä saavutuksia. enabled, teams[] { id, name, createdAt, archivedAt }, challenges[] { id, title, teamId, teamName, target, startsOn, endsOn, rewardText, createdAt, archivedAt }, rewards[] { id, achievementKey, rewardText, createdAt, archivedAt }, rewardGranters[] { userId, name, assignedOn }
cards.json Julkaistut tietokortit, sama rakenne kuin tietokorttien JSON-tiedostossa. schemaVersion, generatedAt, organization, cardCount, cards[]
audit-log.json Organisaation koko loki, uusin ensin, ilman rivirajaa: aika, tapahtuma, tekijä, kohde ja tapahtuman lisätiedot. Ei korttien avauksia eikä korttien ilmoituksia. entries[] { id, at, action, actorUserId, actor, targetType, targetId, target, metadata }
manifest.json Viimeisenä: rakenteen versio, viennin ajanhetki, organisaatio, jokaisen tiedoston nimi, tietueiden määrä, koko tavuina ja SHA-256-tiiviste sekä luettelot siitä, mitä tiedostossa ei ole ja mitä Tarumo toimittaa pyynnöstä. format, schemaVersion, generatedAt, organization, documentation, files[] { name, records, bytes, sha256 }, excluded, onRequest

Tiedosto tehdään latauksen hetkellä, eikä siitä jää kopiota Tarumoon. Tiedostot luetaan peräkkäin: jos tietoja muutetaan latauksen aikana, muutos voi näkyä yhdessä tiedostossa mutta ei toisessa. Kentät, joiden arvoa ei ole, ovat null. Lukijan pitää ohittaa kentät, joita se ei tunne.

Muut tiedostot

Miten vientiä pyydetään

  1. Lähetä kirjallinen pyyntö osoitteeseen myynti@tarumo.fi organisaation ylläpitäjän osoitteesta. Kerro organisaation nimi ja se, mitä haluat: tietojen viennin, siirron toiseen palveluun tai pelkän poiston.
  2. Tarumo toimittaa pyydetyt JSON-tiedostot viimeistään 14 päivän kuluessa.
  3. Siirtoa toiseen palveluun pyydettäessä ilmoitusaika on kaksi kuukautta tai Asiakkaan ilmoittama lyhyempi aika. Sen jälkeen alkaa 30 päivän siirtymäaika, jonka aikana palvelu toimii normaalisti, ja sen jälkeen vähintään 30 päivän noutoaika. Asiakas voi pidentää siirtymäaikaa kerran. Tarumo avustaa siirrossa kohtuullisesti (käyttöehtojen kohta 12 a).
  4. Noutoajan jälkeen Tarumo poistaa Asiakkaan tiedot pysyvästi (käyttöehtojen kohta 12).

Sopimuksen aikana ja vientiajan loppuun asti ylläpitäjä voi viedä tietokortit, kaikki tiedot ZIP-tiedostona, lokin ja raportit itse, eikä siihen tarvita pyyntöä.

Kysymykset

Kysymykset viennistä voi lähettää osoitteeseen myynti@tarumo.fi. Tietojen sijainnista kerromme sivulla Tietojen sijainti ja viranomaispääsy.