| Table of Contents |
|---|
Introduzione
L'ODS di IRIS è uno schema su database che raccoglie i dati di tutti i moduli della piattaforma.
Due sono i livelli: L0 (base per uso tecnico) contiene i dati raccolti dai moduli e non elaborati, mentre L1 (vista per l'utente) contiene i dati elaborati da procedure, in modo che siano più puliti e facili da consultare.
Il livello L0 è prettamente tecnico e, sebbene visibile, non prevede assistenza, in quanto tutte le informazioni utili sono contenute in L1. L0, in particolare, contiene i dati grezzi ed il suo uso è finalizzato a situazioni che richiedono esperti tecnici Cineca su progetti ad-hoc (es. integrazione tra sistemi). Tuttavia si è deciso di rendere anche L0 consultabile per chi lo ritenesse necessario con il relativo allegato tecnico IRIS-ODS-IR-L0-Modello.pdf. Per un dizionario dei campi contenuti in ODS e le relative dimensioni e misure in BI si può fare riferimento all'allegato: Dizionario IRIS-ODS-BI.xlsx.
Il modello ODS è suddiviso in aree corrispondenti ai moduli di riferimento: IR, AP e RM.
La pagina ODS Livello 1 modulo IR riporta la documentazione relativa allo strato L1 del modulo IR.
La pagina ODS Livello 1 modulo AP riporta la documentazione relativa allo strato L1 del modulo AP.
La pagina ODS Livello 1 modulo RM riporta la documentazione relative alle entità del modulo RM: persone, unità organizzative, gruppi di ricerca, etc.
Quick Guide
Lo schema si articola intorno all’entità principale del prodotto IR_ITEM.
Le responsabilità autoriali nella realizzazione del prodotto sono rappresentate nelle due forme ODS_L1_IR_ITEM_CONTRIBUTOR (che elenca gli autori) e ODS_L1_IR_ITEM_CON_PERSON (che riporta la relazione di responsabilità degli autori riconosciuti sull’anagrafica di ateneo).
Le altre viste riportano gli attributi del prodotto suddivisi per “element”.
ODS_L1_IR_ITEM: è una vista che riporta per ciascun ITEM i metadati salienti (classificazione, titolo, data e sede di edizione).
Il contenuto della vista ODS_L1_IR_ITEM rappresenta l’intera popolazione di ITEM censiti in IR, incluse eventuali versioni provvisorie e deprecate.
Le due viste: ODS_L1_IR_ITEM_MASTER e ODS_L1_IR_ITEM_MOST_VALIDATED possono essere utilizzate per accedere alle versioni “master” o “most validated” di un ITEM.
La vista ODS_L1_IR_ITEM_MASTER contiene la versione "master" dell’item, ovvero soddisfa le seguenti condizioni:
- sono esclusi i ritirati [withdrawn=0];
- sono esclusi quelli in stato bozza oppure respinti [workflow_validation_status in (0, 1, 3, 4, 5)];
- la versione è quella “master” [is_master=1].
Effettuando l’incrocio con le tabelle dei metadati (sull’item_id che si trova in questa vista) si troveranno quindi gli ultimi metadati inseriti in IR.
La vista ODS_L1_IR_ITEM_MOST_VALIDATED contiene la versione “più validata” dell’item, ovvero soddisfa le seguenti condizioni:
- sono esclusi i ritirati [withdrawn=0];
- sono esclusi quelli in stato bozza/respinti [workflow_validation_status in (0, 1, 3, 4, 5)];
- la versione è quella “più pubblicata” [is_most_validated=1].
In questo caso non ha senso parlare di "riaperto" perché, per un prodotto "riaperto" viene automaticamente presa la versione più validata prima che il prodotto venisse riaperto.
La logica per il recupero della versione più pubblicata era quella presente in BI, ovvero tra più versioni viene scelta
(in ordine di priorità la prima che viene trovata):
- versione master in stato pubblicato (wf_validation_status 0 o 1)
- versione snapshot in stato pubblicato (wf_validation_status 0 o 1)
- versione più recente in stato workflow step 3 (wf_validation_status 5)
- versione più recente in stato workflow step 2 (wf_validation_status 4)
- versione più recente in stato workflow step 1 (wf_validation_status 3)
Effettuando l’incrocio con le tabelle dei metadati (sull’item_id che si trova in questa vista) si troveranno quindi i metadati di IR come venivano visualizzati in BI.
ODS_L1_IR_ITEM_CON_PERSON: è una vista che riporta i dati relativi al ruolo della persona (RM PERSON) in qualità di autore di un determinato prodotto.
Le fonti principali sono ODS_L0_IR_ITEM_CONTRIBUTOR e ODS_L1_RM_PERSON.
I dati presenti in questa vista vengono caricati a partire da ODS_L0_IR_ITEM_CONTRIBUTOR con dc.element = "authority" ed in cui il value sia una PERSON di RM (CONTRIBUTOR.AUTHORITY=PERSON.PID).
Le viste che seguono contengono gli attributi del prodotto:
ODS_L1_IR_ITEM_DATE è la vista che riporta tutte le date significative relative al prodotto.
ODS_L1_IR_ITEM_DESCRIPTION è la vista che riporta i ruoli della persona.
ODS_L1_IR_ITEM_IDENTIFIER è la vista che riporta i diversi identificativi del prodotto.
ODS_L1_IR_ITEM_LANGUAGE è la vista che riporta le diverse lingue del prodotto.
ODS_L1_IR_ITEM_LOGINMIUR è la vista che riporta le informazioni relative alla sincronizzazione del prodotto con i sistemi ministeriali.
ODS_L1_IR_ITEM_PUBLISHER è la vista che riporta le informazioni relative all’editore del prodotto.
ODS_L1_IR_ITEM_RELATION è la vista che riporta le informazioni relative agli attributi qualificati dall’Element ”relation”, come ad esempio la denominazione della conferenza di un contributo in atti di congresso o le informazioni relative all’edizione.
ODS_L1_IR_ITEM_SUBJECT è la vista che riporta le informazioni relative a SSD e keyword del prodotto.
ODS_L1_IR_ITEM_TYPE è la vista che riporta le informazioni relative alle diverse indicazioni di tipi, classificazioni o indici di riferimento del prodotto.
ODS_L1_IR_ITEM_UGOV è la vista che riporta le informazioni derivanti dalla migrazioni dati dal sistema UGov.
ODS_L1_IR_ITEM_WORKFLOW è la vista che riporta le informazioni relative al processo di validazione del prodotto.
ODS_L1_IR_ITEM_SCO_CUR è la vista contenente i dati bibliometrici di Scopus recuperati tramite Webservice (per chi possiede le API Premium) o tramite incrocio con i dati bibliometrici distribuiti su file (snip, sjr, ipp). I dati dei percentili si riferiscono all’ultimo trimestre recuperato.
ODS_L1_IR_ITEM_WOS_CUR è la vista contenente i dati bibliometrici di WOS recuperati tramite Webservice (per chi possiede le API Premium) o tramite incrocio con i dati bibliometrici distribuiti su file (impact factor).
ODS_L1_IR_ITEM_FULLTEXT è la vista che riporta gli allegati del prodotto. Fonti principali sono le tabelle BUNDLE e BITSTREAM.
ODS_L1_IR_ITEM_EVENT_LOG è la va vista riporta lo storico degli eventi registrati dal sistema per ciascun prodotto.
ODS_L1_IR_ITEM_DATA è la vista che riporta metadati accessori non presenti nelle altre tabelle.
| Note | ||||
|---|---|---|---|---|
| ||||
Il filtro "modalità incrocio con le afferenze" vuol dire:
Questo filtro si applica solo nel caso in cui non si specificano altri filtri sulle afferenze (ruolo/dipartimento/etc.). Infatti,nel caso in cui vengano indicati uno o più filtri di questo tipo, allora in entrambi i casi il numero di pubblicazioni sarà lo stesso, in quanto avere imposto un filtro sull'afferenza elimina per forza tutte le pubblicazioni che non rispettano questo filtro. Il sistema si comporterà quindi come se fosse selezionata la voce "solo pubblicazioni in cui almeno un contributor ha afferenza valida". |
Dalla versione di IRIS 18.10.00.00
Con il primo rilascio di Ottobre 2018 sono state aggiunte due viste: ODS_L1_IR_ITEM_MASTER_ALL e ODS_L1_IR_ITEM_MOST_VAL_ALL.
Esse presentano i dati master/most validated.
Comprendono anche pubblicazioni in BOZZA/RIAPERTO/RESPINTE o cancellate (normalmente non mostrate nelle strutture finora utilizzate).
Le precendenti viste (ODS_L1_IR_ITEM_MASTER e ODS_L1_IR_ITEM_MOST_VALIDATED) non sono state alterate, quindi presentano gli stessi dati di sempre.
Con questo rilascio sono stati aggiunti in ODS_L1_RM_PERSON:
- KEYWORD_ATECO_CONCAT VARCHAR2(4000 CHAR)
- KEYWORD_ATECO_COUNT NUMBER(10,0)
- KEYWORD_ERC2013_CONCAT VARCHAR2(4000 CHAR)
- KEYWORD_ERC2013_COUNT NUMBER(10,0)
- KEYWORD_ERC2016_CONCAT VARCHAR2(4000 CHAR)
- KEYWORD_ERC2016_COUNT NUMBER(10,0)
- KEYWORD_ISICRUI_CONCAT VARCHAR2(4000 CHAR)
- KEYWORD_ISICRUI_COUNT NUMBER(10,0)
- KEYWORD_USER_DEFINED_CONCAT VARCHAR2(4000 CHAR)
- KEYWORD_USER_DEFINED_COUNT NUMBER(10,0)
Dalla versione 18.10.00.00 sono inoltre state rese disponibili su ODS le tabelle ODS_L1_RM_PERSON_TUTORSHIP e ODS_L1_RM_PERSON_ACTIVITIES.
La tabella ODS_L1_RM_PERSON_TUTORSHIP presenta come colonne:
- RM_PERSON_LINK_ID NUMBER(10,0), chiave primaria
- DISCRIMINATOR VARCHAR2(255),
- RM_PERSON_PARENT_ID NUMBER(10,0),
- RM_PERSON_PARENT_FIRST_NAME VARCHAR2(4000),
- RM_PERSON_PARENT_LAST_NAME VARCHAR2(4000),
- RM_PERSON_CHILD_ID NUMBER(10,0),
- RM_PERSON_CHILD_FIRST_NAME VARCHAR2(4000),
- RM_PERSON_CHILD_LAST_NAME VARCHAR2(4000),
- TUT_START_DATE TIMESTAMP(6), per startDate
- TUT_END_DATE TIMESTAMP(6), per endDate
- TUT_TYPE_ID NUMBER(10,0), per type
- TUT_TYPE_DES VARCHAR2(4000), per type
- TUT_NAME VARCHAR2(4000), per name
- TUT_DESCRIPTION VARCHAR2(4000), per description
- TUT_MANAGED_BY VARCHAR2(4000), per managedBy.
La tabella ODS_L1_RM_PERSON_ACTIVITIES ha colonne:
- RM_PERSON_ELEM_ID NUMBER(10,0), chiave primaria
- RM_PERSON_ID NUMBER(10,0),
- DISCRIMINATOR VARCHAR2(255),
- ACT_TYPE_ID NUMBER(10,0), per iaType, externalTutorshipType, incomingType, networkType
- ACT_TYPE_DES VARCHAR2(4000), per iaType, externalTutorshipType, incomingType, networkType
- ACT_START_DATE TIMESTAMP(6), per startDate
- ACT_END_DATE TIMESTAMP(6), per endDate
- ACT_YEAR NUMBER(10,0), per year
- ACT_CYCLE VARCHAR2(4000), per cycle
- ACT_DESCRIPTION VARCHAR2(4000), per description
- ACT_EXT_ORG_ID NUMBER(10,0), per miurExternalOrganization
- ACT_EXT_ORG_DES VARCHAR2(4000), per miurExternalOrganization
- ACT_EXT_ORG_TYPE_DES VARCHAR2(4000), per miurExternalOrganization
- ACT_INTERNATIONAL_RELEVANCE NUMBER(1,0), per internationalRelevance
- ACT_MANAGED_BY VARCHAR2(4000), per managedBy
- ACT_NAME VARCHAR2(4000), per name
- ACT_OTHER_INFO VARCHAR2(4000), per otherInfo
- ACT_PHD_COURSE_ID NUMBER(10,0), per phdCourse
- ACT_PHD_COURSE_DES VARCHAR2(4000), per phdCourse
- ACT_PROJECT_NAME VARCHAR2(4000), per projectName
- ACT_ROLE_TYPE_ID NUMBER(10,0), per rnpRoleType
- ACT_ROLE_TYPE_DES VARCHAR2(4000), per rnpRoleType
- ACT_TUTOREE VARCHAR2(4000), per tutoree - stringa
- ACT_TUTOREE_ID NUMBER(10,0), per tutoree - person
- ACT_TUTOREE_FIRST_NAME VARCHAR(4000), per tutoree - person
- ACT_TUTOREE_LAST_NAME VARCHAR(4000), per tutoree - person
- ACT_URL VARCHAR2(4000), per url
- ACT_AP_ITEM_SOURCE_ID NUMBER(10,0), per apItemSourceId
- ACT_AP_ITEM_SOURCE_IDE VARCHAR2(4000), per apItemSourceIdentifier.
Reportistica&Analisi
Nella tendina "tipologia di metadati da estrarre" è ora possibile scegliere:
- master: ultimi dati inseriti, non necessariamente approvati (esclusi ritirati, bozze e riaperti)
- più validati: ultimi dati inseriti e approvati (esclusi ritirati e bozze)
- master: ultimi dati inseriti, non necessariamente approvati (compresi ritirati, bozze e riaperti)
- più validati: ultimi dati inseriti e approvati (compresi ritirati e bozze)
Le prime due possibilità erano già presenti, ma è stato cambiato il nome per renderle più comprensibili. Le ultime due danno l'accesso alle due nuove strutture.
Inoltre è stato aggiunto il filtro "prodotti ritirati" con le voci:
- non visualizzare i ritirati (default)
- visualizza solo i ritirati
- visualizza tutto
Per visualizzare lo stato "bozza - riaperto" sarà necessario attendere il primo "sync completo" (normalmente avviene il primo sabato dopo l'installazione).