Verifica del Json
è molto importate prima di ogni operazione verificare la correttezza del file json di migrazione.
Per ogni ateneo il file da verificare si trova nella posizione /sites/<ambiente>/files/ugov_course[_en].json ad esempio https://www.unibg.it/sites/default/files/ugov_course.json
Lanciare il migrate
per lanciare in autonomia le migrate per chi non avesse accesso alla portali drupal01 si può procedere con il tasto esegui sulla pagina /admin/structure/migrate/manage/ugov_json/migrations
mentre è caldamente consigliato per chi ha l'accesso alla macchina utilzzare il comando drush ateneo mim --update/ --sync ugov_course
Piccolo memo:
- update: serve ad aggiornare forzatamente tutti i corsi ma molto spesso su ugov_course non riconosce l'id e potrebbe dare errore di chiave duplicata
- sync: serve a verificare se le entità drupal sono presenti sul file sorgente e nel caso in cui ci siano dati superflui procede ad una bonifica, dopo di che aggiornerà i record rimanenti
Template
Spesso capita di dover modificare il template di alcuni componenti dell'offerta formativa, per farlo si può andare alla pagina /admin/ugov/entities/course/migrate e nella sezione template si troveranno tanti box per modifica quanti sono i campi modificabili
Ogni "Box" contiene codice twig e si può modificare liberamente a seconda delle esigenze.
è molto importante una volta salvato i template pulire bene la cache altrimenti non si applicano correttamente le modifiche
Campi
è possibile procedere in autonomia nella creazione di campi base come dei testi semplici o testi elenco.
Per farlo è necessario creare i campi da /admin/structure/course_type cliccando sulla freccina vicino a Modifica poi su Gestisci campi
Procedere seguendo le istruzioni e compilare quanto richiesto, una volta creato il campo e propagato su ogni bundle si procede con la gestione del migrate.
Per gestire le migrazioni bisogna andare su /admin/config/development/configuration/full/export → singolo elemento e impostare i menù a tendina come segue
Tipo di configurazione: migrazione
Il nome della confiigurazione: UGOV Course (ugov_course)
Si otterà un configurazione da poter copiare e modificare sul proprio editor di testo
in questa configurazione si sono due sezioni principali quella del source e quella del process
Nella sezione Source ci sono i vari selettori che sono parti fondamentali per il recupero dell'informazione ad esempio
-
name: durata_it
label: 'Durata - it'
selector: cdsSub/0/durata_it
Dove:
name: indica il nome del selettore
label: indica l'etichetta che si vedrà nella migrazione
selector: indica il percorso del json dove sarà presente il campo
Nella sezione Proccess si va ad indicare come riempire il campo ad esempio
field_duration:
-
plugin: skip_on_editable
source: durata_it
entity_type: course
language: it
In questo esempio si vede il nome macchina del campo da riempire seguito da alcune informazioni
Plugin: indica quale metodo di inserimento sarà utilizzato per inserire il valore, ad esempio in questo caso skip_on_editable ci permette di evitare la sovrascrittura in caso in cui il campo sia stato modificato manualmente
Source: indica quale selettore utilizzare per inserire il dato
Entity_type: indica su quale entità è presente il campo
Language: indica quale traduzione dell'entità riempire
Una volta modificata la configurazione si può procedere all'importazione, quindi si va in /admin/config/development/configuration/full/import → singolo elemento e impostare il menù a tendina come segue
Tipo di configurazione: migrazione
a questo punto basta incollare la nuova configurazione e cliccare su importa
Prima di lanciare la nuova migrazione è sempre importante pulire la cache altrimenti si rischia di non vedere le modifiche appena effettuate in quanto si utilizza la vecchia configurazione
Curriculum
Spesso capita di dover modificare il template di alcuni componenti del piano di studi in questi casi è necessario andare in /admin/ugov/entities/curriculum/migrate e modificare i vari template
Per capire quello corretto da modificare è opportuno verificare in /admin/structure/views/view/insegnamenti/edit/block_2 dove nella sezione fields ci sarà il nome del template utilizzato per mostare il piano di studi
una volta modificato il template è sempre importante pulire la cache altrimenti si rischia di non vedere le modifiche appena effettuate in quanto si utilizza la vecchia configurazione
Prima di lanciare le migrate è necessario lanciare il comando drush10 ateneo mdc e poi il comando di migrazione di ugov_course per la migrazione dei curriculum non è possibile procedere da interfaccia.