Syfotjenester
Dette prosjektet inneholder spesifikasjoner for de tjenestene som SYFO tilbyr internt. De er maskinlesbare i form av WSDL/XSD/JSON-filer, og disse brukes som utgangspunkt for å generere Javakode. Denne autogenererte koden blir kompilert og siden publisert, slik at konsumenter kan bruke dem til å kommunisere med tjenestene.
Bygging
Java 8 trenges pga javax.xml.bind.*
bygg virker ikke lenger med Java versjon >= 9.
https://stackoverflow.com/questions/43574426/how-to-resolve-java-lang-noclassdeffounderror-javax-xml-bind-jaxbexception-in-j
mvn clean install
Oppdatering av WSDL fra NHN
WSDLer fra NHN må først konverteres til noe som kan brukes av NAV. Disse NAV- versjonene av WSDLene hentes fra pakker generert av Team Mellomvare. WSDLene må hentes ut fra maven-pakker og legges inn manuelt her i syfotjenester. Pakkene ligger på intern NAV Nexus her: http://maven.adeo.no/
- no.nav.tjenester:ekstern-helse-fastlegeinformasjon-tjenestespesifikasjon
- no.nav.tjenester:ekstern-helse-adresseregisteret-tjenestespesifikasjon
For å generere disse nye interne NAV-WSDLene ta kontakt med Team Mellomvare. Nye WSDLer fra NHN ligger her:
- https://register-at.test.nhn.no/docs/arkitektur/register/flr.html
- https://register-at.test.nhn.no/docs/arkitektur/register/ar.html
NHN har fire hovedleveranser i året, WSDLene oppdateres med endringer relevante for NAV på omtrent en av disse fire, altså en gang i året. Følg med på #ext-nav-grunndata og https://www.nhn.no/samhandlingsplattform/grunndata/leveranseplaner-for-grunndata for å få oppdateringer på når endringene er i testmiljø og når de skal prodsettes.
Gjøre endringer, release
For å endre spesifikasjoner, lag en branch. Kjør bygget lokalt, da vil du
få siste endringer med 0-SNAPSHOT
som versjon. Test med en konsument at
endringene fungerer (sett versjon av tjenestespesifikasjoner til 0-SNAPSHOT
i konsumenten.)
Når testingen er ferdig, send en pull request til dette repoet.
Hver branch og pull request vil gå gjennom et CI-bygg.
Etter at en pull request er merget til master-branchen, vil
CI automatisk gjøre en release av hele repoet til Maven Central.
Alle modulene i dette repoet får samme versjonsnummer.
Versjonsnummeret til releasen blir 1.YYYY.MM.DD-HH-MM-commithash
.