La pagina è in corso di revisione per l'adeguamento dei contenuto alla versione DS6: le informazioni contenute potrebbero non essere corrette.

Importazione pubblicazioni da LoginMiur

=========================== Parte tecnica, da rivedere========================


Attraverso un'apposita configurazione è possibile non evidenziare (in rosso) le pubblicazioni recuperate da LoginMiur che risultano già censite in IRIS. Gli Atenei interessati a questa configurazione devo inviare una richiesta al  Service Desk di IRIS attraverso il Customer Portal.




Variabili e risorse da configurare


IT_CINECA_ALESSANDRIAMIUR_IMPORT_DEFAULT_STATUS_PROVVISORIO (default: false)
se impostata a false, consente di visualizzare il menù a tendina per la selezione provvisorio/definitivo, per ogni singolo prodotto (colonna azioni nella tabella dei risultati). Se impostata a true la colonna azioni non viene visualizzata e tutti i prodotti sono impostati in stato provvisorio.

IT_CINECA_ALESSANDRIAMIUR_IMPORT_CUSTOM_ATENEO=XXX_MODIFIER (ad es. UNIBG_MODIFIER)
Mappatura custom dei metadati delle tipologie Miur/IRIS

IT_CINECA_ALESSANDRIAMIUR_IMPORT_FORCE_SHOW_COLLECTION (default: false)
Permette di importare le pubblicazioni anche sulle tipologie ad esaurimento

funzionalità aggiuntive ("Widget - /ir/importBatchMiurAdminPanel")
Disabilita authority

In presenza di pubblicazioni da importare che hanno un elevato numero di autori interni (>1000) l'import va in errore perché troppo oneroso. Quando una pubblicazione viene importata viene controllata la stringa autori e per ciascun elemento viene interrogata l'anagrafica dell'Archivio per verificare a quali autori interni attribuire la pubblicazione. Spuntando questa checkbox è possibile inibire il controllo sulla stringa autori. In questo modo la pubblicazione importata viene attribuita solo all'autore per cui si sta eseguendo l'import che sarà il responsabile del dato. Gli altri autori interi potranno riconoscersi manualmente.

Numero di pubblicazioni per chiamata

In caso di troppe pubblicazioni o tante pubblicazioni con molti autori interni, l'import va in errore. E' stato verificato dallo sviluppo che problemi come questi sono risolvibili diminuendo il numero di pubblicazioni per ciascuna chiamata effettuata verso LoginMIUR. Il numero di pubblicazioni importate per ciascuna chiamata di default è 20. Se in quelle 20 pubblicazioni ci sono 2 o più "pesanti", l'import va in errore e viene bloccato. Diminuendo il numero di chiamate diminuisce la probabilità che in una chiamata ci siano più pubblicazioni pesanti. Solitamente quando il sistema va in errore si diminuisce il numero di pubblicazioni per chiamata a 10, successivamente a 5 e cosi via fino ad arrivare a 1 pubblicazione per chiamata (caso estremo). Se nonostante la diminuzione del numero di pubblicazioni per chiamata l'import va in errore occorre aprire un ticket alla fabbrica.


Interfaccia di monitoraggio import

È disponibile un interfaccia di monitoraggio degli import di prodotti da LoginMIUR. L'interfaccia è disponibile SOLO agli amministratori dell'Archivio che accedono in visione completa portandosi in Configurazione, Sincronizzazioni, Log importazioni MIUR. In essa sono contenuti tutti gli eventi relativi agli import di prodotti da LoginMIUR.

L'interfaccia si compone di una form di ricerca e di una tabella in cui sono mostrati i risultati.
Si può ricercare per:

Alessandria id: attraverso questo campo è possibile cercare i prodotti utilizzando l'identificativo che hanno in LoginMIUR;
Item Id: attraverso questo campo è possibile cercare i prodotti utilizzando l'identificativo (UUID) che hanno in IRIS;
Persona: attraverso questo campo è possibile cercare i prodotti utilizzando il nome della persona;

I risultati mostrano i dati raggruppati per le seguenti colonne:

Alessandriaid: rappresenta l'identificativo del prodotto in LoginMIUR;
Item Id: rappresenta l'identificativo del prodotto in IRIS (UUID). È un link che rimanda al backoffice del prodotto importato in Archivio;
Import effettuato da: Nome, UserId e EPersonId dell'utente che ha effettuato l'import;
Data import: indica la data in cui è stato eseguito l'import del prodotto;
Stato: indica lo stato (provvisorio/definitivo) del prodotto;

=============================================

Introduzione

Attraverso questa funzionalità l'Amministratore dell'archivio, che opera in visione completa, può importare in IRIS le pubblicazioni di un docente che risultano censite nel portale LoginMiur.

