search

datagov-cz / sgov-assembly-line

Issue tracker k výrobní lince sémantických konceptuálních modelů.
MIT License
3 stars 0 forks source link

Export pro účely RPP #129

Closed trusinas closed 11 months ago

trusinas commented 1 year ago

Popis

Výrobní lince chybí možnost vytvořený koncptuální model vyexportovat pro účely evidence údajů v RPP.

Využití

Jedním z důvodů, proč používat výrobní linku, je povinnost zaevidovat údaje vedené v agendě do RPP. Výsledkem by měl být seznam jako např. na slidu https://docs.google.com/presentation/d/1Imr18zBgSrgR-uvv9CD_DWX3_qyMaR79_P_fCvXb_tY/edit#slide=id.g1494cb7098d_0_873 Jaká bude reálná podoba exportu (textový soubor, excel atd.) je jedno. Providla pro převod modelu na logiku evidence v RPP obsahuje metodika, s. 32 a následující. RPP možnost importu údajů neumožňuje, ale převod diagramu na strukturu, v jaké jsou údaje v RPP evidovány, proces evidence zrychlí.

Užitečnost

Evidenci údajů bez navrhované funcionality lze provést, ale je zbytečně zdouhavá. Nicméně bez dané funkcionality lze obtížně přesvědčovat úředníky/úřednice, aby výrobní linku používali, pokud je jejich cílem evidence údajů v agendě v RPP.

bindeali commented 1 year ago

Shrnutí dosavadního stavu: Export byl implementován do testovacího prostředí s tímto OG commitem. Zpětná vazba je následující: 

Dobrý den,

pro účely testování exportu do RPP jsem vytvořil diagram https://slovník-test.mvcr.gov.cz/modelujeme/projects/instance-121990092.
Zkoušel jsem exportovat a narazil jsem na chyby:
do exportu CSV i TXT jde jiný diagram než aktuálně otevřený
syntaxe CSV souboru je nejednotná: názvy sloupců nejsou v „", ale jednotlivé hodnoty ano
Můžete se na to prosím podívat?
bindeali commented 1 year ago

Chyby byly opravené přes https://github.com/opendata-mvcr/ontoGrapher/pull/480, který je nyní dostupný v testovacím prostředí.

trusinas commented 1 year ago

1) Můžete prosím zkontrolovat odřádkování? Zkoušel jsem na Win i Linux a je to vše na jednom řádku. Platí pro export do CSV i TXT. 2) Při exportu do TXT se vytváří soubor bez přípony ".txt".

trusinas commented 1 year ago

Díky. Předchozí chyby byly opraveny, takže jsem mohl provést text exportu jako takového. Pro tyto účely jsem vytvořil jednoduchý model - https://slovník-test.mvcr.gov.cz/modelujeme/projects/instance-121990092. Dle modelu a metodiky bych čekal následující strukturu 1) TXT

2) CSV

Subjekt/objekt Popis subjektu Právní předpis (vč. ustanovení) Údaj Popis údaje Právní předpis (vč. ustanovení) Typ
Typ subjektu Typ subjektu - definice Typ subjektu - zdroj       Typ objektu
Typ subjektu     vlastnost subjektu 03     Typ vlastnosti
Typ subjektu     vlastnost subjektu 02     Typ vlastnosti
Typ subjektu     vlastnost subjektu 01 vlastnost subjektu 01 - definice vlastnost subjektu 01 - zdroj Typ vlastnosti
Typ subjektu     jednoduchá událost     Typ události
Typ subjektu     agendový číselník     Typ objektu ?
událost s vlastnostmi           Typ události
událost s vlastnostmi     vlastnost události 01     Typ vlastnosti
událost s vlastnostmi     vlastnost události 02     Typ vlastnosti
událost s vlastnostmi     týká se     Typ vztahu
Typ role           Typ objektu
Typ role     vlastnost role 01     Typ vlastnosti
Typ role     vlastnost role 01     Typ vlastnosti
Typ role     má vazbu na     Typ vztahu
má vazbu s vlastnostmi           Typ vztahu
má vazbu s vlastnostmi     vlastnost vazby 01 vlastnost vazby 01 - definice vlastnost vazby 01 - zdroj Typ vlastnosti
má vazbu s vlastnostmi     vlastnost vazby 02     Typ vlastnosti
má vazbu s vlastnostmi     má vztažený prvek 1     ?
má vazbu s vlastnostmi     má vztažený prvek 2     ?
Role 2           Typ objektu

