Tjenester og kobling til læremidler

I Læremiddelkatalogen hører et læremiddel til en tjeneste. Tjenesten er nettsiden eller appen der elever og lærere åpner læremiddelet.

Tjenester fra Bokbasen

I tillegg til produkter henter vi også tjenester fra Bokbasen. Disse dataene kommer i vårt eget format for tjenester, ikke i ONIX. Se skjema for tjenester for hvilke felt en tjeneste har.

Tjenesten kan også sendes til oss på andre måter, gjennom eget API eller i leverandørflaten. Se Når tjenesten ikke kommer fra Bokbasen.

Slik kobler vi et læremiddel til en tjeneste

Midlertidig løsning

Måten vi kobler læremidler fra Bokbasen til tjenester på i dag, er en midlertidig løsning. ONIX-standarden blir nå gjennomgått for å legge til et felt som kobler et produkt til tjenesten det hører til. Når feltet er på plass, tar vi det i bruk, og da trenger vi ikke lenger listene som er beskrevet her.

Vi finner tjenesten i denne rekkefølgen:

1. Plattformnavn

Vi ser på ProductFormFeature med ProductFormFeatureType 07. Teksten i ProductFormFeatureDescription er navnet på plattformen, altså tjenesten, der læremiddelet brukes.

Vi har en liste over plattformnavn og hvilken tjeneste hvert navn hører til. Navnet dere oppgir må være nøyaktig likt navnet i listen vår, med samme stavemåte og samme store og små bokstaver.

2. Serie

Hvis vi ikke finner et plattformnavn, ser vi på Collection med CollectionType 20, der SourceName er Bokbasen_Ascribed_Collection eller Bokbasen_Schoolbooks. Vi slår opp ID-en til serien i en egen liste over serier og hvilken tjeneste de hører til.

3. Ingen treff

Hvis verken plattformnavn eller serie passer, blir ikke læremiddelet koblet til en tjeneste.

Vi må legge inn plattformnavn og serier hos oss før koblingen virker. Ta kontakt med oss for å sjekke at tjenesten deres er med, eller for å få den lagt til.

Når tjenesten ikke kommer fra Bokbasen

Læremidlene kan komme fra Bokbasen selv om tjenesten kommer fra et annet sted, for eksempel fra deres eget API eller fra leverandørflaten. Koblingen fungerer på samme måte. Slik gjør dere det:

1. Registrer tjenesten, enten i eget API eller i leverandørflaten. Tjenesten får da en ID. I eget API er det verdien dere setter i @id.
2. Bruk ett og samme plattformnavn i ProductFormFeature type 07 på alle produktene som hører til tjenesten.
3. Ta kontakt med oss og fortell hvilket plattformnavn dere bruker, og hvilken tjeneste det hører til. Vi legger det inn i listen vår.

Hvis dere bruker eget API, er det viktig at tjenesten beholder samme ID over tid. Endres ID-en, mister læremidlene koblingen til tjenesten.

Koblingen går alltid fra læremiddelet til tjenesten. Det virker ikke å liste opp læremidlene på tjenesten, for eksempel med ISBN.