Cliccando sul pulsante "Nuovo prodotto" (posizionato in alto a sinistra del desktop prodotti) si apre la pagina di inserimento di una nuova pubblicazione.


Gli atenei che desiderano effettuare importazioni da Miur in autonomia dovranno aprire un apposito ticket all'help desk IRIS facendo richiesta di abilitazione del pulsante "nuovo prodotto" in VISIONE COMPLETA, che è ciò che consente agli amministratori di eseguire la procedura.


All'interno della maschera di importazione "Ricerca per identificativo (DOI, PubMed ID, Scopus ID) è presente la sezione dedicata all'importazione da MIUR (come da immagine sottostante). 


Per poter avviare l'importazione delle pubblicazioni dal Sito Docente è necessario indicare il codice fiscale del docente e cliccare sul pulsante "Cerca".  




La ricerca è permessa per singolo codice fiscale. Inoltre, il codice fiscale indicato deve appartenere a personale interno all'Ateneo. 

Si invita a prestare attenzione al codice fiscale indicato e verificare che questo appartenga a utenti con rapporto di lavoro attivo presso l'Ateneo.


Scheda "Risultati"

Come anticipato sopra, per avviare l'interrogazione della baca dati del Sito Docente e recuperare le pubblicazioni è necessario indicare il codice fiscale del docente e cliccare sul pulsante "Cerca".  Le pubblicazioni recuperate  sono esposte nella nella scheda "Risultati" in forma tabellare.

 La pagina visualizzata è strutturata in quattro sezioni:

Gli avvisi presenti ricordano all'utente che:





E' possibile modificare il testo dei messaggi attraverso il tool Gestione Etichette utilizzando le seguenti chiavi:


ChiaveValore etichetta

jsp.submit.start-lookup-submission.importmiur.policy.label

Importazione allegati provenienti da MIUR
jsp.submit.start-lookup-submission.importmiur.policy.descriptionImportando i dati in IRIS, i dati presenti nel singolo spazio docente verranno condivisi con i coautori della pubblicazione
jsp.submit.start-lookup-submission.importmiur.log.labelMonitoraggio importazione
jsp.submit.start-lookup-submission.importmiur.log.descriptionil log delle importazioni miur si trova sotto il menu configurazione -> sincronizzazioni -> log importazione miur
jsp.submit.start-lookup-submission.importmiur.collection-alternative-disclaimer.label=Tipologia Ministeriale
jsp.submit.start-lookup-submission.importmiur.collection-alternative-disclaimerPoichè alcune tipologie ministeriali sono mappate su più tipologie IRIS, è sempre necessaria la verifica della corretta mappatura cliccando sul menù a fianco (sx) di TIPOLOGIA MIUR. Il default è la prima tipologia indicata nella lista IRIS




======================================


Tabella dei risultati

I risultati trovati a seguito dell'interrogazione di LoginMIUR sono raccolti in una tabella le cui colonne hanno il seguente significato:

Form di ricerca

Al fine di facilitare gli amministratori nell'import di grandi quantità di prodotti, è stata inserita una form di ricerca che permette di filtrare i risultati ottenuti.



Inserendo del testo nella form vengono automaticamente filtrati i risultati. Cancellando il testo inserito vengono visualizzati tutti i risultati disponibili. I campi su cui agisce la form di ricerca sono miur id, titolo, anno, autori.
È inoltre possibile ordinare i risultati per data di pubblicazione e per titolo in ordine crescente o decrescente utilizzando gli appostiti tasti posti di fianco alla form di ricerca.

Azioni possibili

Attraverso la pulsantiera posta sotto la form di ricerca è possibile eseguire diverse azioni sui risultati trovati. In particolare

Funzionamento

Di seguito viene spiegato il funzionamento dell'interfaccia attraverso l'utilizzo di alcuni esempi pratici. Dopo aver inserito un codice fiscale valido nella form di ricerca, cliccando su Cerca si interroga LoginMIUR. A partire dal codice fiscale fornito, sono recuperati i prodotti presenti in LoginMIUR. I risultati ottenuti sono incrociati con i dati presenti in Archivio e se non ci sono match i prodotti sono presentati come nuovi; altrimenti viene segnalata la presenza di prodotti in Archivio. I metadati che sono controllati per il match sono in ordine AlessandriaID, DOI, PubMed, Scopus Id e Wos id, Titolo della pubblicazione. Quando viene trovato un match gli altri identificativi non sono controllati.

Attraverso le icone presenti nella colonna importa della tabella dei risultati, è possibile scegliere le azioni da eseguire sui risultati ottenuti dall'interrogazione di LoginMIUR. Le icone hanno il seguente significato:

Inizialmente, nessun prodotto è marcato come da importare.

