Eventi e apply

L’elemento comunica interamente tramite CustomEvent del DOM — iscriviti a quanti ne servono.

Evento	Si attiva quando	`detail` include
`import-ready`	Licenza verificata, widget montato	`tenantId`
`import-ingested`	Un file viene decodificato in un record	`recordId`, `deduplicated`
`import-mapped`	Le colonne vengono abbinate al tuo schema	`recordId`, `mapping`
`import-step`	La procedura avanza di un passo	`step`, `previous`
`import-applied`	L’importazione viene consegnata	`recordId`, `action`, `rowCount`
`import-error`	Qualcosa fallisce	`code`, `message`, `step`
`import-cancel`	L’utente annulla l’importazione	—

Gli eventi trasportano riassunti, non i dati stessi — import-applied ti dice che le righe sono state consegnate e quante, mai le righe:

const el = document.querySelector('mildport-import')!;

el.addEventListener('import-applied', e => {
  const { rowCount, action } = (e as CustomEvent).detail;
  console.log(`${rowCount} rows delivered (${action})`);
});

Due modi per ricevere le righe

Modalità browser (applyMode = 'browser') — le righe (e il mapping che le ha prodotte) vengono consegnate alla property onResults dell’elemento quando l’utente applica:

el.onResults = (rows, mapping) => saveRows(rows, mapping);

Vuoi ispezionare o bloccare l’invio prima che si completi? Usa il resultsHook (terzo argomento di mountImportFlow) — le stesse righe, più i controlli di veto:

mountImportFlow(el, flowInput, {
  resultsHook: ({ rows, mapping }, controls) => {
    // controls.block('reason') vetoes the submit; doing nothing lets it proceed.
  },
});

Ottimo per demo, embed offline e flussi lato client.

Modalità webhook (applyMode = 'webhook') — il motore invia le righe applicate al tuo backend via POST come consegna firmata in HMAC, con ritentativi durevoli e un log di audit. Questo è il percorso di produzione. Vedi il riferimento webhook per la firma e gli header.