Tabelle utilizzate per le migrazioni della rubrica

é sempre possibile ricreare sul gestore dei db la query di migrazione andando alla pagina /admin/structure/migrate/manage/ugov/migrations

Per le unità organizzative  si utlizzano le tabelle:

v_ie_ac_uo_base_oggi: per la gestione dei cd_tipo nodo

v_ie_ac_so_attiva: per le relazioni padre figlio

v_ie_ac_uo_contatti_all: per i contatti delle uo

Per le persone si utlizzano:

v_ie_ac_pf_contatti_all: per i contatti delle persone, è una vista denormalizzata in cui su ogni riga c'è un tipo di contatto. si mette in join attraverso l'id_ab

v_ie_ru_pers_attivo: Vista che espone tutto il personale con un contratto attivo, utile per ottenere le informazioni su ruolo, profilo, inquadramento, afferenza alle uo, sede di lavoro

v_ie_ru_pf_base: usata per ottenere le informazioni sulla persona come nome e cognome

v_ie_ru_sge: Vista che espone tutta la carriera di una persona all'interno dell'ateneo, mostra quindi contratti attivi e scaduti, viene usata al posto della v_ie_ru_pers_attivo quando si vuole attivare un periodo di grazia

Possibili configurazioni

Organizational Unit

Per quanto riguarda le unità organizzative l'unica configurazione possibile consiste nell'inserire i cd_tipo nodo delle unità che si vorranno mostrare

Person

Per quanto rigurada le persone ci sono 3 possibili configurazioni:

1. Ruolo
2. Ruolo + Profilo
3. Ruolo + Inquadramento

é sempre caldamente consigliato far adottare la seconda configurazione all'ateneo

per configurare la migrazione delle persone si deve andare in admin/ugov/entities/person/migrate

Il tab filtering serve a definire quali persone saranno prese in drupal:

• va definito il Filter type in una delle configurazione sopra elecate
• import only person having these relative Organizational Units: importa solo le persone di una unità organizzativa specifica
• In base al Filter type si avranno 3 possibili scenari
  1. import only person having these combination of Role and Level
  2. import only person having these combination of Role and Profile
  3. import only person having these roles

In questi scenari va distinta la mappatura tra quelli che non avranno il periodo di grazia e quelli invece che hanno il periodo di grazia, è fondamentale che una combinazione non sia ripetuta in entrambe le form

• Person ids to not import: id_ab delle persone che non devono essere importate in rubrica, questo filtro agisce a prescindere dal ruolo che ha la persona
  
• Grace period: definisce  i mesi di periodo di grazia di tutte le combinazioni presenti nella form "<configrazione> with grace period"  NON è possibile definire periodo di grazia diversi da un ruolo all'altro
  

Il tab Importa serve a definire le mappature delle persone:

• Bundles|Roles mapping: va valorizzato in others|<any>
  
• Gender auto recognition enabled: permette di ricoscere il sesso di una persona
  

I tab Publications Import, Prize import, Cv import sono configurazioni dei vecchi moduli ad oggi non vanno MAI attivati

Il tab UniFind Link apparirà solo dopo aver installato i moduli di migrazione di unifind e va configurato settando il check di attivazione, scegliendo Url o alias url in base a cosa viene popolato dal json di unifind e inserita l'etichetta che si aspetta di vedere l'ateneo

Person Role

Questo modulo serve a recuperare le informazioni contrattuali di una persona, ad esempio ruolo e afferenza

Per configurare la migrazione delle persone si deve andare in admin/ugov/relational-entities/person-role/migrate

Il tab filtering serve a definire quali persone saranno prese in drupal:

• va definito il Filter type coerente a quello definito per person
• In base al Filter type si avranno 3 possibili scenari
  1. import only person having these combination of Role and Level
  2. import only person having these combination of Role and Profile
  3. import only person having these roles

In questi scenari va distinta la mappatura tra quelli che non avranno il periodo di grazia e quelli invece che hanno il periodo di grazia, è fondamentale che una combinazione non sia ripetuta in entrambe le form

Il tab Importa serve a definire le mappature dei ruoli sulle persone, va valorizzato solo il form corrispondente al filter type selezionato prima

è molto importante verificare che le mappature siano del tipo RUOLO+PROFILO/INQUADRAMENTO| decoding| peso altrimenti da un warning nella migrazione

per la corretta mappatura è necessario fare attenzione a quale decoding viene utilizzato, solitamente vengono presi da /it/admin/ugov/decoding-entities/decoding/list filtrandoli per Role Type, se l'esatta descrizione non è presente tra quelle fornite di default è necessario creare una nuova decoding di tipo Role Type

Per creare una nuova decoding si va su /it/admin/ugov/decoding-entities/decoding/add/role_type

nel campo code va inserito por-XX dove XX sta per ultimo valore già presente nella lista +1  così da non avere decoding duplicate