Se un prodotto non è presente in Archivio viene presentato come nuovo prodotto. Cliccando sull'icona nella colonna importa il prodotto sarà marcato come da importare; cliccando nuovamente il prodotto sarà marcato come da non importare.

Se un prodotto è già presente in Archivio viene presentato come da non importare. Cliccando sull'icona nella colonna importa il prodotto sarà marcato come da importare.

Cliccando sul pulsante ripristina vengono annullate le azioni eseguite e i risultati sono presentati come dopo l'interrogazione da LoginMIUR.

Nuova pubblicazione

Quando a seguito di un'interrogazione su LoginMIUR viene trovato un prodotto che non è presente in Archivio, viene presentato un record come nuovo prodotto da importare.



Il record viene presentato con il tasto fatto a forma di download nella colonna importa e con il valore nuova nella colonna corrispondenza trovata.

Import

Per importare il record occorre cliccare sul tasto importa. L'icona a forma di download si trasforma in una spunta verde e indica che il prodotto è stato marcato per essere importato.



Cliccando sul tasto verde Importa i record selezionati, posto a fianco della pulsantiera o in fondo alla tabella dei risultati, il prodotto verrà importato in Archivio e si viene rediretti sul proprio Desktop Prodotti. L'import viene eseguito in batch. Per visualizzare lo stato di avanzamento dell'import, è possibile eseguire il login as come l'autore di cui si è effettuato l'import. Nel desktop prodotti dell'autore di cui si è fatto l'import compariranno progressivamente i prodotti importati. Ogni prodotto importato è già ricercabile all'interno dell'Archivio attraverso la form di ricerca base e quella avanzata. Per poter essere utilizzato all'interno del modulo BI occorre attendere la sincronizzazione dei dati secondo le modalità descritte nella documentazione di seguito Reportistica#ModuloBI.

 

Nel caso si import di grandi quantità di prodotti è possibile controllare l'esito attraverso la form di monitoraggio, descritta di seguito.

Scelta tipologia

Attraverso il menu a tendina presente nella colonna tipologia è possibile scegliere la tipologia di documento nella quale sarà importato il prodotto. Il menu a tendina è popolato con le tipologie di Documento presenti in Archivio. Il valore proposto corrisponde a quello trovato su LoginMIUR. Ulteriori dettagli sulla mappatura tra le tipologie di documento presenti in IRIS e quelle di LoginMIUR è disponibile al seguente indirizzo Institutional Research Information System (IRIS).

Scelta stato

Attraverso il menu a tendina della colonna azioni è possibile scegliere lo stato in cui sarà importato il prodotto selezionato. Scegliendo Provvisorio il prodotto sarà importato nello stato bozza. Questo significa che l'autore per cui è stato fatto l'import dovrà completare la submission, al termine della quale il prodotto seguirà il normale workflow previsto dall'Archivio. Se viene scelto Definitivo, il prodotto sarà importato in stato definitivo. L'autore per cui è stato fatto l'import non dovrà completare la submission. Nel caso sia attivo un workflow di validazione il prodotto sarà posto nello stato in validazione.

È possibile nascondere la visualizzazione di questa colonna. In questo caso tutti i prodotti importati saranno posti di default nello stato Bozza. Per attivare questa configurazione è necessario fare una richiesta all'Help Desk di IRIS attraverso il sistema di ticketing Jira.


Rifiuto

Se non si vuole importare una pubblicazione occorre cliccare sull'icona della colonna importa fino a far comparire il simbolo di divieto, in questo modo il prodotto selezionato non verrà importato in Archivio.



Cliccando sul tasto verde Importa i record selezionati, posto a fianco della pulsantiera o in fondo alla tabella dei risultati, il prodotto non verrà importato in Archivio. Se successivamente si effettuerà una nuova ricerca il prodotto verrà nuovamente mostrato come potenziale prodotto da importare.

Pubblicazione presente in Archivio

Quando viene trovato un match tra i prodotti presenti in LoginMIUR e quelli presenti in Archivio, il prodotto viene segnalato come da non importare.



Nella colonna corrispondenza trovata sono riportati i seguenti dati

Significato del campo note

