Möte 2017-10-18 [sv]

Kulturnav

Matcha poster i Kulturnav

Importera data till en stagingmiljö (dev.kulturnav.org) och där kan ni eller jag matcha mot KulturNav (på fältet Caption). Jag änvänder Python i ett enkelt script:

1. Läser kandidater från stagingmiljöns dataset
   
2. Söker post för post i KulturNav via API (requests.get('http://kulturnav.org/api/summary/' + qstring))
   
3. Matchar resultatet med difflib som kollar likheten mellan strängarna
   
4. Returnerar träffar högre än 85 % match till en textfil
   
5. Granskar dessa manuellt och kollar om de är samma person/post
   
6. Tar bort dubblettkandidater (manuellt) ur kandidatdatasetet
   
7. De poster som blir kvar importeras till produktionsdatabasen
   

Importera poster

Ni kan skapa en enkel importfil själva eller låta KulturIT göra det. När skriv-API är driftsatt kommer det gå att skriva poster direkt.

1. "Platta data" exporteras till ett Excelark (eller teckenseparerad textfil utf-8)
   
2. Data omvandlas till en importfil - det är oftast mitt jobb
   
3. Data importeras till ett dataset (av superadmin)
   

Samlingsförvaltning

Sök/slå upp i Kulturnav

Använd KulturNavs API:

Se struktur

• http://kulturnav.org/schema
  

Hämta JSON för en entitet

/api/{uuid}  

• http://kulturnav.org/api/da246424-b7f8-4fe6-b1a4-453fb6dba3b7
  

Hämta ett helt dataset

/api/list/{dataset-uuid}  

• http://kulturnav.org/api/list/ee40dc76-af82-4aed-b72d-ed016c40b1be
  

Söka och hämta

/api/search/[sökvillkor]  

• http://kulturnav.org/api/search/entity.dataset:ee40dc76-af82-4aed-b72d-ed016c40b1be,entity.name:Andr*
  

  /api/summary/[sökvillkor]
  

  • http://kulturnav.org/api/summary/entity.dataset:ee40dc76-af82-4aed-b72d-ed016c40b1be,person.lastName:Andr*
    

Räkna

/api/count/[sökvillkor]  

• http://kulturnav.org/api/count/entity.dataset:ee40dc76-af82-4aed-b72d-ed016c40b1be,entity.sameAs:https%3A%2F%2Fwww.wikidata.org%2Fentity%2FQ*
  

Importera post från Kulturnav (fält måste mappas)

Importera listor genom CSV eller direkt via API (eller RDF).

Synliggöra Kulturnavsposter (färg, fetstil, symbol, länk…)

Primus använder blå text och fetstil för auktoritetsposter som redigeras i KulturNav och blå färg för poster som är hämtade från KulturNav men kan redigeras i Primus.

Uppdatera poster (skörda, prenumerera, på ändringar) från Kulturnav

Urval/mappar

• Gör urval av data i form av mappar: http://kulturnav.org/api/list/e68ba830-914b-486b-88fd-99b0e5530b7a/0/20
  
• Varje urval/mapp i KulturNav ställs in till vilken Organisation/databas som data ska läsas och till vilken lista i databasen som data ska importeras.
  
• Skapa urval per "systemlista". Varje urval/mapp innehåller en sorts auktoritetspost. Personer för sig. Termer för sig etc.
  
• Listorna - de olika mål-listorna i förvaltningssystemet - kan väljas från KulturNav, jämför Primus-upplägget: http://kulturnav.org/c46df79e-fade-4ccb-b655-e19f13175957
  
• Organisationer/databaser kan väljas
  
• Urvalen förvaltas på samma sätt som ett dataset
  

Ändringar

Hämta urval som ändrats efter en viss tidpunkt:

• http://kulturnav.org/api/search/entity.list:e68ba830-914b-486b-88fd-99b0e5530b7a,savedAt:%3E20171016%20000000-S
  

Redigera/uppdatera poster i Kulturnav direkt?

Skriv-API utvecklas just nu:

• API-användare är vanliga användare som registrerar sig i tjänsten
  
• Datasetförvaltare delar ut rättigheter till API-användare
  
• Klienter autentiseras med Oauth2 och auktoriseras av KulturNavs behörighetsinställningar på datasetet
  
• Transaktionsbaserad hantering - skrivoperationer hanteras i transaktioner där samtliga skrivningar inom transaktionen kan godkännas eller förkastas med ett klick.
  
• Beroende på behörighet för API-användaren så skriver API:t förslag eller direkt i databasen[sv]