Rapporter

Rapporter brukes som underlag for å bygge statistikk.

Låt- og artistrapporter

Låt- og artistrapporter bygges av lister med referanse til låter eller artister.

  • Spilletid oppgis i sekunder.
  • Oppgi fra- og til-dato for når rapporteringen gjelder.
  • Legg til kategori eller en radiokanal for å kategorisere.

Låtrapport og låter

Låtrapporter er oversikt over spilletid over en gitt periode.

  • En låt må inneholder ISRC-kode og navn
  • ISRC-koden brukes for å hente ut metadata om låten vha API.

Artistrapporter og artister

Artistrapporter er knyttet til en artist.

  • En artist må inneholde en referanse til en unik ID.
  • Per i dag brukes “spotifyId” for å hente ut metadata om artisten.

Album

En låt kan være tilknyttet et eller flere album.

  • Brukes som metadata i forbindelse med en låt

Api vs metadata i Sanity

Metadata hentes via API-et til Spotify, on-the-fly når listene presenteres.

  • Låter henter metadata basert på ISRC-koden. Album-cover hentes fra den eldste utgivelsen vi finner i Spotify med samme ISRC-kode.
  • Artister henter metadata basert på “spotifyId”.
  • Album brukes ikke dersom metadata hentes via API.

Overstyre API

UNDER UTVIKLING.

Versjonen vi jobber med nå henter all metadata fra Spotify, uten fallback.

Ideen er at man skal kunne overstyre data fra api-et ved å modellere hele låter i Sanity.

Importere data

Data kan importeres som JSON-filer etter følgende format på låtrapporter:

{
  "title": "Julen 2024",
  "since": "2024-12-01",
  "until": "2024-12-31"
  "items": [
    {
      "artistName": "Mariah Carey",
      "isrc": "USSM19400325",
      "playingTime": 327859,
      "trackName": "All I Want For Christmas Is You"
    },
  ],
}
json

Data-import er under utvikling, foreløpig fungerer selve importen i 2 steg.

  1. Velg “import”-fanen. Last opp en JSON-fil.
  2. Trykk på “Create list”.
  3. Velg “ISRC Editor”-fanen.
  4. Trykk på “Update” på hver enkelt linje.

Det som skjer i steg 4 er at listen i rapporten kobles sammen med låt basert på ISRC-koden. Finnes låten fra før lages en kobling til låt basert på kode. Hvis ikke opprettes en ny låt med ISRC-kode.