Produktinfo WebService. integrasjonsbeskrivelse



Like dokumenter
Brukermanual til Domenia Norges adminløsning

Oblig 5 Webutvikling. Av Thomas Gitlevaag

Manual for innlegging av standard sideinnhold og nyheter via «backend»

PUBLISERING PÅ

Side 1. Sniggabo CMS brukermanual rev. 2

P L A N I A 8 S Y S T E M K R A V PLANIA 8 SYSTEM KRAV. Plania 8 Systemkrav.docx av 8

Dette er en demonstrasjonsside som vi skal bruke for å se litt nærmere på HTTP protokollen. Eksemplet vil også illustrere et par ting i PHP.

Administrering av SafariSøk

Brukerdokumentasjon for LabOra portal - forfattere

Lage klubbens webside i Rotary med verktøyet Webwiz 2.0

file:///c:/users/michaelp/sites/dkdm/dw6/dreamweaver6.html

InfoRed Publisering. - produktbeskrivelse. TalkPool WebServices Postboks Åneby

Brukermanual. Itpays W3 Publish. Sette opp, logge inn og komme i gang. Redigert den 23. mai

en hjemmeside Lesson Introduksjon Du kjenner en del HTML tagger, så nå er det på tide å lage din første hjemmeside! La oss begynne med en gang.

Innføring i bruk av CGI4VB

Publiseringsveiledning for

EndNote referansehåndteringsprogram. HiVe biblioteket

BAAN IVc. BAAN Data Navigator - Brukerhåndbok

Importere referanser fra databaser

Javascript. Mer om layout

JSP - 2. Fra sist. Hvordan fungerer web? Tjenerside script HTML. Installasjon av Web-tjener Et enkelt JSP-script. Ønsker dynamiske nettsider:

Publiseringsløsning for internettsider

Eksamen i Internetteknologi Fagkode: IVA1379

Gruppe prosjekt del 3. INFO134 Klientprogrammering Vår 2017 Kandidatnummer: 304, 298

Innhold. Epostprogrammer og webmail.

Brukerveiledning for For å opprette en ny bruker vennligst send en epost til

Oppdatering av eget innhold på venteromsskjermer BRUKERVEILEDNING

Brukerdokumentasjon. Webservices og webklient for kodeverk/ kodeverdi verifisering

NORSKE RØRGROSSISTERS FORENING. NRF Produktdatabase 2.0

ff Brukermanual ebladadmin Pro

Til IT-ansvarlige på skolen

MedAxess WinMed Brukermanual

BORRENYTT. Dette er en innføringsguide om hvordan man kan legge til nye poster, og hvordan disse bør settes opp.

Brukerveiledning for programmet HHR Animalia

Demoversjon. Installasjon Uni Økonomi V3. - økonomisystemer fra start til børs

Remote Desktop Services

Web fundamentals. Web design. Frontend vs. Backend Webdesign 17. januar Monica Strand

KOM I GANG MED WORDPRESS En enkel guide for å hjelpe deg gjennom det grunnleggende i Wordpress

Innføring i bruk av CGI4VB

- reklamebannere mobil og tablet

I denne oppgaven blir du introdusert for programmeringsspråket JavaScript. Du skal gjøre den klassiske oppgaven Hei verden, med en katt.

Hvordan å lage og publisere ditt personlige visittkort

Pålogging. Hovedsiden på Bilde 1

Det du skal gjøre i denne oppgava er først å sette opp bakgrunnen til spillet og så rett og slett å få firkanter til å falle over skjermen.

Tetris. Introduksjon. Skrevet av: Kine Gjerstad Eide. Lag starten på ditt eget tetris spill!

Antall oppgaver: 6. Alle trykte og skrevne hjelpemidler

CASCADING STYLESHEETS (CSS)

the web Introduksjon Lesson

Brukerveiledning NOBB.no

Brukerveiledning WordPress. Innlogging:

Start et nytt Scratch-prosjekt. Slett kattefiguren, for eksempel ved å høyreklikke på den og velge slett.

Publisere på nvfnorden.org

KOMME I GANG 2. Logge på 2. I redigeringsvinduet 3 OVERSIKT OVER KNAPPENE SOM LIGGER ØVERST I REDIGERINGSVINDUET 5

Brukermanual for nettpublisering. frivilligsentral.no

