nl-digigo / NLCS

Technische documentatie en issues NLCS
Creative Commons Attribution 4.0 International
3 stars 0 forks source link

Publicatie van bedrijfstoestand in NLCS publicatie / objectentabellen; onderdeel van veld BEWERKING #461

Open ElisabethKloren opened 1 month ago

ElisabethKloren commented 1 month ago

Conform het besluit in issue #371 in deze issue de voorgestelde uitwerking in de NLCS Database ter review door de developers van de softwareleveranciers.

Uitgangspunten

  1. Voor in Reserve en Verlaten hebben alle ELEMENTEN dezelfde kleur, linetype en lineweight. Er komen daarmee drie attributen bij voor elke combinatie van een status en een bedrijfstoestand

Eisen aan applicaties

  1. De gebruiker moet voor objecten waar deze attributen zijn ingevuld twee picklisten krijgen bij het tekenen van een object of bij het wijzigen van de laagnaam: de status en de bedrijfstoestanden, waarbij als default "in gebruik" geselecteerd is (NB: eventueel kan als service naar de gebruikers de BEWERKING ook worden aangeboden als picklist; ook al staat dat in de database als onderliggende) laagnaam;
  2. de gebruiker moet bij een status alleen de keuze krijgen om een bedrijfstoestand in te voeren, als deze attributen bij dit object staan ingevuld. Bijvoorbeeld: bij T en X komt geen bedrijfstoestand voor in de tabellen van netbeheer.
  3. De gebruiker moet bij het tekenen van andere objecten maar één picklist krijgen, voor de huidige NLCS gebruikers die de buitenruimte tekent veranderd er in principe niks.
  4. Na het selecteren van de status en bedrijfstoestand moeten deze op de juiste plek in de laagnaam worden gezet:
    • Er komen twee soorten dingen in het veld bewerking te staan: [bedrijfstoestand] en BEWERKING;
    • Scheidingsteken: onderliggend streepje = underscore alleen gebruiken als er zowel een bedrijfstoestand als een BEWERKING is
    • bedrijfstoestand altijd tussen blokhaken plaatsen (wat: OP DE KOP = bewerking met spaties)
    • De bedrijfstoestand wordt voluit geschreven, voorbeeld: N-**-KL-BRANDSTOF_TRANSPORTLEIDING_STAAL-[RESERVE]_VOLSCHUIMEN-G

In de publicatie kun je dus deze extra attributen verwachten. De standaard attributen

Status Bedrijfstoestand: In Gebruik Bedrijfstoestand: Reserve Bedrijfstoestand: Verlaten
B lw_b,kl_b,kl_b_a,kl_b_gd,kl_b_gn,kl_b_v,lt_b lw_b_[RESERVE],kl_b_[RESERVE],lt_b_[RESERVE] lw_b_[VERLATEN],kl_b_[VERLATEN],lt_b_[VERLATEN]
N lw_n,kl_n,kl_n_a,kl_n_gd,kl_n_gn,kl_n_v,lt_n lw_n_[RESERVE],kl_n_[RESERVE],lt_n_[RESERVE] lw_n_[VERLATEN],kl_n_[VERLATEN],lt_n_[VERLATEN]
V lw_v,kl_v,kl_v_a,kl_v_gd,kl_v_gn,kl_v_v,lt_v lw_v_[RESERVE],kl_v_[RESERVE],lt_v_[RESERVE] lw_v_[VERLATEN],kl_v_[VERLATEN],lt_v_[VERLATEN]
T lw_t,kl_t,kl_t_a,kl_t_gd,kl_t_gn,kl_t_v,lt_t niet van toepassing niet van toepassing
X niet van toepassing niet van toepassing niet van toepassing
R Lagen met de STATUS “R” moeten dezelfde eigenschappen krijgen als lagen met de STATUS “N”. Lagen met de STATUS “R” moeten dezelfde eigenschappen krijgen als lagen met de STATUS “N”. Lagen met de STATUS “R” moeten dezelfde eigenschappen krijgen als lagen met de STATUS “N”.
ElisabethKloren commented 1 month ago

Gestuurd aan de experts van leveranciers,

Zoals beloofd een voorstel van mijn kant hoe we de bedrijfstoestanden van de netbeheerder kunnen opnemen in de NLCS database, zodat jullie bij je developers kunnen checken of dit inderdaad geprogrammeerd kan worden. Het voorstel staat in deze issue: https://github.com/nl-digigo/NLCS/issues/461

Ik ben zo dit mogelijk bij de originele vorm van de NLCS database gebleven, waarbij alleen extra kolommen zijn toegevoegd in de database. Graag jullie feedback over de voorgestelde oplossing.

FrankvdHeijden commented 1 month ago

Opname bedrijfstoestand in NLCS database

