Web-tjenester for presentasjon av sportsdata (fotball). v. 3.0, 23/2/2014

Transkript

1 BRUKERVEILEDNING Web-tjenester for presentasjon av sportsdata (fotball). v. 3.0, 23/2/2014

2 Innholdsfortegnelse 1 Innledning Abonnement Begrensninger i bruk av tjenestene Tekniske begrensninger Beskrivelse og bruk av web-tjenestene: KAMPPROGRAM totalt pr. klubb RESULTATER totalt pr. klubb TABELL pr. turnering/serie KAMPPROGRAM og RESULTATER pr. turnering/serie «TICKER» /Info-banner/Rulletekst for de siste resultatene PLAKATOPPSLAG, neste kamp AKTIVITETSKALENDER Tilpasning av design og funksjonalitet for aktuell web-tjeneste Plassering av web-tjenestene på hjemmesiden Bruk av Iframe Optimalisering av responstider

3 1 Innledning Web-programmene er konstruert slik at de kan benyttes som frittstående komponenter på klubbens/lagets hjemmeside. Komponentene er f.eks. visning av kampprogram, resultater, tabeller og info-bannere. Både design og funksjonalitet kan til en viss grad parameterstyres av kunden selv, slik at det tilpasses hjemmesidens øvrige design. Det kreves kun grunnleggende kunnskaper om HTML-koding, for å kunne benytte og evt. tilpasse disse tjenestene. 1.1 Abonnement Alle web-programmene er basert på automatisk oppdatert kildedata (i XML-format). Dette må klubben abonnere på fra Dynamic AS / NFF. 1. Det må tegnes års-abonnement på klubbens kildedata («rådata»). Dette kjøpes fra Dynamic AS 2. I tillegg kan man abonnere på våre web-tjenester som viser de ønskede data. Dette bestilles fra Web-tjenesten(e) leveres i form av en URL-adresse (Tjenesten er tilgjengelig for aktuell sesong) 1.2 Begrensninger i bruk av tjenestene Datagrunnlaget fra Dynamic AS / NFF kan kun benyttes fra nettsidene til den klubb som abonnerer på disse. Denne begrensningen gjelder også bruken av web-tjenestene fra Tekniske begrensninger Web-tjenestene er utviklet for, og testet ut på nettleseren Internet Explorer v.11, men fungerer selvsagt mer eller mindre likt i andre nettlesere. 3

4 2 Beskrivelse og bruk av web-tjenestene: 2.1 KAMPPROGRAM totalt pr. klubb Adresse (URL): Eksempel på bruk av dette programmet: URL: &bredde=600&tidsvindu=fremtid&fg=0033cc&bg=f1d623 Kolonnene Kamp, Klasse/turnering og bane inneholder linker til relevant info på 4

5 2.1.3 Parameterstyring: Parameter navn Beskrivelse Aktuelle verdier Obligatorisk parameter? Standard verdi cid Klubbens idnr. (i XML-feedene) <ClubId> JA - tid Kun aktuell serie (idnr. fra XMLfeedene), <TournamentId>/alle Nei alle eller alle serier. hb Viser alle kamper, eller bare kamper på hjemme/borte/alle Nei alle bortearena-/hjemmearena fbredde Visningens bredde i antall pixler <Antall pixler> Nei 580 fg Forgrunns-farge <RGB fargekode> Nei (Svart) bg Bakgrunns-farge <RGB fargekode> Nei FFFFFF (Hvit) fontsizehead Font størrelse for headingen <antall punkter> Nei 12 fontsizedet Font størrelse for detaljlinjene <antall punkter> Nei 8 zebra Annenhver linje i lista med lysegrå farge, ja/ nei Nei ja eller alle linjer med lik farge tidsvindu Kun fremtidige kamper, eller vise hele fremtid/alt Nei alt sesongens kampprogram header Sentrert overskrift <tekst> / <ingen tekst> Nei Ingen header datacont Vis dropdown-lister for valg av serie og hjemme/borte, eller ingen datavalgcontroller ja/nei Nei Ja demo *) Arkivert datasett <demo datasett> Nei - tvdato *) Dato utgangspunkt <åååå-mm-dd> Nei Dagens dato *) Brukes etter avtale med Viser data fra tidligere sesonger 5