Labquality/NKK ELEKTRONISK RESULTATSKJEMA VIA INTERNET. Åpning av skjemaet. Logg inn på Participant services. Velg resultatskjemaet

Her prøver vi å gi en enkel introduksjon til Venstres publiseringssystem for nettsider (Venstre Publish):

HTML-del. 1. <!-- ikke slett min kode, vær så snill --> er a) en HTML stil-tag b) en CSS stil-tag c) en HTML kommentar-tag d) en CSS kommentar-tag

Kom i gang med E-Site - Med E-Site er det enkelt og trygt å redigere dine websider

Testrapport. Aker Surveillance. Gruppe 26. Hovedprosjekt ved Høgskolen i Oslo og Akershus. Oslo, Public 2013 Aker Solutions Page 1 of 5

2 Om statiske variable/konstanter og statiske metoder.

Brukermanual - Joomla. Kopiering av materiale fra denne Bonefish manualen for bruk annet sted er ikke tillatt uten avtale 2010 Bonefish.

Kursdokumentasjon for Dreamweaver

Importere referanser fra databaser

BRUK AV TEKSTEDITOREN

Kom i gang med E-Site

Innstillinger. Endre Personalia

Start et nytt Scratch-prosjekt. Slett kattefiguren, for eksempel ved å høyreklikke på den og velge slett.

QuickGuide Oppdateres fortløpende ved nye funksjoner

Brukerveiledning for Vesuv

OBLIG 1 - WEBUTVIKLING

Brukermanual for Quizbuilder

Hvordan legge til et dokument/bilde på en eksisterende side:

Del 1: Overgang fra gammel hjemmeside til ny hjemmeside

BRUKERMANUAL FOR NETTINTRO CMS Dette dokumentet er skrevet for Nettintro CMS versjon 1.9.0, og kan derfor avvike noe fra nåværende versjon.

Vedlikeholde nettstedet i Joomla 2.5 +

ebudbok Elektronisk budbok på PDA Registrering av gangrekkefølge på web

Dobbelklikk på program-ikonet!

Veiledning Claw 2 CMS Innhold

som blanker skjermen (clear screen). Du får en oversikt over alle kommandoene ved å skrive,

Huldt & Lillevik Ansattportal. - en tilleggsmodul til Huldt & Lillevik Lønn. Teknisk beskrivelse

Halloweenimasjon Introduksjon Scratch PDF

Innhold RDP... 2 Oppkobling Kirkedata... 2 Flere brukerpålogginger til Kirkedata... 8

System Dokumentasjon. Team2. Høgskolen i Sørøst-Norge Fakultet for teknologi, naturvitenskap og maritime fag Institutt for elektro, IT og kybernetikk

HTML5. Skjemaer på nettsider. Skjemaer med. Informasjonsteknologi 1 og 2. Gløer Olav Langslet Sandvika VGS

Brukerdokumentasjon Citrix og Multiframe InnsIKT 2.0. Versjon 1.5. Innholdsfortegnelse

UiS-IKT Kompetanse Word Adresselister og fletting

Logica AS Tlf: Brukerdokumentasjon Fjernaksess InnsIKT 2.0 Versjon 1.3. Godkjennelse. Date. Forfatter: Logica. Leder: <Manager> Date

Memoz brukerveiledning

Intentor Helpdesk - Installasjon Step #3: Microsoft Reporting Services

Artist webside. Gruppe medlemmer Joakim Kartveit. Oppdragsgiver Tetriz Event & Management. Frode Mathiesen. Gry Anita Nilsen.

EN PRAKTISK INNFØRING I KRYPTERT E-POST FRA UDI

Avansert tekstmodul Eksempel Administrasjon Bilde Eksempel på en bildemodul Eksempel på en bildemodul lagt til uten

Brukermanual for drift og installasjon av Pasienttransport, elektronisk rekvisisjon for. ProMed. for Windows. Kundeoppfølging og Administrasjon

Kom i gang med matrikkelklienten

Eksamen i Internetteknologi Fagkode: ITE1526

CSS-formatering: stilark med kommentarer

Dialog 4422 IP Office

KOMME I GANG 3. Logge på 3. I redigeringsvinduet 4 OVERSIKT OVER KNAPPENE SOM LIGGER ØVERST I REDIGERINGSVINDUET 6

PBL Barnehageweb. Brukerveiledning

