Åtgärder

Skillnad mellan versioner av "Användning av DORIS"

Från DAU-handboken

Rad 6: Rad 6:


==Databeskrivningar==
==Databeskrivningar==
[https://doi.org/10.5281/zenodo.6346745 Här finn Manual för DORIS]


===Inkommen databeskrivning===
===Inkommen databeskrivning===

Versionen från 29 juni 2022 kl. 07.52

På startsidan på SND:s webbplats kan du logga in på Mina sidor. Använd ditt SWAMID-konto hos ditt lärosäte för att logga in. Du kan också skapa ett konto, för exempelvis en funktionsadress, genom att klicka på Logga in med användarnamn/lösenord och sen vidare till Skapa nytt konto.

Tryck på Logga in och följ inloggningsinstruktionerna.

Inne på Mina sidor kommer du åt DORIS. Det räcker med att klicka på DORIS för att kunna börja arbeta med verktyget.

Databeskrivningar

Här finn Manual för DORIS

Inkommen databeskrivning

Väl inne i DORIS så kommer du först till granskningsvyn, dvs. sidan som visar inkomna databeskrivningar. Du kan använda snabbfilter i övre högerspalt för att enkelt filtrera databeskrivningarna.

För att se inkomna databeskrivningar kan du t.ex. trycka på snabbfiltret "Visa inkomna databeskrivningar". Alla inkomna databeskrivningar som inte har tilldelats en granskare kommer då dyka upp överst i listan över databeskrivningar. Under kolumnen Ansvarig kommer det att stå Ej tilldelad.

När en databeskrivning har inkommit till DORIS för granskning måste en granskare först tilldelas för att kunna starta granskningsprocessen.

Tilldela granskare

För att tilldela en granskare till en databeskrivning så trycker du på symbolen för Tilldela granskare Tilldela granskare till databeskrivningen.jpg. För du muspekaren över symbolen ser du att det står Tilldela. När du trycker på Tilldela granskare till databeskrivningen.jpg så visas en pop-up ruta med rubriken Tilldela ärendet till en person. Du kan nu välja att tilldela databeskrivningen till dig själv genom att välja alternativet “Mig själv”. När du bockar för alternativet “Mig själv” så bekräftas det genom att texten Du är nu tilldelad ärendet visas strax ovanför en kort stund. Du kan nu stänga dialogrutan genom att klicka på Stäng.

Tilldela en annan granskare

För att tilldela en annan granskare till databeskrivningen trycker du på Tilldela granskare till databeskrivningen.jpg men väljer alternativet “Annan person (välj nedan):”. När du bockar för detta alternativ kan du sedan välja en person i rullistan “Välj en person att tilldela”. När du markerar en person i listan bekräftas det genom att texten Ärendet har tilldelats Förnamn Efternamn visas strax ovanför en kort stund. Personen du har valt som granskare syns i textrutan, se bild nedan. Du kan nu stänga dialogrutan genom att klicka på Stäng.

Tilldela annan granskare.jpg

De personer som visas i rullistan är de samma som är registrerade som granskande DAU-medarbetare i SND:s system. I funktionen Administration i DORIS kan användare hanteras.

Granska metadata och data

För att granska en databeskrivning i DORIS klickar du på titeln. Formuläret öppnas då i samma fönster som du är i.

Här finns beskrivet om hur du kan tänka när du granskar data och metadata.

Här finns SND:s policy för granskning av data och metadata.

Här finns Krav och rekommendationer för granskning av data och metadata i SND:s forskningsdatakatalog.

Här finns Vägledning för filhantering och mappstruktur.

Några funktioner som är bra att använda under granskningsprocessen är:

  • Aktivitetsloggen. Här kan du följa vad som har hänt med databeskrivningen genom dess statusförändringar. Du ser vem som gjort vilken statusändring och du kan se eventuella meddelanden som skickats i samband med statusändringar. Forskaren har en något förenklad vy här och ser t.ex. inte skillnad mellan Under granskning av DAU och Under granskning av SND, utan ser enbart Under granskning. Forskaren kan heller inte se kommunikation mellan DAU och SND.
  • Anteckningar. En viktig och användbar funktion för att dokumentera granskningsprocessen internt. Funktionen är bara synlig för DAU och SND. Man kan skriva anteckningar både i sina egna granskningar och i andras, och under alla statusar. Varje anteckning signeras automatiskt med namn och datum. En rekommendation är att inte ta bort anteckningar om de inte är direkt felaktiga. Om förhållandena ändras är det bättre att skriva en ny anteckning med information om vad som är förändrat.
  • Förhandsgranska katalogposten. Använd funktionen i vänsterkolumnen för att se hur katalogposten kommer att se ut. Ett bra sätt att få en överskådlig bild av databeskrivningen och metadata. DOI och citeringsförslag syns inte förrän katalogposten är publicerad.
  • Ladda ner filer. I vänsterkolumnen finns en funktion för att ladda ner de filer som är uppladdade till databeskrivningen, både data och tillhörande dokumentation.
  • Tomma obligatoriska fält. Antalet tomma obligatoriska fält visas bakom varje avsnittsrubrik i vänsterkolumnen. Ger en första snabb hint om hur väldokumenterad formuläret är och hjälper till att hitta eventuella missar. Saknad obligatorisk information listas också längst ner i formuläret under varje avsnitt.

Det går naturligtvis bra att stämma av med SND-kontoret under granskningsprocessens gång, via exempelvis mail eller telefon.

Skicka tillbaka för komplettering

Om du anser att något saknas för att du ska kunna skicka vidare databeskrivningen till SND, så begär du in kompletteringar från forskaren. Du gör detta genom att byta status till Under komplettering av överlämnare. I samband med statusbytet kan du lämna ett meddelande till forskaren över vad som behöver förbättras. Även om du har haft en del kommunikation med forskaren, via exempelvis mail, så kan det vara bra att kortfattat sammanfatta kompletteringsbehovet även här, så att en medarbetare som i framtiden kanske kommer att titta på ärendet kan föja vad som hänt.

Tänk på att forskaren i sin vy av aktivitetsloggen inte ser kommunikation/statusbyten mellan DAU och SND. Så om det är en komplettering från SND som ska skickas vidare till forskaren behöver du ange den på nytt när du byter status.

Förhandsbokade DOI:ar

Det händer relativt ofta att en forskare som skickar in en databeskrivning i DORIS i första hand är i behov av en DOI, då PID på data allt oftare är ett krav för att få publicera en artikel. I meddelandefältet i samband med att databeskrivningen skickas in uppmanas forskaren att ange om det finns någon deadline för DOI eller publicering av katalogpost. Det här är viktig information att vara uppmärksam på, då det ofta handlar om relativt kort framförhållning. Informationen som fyllts i här syns både i det automatgenererade mailet om inkommen databeskrivning som skickas till DAU och i aktivitetsloggen högst upp inne i databeskrivningen i DORIS.

Så snart ett dataset skapas i formuläret (avsnitt 5. Data, insamling & åtkomst) genereras en förhandsbokad DOI. DOI:en är inte synlig för forskaren utan syns enbart i granskningsvyn.

När en forskare ber om förhandsbokad DOI lämnar du ut det DOI-id som syns i samband med datasetet i formuläret.

Förhandsboka DOI.jpg

Tänk på att informera forskaren om att DOI:en inte blir skarp, det vill säga inte leder till någon landningssida förrän det finns en publicerad katalogpost i SND:s forskningsdatakatalog. Innan du lämnar ut DOI:en kan det vara bra att ta en snabbtitt på metadata och data för att få en första uppfattning om det återstår en del arbete för forskaren. Om så är fallet kan det vara bra att informera om det direkt och kanske skicka med en länk till här sidan där det står beskrivet vad som är bra att tänka på innan man delar data via SND.

Sluten referentgranskning (Closed Review)

Under första fliken i formuläret finns ett fält för sluten referensgranskning, även kallad closed review.

Closed review.jpg

Forskaren markerar här om data behöver finnas åtkomliga i samband med att en artikel granskas för publicering.

I de här fallen gör forskare och granskare klart databeskrivningen så långt det är möjligt, lägger till eventuella kompletteringar, hanterar filer, osv. Länk till den kommande artikeln kan behöva kompletteras med i efterhand.

Som länk till katalogposten och data används den URL-adress som genereras för förhandsvisningen av katalogposten (den kommande katalogposten nås via Förhandsgranska i vänsterkolumnen inne databeskrivningen i DORIS och URL:en kopieras därifrån). Denna URL skickas till förlaget för åtkomst till data.

Ofta vill förlaget eller tidskriften också ha den kommande DOI:en för data. Observera dock att DOI:en INTE är aktiverad förrän det finns en publicerad katalogpost i SND-katalogen, så fram till dess är det URL:en som är länken till data. Denna länk är dock tillfällig och byts ut i samband med att posten publiceras. Persistent länk efter publicering är DOI:en. Detta är viktigt att informera forskaren om.

Data som ska vara direkt nedladdningsbara i katalogen finns åtkomliga där redan under referentgranskningen. Data med begränsad åtkomst delas efter förfrågan, via en sftp-server. Under tiden som artikelgranskningen pågår låter man databeskrivningen ligga kvar som Under granskning i DORIS.

I listningen av databeskrivningar inne i DORIS syns vilka databeskrivningar som är under referentgranskning då de har symbolen Ikon closed review.jpgbakom titeln.

Fram till dess att posten är publicerad i SND-katalogen är det möjligt att uppdatera data och dokumentation utan att en ny DOI behöver skapas. Det är först med en publicerad post som DOI:en aktiveras och knyts till datasetsversionen. Uppdateringar av filer efter publicering ger en ny datasetsversion och en ny DOI.

Databeskrivningar som är under Sluten referentgranskning är inte sökbara i forskningsdatakatalogen. De ska också vara förhållandevis dolda i sökningar i t.ex. Google.

När artikeln är godkänd kan databeskrivningen också publiceras. Tanken är att forskaren ska höra av sig när artikeln är publicerad men det är inte alltid det händer, därför brukar vi på SND-kontoret följa upp våra sådana här granskningar efter en tid.

Checkboxar för Försäkran och Kontroll

För att minimera risken att data sprids eller delas på ett sätt som strider mot lagen behöver varje enskild forskningshuvudman som delar data via SND:s forskningsdatakatalog ha rutiner för att säkerställa detta. Mer detaljerad information om vilka rutiner som bör finnas på plats finns beskrivet i Krav och rekommendationer för data och metadata i SND:s forskningsdatakatalog (avsnittet om juridiska förutsättningar). Samma information har också skickats ut tillsammans med i förtydligandet av samverkansavtalet till alla organisationer i SND-nätverket.

I DORIS behöver ansvarig forskare intyga att de data som delas inte innehåller uppgifter vars spridning eller tillgängliggörande utgör ett brott eller strider mot avtal. I de fall data ska vara direkt nedladdningsbara behöver forskaren även försäkra att data får delas utan restriktioner.

DAU/SND ska vid avslutad granskning bekräfta att forskarens försäkran är kontrollerad. Kontrollerna innebär i praktiken du som granskare gör vad du kan för att säkerställa lagenlighet i enlighet med de rutiner som finns inom din organisation. Som granskare kan det ibland vara svårt att veta vad som gäller för olika typer av data/forskning så vid osäkerhet är det viktigt att ha en dialog med både forskaren och med andra kollegor, ex. organisationens dataskyddsombud. Genom att ställa frågor till forskaren om materialet/projektet brukar man tillsammans kunna komma fram till hur data bäst bör hanteras.

Det är viktigt att dokumentera hur granskningen har gått till och vilka bedömningar som gjorts, använd anteckningsfunktionen i DORIS och kopiera exempelvis in mailkonversationer med forskaren.

Både forskarens försäkran och DAU/SND:s markeringar sparas och loggas i aktivitetsloggen i DORIS.

För pågående granskningar kan det i en övergångsperiod bli lite fel i systemet eftersom DORIS kan kräva att ni kryssar i försäkran även för de poster då funktionen inte fanns på plats när forskaren skickade in. Lägg en anteckning i DORIS där ni beskriver att försäkran tillkommit som funktion efter det att forskaren skickat in sin databeskrivning för granskning.

Försäkran1.jpg
Checkboxar som forskaren behöver markera innan en databeskrivning kan skickas in för granskning.

Kontroll DAU SND.jpg
Checkboxar som DAU- och SND-medarbetare behöver markera innan en databeskrivning kan skickas vidare eller publiceras.

Skicka vidare till SND

När DAU är färdig med granskningen av en databeskrivning skickas den vidare till SND för en slutlig koll. På sikt kommer detta inte längre att behövas och DAU kommer själva att kunna publicera poster i SND-katalogen.

För att skicka vidare en databeskrivning byter du status till Under granskning av SND. Du kan i samband med detta också lämna ett meddelande till SND, om det t.ex. om det har varit något särskilt under granskningen eller om det kvarstår frågetecken. Kommunikationen som sker mellan SND och DAU genom statusar i aktivitetsloggen syns inte för forskaren, utan denna ser bara att databeskrivningen är Under granskning.

Om granskaren hos SND tycker att någonting saknas kommer hen att skicka tillbaka databeskrivningen för komplettering. Du kan då i din tur sen skicka tillbaka den till forskaren om det behövs.

Kommunikation med forskaren

Om DAU deltar i granskningsprocessen av en databeskrivning (är registrerad i DORIS) bör det i första hand vara DAU som sköter kontakten med forskaren. Givetvis måste det finnas en flexibilitet och SND är gärna med i mailkonversationer om det behövs.

Förutom att skicka databeskrivningen för komplettering i DORIS händer att man också har dialog med forskaren via e-post, möte, telefon o.s.v. Det är bra att spara kommunikation som skett utanför DORIS i t.ex. anteckningsfunktionen inne i varje databeskrivning. Det är också viktigt att dokumentera olika beslut som tas i granskningen. För längre mail eller anteckningar är det också möjligt att spara ner dem i en text-fil och bevara den tillsammans med datafilerna. Var dock noga med att filen inte blir synlig i forskningsdatakatalogen. För SND CARE:s filstruktur innebär det att dessa dokumentationsfiler bör ligga tillsammans med en .dipignore -fil.

Förhandsvisning av katalogpost

På SND-kontoret har vi sedan länge en rutin om att alltid be forskaren kontrollera katalogposten innan vi publicerar den i forskningsdatakatalogen. Vi gör detta än så länge via mail och skickar med en länk till katalogens förhandsvisning.

Förslag på text i mail:

Hej xxx,
Nu är din databeskrivning klar för att publiceras i SND:s forskningsdatakatalog. Ta gärna en sista titt på den kommande katalogposten så att allt ser bra ut.
Länk till svenska posten
Länk till engelska posten
Jag/vi/SND publicerar posten när jag fått ett godkännande från dig.
Hälsningar
XXX

Publicera databeskrivning

I dagsläget är det bara SND-kontoret som kan publicera nya databeskrivningar i SND-katalogen. DAU kan däremot publicera uppdateringar/nya versioner utan att det går via SND.

Innan du publicerar en databeskrivning är det viktigt att se till att filerna har hanterats på rätt sätt. De lärosäten/organisationer som har en egen lagringsyta kopplad till DORIS hanterar detta själva inom DAU-gruppen. För de lärosäten som använder SND:s lagring hjälper vi till att strukturera filerna, vilket alltså är viktigt att stämma av innan man publicerar en uppdaterad databeskrivning. Här kan du läsa mer om filhantering. (Hur man uppdaterar en publicerad katalogpost beskrivs nedan.)

För att publicera en databeskrivning ändrar du status till Publicerad. Posten publiceras direkt i katalogen och DOI, dokumentationsfiler och ev. datafiler blir synliga i katalogposten (samt det citeringsförslag som genereras automatiskt).

Uppdatera en publicerad databeskrivning

För att uppdatera/skapa en ny version av en publicerad databeskrivning går du in i DORIS och öppnar databeskrivningen i formuläret.

Klicka på Ändra status och välj Nv version: Under granskning av DAU.

Ändra status.jpg

Gör de uppdateringar som ska göras för metadata i formuläret. Om det ska skapas en ny version för data (dvs. en ny uppdaterad datafil ska laddas upp) så är det viktigt att beskriva versionsförändringen i formuläret i samband med att datafilen laddas upp (ett obligatoriskt fält).

Du kan läsa här om vad som gäller för filhanteringen för uppdaterade databeskrivningar. Se informationen under Granskning av uppdaterad databeskrivning och Publicering av uppdaterad databeskrivning.

Tänk på att det kan vara bra att titta på katalogposten parallellt med arbetet av uppdateringar, så du ser hur ändringarna kommer att se ut i skarpt läge. Detta gör du genom att klicka på Förhandsgranska (den blåa boxen till vänster i formuläret).

Gör du större ändringar i databeskrivningen, utan att ha stämt av dessa med forskaren i förväg, kan det vara bra att skicka en länk med förhandsvisningen av katalogposten till denne och be om eventuella kommentarer.

När du färdig med uppdateringen klickar du på Publicera. Här är det viktigt att dokumentera vilka ändringar som är gjorda för att kunna följa databeskrivningen över tid. Genom att notera ändringar i meddelandefältet i samband med publicering lämnar du information till ägaren/forskaren för databeskrivningen. Använd anteckningsfunktionen för mer intern dokumentation..

Tänk på att SND inte dubbelgranskar vid uppdateringar av metadata, så hör gärna av dig med frågor via mail om det är något som känns osäkert.

Förfrågningar om data

Här kan du läsa om hur verktyget för att hantera förfrågningar om data fungerar.

För att hantera förfrågningar krävs att data lagras lokalt hos forskningshuvudmannen, antingen på permanent lösning som har koppling till SND:s system eller på lagring som används för den s.k. interimslösningen. Hör gärna av er om ni har frågor om detta länge!

Administration

För att hantera DAU-kontot i DORIS finns ett administrationsverktyg. Detta ligger högst uppe i menyn.

Admin verktyg.png

I fliken DAU listas de personer som har åtkomst till granskningsvyn i DORIS för er organisation. Här kan den som har administratörsrättigheter lägga till och ta bort medlemmar i DAU:en. För att DORIS ska hitta de användare ni söker efter behöver de ha loggat in på Mina sidor någon gång i närtid. När ni lagt till eller tagit bort en medlem uppdateras listan automatiskt, ni behöver inte klicka på Spara längre ner på sidan.

Det är också möjligt att ange vilka e-postadresser som DORIS ska använda, både vad gäller databeskrivningar och för hantering av förfrågningar om data.

För e-postadresser för databeskrivningar gäller följande:

Systemadress = Här kan ni lägga in en funktionsadress som ska användas för de automatiska mail som DORIS skickar, ex. aviseringar av en inkommen databeskrivning. Saknas en systemadress går dessa utskick till alla DAU-medlemmars individuella e-postadresser.

Supportadress = Adress som det ska hänvisas till vid frågor om granskning. Finns exempelvis i det bekräftelsemail som forskaren får vid en inskickad databeskrivning.

Ändringar av e-postadresser behöver sparas.

För e-postadresser för förfrågningar gäller följande: Tills dess att er organisation har egen lagring för de data som delas via SND-katalogen hanteras förfrågningar av SND-kontoret. Ni behöver alltså inte ange något här.


I fliken Huvudman finns information om er organisation. Informationen som finns här kan endast uppdateras av behöriga personer på SND-kontoret och används främst av systemet för att avgöra ex. granskningsflöde.

Följande information finns här:

  • Organisationens namn på svenska och engelska
  • Organisationens ROR ID
  • Domän
  • Hemsida
  • DOI-prefix (Fylls i när organisationen har ett eget DOI-prefix som används för data som delas via DORIS.)
  • Typ av huvudman
  • Egen lagring
  • Hanterar förfrågningar om data (Möjligt när organisationen själva ansvarar för lagring av de data som delas via katalogen.)
  • Granskar databeskrivningar
  • Snabbregistrering aktiv (Möjligt tillval att göra när organisationen har egen lagring integrerad med DORIS, då dessa poster inte uppfyller SND:s certifiering.)