nel campo value si inserisce l'etichetta che si vuole aggiungere

nel campo lingua solitamente viene messo Italiano

nel campo mapping si può lasciare vuoto

nel campo nome se visibile ripetere il valore dell'etichetta

Importante cliccare su Set main contract after import in modo da definire quale sia il contratto principale della persona

Decoding e place

Questi moduli non necessitano di configurazione basta installarli e migrarli

Decoding dovrebbe essere il primo modulo ad essere migrato perchè contiene le etichette delle altre entità

Place va fatto girare dopo la migrazione di ugov_ou perchè è un dettaglio delle unità organizzative

Assignment

Questo modulo serve a recuperare gli incarichi delle persone, legge dalla tabella  v_ie_ru_organico_cop

Per configurare la migrazione delle persone si deve andare in /admin/ugov/relational-entities/assignment/migrate

Il tab filtering serve a definire quali funizione saranno recuperate e va indicato un elenco di cd_tipo_posizorg, se non si valorizza il form verrano estratti tutti gli incarichi

Purpose

Questo modulo serve a recuperare le funzioni delle persone, legge dalla tabella  v_ie_ru_inc_funzioni

Per configurare la migrazione delle persone si deve andare in /admin/ugov/relational-entities/purpose/migrate

Il tab filtering serve a definire quali funizione saranno recuperate e va indicato un elenco di funzione, se non si valorizza il form verrano estratte tutte le funzioni

Unifind

Questo modulo serve ad ottenere il link della persona verso il prodotto unifind di ateneo

Per configurare correttamente questo modulo è necessario andare in admin/config/services/http-client-manager cliccare su impostazioni e inserire nel form Override quello che è contenuto nel suggerimento "Valore predefinito" infine su salva configurazione

Una volta che è stato configurato il giusto sito unifid occore cliccare su HTTP Services API e nella riga di unifind_services andare su "View Commands"

Una volta aperta la nuova finestra bisogna configurare una nuova richiesta cliccando  su "Configured Request" poi su "+ Add Http Config Request"

La richiesta dovrà avere:

Etichetta: GET_UNIFIND_LINKS

Accept: application/json

Infine salvare la richiesta e testarla

Passi da svolgere per analizzare un bug

Rubrica

Per una corretta analisi del bug è molto importante conoscere tutto il ciclo della rubrica.

In prima analisi è fondamentale analizzare il db sorgente oracle in modo da capire quali sono i dati autoritativi e approfindere se il dato mostrato è un comportamento atteso dal modulo o se effettivamente si tratta di un bug

SE il dato presente sul db Oracle NON è quello che si aspetta l'ateneo allora si può rispondere che il problema è alla fonte e non possiamo farci nulla

SE il dato presente sul db Oracle è quello che si aspetta l'ateneo allora si verica se il db Mysql è allineato correttamente. potrebbe essere un problema di sync kettle.

Analisi del db Mysql:

SE il dato sul db Mysql NON è allineato all'oracle va verificata la sync

SE il dato sul db Mysql è allineato all'oracle vanno prese le seguenti informazioni:

id_ab, ruolo, profilo, inqudramento per i casi:

• Persona non presente in rubrica
• Persona presente ma con ruolo sbagliato

id_ab, id_ab_aff_org, sede per i casi:

• Persona con afferenza sbagliata
• Persona con sede sbagliata

Una volta ottenute le informazioni è importante verificare che le configurazioni siano corrette andando a verificarle puntualmente sulla base delle informazioni appena recuperate.

Backoffice

Nel caso in cui ci sia una persona che lamenta il problema di non riuscire ad entrare nei nostri backoffice il primo passo da fare è andare sul sito unifind di ateneo (Es. https://unior.unifind.cineca.it/) e cercare la persona nel motore di ricerca.

SE la persona non c'è non ha diritto di entrare quindi non è un problema

SE la persona c'è allora bisogna andare a cercare all'interno del back office se la persona c'è o meno al percorso /admin/ugov/entities/person/list cercando la persona

Anche in questo caso ci sono due possibili scenari

1.  la persona è assente
2.  la persona è presente

SE la persona è assente va fatto il giro come se fosse un problema sulla rubrica, quindi va cercato sull'oracle poi mysql e tutti i passaggi sopra elencati

SE la persona è presente va verificata la configurazione del BO al percorso /admin/bod/auth/settings 

Il tab Identification type può assumere 3 valori Email, Serial Number, Id code

Valutare quindi il valore ricevuto nella mail con quello della persona spesso la mail che ci arriva è quella personale e non quella istituzionale

Teoria

unità organizzative struttura dell'università ha dei concetti di gerarchia tipo albero con altre parti dell'università
unità di afferenza bridge tra ou e persone struttura che ha in carico il costo dello stipendio della persona
purpose è la funzione
place sono le sedi

...