Laitteiden liittäminen LIMS-järjestelmään tuontiliitäntäeditorilla

Tuontirajapinnat: Tiedot automaattisesti LIMS-järjestelmään

Liitä analysaattorit, aineenkoestuskoneet, alihankintalaboratoriot ja ERP-järjestelmät kuten SAP LIMS-järjestelmään: CSV, JSON, XML, REST-API ja SFTP – tekoälyavusteisella kohdistuksella.

Arki ilman liitäntöjä

Neljä asiaa, jotka vievät laboratoriossa aikaa – ja aiheuttavat virheitä

Tulokset syötetään käsin

Laite tulostaa tai vie tiedot, ja joku siirtää numerot käsin järjestelmään. Jokaista arvoa käsitellään kahdesti, ja toisella kerralla syntyvät näppäilyvirheet.

Jokainen laite puhuu omaa kieltään

Yksi laite käyttää puolipisteitä, toinen sarkaimia ja kolmas aloittaa otsikkorivin vasta riviltä 13. Jokaiselle tiedostomuodolle ylläpidetään omaa Excel-viritelmää.

Kohdistaminen on käsityötä

Ilman yksiselitteistä tunnistetta jonkun on pääteltävä, mihin näytteeseen mittaustulos kuuluu. Tämä toimii – kunnes kerran ei toimikaan ja asia paljastuu auditoinnissa.

Jokaiseen liitäntään tarvitaan IT:tä

Uusi liitäntä merkitsee tukipyyntöä, palveluntarjoajaa ja odotusaikaa. Siihen asti välivaihe hoidetaan edelleen Excelillä.

Juuri tätä varten on olemassa LDB LIMSin tuontiliitäntäeditori: työkalu, jolla voidaan liittää monenlaiset ja käyttötiheydeltään hyvin erilaiset laitteet, järjestelmät ja ulkopuoliset laboratoriot – tunneittain tuloksia tuottavasta analysaattorista kumppanilaboratorioon, joka lähettää tiedoston kolme kertaa vuodessa.

Ydintoiminnot

Ei vain mittaustuloksia – lähes kaikki, mitä laboratorioon saapuu

Tuontiliittymäeditori ei rajoitu vain analysaattoreihin. Saman käyttöliittymän kautta voidaan tuoda myös tilauksia, perustietoja ja dokumentteja.

Nämä tiedot voidaan tuoda

  • Mittaustulokset
  • Näytteet
  • Tilaukset
  • Asiakkaat ja yhteystiedot
  • Kohteet, näytteenottopisteet
  • Materiaalit ja erät
  • Kontrolliarvot / QC-tiedot
  • Laskut ja tarjoukset
  • Raportit ja spesifikaatiot
  • Reseptit, mallipohjat, tehtävät

Lisäksi tulevat muistiinpanot, työajanseuranta ja tiedostot – kaikkiaan 19 tietotyyppiä, joita voidaan luoda tai päivittää tuontiliittymien kautta.

Tuetut tiedostomuodot

CSVJSONXMLHL7LDTPDFPNGJPG

HL7 ja LDT kattavat lääketieteellisen tiedonsiirron. Myös Excel toimii – tallenna tiedosto Excelissä vain CSV-muodossa. Kaikki muu lisätään muunnoskoodin avulla.

Tiedonsiirtotavat

Mikä tapa sopii prosesseihinne?

Neljä tapaa manuaalisesta täysautomaattiseen. Valinta riippuu kolmesta asiasta: mihin lähdejärjestelmänne pystyy, mitä IT sallii ja kuinka usein dataa saapuu.

Tiedoston lataus

Manuaalinen

Laitteen vientitiedosto ladataan suoraan liittymään. Helppo tapa päästä alkuun sekä harvoin käytettäville laitteille.

IT-vaiva: ei lainkaan
Soveltuu parhaiten: testivaiheeseen, pienille määrille Vinkki: kokonaisten kansioiden monilataus, historiatietojen tuonti

SFTP / FTP

Laitteiden standardi

Laite tallentaa tiedoston palvelimelle, ja Labordatenbank noutaa sen automaattisesti. Tuodut tiedostot siirretään tai poistetaan.

Noutoväli: 10 minuutin välein
Kiintiö: 10 tiedostoa per sykli
Portti: 22 (SFTP) · 21 (FTP)

HTTPS (REST-API)

Push ja pull

