Come funzionano le scansioni
Quando lanciate una scansione, DQS elabora i vostri record Salesforce rispetto alle capability che avete configurato. La scansione viene eseguita in background utilizzando Salesforce Batch Apex, così potete continuare a lavorare mentre l’elaborazione è in corso.
DQS rispetta automaticamente i governor limit di Salesforce. La vostra org resta reattiva durante le scansioni.
Eseguire una scansione manuale
Avviare una scansione
- Aprite DQS dall’App Launcher
- Trovate la vostra Definition nell’elenco
- Cliccate Run Scan (o l’icona play)
- Confermate per avviare
La scansione comincia a elaborare immediatamente.
Indicatori di stato della scansione
| Stato | Icona | Significato |
|---|---|---|
| Queued | Orologio | In attesa di avvio |
| Processing | Spinner | In esecuzione |
| Completed | Segno di spunta | Terminata con successo |
| Failed | X | Si è verificato un errore |
Visualizzare le scansioni attive
La schermata principale di DQS mostra tutte le scansioni in corso:
- Nome della Definition
- Percentuale di avanzamento
- Record elaborati / totale
- Tempo trascorso
- Tempo stimato rimanente
Comprendere l’avanzamento
Monitoraggio dell’avanzamento
DQS elabora i record in batch. La barra di avanzamento mostra:
- Batch completati sul totale dei batch
- Record elaborati sul totale dei record
- Capability corrente in fase di valutazione
Esempio: “Processing batch 5 of 12 (2.500 di 6.000 record) - Completeness”
Ordine di elaborazione
DQS valuta le capability in questo ordine:
- Completezza (controlli rapidi sui campi)
- Validità (corrispondenza dei pattern di formato)
- Tempestività (confronti tra date)
- Coerenza (conformità dei valori)
- Unicità (rilevamento dei duplicati)
- Capability AI Readiness
Le capability a costo più basso vengono eseguite per prime per fornire un riscontro rapido.
Tempo stimato
La durata della scansione dipende da:
| Fattore | Impatto |
|---|---|
| Numero di record | Più record = tempo maggiore |
| Numero di campi | Più campi = tempo maggiore |
| Costo della capability | Le capability HIGH richiedono più tempo |
| Carico dell’org | Le org molto attive elaborano più lentamente |
Velocità di elaborazione tipiche:
| Numero di record | Tempo stimato |
|---|---|
| 1.000 | Meno di 1 minuto |
| 10.000 | 2-5 minuti |
| 100.000 | 15-30 minuti |
| 1.000.000+ | 1-2 ore |
Sono stime. Il tempo effettivo varia in base alla selezione delle capability e all’attività dell’org.
Costi di elaborazione
Ogni capability ha un costo di elaborazione che incide sulla durata della scansione.
Livelli di costo
| Costo | Capability | Note sull’elaborazione |
|---|---|---|
| LOW | Completezza, Validità | Controlli semplici sui campi per ogni record |
| MEDIUM | Tempestività, Coerenza, Rilevamento PII | Analisi dei pattern e calcoli sulle date |
| HIGH | Unicità | Confronti tra record |
Calcolo del costo
Il riepilogo della Definition mostra il costo totale stimato:
- Low - Tutte le capability selezionate sono a costo LOW
- Medium - Almeno una capability a costo MEDIUM
- High - Almeno una capability a costo HIGH
Suggerimento: per la vostra prima scansione su un dataset di grandi dimensioni, iniziate solo con le capability a costo LOW. Aggiungete le capability a costo HIGH una volta compresa la baseline.
Dettagli dell’elaborazione in batch
Come funziona Batch Apex
DQS utilizza Salesforce Batch Apex per elaborare i record. Ecco cosa significa:
- I record vengono divisi in batch (default: 200 record per batch)
- Ogni batch viene elaborato in modo indipendente
- Se un batch fallisce, gli altri proseguono
- I governor limit si azzerano tra un batch e l’altro
Questo approccio consente a DQS di:
- Elaborare milioni di record
- Rispettare i limiti di Salesforce
- Funzionare senza bloccare gli utenti
- Riprendere in caso di interruzione
Salesforce governor limit
Batch Apex prevede questi limiti principali:
| Limite | Valore | Note |
|---|---|---|
| Batch job massimi in coda | 5 | DQS usa 1 job per scansione |
| Record tramite QueryLocator | 50 milioni | Più che sufficienti per la maggior parte delle org |
| Esecuzioni batch giornaliere | 250.000 | Su tutti i batch job dell’org |
DQS è progettato per restare ampiamente entro questi limiti.
Ottimizzazione della dimensione dei batch
DQS regola la dimensione dei batch in base alla complessità delle capability:
| Tipo di capability | Dimensione del batch |
|---|---|
| Solo costo LOW | 200 record |
| Costo MEDIUM incluso | 200 record |
| Costo HIGH incluso | 100 record |
Batch più piccoli per le capability complesse prevengono gli errori di timeout.
Gestire dataset di grandi dimensioni
Dataset oltre 100.000 record
Per i dataset di grandi dimensioni, seguite queste pratiche:
- Usate i filtri per limitare l’ambito
- Iniziate con le capability a costo LOW
- Eseguite nelle ore di minor carico quando possibile
- Monitorate l’avanzamento per individuare eventuali problemi
Dataset oltre 1 milione di record
Per i dataset molto grandi:
- Segmentate i dati usando più Definition con filtri
- Pianificate le scansioni durante le finestre di manutenzione
- Eseguite le capability separatamente se necessario
- Usate la segmentazione per elaborare i dati in parallelo
Esempio di segmentazione:
- Definition A: Contact con Region = ‘Americas’
- Definition B: Contact con Region = ‘EMEA’
- Definition C: Contact con Region = ‘APAC’
Consigli sulle prestazioni
| Suggerimento | Beneficio |
|---|---|
| Meno campi per Definition | Elaborazione più veloce |
| Usare i filtri sui record | Dataset più piccolo da scansionare |
| Eseguire separatamente le capability a costo HIGH | Migliore visibilità dell’avanzamento |
| Pianificare nelle ore di minor carico | Minore competizione per le risorse |
Completamento della scansione
Notifiche di completamento
Quando una scansione termina, ricevete:
- Notifica in-app - L’icona a campana segnala i nuovi risultati
- Notifica via email - Un riepilogo inviato alla vostra email
- Aggiornamento della schermata principale - Lo stato passa a Completed
Visualizzare i risultati
Cliccate su una scansione completata per vedere:
- Punteggio di qualità complessivo
- Punteggi a livello di dimensione
- Dettagli delle metriche
- Approfondimento fino ai record interessati
Consultate Interpretare i risultati per indicazioni sull’interpretazione.
Storico delle scansioni
DQS conserva lo storico di tutte le scansioni per ciascuna Definition:
- Data e ora
- Durata
- Numero di record
- Punteggio complessivo
- Confronto con la scansione precedente
Usate lo storico per monitorare il miglioramento nel tempo.
Pianificare le scansioni
Potete pianificare scansioni ricorrenti per automatizzare il monitoraggio della qualità dei dati.
Impostare una pianificazione
- Aprite la vostra Definition
- Cliccate Schedule (icona orologio)
- Scegliete la frequenza:
- Giornaliera
- Settimanale (selezionate il giorno)
- Mensile (selezionate la data)
- Impostate l’ora di avvio
- Cliccate Save Schedule
Migliori pratiche per la pianificazione
| Frequenza | Caso d’uso |
|---|---|
| Giornaliera | Inserimento dati ad alto volume, monitoraggio critico della qualità |
| Settimanale | Monitoraggio standard della qualità, analisi delle tendenze |
| Mensile | Reportistica direzionale, audit di conformità |
Suggerimento: pianificate le scansioni nelle ore di minor carico (mattina presto o fine settimana) per ridurre al minimo l’impatto sugli utenti.
Gestire le pianificazioni
Dalla pagina di dettaglio della Definition:
- Edit - Modificate la frequenza o l’orario
- Pause - Sospendete temporaneamente senza eliminare
- Resume - Riavviate una pianificazione sospesa
- Delete - Rimuovete completamente la pianificazione
Limiti della pianificazione
Le scansioni pianificate sono disponibili per tutti gli utenti, senza alcun limite al numero di pianificazioni che potete impostare.
Annullare una scansione
Come annullare
- Trovate la scansione in corso sulla schermata principale
- Cliccate l’icona di stop (o Cancel)
- Confermate l’annullamento
Cosa accade in caso di annullamento
- L’elaborazione si interrompe dopo il batch corrente
- I risultati parziali vengono salvati
- Lo stato passa a “Canceled”
- Potete visualizzare i dati parziali raccolti
Le scansioni annullate non vengono conteggiate nei limiti.
Risoluzione dei problemi
“Scan queued but not starting”
Causa: altri batch job nella vostra org sono in esecuzione.
Soluzione: attendete il completamento degli altri job. Salesforce consente al massimo 5 batch job concorrenti.
Verifica: Setup > Apex Jobs per vedere cosa è in esecuzione.
“Scan failed”
Causa: di solito un problema relativo ai dati o ai permessi.
Soluzione:
- Controllate il messaggio di errore nei dettagli della scansione
- Verificate di avere accesso all’oggetto e ai campi
- Rivedete eventuali condizioni di filtro alla ricerca di errori
- Provate a eseguire con un numero inferiore di record
“Scan taking too long”
Causa: dataset di grandi dimensioni o capability a costo HIGH.
Soluzione:
- Lasciate che si completi (terminerà comunque)
- Aggiungete filtri per ridurre il numero di record
- Rimuovete le capability a costo HIGH
- Pianificate nelle ore di minor carico
“Results don’t show all records”
Causa: le condizioni di filtro hanno escluso alcuni record.
Soluzione: rivedete e modificate i filtri della vostra Definition.
Prossimi passi
- Interpretare i risultati: interpretate i dati delle scansioni
- Guida al Definition Builder: modificate la vostra Definition