6 2.2 RESULTATER totalt pr. klubb Adresse (URL): Eksempel på bruk av dette programmet: URL: Parameterstyring: Parameter navn Beskrivelse Aktuelle verdier Obligatorisk parameter? Standard verdi cid Klubbens idnr. (i XML-feedene) <ClubId> JA - tid Kun aktuell serie (idnr. fra XMLfeedene), <TournamentId>/alle Nei alle eller alle serier hb Viser alle kamper, eller bare borte- hjemme/borte/alle Nei alle /hjemmekamper fbredde Visningens bredde i antall pixler <Antall pixler> Nei 580 fg Forgrunns-farge <RGB fargekode> Nei 0033CC (Blå) bg Bakgrunns-farge <RGB fargekode> Nei F1D623 (Gul) fontsizehead Font størrelse for headingen <antall punkter> Nei 12 fontsizedet Font størrelse for detaljlinjene <antall punkter> Nei 8 zebra Annenhver linje i lista med lysegrå farge, ja/ nei Nei ja eller alle linjer med lik farge header Sentrert overskrift <tekst> / <ingen tekst> Nei Ingen header datacont Vis dropdown-lister for valg av serie og hjemme/borte, eller ingen datavalgcontroller ja/nei Nei Ja demo *) Arkivert datasett <demo datasett> Nei - *) Brukes etter avtale med Viser data fra tidligere sesonger 6

7 2.3 TABELL pr. turnering/serie Adresse (URL): Eksempel på bruk av dette programmet: URL: et=10&fg=0033cc&bg=f1d623&opp=1&ned=12 7

8 2.3.3 Parameterstyring: Parameter navn Beskrivelse Aktuelle verdier Obligatorisk parameter? Standard verdi cid Klubbens idnr. (i XML-feedene) <ClubId> JA - teamid Lagets nr. (idnr. fra XML-feedene) <TeamId> JA - tid Aktuell serie/turnering (idnr. fra XMLfeedene) <TournamentId> JA - fbredde Visningens bredde i antall pixler <Antall pixler> Nei 290 fg Forgrunns-farge <RGB fargekode> Nei 0033CC (Blå) bg Bakgrunns-farge <RGB fargekode> Nei F1D623 (Gul) opp Direkte opprykk for denne plassen og <plass nr> Nei 0 over ned Direkte nedrykk for denne plassen og <plass nr> Nei 999 under oppkv Kvalik for opprykk fra denne plass, og <plass nr> Nei 0 over nedkv Kvalik for nedrykk fra denne plass, og <plass nr> Nei 999 under fontsizehead Font størrelse for headingen <antall punkter> Nei 12 fontsizedet Font størrelse for detaljlinjene <antall punkter> Nei 8 datacont Vis lenker for navigering til ja/nei Nei ja tabell/resultat/kamper, eller ingen lenker vishode Om turneringsnavnet vises som hode Ja/nei Nei ja ramme Om det skal vises en ramme Ja/nei Nei Ja demo *) Arkivert datasett <demo datasett> Nei - tvdato *) Dato utgangspunkt <åååå-mm-dd> Nei Dagens dato parentid *) Intern bruk <valgfri> Nei <blank> *) Brukes etter avtale med Viser data fra tidligere sesonger 8