Ke stávající implementaci mám následující připomínky Obecně:

V případě, že typ události má vlastnosti, je k diskuzi, zda by se neměl modelovat jako typ objektu, potom by export fungoval správně (a analogicky typ vztahu s vlastnostmi).

Nelze otestovat export pro typ: • fáze • činnost protože daný typ nelze nastavit.

K CSV

MichalMed commented 1 year ago

Ne všem vašim připoínkám rozumím. Potřeboval bych tedy iupřesnění . Týká se to předvším:

Mohl byste upřesnit vaše očekávání, ideálně na konkrétních příkladech? Zbytek by neměl být problém.

trusinas commented 1 year ago

Metodikou myslím C2V11 - Metodika definice údajů vedených v agendě

nezohledňuje se číselník dle metodiky

Podle metodiky (Odvození evidence údajů agendy, bod 5) se v RPP bude typ objektu, který je specializací číselníku, evidovat jako údaj objektu/subjektu. Toto aktuálně není implementováno. Případně je možné, že jsem použil špatný objekt číselník, a proto export nefungoval. Proto jsem psal žádost o upřesnění. Pokud je implementace náročná, můžeme to (zatím?) přeskočit.

je nutné dořešit, jak se bude přavádět událost, pokud má vlastnosti

Podle metodiky (Odvození evidence údajů agendy, bod 4) bude událost evidována jako údaj. Tak se export aktuálně nechová. Nicméně Martin Nečaský potvrdil, že typ události s více vlastnostmi bude v RPP skutečně (navzdory metodice) jako nový objekt. Ponechal bych stávající implementaci.

Nelze otestovat export pro typ

Toto je častým předmětem dotazů. Pokud se v metodice uvádí, že existují typy fáze a činnost, ale ve VL tomu tak není, uživatel se na to oprávněně ptá. Typy potřebujeme sjednotit (úpravou metodiky nebo VL).

upravit generování zdroje, aby pro daný typ zobrazoval správný zdroj

Používám pojmy z metodiky, a proto asi došlo ke zmatení. V př. exportu do CSV se z VL exportuje atribut "Zdroj", který je přejmenován na "Právní předpis (vč. ustanovení)". Dle příkladu výše je nutné, aby se exportoval jak pro typy (z hlediska VL), tak i pro jejich vlastnosti.

doplnit generování definice (a rozlišovat dle typu)

V př. exportu do CSV se z VL exportuje atribut "Definice", který je přejmenován na "Popis subjektu" a "Popis údaje". Dle příkladu výše je nutné, aby se exportoval jak pro typy (z hlediska VL), tak i pro jejich vlastnosti.

Pro generování Zdroje/ Právní předpis (vč. ustanovení) a Definice/Popis subjektu/údaje do CSV platí, že první řádek, který se týká objektu (resp. události), bude obsahovat Zdroj a Definici objektu, další řádky se budou týkat jeho vlastností, takže Zdroj a Definice budou obsahovat Zdroj a Definici dané vlastnosti. Dokud jde o tentýž objekt, je nutné opakovat jeho název (1. sloupec), aby toto z tabulky bylo zřejmé.

Názorně jsem se to snažil ukázat na té tabulce výše. Radši přikládám i export diagramu. diagram_export

bindeali commented 1 year ago

V nejnovější testovací verzi to nyní vypadá takto: image Číselníky se tedy zohledňují jako typy objektu.

bindeali commented 1 year ago

Shrnutí dosavadního stavu:

Export pojmů

Obecně se držíme návrhu z Šimonova komentáře, společně s omezeními.

Tento diagram: Snímek obrazovky 2023-08-01 144239 tvoří tyto exporty:

image image

Ale tento diagram: image vytváří tento export:

Změny v OG prezentaci:

image V OG uvažujeme o přidání modelování vztahů s vlastnostmi, které prozatím vypadá takto. Deploy preview této změny je na https://github.com/datagov-cz/ontoGrapher/pull/501.