Transkript:

Produktinfo WebService integrasjonsbeskrivelse

Innhold PRODUKTINFO WEBSERVICE 1 INTEGRASJONSBESKRIVELSE 1 DOKUMENTINFORMASJON 3 1. ARKITEKTUR OG TEKNOLOGI 4 1.1. ARKITEKTUR OG DATAFLYT 4 1.2. TEKNOLOGI 4 1.2.1. Valg av teknologi 5 1.2.2. Dokument- og bildetyper 6 1.2.3. Om Dokument- og bildelenker 6 2. IMPLEMENTASJON 7 2.1. WEB SERVICES 7 2.1.1. Visual Studio.Net 7 2.1.1.1. Legg til "Web Reference" 7 2.1.2. Dokumentlenkefunksjoner 10 2.1.2.2. ProduktInfo.HentDokumentLenkerXML 10 2.1.3. Bildelenkefunksjoner 11 2.1.3.3. ProduktInfo.HentBildeLenkerXML 11 2.1.3.4. ProduktInfo.HentBildeLenkerXMLTyped 11 2.1.3.5. ProduktInfo.HentBildeLenkerHTML 12 2.1.4. Kombinert bilde- og dokumentlenkefunksjoner 12 2.1.4.6. ProduktInfo.HentDokumentBildeLenkerXML 12 2.1.4.7. ProduktInfo.HentDokumentBildeLenkerXMLTyped 12 2.1.4.8. ProduktInfo.HentDokumentBildeLenkerHTML 13 2.1.5. Sortimentsfunksjoner 14 2.1.5.9. ProduktInfo.SendSortiment 14 2.1.5.10. ProduktInfo.SendSortimentTyped 15 2.1.6. Diverse funksjoner 16 2.1.6.11. ProduktInfo.HentProdukterForVareeier 16 2.1.6.12. ProduktInfo.HentPREDokumentHTML 16 2.1.7. Datasett 17 2.1.7.13. DokumentLenker 17 2.1.7.14. Produkter 17 2.2. JAVASCRIPT 18 2.2.1. HentPreDokHTML 18 2.2.2. HentDokLenker 19 2.2.3. HentBildeLenkerJS 20 2.2.4. HentDokumentBildeLenkerJS 20 2.3. STATISKE LENKER 21 2.3.1. Html kode for en statisk lenke 21 2.3.2. Lenker til enkeltbilder Feil! Bokmerke er ikke definert. 2.3.3. HentBilde 22 2.3.4. HentBildeData 23 2.4. STILARK 24 2 of 24

Dokumentinformasjon TEKNISK MANUAL ProduktInfoService integrasjonsbeskrivelse for vareeiere Author Kjetil Gullen Created 8-Jun-04 Changed 3-May-07 Customer Norsk byggtjeneste oda as Customers ref Hans Hope Projectname ProduktInfoService Proj.no. 10299 Doc.no. Revision 2 Pages 24 3 of 24

1. Arkitektur og teknologi 1.1. Arkitektur og dataflyt 1. Sluttbruker navigerer inn på vareeiers nettsider. 2. Vareeiers webserver leser dokumentlenker og produktinfo fra NBT server og integrerer dette i nettsidene som returneres til sluttbruker. 3. Sluttbruker klikker på en dokumentlenke som peker direkte til siste versjon av dokumentet på NBT s server. 2. Vareeier server Internett 1. 1.2. Teknologi Vareeiers system henter dokumentlenker via en av følgende teknologier: NBT Server 3. Dokument Sluttbruker Vareeier NBT.Net HTTP XML Web Service Javascript HTTP Javascript kode Aspx web page Statiske lenker HTTP Dokument Aspx web page Implementering kan gjøres uavhengig av vareeiers plattform, da Javascript og statiske lenker blir tolket og utført av sluttbrukerens nettleser. 4 of 24