“Voor in Reserve en Verlaten hebben alle ELEMENTEN dezelfde kleur, linetype en lineweight. Er komen daarmee drie attributen bij voor elke combinatie van een status en een bedrijfstoestand”

Gebruikersfunctionaliteit in software voor “bedrijfstoestand”

3. De gebruiker moet voor objecten waar deze attributen zijn ingevuld twee picklisten krijgen bij het tekenen van een object of bij het wijzigen van de laagnaam: de status en de bedrijfstoestanden, waarbij als default "in gebruik" geselecteerd is (NB: eventueel kan als service naar de gebruikers de BEWERKING ook worden aangeboden als picklist; ook al staat dat in de database als onderliggende) laagnaam;

Voor status geldt dat deze functionaliteit reeds bestaat en uiteraard moet blijven bestaan

Toepassing van “bedrijfstoestand” voor specifieke NLCS statussen

4. de gebruiker moet bij een status alleen de keuze krijgen om een bedrijfstoestand in te voeren, als deze attributen bij dit object staan ingevuld. Bijvoorbeeld: bij T en X komt geen bedrijfstoestand voor in de tabellen van netbeheer.

Toepassing van “bedrijfstoestand” voor specifieke hoofdgroepen

5. De gebruiker moet bij het tekenen van andere objecten maar één picklist krijgen, voor de huidige NLCS gebruikers die de buitenruimte tekent veranderd er in principe niks.

Opmerking over blokhaken:

6. Na het selecteren van de status en bedrijfstoestand moeten deze op de juiste plek in de laagnaam worden gezet: Er komen twee soorten dingen in het veld bewerking te staan: [bedrijfstoestand] en BEWERKING; Scheidingsteken: onderliggend streepje = underscore alleen gebruiken als er zowel een bedrijfstoestand als een BEWERKING is bedrijfstoestand altijd tussen blokhaken plaatsen (wat: OP DE KOP = bewerking met spaties) De bedrijfstoestand wordt voluit geschreven, voorbeeld: N-**-KL-BRANDSTOF_TRANSPORTLEIDING_STAAL-[RESERVE]_VOLSCHUIMEN-G

Probleembeschrijving Gebruik van de tekens “[” en “]” in verband met de herkenbaarheid van de bedrijfstoestand in de laagnaam geeft geen eenduidige resultaten in bijvoorbeeld layer filters binnen AutoCAD.

Beschrijving De tekens “[” en “]” hebben betekenis in AutoCAD. Bij het gebruik van layer filters in AutoCAD is het resultaat niet zoals verwacht wanneer letterlijk “[VERPLAATSEN]” wordt toegepast.

Vanuit de documentatie van Autodesk ten aanzien van karakters [ ]: [...] Matches any one of the characters enclosed [~...] Matches any single character not enclosed

Voorbeeld: [ABC] geeft laag “A” en “C” als resultaat terug

Voorstel Deze karakters in verband met de zuiverheid en conflicterende functionaliteit in (in ieder geval) AutoCAD niet te gebruiken en “bedrijfstoestanden” volgens voorstel Sander met vaste lijst te beschrijven.

Onderbouwing: Met de onderbouwing “altijd als eerste object” voor bedrijfstoestand binnen de NLCS bewerkingen wordt het kenmerk altijd voorafgegaan met een “-” en beëindigd met “ ” of “_” Daarnaast is de lijst beperkt tot bekende waarden en is daarmee te documenteren. Filtering is dus met bovenstaande sowieso mogelijk.

ElisabethKloren commented 1 month ago

Opname bedrijfstoestand in NLCS database

“Voor in Reserve en Verlaten hebben alle ELEMENTEN dezelfde kleur, linetype en lineweight. Er komen daarmee drie attributen bij voor elke combinatie van een status en een bedrijfstoestand”

  • Wenselijk is om hier meer database velden beschikbaar te hebben vergelijkbaar met overige NLCS kenmerken; Onderbouwing: Kleur kan afhankelijk zijn van netvlak/spanningsniveau; zou ook kunnen gelden voor lijntype (onderscheid in ieder geval voor RESERVE en VERLATEN en mogelijk ook LS MS HS)

Dit klopt, de kleuren kunnen per NLCS-Object verschillen, er zijn verschillende objecten voor LS MS HS enzovoorts. De zin zegt alleen maar dat de kleuren worden toegepast op alle ELEMENTEN (G/A/S en alle andere). Voorgestelde nieuwe tekst:

Een NLCS Objecten waarop de bedrijfstoestand van toepassing is krijgt per combinatie van een status en een bedrijfstoestand drie extra attributen: kleur, linetype en lineweight. Deze attributen zijn van toepassing op alle ELEMENTEN

ElisabethKloren commented 1 month ago

Gebruikersfunctionaliteit in software voor “bedrijfstoestand”

3. De gebruiker moet voor objecten waar deze attributen zijn ingevuld twee picklisten krijgen bij het tekenen van een object of bij het wijzigen van de laagnaam: de status en de bedrijfstoestanden, waarbij als default "in gebruik" geselecteerd is (NB: eventueel kan als service naar de gebruikers de BEWERKING ook worden aangeboden als picklist; ook al staat dat in de database als onderliggende) laagnaam;

  • Voor de toepassing van de “bedrijfstoestand” moet de gebruiker in staat zijn om op basis van een voor gedefinieerde lijst (=picklist) de bedrijfstoestand kunnen selecteren voor objecten. Daarnaast moet de bedrijfstoestand per object of over selecties van meerdere objecten gewijzigd kunnen worden.

Voor status geldt dat deze functionaliteit reeds bestaat en uiteraard moet blijven bestaan

akkoord, laatste zin komt er bij in de tekst.

ElisabethKloren commented 1 month ago

Toepassing van “bedrijfstoestand” voor specifieke NLCS statussen

4. de gebruiker moet bij een status alleen de keuze krijgen om een bedrijfstoestand in te voeren, als deze attributen bij dit object staan ingevuld. Bijvoorbeeld: bij T en X komt geen bedrijfstoestand voor in de tabellen van netbeheer.

  • “TIJDELIJK” kan voorkomen voor netbeheer, X kan uberhaupt door een gebruiker niet worden gekozen. Daarmee vervalt bovenstaande regel.

Akkoord, dat betekent dat de tabel extra attributen krijgt

Status Bedrijfstoestand: In Gebruik Bedrijfstoestand: Reserve Bedrijfstoestand: Verlaten
B lw_b,kl_b,kl_b_a,kl_b_gd,kl_b_gn,kl_b_v,lt_b lw_b_RESERVE,kl_b_RESERVE,lt_b_RESERVE lw_b_VERLATEN,kl_b_VERLATEN,lt_b_VERLATEN
N lw_n,kl_n,kl_n_a,kl_n_gd,kl_n_gn,kl_n_v,lt_n lw_n_RESERVE,kl_n_RESERVE,lt_n_RESERVE lw_n_VERLATEN,kl_n_VERLATEN,lt_n_VERLATEN
V lw_v,kl_v,kl_v_a,kl_v_gd,kl_v_gn,kl_v_v,lt_v lw_v_RESERVE,kl_v_RESERVE,lt_v_RESERVE lw_v_VERLATEN,kl_v_VERLATEN,lt_v_VERLATEN
T lw_t,kl_t,kl_t_a,kl_t_gd,kl_t_gn,kl_t_v,lt_t lw_t_RESERVE,kl_t_RESERVE,lt_t_RESERVE lw_t_VERLATEN,kl_t_VERLATEN,lt_t_VERLATEN
X niet van toepassing niet van toepassing niet van toepassing
R Lagen met de STATUS “R” moeten dezelfde eigenschappen krijgen als lagen met de STATUS “N”. Lagen met de STATUS “R” moeten dezelfde eigenschappen krijgen als lagen met de STATUS “N”. Lagen met de STATUS “R” moeten dezelfde eigenschappen krijgen als lagen met de STATUS “N”.
ElisabethKloren commented 1 month ago

Toepassing van “bedrijfstoestand” voor specifieke hoofdgroepen

5. De gebruiker moet bij het tekenen van andere objecten maar één picklist krijgen, voor de huidige NLCS gebruikers die de buitenruimte tekent veranderd er in principe niks.

  • Voorgestelde aanscherping; Regel zegt hier eigenlijk: “De toepassing voor een bedrijfstoestand wordt enkel toegepast op objecten waarvoor dit is ingeregeld (voor nu zal dit neerkomen op enkel objecten uit de hoofdgroep KL)”

Akkoord

ElisabethKloren commented 1 month ago

Opmerking over blokhaken:

6. Na het selecteren van de status en bedrijfstoestand moeten deze op de juiste plek in de laagnaam worden gezet: Er komen twee soorten dingen in het veld bewerking te staan: [bedrijfstoestand] en BEWERKING; Scheidingsteken: onderliggend streepje = underscore alleen gebruiken als er zowel een bedrijfstoestand als een BEWERKING is bedrijfstoestand altijd tussen blokhaken plaatsen (wat: OP DE KOP = bewerking met spaties) De bedrijfstoestand wordt voluit geschreven, voorbeeld: N-**-KL-BRANDSTOF_TRANSPORTLEIDING_STAAL-[RESERVE]_VOLSCHUIMEN-G

