Questa sezione dettaglia il modello dati dell'entità ricalcando la struttura del form di raccolta dati.

Per ogni TAB viene visualizzata una tabella che riporta le seguenti colonne:
Oggetto Widget Attributo Tipo Dato Etichetta e Descrizione
Indica l'oggetto di riferimento
  • Se uguale a root vuol dire che l'attributo specificato è relativo all'oggetto radice corrente
  • Se diverso da root vuol dire che l'attributo specificato è relativo ad un oggetto figlio dell'oggetto radice corrente, che è individuato dall'identificativo riportato
 Indica il tipo di widget usato per il rendering dell'attributo (text, select, tree, ....) Indica il nome dell'attributo
L'eventuale nome riportato tra parentesi indica il nome dell'attributo esposto nel servizio REST nella vesione FULL
Per maggiori dettagli consultare IRIS FAST REST Services - GW (Gateway) REST API v.1
Indica il tipo dell'attributo Riporta l'etichetta e l'eventuale descrizione estesa.
Per ogni attributo, oltre all'etichetta "label." (obbligatoria) è possibile prevedere la corrispettiva "info." (opzionale)
Le etichette "info." servono per visualizzare degli "hint" contestuali sul significato dello specifico campo.
Nel caso in cui l'attributo agganci dizionari, unità organizzative, o item di altre tipologie vengono riportate le seguenti informazioni aggiuntive:
  • Dizionario collegato
    Viene riportato l'identificativo del dizionario e la sua descrizione.
    Queste informazioni consentono di individuare le voci di dizionario nell'interfaccia amministrativa dei dizionari di IRIS RM e AP disponibile al seguente percorso Configurazione ==> Gestione dizionari.
    In questa sezione è possibile, se abilitato, procedere alla modifica, inserimento o cancellazione di voci di dizionari.
  • Oggetto collegato
    Viene riportato l'identificativo dell'oggetto collegato
    Si tratta tipicamente di unità organizzative o tipi di entità diffenti da quella corrente.
    Ad esempio ad un progetto è possibile agganciare
    • un dipartimento (organizationUnit di tipo department) recuperato da IRIS RM Risorse ==> Strutture interne
    • un centro di ricerca (organizationUnit di tipo researchCenter) recuperato da IRIS RM Risorse ==> Strutture interne
    • un'area amministrativa (organizationUnit di tipo administrativeArea) recuperato da IRIS RM Risorse ==> Strutture interne
    • un ente esterno (organizationUnit di tipo externalOrganization o university) recuperato da IRIS RM Risorse ==> Strutture esterne
    • la tipologia di progetto (wfItemType di tipo PRJ) come da tassonomia
    • un bando di finanziamento (wfItemTypeLink di tipo CALL) recuperato da IRIS AP Attività e Progetti ==> Bandi di finanziamento
    • un contratto (wfItemTypeLink di tipo CON) recuperato da IRIS AP Attività e Progetti ==> Contratti
    • una iniziativa di public engagement (wfItemTypeLink di tipo PEN) recuperato da IRIS RM Terza missione ==> Public engagement
    • ...

Di seguito l'elenco di TUTTI i TAB previsti per il seguente modello.
Tenere presente che alcuni TAB potrebbero essere visibili solo a determinate categorie di attori e/o solo in certi stati: per questi dettagli cfr il flusso di riferimento dell'entità in questione alla sezione "Permessi".

Informazioni generali (equipment/form1)

Oggetto Widget Attributo Tipo Dato Etichetta e Descrizione
root hidden id integer

Attributo nascosto
Identificativo di sistema

root textarea transitionComment string Motivazione transizione di stato (label.equipment.transitionComment)

Questo attributo viene visualizzato SOLO quando nel flusso viene prevista una validazione "required" stringMap[transitionComment]
Serve per richiedere l'inserimento della motivazione della transizione di stato corrente: tipicamente quando si porta la Grande attrezzatura in uno stato di "morte" come Bozza.
Il valore inserito dall'utente in questo campo viene recuperato e accodato all'attributo clobMap[transitionsLog] insieme al log della transizione di stato.
Fare riferimento al flusso per conoscere gli stati che scatenano questa validazione.

root hidden identifier string

Identificativo della Grande Attrezzatura.
Attributo nascosto e in sola lettura.

root hidden wfState wfState

