B 1.1 PULS forretningsobjekter beskrivelse

B1.1 Forretningsobjekter beskrivelse.
B1.2 Forretningsobjekters relationer.
B1.3 Forretningsspørgsmål.
Dato
2015-02-06
2015-03-04
Rev. af
SMu
SMu
Version
0.1
0.2
Miljøportalsekretariatet
DMP j.nr.
Ref.: XXXXX
Den 00.
XXXX 0000
Revision
Dokument oprettet
Opdateret figurer.
Indholdsfortegnelse
Service URLs: .................................................................................................................................... 1
B1.1 Forretningsobjekter ............................................................................................................. 2
B1.2 Forretningsobjekters relationer....................................................................................... 9
B1.3 Forretningsspørgsmål ....................................................................................................... 10
Service URLs:
Nedenstående services er udstillet i version 1.0.1; fælles for dem er stien:
http://services.puls.miljoeportal.dk/miljoeportal.surfacewater.pointsources.1.0.1/
 Beregnng
 Pointsample
 Stancode
 Stanlab
 Tilsyn
 Udtraek
Nedenstående services er udstillet i version 1.1.0; fælles for dem er stien:
http://services.puls.miljoeportal.dk/miljoeportal.surfacewater.pointsources.1.1.0/
 Produktattribut
 Punktkilde
 Retsgrundlag
 Stamdata
 Aarsindberetning
B1.1 Forretningsobjekter
Services, der tilgår forretningsobjekterne er nævnt herunder. Se særskilt dokumentation for hver
Service for yderligere information.
Forretningsobjekt
Beskrivelse
Beregning
Metoder:
BestilBeregning
FindBeregning
GemBeregning
DeaktiverBeregning
LaasBeregning
LaasOpBeregning
HentBeregningsresultat
Forretningsobjekter:
Forretningsobjekt
Beskrivelse
Pointsample
Metoder:
GemPointsample
FindPointsample
DeaktiverPointsample
Forretningsobjekter:
Produktattribut
Metoder:
FindDatakvalitetstype
FindProduktDatakvalitet
FindProduktattributtype
FindProduktProduktattribut
GemProduktProduktattribut
GemProduktDatakvalitet
DeaktiverProduktProduktattribut
Forretningsobjekter:
KvalitetType
1
Datakvalitet
Produkt
Beregningsresultat
Forretningsobjekt
Beskrivelse
Punktkilde
Metoder:
GemPunktkilde
FindPunktkilde
DeaktiverPunktkilde
Forretningsobjekter:
Produktionsenhed
Ejer
*
Retsgrundlag
Punktkilde
(Observationssted)
Geometri
1
Recipient
AnvendtParameter
*
0..1
Status
Målested
Parameterkrav
PunktkildeStatus
Aktør
Industri
SpredtBebyggelse
IndustriStatus
SpredtBebyggelseStatus
Parameter
*
Årsindberetning
Dambrug
1
Aktivitet
Prøvetagning
Feltmåling
Tilsyn
Analyse
1..*
DambrugStatus
Produkt
Renseanlæg
RBU
Retsgrundlag
RenseanlægStatus
RBUStatus
Hovedopland
Undersøgelsesformål
Kloakopland
Metoder:
FindRetsgrundlag
GemRetsgrundlag
Forretningsobjekter:
Retsgrundlag
Se figur herover, hvor retsgrundlag indgår i sammenhæng med
punktkilde.
Forretningsobjekt
Beskrivelse
Stamdata
Metoder:
GemEjer
FindEjer
GemHovedopland
FindHovedopland
GemKloakopland
FindKloakopland
DeaktiverKloakopland
GemProduktionsenhed
FindProduktionsenhed
GemRecipient
FindRecipient
GemRegnserie
FindRegnserie
GemSeparatkloakeretEnhedstal
FindSeparatkloakeretEnhedstal
GemFaelleskloakeretEnhedstal
FindFaelleskloakeretEnhedstal
GemKonfigurationsparameter
FindKonfigurationsparameter
Forretningsobjekter:
Ejer
Hovedopland
Kloakopland
Produktionsenhed
Recipient
Regnserie
SeparatkloakeretEnhedstal
FaelleskloakeretEnhedstal
Konfigurationsparameter
Stancode
Metoder:
OpdaterLister
Forretningsobjekter:
Stancode-lister
Forretningsobjekt
Beskrivelse
Stanlab
Metoder:
SaveResults
FindResults
DeactivateResults
Forretningsobjekter:
Tilsyn
Metoder:
GemTilsyn
FindTilsyn
DeaktiverTilsyn
Forretningsobjekter:
Forretningsobjekt
Beskrivelse
Udtraek
Metoder:
HentUdtraek
GemUdvalgsliste
FindUdvalgsliste
DeaktiverUdvalgsliste
Forretningsobjekter:
Udtraek
Udtræk er i øjeblikket begrænset til typen
”sedublettervedlaasning”.
Udvalgsliste
En udvalgsliste består af identifikator og et navn.
Et Punktkildeudvalg består, foruden identifikator, af et antal
referencer til hhv. udvalgsliste og punktkilde. En udvalgsliste
med tilhørende punktkildeudvalg kan fx bruges i forbindelse
med udvælgelse af punktkilder til rapporter.
Forretningsobjekt
Beskrivelse
Aarsindberetning Metoder:
GemAarsindberetning
FindAarsindberetning
DeaktiverAarsindberetning
Forretningsobjekter:
Ændring af allerede oprettet data
Der kan være flere grunde til at man ønsker at ændre i allerede
oprettede data:
•
Tilføjelse af Foder eller Hjælpestof etc.
•
Ændring af tekst eller værdier.
•
Sletning af Årsindberetning, Foder, Hjælpestof (ikke
medtaget her).
For at ændre, skal brugeren angive identifikator for den del af
data han/hun vil ændre. Hvis en identifikator for et givet felt er
udfyldt, vil systemet undersøge om en post med denne
identifikator findes; hvis den findes, træder reglerne gengivet
herunder i kraft.
Ændring i Årsindberetning
Der sker følgende:
 Årsindberetning bliver sat til ”inaktiv”.
 Der oprettes en ny aktiv Årsindberetning med tilhørende
