Righe: Arricchisci sotto-descrizione

action_lines_enrich · action · Utility · Disponibile · v1.0.0

Descrizione

Arricchitore enterprise specializzato per righe ordine estratte da PDF fornitore, che gestisce il pattern semantico "descrizione su due righe" tipico dei documenti di fornitura B2B italiani: la prima riga contiene il codice articolo + descrizione principale ("ROT-COIL-220V Bobina elettrica"), la seconda riga sottostante porta dettagli tecnici specifici dell'item ("Voltaggio 220V AC 50Hz, IP65, certificata CE") che NON appartengono ad una nuova riga ordine ma sono qualificazione del codice precedente. Senza questo arricchimento, il parsing PDF naïve crea N+1 righe (1 per codice + 1 per descrizione) confondendo il downstream ERP import. Il nodo applica le regole configurate per identificare quali codici beneficiano di sub-description e li fonde nella product_description del corretto record line, eliminando le righe descrizione spurious. Logica intelligente di matching: solo i codici che corrispondono ai pattern regex configurati ottengono enrichment (es. "^ROT-[A-Z]+-[0-9]+V$" per matchare codici della famiglia ROT-COIL-220V/ROT-VALVE-380V/ ROT-MOTOR-110V), gli altri restano invariati. Esclude esplicitamente note generiche commerciali tipo "A saldo Vs. ordine n.X", "Spese accessorie", "Pagamento a 60gg fine mese", "IVA esposta" — testi che non sono descrizioni di prodotto ma metadata fiscali/commerciali. Customization rich delle regole: il customer admin definisce N pattern di matching con relativa policy di merge (concatenazione con separator " - ", append parentesi "(...) ", overwrite condizionato se la sub-description è più informativa, skip per pattern blocklist note generiche). Output: stesse lines del input ma con product_description arricchita per export downstream + lines.removed[] che traccia le righe descrizione fuse + audit log delle merge applicate per debug. Use case business reali da clienti enterprise: arricchire righe ordine estratte da PDF fornitore prima dell'export ERP (es. Sage X3, TeamSystem Polyedro, Zucchetti Ad Hoc) per evitare cleanup manuale del controller); integrare codici prodotto specifici per vertical industriale (es. attuatori/valvole industriali: bobine, voltage spec, IP rating per impiantistica), automazione automotive (codici OEM), elettromedicale (CND+ATC code); normalizzare descrizioni multi-riga di fornitori legacy in singolo campo searchable per data warehouse analytics (es. "fornitore X usa 2 righe descrizione, fornitore Y usa 3, fornitore Z usa 1 — normalizzo tutti a 1"); pre-processare ordini Excel ricevuti da clienti che mantengono ancora il "modello a due righe Excel" cartaceo migrato a digitale; harmonization di anagrafica prodotti tra subsidiary di gruppi multinazionali che ognuno ha format suo.

⚙️ Parametri di configurazione

Campi mostrati nell’editor quando si configura il nodo. Generati direttamente dal NodeDefconfigFields.

Campo	Tipo	Required	Default	Descrizione
`linesExpression` Righe sorgente	`expression`	no	— {{$node.extract_of.json.lines}}	Espressione che ritorna l'array lines[] da arricchire. Se vuoto, usa l'input del nodo precedente. Ogni riga DEVE avere almeno product_code, product_description (gli altri campi sono passthrough).
`rawTextExpression` Testo PDF grezzo	`expression`	si	— {{$node.pdf_extract.json.text}}	Espressione che ritorna il testo grezzo del PDF (output di pdf_extract). Serve per cercare le sotto-righe indentate sotto a ogni codice.
`includeCodePatterns` Codici che RICHIEDONO sotto-descrizione (uno per riga)	`string`	no	`^\d{1,2}\/$ -BOB$ -7000$ -3510$ -1865$ -24DC$ -24AC$ -2400$`	Una regex per riga, applicata al product_code. Se il codice matcha UNA delle regex, la sotto-descrizione viene cercata e aggiunta a product_description. Default inclusi (esempio industriale): • ^\d{1,2}\/$ — codici generici tipo "27/", "8/" • -BOB$ — bobine senza voltage specifico (es. "RB206DBX-BOB") • -7000$, -3510$, -1865$, -24DC$, -24AC$, -2400$ — varianti voltage/sigla Aggiungi altri pattern del tuo dominio: es. "^OPZ-" per opzionali, "-CUSTOM$" per personalizzazioni.
`excludePrefixes` Sotto-righe da IGNORARE (uno per riga)	`string`	no	`A saldo Vs. ordine In acc. Vs. ordine Vostro riferimento Nostro riferimento`	Prefissi case-insensitive: se la sotto-riga inizia con uno di questi, viene IGNORATA (non aggiunta a product_description). Tipico: note amministrative, riferimenti commerciali, marker di pagamento.
`separator` Separatore tra descrizione e sotto-descrizione	`string`	no	`—`	Stringa inserita tra descrizione e sotto-descrizione quando entrambe sono presenti. Default " — " (em dash). Altre opzioni: " · " (interpunct), "\n" (newline, per wrap cella Excel), " \| " (pipe).

⬆️ Output del nodo

Campi disponibili nei nodi successivi via $node.<alias>.json.<field>:

lines
enrichedCount

💡 Esempio configurazione

Snippet JSON del nodo come compare nel workflow. I valori sono derivati daidefaultValue e dai parametri required.

{
  "id": "node-action_lines_enrich-1",
  "defId": "action_lines_enrich",
  "label": "Righe: Arricchisci sotto-descrizione",
  "config": {
    "rawTextExpression": "{{$node.pdf_extract.json.text}}",
    "includeCodePatterns": "^\\d{1,2}\\/$\n-BOB$\n-7000$\n-3510$\n-1865$\n-24DC$\n-24AC$\n-2400$",
    "excludePrefixes": "A saldo Vs. ordine\nIn acc. Vs. ordine\nVostro riferimento\nNostro riferimento",
    "separator": " — "
  }
}

🔗 Nodi correlati nella stessa categoria

Pronto a usare Righe: Arricchisci sotto-descrizione?

Disponibile da subito in tutti i piani FlowForge. Provalo gratis senza carta di credito.

Inizia gratis Sfoglia tutti i nodi