Nel caso in cui sia stato trovato un match tra il prodotto da importare e quelli presenti in Archivio (AlessandriaID, DOI, PubMed, Scopus Id, Wos id e Titolo del prodotto), viene controllata la stringa autori del prodotto presente in Archivio per verificare che l'autore per cui si sta eseguendo l'import sia presente o meno. I risultati ottenuti da questo controllo sono riportati nel campo note. I casi possibili sono i seguenti:

  1. la persona è già presente nella stringa autori della pubblicazione trovata: all'interno dell'Archivio è presente una pubblicazione la cui stringa autori contiene il nominativo dell'autore per cui si sta eseguendo l'import. L'autore per cui si sta eseguendo l'import compare tra gli autori interni del prodotto. In questo caso non viene eseguita nessuna azione;
  2. la persona è già presente nella stringa autori della pubblicazione trovata ma non ancora riconosciuta: all'interno dell'Archivio è presente una pubblicazione la cui stringa autori contiene il nominativo dell'autore per cui si sta eseguendo l'import. L'autore per cui si sta eseguendo l'import NON compare tra gli autori interni del prodotto. In questo caso viene eseguita una richiesta di riconoscimento per l'autore di cui si sta eseguendo l'import utilizzando il nominativo contenuto nella stringa autori del prodotto presente in Archivio;
  3. la persona è stata aggiunta nella stringa autori della pubblicazione trovata: all'interno dell'Archivio è presente una pubblicazione la cui stringa autori NON contiene il nominativo dell'autore per cui si sta eseguendo l'import. L'autore per cui si sta eseguendo l'import NON compare tra gli autori interni del prodotto. In questo caso viene eseguita una richiesta di riconoscimento per l'autore di cui si sta eseguendo l'import aggiungendo il nominativo dell'autore alla stringa autori del prodotto presente in Archivio;
  4. non è stato possibile recuperare le informazioni sulla stringa autori: all'interno dell'Archivio è presente una pubblicazione per cui non è stato possibile trovare la stringa autori. In questo caso si tratta di un errore che va gestito con il supporto dell'Help Desk di IRIS;

Per i casi 2 e 3, anche se il prodotto rimane escluso dall'import (icona a forma di divieto), viene creata una richiesta di autoriconoscimento dell'autore sul prodotto in oggetto. Nel caso 3 viene modificata la stringa autori del prodotto in oggetto aggiungendo il nominativo dell'autore di cui si sta effettuando l'import.

Al momento di un import, eventuali coautori NON vengono avvisati con una notifica email, ma troveranno nel tab del desktop "autoriconoscimenti da validare" i prodotti che sono stati appena importati.



È possibile modificare la configurazione per fare in modo che i potenziali match non siano segnalati. Per attivare questa configurazione è necessario fare una richiesta all'Help Desk di IRIS attraverso il sistema di ticketing Jira.


Match per titolo

Nel caso in cui il match per titolo abbia acuto un esito positivo nel campo Sorgente comparirà il valore Title. il testo del campo note assumerà i seguenti valori:


In questo caso NON viene effettuata alcuna modifica sulla stringa autori e NON vengono generate richieste di autoriconoscimento.


Pubblicazione già importata e sincronizzata

Nel caso in cui il sistema rileva la presenza di una pubblicazione presente in Archivio che è stata precedentemente importata attraverso la funzionalità di import da LoginMIUR e quindi sincronizzata con LoginMIUR, ne segnala la presenza. La pubblicazione è marcata come presente in Archivio e da non importare (simbolo divieto nel campo Importa). Inoltre nel campo Corrispondenza trovata sarà indicata come sorgente "codice Miur" e come note "il prodotto risulta già importato e sincronizzato".



Autoriconoscimento

Nei casi 2 e 3 trattati nel paragrafo Import di prodotti da LoginMIUR se l'autore per cui si sta effettuando l'import delle pubblicazioni da loginMIUR si riconosce su una pubblicazione già presente in Archivio, ma non nella sua pagina LoginMIUR, allora questo provocherà la duplicazione della pubblicazione sulla pagina LoginMIUR.

A questo punto l'autore dovrà andare a sanare la situazione sulla propria pagina personale di LoginMIUR cancellando la pubblicazione duplicata.

Esempio:

Il docente Mario Rossi su LoginMIUR ha 2 pubblicazioni:

In fase di import da LoginMIUR si accorge che in IRIS c'è già una pubblicazione dal titolo "Ossigenoterapia" e AlessandriaID = 102.

Quando il riconoscimento sarà confermato il prodotto sarà sincronizzato su loginMIUR e avendo un identificativo differente dalle altre pubblicazioni presenti sulla pagina del ricercatore, sarà aggiunto alla stessa. A questo punto il ricercatore dovrà eliminare la pubblicazione aggiunta sulla sua pagina decidendo quale delle due tenere.




Interfaccia di monitoraggio import

È disponibile un interfaccia di monitoraggio degli import di prodotti da LoginMIUR. L'interfaccia è disponibile SOLO agli amministratori dell'Archivio che accedono in visione completa portandosi in Configurazione, Sincronizzazioni, Log importazioni MIUR. In essa sono contenuti tutti gli eventi relativi agli import di prodotti da LoginMIUR.

L'interfaccia si compone di una form di ricerca e di una tabella in cui sono mostrati i risultati.



Form di ricerca

I campi che compongono la form di ricerca sono i seguenti:

Tabella dei risultati

Le colonne che compongono la tabella dei risultati hanno il seguente significato: