KQL Builder

Scopo & intenzione dell’utente: lo strumento traduce obiettivi aziendali in espressioni KQL eDiscovery robuste, consentendo a team legali e IT di elaborare ricerche accurate su email, documenti, chat e archivi. Enfatizza la ripetibilità, tracce verificabili e esportabilità per flussi di lavoro di contenzioso e conformità. Utenti previsti: analisti eDiscovery, operazioni legali, responsabili conformità e IT admin che richiedono costruzione di query guidata dal dominio.
Logica centrale e funzionalità: Il sistema usa un modello basato sui campi con campi obbligatori, operatori e componenti di valore e supporta raggruppamenti avanzati tramite parentesi. Impone validazione della sintassi, precedenza degli operatori e esportazione strutturata. Funzioni opzionali: modelli riutilizzabili, storia delle versioni, import/export di modelli e blocchi JSON pronti per API.
Input & Output: Gli utenti forniscono ambito contenuto, definizioni di campo, intervalli di date, flag allegati e valori di esempio. Lo strumento restituisce una stringa KQL, un riepilogo e un flag di validità della sintassi, con validazione ISO-8601. L’esportazione può essere query autonome o blocchi integrati in pipeline aziendali.
Algoritmi & Calcoli: Criteri di alto livello mappati su token KQL (ad es. contiene, uguale, inizia_con, termina_con). Il motore raggruppa espressioni tra parentesi, applica letterali di data, elude caratteri speciali e concatena token con logica AND/OR/NOT per formare la query finale.
Errori & Casi limite: Lo strumento segnala nomi di campi non validi, operatori non supportati, parentesi sbilanciate, valori vuoti o problemi di parsing data, con dettagli di errore strutturati e senza messaggi UI. Se fonti dati esterne non sono disponibili, conserva l’input e segnala il problema.
Industria/Regione & Localizzazione: Le date ISO-8601 sono necessarie; i tempi sono UTC a meno che non sia specificata una fuso orario. Si presume la sintassi KQL in inglese; la localizzazione è limitata ai formati di data.
Assunzioni & Esclusioni: Si assume accesso a un indice eDiscovery e mappatura dei campi alle entità supportate. UI, autenticazione e rendering dei dati non rientrano in ambito; solo generazione KQL e metadati sono prodotti.