1.2.1. Valg av teknologi Hva kan jeg bruke og hva bør jeg bruke? Web services Anbefalt Ved å bruke web services kan vareeier sy sammen data fra Byggtjenestens produktinfo-tjeneste med egne websider. Denne metodikken overlater ingenting til klienten. Dokumenter lastes direkte ned fra produktinfo databasen til Byggtjenesten og vil derfor alltid være oppdatert. Egner seg bra til Microsoft.Net løsninger og andre løsninger med XML Web Services støtte. Javascript Her overlates jobben til sluttbrukerens nettleser, og krever støtte for å kjøre Javascript i nettleseren. Kan enkelt integreres i publiseringsløsninger og eksisterende sider. Dokumenter lastes direkte ned fra produktinfo databasen til Byggtjenesten og vil derfor alltid være oppdatert. Nettleseren til sluttbrukeren prosesserer et skript som integrerer innholdet i nettsiden til vareeier. Strenge sikkerhetsinnstillinger i klientens nettleser kan gi problemer. Statiske lenker Her overlates mer manuelt arbeid til vareeier. Vareeier må selv legge inn lenker og produktinformasjon i sine websider. Sluttbrukerens nettleser trenger ikke å prosessere noe mer enn den gjør ved bruk av "Web services". Ved endringer av data i databasen hos Byggtjenesten må vareeier selv manuelt oppdatere innholdet sitt. Dette krever ingen kommunikasjon mellom vareeiers og Byggtjenestens system ved generering av sider. Dette kan derfor gå noe raskere. Man må linke til enkeltdokumenter, og har ingen mulighet for å hente ut alle tilgjengelige dokumenter som en liste. 5 of 24

1.2.2. Dokument- og bildetyper Det blir brukt forkortelser for de ulike dokumenttypene. I denne tabellen finner du forklaringer på dokumenttypene. FDV Forvaltning, drift og vedlikehold HMF Helse, miljø og sikkerhet faktablad HMS Helse, miljø og sikkerhet datablad MAN Monteringsanvisning MLJ Miljødeklarasjon PB Produktbilde PRE Produktdatablad SER Sertifikater TEK Teknisk beskrivelse 1.2.3. Om dokument- og bildelenker Produktinfoservice gir klienter muligheten til bruke en vares varenummer til å finne dokumentasjon for varen i tilfeller der dokumentasjonen er assosiert med vare, modul eller modulnummer. Det er også mulig å bruke varenummer eller modulnummeret til å finne dokumentasjon assosiert med dokumentmodulnummeret til en vare. Vær oppmerksom på at det ikke er mulig å hente lenker til dokumenter ved å spesifisere modulnummer eller dokumentmodulnummer til varer som har dokumentasjonen assosiert med varenummer. Det er heller ikke mulig å bruke dokumentmodulnummeret til en vare dersom dokumentasjonen er assosiert med varenummer eller modulnummer. Dette skyldes at det kan eksistere mange varer i den modulen som blir spesifisert. HMS dokumentasjon og bilder kan ikke assosieres med dokumentmodulnummer. 6 of 24

2. Implementasjon 2.1. Web services En "Web Service" er en applikasjon som eksponerer funksjoner over internett, slik at andre applikasjoner kan bruke disse. Disse kan da gjøre interne ressurser (i dette tilfellet produktinfo databasen til NBT) eller funksjoner som er avhengig av slike ressurser tilgjengelig for andre eksterne systemer. "Web Services" er basert på XML og SOAP. I Visual Studio.Net, som vi skal ta for oss, er det innebygd støtte for dette, slik at dette enkelt kan taes i bruk. 2.1.1. Visual Studio.Net Første skritt er å legge til en "Web Reference" til prosjektet man ønsker å integrere web servicen med. For å kunne legge til en referanse til Byggtjenesten sin tjeneste må man være tilknyttet internett. 2.1.1.1. Legg til "Web Reference" Velg "Project" på hovedmenyen og "Add Web Reference" fra nedtrekksmenyen. Etter å ha valgt "Add Web reference" vises en dialog, se neste side. 7 of 24

Følgende dialog vises. Sett markøren i URL feltet og skriv: http://produktinfo.byggtjeneste.no/produktinfo.asmx Dette er adressen til Byggtjenestens produktinfotjeneste. Klikk på ved siden av adressefeltet. Når Visual Studio har hentet informasjon om tjenesten vises denne informasjonen i området nedenfor. (se bildet øverst på siden) Deretter klikker du på, slik at referansen legges til i prosjektet ditt. Et nytt "Namespace" er nå tilgjengelig i din Visual Studio.Net applikasjon. Dette er no.byggtjeneste.produktinfo. 8 of 24

