Data-Coupler/TEST_HASH_COMPARISON.md

Test Hash Comparison - Guida al Debug

Problema Rilevato

Il sistema di confronto hash non sembra funzionare correttamente: i record vengono aggiornati anche quando i dati non sono cambiati.

Modifiche Apportate

Ho aggiunto logging dettagliato per tracciare:

1. Generazione Hash (GenerateDataHash)

   • 🔍 Numero di campi processati
   • 🔍 Elenco campi ordinati
   • 🔍 Stringa combinata prima dell'hashing
   • ✅ Hash finale generato

2. Confronto Hash (in StartDataTransferWithComposite)

   • 📌 Hash esistente nel database
   • 📌 Hash calcolato sul record corrente
   • ✅ Decisione: saltato o aggiornato
   • ⚠️ Warning se hash diversi

Come Testare

Passo 1: Accedi all'applicazione

L'applicazione è già in esecuzione su: http://localhost:7550

Passo 2: Configura un trasferimento

1. Seleziona una sorgente dati (database o REST API)
2. Seleziona una destinazione (REST API)
3. Configura i mapping dei campi
4. IMPORTANTE: Assicurati che "Usa associazioni record" sia abilitato

Passo 3: Esegui il primo trasferimento

1. Esegui il trasferimento con alcuni record
2. Verifica che i record vengano creati correttamente
3. Annotati quanti record sono stati creati

Passo 4: Esegui il trasferimento duplicato

1. SENZA modificare i dati sorgente, esegui di nuovo lo stesso trasferimento
2. ATTESO: Tutti i record dovrebbero essere saltati (hash identico)
3. PROBLEMA: Se i record vengono aggiornati, c'è un problema

Passo 5: Analizza i log

Apri la console PowerShell dove sta girando l'applicazione e cerca:

Log di Generazione Hash

🔍 HASH DEBUG: Generazione hash per X campi
🔍 HASH DEBUG: Campi ordinati: [campo1, campo2, campo3, ...]
🔍 HASH DEBUG: Stringa combinata: campo1=valore1|campo2=valore2|...
✅ HASH DEBUG: Hash finale generato: 1A2B3C4D5E6F...

Log di Confronto Hash (IMPORTANTE!)

🔍 CONFRONTO HASH - Record 1:
   📌 Hash esistente: 1A2B3C4D5E6F...
   📌 Hash corrente:  1A2B3C4D5E6F...
✅ HASH IDENTICO - Record 1 saltato

oppure

🔍 CONFRONTO HASH - Record 1:
   📌 Hash esistente: 1A2B3C4D5E6F...
   📌 Hash corrente:  9Z8Y7X6W5V4U...  <-- DIVERSO!
⚠️ HASH DIVERSO - Record 1 marcato per aggiornamento (EntityId: 001...)

Cosa Cercare nei Log

✅ Scenario Corretto (Hash Identico)

Se lo stesso record viene processato due volte:

• La "Stringa combinata" deve essere identica
• L'hash generato deve essere identico
• Il record deve essere saltato

⚠️ Scenario Problematico (Hash Diverso)

Se gli hash sono diversi pur con gli stessi dati, cerca differenze nella "Stringa combinata":

Possibili Cause

1. Campi timestamp generati automaticamente

   • Se un campo contiene DateTime.Now o timestamp auto-generati
   • L'hash cambierà sempre

2. Valori con formato diverso

   • Decimali: 10.5 vs 10,5 (cultura)
   • Date: 2024-01-01 vs 01/01/2024
   • Boolean: true vs True vs 1

3. Campi che non dovrebbero essere nell'hash

   • Campi di sistema (ID, CreatedAt, UpdatedAt, ecc.)
   • Campi calcolati dinamicamente

4. Ordine campi diverso (già gestito con .OrderBy)

   • Dovrebbe essere risolto, ma verifica che i campi siano nello stesso ordine

Prossimi Passi in Base ai Risultati

Se Hash Identico ma Record Aggiornato Comunque

→ Problema nella logica di confronto o salvataggio hash

Se Hash Diverso con Dati Identici

→ Problema nella generazione hash (valori dinamici o formattazione)

Se Hash NULL nel Database

→ L'hash non viene salvato correttamente dopo il primo trasferimento

Esempio Output Atteso

Primo Trasferimento (Creazione)

🔍 HASH DEBUG: Generazione hash per 5 campi
🔍 HASH DEBUG: Campi ordinati: [Email, FirstName, LastName, Phone, Title]
🔍 HASH DEBUG: Stringa combinata: Email=john@example.com|FirstName=John|LastName=Doe|Phone=123456789|Title=Developer
✅ HASH DEBUG: Hash finale generato: A1B2C3D4E5F6...

COMPOSITE: Record 1 marcato per creazione
COMPOSITE: Associazione creata con ID: 1 per record 1 - Hash: A1B2C3D4E5F6...

Secondo Trasferimento (Stesso Dato - Dovrebbe Saltare)

🔍 HASH DEBUG: Generazione hash per 5 campi
🔍 HASH DEBUG: Campi ordinati: [Email, FirstName, LastName, Phone, Title]
🔍 HASH DEBUG: Stringa combinata: Email=john@example.com|FirstName=John|LastName=Doe|Phone=123456789|Title=Developer
✅ HASH DEBUG: Hash finale generato: A1B2C3D4E5F6...

🔍 CONFRONTO HASH - Record 1:
   📌 Hash esistente: A1B2C3D4E5F6...
   📌 Hash corrente:  A1B2C3D4E5F6...
✅ HASH IDENTICO - Record 1 saltato

Raccogli Informazioni

Per aiutarmi a risolvere il problema, copia e incolla:

1. Output del primo trasferimento (dai log della console)

   • Cerca le linee con "🔍 HASH DEBUG" e "✅ HASH DEBUG"

2. Output del secondo trasferimento (stesso dato)

   • Cerca le linee con "🔍 CONFRONTO HASH"
   • Verifica se gli hash sono identici

3. Risultato finale mostrato nell'UI

   • Quanti record creati/aggiornati/saltati

---

Nota: I log dettagliati sono attivi ora. Dopo il test, potremo ridurre il livello di logging.