Data-Coupler/SCHEDULING_UI_GUIDE.md

# Guida all'Interfaccia di Schedulazione - Data-Coupler

## 📋 Overview

L'interfaccia di schedulazione di Data-Coupler permette di configurare esecuzioni automatiche dei profili di trasferimento dati con diverse modalità, inclusa la nuova funzionalità di **intervalli personalizzati**.

---

## 🎯 Accesso alla Pagina di Schedulazione

1. Avvia l'applicazione Data-Coupler
2. Nella barra di navigazione, clicca su **"Schedulazione Profili"** (icona orologio)
3. Vedrai la lista delle schedulazioni esistenti o un messaggio per crearne una nuova

---

## ➕ Creare una Nuova Schedulazione

### Passo 1: Aprire il Modal di Creazione

Clicca sul pulsante verde **"+ Nuova Schedulazione"** in alto a destra.

### Passo 2: Configurare i Campi Base

#### **Nome Schedulazione** (obbligatorio)
- Inserisci un nome descrittivo
- Esempio: `"Sync Clienti Salesforce"`, `"Import Ordini Ogni 5 Minuti"`

#### **Descrizione** (opzionale)
- Aggiungi note o dettagli aggiuntivi
- Esempio: `"Sincronizzazione automatica clienti da Salesforce a database locale"`

#### **Profilo** (obbligatorio)
- Seleziona dal dropdown il profilo di trasferimento da eseguire
- Verranno mostrati solo i profili attivi

### Passo 3: Scegliere il Tipo di Schedulazione

Seleziona una delle seguenti opzioni:

---

## ⏱️ Tipi di Schedulazione Disponibili

### 1. **Una Volta** (`once`)
Esecuzione singola in una data e ora specifica.

**Configurazione:**
- **Data e Ora di Esecuzione**: Seleziona data e ora usando il picker
- Formato: `GG/MM/AAAA HH:mm`

**Esempio:**
```
Tipo: Una volta
Data e Ora: 15/10/2025 14:30
```

---

### 2. **⭐ Intervallo Personalizzato** (`interval`) - NUOVO!
Esecuzione ripetuta ogni N unità di tempo.

**Configurazione:**
- **Intervallo**: Inserisci un numero (minimo 1)
- **Unità di Tempo**: Seleziona dal dropdown
  - **Secondi** - Per test rapidi o requisiti real-time
  - **Minuti** - Per sincronizzazioni frequenti
  - **Ore** - Per aggiornamenti regolari
  - **Giorni** - Per backup giornalieri
  - **Settimane** - Per report settimanali
  - **Mesi** - Per consolidamenti mensili

**Anteprima in Tempo Reale:**
Una volta configurati intervallo e unità, vedrai un'anteprima che mostra:
```
Esecuzione ogni 5 minuti
```

**Esempi Pratici:**

**Test/Sviluppo:**
```
Intervallo: 30
Unità: Secondi
Anteprima: Esecuzione ogni 30 secondi
```

**Sincronizzazione Frequente:**
```
Intervallo: 5
Unità: Minuti
Anteprima: Esecuzione ogni 5 minuti
```

**Aggiornamento Orario:**
```
Intervallo: 2
Unità: Ore
Anteprima: Esecuzione ogni 2 ore
```

**Backup Giornaliero:**
```
Intervallo: 1
Unità: Giorni
Anteprima: Esecuzione ogni 1 giorno
```

**Report Settimanale:**
```
Intervallo: 1
Unità: Settimane
Anteprima: Esecuzione ogni 1 settimana
```

**Consolidamento Mensile:**
```
Intervallo: 1
Unità: Mesi
Anteprima: Esecuzione ogni 1 mese
```

---

### 3. **Giornaliera** (`daily`)
Esecuzione ogni giorno alla stessa ora.

**Configurazione:**
- **Ora di Esecuzione**: Formato 24 ore (es: `14:30`)

**Esempio:**
```
Tipo: Giornaliera
Ora: 09:00
Risultato: Esegue ogni giorno alle 09:00
```

---

### 4. **Settimanale** (`weekly`)
Esecuzione in un giorno specifico della settimana.

