Guide for utfylling av endringsmeldinger til kommunikasjonsstandarden

Transkript

1 Transaksjonsstandard for virkesomsetningen i Norge Guide for utfylling av endringsmeldinger til kommunikasjonsstandarden Versjon 0.1 Revisjonshistorie: Versjon Beskrivelse Dato 0.1 Første utkast

2 Innhold 1 INNLEDNING 3 2 UTFYLLING AV ENDRINGSMELDING Endringsmelding ID Overordnet beskrivelse Foreslått endring 4 3 BEHANDLING Sekretariatets behandling Faggruppens behandling Styringsgruppens behandling 5 4 EKSEMPLER PÅ ENDRINGSMELDINGER Legge inn et nytt element i en melding 6

3 1 Innledning Dette dokumentet beskriver skjemaet for endringsmeldinger og hvordan de skal fylles ut. Den brukeren av standarden som har behov for en endring, skal sende endringsforslag basert på skjema på websiden, til sekretariatet. En ny melding er også å betrakte som en endringsmelding. 2 Utfylling av endringsmelding Skjemaet består av flere avsnitt. 2.1 Endringsmelding ID Alle endringsmeldinger må kunne unikt identifiseres. I tilefelle det sendes inn flere meldinger som henviser til hverandre, må ID tildeles av utsteder. ID tildeles slik: Der: <Org.forkortelse>-YYYYMMDD-nnn <Org.forkortelse> identifiseres innsenderorganisasjon. Bør holdes på et minimumsnivå. YYYYMMDD er dato nnn er fortløpende nummerering fra innsender 2.2 Overordnet beskrivelse En kort beskrivelse av endringen. Eksempler kan være Øke plass for beskrivelse av vei eller Nytt felt for å sende veibredde. Teksten brukes i oversikter/lister. Side 3 av 6

4 Under relaterte meldinger oppgis om denne endringen er relatert til andre foreslåte endringer. 2.3 Foreslått endring Her skal endringen beskrives i detalj. Påvirker Type endring Endringsbeskrivelse Begrunnelse Påvirker meldinger Detaljert beskrivelse og kommentarer Angi om dette gjelder et element, et attributt eller dokumentasjonen. Merk det/de aktuelle alternativene med fet rød skrift. Angi om det er en ny opplysning, endring av eksisterende eller sletting. Merk det/de aktuelle alternativene med fet rød skrift. En mer detaljert beskrivelse i klartekst. Hvorfor endringen ønskes. Her oppgis hvilke meldinger om påvirkes av endringen. I noen tilfeller kan det forslås endringer i elementer som er globale. Globale elementer er Sender, Mottager osv. I slike tilfeller oppgis Globalt element for Relaterte meldinger. Her skal det settes inn spesifikasjon av endringen. Spesifikasjonen bør inneholde forslag til elementnavn, datatyper og størrelser. Skjermdump av schema før settes inn. Eventuelle behandlingsregler skal også beskrives. Dersom endringen inkludere en liste over alternative verdier (enumeration list), skal elementene i listen oppgis (navn + beskrivelse). Eksempel: 3 Behandling Endringsmeldingen sendes sekretariatet. Sekretariatet bekrefter mottagelsen. Side 4 av 6

5 3.1 Sekretariatets behandling Sekretariatet mottar, arkiverer og sørger for at alle endringsmeldinger blir behandlet. Sekretariatet kan gi kommentarer og anbefalinger til de saksbehandlere i prosessen. Det kan være at en endring bør løses på en annen måte enn det som er foreslått. Sekretariatet skal påse at retningslinjene i standarden opprettholdes. Sekretariatet kompletterer meldingen dersom det er behov for det. 3.2 Faggruppens behandling Faggrupper kan bli bedt om å gi en anbefaling. Faggrupper kan etableres ved behov og skal ivareta det faglige innenfor sitt område. Eksempler på faggrupper kan være transport, måling osv. Styringsgruppen er ansvarlig for faggruppene. 3.3 Styringsgruppens behandling Styringsgruppen har beslutningsmyndighet. De kan godkjenne eller godkjenne med endring. I begge disse tilfellene vil det bli publisert en oppdatert versjon av standarden på web-siden. Innsender mottar tilbakemeling. Dersom en endringsmelding blir avslått, gis tilbakemelding til innsender og meldingen arkiveres. Et alternativ kan være å vente til neste versjon. Endringen er i prinsippet godkjent, men det vil ikke bli publisert en oppdatert versjon. Side 5 av 6

6 4 Eksempler på endringsmeldinger 4.1 Legge inn et nytt element i en melding I dette eksemplet ønsker innsender å legge inn et element for å kunne sende med ID for en stokk i måledokumentet (for eksempel RFID nummer som er festet i stokken). Side 6 av 6