Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Introduzione

I prodotti presenti in archivio hanno dei codici identificativi che servono ad agganciarli alle banche dati degli editori.

...

Warning
titleNota

Questa interfaccia è disponibile solo per coloro che hanno effettuato la sottoscrizione di un account premium con Elsevier o con Clarivate Analytics. 

Info

Per gli atenei che desiderano attivare il servizio legato allo SCOPUS AUTHOR'S ID

Il servizio non ha costi aggiuntivi per gli atenei.

Di seguito trovate le istruzioni per richiederne la configurazione:

  1. Richiedere la API key effettuando il login al link https://dev.elsevier.com/index.jsp quindo cliccare su I want an API Key 
  2. Richiedere l'insttoken (INSTitutional Token) utilizzando il sistema di ticketicng disponibile al seguente link https://service.elsevier.com/app/contact/supporthub/researchproductsapis/?
  3. Specificare il nominativo dell'Istituzione e la API key ottenuta

Riportiamo di seguito un template di esempio:

Subject: Institutional Token request for --Nome Istituzione--

Dear integration support staff,
we would like to receive the insttoken for our Institution
Below the API Key received 
---inserire la API key ottenuta--- 

Looking forward to hear from you soon,

best regards.

--firma--

4. Una volta ottenute le informazioni, aprire un ticket all'Help Desk IRIS per chiederne la configurazione fornendo API Key e INSTTOKEN ricevuti.



I limiti di default di richieste (per settimana, per secondo, etc.) per queste API sono dettagliati qui: https://dev.elsevier.com/api_key_settings.html

Qui le istruzioni intere: https://dev.elsevier.com/tecdoc_api_authentication.html .


Per lo isttoken indicano quanto segue:


Insttoken Authentication

If automatic IP authentication or use of the Authentication API do not meet your requirements,  contact us for more information about obtaining an 'Institutional Token'.

An insttoken is an additional security token submitted in tandem with your APIKey.
Insttokens are only available to customers or partners working on behalf of a customer. If Elsevier grants you an insttoken, there are restrictions to follow:

  1. The insttoken must be kept secure server-side in a password protected environment.
    • It can't appear in any browser side code
    • It can't appear in the address bar
  2. The insttoken represents full access to a customer account within our authentication and entitlements system
    • It may be revoked at any time, without notice
  3. All requests using insttoken must come over https

You submit insttokens in header: X-ELS-Insttoken


Utilizzo dell'interfaccia


L'interfaccia di recupero di identificativi esterni è consultabile accedendo al menu di IRIS e quindi cliccando su Prodotti →  Qualità dell'archivio →  Identificativi.

...

Warning
titleNOTA
È possibile fare in modo che i prodotti appartenenti ad alcune tipologie di prodotto non siano trattate in questo tool. Per attivare questa configurazione è necessario effettuare una richiesta all'Help Desk di IRIS attraverso il Customer Portal.


Attori coinvolti

Questa interfaccia è consultabile dalle seguenti categorie di utenti:

...

Warning
titledalla versione 20.04.02.00

Solo per la Visione Personale, non sono proposte le associazioni per le tipologie che non sono indicizzate da wos e scopus
Di conseguenza, sono prese in considerazione solo le pubblicazioni che appartengono alle seguenti tipologie: 
-Articolo in rivista (262) 
-Contributo in volume (Capitolo o Saggio) (268) 
-Monografia o trattato scientifico (276) 
-Contributo in Atti di convegno (273)


Notifica potenziali match individuati

Quando un utente accede in visione personale al proprio desktop prodotti, se sono presenti potenziali match per le proprie pubblicazioni il sistema mostra una finestrella di notifica in cui è contenuto il numero di potenziali match trovati e il link alla pagina della qualità dell'archivio.


Notifica potenziali pubblicazioni da importare

È possibile attivare un sistema di notifiche che informa gli utenti della presenza di pubblicazioni all'interno del database di Scopus che non sono presenti in Archivio.

...

L'utente potrà importare le pubblicazioni in questione cliccando sul link proposto, oppure andando ad effettuare una submission utilizzando la form di Inserimento nuovo prodotto.

I filtri

Di seguito l'elenco dei filtri che compongono la form di ricerca e il loro significato.

...

View file
nameTipologia_db_bibliografici_label.txt
height400

Tabella dei risultati

I risultati sono presentati in forma tabellare. Le colonne hanno il seguente significato

...

Warning
titleNota
L'opzione Ritenta identificazione è disponibile solo agli amministratori dell'archivio che operano in visione completa.


Modalità di matching

