## Problema - La documentazione dei componenti di layout non ha una panoramica d'insieme che ne spieghi il raggruppamento e l'uso generale. - I nested form ICEF, ISEE Minorenni e Cittadinanza sono ancora etichettati come "deprecato", sebbene non lo siano più. - Il nested form ISEE Minorenni ha una configurazione diversa dagli altri nested form, ma la differenza non è spiegata né richiamata dalla sezione introduttiva sul trascinamento dei nested form. - Manca una sezione su su come valorizzare i campi con i dati inseriti in un altro campo - La sezione sul componente date non spiega perché si sconsiglia il componente di default form.io date. - Nella sezione conditional non è documentato che esistono due modalità (semplice e advanced) per impostare la condizione di non mostrare un componente. - Manca un esempio specifico su come calcolare il punteggio per una graduatoria - Sistemare la sezione di estrazione dati tramite API - Aggiungere qui https://docs.opencityitalia.it/stanza-del-cittadino/gestione-delle-pratiche/gestire-le-pratiche-online/modifica-il-file-.csv-con-i-dati-delle-pratiche la lista dei componenti con dati non estraibili nel csv - Manca il percorso di recupero dati nested form anche per componenti "HTML" - Mancano le indicazioni su come richiamare un dato in un componente che è già stato inserito da un'altra parte del modulo - Manca la descrizione del componente "number" ## Soluzione - Aggiungere una sezione con panoramica generale dei componenti di layout, raggruppati per tipologia, corredata da uno screenshot con frecce esplicative. - Rimuovere la dicitura "deprecato" dai nested form ICEF, ISEE Minorenni e Cittadinanza. - Nel nested form ISEE Minorenni, spiegare le differenze di configurazione rispetto agli altri nested form e aggiungere un rimando da questa sezione a quella introduttiva sul trascinamento dei nested form. - Aggiungere percorso recupero dati nested form anche per componenti "HTML" - Aggiungere hint su OC-ISEE Minorenni con differenza tra OC- ISEE Minorenni e OC- ISEE Ordinario - Esplicitare anche il property_name dei campi che compongono ogni nested form es. Genere (property_name: **gender**; path: data.beneficiary.data.gender) - Aggiungere percorso recupero dati nested form anche per componenti "HTML"Aggiungere nella sezione date la motivazione per cui non si consiglia il componente di default form.io date. - Scrivere la lista dei componenti i cui dati non sono estraibili nel csv - Aggiunta una sezione su su come valorizzare i campi con i dati inseriti in un altro campo - Aggiungere esempio punteggio graduatoria - Aggiungere esempi nella pagina sull'estrazione dati tramite api --> c'è già https://docs.opencityitalia.it/sito-web/moduli-integrativi-della-piattaforma/utilizzare-le-api-del-sito/effettuare-una-chiamata-api#esempi-di-utilizzo-delle-api - Inserire delle istruzione su come richiamare un dato in un componente che è già stato inserito da un'altra parte del modulo - Inserire una pagina di descrizione del componente "number" e una per il "text_area" ## Test - [ ] [CHANGE REQUEST COMPONENTI LAYOUT](https://app.gitbook.com/o/-MRQtav6dxPB0RkAwAX7/s/rdV0mwA7iy2c3I7wu5BX/~/changes/256/) Verificare che la sezione componenti di layout includa una panoramica generale con screenshot e raggruppamento per tipologia. - [ ] [CHANGE REQUEST NUMBER E TEXT AREA](https://app.gitbook.com/o/-MRQtav6dxPB0RkAwAX7/s/rdV0mwA7iy2c3I7wu5BX/~/changes/256/) Verificare che ci sia una pagina di descrizione del componente "number" e "text_area" - [ ] [CHANGE REQUEST NESTED FORM](https://app.gitbook.com/o/-MRQtav6dxPB0RkAwAX7/s/rdV0mwA7iy2c3I7wu5BX/~/changes/254/) Verificare che i nested form ICEF, ISEE Minorenni e Cittadinanza non riportino più la dicitura "deprecato". - [ ] [CHANGE REQUEST NESTED FORM](https://app.gitbook.com/o/-MRQtav6dxPB0RkAwAX7/s/rdV0mwA7iy2c3I7wu5BX/~/changes/254/) Verificare che il nested form ISEE Minorenni spieghi le differenze di configurazione e che la sezione introduttiva sul trascinamento dei nested form rimandi a questa spiegazione. - [ ] [CHANGE REQUEST NESTED FORM](https://app.gitbook.com/o/-MRQtav6dxPB0RkAwAX7/s/rdV0mwA7iy2c3I7wu5BX/~/changes/254/) Verificare che il percorso recupero dati nested form ci sia anche per i componenti "HTML" (es. in Immobili: "luogo" e "dati catastali") - [ ] [CHANGE REQUEST NESTED FORM](https://app.gitbook.com/o/-MRQtav6dxPB0RkAwAX7/s/rdV0mwA7iy2c3I7wu5BX/~/changes/254/) Verificare che ci sia un hint su OC-ISEE Minorenni che spiega la differenza da OC- ISEE Ordinario - [ ] [CHANGE REQUEST NESTED FORM](https://app.gitbook.com/o/-MRQtav6dxPB0RkAwAX7/s/rdV0mwA7iy2c3I7wu5BX/~/changes/254/) Verificare che sia resa esplicito anche il property_name dei campi che compongono ogni nested form es. Genere (property_name: **gender**; path: data.beneficiary.data.gender) - [ ] [CHANGE REQUEST NUOVA PAGINA](https://app.gitbook.com/o/-MRQtav6dxPB0RkAwAX7/sites/site_j0AUY/s/rdV0mwA7iy2c3I7wu5BX/~/changes/266/) Inserita nuova pagina su come valorizzare i campi con i dati inseriti in un altro campo - [ ] [CHANGE REQUEST DATE](https://app.gitbook.com/o/-MRQtav6dxPB0RkAwAX7/sites/site_j0AUY/s/rdV0mwA7iy2c3I7wu5BX/~/changes/264/) Verificare che la sezione date spieghi perché non si consiglia il componente di default form.io date. - [ ] [CHANGE REQUEST CALCOLI ](https://app.gitbook.com/o/-MRQtav6dxPB0RkAwAX7/sites/site_j0AUY/s/rdV0mwA7iy2c3I7wu5BX/~/changes/265/) Verificare che si sia un esempio sul calcolo del punteggio di una graduatoria - [ ] [CHANGE REQUEST DATE](https://app.gitbook.com/o/-MRQtav6dxPB0RkAwAX7/sites/site_j0AUY/s/buF4yaTdhboReojXsnKw/~/changes/91/) Verificare che ci sia una lista dei componenti i cui dati non sono estraibili nel csv - [ ] [CHANGE REQUEST MODIFICA DATI NESTED FORM](https://app.gitbook.com/o/-MRQtav6dxPB0RkAwAX7/sites/site_j0AUY/s/rdV0mwA7iy2c3I7wu5BX/~/changes/263/) Verifica che ora la pagina di Modifica Campi Nested Form riporti prima i casi d'uso e poi come configurare i cambiamenti. ## Documentazione Le sezioni della documentazione aggiornata sono riportate nei test