Dette betyr at hvis du skriver "no.byggtjeneste.produktinfo." i Visual Studio.Net vil tilgjengelige klasser i produktinfotjenesten vises. (se bildet nedenfor) For å aksessere funksjoner i Byggtjenestens system må ProduktInfo-klassen benyttes. Resten av kapitlet beskriver disse funksjonene. 9 of 24

2.1.2. Dokumentlenkefunksjoner 2.1.2.2. ProduktInfo.HentDokumentLenkerXML Parametere: Vare/Modul nummer til ønsket produkt. Metoden returnerer et typet datasett med alle tilgjengelige dokumentlenker og url er til disse for et angitt produkt. Eksemplet under lister disse for produktet 25222472 i en datagrid. private void Button1_Click(object sender, System.EventArgs e) { no.byggtjeneste.produktinfo.produktinfo pinfo = new WebServiceTest.no.byggtjeneste.produktinfo.ProduktInfo(); DataGrid1.DataSource = pinfo.hentdokumentlenkerxml("25222472"); } DataGrid1.DataBind(); Neste eksempel itererer igjennom alle dokumentlenker og henter ut URL og pulikasjonstype i 2 variabler i en løkke. no.byggtjeneste.produktinfo.produktinfo pinfo = new WebServiceTest.no.byggtjeneste.produktinfo.ProduktInfo(); no.byggtjeneste.produktinfo.dokumentlenker dl = pinfo.hentdokumentlenkerxml("25222472"); foreach(no.byggtjeneste.produktinfo.dokumentlenker.dokumentlenkerow DokLenke in dl.dokumentlenke) { string sdokumenturl = DokLenke.Url; } string spublikasjonstype = DokLenke.Publikasjonstype; 10 of 24

2.1.3. Bildelenkefunksjoner Følgende funksjoner returnerer sett med lenker til bilder. 2.1.3.3. ProduktInfo.HentBildeLenkerXML Parametere: Vare/Modul nummer til ønsket produkt og størrelse på bilde. Metoden returnerer et typet datasett med alle tilgjengelige bildelenker og url er til disse for et angitt produkt. private void Button1_Click(object sender, System.EventArgs e) { no.byggtjeneste.produktinfo.produktinfo pinfo = new WebServiceTest.no.byggtjeneste.produktinfo.ProduktInfo(); DataGrid1.DataSource = pinfo.hentbildelenkerxml("25222472", "small"); } DataGrid1.DataBind(); 2.1.3.4. ProduktInfo.HentBildeLenkerXMLTyped Parametere: Vare/Modul nummer til ønsket produkt og størrelse på bilde. Metoden returnerer et typet datasett med alle tilgjengelige bildelenker og url er til disse for et angitt produkt. Bildestørrelse angis som en verdi av typen ImageSize. Størrelsene som støttes er ImageSize.small og ImageSize.large. private void Button1_Click(object sender, System.EventArgs e) { no.byggtjeneste.produktinfo.produktinfo pinfo = new WebServiceTest.no.byggtjeneste.produktinfo.ProduktInfo(); DataGrid1.DataSource = pinfo.hentbildelenkerxmltyped("25222472", no.byggtjeneste.produktinfo.imagesize.small); } DataGrid1.DataBind(); 11 of 24