Stato della grande Attrezzatura relativa al flusso di validazione scelto.
Attributo nascosto in sola lettura.

root select wfItemTypeId (wfItemType) wfItemType Tipo (label.equipment.wfItemType)
Oggetto collegato
EQP
root text identifier string Codice interno (label.equipment.identifier)

Identificativo di Grandi attrezzature equipment.
Il valore dipende dal flusso di validazione scelto.
Cfr la sezione "Logiche (action/start)" del flusso scelto.
Attributo in sola lettura.

root text wfState wfState Stato (label.equipment.wfState)

Stato della Grande attrezzatura relativo al flusso di validazione scelto.
Attributo in sola lettura.

root hidden wfItemTypeIdPreviousValue (wfItemType) wfItemType

Attributo nascosto ad uso tecnico delle validazioni.

root text description string Nome (label.equipment.description)

Titolo (description) multingua it/en

root textarea abstract clob Descrizione (Italiano) (label.equipment.abstract)

Abstract multingua it/en

root textarea note clob Note (label.equipment.note)
root radio visibleOnPortal boolean Visibile su Portale pubblico (label.equipment.visibleOnPortal)
root autocomplete manufacturer organizationUnit Azienda produttrice (label.equipment.manufacturer)
Oggetto collegato
externalOrganization
root radio internalOwnership boolean Proprietà dell'Ateneo? (label.equipment.internalOwnership)
root autocomplete externalOrganizationOwner organizationUnit Ente esterno proprietario (label.equipment.externalOrganizationOwner)

Questo metadato viene mostrato SOLO se l'Ateneo NON è il proprietario dell'attrezzatura (internalOwnership valorizzato a NO/false)

Oggetto collegato
externalOrganization
Riferimenti ad inventario (fieldset.inventory)

Questa sezione consente il collegamento di Beni di Inventario di UGOV alla Grande Attrezzatura.
Di default, questa funzionalità non viene mostrata, è possibile visualizzare questa funzionalità andando a settare la variabile di configurazione ap.eqp.ugovpj.inventory.enabled a valore true.
Per il corretto funzionamento, è necessario che le seguenti variabili di configurazione siano configurate correttamente.

  • it.cineca.ap.iris.UgovPJBridge.ProjectEndpoint , in Iris-configuration AP_UGOV_PJ_ENDPOINT
  • it.cineca.ap.iris.UgovPJBridge.ProjectEndpoint.username, in Iris-configuration AP_UGOV_PJ_USERNAME
  • it.cineca.ap.iris.UgovPJBridge.ProjectEndpoint.password, in Iris-configuration AP_UGOV_PJ_PASSWORD

inventoryGood UNDOCUMENTED
root radio autocalculatedInventoryGoodsTotalValue boolean Valore complessivo autocalcolato (label.equipment.inventory.autocalculatedInventoryGoodsTotalValue)

Questo widget contiene lo script che va a calcolare il Valore Complessivo ogni volta che viene modificata la tabella dei Riferimenti ad inventario

root text purchaseValue number Valore di acquisto (label.equipment.purchaseValue)
Codici identificativo progetto (tariffario/contabilità) (fieldset.equipmentTariffLink.tariff)

Fragment che contiene i contratti di tipo tariffario/contabilità.
Il fragment recupera tutti i contratti con la tipologia valorazziata nella variabile di configurazione ap.eqp.tariff.quotedCsvType.
La variabile di configurazione deve essere valorizzata con le tipologie specifiche tra apici (contenute nel file excel delle alberature come CON.OTH.TAR).
Esempio: 'CON.OTH.TAR','CON.OTH-ECHO.TAR' La variabile di CONFIGURATION (MA) che abilita questo widget si chiama ap.eqp.pj-tariff.enabled
Se questa è TRUE allora viene visualizzato tutto il fieldset, altrimenti no.
La config non è valorizzata di default, quindi di default non compare.

equipmentTariffLink autocomplete child wfItemLink @label.equipment.tariffName|tableColumns=9@ (label.equipment.tariffName|tableColumns=9)
Oggetto collegato
[${config.ap.eqp.tariff.quotedCsvType}]
Archibus ID (fieldset.equipment.archibusId)

Codici Archibus per la grande attrezzatura.
La variabile di CONFIGURATION (MA) che abilita questo widget si chiama ap.eqp.archibus.enabled
Se questa è TRUE allora viene visualizzato tutto il fieldset, altrimenti no.
La config non è valorizzata di default, quindi di default non compare.