**Configurazione:**
- **Ora di Esecuzione**: Formato 24 ore
- **Giorno della Settimana**: Seleziona dal dropdown

**Esempio:**
```
Tipo: Settimanale
Ora: 10:00
Giorno: Lunedì
Risultato: Esegue ogni Lunedì alle 10:00
```

---

### 5. **Mensile** (`monthly`)
Esecuzione in un giorno specifico del mese.

**Configurazione:**
- **Ora di Esecuzione**: Formato 24 ore
- **Giorno del Mese**: Numero da 1 a 31

**Esempio:**
```
Tipo: Mensile
Ora: 08:00
Giorno: 1
Risultato: Esegue il primo giorno di ogni mese alle 08:00
```

---

## 🎛️ Opzioni Avanzate

### Schedulazione Attiva
- **Checkbox "Schedulazione attiva"**
- Se spuntato: la schedulazione sarà abilitata e verrà eseguita
- Se non spuntato: la schedulazione sarà salvata ma non eseguita

### Override Database (Opzionale)
Se il profilo selezionato lo supporta, puoi sovrascrivere:
- **Database Sorgente**: Per eseguire su un database diverso
- **Database Destinazione**: Per scrivere su un database diverso

---

## 💾 Salvare la Schedulazione

1. Verifica che tutti i campi obbligatori siano compilati
2. Clicca sul pulsante **"💾 Salva"**
3. Vedrai un messaggio di conferma
4. La schedulazione apparirà nella lista principale

---

## 📊 Visualizzazione delle Schedulazioni

### Card Schedulazione

Ogni schedulazione è mostrata in una card con:

**Header:**
- Icona del tipo (🔁 per intervalli, 📅 per altre)
- Nome schedulazione
- Menu dropdown ⋮ per azioni

**Corpo:**
- **Profilo**: Nome del profilo associato
- **Descrizione**: Se presente
- **Tipo**: Descrizione leggibile del tipo di schedulazione
  - Esempio per intervalli: `"INTERVALLO: Ogni 5 minuti"`
- **Prossima Esecuzione**: Data e ora della prossima esecuzione prevista
- **Ultima Esecuzione**: Data e ora dell'ultima esecuzione (se presente)
- **Status**: Badge colorato con risultato ultima esecuzione
  - 🟢 Verde: Success
  - 🔴 Rosso: Failed
  - 🔵 Blu: Running

**Bordo Card:**
- 🟢 Verde: Schedulazione attiva
- ⚫ Grigio: Schedulazione disabilitata

---

## ⚙️ Azioni su Schedulazioni Esistenti

### Menu Dropdown (⋮)

**✏️ Modifica**
- Apre il modal di modifica
- Tutti i campi sono precompilati con i valori attuali
- Salva per applicare le modifiche

**▶️ Esegui Ora**
- Esegue immediatamente la schedulazione
- Non modifica la prossima esecuzione programmata
- Utile per test o esecuzioni fuori programma

**🗑️ Elimina**
- Richiede conferma
- Elimina permanentemente la schedulazione
- Non elimina il profilo associato

---

## 🔍 Monitoraggio Esecuzioni

### Pulsante "📜 Storico Esecuzioni"
In alto a destra, clicca per vedere:
- Tutte le esecuzioni passate
- Status (success/failed)
- Numero di record trasferiti
- Durata esecuzione
- Messaggi di errore (se presenti)

---

## 💡 Best Practices per Intervalli

### Ambienti Diversi

**Sviluppo/Test:**
- Usa intervalli brevi (30-60 secondi) per test rapidi
- Ricorda di disabilitare o eliminare dopo i test

**Staging:**
- Intervalli moderati (1-5 minuti)
- Simula il carico di produzione

**Produzione:**
- Intervalli consigliati: minimo 5-10 minuti
- Valuta il carico sul sistema e sulle API
- Monitora le performance

### Considerazioni Performance

**Intervalli Brevi (<1 minuto):**
- ⚠️ Usa solo se necessario
- Aumenta il carico su database e API
- Monitora CPU e memoria
- Considera limitazioni API rate limits