2.1.3.5. ProduktInfo.HentBildeLenkerHTML Parametere: Vare/Modul nr til ønsket produkt Metoden returnerer en liste med lenker i form av en HTML formatert tekst streng som kan settes direkte inn i websiden, via f.eks. en Label-kontroll slik eksemplet under viser. private void Button1_Click(object sender, System.EventArgs e) { no.byggtjeneste.produktinfo.produktinfo pinfo = new WebServiceTest.no.byggtjeneste.produktinfo.ProduktInfo(); string shtml = pinfo.hentbildelenkerhtml( "25222472" ); } Label1.Text = shtml; 2.1.4. Kombinert bilde- og dokumentlenkefunksjoner Følgende funksjoner returnerer lenker til både bilder og dokumenter i samme lenkesett. 2.1.4.6. ProduktInfo.HentDokumentBildeLenkerXML Parametere: Vare/Modul nummer til ønsket produkt og størrelse på bilde. Metoden returnerer et typet datasett med alle tilgjengelige bilde- og dokumentlenker og url er til disse for et angitt produkt. Bildestørrelse angis som en verdi av typen ImageSize. private void Button1_Click(object sender, System.EventArgs e) { no.byggtjeneste.produktinfo.produktinfo pinfo = new WebServiceTest.no.byggtjeneste.produktinfo.ProduktInfo(); DataGrid1.DataSource = pinfo.hentdokumentbildelenkerxml("25222472", "small"); } DataGrid1.DataBind(); 2.1.4.7. ProduktInfo.HentDokumentBildeLenkerXMLTyped Parametere: Vare/Modul nummer til ønsket produkt og størrelse på bilde. Metoden returnerer et typet datasett med alle tilgjengelige bilde- og dokumentlenker og url er til disse for et angitt produkt. Bildestørrelse angis som en verdi av typen ImageSize. Størrelsene som støttes er ImageSize.small og ImageSize.large. private void Button1_Click(object sender, System.EventArgs e) { no.byggtjeneste.produktinfo.produktinfo pinfo = new WebServiceTest.no.byggtjeneste.produktinfo.ProduktInfo(); DataGrid1.DataSource = pinfo.hentdokumentbildelenkerxmltyped("25222472", no.byggtjeneste.produktinfo.imagesize.small); 12 of 24

} DataGrid1.DataBind(); 2.1.4.8. ProduktInfo.HentDokumentBildeLenkerHTML Parametere: Vare/Modul nr til ønsket produkt Metoden returnerer en liste med lenker i form av en HTML formattert tekst streng som kan settes direkte inn i websiden, via f.eks. en Label-kontroll slik eksemplet under viser. private void Button1_Click(object sender, System.EventArgs e) { no.byggtjeneste.produktinfo.produktinfo pinfo = new WebServiceTest.no.byggtjeneste.produktinfo.ProduktInfo(); string shtml = pinfo.hentdokumentbildelenkerhtml( "25222472" ); } Label1.Text = shtml; 13 of 24

2.1.5. Sortimentsfunksjoner Følgende funksjoner gjør det mulig å sende en samling dokumenter/bilder som et ziparkiv til en gitt epostadresse. 2.1.5.9. ProduktInfo.SendSortiment Parametere: string EpostAdresse, string[] VareListe, int[] DoktypeListe Metoden lager et ZIP arkiv med angitte dokumenter og/eller bilder for angitte produkter og sender lenke til denne via e-post til angitt adresse. Metoden returnerer også lenken til arkivet. Lenken er gyldig i 1-2 dager før arkivet slettes. Ved bruk av utypede data (for eksempel hvis du benytter Java eller PHP, eller andre språk som ikke har støtte for.net objekter), benyttes disse verdiene: Navn Tallverdi ALLE 0 HMS 1 PRE 2 TEK 3 FDV 4 MAN 5 SER 6 MLJ 7 HMF 8 PB 9 Disse verdiene bør med fordel lagres i en enum datatype eller tilsvarende, slik at man har kontroll på verdiene på ett sted. Eksemplet under viser kode for å sende HMS dokument for 25222472 og ALLE dokumenter for 25222473. no.byggtjeneste.produktinfo.produktinfo p = new no.byggtjeneste.produktinfo.produktinfo(); p.sendsortiment( "navn@firma.no", new string[] {"25222472", "25222473"}, new int[] {1, 0} ); 14 of 24

2.1.5.10. ProduktInfo.SendSortimentTyped Parametere: string EpostAdresse, string[] VareListe, DokumentTypeValg[] DoktypeListe Denne metoden gjør det samme som SendSortiment men med typet variabel for valg av dokumenttyper. Typene for dokumenttyper finnes i WebServicen under namespacet no.byggtjeneste.produktinfo.dokumenttypevalg Gyldige verdier for dokumenttypen er: Eksemplet under viser kode for å sende HMS dokument for 25222472 og ALLE dokumenter for 25222473. p.sendsortimenttyped( "navn@firma.no", new string[] {"25222472", "25222473"}, new no.byggtjeneste.produktinfo.dokumenttypevalg[] {no.byggtjeneste.produktinfo.dokumenttypevalg.hms, no.byggtjeneste.produktinfo.dokumenttypevalg.alle} ); Første parameter inneholder da en liste med NOBB Modul/varenummer, mens andre parameter inneholder en liste med dokumenttypene for de respektive NOBB modul/varenummer. Disse 2 listene må være like lange, og index 0 i NOBB Modul/varenummer listen vil få dokumenter av typen spesifisert i index 0 for dokumenttype listen. Ønsker du f. eks. å sende flere dokumenttyper for et produkt men ikke alle dokumenttyper må samme produkt spesifiseres flere ganger, se eksemplet under. p.sendsortimenttyped( "navn@firma.no", new string[] {"25222472", " 25222472"}, new no.byggtjeneste.produktinfo.dokumenttypevalg[] {no.byggtjeneste.produktinfo.dokumenttypevalg.hms, no.byggtjeneste.produktinfo.dokumenttypevalg.pre} ); I eksemplet er samme produktet (25222472) spesifisert 2 ganger med PRE og HMS dokument. 15 of 24