9 2.4 KAMPPROGRAM og RESULTATER pr. turnering/serie Adresse (URL): Eksempel på bruk av disse programmene: URL for resultater: &fbredde=440&fontsizehead=12&fontsizedet=10&datacont=ja&vishode=ja URL for kampprogram: redde=440&fontsizehead=12&fontsizedet=10&datacont=ja&vishode=ja Parameterstyring: Parameter navn Beskrivelse Aktuelle verdier Obligatorisk parameter? Standard verdi cid Klubbens idnr. (i XML-feedene) <ClubId> JA - teamid Aktuellt lagg (idnr. fra XML-feedene) <TeamId> JA - tid Aktuell serie/turnering (idnr. Fra XMLfeedene) <TournamentId> JA - vis Vise resultater eller kommende kamper Resultater/kamper Nei resultater fbredde Visningens bredde i antall pixler <Antall pixler> Nei 290 fg Forgrunns-farge <RGB fargekode> Nei 0033CC (Blå) bg Bakgrunns-farge <RGB fargekode> Nei F1D623 (Gul) fontsizehead Font størrelse for headingen <antall punkter> Nei 12 fontsizedet Font størrelse for detaljlinjene <antall punkter> Nei 8 datacont Vis lenker for navigering til ja/nei Nei ja tabell/resultat/kamper, eller ingen lenker vishode Om turneringsnavnet vises som hode Ja/nei Nei ja ramme Om det skal vises en ramme Ja/nei Nei Ja demo *) Arkivert datasett <demo datasett> Nei - tvdato *) Dato utgangspunkt <åååå-mm-dd> Nei Dagens dato parentid *) Intern bruk <valgfri> Nei <blank> *) Brukes etter avtale med Viser data fra tidligere sesonger 9

10 2.5 «TICKER» /Info-banner/Rulletekst for de siste resultatene De siste resultater vises som en linjes rulletekst. Teksten scroller fra høyre mot venstre Man kan velge resultater for klubben totalt, eller for enkelt-turneringer Adresse (URL): Eksempel på bruk av programmet: URL: Parameterstyring: Parameter navn Beskrivelse Aktuelle verdier Obligatorisk parameter? Standard verdi cid Klubbens idnr. (i XML-feedene) <ClubId> JA - tid Aktuell serie/turnering (idnr. fra XMLfeedene) <TournamentId> Nei alle fbredde Visningens bredde i antall pixler <Antall pixler> Nei 175 fg Forgrunns-farge <RGB fargekode> Nei 0033CC (Blå) bg Bakgrunns-farge <RGB fargekode> Nei FFFFFF (Hvit) fontsizedet Font størrelse for rulleteksten <antall punkter> Nei 12 rescol Forgrunnsfarge på resultatet <RGB fargekode> Nei (Svart) rescolseier Forgrunnsfarge på resultatet, hvis seier <RGB fargekode> Nei Som rescol rescoltap Forgrunnsfarge på resultatet, hvis tap <RGB fargekode> Nei Som rescol rescolu Forgrunnsfarge på resultatet, hvis <RGB fargekode> Nei Som rescol uavgjort ramme Om det skal vises en ramme Ja/nei Nei ja antres Antall kamp.res. som skal vises 0 9/sistedato Nei 3 demo *) Arkivert datasett <demo datasett> Nei - *) Brukes etter avtale med Viser data fra tidligere sesonger 10

11 2.6 PLAKATOPPSLAG, neste kamp Adresse (URL): Eksempel på bruk av dette programmet: URL: Parameterstyring: Parameter navn Beskrivelse Aktuelle verdier Obligatorisk parameter? Standard verdi cid Klubbens idnr. (i XML-feedene) <ClubId> JA - teamid Viser dette lagets neste kamp (idnr. fra <TeamId> JA - XML-feedene). fbredde Visningens bredde i antall pixler <Antall pixler> Nei 175 fg Forgrunnsfarge for turneringsnavn og <RGB-fargekode> Nei 0033CC (blå) kamp, som HTML color-kode (RGB) bg Bakgrunnsfarge for turneringsnavn og <RGB-fargekode> Nei F1D623 (gult) kamp, som HTML color-kode (RGB) fontsizehead Font størrelse for Turneringsnavn og <antall punkter> Nei 11 kamp fontsizedet Font størrelse for Tidspunkt og stadion <antall punkter> Nei 10 ramme Om det skal være ramme rundt visningen ja/nei Nei Ja Filecache *) Om man ønsker at alle klubbens data Ja/nei Nei Nei skal leses, slik at dette lagres i file-cache demo *) Arkivert datasett <demo datasett> Nei - tvdato *) Dato utgangspunkt <åååå-mm-dd> Nei Dagens dato *) Brukes etter avtale med 11