Il recupero degli identificativi avviene in modo differente per WoS e Scopus, come spiegato nel seguito.

...

Warning
titleNota

È possibile specificare una configurazione per cui se l'id recuperato e quello presente differiscono solo per il prefisso allora il sistema lo approva automaticamente. I prefissi gestiti sono i seguenti

per SCOPUS

  • 2-s2.0-

per WOS

  • ISI:
  • WOS:
  • WOS:ISI:

È possibile richiedere l'attivazione di questa configurazione facendo una richiesta all'Help Desk di IRIS attraverso il sistema di ticketing Jira.  


Scopus 

Viene invocato un webservice a cui viene fornito il seguente insieme di metadati dei prodotti:

...

  • Se il servizio trova una pubblicazione e l'identificativo restituito dal servizio COINCIDE con quello presente in IR, l'identificativo del prodotto è considerato corretto e non viene presentato tra le possibili associazioni da validare;
  • Se il servizio trova una pubblicazione e l'identificativo restituito dal servizio NON COINCIDE con quello presente in IR o è assente, il prodotto viene presentato tra i risultati di possibili associazioni da validare;
  • Se il servizio trova più di una pubblicazione viene segnalato un errore; nella descrizione dell'errore sarà disponibile il numero di pubblicazioni restituite;
  • Se il servizio non trova alcuna pubblicazione viene segnalato un errore; la tipologia di errore restituita dall'algoritmo di Scopus sarà una delle seguenti:
    • "No match found for document", "No match found for document and none of the supplied ISSNs were found in the list of Scopus covered ISSNs";
    • "The supplied year is not within the specified publication years range (e.g. 2007-2014). This only applies if a year range restriction is in effect for your account";
    • "Too little data to resolve the request (e.g. less than 3 words in the title and not possible to match on other elements)";
    • "In case a problem in the backend and no match is possible, this means service is required or one should try again";
    • "The key as provided for authentication is not valid";
    • "generic error";

WoS

La ricerca di potenziali identificativi WOS è gestita da una procedura sviluppata internamente ad IRIS.

...

  • Se la proceedura trova una pubblicazione in WOS e l'identificativo trovato COINCIDE con quello presente in IR, l'identificativo del prodotto è considerato corretto e non viene presentato tra le possibili associazioni da validare;
  • Se la proceedura trova una pubblicazione e l'identificativo trovato NON COINCIDE con quello presente in IR o è assente, il prodotto viene presentato tra i risultati di possibili associazioni da validare;
  • Se la proceedura trova più di una pubblicazione viene segnalato un errore; nella descrizione dell'errore sarà disponibile il numero di pubblicazioni restituite;
  • Se la proceedura non trova pubblicazioni viene segnalato un l'errore "No match found for document".

Warning: riga evidenziata in rosso

Se una riga è colorata di rosso trasparente, come nell'immagine sotto, ciò mette in evidenza le associazioni  in cui l'anno è differente oppure il titolo risulta diverso, per tutte le tipologie di match titolo/anno (quindi visibili solo per il filtro "match non sicuro").

Matching non per identificativo bibliografico

Se il match tra l'identificativo di una pubblicazione presente in IRIS e quello restituito dai webservice NON è stato fatto direttamente sull'identificativo bibliografico, allora, anche a parità di identificativo, viene proposta l'associazione. Questo avviene perché il sistema non ha la certezza assoluta che si tratti della stessa pubblicazione.



Frequenza di recupero dei dati

Sia per Scopus che per WoS i dati vengono controllati ogni notte solo per l'istanza di produzione.

...

  • non sono in stato "cancellato";
  • sono "master";
  • sono stati modificati rispetto all'ultima interrogazione della banca dati dell'editore;
  • hanno l'identificativo assente o sprovvisto del prefisso "WOS:" (per WoS) o "2-s2.0-" (per Scopus).

Modalità di recupero dei dati