Ulkoinen järjestelmä lähettää tiedot aktiivisesti POST-pyynnöllä, tai Labordatenbank noutaa ne. Nopein tapa — lähes reaaliajassa.

Todennus: Basic Auth tai varmenne
Vastaus: 200 onnistunut · 400 hylätty
Soveltuu parhaiten: ERP-järjestelmille, portaaleille, alihankintalaboratorioille

Sähköpostivastaanotto

Ilman IT-projektia

Liittymä vastaanottaa liitetiedostoja sähköpostitse. Hyödyllinen ratkaisu kumppanilaboratorioille, joilla ei ole muita tiedonsiirtotapoja.

IT-vaiva: minimaalinen
Soveltuu parhaiten: alihankintalaboratorioille, yksittäisille lausunnoille, lämpötilaloggereille

MCP

Tekoäly- ja puheavustajat

ChatGPT, Claude ja muut tekoälysovellukset siirtävät tietoja valtuutettujen tuontirajapintojen kautta — patologian lausunto sanelemalla kirjoittamisen sijaan, näytteenotto liikkeellä ollessa puheella kirjattuna ja mikrobiologian lukemat kädet vapaina dokumentoituna.

Valtuutus: Päätätte itse, mitä rajapintoja tekoäly saa käyttää
Oikeudet: sidottu LDB-käyttäjään
Audit Trail: jokainen muutos merkitty tunnuksella ”MCP”
Lue lisää MCP:stä

Oma lomake

Kirjaa viennin sijaan

Luotte oman HTML-sivun tai lomakkeen — kenttänäytteenottoa, lähettäjiä tai täysin uudenlaista tiedonkeruuta varten. Lähettämisen jälkeen syötetyt tiedot siirtyvät suoraan tuontirajapintaan.

Reitti: lomake → HTTPS-vastaanotto
Soveltuu parhaiten: näytteenottajille, lähettäjille, erikoistapauksiin
Ilman tiedostoa: syöte tallentuu suoraan tietueeksi
Kuvat ja PDF-tiedostot kohdistetaan oikeaan näytteeseen tiedostonimen, QR-koodin tai tekoälyn perusteella.
Audit Trail kirjaa jokaisen tuonnin täydellisesti lokiin — mukaan lukien raakadatan.
Tuontikartoitus

Sarake kenttään – kerran määritetty, toimii automaattisesti

Kartoituksessa määrität, mikä tiedostosi sarake viedään mihinkin Labordatenbank-järjestelmän kenttään: asiakas, tilaus, näyte, näytteenottopaikka, parametri, mittausarvo.

Lataat mallitiedoston järjestelmään, Labordatenbank lukee otsikkorivin ja sinä kohdistat kentät. Sillä ei ole väliä, ovatko parametrit rinnakkain sarakkeissa vai allekkain riveillä – kartoitus mukautuu tiedostosi rakenteeseen, ei päinvastoin.

Kuvakaappaus: Tuontikartoitus ja attribuuttien kohdistus

Mukauta nimikkeitä

Jokainen attribuutti saa kuvaavan nimen – kryptisestä sarakeotsikosta tulee ”Näytteenottaja”.

Määritä oletusarvo

Jos tuontitiedoston kenttä on tyhjä, Labordatenbank täyttää sen automaattisesti tallennetulla oletusarvolla.

Yhdistä kenttiä

Useita sarakkeita voidaan ketjuttaa yhdeksi kentäksi – etu- ja sukunimi yhdistyvät yhdeksi nimeksi.

Tarkista syötteet

Malli validoi tiedot jo tuontivaiheessa: jos arvo ei vastaa odotettua muotoa, tuonti keskeytetään virheellisen datan luomisen sijaan.

Entä jos tiedosto ei olekaan CSV-muodossa?

Silloin muunnoskoodi muotoilee datan tarvittavaan muotoon ennen kartoitusta. Laboratoriosi pääkäyttäjät voivat kirjoittaa ja ylläpitää tätä koodia itse. Vaihtoehtoisesti voimme toteuttaa sen palveluna tuntiveloituksella. Tuonti-ikkunassa näet sen jälkeen molemmat rinnakkain: raakadatan ja muunnetun version.

Muunnoskoodi käyttöoppaassa
Tekoälylaajennus

Muunna jäsentämätön data strukturoiduiksi tiedoiksi

