Introduktion
Denne introduktion beskriver den samling af forretningstransaktioner, der vil blive implementeret i DataHub 3.0, og som indgår i specifikationerne af forretningsprocesserne for det danske elmarked.
Forretningstransaktionerne benævnes også EDI-transaktioner eller RSM’er.
EDI står for Electronic Data Interchange, og dækker over den tekniske standard for dataudveksling, mens RSM står for Requirements Specification Mapping.
Den samlede specifikation af håndteringen af forretningstransaktionerne kaldes i daglig tale også RSM-guiden.
Formål og målgruppe
RSM-guiden har til formål at klarlægge og beskrive forretningstransaktionerne samt indholdet af data for de beskrevne forretningsprocesser. RSM-guidens målgruppe er alle aktører og disses systemleverandører.
Forretningstransaktioner
En forretningstransaktion er uafhængig af andre forretningstransaktioner, men kan sammen med andre transaktioner indgå i en eller flere forretningsprocesser.
En forretningstransaktion beskriver udvekslingen af meddelelser mellem to aktørers it-systemer. Yderligere specificeres en del af den interne håndtering i en aktørs it-system.
Ved modtagelse af en meddelelse skal det valideres om den er i overensstemmelse med de forretningsregler der er angivet i forretningsprocesserne for det danske elmarked, hvorefter svar afsendes.
Hver meddelelse indeholder en liste af attributter, som vises i form af et klassediagram og i enkelte tilfælde anvendes en dependency matrix. En dependency matrix anvendes, hvis det er muligt at sende en meddelelse med forskellige attributter alt efter formål.
RSM-guiden beskriver således alle forretningstransaktioner, der indgår i forretningsprocesserne for det danske elmarked.
Beskrivelse af meddelelsesstruktur
Den strukturelle definition af de enkelte meddelelser er dels beskrevet tekstuelt i RSM-guiden, dels specificeret ved hjælp af en række XML-skemaer, som kan hentes på Energinets hjemmeside.
På grund af tekniske begrænsninger i syntaksen for XML/JSON-skemaer er der situationer, hvor attributter vil være angivet som valgfri, på trods af at de logisk vil være krævet et sted i meddelelsen og valgfri eller endog ikke tilladt et andet sted. Dette fremkommer når samme datatype genanvendes i samme meddelelse, men i lidt forskellig kontekst. I disse tilfælde vil afhængigheden for den enkelte instans af en attribut som beskrevet i RSM-guiden være den gældende og den som DataHub validerer efter.
Læsevejledning
De enkelte RSM’er er beskrevet ud fra den generelle IEC standard, hvorfor der vil være en række attributter, som ikke bruges i Danmark. Attributter der ikke bruges, vil ikke have noget navn i kolonnen ”Danish attribute” og ofte vil der også være en bemærkning i kolonnen ”Remark” som viser at der ikke bruges i Danmark.
Meddelelsesudveksling
Alle beskeder, der kommunikeres via webinterfacet i DataHub, er XML/JSON beskeder og består af:
En MessageHeader, som indeholder informationer, der bruges til styring af den bagvedliggende forretningsproces. Det vil sige identifikation af den enkelte besked og dens indhold og identifikation af den forretningsproces, beskeden skal behandles af.
En eller flere Payloads (forretningstransaktioner), som hver indeholder en forretningsbesked.
Validering mod XML-skema
XML-skemaer[1] definerer indhold, struktur og typer for XML-meddelelser. Med en XSD definition er det muligt at:
Beskrive indholdet i XML-meddelelsen
Validere XML-meddelelsen
Definere datafacetter (restriktioner for dataindhold)
Definere datamønstre (dataformater)
DataHub validerer alle XML-meddelelser mod det tilhørende skema. Valideringen sker i samme webservice session, og afsender bliver øjeblikkeligt orienteret om resultatet.
Det er til enhver tid Energinet, der fastlægger, hvilket XML-skema der skal anvendes for en given XML-meddelelse.
Meddelelser indsendt i JSON format, vil blive konverteret til XML.
[1] XML Schema Definition (XSD)