Projekt

Všeobecné

Profil

Napoveda » Napoveda-InstrumentSync »

Import nameraných údajov cez modul InstrumentSync

Modul InstrumentSync slúži na hromadný import analýz vzoriek vody do informačného systému Previs z automatizovaných meracích prístrojov.

Úvod

Modul Previs.InstrumentSync zabezpečuje automatizovaný prenos nameraných dát z laboratórnych prístrojov do systému Previs. Import prebieha na základe spárovania ukazovateľov a meracích prístrojov, vždy na pokyn užívateľa.

Hlavné výhody:
  • Výrazné zrýchlenie spracovania výsledkov,
  • Zníženie chybovosti spôsobenej manuálnym prepisom,
  • Odbremenenie personálu od rutinných úloh,
  • Vyššia konzistencia a spoľahlivosť údajov.

Základné pojmy

Pojem Popis
Identifikátor vzorky Alfanumerický kód v tvare XX/CCCC, kde XX je identifikátor laboratória a CCCC je číslo vzorky. Príklad: LPV/1234
Automatizovaný merací prístroj Zariadenie, ktoré automaticky vykonáva analýzy vzoriek a produkuje výstupné súbory s výsledkami
CSV súbor Textový súbor s hodnotami oddelenými čiarkou alebo bodkočiarkou
Analytik / Operátor Odborný pracovník, ktorý realizuje analýzu vzorky vody

Prístup k modulu

Pre používanie modulu InstrumentSync je potrebné:
  1. Byť zaradený do príslušnej AD skupiny
  2. Mať právo Editácie pre formulár MENU / InstrumentSync / Import
Dostupné formuláre:
  • MENU / InstrumentSync / Firmy - číselník dodávateľov prístrojov,
  • MENU / InstrumentSync / Automatizované meracie prístroje - evidencia prístrojov,
  • MENU / InstrumentSync / Príprava vzoriek pre aut. prístroje - export zoznamu vzoriek,
  • MENU / InstrumentSync / Import - samotný import dát.

Konfigurácia modulu

Pred prvým použitím je potrebné vykonať úvodnú konfiguráciu.

Evidencia dodávateľských firiem

  1. Otvorte MENU / InstrumentSync / Firmy,
  2. Kliknite ikonu *+* pre pridanie nového záznamu,
  3. Vyplňte údaje o dodávateľskej firme,
  4. Prejdite na stránku Údaje pre modul InstrumentSync,
  5. Vyplňte konfiguračné údaje:
Pole Popis
Názov triedy pre import Trieda zabezpečujúca čítanie dát (vyplní dodávateľ Previsu)
Sieťová cesta pre export Zdieľaný adresár alebo URL webovej služby
Cesta po úspešnom importe Adresár pre presunutie naimportovaných súborov
Cesta po neúspešnom importe Adresár pre presunutie nenaimportovaných súborov
Filter pre importné súbory Napr. hermes*.csv
Oddeľovač položiek Čiarka , alebo bodkočiarka ;

Konfigurácia automatizovaných prístrojov

  1. Vytvorte prístroj v MENU / Laboratórny denník / Metrológia / Prístroje,
  2. Otvorte MENU / InstrumentSync / Automatizované meracie prístroje,
  3. Vypnite filter (odškrtnite zobrazovať iba automatizované prístroje),
  4. Nalistujte požadovaný prístroj,
  5. Kliknite ikonu editácie a vyplňte:
    • Identifikátor aut. meracieho prístroja - označenie v CSV súboroch
    • Firma zabezpečujúca export údajov

Párovanie meracích prístrojov

Identifikátor prístroja v CSV súbore musí zodpovedať hodnote v poli Identifikátor aut. meracieho prístroja.

Príklad z CSV: ak je v súbore hodnota G6470B, rovnaká hodnota musí byť vyplnená v konfigurácii prístroja.

Párovanie užívateľov

Pre správnu identifikáciu analytikov je potrebné spárovať ich kontá:

  1. Otvorte MENU / InstrumentSync / Automatizované meracie prístroje,
  2. Prejdite na stránku Párovanie užívateľov,
  3. Pridajte identifikátory kont z automatizovaných prístrojov,
  4. Ku každému priraďte konto z Previsu.

Tip: Pre hromadný import použite tlačidlo Import identifikátorov operátorov z CSV súboru

Párovanie ukazovateľov

  1. Na stránke Párovanie ukazovateľov pridajte identifikátory z prístroja,
  2. Ku každému identifikátoru vyplňte:
    • Ukazovateľ podľa Previsu - výber zo zoznamu,
    • Násobok nameranej hodnoty - exponent X pre prepočet (10^X).

Pre hodnotu bez prepočtu zadajte 0 (10^0 = 1).

Tip: Použite Import identifikátorov ukazovateľov z CSV súboru pre hromadné pridanie.

Predvoľby metód

Na stránke Predvoľby metód definujte metódu pre kombináciu laboratória a ukazovateľa. Ak metódy nevyplníte, použije sa metóda s najmenším poradovým číslom.

Príprava vzoriek

Formulár MENU / InstrumentSync / Príprava vzoriek pre aut. prístroje umožňuje:

Filtrovanie:
  • Obdobie (dátum odberu),
  • Laboratórium,
  • Firma,
  • Prístroj,
  • Matrica.
Postup:
  1. Nastavte filtre,
  2. Zaškrtnite požadované ukazovatele,
  3. Kliknite Načítať analýzy.
Dostupné exporty:
Export zoznamu vzoriek Zoznam identifikátorov pre zadanie do prístroja
Export vzorového súboru pre import CSV súbor s náhodnými hodnotami pre testovanie