Käsin kirjoitetut näytteenottopöytäkirjat, valokuvatut mittaustulokset, toimeksiantajien tai alihankintalaboratorioiden PDF-tiedostot: tekoälylaajennus muuntaa jäsentämättömät asiakirjat rakenteelliseksi tiedoksi, validoi ne ja siirtää ne tuontiprosessiin.

Kuvakaappaus: Käsin kirjoitetun näytteenottopöytäkirjan tekoälyavusteinen tuonti ja validointi

Kaksi mallia yhden sijaan

Yksi malli lukee tiedot, ja toinen tarkistaa tuloksen itsenäisesti ristiin. Molemmat ehdotukset esitetään rinnakkain luottamusarvoineen – näet välittömästi, missä ne ovat samaa mieltä ja missä eivät.

Jokainen arvo säilyy todennettavissa

Labordatenbank näyttää jokaisen tunnistetun kentän kohdalla kohdan alkuperäisessä asiakirjassa, josta arvo on peräisin. Epäselvät arvot merkitään manuaalista tarkistusta varten sen sijaan, että ne hyväksyttäisiin hiljaisesti.

Pääsy perustietoihinne

Tekoäly voi tehdä kohdennettuja hakuja tietokannasta – esimerkiksi etsiä mainitun testausvälineen ja kohdistaa sen oikein. Se ei arvaile, vaan tarkistaa.

Lisätietoa tekoälylaajennuksen yksityiskohtaisesta toiminnasta, sen tunnistamista datatyypeistä ja liittymäkohtaisista määrityksistä löydät omalta sivultaan.

Tutustu tekoälyavusteiseen tuontiin
Tuontitila

Päätätte itse, mitä saa korvata

Tuonti voi luoda uutta, päivittää tai jättää olemassa olevat tiedot koskemattomiksi. Tila määritetään liittymäkohtaisesti – ja se koskee jokaista tuontiajoa.

Vakiona on update: uusi arvo tallennetaan joka tapauksessa. Lisäksi käytettävissä on tiloja, jotka täyttävät vain tyhjät parametrit, päivittävät vain olemassa olevat, luovat puuttuvat parametrit ilman arvoa tai liittävät mittausarvot osaksi aiempaa numerosarjaa. Jos uusintamittauksen yhteydessä ei haluta korvata mitään, valitaan ignore-tila – varoituksella tai ilman.

Kaikki tuontitilat käyttöoppaassa
Kuvakaappaus: Tuontitilan valinta mittausarvojen tuonnille

Testaaminen ja virheiden etsintä

Ensin testijärjestelmässä

Jokainen liittymä määritetään ensin sinne ja testataan anonymisoiduilla esimerkkitiedostoilla. Tuotantoon se siirtyy vasta onnistuneen validoinnin jälkeen.

Yhteyden tarkistus

Yksi napsautus testaa SFTP- tai FTP-yhteyden: saavutettavuuden, kirjautumistiedot ja kirjoitusoikeudet. HTTPS-rajapinta vastaa tilakoodilla 200 tai 400, ennen kuin varsinaista dataa siirretään.

Testaa myös erikoistapaukset

Puuttuvat pakolliset kentät, tuntemattomat tunnisteet, erikoismerkit, tyhjät arvot: kaikki, mikä arjessa voi mennä pieleen, kuuluu testiin – ei ensimmäiseen tuotantoajoon.

Historia ja toisto

Jokainen tuontiajo kirjataan lokiin ja se voidaan toistaa. Virhetilanteissa näette tarkalleen, missä ongelma on – lähdetiedostossa, avaimessa, mäppäyksessä vai muunnoksessa.

Laitteet ja järjestelmät

Nämä laitteet ja järjestelmät olemme jo liittäneet

Ja kaikki, mitä listalta ei löydy, liitetään mukaan mäppäyksen ja datamuunnoksen avulla — laitteen tiedostomuoto määrittää vain sen, kuinka paljon esityötä tarvitaan.

Analyysilaitteet

  • Agilent
  • Bruker
  • Leco
  • Tecan
  • Zwick
  • GC/MS
  • HPLC · IC · MS
  • Waagen · Titratoren

Laiteohjelmistot

ERP ja toiminnanohjaus

  • SAP
  • SAP Business One
  • Microsoft Dynamics
  • Navision
  • ProAlpha
  • AS/400
  • Salesforce
  • DATEV