multipleArchibusId text description string Archibus ID (fieldset.equipment.archibusId)
Contatti (fieldset.contact)
contact
radio mainContact boolean Contatto principale (label.contact.mainContact)
select contactType gaDictionary Tipo di contatto (label.contact.contactType)
Dizionario collegato
RM - Gruppi di ricerca - Tipo di contatto
(contactType)
text description string Descrizione (label.contact.description)
Responsabili scientifici (fieldset.equipment.owner.fragment)
owner
autocomplete ownerId (person) person Responsabile (label.equipment.owner.ownerId)
Oggetto collegato
persone indipendentemente dalla presenza di rapporti di lavoro
text startDate date Inizio (label.equipment.owner.startDate)
text endDate date Fine (label.equipment.owner.endDate)
Delegati alla compilazione (fieldset.equipment.internalRepresentative.fragment)
internalRepresentative autocomplete internalRepresentative (person) person Delegati alla compilazione (fieldset.equipment.internalRepresentative.fragment)
Oggetto collegato
persone interne con ultima posizione - attiva o cessata
Laboratori collegati (fieldset.laboratoryEquipmentLink.laboratory)
laboratoryEquipmentLink autocomplete parent wfItemLink @label.laboratoryName|relationElementParentFkName=parentId@ (label.laboratoryName|relationElementParentFkName=parentId)
Oggetto collegato
LAB
Dipartimenti di afferenza (fieldset.wfItem.internalOrganization)
internalOrganizationUnit autocomplete ouId (organizationUnit) organizationUnit Dipartimenti di afferenza (fieldset.wfItem.internalOrganization)
Oggetto collegato
department

Altre informazioni (equipment/form2)

Oggetto Widget Attributo Tipo Dato Etichetta e Descrizione
root select wfItemTypeId (wfItemType) wfItemType Tipo (label.equipment.wfItemType)
Oggetto collegato
EQP
root text identifier string Codice interno (label.equipment.identifier)

Identificativo di Grandi attrezzature equipment.
Il valore dipende dal flusso di validazione scelto.
Cfr la sezione "Logiche (action/start)" del flusso scelto.
Attributo in sola lettura.

root text wfState wfState Stato (label.equipment.wfState)

Stato della Grande attrezzatura relativo al flusso di validazione scelto.
Attributo in sola lettura.

root hidden wfItemTypeIdPreviousValue (wfItemType) wfItemType

Attributo nascosto ad uso tecnico delle validazioni.

root text building string Edificio (label.equipment.building)
root text room string Aula (label.equipment.room)
root text floor string Piano (label.equipment.floor)
root radio publicCalendar boolean Calendario pubblico (label.equipment.publicCalendar)
root text urlPublicCalendar string URL a Calendario prenotazioni (label.equipment.urlPublicCalendar)

Questo metadato viene mostrato SOLO se il calendario dell'attrezzatura è pubblico (publicCalendar valorizzato a SI/true)

root date startDate date Data di acquisizione (label.equipment.startDate)
root text year integer Anno di acquisizione (label.equipment.year)

Attributo in sola lettura.
L'anno viene estratto dall'attributo startDate.
Ogni modifica alla data di inizio viene recepita da questo campo

root text purchaseValue number Valore di acquisto (label.equipment.purchaseValue)
Fondi su cui è stato effettuato l'acquisto (fieldset.wfItem.costType)
costType select cost wfDictionary Fondi su cui è stato effettuato l'acquisto (fieldset.wfItem.costType)
Dizionario collegato
RM - Attrezzature - Fondi su cui è stato effettuato l'acquisto
(costType)
root select activationYear integer Anno di messa in esercizio (label.equipment.activationYear)
Oggetto collegato
Elenco anni dal 1970 all'anno corrente
root select manifacturingYear integer Anno di fabbricazione (label.equipment.manifacturingYear)
Oggetto collegato
Elenco anni dal 1970 all'anno corrente
root radio historicalEvidence boolean Valore storico (label.equipment.historicalEvidence)
root radio inUse boolean In uso/Funzionante (label.equipment.inUse)
root select repairability wfDictionary Riparabilità (label.equipment.repairability)