Foder og Hjælpestof(fer) ud fra data i request.
Den nye Årsindberetning erstatter altså den gamle; brugeren
skal derfor angive identifikatoren for den Årsindberetning, der
skal erstattes. Bemærk, at erstatning af Årsindberetning kun vil
lykkes, hvis Årsindberetningen der skal erstattes ikke har
aktive Foder eller Hjælpestof(fer) tilknyttet.
Ændring af Foder og Hjælpestof
Disse er resultat af en aktivitet på niveau under aktiviteter, og
fællesbetegnelsen for dem er ”Produkter”. Et produkt bliver
erstattet på samme måde som en aktivitet:
•
Det produkt, som skal erstattes bliver sat til
”inaktiv”.
•
Der oprettes et nyt aktivt produkt ud fra data i
request.
Set i forhold til Årsindberetning er produkter et niveau under
disse. Men produkter kan også være brugt i andre
sammenhænge, og hvis det er tilfældet kan man ikke erstatte
et produkt.
Det nye produkt erstatter det gamle; brugeren skal derfor
angive identifikatoren for det produkt, der skal erstattes.
B1.2 Forretningsobjekters
relationer
Se en overordnet gengivelse af forretningsobjekternes relationer herunder. Se dokumentation for de
enkelte forretningsobjekter/services under særskilt dokumentation.
De forskellige metoder indeholder en række felter som henviser til entiteter i andre services og
metoder.
Af nedenstående figur fremgår det, hvilke henvisninger der går på tværs af services.
Udtraek
Beregning
Stancode
PunktkildeIdentifikator
PunktkildeIdentifikator
RBUStatusReference
EjerReference
ProduktionsenhedReference
Stamdata
MaalestedReference
Punktkilde
Pointsample
RecipientReference
NormalAarRegnserieReference
KonkretAarRegnserieReference
Stanlab
SampleReference
PunktkildeReference
PunktkildeReference
MaalestedReference
MaalestedReference
ProduktIdentifikator
Retsgrundlag
Tilsyn
Aarsindberetning
Produktattribut
ProduktIdentifikator
Service-interne referencer og strukturer fremgår ikke af ovenstående.
ProduktIdentifikator
B1.3 Forretningsspørgsmål
Herunder er gengivet nogle af de spørgsmål og svar, der har været.
Forretnings- Kategori
spørgsmål
FSP 1
Hvilke web services
skal anvendes ved
godkendelse af
analyseresultater og
feltmålingsresultater
?
FSP 2
Findes der
dokumentation af de
enkelte properties?
FindProduktDataKval
itetRequest.Aktivitet
Identifikator = new
string[0];
FSP 3
Beskrivelse
Til godkendelse bruges
Produktattribut-servicen,
metoderne vedr. datakvalitet.
Aktivitetsbegrebet dækker
over bl.a. prøvetagninger,
analyser og feltmålinger.
Produktbegrebet dækker
over bl.a. prøver,
analyseresultater og
måleresultater.
FindProduktDataKval Feltet produkttype dækker i
itetRequest.Produktt relation til ovenstående over
ype = "";
”Maaleresultat” eller
”Analyseresultat”.
FindProduktDataKval
itetRequest.ProduktI
dentifikator = new
string[0];
Adgang til testDen kan findes her:
klient til PULS
https://faq.miljoeportal.dk/vi
ewtopic.php?f=40&t=247
Prioritet
Forretnings- Kategori
spørgsmål
FSP 4
Oprettelse af nye
brugere og tildeling
af roller i PULS
Beskrivelse
For at få adgang til PULS,
skal du have oprettet en
bruger i Miljøportalens
brugerstyring. Du skal
kontakte din lokale it
administrator for at blive
oprettet som bruger, og for
at få tildelt roller.
Der er udarbejdet en
vejledning til oprettelse af
nye brugere af PULS. Her
står angivet, hvilken
grundrolle du skal have for at
tilgå PULS enten som
kommunal medarbejder, eller
ansat i Naturstyrelsen (NST).
Vejledningen hedder
'Oprettelse af nye brugere i
PULS' og kan findes her:
http://internet.miljoeportal.d
k/hjaelp/Vejledninger/Sider/
Overfladevand.aspx
Prioritet
Forretnings- Kategori
spørgsmål
FSP 5
Adgang til
certifikater til PULS
webservices
Beskrivelse
Se certifikat-oversigt i ””. For
udlevering af certifikat:
Kontakt DMP.
Desuden kan certifikater for
Goddadys vedkommende kan
de findes her:
https://certs.godaddy.com/a
nonymous/repository.pki
og certifikater for TDC’s
vedkommende kan findes
her:
https://www.certifikat.dk/da/
download/rodcertifikat.html
Se desuden:
https://faq.miljoeportal.dk/vi
ewtopic.php?f=1&t=14
Applikationer, der tilgår Puls
En applikation, der tilgår Puls
Webservicen, skal bruge
STS-encryption certifikatet;
der kan være indlejret som
en base-64-streng.
Prioritet
Forretnings- Kategori
spørgsmål
FSP 6
Jeg har nogle få
udløb, jeg skal have
nedlagt. Hvordan
gøres det?
Beskrivelse
PULS understøtter ikke sletning
af data, fordi det er et krav at
historiske data, herunder
migreringer, er tilgængelige.
Danmarks Miljøportal kan derfor
ikke tilbyde generel sletning af
data i PULS.
PULS understøtter i slutningen
af 2013 deaktivering af bl.a. en
RBU. Denne deaktivering har
alene til formål, at man kan
fjerne umiddelbare
fejloprettelser i
brugergrænsefladen.
Deaktivering af RBU med
underliggende registreringer på
f.eks. et målested vil fortsat
ikke være muligt.
Forbedring af datakvaliteten på
migrerede RBUer, målesteder
skal ske ved at nye
indberetninger opdaterer
eksisterende værdier fra
migreringen. I
brugergrænsefladen sker det
ved overskrivning, mens det i
forhold til indberetning med
trediepartsprodukter
(Orbicon/OPUS og
EnviDan/GIDAS) er et krav, at
overførte data kan mappes op
mod eksisterende RBUer,
målesteder mm. i PULS.
Det påhviler altså 3. parts
leverandøren, at nye data
overføres med ”nøgler” til
eksisterende registreringer i
PULS (med mindre der er tale
om tilkomne RBUer og/eller
målesteder). Af samme grund
tilbyder PULS, at
trediepartsleverandøren kan
hente de fornødne nøgler fra
PULS via en WEB-service.
Prioritet
Forretnings- Kategori
spørgsmål
FSP 7
Yder DMP support
hvis PULS tilgås via
egen applikation?
Beskrivelse
Nej, Danmarks Miljøportal
(DMP) yder support til de
brugere, der benytter
brugergrænsefladen på PULS.
DMP yder således ikke
support til brugere der tilgår
PULS via egne applikationer
som eks. OPUS eller GIDAS.
Derudover yder DMP support
til leverandører, der har
problemer med at integrere
til DMP’s løsninger herunder
webservices udstillet af PULS.
FSP
FSP
FSP
FSP
FSP
FSP
FSP
FSP
8
9
10
11
12
13
14
15
Prioritet