Vastaanotot ja ulkoiset laboratoriot

  • Tomedo
  • M1
  • eTermin
  • Caritasnet
  • neolution
  • Novid20
  • HL7 · LDT
Eikö laitettasi löydy listalta? Lähetä meille esimerkkivientitiedosto. Integraatiotyöpajassa selvitämme yleensä jo yhdellä tapaamisella, riittääkö pelkkä mäppäys vai tarvitaanko muunnoskoodia.
Tarkistuta vientitiedosto
Ohjeet

Tuontirajapinnat käsikirjassa

Jokainen vaihe on dokumentoitu – mukana näyttökuvat, esimerkkitiedostot ja videot. Vapaasti tutustuttavissa jo ennen päätöksentekoa.

Perusteet

Luonti & kohdistus

Automatisointi & testaus

Tekoäly & erityistapaukset

Käytännön laite-esimerkit

Usein kysyttyä tuontirajapinnoista ja laiteliitännöistä

Tuontirajapintojen kautta Labordatenbankiin voidaan liittää analysaattoreita, aineenkoestuskoneita, lämpötila- ja tiedonkeruulaitteita, alihankintalaboratorioita sekä ERP-järjestelmiä. Tiedonsiirtotapoina tulevat kyseeseen manuaalinen lataus, SFTP, HTTPS/REST-API, sähköpostivastaanotto, räätälöity lomake tai tekoälyavustajille tarkoitettu MCP. Sopiva tapa riippuu lähdejärjestelmästä, tietoturvavaatimuksistanne sekä halutusta automaatioasteesta.
Kyllä — ja tämä yllättää useimmat. Saman käyttöliittymän kautta voidaan tuoda myös näytteitä, tilauksia, asiakkaita ja yhteystietoja, mittalaitteita ja kalibrointivälineitä, materiaaleja ja eriä, laitteistoja, laskuja ja tarjouksia, raportteja, spesifikaatioita, reseptejä, malleja, tehtäviä, muistiinpanoja sekä työajanseurantatietoja. Tietotyyppejä on yhteensä 19, ja jokainen niistä voidaan luoda tai päivittää.
Yleisimpiä ovat CSV, JSON ja XML. Lääkinnällisessä tiedonvaihdossa tuetaan lisäksi HL7- ja LDT-muotoja; lisäksi voidaan tuoda PDF-, PNG- ja JPG-tiedostoja, kuten kromatogrammeja tai allekirjoitettuja pöytäkirjoja. Myös Excel toimii — tallenna se vain Excelissä CSV-muodossa. Rajapintaa luotaessa määritetään merkistö, päivämäärämuoto ja desimaalierotin; virheelliset asetukset ovat yleisin syy ääkkösten rikkoutumiseen tai mittauslukujen väärintulkintaan.
Kyllä — välivaihe Excelin kautta jää pois. Laitteen tuloste, parametrit, näytetunniste ja siirtotapa sovitetaan toisiinsa kerran, minkä jälkeen mittaustulokset siirtyvät automaattisesti oikealle näytteelle. Tämä koskee niin GC- tai PCR-laitteistoja kuin vaakoja ja titraattoreitakin.
Kyllä, Zwick-koestuskoneet voidaan integroida sopivan tuontirajapinnan kautta. Konfiguraatiosta riippuen siirrämme maksimiarvon, keskiarvon, kulmakertoimen, raakadatan tai kokonaisia käyriä — ja te määritätte, mitkä näistä mittaustiedoista todella viedään LIMS-järjestelmään. Laitteet ja testausvälineet yksilöidään kiinteiden tunnisteiden, sarjanumeroiden tai viivakoodien avulla.
Tätä varten on käytettävissä mobiilikirjaus: valokuva, syöttö iPadilla tai iPhonella, sanelu tai perinteinen manuaalinen kirjaus. Monisivuiset mittauspöytäkirjat ja käsinkirjoitetut muistiinpanot luetaan OCR:n ja tekoälyn avulla ja muunnetaan rakenteellisiksi mittausarvoiksi. Myös näytteenottolomakkeet voidaan lukea tällä tavalla — niistä syntyy automaattisesti tilauksia ja näytteitä.
Muun muassa SAP-, Navision-, Microsoft Dynamics- ja AS/400-järjestelmiin. Muunnossäännöt muuntavat ERP-tiedot tilauksiksi, näytteiksi ja kohdistuksiksi; vähimmäistiedoiksi riittävät yleensä asiakasnumero, tuotenumero ja eränumero, jolloin yksikäsitteinen kohdistus muodostuu erä- ja tuotenumeron yhdistelmästä. Asiakasstammitiedot kannattaa pitää ensisijaisesti ERP-järjestelmässä — LIMS synkronoi tiedot säännöllisesti rinnakkaisen totuuden rakentamisen sijaan. Laskutustiedot siirtyvät takaisin DATEV- tai suoran ERP-rajapinnan kautta.
Tuontirajapinnan kautta automaattisella parametrikohdistuksella tai pienillä määrillä manuaalisesti syöttämällä. Kumppanilaboratorion alkuperäinen raportti voidaan liittää näytteeseen, jotta auditoinnissa säilyy jäljitettävyys siitä, mistä arvo on peräisin.
Molemmat siirtomallit ovat toteutettavissa. Taajuus määräytyy siirtotavan mukaan: ajastetut haut, esimerkiksi kymmenen minuutin välein, tai REST-yhteyksissä lähes välitön siirto. Tuonteja voidaan laukaista myös manuaalisesti tai tilatiedon perusteella; tilasuodattimet ja yksilölliset tuontitunnisteet estävät kaksoistuonnit ja ikuiset silmukat.
Kyllä, Model Context Protocolin (MCP) kautta. Tekoälysovellukset siirtävät tietoja ainoastaan niiden tuontirajapintojen kautta, jotka olette erikseen sallineet — laajempaa pääsyä ne eivät saa. Kirjautuminen on sidottu LDB-käyttäjään, jolloin sen käyttöoikeudet ovat voimassa, ja jokainen muutos kirjautuu valvontalokiin (Audit Trail) merkinnällä ”MCP”. Näin patologian lausunto voidaan sanella kirjoittamisen sijaan tai kentällä tehty näytteenotto kirjata puheella.
Kyllä. Luotte oman HTML-sivun tai lomakkeen — paikan päällä tapahtuvaa näytteenottoa, näytteiden lähettäjiä tai sellaista kirjausta varten, jota LIMS-järjestelmässä ei vielä sellaisenaan ole. Lähetettäessä tiedot menevät HTTPS-vastaanoton kautta suoraan tuontirajapintaan. Mitään tiedostoa, jota jonkun pitäisi myöhemmin ladata, ei tarvitse luoda.
Kyllä. Yksittäislatauksen lisäksi käytettävissä on monilataus kokonaisille kansioille — tavanomainen menetelmä historiatietojen tuonnissa. Automaattisessa SFTP-haussa Labordatenbank noutaa jopa kymmenen tiedostoa per sykli kymmenen minuutin välein. Suuremmat määrät käsitellään useammassa syklissä tai nostetulla kiintiöllä.
Kyllä. Labordatenbankiin tapahtuvan tuonnin lisäksi voidaan toteuttaa paluukanavat portaaleihin, ERP-järjestelmiin tai ulkoisiin laboratorioihin — tuloksia, tilatietoja tai tunnisteita varten. Palautussiirron laukaiseva tila ja palautettavat kentät määritellään projektikohtaisesti.
Kohdistuksessa liitätte tuontitiedoston kentät LIMS-järjestelmän kenttiin: asiakas, tilaus, näyte, näytteenottopaikka, parametri, mittaustulos. Yksinkertaiset kohdistukset määritetään suoraan käyttöliittymässä. Monimutkaisille tiedostorakenteille, poikkeaville nimille tai erityisille mittaustulosten muodoille käytetään muunnoskoodia, joka muuntaa tiedot ennen tuontia. Laboratorionne pääkäyttäjät voivat kirjoittaa ja ylläpitää tätä koodia itse; vaihtoehtoisesti hoidamme sen palvelutyönä tuntiveloituksella. Luomisen jälkeen koodi tulee aina testata edustavilla testitiedostoilla.
Kyllä. Tekoäly tunnistaa sarakkeet, ehdottaa kohdistuksia ja tuottaa muunnoskoodin — näin tuontikohdistus syntyy muutamalla napsautuksella päivien työn sijaan. Kaksi sääntöä on kuitenkin voimassa: esimerkkitiedostot on anonymisoitava etukäteen, ja jokainen automaattisesti luotu kohdistus on tarkistettava sisällöllisesti ja teknisesti.
Molemmat rakenteet ovat tuettuja. Vaakasuorassa tuonnissa parametrit ovat rinnakkain sarakkeissa, pystysuorassa tuonnissa riveittäin allekkain — laitteiden tulosteet ovat usein pystysuoria, ERP-viennit usein vaakasuoria. Ratkaisevaa on vain se, että kohdistus vastaa lähdetiedoston rakennetta; nykyisiä vientitiedostojanne ei tarvitse muokata tämän vuoksi.
Tämä riippuu tuontityypistä. Mittaustuloksille tarvitaan vähintään kelvollinen näyte, kohdistettavissa oleva parametri sekä itse mittaustulos; viranomaisilmoituksissa tarvitaan lisäksi tunnisteet sekä toiminnanharjoittajan tai näytteenottopaikan tiedot. Puuttuvat kentät voidaan luoda järjestelmään, ja tuontipohjia voidaan määrittää eri tavoin eri toimipisteiden tai tutkimustyyppien mukaan.
Yhdenmukaisten tuotenumeroiden ja huolellisen perustietojen kohdistuksen avulla. Tutkimuspaketti voi tällöin niputtaa useita parametreja, jotka on yhdessä liitetty yhteen tuotenumeroon. Myös useita eriä yhdestä ainoasta Excel-tiedostosta voidaan kohdistaa ja koota automaattisesti, kunhan yksiselitteiset tunnistetiedot ovat olemassa.
Jokainen datataso tarvitsee yksilöllisen avaimen: asiakasnumero, tilausnumero, näytenumero, parametri-ID, potilas-ID, laitetunniste tai viivakoodi. Jos tämä avain puuttuu, käytettävissänne on kattavat työkalut — hyödynnämme tällöin kaikkia olemassa olevia perustietokenttiä tai yhdistämme useita kenttiä tunnistusavaimeksi.
Kyllä. Viivakoodeilla yksilöidään näytteitä, materiaaleja, eriä, mittavälineitä ja laitteita; materiaalit ja erät voidaan skannata suoraan. Edellytyksenä on, että koodi tallennetaan yhtenevästi lähdejärjestelmässä ja Labordatenbankissa ja otetaan huomioon kohdistuksessa. Vaihtoehtoisesti sarjanumero toimii laitteen yksikäsitteisenä tunnisteena.
Yksilöllisten tunnisteiden, sovitettujen tunnistussääntöjen ja sopivan tuontitilan avulla. Oletustila update korvaa olemassa olevan arvon toisen tietueen luomisen sijaan — jos sama tiedosto tuodaan vahingossa uudelleen, kaksoiskappaletta ei synny. Avainten määrittely on erityisen kriittistä asiakkaiden, potilaiden, toimipaikkojen ja näytteiden osalta. Lisäksi pakollisten kenttien tarkistukset ja validointitarkastukset estävät puutteellisten tai ristiriitaisten tietojen käsittelyn kokonaan.
Molemmat ovat määritettävissä kenttäkohtaisesti: valitsette, mitä kenttiä tuonti saa korvata ja mitkä jätetään koskemattomiksi. Tyhjät arvot, jo olemassa olevat sisällöt ja erityistapaukset kannattaa testata huolellisesti, jotta mitään ei ylikirjoiteta tahattomasti.
Kyllä. Jokainen tuontoajo saa oman ID:n, jonka alle kaikki siihen liittyvät tiedot tallennetaan ja josta ne ovat aina haettavissa — raakadata mukaan lukien. Näin voidaan tarkistaa, milloin mikäkin tiedosto saapui minkä rajapinnan kautta, mitä tietueita siitä luotiin ja kuka tuonnin laukaisi. Jokainen ajo voidaan myös toistaa.
Jokainen rajapinta määritetään ensin testiympäristöön ja tarkistetaan edustavilla, mahdollisimman pitkälle anonymisoiduilla esimerkkitiedostoilla. Testauksessa käydään läpi perustapausten lisäksi erityisesti puuttuvat pakolliset kentät, tuntemattomat tunnisteet, erikoismerkit, tyhjät arvot ja toiminnalliset poikkeustapaukset. Vasta onnistuneen validoinnin jälkeen rajapinta viedään tuotantojärjestelmään — erillisillä kirjautumistiedoilla ja linkeillä kumpaankin ympäristöön.
Tarkista ensin lähdetiedosto, käytetyt avaimet, kohdistus ja muunnoslogiikka; virhelokit osoittavat, missä kohtaa ongelma on. Tukitiimille hyödyllisimpiä tietoja ovat anonymisoitu tuontitiedosto, kyseinen rajapinta, näyte- tai tuonti-ID, konkreettinen virheilmoitus sekä lyhyt kuvaus siitä, mitä tulosta odotitte. Näin syy saadaan rajattua huomattavasti nopeammin.
Tuontirajapintojen luonti ja muokkaus on rajattu pääkäyttäjärooleille. SFTP- ja API-yhteyksissä käytetään turvallisia kirjautumistietoja sekä erillisiä testi- ja tuotantotunnuksia, ja vastuut laboratorion, IT:n ja rajapintaylläpidon välillä määritellään selkeästi. Arkaluonteiset mittaus- ja potilastiedot kulkevat vain sovittuja, suojattuja reittejä pitkin; esimerkkitiedostojen ja tekoälypohjaisen kohdistuksen osalta anonymisointi on pakollista.
Kyllä. Käyttöönottovaiheessa käytämme juuri näitä samoja tuontirajapintoja vanhojen tietojenne migrointiin — erillistä migraatiotyökalua ette tarvitse. Näin aiemmat testaustulokset, asiakas- ja parametritiedot sekä suuret määrät vanhoja kalibrointitodistuksia, esimerkiksi Lotus Notesista, siirtyvät Labordatenbankiin ja ovat sen jälkeen normaalisti käytettävissä analyyseihin. Parhaiten soveltuvat rakenteiset CSV-tiedostot; mitä siistimpi vanhojen tietojen rakenne on, sitä vähemmän jälkityötä tarvitaan. Etuna on se, että sama rajapinta, jolla tiedot migroidaan, palvelee sellaisenaan jatkuvassa päivittäiskäytössä.
Mittaustietorajapinnalle prosessi etenee käytännössä näin:
  1. Avaa laitteen vientitiedosto Excelissä ja tallenna se CSV-muodossa UTF-8-merkistöllä.
  2. Tarkista attribuuttirivi ja tallenna vientitiedoston parametrin nimi parametrin perustietokenttään Importkey.
  3. Luo rajapinta kohdassa Näytteet → CSV-tuontirajapinnat → Uusi rajapinta: valitse tyypiksi Mittaustiedot, aseta merkistöksi UTF-8 ja valitse Näytetuonti.
  4. Jos attribuuttirivi puuttuu tai on puutteellinen: täydennä sarakeotsikot — niiden on oltava yksiselitteisiä eivätkä ne saa sisältää välilyöntejä — ja määritä, mistä rivistä alkaen tuonti alkaa.
  5. Lataa tiedosto, tee kohdistus ja yhdistä tiedot.
  6. Siirry näytteeseen ja lataa tiedosto suoraan sinne.