Probleembeschrijving Gebruik van de tekens “[” en “]” in verband met de herkenbaarheid van de bedrijfstoestand in de laagnaam geeft geen eenduidige resultaten in bijvoorbeeld layer filters binnen AutoCAD.

Beschrijving De tekens “[” en “]” hebben betekenis in AutoCAD. Bij het gebruik van layer filters in AutoCAD is het resultaat niet zoals verwacht wanneer letterlijk “[VERPLAATSEN]” wordt toegepast.

Vanuit de documentatie van Autodesk ten aanzien van karakters [ ]: [...] Matches any one of the characters enclosed [~...] Matches any single character not enclosed

Voorbeeld: [ABC] geeft laag “A” en “C” als resultaat terug

Voorstel Deze karakters in verband met de zuiverheid en conflicterende functionaliteit in (in ieder geval) AutoCAD niet te gebruiken en “bedrijfstoestanden” volgens voorstel Sander met vaste lijst te beschrijven.

Onderbouwing: Met de onderbouwing “altijd als eerste object” voor bedrijfstoestand binnen de NLCS bewerkingen wordt het kenmerk altijd voorafgegaan met een “-” en beëindigd met “ ” of “_” Daarnaast is de lijst beperkt tot bekende waarden en is daarmee te documenteren. Filtering is dus met bovenstaande sowieso mogelijk.

Akkoord om blokhaken te laten vervallen. In de database zijn bij sommige objecten extra attributen te vinden met daarin de naam van de bedrijfstoestand; er wordt ook een lijst met bedrijfstoestanden gepubliceerd. Dat moet voldoende zijn voor automatisering.

SanderNijhof commented 1 month ago

Graag jullie feedback over de voorgestelde oplossing.

Gezien de onduidelijke omvang van nog uit te werken bedrijfstoestanden en bewerkingen, zou mijn voorstel zijn om minimale wijzigingen aan de database te doen, totdat er meer duidelijkheid is over wat en hoe e.e.a. het beste te implementeren is.

Mijn voorstel is om vanuit de database per object alleen te verwijzen naar een picklist, zijnde bijvoorbeeld een .txt of een .csv bestand met daarin de regels voor en inhoud van de picklist. De .csv bestanden zijn makkelijker te testen en snel aan te passen als dat nodig blijkt. Als eenduidig de inhoud van de picklisten en de inhoud van het veld BEWERKING in combinatie met de bijbehorende objecten en status voor iedereen goed werkt, dan kan ook duidelijker gekeken worden of en hoe e.e.a. definitief in de database opgenomen kan worden.

Dit lijkt mij voor de software leveranciers ook het meest praktische, maar dat kan ik ook helemaal verkeerd inschatten :monocle_face:.

ElisabethKloren commented 4 weeks ago

trouwens gebruiken we beter leesbare attibuutvelden in de linked data publicatie, de extra informatie-attributen worden: (edit had per ongeluk R ipv V aangemaakt)

a. B color RESERVE b. B linetype RESERVE c. B lineweight RESERVE d. N color RESERVE e. N linetype RESERVE f. N lineweight RESERVE g. T color RESERVE h. T linetype RESERVE i. T lineweight RESERVE j. V color RESERVE k. V linetype RESERVE l. V lineweight RESERVE m. B color VERLATEN n. B linetype VERLATEN o. B lineweight VERLATEN p. N color VERLATEN q. N linetype VERLATEN r. N lineweight VERLATEN s. T color VERLATEN t. T linetype VERLATEN u. T lineweight VERLATEN v. V color VERLATEN w. V linetype VERLATEN x. V lineweight VERLATEN

SanderNijhof commented 3 weeks ago

trouwens gebruiken we beter leesbare attibuutvelden in de linked data publicatie, de extra informatie-attributen worden:

Oh ja? Dat strookt niet met wat besproken is over variabele terminologie per hoofdgroep. Volgens mij moet er nog een methodiek uitgewerkt worden. Ik begrijp daarom niet hoe bovenstaande al in de linked data kan worden opgenomen. Dat kan helemaal nog niet. Kun je me uitleggen wat de impact hiervan is?

ElisabethKloren commented 2 weeks ago

trouwens gebruiken we beter leesbare attibuutvelden in de linked data publicatie, de extra informatie-attributen worden:

Oh ja? Dat strookt niet met wat besproken is over variabele terminologie per hoofdgroep. Volgens mij moet er nog een methodiek uitgewerkt worden. Ik begrijp daarom niet hoe bovenstaande al in de linked data kan worden opgenomen. Dat kan helemaal nog niet. Kun je me uitleggen wat de impact hiervan is?

als er andere bedrijfstoestanden bijkomen dan moet hiervoor eigen attribuutvelden worden opgenomen, dit zijn de attribuutvelden voor de bedrijfstoestanden van netbeheer.