Microsoft BizTalk og WEBservices Webservices Grunndata (XML) Microsoft BizTalk og WEBservices
Hva er Webservices ? Web Service er en teknologi som gjør det enkelt å utveksle data mellom ulike datasystemer Brukes av Byggtjeneste for å tilgjengeliggjøre produktbilder og produktdokumentasjon fra NOBB til ulike dataløsninger Nyhet! Kan nå brukes til automatisk overføring av Grunndata mellom NOBB og kundens eget datasystem 2
Realisering Løsningen realiseres ved å benytte følgende verktøy: BizTalk for prosessering av meldinger WebServices for grensesnitt mot BizTalk WebServices for grensesnitt mot partnere XML Schemas for definering av meldingsformat
To tjenester eksport- og import-webservices
Eksport/import webservices Eksport: Ett sett av tjenester som kan benyttes for å hente ut [all] informasjon fra Byggtjenestes varedatabase Kan benyttes av både brukere og vareeiere Import: Ett sett av tjenester som kan benyttes for å levere et gitt sett av informasjon inn til Byggtjenestes varedatabase Benyttes av vareeiere
Eksport Web Services Batch-meldinger Fulle meldinger Varer Moduler Priser Fulle meldinger Modulstandarder Produsentregister Stikkordsregister Enhetsregister Deltagere Varegruppestruktur 6 6
Skeleton applications ReceiveService Webservice for mottak av batcher fra Byggtjeneste Skeleton webserviceapplikasjon i .net 2.0 C# Inneholder kode for mottak av meldinger Lagrer disse ned til disk Sender ny request melding om nødvendig Binær kode kan benyttes direkte Source code medfølger Kopiering og endring tillatt og ønskelig Kjøres under IIS
Oversikt over tjenestene
Access til Services’ene Eksportservices Finnes på adressen:http:// Grunndata.byggtjeneste.no/Eksportservice/eksportservice.asmx Krever login Dere får login ved henvendelse til Byggtjeneste
Access til Services’ene forts. Importservices Finnes på adressen: http:// Grunndata.byggtjeneste.no/Importservice/Importservice.asmx Krever login Dere får login ved henvendelse til Byggtjeneste
Tilgjengelig materiale Sendes kunder som er interresert: Eksportservice i to varianter Beskrivelse av tjenestene i Power Point Schemas ReceiveService GUI basert: StartEksport GUI Winform teknologi CLI basert: StartEksportCLI Kan f.eks. startes fra windows scheduler
Forutsetninger for levert software Kan kjøre på følgende ”servere”: Windows XP Windows 2000 Windows 2003 Krever .net 2.0 Framework
Meldingsflyt, arkitektur
To typer overføringer Batchorienterte Fulle tjenester For å kunne dele opp større meldinger. Normal batchstørrelse ca 10MB, maks 64MB Kan hentes ut basert på dato (delta-meldinger) Raskt endrende informasjon Fulle tjenester Informasjonen er relativt liten Dvs < 64MB Vil kun overføres som fulle sett Forholdsvis stabil informasjon
Overføre endringer fra NOBB til partnere Overføring av data som både delta og som full Bilder og dokumentasjon er ikke klar
Overføre registre fra NOBB til partnere Overføring av data bare som full overføring 16
XML Schema design
Varegruppestruktur, grafisk
Varegruppestruktur, xml 19
Deltager
Deltager - Adresse
Deltager - Kontaktperson
Modul
Vare Innehold (mer info en Integ.dat) Vare og modulnumre Varetekster TUN/FINFO lister Dokumentasjonsindikatorer Godkjenningsstatus Erstatningsinfo Beskrivelsestekst på vare Miljøavgifter NRF data Pakningsinformasjon
Vare
Vare - Pakning Deltakernummeret på pakningen viser hvilken vareeier som har registrert info på en pakning på en vare i NOBB En pakning kan kun opprettes av vareeieren På enkelte felter kan en annen vareeier registrere sin egen variant av en eksisterende pakning. Dersom en annen vareeier har opprettet sin egen variant av en pakning vil denne eksporteres ut i 2 varianter med all pakningsinfo på hver av pakningene. Ved all eksport vil alltid all info som er knyttet til varen eksporters, herunder all pakningsinformasjon. Se eksempelfiler
Pris Selvstendig schema, for bruk også ved innrapportering av priser Inneholder Priser (innkjøp, kost, veiledende) Gyldighetsdatoer Mottager/avsender
Pris
Status
Hvordan komme i gang…
Tilgjengelig dokumentasjon Produktinfo WebService Integrasjonsbeskrivelse Detaljert beskrivelse http://produktinfo.byggtjeneste.no Grunndata Webservice Beskrivelse i Power Point XML Schemas ReceiveService StartEksportService http://grunndata.byggtjeneste.no