Scopus

  • Indicatori bibliometrici (SJR, SNIP, CITESCORE): sono forniti con un file excel (consultabile al link https://www.scopus.com/sources) che viene caricato una volta all'anno. Per i dati non disponibili sul file, in accordo con il focus group, viene fatta una proiezione basata sugli ultimi dati disponibili.
  • Percentili: possono essere di rivista o di pubblicazione. I dati mostrati in archivio sono recuperati dai web service dell'editore.
  • Citazioni: i dati mostrati in archivio sono recuperati dai web service dell'editore.
  • Dati bibliografici: i dati sono recuperati dai web service dell'editore. Vengono mostrati in Archivio il Document type e l'anno di pubblicazione.

WoS

  • Indicatori bibliometrici (IMPACT-FACTOR): la CRUI fornisce un file agli Atenei. Come da accordi con il focus group, viene utilizzato il file della CRUI che annualmente ci viene fornito dai nostri Atenei.
  • Percentili: possono essere di rivista o di pubblicazione. WOS non fornisce dei webservice per l’esposizione dei percentili, ma solo il valore assoluto delle citazioni; in accordo con il focus group tavolo ER e Interop.( https://wiki.u-gov.it/confluence/display/REQIRIS/TAVOLO+Interop.+-+Home), si è deciso di calcolarli in IRIS. A tale proposito CRUI è riuscita ad ottenere dal contratto consortile WOS i file con il numero delle citazioni per ogni categoria e il relativo percentile. Periodicamente viene quindi ricalcolato il percentile incrociando il dato del WS con il dato del file fornito dalla CRUI.
  • Citazioni: i dati mostrati in archivio sono recuperati dai web service dell'editore.
  • Dati bibliografici: i sono recuperati dai web service dell'editore. Vengono mostrati in Archivio il Document type e l'anno di pubblicazione.

Aggiornamento dei dati

I dati vengono aggiornati secondo le regole qui descritte.

...

Questo è quanto avviene attualmente all'interno del sistema.

Percentili e quartili 

I percentili forniti dagli editori si possono riferire sia a metriche di pubblicazioni (percentili relativi al numero di citazioni) sia a metriche di rivista (percentili relativi a impact factor o impact factor a 5 anni).

...

  • quello di pubblicazione è presente se la pubblicazione ha il codice WOS e se tale pubblicazione rientra tra i percentili calcolati nell'ultimo trimestre
  • quelli di rivista sono presenti solo se la pubblicazione ha ISSN e anno, e tale coppia è presente nei file dei percentili inviati da WOS.

Casi particolari - Identificativo non citazionale

È possibile che il sistema recuperi un identificativo non citazionale dalla piattaforma WoS di Clarivate.

...

In casi come questo non è possibile accettare o rifiutare l'associazione dell'identificativo con il prodotto. È soltanto prevista la possibilità di eseguire un refresh dell'identificazione.


Esempio d'uso

Di seguito sono forniti una serie di esempi di utilizzo a partire da possibili risultati ottenuti mostrati nell'immagine sottostante.


Esempio 1

L'algoritmo ha trovato un potenziale match.

...

Effettuando una successiva ricerca per potenziali match, quel prodotto non sarà inserito tra i risultati.


Esempio 2

L'algoritmo ha trovato un potenziale match. Il match è stato trovato utilizzando il DOI (icona verde DOI).

...

Se la pubblicazione non è quella presente in IRIS, cliccando su "Respingi associazione" il rifiuto verrà registrato e nella colonna info comparirà la relativa icona. Effettuando una successiva ricerca per potenziali match, quel prodotto non sarà inserito tra i risultati.


Esempio 2.b

È possibile accettare un'associazione di un identificativo dopo che questa è stata respinta.

Per farlo occorre ricercare l'item attraverso il titolo del prodotto, oppure impostando come filtro Status = Associazione respinta e quindi cliccare su Accetta associazione.


Esempio 3

L'algoritmo ha trovato un potenziale match.

...

Warning
titleNota

Gli esempi 1 e 3 non sarebbero stati inclusi tra le possibili associazioni se si fosse attivata la configurazione che prevede di associare automaticamente gli identificativi che differiscono solo per il prefisso.

Esempio 4 e 5

L'algoritmo non ha trovato alcuna pubblicazione all'interno dei database degli editori.

...

Per Wos il messaggio di errore è "Nessuna pubblicazione trovata", mentre per Scopus è "Rivista non indicizzata" (corrisponde all'errore proposto da Scopus "No match found for document", "No match found for document and none of the supplied ISSNs were found in the list of Scopus covered ISSNs").

Sincronizzazioni in errore per determinati anni

È stata implementata la possibilità di richiedere la sincronizzazione di tutte le pubblicazioni in errore per determinati anni (come ad es. per gli anni relativi alla VQR) 
Questo avviene attraverso la configurazione di alcuni job e pertanto va fatta richiesta all'Help Desk tramite Customer Portal.

Importa metadati da banca dati remota

Se si preme sul comando "Importa metadati da banca dati remota" verranno importati tutti campi tranne gli autori (dc.description.allpeopleoriginal).

Confronta metadati

Se si apre il popup di fusione "Confronta metadati", il campo autori (dc.description.allpeopleoriginal) di default non è selezionato tra quelli da importare.

...