Cristin API: tekniske erfaringer

Hvordan byttet vi?

• Cristin lagde nytt API, Cristin 2.0 ('C2')

  • faser ut det gamle, så vi måtte bytte

• Lagde ny komponent for nytt api
• La til en 'switch'
• Brukere kan teste nytt, men standard gammelt
• Lot stå en stund og samlet feedback

• Fikset feil

  • Eks. ikke tatt hensyn til særegenheter på enkelte vertsmaskiner.
  • Eks. lenke i en type dukket opp på uventet sted.
  • Pirk-arbeid.

• Byttet om komponenter

  • Gammelt komponent-kall peker nå til ny versjon.
  • For feilsøking: Gammel kan brukes vha 'hemmelig' kall.

Pros

Gevinster i å bytte

• JSON mye bedre.

  • SOAP er fælt.

• Enkelt api å kommunisere med.
• Fått mye feedback fra brukere i beta.

• Cacher siste vellykka

  • Nødvendig mtp tidligere API.
  • Men er cristin nede er det ingen data på ting vi ikke har vist før.

Pros 2

Nye muligheter

• Datakvalitet på noen typer er bedre.

• Eksempelvis musikk har nå...

  • fulltekst
  • abstract
  • og mer?

• Ikke låst til NFR-prosjekter

  • Oppslag av annet forberedt, men ikke ferdigstilt.

• Sterkere oppslagsmuligheter

  • Flere endepunkter for søk osv

Hindre

Dokumentasjon

• Vag/manglende dokumentasjon

  • Mulige verdier ikke beskrevet
  • Mulige søkbare felt ikke beskrevet (ID, f.eks)
  • Nye kategorier, hierarki borte.
  • Ingen dokumentasjon av Cristin Webapp. Vanskelig å lage lenker til profiler.

• Ting ligger litt overalt.

  • Kan finne url til fulltekst 'overalt', avhengig av datatype.
  • Publisher-url i journal, eller i publisher, eller helt andre steder.
  • Mye fallback-logikk.

Hindre 2

Annet

id-feltet ikke annonsert noe sted..

• Data forsvunnet

  • Kapittel eksisterer ikke.
  • Kan dermed ikke følge APA helt.

• Utvalgte publikasjoner borte

  • Ikke så mange brukte dette, men...
  • ...for noen sluttbrukere var dette viktig.
  • Må evt manuelt skrive i et tekstfelt hos oss.

• Trenger flere kall

  • Noe data krever egne kall. Spesielt 'contributors'
  • Vi viser kun 'preview' fra cristin
  • (Noen blir grinete av dette.)

• Videreutvikling stanset?

  • Skal komme noe nytt
  • Fikser kun de groveste bugs

Feil og 'feil'

Feil i Cristin V2

• Preview har ikke redaktør-info o.l.

• Feil antall forfattere

  • Viser f.eks. 42 på et med 6 forfattere.
  • Blant disse 42 er det gjentakelser...
  • ...av personer som ikke deltok i studiet.
  • Heldigvis sjeldent

• Flerspråksfelt gir ikke fler språk

  • Gir spesifisert språk, eller evt fallback.
  • Gir i blant 'ugyldige språk' (e.g. 'no')

• Noen personer eksisterer ikke i V2?

• Underenheter vises ikke (feil antall resultat):

  • Moderenhet gir ferre resultater enn underenheter.
  • Dette gjør at vi får feil publikasjonlistes når vi vil ha med underenheter.
  • Vi har meldt inn dette og det 'ses på'.

• Noen prosjekter finnes under results, men ikke projects (project_code)

  • Er et NFR-prosjekt, ikke et 'ekte' prosjekt. Henger igjen fra gamledager.