Tämän jälkeen testaat virhe- ja poikkeustapaukset testijärjestelmässä, aloitat tuotantokäytön pienellä tietomäärällä ja laajennat automaatiota ja valvontaa. Pakolliset kentät, tilalogiikka, laitemuoto ja tunnistussäännöt määritellään yhdessä rajapintatyöpajassa.

Vaihe vaiheelta -ohje videon kera: Mittaustietojen tuominen. Lisätietoja: Tuontirajapintojen yleiskatsaus, CSV-mittaustietorajapinnan luominen, Mittaustulosten tuominen laitteista, Muunnoskoodi muille tiedostomuodoille, Automaattinen FTP/SFTP-tuonti ja Tuontirajapintojen tekoälylaajennus.

Kyllä. Jokaisella tuontirajapinnalla on oma HTTPS-päätepisteensä, johon ulkoinen järjestelmä lähettää tietonsa POST-pyynnöllä — tunnistautuneena Basic Authilla tai varmenteella. Päätepiste vastaa koodilla 200, kun tiedot on vastaanotettu, ja koodilla 400, jos ne saapuivat perille, mutta niitä ei voitu käsitellä; jokainen yritys näkyy rajapintojen yleisnäkymässä. Vastakkaiseen suuntaan tilastot ja raportit tarjoavat ne tiedot, jotka ulkoinen järjestelmä tai tekoälyavustaja saa hakea. Käyttöohje kuvaa rakenteen ja testikutsun.
Kyllä. Pääkäyttäjänne voivat luoda uuden CSV-rajapinnan itse: lataa mallitiedosto, valitse erotin ja merkistö, kohdista sarakkeet kohdekenttiin ja tallenna. Ohjelmointitaitoja tarvitaan vasta silloin, kun harvinaisemmalle tiedostomuodolle vaaditaan muunnoskoodia — ja senkin pääkäyttäjänne voivat kirjoittaa ja ylläpitää itse.
Kyllä. Merkistö, päivämäärämuoto ja desimaalierotin määritellään rajapintakohtaisesti. Laite, joka käyttää pistettä desimaalierottimena tai antaa päivämäärät muodossa MM/DD/YYYY, luetaan siten täysin oikein. Kokemuksemme mukaan väärin asetetut arvot tässä kohdassa ovat yleisin syy ääkkösten rikkoutumiseen ja mittauslukujen väärintulkintaan.
Kyllä, se on itse asiassa tavanomainen käytäntö. Monet laboratoriot aloittavat perustiedoista — asiakkaat, parametrit, raja-arvot — ja jättävät tuloshistorian aluksi vanhaan järjestelmään. Rinnakkaiskäytön aikana kertyvät tiedot siirretään myöhemmin saman tuontirajapinnan kautta; toinen migraatioajo ei ole poikkeus. Te päätätte, kuinka paljon historiaa siirretään.
Kyllä, ja korjaus säilyy täysin jäljitettävissä. Valvontaloki (Audit Trail) tallentaa tiedon siitä, kuka mitäkin arvoa muutti ja milloin; alun perin tuotu arvo ei katoa mihinkään. Käyttöoikeuksien avulla määritätte, kenellä on korjausoikeudet ja kenellä vain lukuoikeus.
Ei perinteisenä kansiovalvontana — ratkaisu tähän on SFTP. Laitteenne tai palvelimenne tallentaa tiedostot SFTP-hakemistoon, josta Labordatenbank noutaa ne itsenäisesti kymmenen minuutin välein, jopa kymmenen tiedostoa per sykli, ja siirtää tai poistaa ne tämän jälkeen. Työntekijöillenne lopputulos on täysin sama: tiedoston tallentaminen riittää, kenenkään ei tarvitse ladata mitään käsin.
Kyllä. Yhteys ei toimi vain yhteen suuntaan: Labordatenbank voi tehdä kyselyn laitteelle tai ulkoiselle järjestelmälle REST-APIn kautta — se lähettää esimerkiksi näytenumeron, ja laite vastaa juuri kyseisen näytteen tuloksilla. Tämä on selkein toimintatapa silloin, kun laitteen ei haluta tallentavan tiedostoja tai kun halutaan hallita tarkasti, milloin mitäkin tietoja noudetaan. Mitä tietoja Labordatenbank puolestaan luovuttaa ulospäin, määritetään kohdassa tilastot ja raportit.
Kyllä, molempia. AnIML-toteutuksen teemme yhdessä kumppanimme Splashlaken kanssa, ja Labordatenbank on SiLA-valmis. Erityisesti tarjouskilpailuissa näitä kahta standardia kysytään usein — käytännössä useimmat integraatiot toteutetaan silti edelleen CSV-tiedostojen, laitekohtaisten vientitiedostojen sekä REST-rajapinnan kautta.

Onboarding: Tuontirajapinnat

Tuo mittausarvot, näytteet ja asiakastiedot automaattisesti laitteista, ulkoisista laboratorioista ja ERP-järjestelmistä

  1. Mittausarvojen tuonti CSV-tiedostoista
  2. Käyttöoikeudet, tuontiavaimet ja tuontitilat
  3. Tekoälypohjainen tuontikohdistus ilman ohjelmointitaitoja
  4. GC- ja HL7-tiedostojen liittäminen muunnoskoodin avulla
  5. Automaatio HTTPS- ja SFTP-protokollilla, liitäntä ERP-järjestelmiin
  6. Usein kysyttyä aiheestaTuontirajapinnat ja LIMS

LDB-toiminnot

Laboratorion tiedonhallintajärjestelmä (LIMS)

Laadunhallintamoduulit

Helpota dokumentointia ja sovella ISO-vaatimuksia arjessa

Wir verwenden Cookies

Wir verwenden unsere eigenen Cookies und Cookies von Drittanbietern, damit wir Ihnen die Website anzeigen und besser verstehen können, wie Sie diese nutzen, um unsere angebotenen Dienste zu verbessern.