**Intervalli Ottimali (5-15 minuti):**
- ✅ Bilanciamento tra freschezza dati e performance
- ✅ Riduce carico sistema
- ✅ Permette completamento esecuzioni precedenti

**Intervalli Lunghi (>1 ora):**
- ✅ Ideale per grandi dataset
- ✅ Minimo impatto sistema
- ✅ Adatto per backup e consolidamenti

---

## 🎯 Esempi di Configurazione

### Caso d'Uso 1: Sincronizzazione Real-Time Salesforce

```
Nome: Sync Leads Salesforce Real-Time
Profilo: Salesforce to SQL - Leads
Tipo: Intervallo Personalizzato
Intervallo: 2
Unità: Minuti
Schedulazione Attiva: ✅
```

**Risultato**: Sincronizza leads ogni 2 minuti durante l'orario lavorativo.

---

### Caso d'Uso 2: Backup Database Notturno

```
Nome: Backup Database Notte
Profilo: Full Database Backup
Tipo: Giornaliera
Ora: 02:00
Schedulazione Attiva: ✅
```

**Risultato**: Backup completo ogni notte alle 02:00.

---

### Caso d'Uso 3: Report Settimanale

```
Nome: Report Vendite Settimanale
Profilo: Sales Report
Tipo: Settimanale
Ora: 09:00
Giorno: Lunedì
Schedulazione Attiva: ✅
```

**Risultato**: Genera report vendite ogni Lunedì mattina.

---

### Caso d'Uso 4: Test Incrementale

```
Nome: Test Sync Every 30s
Profilo: Test Profile
Tipo: Intervallo Personalizzato
Intervallo: 30
Unità: Secondi
Schedulazione Attiva: ✅
```

**Risultato**: Test con sincronizzazione ogni 30 secondi (ricorda di disabilitare dopo test!).

---

### Caso d'Uso 5: Consolidamento Mensile

```
Nome: Consolidamento Fine Mese
Profilo: Monthly Consolidation
Tipo: Mensile
Ora: 23:00
Giorno: 28
Schedulazione Attiva: ✅
```

**Risultato**: Consolidamento dati il 28 di ogni mese alle 23:00.

---

## 🛠️ Troubleshooting

### Schedulazione Non Si Esegue

**Verifica:**
1. ✅ Schedulazione è attiva (checkbox spuntato)
2. ✅ Profilo associato esiste ed è attivo
3. ✅ NextExecutionTime è impostato (visibile nella card)
4. ✅ Background service è in esecuzione (verifica log applicazione)

### Intervalli Troppo Frequenti

**Sintomi:**
- Alta CPU/Memoria
- Log pieni di esecuzioni
- Timeout o errori API

**Soluzione:**
1. Modifica schedulazione
2. Aumenta intervallo (es: da 30s a 5min)
3. Monitora per 30-60 minuti

### Esecuzioni Saltate

**Causa Possibile:**
- Esecuzione precedente ancora in corso
- Sistema sotto carico

**Soluzione:**
- Il sistema salta automaticamente se già in esecuzione
- Aumenta intervallo se succede spesso
- Verifica durata media esecuzioni nello storico

---

## 📞 Supporto

Per problemi o domande:
1. Controlla i log applicazione
2. Consulta la documentazione tecnica (`ADVANCED_SCHEDULING_SYSTEM.md`)
3. Verifica lo storico esecuzioni per errori specifici

---

## 🔄 Aggiornamenti Futuri

Funzionalità pianificate:
- Dashboard monitoraggio real-time
- Notifiche email su errori
- Pause/Resume schedulazioni
- Dependency chains tra schedulazioni
- Export/import configurazioni

---

**Versione**: 2.0  
**Data**: Ottobre 2025  
**Compatibile con**: Data-Coupler .NET 9.0  
**Autore**: Alessio Dalsanto

---

## 🎉 Conclusione

La nuova interfaccia di schedulazione con intervalli personalizzati offre massima flessibilità per qualsiasi scenario di sincronizzazione dati. Utilizza gli esempi e le best practices per configurare schedulazioni ottimali per il tuo ambiente! 🚀