2.1.6. Diverse funksjoner 2.1.6.11. ProduktInfo.HentProdukterForVareeier Parametere: Navn på ønsket vareeier av produkter. Metoden henter alle produkter til en gitt vareeier og returnerer NOBB Modul numrene til disse i et typet datasett. Eksempel: Bygg og Tre AS er kun et eksempel og ligger ikke nødvendigvis i Byggtjeneste databasen. For å få eksemplet til å fungere er det viktig at du har lagt en DataGrid komponent på websiden din og at Button1_Click metoden er koblet til en Click hendelse på en knapp på samme siden. Bytt også ut Bygg og tre AS med ditt eget firmanavn. 2.1.6.12. ProduktInfo.HentPREDokumentHTML Parametere: VareModul nr til ønsket produkt Metoden returnerer PRE dokument i en HTML formatert tekst streng som kan settes direkte inn i websiden, via f.eks. en Label-kontroll slik eksemplet under viser. private void Button1_Click(object sender, System.EventArgs e) { no.byggtjeneste.produktinfo.produktinfo pinfo = new WebServiceTest.no.byggtjeneste.produktinfo.ProduktInfo(); string shtml = pinfo.hentpredokumenthtml( "25222472" ); } Label1.Text = shtml; - Ønsker du å definere hvordan dokumentlenkene skal se ut se kapittel 2.4. 16 of 24

2.1.7. Datasett Datasettene er klasser som gir brukervennlig og type sikker tilgang til data som returneres fra produktinfo tjenesten. 2.1.7.13. DokumentLenker Datasett som inneholder lenker til forskjellige publikasjonstyper av dokumenter. Skjemaet kan lastes ned fra http://produktinfo.byggtjeneste.no/datasets/dokumentlenker.xsd Feltnavn Beskrivelse Type NOBBModulNr Produktets NOBB Tekststreng (string) modulnummer Publikasjonstype Publikasjonstype for Tekststreng (string) dette dokumentet. Url Url til dokumentet Tekststreng (string) 2.1.7.14. Produkter Datasett som inneholder modulnummer til produkter. Skjemaet kan lastes ned fra http://produktinfo.byggtjeneste.no/datasets/produkter.xsd Feltnavn ModulNr Type Tekststreng (string) 17 of 24

2.2. JavaScript JavaScript er kode som kjøres av sluttbrukerens nettleser. Ved å legge med kodelenker (til funksjonene beskrevet nedenfor) i vareeiers nettsider, vil systemet hente inn informasjon fra Byggtjenestens system direkte inn i vareeiers nettsider. 2.2.1. HentPreDokHTML Adresse: http://produktinfo.byggtjeneste.no/hentpredokhtmljs.aspx Parametere: NOBBModulNr Returnerer: PRE dokument i HTML for angitt produkt direkte inn i vareeiers nettsider. Følgende HTML element vil be nettleseren til sluttbruker om å hente produktinformasjon fra NBT sin web server for produkt med nr 25222472. Sett dette elementet inn der du f.eks. ellers ville lagt inn PRE dokumentet i din webside, bytt ut NOBBModulNr parameteren med dine produktnummer. - Ønsker du å definere hvordan dokumentlenkene skal se ut se punkt 2.4. 18 of 24