Import dát

Načítanie dát

  1. Otvorte MENU / InstrumentSync / Import,
  2. Vyberte laboratórium (voliteľné),
  3. Vyberte automatizovaný prístroj,
  4. Kliknite Načítať dáta,
  5. Zaškrtnite práve jeden súbor pre import,
  6. Kliknite Ďalej.

Upozornenie: Import je možný len do vzoriek aktuálne zvoleného roka.

Zobrazované informácie:
Stĺpec Význam
Počet analýz Počet záznamov v súbore
Dáta sú valídne Štrukturálna správnosť súboru
Status Zelená ikona = bez chýb
Zdroj Názov súboru
Chyby načítania Popis prípadnej chyby

Párovanie číselníkov

Ak chýbajú spárované entity, systém zobrazí červenú ikonu a ponúkne doplnenie:

  • Chýbajúce identifikátory prístrojov - neznámy prístroj v súbore,
  • Chýbajúce identifikátory ukazovateľov - nespárovaný ukazovateľ,
  • Chýbajúce identifikátory operátorov - nespárovaný užívateľ.

Po doplnení sa zobrazí zelená ikona a je možné pokračovať.

Validácia dát

Systém kontroluje formát každého záznamu. Možné chyby:

Chyba Popis
Neplatný formát údaja [Sample Name]! Identifikátor vzorky musí byť v tvare XX/CC
Chýba údaj [Compound Name]! Chýba identifikátor ukazovateľa
Chýba údaj [Instrument Name]! Chýba identifikátor prístroja
Chýba nameraná hodnota! Prázdna koncentrácia
Chýba údaj [Acq Operator]! Chýba identifikátor operátora
Neplatný formát údaja [Acq. Date-Time]! Neplatný dátum merania
Neplatný identifikátor laboratória Laboratórium nie je v Previse
Pri úspešnej validácii je možné:
  • Zmeniť predvolenú metódu,
  • Zmeniť akreditovanosť,
  • Odznačiť nežiadúce riadky.

Nastavenia importu

Všeobecné nastavenia

Nastavenie Popis
Zapísať spárované entity Uloží nové párovanie k prístroju (povinné)
Zrušiť import pri zlyhaní Ak zlyhá jedna hodnota, nenaimportuje sa nič (povinné)
Neimportovať bez predvolených metód Vyžaduje vyplnené predvoľby metód
Prepísať existujúce hodnoty Umožní prepísať už existujúce namerané hodnoty
Presunúť nevalídne súbory Po zlyhaní presunie súbor do chybového adresára
Presunúť úspešné súbory Po úspechu presunie súbor do archívneho adresára
Extrahovať valídne záznamy Vytvorí súbor _EXTRACTED s valídnymi záznamami

Nastavenia importu analýz

Nastavenie Popis
Zapísať ceny Import ceny za analýzu
Zapísať neistoty Import neistoty podľa metódy
Zapísať prístroje Import údaja o prístroji
Zapísať pracovníkov Import údaja o analytikovi
Vložiť dátumy prvého zápisu Import dátumu a času analýzy
Vložiť poznámky do protokolu Import predvolenej poznámky

Tip: Zaškrtnite uložiť tieto predvoľby pre automatické použitie pri ďalšom importe.

Spustenie importu

  1. Skontrolujte nastavenia,
  2. Kliknite Ďalej,
  3. Kliknite Dokončiť.
Výsledky importu:
  • Zelená obrazovka = import úspešný,
  • Červená obrazovka = zoznam chýb.

Garantovaný výkon: 200 analýz za minútu

Chybové stavy a ich riešenie

Duplicita importovaných údajov

Príčina: V ukazovateli vzorky už existuje nameraná hodnota.
Riešenie: Zapnite možnosť prepísať existujúce namerané hodnoty.

Neplatný identifikátor vzorky

Systém hľadá vzorku podľa:
  • Aktuálne zvolený rok,
  • Číslo vzorky z identifikátora,
  • Laboratórium zodpovedajúce identifikátoru.

Príklad: PV/115 v roku 2025 = vzorka č. 115 v laboratóriu s identifikátorom PV.

Riešenie chybných súborov

Možnosti opravy:

  1. Manuálna oprava súboru - otvorte CSV v Poznámkovom bloku, opravte chybu alebo zmažte riadok,
  2. Extrakcia valídnych dát - ak bola zapnutá voľba extrakcie, systém vytvorí:
    • nazov_EXTRACTED.csv - valídne záznamy,
    • nazov_INVALID.csv - nevalídne záznamy,
  3. Opakovaný import - zaškrtnite načítať iba _EXTRACTED súbory a spustite import znova.

Podporované formáty dát

Trieda Popis
UniversalCsvFileBatchLoader Univerzálny CSV súbor
HermesSimpleCsvFileBatchLoader CSV pre prístroje Hermes (jednoduchý)
HermesAdvancedCsvFileBatchLoader CSV pre prístroje Hermes (rozšírený s filtrami)
UniversalJsonFileBatchLoader JSON súbor (pripravené pre budúcnosť)
RestApiBatchLoader Webová služba (pripravené pre budúcnosť)

Rýchly prehľad - kontrola pred importom

  • Dodávateľská firma je zaevidovaná,
  • Cesty pre import sú správne nastavené,
  • Prístroj je označený ako automatizovaný,
  • Identifikátor prístroja zodpovedá CSV súboru,
  • Užívatelia sú spárovaní,
  • Ukazovatele sú spárované,
  • Metódy sú predvolené (voliteľné),
  • Laboratórium má vyplnený identifikátor pre InstrumentSync.