Tota la documentació tècnica i d'ús sobre l'eina Integrations Dashboard es pot trobar a: libis/rdm-integration: Integration tool for importing data to Dataverse
Anar a la pàgina de Github (Releases · libis/rdm-integration (github.com)) i descarregar el fitxer executable depenent de la versió del sistema Operatiu que es tingui.
Windows
demo_windows.exe
macOS
Mac amb Intel →
demo_darwin_amd64.binMac amb Apple Silicon (M1/M2/M3) →
demo_darwin_arm64.bin
Linux
demo_linux.bin
Un cop descarregat el fitxer, es pot decidir guardar-lo en una carpeta en concreta o deixar-lo a la carpeta descàrregues. És important saber on està localitzat el fitxer pels propers passos.
Obrir el Terminal del sistema operatiu que s'estigui utilitzant.
Windows
Win→ escriure cmd o PowerShell → Enter
macOS
Launchpad → Altres → Terminal
Linux
Ctrl + Alt + To Aplicacions → Terminal
Per exemple per a Windows:
Al Terminal, cal ubicar-se a la carpeta origen on es troba l'executable.
Comandes comunes
ls # llistar fitxers cd carpeta # entrar a una carpeta
Exemples
- Windows (PowerShell):
cd Desktop\Integrations_Dashboard
macOS / Linux
- cd ~/Desktop/Integrations_Dashboard
Comproveu que hi teniu el fitxer:
- ls
Per exemple, a Windows, la comanda 'ls' + 'tecla Enter' ajuda a saber l'ubicació on es troba l'usuari amb els fitxers o carpetes que hi ha a dins.
Per ubicar-se a la carpeta d'origen, cal anar obrint i movent-se entre carpetes mitjançant la comanda 'cd' + 'Nom de carpeta o Ruta'+ 'tecla Enter'.
Per exemple si volem obrir la carpeta 'Downloads', s'ha d'escriure 'cd Downloads'. Si volem obrir una altra carpeta, s'ha d'escriure la ruta de carpetes separat per '\'.
A la següent imatge, s'ha guardat l'executable a una carpeta amb el nom 'Integrations_Dashboard' que es troba a 'Desktop'. Per tant al terminal s'ha d'escriure: 'cd Desktop/Integrations_Dashboard'+ 'tecla Enter'.
A la imatge anterior, amb la comanda 'ls' es pot veure que hi ha el fitxer 'demo_windows.exe a dins d'aquest directori.
Per executar el programa, per a Mac i Linux s'ha de donar el permís corresponent
macOS / Linux:
chmod +x demo_darwin_amd64.bin
o
- chmod +x demo_darwin_arm64.bin
o
chmod +x demo_linux.bin
Per executar el programa, s'ha d'escriure la següent línia de comandament:
Windows
.\demo_windows.exe -server=https://dataverse.csuc.cat -servername="Repositori Dades de Recerca" -dvID=cat
macOS (Intel)
./demo_darwin_amd64.bin -server=https://dataverse.csuc.cat -servername="Repositori Dades de Recerca" -dvID=cat
macOS (Apple Silicon)
./demo_darwin_arm64.bin -server=https://dataverse.csuc.cat -servername="Repositori Dades de Recerca" -dvID=cat
Linux
./demo_linux.bin -server=https://dataverse.csuc.cat -servername="Repositori Dades de Recerca" -dvID=cat
S’obrirà el navegador amb el Dashboard operatiu.
S'obrirà una finestra o pestanya al navegador d'internet predeterminat:
Al Desplegable 'Data/code source' hi les opcions per escollir la procedència des d'on es transferiran les dades cap al repositori. Cal tenir present que les dades han d'estar ja allotjada a la plataforma de procedència. Aquestes opcions de procedència són:
- Local Filesystem: Sistema d'arxius local d'un ordinador o servidor per emmagatzemar i gestionar dades directament.
- GitHub: Plataforma basada en Git per al desenvolupament de programari col·laboratiu i l'allotjament de codi font.
- GitLab: Entorn DevOps de codi obert per a la gestió de repositoris Git i la integració contínua.
- iRODs: Sistema de gestió de dades distribuït i de codi obert per al control i compartició d'arxius a gran escala.
- REDCap: Plataforma segura de gestió de dades per a la recerca, especialment en l'àmbit biomèdic i acadèmic.
- OSF (Open Science Framework): Plataforma per a la gestió, col·laboració i compartició de projectes de recerca oberta.
- Dataverse: Repositori de dades de recerca que permet la publicació, preservació, cita i compartició de dades.
Depenent de la procedència escollida, es requeriran certes variables com poden ser un Token, URL, nom del repositori entre altres. Totes aquestes variables es refereixen a la de la procedència de les dades i no de l'RDR.
A la pestanya 'Repositori de Dades de Recerca', cal omplir les següents variables:
- Token: Clau secreta única per cada usuari de l'RDR. Com a requisit mínim, l'usuari ha de tenir el rol de Curator o Contributor.
- Dataverse Collection: Instància on es troba el dataset prèviament creat. Es pot cercar amb el nom complet o amb les sigles.
- Dataset DOI: DOI del dataset el qual és cercable a la llista o amb la URL.
Un cop omplertes totes les variables de la procedència i de l'RDR, clicar el botó 'Connect and Compare'
S'actualitzarà la pàgina i es mostraran dues columnes amb els noms del fitxers. A la columna de la esquerra hi apareixen els fitxers que es troben a la font de procedència i a la columna de la dreta hi apareixen els fitxers que es troben al dataset a RDR si és que n'hi hagi.
- Si es vol transferir un fitxer des de la procedència s'ha de clicar el requadre, es tornarà en color verd i apareixerà a l'altre columna.
- Si es vol reemplaçar un fitxer amb el mateix nom, s'ha de clicar el requadres, es tornarà en color blau i a l'altre columna el nom apareixerà en negreta.
- Si es vol suprimir un fitxer del dataset, s'ha de clicar el requadre, es tornarà en color vermell i el nom apareixerà ratllat.
- Si no es vol transferir un fitxer, no s'ha de clicar res.
- Si existeix una estructura de carpetes, també es possible transferir, esborrar o remplaçar tots els fitxers a dins clicant una única vegada.
Clicar 'Submit' per guardar els canvis al repositori. A continuació apareixeran els canvis que es realitzaran:
Clicar 'Submit' novament i el missatge 'Click on "OK" to start the update/transfer. You can close the window and the transfer will continue.'. Si hi esteu d'acord, clicar OK.
Esperar que es realitzin tots el canvis, i s'actualitzarà la pàgina amb els canvis fets. També hi ha l'opció d'anar al dataset clicant el botó 'Go to dataset'.