2.2.2. HentDokLenker Adresse: http://produktinfo.byggtjeneste.no/hentdoklenkerjs.aspx Parametere: NOBBModulNr, Direction, IconFile (nærmere beskrivelse lenger ned) Returnerer: HTML med lenker til angitt produkt direkte inn i vareeiers nettsider. Følgende HTML element vil be nettleseren til sluttbruker om å hente dokument lenker til produktet 25222472 i en horisontal liste. Resultatet ser slik ut i sluttbrukers nettleser: Parametere: Navn NOBBModulNr * Direction * Beskrivelse Produktnummeret du ønsker dokumentlenkene til. Retning lenkene vises på skjerm. Verdier H Horisontalt V Vertikalt (illustrert i bildet til høyre) IconFile Eksempel: Direction=H URL til ikon Eksempel: IconFile=http://abonnement.byggtjeneste.no/TreeDocView/images/pdf. gif Ikonene vises foran dokumenttekstene illustrert på bildet under: * Er påkrevet - Ønsker du å definere hvordan dokumentlenkene skal se ut, se kapittel 2.4. 19 of 24

2.2.3. HentBildeLenkerJS Adresse: http://produktinfo.byggtjeneste.no/hentbildelenkerjs.aspx Parametere: VareModulNr, direction og size. Returnerer: HTML med lenker til angitt produkt direkte inn i vareeiers nettsider. Resultatet ser slik ut i sluttbrukers nettleser: Parametere: - Parameterene er av samme type som i kapittel 2.2.2. - Ønsker du å definere hvordan dokumentlenkene skal se ut se kapittel 2.4. 2.2.4. HentDokumentBildeLenkerJS Adresse: http://produktinfo.byggtjeneste.no/hentdokumentbildelenkerjs.aspx Parametere: VareModulNr, direction og size. Returnerer: HTML med lenker til angitt produkt direkte inn i vareeiers nettsider.. Resultatet ser slik ut i sluttbrukers nettleser: Parametere: - Parameterene er av samme type som i tabellen i kapittel. - Ønsker du å definere hvordan dokumentlenkene skal se ut se kapittel 2.4 20 of 24

2.3. Statiske lenker Dette brukes typisk fordi vareeier selv ønsker full kontroll over egne websider og/eller ikke ønsker å benytte de andre tilgjengelige metodene å integrere seg mot. Tilgjengelige statiske lenker for et angitt produkt kan hentes ut fra denne webadressen: http://produktinfo.byggtjeneste.no/produktlenker.aspx 2.3.1. Html kode for en statisk lenke Lenker defineres i html med et <a> tag. Denne har et attributt som heter href, som er adressen du finner i Url kolonnen på produktlenker listen ovenfor (i produktlenker.aspx). Et eksempel på dette kan være følgende: 21 of 24

2.3.2. HentBilde Adresse: http://produktinfo.byggtjeneste.no/hentbilde.aspx Parametere: Vare eller modulnummer Returnerer: URL til et bilde. Parametere: Navn VareModulNr size Beskrivelse Produktnummeret du ønsker dokumentlenkene til. Størrelsen på bildet, må være enten small eller large. Dersom size parameteren utelukkes, vil bildet være i størrelse small. HentBilde.aspx vil returnere en vanlig lenke direkte til bildet hos leverandøren av bildet. Forskjellen på HentBilde.aspx og HentBildeData.aspx er at HentBildeData.aspx (kapittel 2.3.3) laster ned bildet fra serveren til bildeleverandøren til produktinfoservice serveren og returnerer en lenke dit istedet. Eksempel: HentBilde.aspx bør hente en url som ser slik ut: 22 of 24

2.3.3. HentBildeData Adresse: http://produktinfo.byggtjeneste.no/hentbildedata.aspx Parametere: VareModulNr Returnerer: URL til et bilde. Parametere: Navn VareModulNr size Beskrivelse Produktnummeret du ønsker dokumentlenkene til. Størrelsen på bildet, må være enten small eller large. Dersom size parameteren utelukkes, vil bildet være i størrelse small. Eksempel: HentBildeData forutsetter at VareModulNr er det nummeret bildet er registrert på i bildedatabasen. Dvs man kan ikke sende inn et varenummer å få et bildet som er registrert på varenummerets modulnummer i bildedatabasen. 23 of 24

2.4. Stilark Ønsker du å definere hvordan dokumentlenkene skal se ut kan dette defineres med følgende stilark: Eksempel:.NBTHEADER { font-weight : bold; font-size : 10pt; color : black; }.NBTLINK { font-size : 10pt; font-weight : normal; color : Black; }.NBTIMAGE { border : 0px; } Ønsker du å skjule f.eks. overskriften kan du legge til følgende i.nbtheader stilen: display : none; 24 of 24