utilities/README.md

Fix Gaia Excel - Script Python

Script per leggere e processare file Excel con struttura specifica, cercando e estraendo dati dalla colonna "Titoli - Operativita - Data ottenimento - Data scadenza".

Requisiti

• Python 3.6 o superiore
• pip (gestore pacchetti Python)

Installazione

1. Creare l'ambiente virtuale

# Crea l'ambiente virtuale nella cartella venv
python -m venv venv

2. Attivare l'ambiente virtuale

Su Windows (PowerShell):

.\venv\Scripts\Activate.ps1

Su Windows (CMD):

.\venv\Scripts\activate.bat

Su Linux/macOS:

source venv/bin/activate

Nota: Se ricevi un errore di policy su PowerShell, esegui:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

3. Installare le dipendenze

pip install -r requirements.txt

Se il file requirements.txt non esiste, installa manualmente:

pip install openpyxl

4. Generare il file requirements.txt (opzionale)

Se vuoi aggiornare il file delle dipendenze:

pip freeze > requirements.txt

Utilizzo

Eseguire lo script

python fixgaiaexcel.py <percorso_file_excel>

Esempio:

python fixgaiaexcel.py data\report.xlsx

Output

Lo script:

1. Apre il file Excel specificato
2. Cerca la colonna con intestazione "Titoli - Operativita - Data ottenimento - Data scadenza"
3. Estrae e stampa tutti i dati sotto quella colonna
4. Mostra il conteggio totale degli elementi trovati

Esempio di output

Apertura file: data\report.xlsx
----------------------------------------------------------------------
Foglio attivo: Foglio1
Dimensioni: 150 righe x 10 colonne
----------------------------------------------------------------------
Colonna target trovata: posizione 5
Intestazione: Titoli - Operativita - Data ottenimento - Data scadenza
----------------------------------------------------------------------

Dati trovati (10 elementi):

    1. Valore 1
    2. Valore 2
    3. Valore 3
    ...

----------------------------------------------------------------------
Totale elementi letti: 10

Reinstallazione su nuovo PC

Passaggi completi

1. Clona o copia il progetto sul nuovo PC

2. Verifica che Python sia installato:

   python --version
   

   Se Python non è installato, scaricalo da python.org

3. Crea l'ambiente virtuale:

   python -m venv venv
   

4. Attiva l'ambiente virtuale:

   .\venv\Scripts\Activate.ps1
   

5. Installa le dipendenze:

   pip install -r requirements.txt
   

6. Verifica l'installazione:

   pip list
   

   Dovresti vedere openpyxl nella lista dei pacchetti installati.

7. Testa lo script:

   python fixgaiaexcel.py --help
   

Struttura del progetto

cripy/
├── venv/                  # Ambiente virtuale (NON committare in git)
├── data/                  # Cartella per i file Excel
├── fixgaiaexcel.py        # Script principale
├── requirements.txt       # Dipendenze Python
└── README.md             # Questo file

Troubleshooting

Errore: "Il file non esiste"

Verifica che il percorso del file Excel sia corretto e che il file esista.

Errore: "Colonna non trovata"

Lo script cerca l'intestazione esatta nella prima riga. Verifica che il file Excel contenga la colonna "Titoli - Operativita - Data ottenimento - Data scadenza" nella prima riga.

Errore di importazione openpyxl

Assicurati di aver attivato l'ambiente virtuale e installato le dipendenze:

.\venv\Scripts\Activate.ps1
pip install openpyxl

Disattivare l'ambiente virtuale

Quando hai finito di lavorare:

deactivate

Note

• L'ambiente virtuale (venv/) non dovrebbe essere committato in git. Aggiungi al .gitignore:

  venv/
  __pycache__/
  *.pyc
  

• Il file requirements.txt dovrebbe essere committato per facilitare l'installazione su altri PC.