Questo metadato viene mostrato SOLO se l'attrezzatura NON è in uso/NON è funzionante (inUse valorizzato a NO/false)

Dizionario collegato
RM - Attrezzature - Riparabilità
(repairability)
root text endDate date Data di dismissione (label.equipment.endDate)

Data di dismissione

root text endYear integer Anno di dismissione (label.equipment.endYear)

Anno solare di dismissione

root radio underMaintenance boolean Sotto contratto di manutenzione (label.equipment.underMaintenance)
root text yearlyCost number Costo annuo (label.equipment.yearlyCost)

Questo metadato viene mostrato SOLO se l'attrezzatura è Sotto contratto di manutenzione (underMaintenance valorizzato a true

root textarea underMaintenanceNote string Note sulla manutenzione (label.equipment.underMaintenanceNote)

Questo metadato viene mostrato SOLO se l'attrezzatura è Sotto contratto di manutenzione (underMaintenance valorizzato a true

Come accedere (fieldset.equipment.accessMode)
accessMode select accessMode wfDictionary Come accedere (fieldset.equipment.accessMode)
Dizionario collegato
@label.dictionary.accessMode@
(accessMode)
Chi può accedere/Utenza (fieldset.equipment.userType)
userType select user wfDictionary Chi può accedere/Utenza (fieldset.equipment.userType)
Dizionario collegato
RM - Attrezzature - Utenza
(userType)
Finalità dell'accesso/Applicazioni (fieldset.equipment.applications)
applications select application wfDictionary Finalità dell'accesso/Applicazioni (fieldset.equipment.applications)
Dizionario collegato
RM - Attrezzature - Finalità dell'accesso/Applicazioni
(applications)
Siti tariffari (fieldset.equipment.tariffSite)

Siti tariffari per la grande attrezzatura
Viene mostrato solo se la configurazione ap.eqp.tariffSite.enabled è presente ed impostata a valore true

tariffSite text description string Siti tariffari (fieldset.equipment.tariffSite)
root text tariff string Dettaglio tariffario (label.equipment.tariff)

Questo metadato viene mostrato SOLO se tra le applicazioni compare la voce di dizionario applications.tariff (RM - Attrezzature - Applicazioni)

Classificazione ESFRI (fieldset.wfItem.esfriClassification)
esfriClassification select classification wfDictionary Classificazione ESFRI (fieldset.wfItem.esfriClassification)
Dizionario collegato
RM - Attrezzature - Classificazione ESFRI
(esfriClassification)
Tipologia personalizzata (fieldset.wfItem.rmCustomClassification)
rmCustomClassification select rmCustomClassification gaDictionary Tipologia personalizzata (fieldset.wfItem.rmCustomClassification)
Dizionario collegato
RM - Tipologia personalizzata
(rmCustomClassification)
root select constraintsType wfDictionary Tipo (label.equipment.constraintsType)

Vincoli sulla proprietà della Grande attrezzatura.
Visibile SOLO se ap.equipment.constraints.enabled settata a true.

Dizionario collegato
RM - Attrezzature - Vincoli
(constraintsType)
root textarea constraintsDetail clob Descrizione (label.equipment.constraintsDetail)

Vincoli sulla proprietà della Grande attrezzatura.
Visibile SOLO se ap.equipment.constraints.enabled settata a true.

Collegamenti (equipment/form3)

Oggetto Widget Attributo Tipo Dato Etichetta e Descrizione
root select wfItemTypeId (wfItemType) wfItemType Tipo (label.equipment.wfItemType)
Oggetto collegato
EQP
root text identifier string Codice interno (label.equipment.identifier)

Identificativo di Grandi attrezzature equipment.
Il valore dipende dal flusso di validazione scelto.
Cfr la sezione "Logiche (action/start)" del flusso scelto.
Attributo in sola lettura.

root text wfState wfState Stato (label.equipment.wfState)

Stato della Grande attrezzatura relativo al flusso di validazione scelto.
Attributo in sola lettura.

root hidden wfItemTypeIdPreviousValue (wfItemType) wfItemType

Attributo nascosto ad uso tecnico delle validazioni.