12 2.7 AKTIVITETSKALENDER Adresse (URL): Eksempler på bruk av dette programmet: Eksempel 1: URL: Haralokka&fbredde=600&tidsvindu=fremtid&fg=0033CC&bg=F1D623 Viser kampprogrammet for hele klubben på en valgt arena: 12

13 Eksempel 2: URL: vindu=fremtid&datacont=ja Viser kommende kamper og tidligere kamper og resultater. Man kan selv velgekommende/arkiv/serie/arena: 13

14 2.7.3 Parameterstyring: Parameter navn Beskrivelse Aktuelle verdier Obligatorisk parameter? Standard verdi cid Klubbens idnr. (i XML-feedene) <ClubId> JA - tid Kun aktuell serie (idnr. fra XMLfeedene), <TournamentId>/alle Nei alle eller alle serier. hb Viser alle kamper, eller bare kamper på hjemme/borte/alle Nei alle bortearena-/hjemmearena fbredde Visningens bredde i antall pixler <Antall pixler> Nei - fg Forgrunns-farge <RGB fargekode> Nei (Svart) bg Bakgrunns-farge <RGB fargekode> Nei FFFFFF (Hvit) fontsizehead Font størrelse for headingen <antall punkter> Nei 12 fontsizedet Font størrelse for detaljlinjene <antall punkter> Nei 10 tidsvindu Kun fremtidige kamper, eller vise hele fremtid/alt Nei fremtid sesongens kampprogram header Sentrert overskrift <tekst> / <ingen tekst> Nei Ingen header datacont Vis dropdown-lister for valg av serie og ja/nei Nei Nei arena, og knapper for Arkiv/Kommende demo *) Arkivert datasett <demo datasett> Nei - tvdato *) Dato utgangspunkt <åååå-mm-dd> Nei Dagens dato *) Brukes etter avtale med Viser data fra tidligere sesonger 14

15 3 Tilpasning av design og funksjonalitet for aktuell web-tjeneste Kopier URL en til adressefeltet i din browser, og prøv deg frem med å variere de tilgjengelige parameterne 4 Plassering av web-tjenestene på hjemmesiden 4.1 Bruk av Iframe Visningens URL kan plasseres i en Inline frame, f.eks slik: <iframe style="width: 310px; HEIGHT: 276px" frameborder="0" marginwidth="0" scrolling="yes" align="middle" src=" </iframe> På denne måten kan visningen plasseres eksakt hvor man vil på egen hjemmeside. OBS! Dersom visningen har en variabel lengde (f.eks kommende kamper), bør WIDTH i iframe, settes til ca. 15 punkter større enn visningens bredde. Dette for å gjøre plass til scroll-bar 5 Optimalisering av responstider Noen av webtjenestene krever at relativt mye data skal leses fra serveren til Dynamic AS. Dersom klubben har mange lag, kan f.eks visning av total kampkalender for hele klubben, virke noe treg, dersom alle data skal hentes hver gang. Ved å sette opp «file-caching» vil data leses fra et filområde på Dette filområdet oppdateres med ferske data fra Dynamic AS, med et valgfritt tidsintervall (f.eks hvert 5 minutt) Dette løses ved å sette opp «file-caching, slik: 1. Gi beskjed til at klubben ønsker å bruke «file-caching» 2. Sørg for at denne HTML-koden plasseres på klubbens hovedside: <iframe style="width: 0px; HEIGHT: 0px" frameborder="0" marginwidth="0" scrolling="no" src=" </iframe> NB! 999 erstattes med din klubbs Club ID Ingenting vises i browser-vinduet! 15