Progetti collegati (fieldset.equipmentProjectLink.equipment)
projectEquipmentLink autocomplete parent wfItemLink Progetti collegati (label.equipmentProjectLink)
Oggetto collegato
PRJ
Contratti collegati (fieldset.equipmentContractLink.equipment)
contractEquipmentLink autocomplete parent wfItemLink Contratti collegati (label.equipmentContractLink)
Oggetto collegato
CON
Gruppi di ricerca collegati (fieldset.workgroupEquipmentLink.workgroup)
workgroupEquipmentLink autocomplete parent wfItemLink @label.workgroupName|relationElementParentFkName=parentId@ (label.workgroupName|relationElementParentFkName=parentId)
Oggetto collegato
WKG
Iniziative di public engagement collegate (fieldset.equipmentPublicEngagementLink.equipment)
publicEngagementEquipmentLink autocomplete parent wfItemLink Iniziative di public engagement collegate (label.equipmentPublicEngagementLink)
Oggetto collegato
PEN
Pubblicazioni (fieldset.equipment.publication)

Questa sezione consente il collegamento di pubblicazioni del grande attrezzatura
E' possibile definire all'interno della variabile di configurazione ap.eqp.publication.validationStatus gli stati (separati da virgola) delle pubblicazioni da includere.
Se questa variabile non è definita vengono restituite tutte le pubblicazioni con stato di validazione "1"
RM usa il servizio di IR /rest/api/v1/items/search documentato a questo indirizzo: rawgit.com/Cineca/IRIS-rest-java-client/master/docs/CINECA_IR_REST_API_Doc.htm
Gli stati possibili sono:
VALIDATION STP 3=5
VALIDATION STP 2=4
VALIDATION STP 1=3
REJECT=2
VALIDATE=1
INACTIVE=0
WORKSPACE=-1
Solitamente si traducono in [0=Definitivo], [1=Validato], [2=Riaperto], [3=], [4=In validazione]
Li si trova specificati nella doc di IR dove si nomina workFlowValidationStatus

publication system title (title) string
system contributors (contributors) string
system handle (handle) string
system year (year) string
system itemId (itemId) string
Premi nazionali e internazionali per la ricerca (fieldset.prize)
prize system prize (prize) rmItem Premio - Denominazione (label.prize.name)

Allegati (equipment/form4)

Oggetto Widget Attributo Tipo Dato Etichetta e Descrizione
root select wfItemTypeId (wfItemType) wfItemType Tipo (label.equipment.wfItemType)
Oggetto collegato
EQP
root text identifier string Codice interno (label.equipment.identifier)

Identificativo di Grandi attrezzature equipment.
Il valore dipende dal flusso di validazione scelto.
Cfr la sezione "Logiche (action/start)" del flusso scelto.
Attributo in sola lettura.

root text wfState wfState Stato (label.equipment.wfState)

Stato della Grande attrezzatura relativo al flusso di validazione scelto.
Attributo in sola lettura.

root hidden wfItemTypeIdPreviousValue (wfItemType) wfItemType

Attributo nascosto ad uso tecnico delle validazioni.

Allegati (fieldset.attachments)
attachmentEquipmentLogo file attachmentName (attachmentName) string File (label.file)
text attachmentDescription (attachmentDescription) string Descrizione (label.description)
select attachmentTypeId (attachmentTypeId) wfDictionary Tipologia (label.type)
system attachmentLoadingDate (attachmentLoadingDate) date
system attachmentOwner (attachmentOwner) person
system attachmentBlob (attachmentBlob) blob

Versioni (equipment/form5)

Oggetto Widget Attributo Tipo Dato Etichetta e Descrizione
root select wfItemTypeId (wfItemType) wfItemType Tipo (label.equipment.wfItemType)
Oggetto collegato
EQP
root text identifier string Codice interno (label.equipment.identifier)

Identificativo di Grandi attrezzature equipment.
Il valore dipende dal flusso di validazione scelto.
Cfr la sezione "Logiche (action/start)" del flusso scelto.
Attributo in sola lettura.

root text wfState wfState Stato (label.equipment.wfState)

Stato della Grande attrezzatura relativo al flusso di validazione scelto.
Attributo in sola lettura.

root hidden wfItemTypeIdPreviousValue (wfItemType) wfItemType

Attributo nascosto ad uso tecnico delle validazioni.

Versioni precedenti (fieldset.linkVersion)

Gestione delle versioni
Ogni volta che viene effettuata una transizione verso lo stato "approved", viene generata una versione congelata delle Grande attrezzatura
Le versioni precedenti sono in sola lettura

version autocomplete child wfItemLink