@noeva/etl-core 1.0.0-next.1 → 1.0.0-next.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli.js +103 -103
- package/dist/guida/404.html +2 -2
- package/dist/guida/GUIDA_SVILUPPO.html +5 -5
- package/dist/guida/TECHNICAL_OVERVIEW.html +3 -3
- package/dist/guida/assets/{GUIDA_SVILUPPO.md.Dj20s7gS.js → GUIDA_SVILUPPO.md.D13C7Zwu.js} +1 -1
- package/dist/guida/assets/{app.vAJRZtow.js → app.BMz6ZZYF.js} +1 -1
- package/dist/guida/assets/chunks/@localSearchIndexroot.B3bE99g8.js +1 -0
- package/dist/guida/assets/chunks/{VPLocalSearchBox.D3nX303F.js → VPLocalSearchBox.D8gO6gDY.js} +1 -1
- package/dist/guida/assets/chunks/{theme.Bq6mfDhZ.js → theme.DV62mViB.js} +2 -2
- package/dist/guida/connectors/README.html +3 -3
- package/dist/guida/connectors/file.html +3 -3
- package/dist/guida/connectors/http.html +3 -3
- package/dist/guida/connectors/imap.html +3 -3
- package/dist/guida/connectors/jira.html +3 -3
- package/dist/guida/connectors/noeva.html +3 -3
- package/dist/guida/connectors/oauth.html +3 -3
- package/dist/guida/connectors/postgres.html +3 -3
- package/dist/guida/connectors/process.html +3 -3
- package/dist/guida/connectors/sendgrid.html +3 -3
- package/dist/guida/connectors/smtp.html +3 -3
- package/dist/guida/connectors/sqlserver.html +3 -3
- package/dist/guida/conventions/node-columns.html +3 -3
- package/dist/guida/conventions/node-descriptor.html +3 -3
- package/dist/guida/conventions/run-report.html +3 -3
- package/dist/guida/conventions/run-trace.html +3 -3
- package/dist/guida/conventions/variabili-del-core.html +3 -3
- package/dist/guida/conventions/versioni-di-pipeline.html +3 -3
- package/dist/guida/guide/claude-code/index.html +3 -3
- package/dist/guida/guide/claude-code/prompt.html +3 -3
- package/dist/guida/guide/claude-code/strumenti.html +3 -3
- package/dist/guida/guide/grafo.html +3 -3
- package/dist/guida/guide/usare/app-desktop.html +3 -3
- package/dist/guida/guide/usare/esito-di-una-run.html +3 -3
- package/dist/guida/guide/usare/index.html +3 -3
- package/dist/guida/hashmap.json +1 -1
- package/dist/guida/index.html +3 -3
- package/dist/guida/nodes/README.html +3 -3
- package/dist/guida/nodes/action.html +3 -3
- package/dist/guida/nodes/ai.html +3 -3
- package/dist/guida/nodes/join.html +3 -3
- package/dist/guida/nodes/lookup.html +3 -3
- package/dist/guida/nodes/pipeline.html +3 -3
- package/dist/guida/nodes/route.html +3 -3
- package/dist/guida/nodes/sink.html +3 -3
- package/dist/guida/nodes/source.html +3 -3
- package/dist/guida/nodes/task.html +3 -3
- package/dist/guida/nodes/transform.html +3 -3
- package/dist/guida/nodes/try-catch.html +3 -3
- package/dist/guida/nodes/union.html +3 -3
- package/dist/guida/pipelines/README.html +3 -3
- package/dist/guida/pipelines/crm-leads-sync.html +3 -3
- package/dist/guida/pipelines/cross-workspace-csv-merge.html +3 -3
- package/dist/guida/pipelines/movimenti-per-conto.html +3 -3
- package/dist/guida/pipelines/orders-enriched-daily.html +3 -3
- package/dist/guida/pipelines/test-posta.html +3 -3
- package/dist/guida/runbooks/aggiornamento-pm2.html +3 -3
- package/dist/guida/runbooks/deployment.html +3 -3
- package/dist/guida/runbooks/etl-worker.html +3 -3
- package/dist/guida/runbooks/graph-server.html +3 -3
- package/dist/guida/runbooks/mask-key.html +3 -3
- package/dist/guida/runbooks/oauth-google-posta.html +3 -3
- package/dist/guida/runbooks/rollback-di-pipeline.html +3 -3
- package/dist/guida/runbooks/scd2-rehash.html +3 -3
- package/dist/guida/runbooks/sql-task-truncate-swap.html +3 -3
- package/dist/guida/runbooks/stato-incrementale.html +3 -3
- package/dist/guida/sub-pipelines/README.html +3 -3
- package/dist/guida/sub-pipelines/riepilogo-ordini.html +3 -3
- package/package.json +1 -1
- package/dist/guida/assets/chunks/@localSearchIndexroot.Bhyx8u0i.js +0 -1
- /package/dist/guida/assets/{GUIDA_SVILUPPO.md.Dj20s7gS.lean.js → GUIDA_SVILUPPO.md.D13C7Zwu.lean.js} +0 -0
|
@@ -9,9 +9,9 @@
|
|
|
9
9
|
<link rel="preload stylesheet" href="/guida/core/assets/style.BNn_AkzN.css" as="style">
|
|
10
10
|
<link rel="preload stylesheet" href="/guida/core/vp-icons.css" as="style">
|
|
11
11
|
|
|
12
|
-
<script type="module" src="/guida/core/assets/app.
|
|
12
|
+
<script type="module" src="/guida/core/assets/app.BMz6ZZYF.js"></script>
|
|
13
13
|
<link rel="preload" href="/guida/core/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
|
|
14
|
-
<link rel="modulepreload" href="/guida/core/assets/chunks/theme.
|
|
14
|
+
<link rel="modulepreload" href="/guida/core/assets/chunks/theme.DV62mViB.js">
|
|
15
15
|
<link rel="modulepreload" href="/guida/core/assets/chunks/framework.qdetmeNX.js">
|
|
16
16
|
<link rel="modulepreload" href="/guida/core/assets/pipelines_README.md.Ee6LS-SU.lean.js">
|
|
17
17
|
<link rel="icon" type="image/svg+xml" href="/guida/core/favicon.svg">
|
|
@@ -93,7 +93,7 @@
|
|
|
93
93
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">recente, la voce scritta dall'autore e sotto il diff di nodi, archi e colonne rispetto alla</span></span>
|
|
94
94
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">precedente, con «rompe il contratto» se una colonna di un sink sparisce, cambia nome o cambia tipo. Non si</span></span>
|
|
95
95
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">scrive a mano: vedi [</span><span style="--shiki-light:#032F62;--shiki-light-text-decoration:underline;--shiki-dark:#DBEDFF;--shiki-dark-text-decoration:underline;">versioni di pipeline</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">](</span><span style="--shiki-light:#24292E;--shiki-light-text-decoration:underline;--shiki-dark:#E1E4E8;--shiki-dark-text-decoration:underline;">../conventions/versioni-di-pipeline.md</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">).</span></span></code></pre></div></div></div></main><footer class="VPDocFooter" data-v-303c7d43 data-v-64d0b887><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-64d0b887><span class="visually-hidden" id="doc-footer-aria-label" data-v-64d0b887>Pager</span><div class="pager" data-v-64d0b887><a class="VPLink link pager-link prev" href="/guida/core/connectors/sqlserver" data-v-64d0b887><!--[--><span class="desc" data-v-64d0b887>Pagina precedente</span><span class="title" data-v-64d0b887>SQL Server</span><!--]--></a></div><div class="pager" data-v-64d0b887><a class="VPLink link pager-link next" href="/guida/core/pipelines/test-posta" data-v-64d0b887><!--[--><span class="desc" data-v-64d0b887>Pagina successiva</span><span class="title" data-v-64d0b887>test-posta</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-f5dee57d data-v-e10de3dd><div class="container" data-v-e10de3dd><p class="message" data-v-e10de3dd>Noeva è un marchio registrato di 4D S.R.L.</p><p class="copyright" data-v-e10de3dd>© 2026 4D S.R.L. · Gruppo4D</p></div></footer><!--[--><span hidden></span><!--]--></div></div>
|
|
96
|
-
<script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"DUHajB0u\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"ChyXSf73\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"D8Si7E2S\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"
|
|
96
|
+
<script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"DUHajB0u\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"ChyXSf73\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"D8Si7E2S\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"D13C7Zwu\",\"guide_claude-code_index.md\":\"CxVSru8e\",\"guide_claude-code_prompt.md\":\"C7uETA9W\",\"guide_claude-code_strumenti.md\":\"BWhQnAlY\",\"guide_grafo.md\":\"Dy8_YMeh\",\"guide_usare_app-desktop.md\":\"CcDu8cJL\",\"guide_usare_esito-di-una-run.md\":\"DkvAOPBE\",\"guide_usare_index.md\":\"BJqi3P7J\",\"index.md\":\"kMhsF-sv\",\"nodes_action.md\":\"DOsTbV-i\",\"nodes_ai.md\":\"CVtP9gEJ\",\"nodes_join.md\":\"DSYbIDG6\",\"nodes_lookup.md\":\"BI8tgBIq\",\"nodes_pipeline.md\":\"DIMlyprm\",\"nodes_readme.md\":\"CHGy_go6\",\"nodes_route.md\":\"Bt9qH6OA\",\"nodes_sink.md\":\"yAf_z4wO\",\"nodes_source.md\":\"V_vlNfOz\",\"nodes_task.md\":\"Dk6VB7as\",\"nodes_transform.md\":\"Bv5fg2Xx\",\"nodes_try-catch.md\":\"DCYydDPm\",\"nodes_union.md\":\"CznVzHTK\",\"pipelines_crm-leads-sync.md\":\"BlZUnxYn\",\"pipelines_cross-workspace-csv-merge.md\":\"CsRE6GNe\",\"pipelines_movimenti-per-conto.md\":\"DRGfO1_5\",\"pipelines_orders-enriched-daily.md\":\"jESRtvBo\",\"pipelines_readme.md\":\"Ee6LS-SU\",\"pipelines_test-posta.md\":\"Cxo_DGBs\",\"runbooks_aggiornamento-pm2.md\":\"f3LAxif4\",\"runbooks_deployment.md\":\"DvIOOsoG\",\"runbooks_etl-worker.md\":\"Bu05cEgT\",\"runbooks_graph-server.md\":\"BOXZqdXC\",\"runbooks_mask-key.md\":\"nZkhAjBf\",\"runbooks_oauth-google-posta.md\":\"Bs7QTkmU\",\"runbooks_rollback-di-pipeline.md\":\"6US0Wsdc\",\"runbooks_scd2-rehash.md\":\"DtmuXA67\",\"runbooks_sql-task-truncate-swap.md\":\"C8viT-fp\",\"runbooks_stato-incrementale.md\":\"hGZ8FlbZ\",\"sub-pipelines_readme.md\":\"CF8gmNPU\",\"sub-pipelines_riepilogo-ordini.md\":\"qCBZJ4nh\",\"technical_overview.md\":\"DQP0pWc8\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"it-IT\",\"dir\":\"ltr\",\"title\":\"Noeva ETL\",\"titleTemplate\":\":title · Noeva ETL\",\"description\":\"Documentazione di Noeva ETL: come usare la piattaforma e come creare pipeline con Claude Code.\",\"base\":\"/guida/core/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":{\"light\":\"/logo-dark.png\",\"dark\":\"/logo-light.png\",\"alt\":\"Noeva\"},\"siteTitle\":false,\"footer\":{\"message\":\"Noeva è un marchio registrato di 4D S.R.L.\",\"copyright\":\"© 2026 4D S.R.L. · Gruppo4D\"},\"outline\":{\"level\":[2,3],\"label\":\"In questa pagina\"},\"docFooter\":{\"prev\":\"Pagina precedente\",\"next\":\"Pagina successiva\"},\"darkModeSwitchLabel\":\"Tema\",\"lightModeSwitchTitle\":\"Passa al tema chiaro\",\"darkModeSwitchTitle\":\"Passa al tema scuro\",\"sidebarMenuLabel\":\"Menu\",\"returnToTopLabel\":\"Torna su\",\"langMenuLabel\":\"Lingua\",\"notFound\":{\"title\":\"PAGINA NON TROVATA\",\"quote\":\"Il documento che cercavi non c'è più, o non è mai stato pubblicato qui.\",\"linkLabel\":\"Torna alla home\",\"linkText\":\"Torna alla home\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Cerca\",\"buttonAriaLabel\":\"Cerca nella documentazione\"},\"modal\":{\"displayDetails\":\"Mostra i dettagli\",\"resetButtonTitle\":\"Azzera la ricerca\",\"backButtonTitle\":\"Chiudi la ricerca\",\"noResultsText\":\"Nessun risultato per\",\"footer\":{\"selectText\":\"per aprire\",\"selectKeyAriaLabel\":\"invio\",\"navigateText\":\"per spostarti\",\"navigateUpKeyAriaLabel\":\"freccia su\",\"navigateDownKeyAriaLabel\":\"freccia giù\",\"closeText\":\"per chiudere\",\"closeKeyAriaLabel\":\"esc\"}}}}},\"nav\":[{\"text\":\"Usare\",\"link\":\"/guide/usare/\",\"activeMatch\":\"^/guide/usare/\"},{\"text\":\"Creare con Claude Code\",\"link\":\"/guide/claude-code/\",\"activeMatch\":\"^/guide/claude-code/\"},{\"text\":\"Riferimento\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Tipi di nodo\",\"link\":\"/nodes/README\"},{\"text\":\"Connettori\",\"link\":\"/connectors/README\"},{\"text\":\"Pipeline pronte\",\"link\":\"/pipelines/README\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"},{\"text\":\"Operatività\",\"link\":\"/runbooks/graph-server\"}]}],\"sidebar\":[{\"text\":\"Usare Noeva ETL\",\"items\":[{\"text\":\"Come si usa\",\"link\":\"/guide/usare/\"},{\"text\":\"L'app desktop\",\"link\":\"/guide/usare/app-desktop\"},{\"text\":\"Leggere l'esito di una run\",\"link\":\"/guide/usare/esito-di-una-run\"},{\"text\":\"Panoramica di prodotto\",\"link\":\"/TECHNICAL_OVERVIEW\"}]},{\"text\":\"Creare con Claude Code\",\"items\":[{\"text\":\"Dal bisogno al processo\",\"link\":\"/guide/claude-code/\"},{\"text\":\"Comporre il prompt\",\"link\":\"/guide/claude-code/prompt\"},{\"text\":\"Skill e subagent\",\"link\":\"/guide/claude-code/strumenti\"},{\"text\":\"Guida allo sviluppo\",\"link\":\"/GUIDA_SVILUPPO\"}]},{\"text\":\"Concetti\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Versioni di pipeline\",\"link\":\"/conventions/versioni-di-pipeline\"},{\"text\":\"Descriptor dei nodi\",\"link\":\"/conventions/node-descriptor\"},{\"text\":\"Colonne dei nodi\",\"link\":\"/conventions/node-columns\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"}]},{\"text\":\"Tipi di nodo\",\"collapsed\":true,\"items\":[{\"text\":\"Cheatsheet\",\"link\":\"/nodes/README\"},{\"text\":\"action\",\"link\":\"/nodes/action\"},{\"text\":\"ai\",\"link\":\"/nodes/ai\"},{\"text\":\"join\",\"link\":\"/nodes/join\"},{\"text\":\"lookup\",\"link\":\"/nodes/lookup\"},{\"text\":\"pipeline\",\"link\":\"/nodes/pipeline\"},{\"text\":\"route\",\"link\":\"/nodes/route\"},{\"text\":\"sink\",\"link\":\"/nodes/sink\"},{\"text\":\"source\",\"link\":\"/nodes/source\"},{\"text\":\"task\",\"link\":\"/nodes/task\"},{\"text\":\"transform\",\"link\":\"/nodes/transform\"},{\"text\":\"try-catch\",\"link\":\"/nodes/try-catch\"},{\"text\":\"union\",\"link\":\"/nodes/union\"}]},{\"text\":\"Connettori\",\"collapsed\":true,\"items\":[{\"text\":\"Panoramica\",\"link\":\"/connectors/README\"},{\"text\":\"File (storage × codec)\",\"link\":\"/connectors/file\"},{\"text\":\"HTTP (API REST per i nodi lookup e action)\",\"link\":\"/connectors/http\"},{\"text\":\"IMAP (caselle di posta)\",\"link\":\"/connectors/imap\"},{\"text\":\"Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)\",\"link\":\"/connectors/jira\"},{\"text\":\"Noeva (file dei workspace)\",\"link\":\"/connectors/noeva\"},{\"text\":\"OAuth2 per i connettori di posta\",\"link\":\"/connectors/oauth\"},{\"text\":\"PostgreSQL\",\"link\":\"/connectors/postgres\"},{\"text\":\"processo esterno\",\"link\":\"/connectors/process\"},{\"text\":\"SendGrid (mail via API REST)\",\"link\":\"/connectors/sendgrid\"},{\"text\":\"SMTP (notifiche email)\",\"link\":\"/connectors/smtp\"},{\"text\":\"SQL Server\",\"link\":\"/connectors/sqlserver\"}]},{\"text\":\"Pipeline pronte\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una pipeline\",\"link\":\"/pipelines/README\"},{\"text\":\"test-posta\",\"link\":\"/pipelines/test-posta\"}]},{\"text\":\"Esempi\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una sub-pipeline\",\"link\":\"/sub-pipelines/README\"},{\"text\":\"crm-leads-sync\",\"link\":\"/pipelines/crm-leads-sync\"},{\"text\":\"cross-workspace-csv-merge\",\"link\":\"/pipelines/cross-workspace-csv-merge\"},{\"text\":\"movimenti-per-conto\",\"link\":\"/pipelines/movimenti-per-conto\"},{\"text\":\"orders-enriched-daily\",\"link\":\"/pipelines/orders-enriched-daily\"},{\"text\":\"riepilogo-ordini\",\"link\":\"/sub-pipelines/riepilogo-ordini\"}]},{\"text\":\"Operatività\",\"collapsed\":true,\"items\":[{\"text\":\"aggiornare un deploy PM2 di un repo cliente\",\"link\":\"/runbooks/aggiornamento-pm2\"},{\"text\":\"distribuzione del runner ETL\",\"link\":\"/runbooks/deployment\"},{\"text\":\"worker etl worker (polling su processes)\",\"link\":\"/runbooks/etl-worker\"},{\"text\":\"server grafi etl serve (HTTP)\",\"link\":\"/runbooks/graph-server\"},{\"text\":\"chiavi di mask (creazione, rotazione, compromissione)\",\"link\":\"/runbooks/mask-key\"},{\"text\":\"OAuth2 per una casella Google (IMAP + SMTP)\",\"link\":\"/runbooks/oauth-google-posta\"},{\"text\":\"rollback di una pipeline\",\"link\":\"/runbooks/rollback-di-pipeline\"},{\"text\":\"rehash di una dimensione storicizzata\",\"link\":\"/runbooks/scd2-rehash\"},{\"text\":\"task SQL, truncate e scambio di tabelle\",\"link\":\"/runbooks/sql-task-truncate-swap\"},{\"text\":\"stato di pipeline e watermark\",\"link\":\"/runbooks/stato-incrementale\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
|
|
97
97
|
|
|
98
98
|
</body>
|
|
99
99
|
</html>
|
|
@@ -9,9 +9,9 @@
|
|
|
9
9
|
<link rel="preload stylesheet" href="/guida/core/assets/style.BNn_AkzN.css" as="style">
|
|
10
10
|
<link rel="preload stylesheet" href="/guida/core/vp-icons.css" as="style">
|
|
11
11
|
|
|
12
|
-
<script type="module" src="/guida/core/assets/app.
|
|
12
|
+
<script type="module" src="/guida/core/assets/app.BMz6ZZYF.js"></script>
|
|
13
13
|
<link rel="preload" href="/guida/core/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
|
|
14
|
-
<link rel="modulepreload" href="/guida/core/assets/chunks/theme.
|
|
14
|
+
<link rel="modulepreload" href="/guida/core/assets/chunks/theme.DV62mViB.js">
|
|
15
15
|
<link rel="modulepreload" href="/guida/core/assets/chunks/framework.qdetmeNX.js">
|
|
16
16
|
<link rel="modulepreload" href="/guida/core/assets/pipelines_crm-leads-sync.md.BlZUnxYn.lean.js">
|
|
17
17
|
<link rel="icon" type="image/svg+xml" href="/guida/core/favicon.svg">
|
|
@@ -62,7 +62,7 @@ report: record andati in errore (conteggio)
|
|
|
62
62
|
<span class="line"><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">PG_SINK_USER</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"><user></span></span>
|
|
63
63
|
<span class="line"><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">PG_SINK_PASSWORD</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"><password></span></span>
|
|
64
64
|
<span class="line"><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">PG_SINK_DATABASE</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"><db></span></span></code></pre></div><blockquote><p><strong>Nota (breaking):</strong> <code>PG_INSTANCES</code> è <strong>globale</strong> per il connettore Postgres. Impostandola a <code>source,sink</code> si rimuove l'istanza implicita <code>default</code>: altre pipeline che usano l'istanza <code>default</code> vanno riconfigurate aggiungendo il proprio id alla lista e le rispettive <code>PG_<ID>_*</code>.</p></blockquote><h2 id="nel-piano" tabindex="-1">Nel piano <a class="header-anchor" href="#nel-piano" aria-label="Permalink to "Nel piano""></a></h2><p><code>getSpec()</code> usa connettori stub, senza connessione. Host, porta e database di <code>crm_leads</code> e <code>crm_leads_import</code> vengono dalla risoluzione delle istanze <code>source</code> e <code>sink</code>, ognuno con la sua variabile (<code>PG_SOURCE_HOST</code>, <code>PG_SINK_DATABASE</code>…) e la sua origine; l'istanza è in <code>connection</code>, e in fondo c'è la <code>credenziale</code>, che dice solo se la password è impostata.</p><p>Le due istanze ricadono sull'esempio ognuna da sola: un sink incompleto mostra <code>postgres.esempio</code> con le variabili <code>mancante</code>, e il source resta risolto. Se <code>PG_INSTANCES</code> non dichiara <code>source</code> o <code>sink</code>, i loro nodi portano anche <code>configurazione: non valida: da controllare PG_INSTANCES</code>.</p><p>Le variabili si vedono prima di lanciarla con <code>pnpm run etl env check</code>: la pipeline dichiara le due istanze che la run apre (<code>environment</code>, con <code>istanzaPgDichiarata</code>), quindi anche <code>PG_INSTANCES</code>, utente e password di <code>PG_SOURCE_*</code> e <code>PG_SINK_*</code>, che il piano non mostra. I pool li apre il connettore con <code>createPgPool</code>: la pipeline non importa il driver.</p><h2 id="esecuzione" tabindex="-1">Esecuzione <a class="header-anchor" href="#esecuzione" aria-label="Permalink to "Esecuzione""></a></h2><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">pnpm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> etl</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> crm-leads-sync</span></span></code></pre></div><h2 id="idempotenza" tabindex="-1">Idempotenza <a class="header-anchor" href="#idempotenza" aria-label="Permalink to "Idempotenza""></a></h2><p>Upsert su <code>id</code> (<code>ON CONFLICT (id) DO UPDATE</code>): rieseguire la pipeline <strong>non duplica</strong> le righe — il conteggio sulla landing table resta stabile.</p><h2 id="test" tabindex="-1">Test <a class="header-anchor" href="#test" aria-label="Permalink to "Test""></a></h2><ul><li><code>pipeline.test.ts</code> — cattura per-record: le righe valide arrivano alla landing, le N in errore finiscono sul ramo <code>catch</code> del guard; il nodo di report le conta senza persisterle.</li><li><code>run.test.ts</code> — il piano: host, porta e database delle due istanze con variabile e origine, ricaduta sull'esempio per istanza.</li><li>Integrazione <strong>cross-DB</strong> (PG → SQL Server): <code>pg-mssql-cross-db.integration.test.ts</code> — lo stesso grafo con una sorgente Postgres e un sink SQL Server, su tabelle sintetiche create dal test: caricamento e idempotenza (MERGE) end-to-end.</li></ul><h2 id="note" tabindex="-1">Note <a class="header-anchor" href="#note" aria-label="Permalink to "Note""></a></h2><ul><li>Non copia le tabelle referenziate (workspaces/users/companies): per popolare la vera <code>public.crm_leads</code> servirebbe portare anche i parent o bypassare i FK.</li><li>Dati reali dei clienti: non vanno committati; restano nel Postgres locale.</li></ul><h2 id="versioni" tabindex="-1">Versioni <a class="header-anchor" href="#versioni" aria-label="Permalink to "Versioni""></a></h2><p>La storia della pipeline, dalla versione più recente: la voce di changelog di ogni versione (<code>src/pipelines/crm-leads-sync/changelog.ts</code>) e, sotto, cosa è cambiato nel piano rispetto alla precedente. Vedi <a href="./../conventions/versioni-di-pipeline">versioni di pipeline</a>.</p><div class="pipeline-versions" data-v-cdcb1722><!--[--><article class="pipeline-versions__entry" data-v-cdcb1722><header class="pipeline-versions__header" data-v-cdcb1722><strong class="pipeline-versions__number" data-v-cdcb1722>v3</strong><span class="pipeline-versions__meta" data-v-cdcb1722>2026-10-09 · ETL-193, ETL-195</span><!----></header><!----><!--[--><!--[--><!----><!--]--><!--[--><div class="pipeline-versions__list" data-v-cdcb1722><span class="pipeline-versions__list-title" data-v-cdcb1722>Modifiche</span><ul data-v-cdcb1722><!--[--><li data-v-cdcb1722>Nessun cambio di comportamento: il piano è identico alla v2. Gli import seguono l'infrastruttura (changelog, configurazione delle istanze, report di volume) uscita da `src/pipelines/` (ADR-0093 §1), e la pipeline si dichiara nel catalogo di `etl.config.ts` invece che in un registro (ADR-0093 §2)</li><!--]--></ul></div><!--]--><!--[--><!----><!--]--><!--]--><div class="pipeline-versions__diff" data-v-cdcb1722><p class="pipeline-versions__note" data-v-cdcb1722> Il piano non cambia rispetto alla v2. </p></div></article><article class="pipeline-versions__entry" data-v-cdcb1722><header class="pipeline-versions__header" data-v-cdcb1722><strong class="pipeline-versions__number" data-v-cdcb1722>v2</strong><span class="pipeline-versions__meta" data-v-cdcb1722>2026-10-06 · ETL-153</span><!----></header><!----><!--[--><!--[--><div class="pipeline-versions__list" data-v-cdcb1722><span class="pipeline-versions__list-title" data-v-cdcb1722>Aggiunte</span><ul data-v-cdcb1722><!--[--><li data-v-cdcb1722>Host, porta e database delle istanze `source` e `sink`, ognuno con variabile e origine (ADR-0089)</li><li data-v-cdcb1722>Riga `credenziale` con lo stato della password, mai il valore</li><li data-v-cdcb1722>L'istanza del registry sta in `connection`, come negli altri connettori</li><!--]--></ul></div><!--]--><!--[--><div class="pipeline-versions__list" data-v-cdcb1722><span class="pipeline-versions__list-title" data-v-cdcb1722>Modifiche</span><ul data-v-cdcb1722><!--[--><li data-v-cdcb1722>Il piano ricade sulla configurazione d'esempio per istanza: un sink incompleto non nasconde il source</li><!--]--></ul></div><!--]--><!--[--><div class="pipeline-versions__list" data-v-cdcb1722><span class="pipeline-versions__list-title" data-v-cdcb1722>Rimozioni</span><ul data-v-cdcb1722><!--[--><li data-v-cdcb1722>Il dettaglio `instance`, sostituito da `connection`</li><!--]--></ul></div><!--]--><!--]--><div class="pipeline-versions__diff" data-v-cdcb1722><!--[--><p class="pipeline-versions__note" data-v-cdcb1722> Il piano rispetto alla v1: </p><dl data-v-cdcb1722><!----><!--[--><!--[--><dt data-v-cdcb1722>Nodi <!----></dt><dd data-v-cdcb1722><ul data-v-cdcb1722><!--[--><li class="is-changed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>~</span><code data-v-cdcb1722>crm_leads</code><span data-v-cdcb1722>connettore</span></li><li class="is-changed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>~</span><code data-v-cdcb1722>crm_leads_import</code><span data-v-cdcb1722>connettore</span></li><!--]--></ul></dd><!--]--><!--]--></dl><!--]--></div></article><article class="pipeline-versions__entry" data-v-cdcb1722><header class="pipeline-versions__header" data-v-cdcb1722><strong class="pipeline-versions__number" data-v-cdcb1722>v1</strong><span class="pipeline-versions__meta" data-v-cdcb1722>2026-10-05 · ETL-120</span><!----></header><!----><!--[--><!--[--><div class="pipeline-versions__list" data-v-cdcb1722><span class="pipeline-versions__list-title" data-v-cdcb1722>Aggiunte</span><ul data-v-cdcb1722><!--[--><li data-v-cdcb1722>Versione iniziale sotto versionamento (ADR-0086)</li><!--]--></ul></div><!--]--><!--[--><!----><!--]--><!--[--><!----><!--]--><!--]--><div class="pipeline-versions__diff" data-v-cdcb1722><p class="pipeline-versions__note" data-v-cdcb1722> Prima versione: non c'è una versione precedente da confrontare. </p></div></article><!--]--></div></div></div></main><footer class="VPDocFooter" data-v-303c7d43 data-v-64d0b887><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-64d0b887><span class="visually-hidden" id="doc-footer-aria-label" data-v-64d0b887>Pager</span><div class="pager" data-v-64d0b887><a class="VPLink link pager-link prev" href="/guida/core/sub-pipelines/README" data-v-64d0b887><!--[--><span class="desc" data-v-64d0b887>Pagina precedente</span><span class="title" data-v-64d0b887>Le schede di una sub-pipeline</span><!--]--></a></div><div class="pager" data-v-64d0b887><a class="VPLink link pager-link next" href="/guida/core/pipelines/cross-workspace-csv-merge" data-v-64d0b887><!--[--><span class="desc" data-v-64d0b887>Pagina successiva</span><span class="title" data-v-64d0b887>cross-workspace-csv-merge</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-f5dee57d data-v-e10de3dd><div class="container" data-v-e10de3dd><p class="message" data-v-e10de3dd>Noeva è un marchio registrato di 4D S.R.L.</p><p class="copyright" data-v-e10de3dd>© 2026 4D S.R.L. · Gruppo4D</p></div></footer><!--[--><span hidden></span><!--]--></div></div>
|
|
65
|
-
<script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"DUHajB0u\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"ChyXSf73\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"D8Si7E2S\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"
|
|
65
|
+
<script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"DUHajB0u\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"ChyXSf73\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"D8Si7E2S\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"D13C7Zwu\",\"guide_claude-code_index.md\":\"CxVSru8e\",\"guide_claude-code_prompt.md\":\"C7uETA9W\",\"guide_claude-code_strumenti.md\":\"BWhQnAlY\",\"guide_grafo.md\":\"Dy8_YMeh\",\"guide_usare_app-desktop.md\":\"CcDu8cJL\",\"guide_usare_esito-di-una-run.md\":\"DkvAOPBE\",\"guide_usare_index.md\":\"BJqi3P7J\",\"index.md\":\"kMhsF-sv\",\"nodes_action.md\":\"DOsTbV-i\",\"nodes_ai.md\":\"CVtP9gEJ\",\"nodes_join.md\":\"DSYbIDG6\",\"nodes_lookup.md\":\"BI8tgBIq\",\"nodes_pipeline.md\":\"DIMlyprm\",\"nodes_readme.md\":\"CHGy_go6\",\"nodes_route.md\":\"Bt9qH6OA\",\"nodes_sink.md\":\"yAf_z4wO\",\"nodes_source.md\":\"V_vlNfOz\",\"nodes_task.md\":\"Dk6VB7as\",\"nodes_transform.md\":\"Bv5fg2Xx\",\"nodes_try-catch.md\":\"DCYydDPm\",\"nodes_union.md\":\"CznVzHTK\",\"pipelines_crm-leads-sync.md\":\"BlZUnxYn\",\"pipelines_cross-workspace-csv-merge.md\":\"CsRE6GNe\",\"pipelines_movimenti-per-conto.md\":\"DRGfO1_5\",\"pipelines_orders-enriched-daily.md\":\"jESRtvBo\",\"pipelines_readme.md\":\"Ee6LS-SU\",\"pipelines_test-posta.md\":\"Cxo_DGBs\",\"runbooks_aggiornamento-pm2.md\":\"f3LAxif4\",\"runbooks_deployment.md\":\"DvIOOsoG\",\"runbooks_etl-worker.md\":\"Bu05cEgT\",\"runbooks_graph-server.md\":\"BOXZqdXC\",\"runbooks_mask-key.md\":\"nZkhAjBf\",\"runbooks_oauth-google-posta.md\":\"Bs7QTkmU\",\"runbooks_rollback-di-pipeline.md\":\"6US0Wsdc\",\"runbooks_scd2-rehash.md\":\"DtmuXA67\",\"runbooks_sql-task-truncate-swap.md\":\"C8viT-fp\",\"runbooks_stato-incrementale.md\":\"hGZ8FlbZ\",\"sub-pipelines_readme.md\":\"CF8gmNPU\",\"sub-pipelines_riepilogo-ordini.md\":\"qCBZJ4nh\",\"technical_overview.md\":\"DQP0pWc8\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"it-IT\",\"dir\":\"ltr\",\"title\":\"Noeva ETL\",\"titleTemplate\":\":title · Noeva ETL\",\"description\":\"Documentazione di Noeva ETL: come usare la piattaforma e come creare pipeline con Claude Code.\",\"base\":\"/guida/core/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":{\"light\":\"/logo-dark.png\",\"dark\":\"/logo-light.png\",\"alt\":\"Noeva\"},\"siteTitle\":false,\"footer\":{\"message\":\"Noeva è un marchio registrato di 4D S.R.L.\",\"copyright\":\"© 2026 4D S.R.L. · Gruppo4D\"},\"outline\":{\"level\":[2,3],\"label\":\"In questa pagina\"},\"docFooter\":{\"prev\":\"Pagina precedente\",\"next\":\"Pagina successiva\"},\"darkModeSwitchLabel\":\"Tema\",\"lightModeSwitchTitle\":\"Passa al tema chiaro\",\"darkModeSwitchTitle\":\"Passa al tema scuro\",\"sidebarMenuLabel\":\"Menu\",\"returnToTopLabel\":\"Torna su\",\"langMenuLabel\":\"Lingua\",\"notFound\":{\"title\":\"PAGINA NON TROVATA\",\"quote\":\"Il documento che cercavi non c'è più, o non è mai stato pubblicato qui.\",\"linkLabel\":\"Torna alla home\",\"linkText\":\"Torna alla home\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Cerca\",\"buttonAriaLabel\":\"Cerca nella documentazione\"},\"modal\":{\"displayDetails\":\"Mostra i dettagli\",\"resetButtonTitle\":\"Azzera la ricerca\",\"backButtonTitle\":\"Chiudi la ricerca\",\"noResultsText\":\"Nessun risultato per\",\"footer\":{\"selectText\":\"per aprire\",\"selectKeyAriaLabel\":\"invio\",\"navigateText\":\"per spostarti\",\"navigateUpKeyAriaLabel\":\"freccia su\",\"navigateDownKeyAriaLabel\":\"freccia giù\",\"closeText\":\"per chiudere\",\"closeKeyAriaLabel\":\"esc\"}}}}},\"nav\":[{\"text\":\"Usare\",\"link\":\"/guide/usare/\",\"activeMatch\":\"^/guide/usare/\"},{\"text\":\"Creare con Claude Code\",\"link\":\"/guide/claude-code/\",\"activeMatch\":\"^/guide/claude-code/\"},{\"text\":\"Riferimento\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Tipi di nodo\",\"link\":\"/nodes/README\"},{\"text\":\"Connettori\",\"link\":\"/connectors/README\"},{\"text\":\"Pipeline pronte\",\"link\":\"/pipelines/README\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"},{\"text\":\"Operatività\",\"link\":\"/runbooks/graph-server\"}]}],\"sidebar\":[{\"text\":\"Usare Noeva ETL\",\"items\":[{\"text\":\"Come si usa\",\"link\":\"/guide/usare/\"},{\"text\":\"L'app desktop\",\"link\":\"/guide/usare/app-desktop\"},{\"text\":\"Leggere l'esito di una run\",\"link\":\"/guide/usare/esito-di-una-run\"},{\"text\":\"Panoramica di prodotto\",\"link\":\"/TECHNICAL_OVERVIEW\"}]},{\"text\":\"Creare con Claude Code\",\"items\":[{\"text\":\"Dal bisogno al processo\",\"link\":\"/guide/claude-code/\"},{\"text\":\"Comporre il prompt\",\"link\":\"/guide/claude-code/prompt\"},{\"text\":\"Skill e subagent\",\"link\":\"/guide/claude-code/strumenti\"},{\"text\":\"Guida allo sviluppo\",\"link\":\"/GUIDA_SVILUPPO\"}]},{\"text\":\"Concetti\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Versioni di pipeline\",\"link\":\"/conventions/versioni-di-pipeline\"},{\"text\":\"Descriptor dei nodi\",\"link\":\"/conventions/node-descriptor\"},{\"text\":\"Colonne dei nodi\",\"link\":\"/conventions/node-columns\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"}]},{\"text\":\"Tipi di nodo\",\"collapsed\":true,\"items\":[{\"text\":\"Cheatsheet\",\"link\":\"/nodes/README\"},{\"text\":\"action\",\"link\":\"/nodes/action\"},{\"text\":\"ai\",\"link\":\"/nodes/ai\"},{\"text\":\"join\",\"link\":\"/nodes/join\"},{\"text\":\"lookup\",\"link\":\"/nodes/lookup\"},{\"text\":\"pipeline\",\"link\":\"/nodes/pipeline\"},{\"text\":\"route\",\"link\":\"/nodes/route\"},{\"text\":\"sink\",\"link\":\"/nodes/sink\"},{\"text\":\"source\",\"link\":\"/nodes/source\"},{\"text\":\"task\",\"link\":\"/nodes/task\"},{\"text\":\"transform\",\"link\":\"/nodes/transform\"},{\"text\":\"try-catch\",\"link\":\"/nodes/try-catch\"},{\"text\":\"union\",\"link\":\"/nodes/union\"}]},{\"text\":\"Connettori\",\"collapsed\":true,\"items\":[{\"text\":\"Panoramica\",\"link\":\"/connectors/README\"},{\"text\":\"File (storage × codec)\",\"link\":\"/connectors/file\"},{\"text\":\"HTTP (API REST per i nodi lookup e action)\",\"link\":\"/connectors/http\"},{\"text\":\"IMAP (caselle di posta)\",\"link\":\"/connectors/imap\"},{\"text\":\"Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)\",\"link\":\"/connectors/jira\"},{\"text\":\"Noeva (file dei workspace)\",\"link\":\"/connectors/noeva\"},{\"text\":\"OAuth2 per i connettori di posta\",\"link\":\"/connectors/oauth\"},{\"text\":\"PostgreSQL\",\"link\":\"/connectors/postgres\"},{\"text\":\"processo esterno\",\"link\":\"/connectors/process\"},{\"text\":\"SendGrid (mail via API REST)\",\"link\":\"/connectors/sendgrid\"},{\"text\":\"SMTP (notifiche email)\",\"link\":\"/connectors/smtp\"},{\"text\":\"SQL Server\",\"link\":\"/connectors/sqlserver\"}]},{\"text\":\"Pipeline pronte\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una pipeline\",\"link\":\"/pipelines/README\"},{\"text\":\"test-posta\",\"link\":\"/pipelines/test-posta\"}]},{\"text\":\"Esempi\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una sub-pipeline\",\"link\":\"/sub-pipelines/README\"},{\"text\":\"crm-leads-sync\",\"link\":\"/pipelines/crm-leads-sync\"},{\"text\":\"cross-workspace-csv-merge\",\"link\":\"/pipelines/cross-workspace-csv-merge\"},{\"text\":\"movimenti-per-conto\",\"link\":\"/pipelines/movimenti-per-conto\"},{\"text\":\"orders-enriched-daily\",\"link\":\"/pipelines/orders-enriched-daily\"},{\"text\":\"riepilogo-ordini\",\"link\":\"/sub-pipelines/riepilogo-ordini\"}]},{\"text\":\"Operatività\",\"collapsed\":true,\"items\":[{\"text\":\"aggiornare un deploy PM2 di un repo cliente\",\"link\":\"/runbooks/aggiornamento-pm2\"},{\"text\":\"distribuzione del runner ETL\",\"link\":\"/runbooks/deployment\"},{\"text\":\"worker etl worker (polling su processes)\",\"link\":\"/runbooks/etl-worker\"},{\"text\":\"server grafi etl serve (HTTP)\",\"link\":\"/runbooks/graph-server\"},{\"text\":\"chiavi di mask (creazione, rotazione, compromissione)\",\"link\":\"/runbooks/mask-key\"},{\"text\":\"OAuth2 per una casella Google (IMAP + SMTP)\",\"link\":\"/runbooks/oauth-google-posta\"},{\"text\":\"rollback di una pipeline\",\"link\":\"/runbooks/rollback-di-pipeline\"},{\"text\":\"rehash di una dimensione storicizzata\",\"link\":\"/runbooks/scd2-rehash\"},{\"text\":\"task SQL, truncate e scambio di tabelle\",\"link\":\"/runbooks/sql-task-truncate-swap\"},{\"text\":\"stato di pipeline e watermark\",\"link\":\"/runbooks/stato-incrementale\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
|
|
66
66
|
|
|
67
67
|
</body>
|
|
68
68
|
</html>
|
|
@@ -9,9 +9,9 @@
|
|
|
9
9
|
<link rel="preload stylesheet" href="/guida/core/assets/style.BNn_AkzN.css" as="style">
|
|
10
10
|
<link rel="preload stylesheet" href="/guida/core/vp-icons.css" as="style">
|
|
11
11
|
|
|
12
|
-
<script type="module" src="/guida/core/assets/app.
|
|
12
|
+
<script type="module" src="/guida/core/assets/app.BMz6ZZYF.js"></script>
|
|
13
13
|
<link rel="preload" href="/guida/core/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
|
|
14
|
-
<link rel="modulepreload" href="/guida/core/assets/chunks/theme.
|
|
14
|
+
<link rel="modulepreload" href="/guida/core/assets/chunks/theme.DV62mViB.js">
|
|
15
15
|
<link rel="modulepreload" href="/guida/core/assets/chunks/framework.qdetmeNX.js">
|
|
16
16
|
<link rel="modulepreload" href="/guida/core/assets/pipelines_cross-workspace-csv-merge.md.CsRE6GNe.lean.js">
|
|
17
17
|
<link rel="icon" type="image/svg+xml" href="/guida/core/favicon.svg">
|
|
@@ -53,7 +53,7 @@ workspace: 8793575e-7546-489e-91c9-3004918361fb
|
|
|
53
53
|
fileName: test-etl.csv
|
|
54
54
|
mode: new-version
|
|
55
55
|
</title><rect class="dag-node__halo" x="980" y="102" width="198" height="74" rx="12" data-v-340130bc></rect><!----><rect class="dag-node__card" x="984" y="106" width="190" height="66" rx="9" data-v-340130bc></rect><rect class="dag-node__accent" x="984" y="112" width="3" height="54" rx="1.5" data-v-340130bc></rect><text class="dag-node__label" x="996" y="125" data-v-340130bc>workspace-b</text><text class="dag-node__kind" x="1164" y="125" text-anchor="end" data-v-340130bc>sink</text><!--[--><text class="dag-node__sub" x="996" y="141" data-v-340130bc>noeva-file</text><text class="is-detail dag-node__sub" x="996" y="154" data-v-340130bc>fileName: test-etl.csv</text><!--]--><!--[--><!--]--></g><!--]--><!--[--><!--]--></svg><!--[--><!--]--><!----></div><!----><figcaption class="graph-demo__footer" data-v-fc9b2f46><span class="graph-demo__progress" aria-hidden="true" data-v-fc9b2f46><span style="width:0%;" data-v-fc9b2f46></span></span><span class="graph-demo__caption" aria-live="polite" data-v-fc9b2f46><!--[--> Scegli una scena e premi ▶ per guardarla scorrere, oppure → per andare avanti un passo alla volta. <!--]--></span></figcaption></figure><figure class="level-nav__purposes" data-v-c981a055><figcaption id="level-nav-purposes-v-0" class="level-nav__purposes-title" data-v-c981a055> Lo scopo dei nodi </figcaption><table aria-labelledby="level-nav-purposes-v-0" data-v-c981a055><thead data-v-c981a055><tr data-v-c981a055><th scope="col" data-v-c981a055>Nodo</th><th scope="col" data-v-c981a055>Tipo</th><th scope="col" data-v-c981a055>Scopo</th></tr></thead><tbody data-v-c981a055><!--[--><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>read-workspace-a</code></td><td data-v-c981a055><code data-v-c981a055>source</code></td><td data-v-c981a055>Legge il file condiviso dal primo workspace. Se lì il file non esiste ancora, il workspace non porta righe e l'unione parte lo stesso.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>read-workspace-b</code></td><td data-v-c981a055><code data-v-c981a055>source</code></td><td data-v-c981a055>Legge lo stesso file dal secondo workspace. Se lì il file non esiste ancora, il workspace non porta righe e l'unione parte lo stesso.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>union-workspaces</code></td><td data-v-c981a055><code data-v-c981a055>union</code></td><td data-v-c981a055>Mette in fila le righe dei due workspace, prima tutte quelle del primo e poi quelle del secondo. L'ordine fisso fa sì che, a dati fermi, ogni run produca lo stesso identico file.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>dedup-rows</code></td><td data-v-c981a055><code data-v-c981a055>transform</code></td><td data-v-c981a055>Toglie le righe ripetute, tenendo la prima copia di ognuna. Il risultato torna in tutti e due i workspace: senza questo passo il file raddoppierebbe a ogni run.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>encode-csv</code></td><td data-v-c981a055><code data-v-c981a055>transform</code></td><td data-v-c981a055>Ricompone le righe in un unico file, con tutte le colonne presenti in almeno uno dei due workspace. Una colonna che un workspace non ha resta vuota nelle sue righe, così nessun dato va perso.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>workspace-a</code></td><td data-v-c981a055><code data-v-c981a055>sink</code></td><td data-v-c981a055>Salva il file unito come nuova versione nel primo workspace. Se il contenuto è uguale all'ultima versione, non ne crea un'altra.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>workspace-b</code></td><td data-v-c981a055><code data-v-c981a055>sink</code></td><td data-v-c981a055>Salva il file unito come nuova versione nel secondo workspace. Se il contenuto è uguale all'ultima versione, non ne crea un'altra.</td></tr><!--]--></tbody></table></figure></div><blockquote><p>Il grafo qui sopra è disegnato dalla topologia reale della pipeline (<code>getSpec()</code>): nodi, archi, dead-letter e ramo catch sono quelli eseguiti. Premi ▶ per far passare un record, o → per avanzare un passo alla volta.</p></blockquote><p>Una source per workspace (<code>read-workspace-a</code>, <code>read-workspace-b</code>) legge il file e ne emette le righe così come sono; un <a href="./../nodes/union"><code>union</code></a> le accoda, A prima di B; un <a href="./../nodes/transform"><code>dedup</code></a> su riga intera tiene la prima occorrenza di ogni riga; un nodo di encode serializza in CSV con l'unione delle colonne come intestazione; il byte stream fa <strong>fan-out</strong> su due sink Noeva, uno per workspace.</p><h2 id="sorgenti" tabindex="-1">Sorgenti <a class="header-anchor" href="#sorgenti" aria-label="Permalink to "Sorgenti""></a></h2><ul><li><strong><code>test-etl.csv</code></strong> su <strong>workspace A</strong> (il primo servito dall'istanza) e <strong>workspace B</strong> (<code>NOEVA_MERGE_SECONDARY_WORKSPACE_ID</code>, default <code>8793575e-7546-489e-91c9-3004918361fb</code>), via le API <code>files</code> di <code>noeva-server-api</code> (<code>src/connectors/noeva</code>).</li><li>Lette da <code>workspaceCsvSource</code> (<code>src/pipelines/cross-workspace-csv-merge/workspace-source.ts</code>), in streaming. La memoria cresce con le righe distinte: il <code>dedup</code> ne tiene le chiavi, e <code>encode-csv</code> le trattiene per conoscere l'unione delle colonne prima di scrivere. Il tetto è <code>maxKeys: 100 000</code> sul <code>dedup</code>: oltre 100 000 righe distinte la run si ferma con un errore che nomina l'opzione, invece di scrivere un merge a metà sui due workspace.</li><li><strong>Tollerante all'assenza:</strong> se il file non esiste in un workspace, quel workspace contribuisce 0 righe (warning nel log), così il merge parte anche al primo giro. Se manca in entrambi, l'encode non produce byte e i sink caricano un file vuoto (0 byte); alla run successiva è identico e l'upload si salta.</li></ul><h2 id="sink" tabindex="-1">Sink <a class="header-anchor" href="#sink" aria-label="Permalink to "Sink""></a></h2><ul><li><strong><code>test-etl.csv</code></strong> su <strong>entrambi</strong> i workspace, in modalità <code>new-version</code> (<code>noevaFileSink</code>). Il sink è <strong>idempotente</strong>: salta l'upload se il contenuto è identico all'ultima versione.</li></ul><h2 id="trasformazioni-e-regole-di-business" tabindex="-1">Trasformazioni e regole di business <a class="header-anchor" href="#trasformazioni-e-regole-di-business" aria-label="Permalink to "Trasformazioni e regole di business""></a></h2><ul><li><strong>Merge = union deduplicata su riga intera</strong>, in due nodi: <ul><li><code>union-workspaces</code> — nodo <code>union</code> in modalità <strong><code>concat</code></strong>: prima tutte le righe di A, poi quelle di B;</li><li><code>dedup-rows</code> — transform <code>dedup</code> con <code>keep: "first"</code> e chiave <code>rowKey</code> (<code>src/pipelines/cross-workspace-csv-merge/row-key.ts</code>, serializzazione delle colonne non vuote ordinate per nome): tiene la prima occorrenza di ogni riga distinta. Una colonna assente e una vuota sono la stessa riga, come lo sono nel CSV scritto.</li></ul></li><li><strong>Encode = unione delle intestazioni</strong> (<code>encode-csv</code>, <code>src/pipelines/cross-workspace-csv-merge/encode-csv.ts</code>): l'intestazione è l'unione delle colonne di tutte le righe, nell'ordine in cui compaiono la prima volta (quelle di A, poi quelle che solo B ha). Una riga senza una colonna la scrive vuota. Senza righe non scrive nulla, nemmeno l'intestazione.</li><li><strong>L'ordine fa parte del contratto</strong>, ed è per questo che il <code>union</code> è in <code>concat</code> e non in <code>interleave</code>: i sink <code>new-version</code> saltano l'upload solo se i byte sono identici all'ultima versione, e un ordine che cambiasse fra una run e l'altra produrrebbe una versione nuova a ogni run anche a dati fermi.</li><li><strong>Idempotenza (importante):</strong> scrivere <code>merge(A,B)</code> dentro sia A sia B è un feedback loop lettura/scrittura. Dedup e ordine fisso garantiscono un <strong>punto fisso</strong>: dopo la prima run A e B diventano identici; alla run successiva <code>dedup(A ∪ B)</code> è già uguale, byte per byte, all'ultima versione → il sink <code>new-version</code> salta l'upload. Un semplice concat, invece, raddoppierebbe i dati a ogni run, e un sink che duplica i dati a ogni riesecuzione non è ammesso.</li></ul><h3 id="intestazioni-diverse-fra-a-e-b" tabindex="-1">Intestazioni diverse fra A e B <a class="header-anchor" href="#intestazioni-diverse-fra-a-e-b" aria-label="Permalink to "Intestazioni diverse fra A e B""></a></h3><p>L'output sovrascrive le sorgenti, quindi una colonna persa in scrittura è un dato perso: invece di fermarsi quando le intestazioni differiscono, la pipeline ne scrive l'<strong>unione</strong>. Così un file che guadagna una colonna in un workspace la propaga all'altro, e il merge raggiunge il punto fisso alla prima run anche in quel caso.</p><table tabindex="0"><thead><tr><th>Caso</th><th>Comportamento</th></tr></thead><tbody><tr><td>Colonna presente solo in B</td><td>Resta nell'output, vuota nelle righe di A</td></tr><tr><td>Stesse colonne in ordine diverso</td><td>Ordine di prima comparsa: quello di A, poi le colonne nuove di B</td></tr><tr><td><code>{id,val}</code> in A, <code>{id,val,extra: ""}</code> in B</td><td>Una riga sola: la colonna assente vale come vuota</td></tr><tr><td>Riga corta (meno campi dell'intestazione)</td><td>Ammessa: la source mette a vuoto le colonne mancanti</td></tr><tr><td>Riga lunga (più campi dell'intestazione)</td><td><code>ExtractError</code> fail-fast, nessuna scrittura: il campo in più non ha una colonna</td></tr><tr><td>Nome di colonna duplicato o <code>__proto__</code></td><td><code>ExtractError</code> fail-fast, nessuna scrittura: se ne terrebbe un valore o nessuno</td></tr><tr><td>Colonna che nessuna riga sopravvissuta porta</td><td>Esce dall'intestazione: succede solo se è vuota ovunque, nessun valore si perde</td></tr></tbody></table><p>Una colonna esce dall'intestazione solo quando il suo file non ha righe, o quando ogni sua riga coincide con una già vista (e quindi quella colonna è vuota in tutte).</p><p><strong>Limite noto, indipendente dalle intestazioni:</strong> in un file a <strong>una sola colonna</strong>, una cella vuota si scrive come riga vuota, e il decode la salta alla run dopo.</p><h2 id="contratti-schema-zod" tabindex="-1">Contratti (schema Zod) <a class="header-anchor" href="#contratti-schema-zod" aria-label="Permalink to "Contratti (schema Zod)""></a></h2><ul><li>Input/Output: <code>csvRowSchema = z.record(z.string(), z.string())</code> (<code>src/pipelines/cross-workspace-csv-merge/schema.ts</code>) — riga CSV schema-agnostica (mappa colonna→valore). Un decode che producesse qualcosa di diverso è un errore fail-fast (<code>ExtractError</code>), nessuno scarto silenzioso.</li></ul><p><strong>Colonne nel piano (<code>getSpec</code>)</strong>: essendo la riga schema-agnostica (<code>z.record</code>), le colonne non sono introspezionabili e vengono <strong>dichiarate</strong> esplicitamente sugli stub delle due letture (<code>CSV_COLUMNS = [id, val]</code>, l'header noto di <code>test-etl.csv</code>). Da lì si propagano a <code>union-workspaces</code>, <code>dedup-rows</code>, <code>encode-csv</code> e ai due sink (<code>workspace-a</code>, <code>workspace-b</code>) nella UI del DAG. Sono rappresentative: con intestazioni diverse fra A e B il file scritto ne ha di più (vedi sopra).</p><p><strong>Descriptor nel piano</strong>: gli stub di <code>getSpec</code> usano le stesse funzioni dei connettori veri (<code>workspaceCsvDescriptor</code>, <code>noevaFileSinkDescriptor</code>), quindi il DAG mostra per ogni nodo gli stessi dettagli della run. Un test lo verifica.</p><p>Ogni riga porta la variabile da cui arriva e la sua origine: base URL e workspace A dal client Noeva (<code>NOEVA_*</code>), workspace B e file dalle variabili della pipeline (<code>NOEVA_MERGE_*</code>). Il workspace B di default compare con origine <code>default</code>. La riga <code>credenziale</code> dice solo se <code>NOEVA_API_KEY</code> è impostata. Senza <code>.env</code> il client Noeva è d'esempio, con le sue variabili <code>mancanti</code>; le variabili <code>NOEVA_MERGE_*</code> stanno anche nella configurazione della pipeline del piano.</p><p>Per <code>pnpm run etl env check</code> la pipeline dichiara le sole <code>NOEVA_MERGE_*</code> (<code>environment</code>): le <code>NOEVA_*</code> del client sono del core, che le dichiara da sé.</p><h2 id="parametri-ed-env" tabindex="-1">Parametri ed env <a class="header-anchor" href="#parametri-ed-env" aria-label="Permalink to "Parametri ed env""></a></h2><ul><li><code>ctx.params</code>: nessuno.</li><li>Variabili d'ambiente (vedi <code>.env.example</code>): <ul><li><code>NOEVA_WORKSPACE_IDS</code> — <strong>richiesto</strong>: deve elencare sia il workspace A sia il workspace B (l'<code>NOEVA_API_KEY</code> è una sola e vale per entrambi).</li><li><code>NOEVA_WORKSPACE_ID</code> — workspace A quando <code>NOEVA_WORKSPACE_IDS</code> non è impostata; con la lista, il workspace A è il suo primo id e questa variabile non conta.</li><li><code>NOEVA_API_BASE_URL</code> — endpoint dell'API, condiviso dai due workspace; nel piano (<code>getSpec</code>) compare nel descriptor dei nodi.</li><li><code>NOEVA_MERGE_SECONDARY_WORKSPACE_ID</code> — workspace B (default <code>8793575e-…</code>).</li><li><code>NOEVA_MERGE_FILE_NAME</code> — nome file (default <code>test-etl.csv</code>). Le variabili <code>NOEVA_MERGE_*</code> sono dichiarate in <code>MANIFEST_CROSS_WORKSPACE</code> (<code>config.ts</code>), quelle <code>NOEVA_*</code> in <code>MANIFEST_NOEVA</code>: una run con variabili mancanti si ferma con un <code>ConfigError</code> che le elenca tutte.</li></ul></li><li><strong>Validazione workspace:</strong> ogni workspace target deve essere tra quelli configurati. Puntare a un workspace non presente in <code>NOEVA_WORKSPACE_IDS</code> è un errore fail-fast (<code>ConfigError</code>), per non avviare processi su workspace non previsti.</li></ul><h2 id="gestione-errori" tabindex="-1">Gestione errori <a class="header-anchor" href="#gestione-errori" aria-label="Permalink to "Gestione errori""></a></h2><ul><li><strong>File assente</strong> in un workspace → tollerato (0 righe + warning).</li><li><strong>CSV malformato</strong> o errore di lettura → <code>ExtractError</code> (fail-fast), che nomina il workspace: nel report il nodo fallito è la source di quel workspace. I sink Noeva lasciano passare invariato un errore arrivato da monte, e raccolgono tutti i byte prima di caricare: se una lettura fallisce, nessun workspace riceve una versione nuova.</li><li><strong>Workspace non configurato</strong> → <code>ConfigError</code> prima di qualsiasi I/O.</li><li>Nessun dead-letter: la demo è fail-fast (i record CSV sono schema-agnostici e sempre validi per costruzione). I duplicati scartati dal <code>dedup</code> non sono errori: il <code>dedup</code> usa <code>duplicates: "drop"</code>, e si contano come differenza sul nodo.</li><li><strong>Riga con più campi dell'intestazione, o nome di colonna duplicato</strong> → <code>ExtractError</code> (fail-fast), come un CSV malformato: il codec della source gira con <code>unmappedFields: "error"</code> invece di perdere quei valori, che riscrivere il file cancellerebbe. Vedi <a href="#intestazioni-diverse-fra-a-e-b">Intestazioni diverse fra A e B</a>.</li></ul><h2 id="report" tabindex="-1">Report <a class="header-anchor" href="#report" aria-label="Permalink to "Report""></a></h2><p>Ogni workspace è un nodo, quindi il report della run dice quante righe ha dato ciascuno: <code>extracted</code> di <code>read-workspace-a</code> e di <code>read-workspace-b</code>. Il totale <code>extracted</code> della run è la loro somma, <strong>prima</strong> della dedup; i duplicati scartati sono <code>extracted − written</code> di <code>dedup-rows</code>.</p><h2 id="test" tabindex="-1">Test <a class="header-anchor" href="#test" aria-label="Permalink to "Test""></a></h2><ul><li><code>src/pipelines/cross-workspace-csv-merge/characterization.test.ts</code> — l'output consegnato ai due workspace, passando da <code>run()</code>: byte esatti (righe e ordine), punto fisso, file assente, fail-fast su CSV malformato; intestazioni diverse fra A e B (colonna solo in B, colonna assente ≡ vuota, punto fisso, righe corte, riga lunga, colonna duplicata).</li><li><code>src/pipelines/cross-workspace-csv-merge/config.test.ts</code> — default e override delle variabili <code>NOEVA_MERGE_*</code>, con la loro origine.</li><li><code>src/pipelines/cross-workspace-csv-merge/encode-csv.test.ts</code> — unione delle colonne, byte invariati a intestazione uguale, nessun output senza righe.</li><li><code>src/pipelines/cross-workspace-csv-merge/workspace-source.test.ts</code> — lettura di un workspace, tolleranza all'assenza, fail-fast su CSV malformato, riga lunga e colonna duplicata, righe corte completate con celle vuote, descriptor.</li><li><code>src/pipelines/cross-workspace-csv-merge/row-key.test.ts</code> — chiave di dedup, colonna assente ≡ vuota.</li><li><code>src/pipelines/cross-workspace-csv-merge/pipeline.test.ts</code> — e2e (stesso CSV su entrambi i sink, ordine, dedup, idempotenza, nessuna riga), conteggi per workspace nel report, errore attribuito al nodo del workspace coi sink Noeva veri, topologia <code>getSpec</code> e descriptor del piano uguali a quelli dei connettori veri; variabile e origine delle righe, workspace B di default con origine <code>default</code>, client Noeva d'esempio senza <code>.env</code>.</li><li><code>src/connectors/noeva/workspace-registry.test.ts</code> — validazione workspace configurati.</li></ul><h2 id="versioni" tabindex="-1">Versioni <a class="header-anchor" href="#versioni" aria-label="Permalink to "Versioni""></a></h2><p>La storia della pipeline, dalla versione più recente: la voce di changelog di ogni versione (<code>src/pipelines/cross-workspace-csv-merge/changelog.ts</code>) e, sotto, cosa è cambiato nel piano rispetto alla precedente. Vedi <a href="./../conventions/versioni-di-pipeline">versioni di pipeline</a>.</p><div class="pipeline-versions" data-v-cdcb1722><!--[--><article class="pipeline-versions__entry" data-v-cdcb1722><header class="pipeline-versions__header" data-v-cdcb1722><strong class="pipeline-versions__number" data-v-cdcb1722>v3</strong><span class="pipeline-versions__meta" data-v-cdcb1722>2026-10-09 · ETL-193, ETL-195</span><!----></header><!----><!--[--><!--[--><!----><!--]--><!--[--><div class="pipeline-versions__list" data-v-cdcb1722><span class="pipeline-versions__list-title" data-v-cdcb1722>Modifiche</span><ul data-v-cdcb1722><!--[--><li data-v-cdcb1722>Nessun cambio di comportamento: il piano è identico alla v2. Gli import seguono l'infrastruttura (changelog, configurazione delle istanze, report di volume) uscita da `src/pipelines/` (ADR-0093 §1), e la pipeline si dichiara nel catalogo di `etl.config.ts` invece che in un registro (ADR-0093 §2)</li><!--]--></ul></div><!--]--><!--[--><!----><!--]--><!--]--><div class="pipeline-versions__diff" data-v-cdcb1722><p class="pipeline-versions__note" data-v-cdcb1722> Il piano non cambia rispetto alla v2. </p></div></article><article class="pipeline-versions__entry" data-v-cdcb1722><header class="pipeline-versions__header" data-v-cdcb1722><strong class="pipeline-versions__number" data-v-cdcb1722>v2</strong><span class="pipeline-versions__meta" data-v-cdcb1722>2026-10-06 · ETL-152</span><!----></header><!----><!--[--><!--[--><div class="pipeline-versions__list" data-v-cdcb1722><span class="pipeline-versions__list-title" data-v-cdcb1722>Aggiunte</span><ul data-v-cdcb1722><!--[--><li data-v-cdcb1722>Variabile e origine su ogni riga dei nodi Noeva: base URL, workspace A, file e workspace B, che col default compare con origine `default` (ADR-0089)</li><li data-v-cdcb1722>Riga `credenziale` sui nodi Noeva, con lo stato della chiave API e mai il valore</li><li data-v-cdcb1722>Configurazione della pipeline nel piano: le variabili `NOEVA_MERGE_*` con valore e origine</li><!--]--></ul></div><!--]--><!--[--><div class="pipeline-versions__list" data-v-cdcb1722><span class="pipeline-versions__list-title" data-v-cdcb1722>Modifiche</span><ul data-v-cdcb1722><!--[--><li data-v-cdcb1722>Senza `.env` i nodi mostrano un client Noeva d'esempio con le variabili mancanti marcate, invece di omettere base URL e workspace A</li><li data-v-cdcb1722>Il workspace A è il primo che l'istanza serve: con `NOEVA_WORKSPACE_IDS` impostata, `NOEVA_WORKSPACE_ID` non conta più</li><!--]--></ul></div><!--]--><!--[--><!----><!--]--><!--]--><div class="pipeline-versions__diff" data-v-cdcb1722><!--[--><p class="pipeline-versions__note" data-v-cdcb1722> Il piano rispetto alla v1: </p><dl data-v-cdcb1722><!----><!--[--><!--[--><dt data-v-cdcb1722>Nodi <!----></dt><dd data-v-cdcb1722><ul data-v-cdcb1722><!--[--><li class="is-changed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>~</span><code data-v-cdcb1722>read-workspace-a</code><span data-v-cdcb1722>connettore</span></li><li class="is-changed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>~</span><code data-v-cdcb1722>read-workspace-b</code><span data-v-cdcb1722>connettore</span></li><li class="is-changed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>~</span><code data-v-cdcb1722>workspace-a</code><span data-v-cdcb1722>connettore</span></li><li class="is-changed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>~</span><code data-v-cdcb1722>workspace-b</code><span data-v-cdcb1722>connettore</span></li><!--]--></ul></dd><!--]--><!--]--></dl><!--]--></div></article><article class="pipeline-versions__entry" data-v-cdcb1722><header class="pipeline-versions__header" data-v-cdcb1722><strong class="pipeline-versions__number" data-v-cdcb1722>v1</strong><span class="pipeline-versions__meta" data-v-cdcb1722>2026-10-05 · ETL-120</span><!----></header><!----><!--[--><!--[--><div class="pipeline-versions__list" data-v-cdcb1722><span class="pipeline-versions__list-title" data-v-cdcb1722>Aggiunte</span><ul data-v-cdcb1722><!--[--><li data-v-cdcb1722>Versione iniziale sotto versionamento (ADR-0086)</li><!--]--></ul></div><!--]--><!--[--><!----><!--]--><!--[--><!----><!--]--><!--]--><div class="pipeline-versions__diff" data-v-cdcb1722><p class="pipeline-versions__note" data-v-cdcb1722> Prima versione: non c'è una versione precedente da confrontare. </p></div></article><!--]--></div></div></div></main><footer class="VPDocFooter" data-v-303c7d43 data-v-64d0b887><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-64d0b887><span class="visually-hidden" id="doc-footer-aria-label" data-v-64d0b887>Pager</span><div class="pager" data-v-64d0b887><a class="VPLink link pager-link prev" href="/guida/core/pipelines/crm-leads-sync" data-v-64d0b887><!--[--><span class="desc" data-v-64d0b887>Pagina precedente</span><span class="title" data-v-64d0b887>crm-leads-sync</span><!--]--></a></div><div class="pager" data-v-64d0b887><a class="VPLink link pager-link next" href="/guida/core/pipelines/movimenti-per-conto" data-v-64d0b887><!--[--><span class="desc" data-v-64d0b887>Pagina successiva</span><span class="title" data-v-64d0b887>movimenti-per-conto</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-f5dee57d data-v-e10de3dd><div class="container" data-v-e10de3dd><p class="message" data-v-e10de3dd>Noeva è un marchio registrato di 4D S.R.L.</p><p class="copyright" data-v-e10de3dd>© 2026 4D S.R.L. · Gruppo4D</p></div></footer><!--[--><span hidden></span><!--]--></div></div>
|
|
56
|
-
<script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"DUHajB0u\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"ChyXSf73\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"D8Si7E2S\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"
|
|
56
|
+
<script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"DUHajB0u\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"ChyXSf73\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"D8Si7E2S\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"D13C7Zwu\",\"guide_claude-code_index.md\":\"CxVSru8e\",\"guide_claude-code_prompt.md\":\"C7uETA9W\",\"guide_claude-code_strumenti.md\":\"BWhQnAlY\",\"guide_grafo.md\":\"Dy8_YMeh\",\"guide_usare_app-desktop.md\":\"CcDu8cJL\",\"guide_usare_esito-di-una-run.md\":\"DkvAOPBE\",\"guide_usare_index.md\":\"BJqi3P7J\",\"index.md\":\"kMhsF-sv\",\"nodes_action.md\":\"DOsTbV-i\",\"nodes_ai.md\":\"CVtP9gEJ\",\"nodes_join.md\":\"DSYbIDG6\",\"nodes_lookup.md\":\"BI8tgBIq\",\"nodes_pipeline.md\":\"DIMlyprm\",\"nodes_readme.md\":\"CHGy_go6\",\"nodes_route.md\":\"Bt9qH6OA\",\"nodes_sink.md\":\"yAf_z4wO\",\"nodes_source.md\":\"V_vlNfOz\",\"nodes_task.md\":\"Dk6VB7as\",\"nodes_transform.md\":\"Bv5fg2Xx\",\"nodes_try-catch.md\":\"DCYydDPm\",\"nodes_union.md\":\"CznVzHTK\",\"pipelines_crm-leads-sync.md\":\"BlZUnxYn\",\"pipelines_cross-workspace-csv-merge.md\":\"CsRE6GNe\",\"pipelines_movimenti-per-conto.md\":\"DRGfO1_5\",\"pipelines_orders-enriched-daily.md\":\"jESRtvBo\",\"pipelines_readme.md\":\"Ee6LS-SU\",\"pipelines_test-posta.md\":\"Cxo_DGBs\",\"runbooks_aggiornamento-pm2.md\":\"f3LAxif4\",\"runbooks_deployment.md\":\"DvIOOsoG\",\"runbooks_etl-worker.md\":\"Bu05cEgT\",\"runbooks_graph-server.md\":\"BOXZqdXC\",\"runbooks_mask-key.md\":\"nZkhAjBf\",\"runbooks_oauth-google-posta.md\":\"Bs7QTkmU\",\"runbooks_rollback-di-pipeline.md\":\"6US0Wsdc\",\"runbooks_scd2-rehash.md\":\"DtmuXA67\",\"runbooks_sql-task-truncate-swap.md\":\"C8viT-fp\",\"runbooks_stato-incrementale.md\":\"hGZ8FlbZ\",\"sub-pipelines_readme.md\":\"CF8gmNPU\",\"sub-pipelines_riepilogo-ordini.md\":\"qCBZJ4nh\",\"technical_overview.md\":\"DQP0pWc8\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"it-IT\",\"dir\":\"ltr\",\"title\":\"Noeva ETL\",\"titleTemplate\":\":title · Noeva ETL\",\"description\":\"Documentazione di Noeva ETL: come usare la piattaforma e come creare pipeline con Claude Code.\",\"base\":\"/guida/core/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":{\"light\":\"/logo-dark.png\",\"dark\":\"/logo-light.png\",\"alt\":\"Noeva\"},\"siteTitle\":false,\"footer\":{\"message\":\"Noeva è un marchio registrato di 4D S.R.L.\",\"copyright\":\"© 2026 4D S.R.L. · Gruppo4D\"},\"outline\":{\"level\":[2,3],\"label\":\"In questa pagina\"},\"docFooter\":{\"prev\":\"Pagina precedente\",\"next\":\"Pagina successiva\"},\"darkModeSwitchLabel\":\"Tema\",\"lightModeSwitchTitle\":\"Passa al tema chiaro\",\"darkModeSwitchTitle\":\"Passa al tema scuro\",\"sidebarMenuLabel\":\"Menu\",\"returnToTopLabel\":\"Torna su\",\"langMenuLabel\":\"Lingua\",\"notFound\":{\"title\":\"PAGINA NON TROVATA\",\"quote\":\"Il documento che cercavi non c'è più, o non è mai stato pubblicato qui.\",\"linkLabel\":\"Torna alla home\",\"linkText\":\"Torna alla home\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Cerca\",\"buttonAriaLabel\":\"Cerca nella documentazione\"},\"modal\":{\"displayDetails\":\"Mostra i dettagli\",\"resetButtonTitle\":\"Azzera la ricerca\",\"backButtonTitle\":\"Chiudi la ricerca\",\"noResultsText\":\"Nessun risultato per\",\"footer\":{\"selectText\":\"per aprire\",\"selectKeyAriaLabel\":\"invio\",\"navigateText\":\"per spostarti\",\"navigateUpKeyAriaLabel\":\"freccia su\",\"navigateDownKeyAriaLabel\":\"freccia giù\",\"closeText\":\"per chiudere\",\"closeKeyAriaLabel\":\"esc\"}}}}},\"nav\":[{\"text\":\"Usare\",\"link\":\"/guide/usare/\",\"activeMatch\":\"^/guide/usare/\"},{\"text\":\"Creare con Claude Code\",\"link\":\"/guide/claude-code/\",\"activeMatch\":\"^/guide/claude-code/\"},{\"text\":\"Riferimento\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Tipi di nodo\",\"link\":\"/nodes/README\"},{\"text\":\"Connettori\",\"link\":\"/connectors/README\"},{\"text\":\"Pipeline pronte\",\"link\":\"/pipelines/README\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"},{\"text\":\"Operatività\",\"link\":\"/runbooks/graph-server\"}]}],\"sidebar\":[{\"text\":\"Usare Noeva ETL\",\"items\":[{\"text\":\"Come si usa\",\"link\":\"/guide/usare/\"},{\"text\":\"L'app desktop\",\"link\":\"/guide/usare/app-desktop\"},{\"text\":\"Leggere l'esito di una run\",\"link\":\"/guide/usare/esito-di-una-run\"},{\"text\":\"Panoramica di prodotto\",\"link\":\"/TECHNICAL_OVERVIEW\"}]},{\"text\":\"Creare con Claude Code\",\"items\":[{\"text\":\"Dal bisogno al processo\",\"link\":\"/guide/claude-code/\"},{\"text\":\"Comporre il prompt\",\"link\":\"/guide/claude-code/prompt\"},{\"text\":\"Skill e subagent\",\"link\":\"/guide/claude-code/strumenti\"},{\"text\":\"Guida allo sviluppo\",\"link\":\"/GUIDA_SVILUPPO\"}]},{\"text\":\"Concetti\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Versioni di pipeline\",\"link\":\"/conventions/versioni-di-pipeline\"},{\"text\":\"Descriptor dei nodi\",\"link\":\"/conventions/node-descriptor\"},{\"text\":\"Colonne dei nodi\",\"link\":\"/conventions/node-columns\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"}]},{\"text\":\"Tipi di nodo\",\"collapsed\":true,\"items\":[{\"text\":\"Cheatsheet\",\"link\":\"/nodes/README\"},{\"text\":\"action\",\"link\":\"/nodes/action\"},{\"text\":\"ai\",\"link\":\"/nodes/ai\"},{\"text\":\"join\",\"link\":\"/nodes/join\"},{\"text\":\"lookup\",\"link\":\"/nodes/lookup\"},{\"text\":\"pipeline\",\"link\":\"/nodes/pipeline\"},{\"text\":\"route\",\"link\":\"/nodes/route\"},{\"text\":\"sink\",\"link\":\"/nodes/sink\"},{\"text\":\"source\",\"link\":\"/nodes/source\"},{\"text\":\"task\",\"link\":\"/nodes/task\"},{\"text\":\"transform\",\"link\":\"/nodes/transform\"},{\"text\":\"try-catch\",\"link\":\"/nodes/try-catch\"},{\"text\":\"union\",\"link\":\"/nodes/union\"}]},{\"text\":\"Connettori\",\"collapsed\":true,\"items\":[{\"text\":\"Panoramica\",\"link\":\"/connectors/README\"},{\"text\":\"File (storage × codec)\",\"link\":\"/connectors/file\"},{\"text\":\"HTTP (API REST per i nodi lookup e action)\",\"link\":\"/connectors/http\"},{\"text\":\"IMAP (caselle di posta)\",\"link\":\"/connectors/imap\"},{\"text\":\"Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)\",\"link\":\"/connectors/jira\"},{\"text\":\"Noeva (file dei workspace)\",\"link\":\"/connectors/noeva\"},{\"text\":\"OAuth2 per i connettori di posta\",\"link\":\"/connectors/oauth\"},{\"text\":\"PostgreSQL\",\"link\":\"/connectors/postgres\"},{\"text\":\"processo esterno\",\"link\":\"/connectors/process\"},{\"text\":\"SendGrid (mail via API REST)\",\"link\":\"/connectors/sendgrid\"},{\"text\":\"SMTP (notifiche email)\",\"link\":\"/connectors/smtp\"},{\"text\":\"SQL Server\",\"link\":\"/connectors/sqlserver\"}]},{\"text\":\"Pipeline pronte\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una pipeline\",\"link\":\"/pipelines/README\"},{\"text\":\"test-posta\",\"link\":\"/pipelines/test-posta\"}]},{\"text\":\"Esempi\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una sub-pipeline\",\"link\":\"/sub-pipelines/README\"},{\"text\":\"crm-leads-sync\",\"link\":\"/pipelines/crm-leads-sync\"},{\"text\":\"cross-workspace-csv-merge\",\"link\":\"/pipelines/cross-workspace-csv-merge\"},{\"text\":\"movimenti-per-conto\",\"link\":\"/pipelines/movimenti-per-conto\"},{\"text\":\"orders-enriched-daily\",\"link\":\"/pipelines/orders-enriched-daily\"},{\"text\":\"riepilogo-ordini\",\"link\":\"/sub-pipelines/riepilogo-ordini\"}]},{\"text\":\"Operatività\",\"collapsed\":true,\"items\":[{\"text\":\"aggiornare un deploy PM2 di un repo cliente\",\"link\":\"/runbooks/aggiornamento-pm2\"},{\"text\":\"distribuzione del runner ETL\",\"link\":\"/runbooks/deployment\"},{\"text\":\"worker etl worker (polling su processes)\",\"link\":\"/runbooks/etl-worker\"},{\"text\":\"server grafi etl serve (HTTP)\",\"link\":\"/runbooks/graph-server\"},{\"text\":\"chiavi di mask (creazione, rotazione, compromissione)\",\"link\":\"/runbooks/mask-key\"},{\"text\":\"OAuth2 per una casella Google (IMAP + SMTP)\",\"link\":\"/runbooks/oauth-google-posta\"},{\"text\":\"rollback di una pipeline\",\"link\":\"/runbooks/rollback-di-pipeline\"},{\"text\":\"rehash di una dimensione storicizzata\",\"link\":\"/runbooks/scd2-rehash\"},{\"text\":\"task SQL, truncate e scambio di tabelle\",\"link\":\"/runbooks/sql-task-truncate-swap\"},{\"text\":\"stato di pipeline e watermark\",\"link\":\"/runbooks/stato-incrementale\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
|
|
57
57
|
|
|
58
58
|
</body>
|
|
59
59
|
</html>
|
|
@@ -9,9 +9,9 @@
|
|
|
9
9
|
<link rel="preload stylesheet" href="/guida/core/assets/style.BNn_AkzN.css" as="style">
|
|
10
10
|
<link rel="preload stylesheet" href="/guida/core/vp-icons.css" as="style">
|
|
11
11
|
|
|
12
|
-
<script type="module" src="/guida/core/assets/app.
|
|
12
|
+
<script type="module" src="/guida/core/assets/app.BMz6ZZYF.js"></script>
|
|
13
13
|
<link rel="preload" href="/guida/core/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
|
|
14
|
-
<link rel="modulepreload" href="/guida/core/assets/chunks/theme.
|
|
14
|
+
<link rel="modulepreload" href="/guida/core/assets/chunks/theme.DV62mViB.js">
|
|
15
15
|
<link rel="modulepreload" href="/guida/core/assets/chunks/framework.qdetmeNX.js">
|
|
16
16
|
<link rel="modulepreload" href="/guida/core/assets/pipelines_movimenti-per-conto.md.DRGfO1_5.lean.js">
|
|
17
17
|
<link rel="icon" type="image/svg+xml" href="/guida/core/favicon.svg">
|
|
@@ -38,7 +38,7 @@ memory
|
|
|
38
38
|
scarti — dead-letter
|
|
39
39
|
memory
|
|
40
40
|
</title><rect class="dag-node__halo" x="738" y="102" width="198" height="74" rx="12" data-v-340130bc></rect><!----><rect class="dag-node__card" x="742" y="106" width="190" height="66" rx="9" data-v-340130bc></rect><rect class="dag-node__accent" x="742" y="112" width="3" height="54" rx="1.5" data-v-340130bc></rect><text class="dag-node__label" x="754" y="125" data-v-340130bc>scarti</text><text class="dag-node__kind" x="922" y="125" text-anchor="end" data-v-340130bc>dead-letter</text><!--[--><text class="dag-node__sub" x="754" y="141" data-v-340130bc>memory</text><!--]--><!--[--><!--]--></g><!--]--><!--[--><!--]--></svg><!--[--><!--]--><!----></div><!----><figcaption class="graph-demo__footer" data-v-fc9b2f46><span class="graph-demo__progress" aria-hidden="true" data-v-fc9b2f46><span style="width:0%;" data-v-fc9b2f46></span></span><span class="graph-demo__caption" aria-live="polite" data-v-fc9b2f46><!--[--> Scegli una scena e premi ▶ per guardarla scorrere, oppure → per andare avanti un passo alla volta. <!--]--></span></figcaption></figure><figure class="level-nav__purposes" data-v-c981a055><figcaption id="level-nav-purposes-v-0" class="level-nav__purposes-title" data-v-c981a055> Lo scopo dei nodi </figcaption><table aria-labelledby="level-nav-purposes-v-0" data-v-c981a055><thead data-v-c981a055><tr data-v-c981a055><th scope="col" data-v-c981a055>Nodo</th><th scope="col" data-v-c981a055>Tipo</th><th scope="col" data-v-c981a055>Scopo</th></tr></thead><tbody data-v-c981a055><!--[--><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>estratti</code></td><td data-v-c981a055><code data-v-c981a055>source</code></td><td data-v-c981a055>Legge gli estratti conto di prova della dimostrazione, ognuno un file CSV con i movimenti di più conti.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>righe</code></td><td data-v-c981a055><code data-v-c981a055>transform</code></td><td data-v-c981a055>Apre ogni estratto e ne ricava i movimenti, uno per riga, ricordando da quale file e da quale riga viene ciascuno. Un file che non si legge finisce per intero fra gli scarti.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>movimenti</code></td><td data-v-c981a055><code data-v-c981a055>transform</code></td><td data-v-c981a055>Controlla che ogni movimento abbia conto, data e importo validi. Un movimento fuori regola finisce fra gli scarti, e gli altri proseguono.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>ordina</code></td><td data-v-c981a055><code data-v-c981a055>transform</code></td><td data-v-c981a055>Mette i movimenti in ordine di conto e, per ogni conto, di data, così ogni file per conto li elenca dal più vecchio.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>componi-file</code></td><td data-v-c981a055><code data-v-c981a055>transform</code></td><td data-v-c981a055>Scrive un file CSV per conto, con i suoi movimenti in ordine e gli importi con due decimali.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>file-per-conto</code></td><td data-v-c981a055><code data-v-c981a055>sink</code></td><td data-v-c981a055>Consegna i file per conto, uno per ciascun conto che compare negli estratti.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>scarti</code></td><td data-v-c981a055><code data-v-c981a055>dead-letter</code></td><td data-v-c981a055>Raccoglie i record scartati dai nodi di questa pipeline, ognuno con il motivo dello scarto.</td></tr><!--]--></tbody></table></figure></div><p>Il grafo è una catena; lo scopo di ogni nodo è nella tabella sotto il grafo. Qui il dettaglio tecnico:</p><ul><li><strong><code>righe</code></strong> — <code>parse</code> con <code>csvCodec({ delimiter: ";" })</code>: i byte arrivano dal record (<code>bytes</code>), non da <code>fileSource</code>, ed è il caso di una cartella Noeva o di un allegato di posta. La decodifica non fa IO, quindi resta una transform pura. <code>merge</code> porta nella riga il nome del file e il numero di riga. Con <code>emit: "atomic"</code>, il default, le righe di un file escono solo a decodifica finita: un errore porta il file intero nella dead-letter, con <code>fileName</code>, <code>rowNumber</code> e <code>line</code> nei <code>details</code>, e non lascia righe a metà.</li><li><strong><code>movimenti</code></strong> — <code>validate</code> con <code>movimentoSchema</code>, con la dead-letter <code>scarti</code>.</li><li><strong><code>ordina</code></strong> — <code>sort</code> su due chiavi, conto e data, stabile. È stateful: trattiene tutto lo stream fino alla fine, con il tetto <code>maxRecords</code> obbligatorio (100 000), e non ha dead-letter.</li><li><strong><code>componi-file</code></strong> — <code>serialize</code> con <code>groupBy</code> per conto: un file per gruppo, a fine stream, nell'ordine di prima comparsa della chiave. Dopo il <code>sort</code> i file escono in ordine di conto. <code>row</code> porta l'importo a stringa con due decimali, <code>toOutput</code> compone il record del file.</li></ul><h2 id="sorgenti" tabindex="-1">Sorgenti <a class="header-anchor" href="#sorgenti" aria-label="Permalink to "Sorgenti""></a></h2><ul><li><code>estratti</code>: due estratti conto di prova, in memoria, ognuno con l'header <code>conto;data;descrizione;importo</code> e i movimenti di due conti. Uno dei movimenti ha un importo che non è un numero.</li></ul><h2 id="sink" tabindex="-1">Sink <a class="header-anchor" href="#sink" aria-label="Permalink to "Sink""></a></h2><ul><li><code>file-per-conto</code>: un record per conto, con il nome del file (<code>movimenti-<conto>.csv</code>), il numero di movimenti e i byte del CSV. In una pipeline vera qui c'è un sink di file, per esempio una cartella Noeva.</li><li><code>scarti</code>: la dead-letter di <code>righe</code> e <code>movimenti</code>, con l'envelope <code>DeadLetter</code> di ogni file o riga scartati.</li></ul><h2 id="idempotenza" tabindex="-1">Idempotenza <a class="header-anchor" href="#idempotenza" aria-label="Permalink to "Idempotenza""></a></h2><p>I byte dipendono solo dagli estratti: lo stesso ingresso dà gli stessi file, nello stesso ordine. Un sink di file che sovrascrive per nome, o che salta un upload con gli stessi byte come <code>noevaFileSink</code> in <code>new-version</code>, rende sicura la riesecuzione.</p><h2 id="contratti-schema-zod" tabindex="-1">Contratti (schema Zod) <a class="header-anchor" href="#contratti-schema-zod" aria-label="Permalink to "Contratti (schema Zod)""></a></h2><ul><li><code>movimentoSchema</code>: <code>file</code>, <code>riga</code>, <code>conto</code>, <code>data</code>, <code>descrizione</code>, <code>importo</code> (con coercizione da stringa, perché il CSV non ha tipi).</li><li><code>filePerContoSchema</code>: le colonne del record in uscita da <code>componi-file</code>, per il DAG.</li></ul><h2 id="gestione-errori" tabindex="-1">Gestione errori <a class="header-anchor" href="#gestione-errori" aria-label="Permalink to "Gestione errori""></a></h2><table tabindex="0"><thead><tr><th>Caso</th><th>Dove finisce</th><th>Esito della run</th></tr></thead><tbody><tr><td>Un file che non si decodifica</td><td>scarti, per intero, con <code>fileName</code> e <code>rowNumber</code></td><td><code>partial</code></td></tr><tr><td>Una riga fuori contratto</td><td>scarti, la riga sola</td><td><code>partial</code></td></tr><tr><td>Più movimenti di <code>maxRecords</code></td><td>la run si ferma: niente ordinamento a metà</td><td><code>failed</code></td></tr></tbody></table><p>Senza un sink di scarto, i primi due casi fermano la run.</p><h2 id="parametri-ed-env" tabindex="-1">Parametri ed env <a class="header-anchor" href="#parametri-ed-env" aria-label="Permalink to "Parametri ed env""></a></h2><p>Nessuno: il dataset è in memoria.</p><h2 id="test" tabindex="-1">Test <a class="header-anchor" href="#test" aria-label="Permalink to "Test""></a></h2><p><code>pipeline.test.ts</code> copre i file per conto in ordine di data, una riga scartata, un file che non si decodifica e la riesecuzione con gli stessi byte.</p><h2 id="versioni" tabindex="-1">Versioni <a class="header-anchor" href="#versioni" aria-label="Permalink to "Versioni""></a></h2><div class="pipeline-versions" data-v-cdcb1722><!--[--><article class="pipeline-versions__entry" data-v-cdcb1722><header class="pipeline-versions__header" data-v-cdcb1722><strong class="pipeline-versions__number" data-v-cdcb1722>v1</strong><span class="pipeline-versions__meta" data-v-cdcb1722>2026-10-18 · ETL-206</span><!----></header><!----><!--[--><!--[--><div class="pipeline-versions__list" data-v-cdcb1722><span class="pipeline-versions__list-title" data-v-cdcb1722>Aggiunte</span><ul data-v-cdcb1722><!--[--><li data-v-cdcb1722>Versione iniziale: esempio di riferimento per `parse`, `sort` e `serialize`, su estratti conto di prova in memoria</li><!--]--></ul></div><!--]--><!--[--><!----><!--]--><!--[--><!----><!--]--><!--]--><div class="pipeline-versions__diff" data-v-cdcb1722><p class="pipeline-versions__note" data-v-cdcb1722> Prima versione: non c'è una versione precedente da confrontare. </p></div></article><!--]--></div></div></div></main><footer class="VPDocFooter" data-v-303c7d43 data-v-64d0b887><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-64d0b887><span class="visually-hidden" id="doc-footer-aria-label" data-v-64d0b887>Pager</span><div class="pager" data-v-64d0b887><a class="VPLink link pager-link prev" href="/guida/core/pipelines/cross-workspace-csv-merge" data-v-64d0b887><!--[--><span class="desc" data-v-64d0b887>Pagina precedente</span><span class="title" data-v-64d0b887>cross-workspace-csv-merge</span><!--]--></a></div><div class="pager" data-v-64d0b887><a class="VPLink link pager-link next" href="/guida/core/pipelines/orders-enriched-daily" data-v-64d0b887><!--[--><span class="desc" data-v-64d0b887>Pagina successiva</span><span class="title" data-v-64d0b887>orders-enriched-daily</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-f5dee57d data-v-e10de3dd><div class="container" data-v-e10de3dd><p class="message" data-v-e10de3dd>Noeva è un marchio registrato di 4D S.R.L.</p><p class="copyright" data-v-e10de3dd>© 2026 4D S.R.L. · Gruppo4D</p></div></footer><!--[--><span hidden></span><!--]--></div></div>
|
|
41
|
-
<script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"DUHajB0u\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"ChyXSf73\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"D8Si7E2S\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"
|
|
41
|
+
<script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"DUHajB0u\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"ChyXSf73\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"D8Si7E2S\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"D13C7Zwu\",\"guide_claude-code_index.md\":\"CxVSru8e\",\"guide_claude-code_prompt.md\":\"C7uETA9W\",\"guide_claude-code_strumenti.md\":\"BWhQnAlY\",\"guide_grafo.md\":\"Dy8_YMeh\",\"guide_usare_app-desktop.md\":\"CcDu8cJL\",\"guide_usare_esito-di-una-run.md\":\"DkvAOPBE\",\"guide_usare_index.md\":\"BJqi3P7J\",\"index.md\":\"kMhsF-sv\",\"nodes_action.md\":\"DOsTbV-i\",\"nodes_ai.md\":\"CVtP9gEJ\",\"nodes_join.md\":\"DSYbIDG6\",\"nodes_lookup.md\":\"BI8tgBIq\",\"nodes_pipeline.md\":\"DIMlyprm\",\"nodes_readme.md\":\"CHGy_go6\",\"nodes_route.md\":\"Bt9qH6OA\",\"nodes_sink.md\":\"yAf_z4wO\",\"nodes_source.md\":\"V_vlNfOz\",\"nodes_task.md\":\"Dk6VB7as\",\"nodes_transform.md\":\"Bv5fg2Xx\",\"nodes_try-catch.md\":\"DCYydDPm\",\"nodes_union.md\":\"CznVzHTK\",\"pipelines_crm-leads-sync.md\":\"BlZUnxYn\",\"pipelines_cross-workspace-csv-merge.md\":\"CsRE6GNe\",\"pipelines_movimenti-per-conto.md\":\"DRGfO1_5\",\"pipelines_orders-enriched-daily.md\":\"jESRtvBo\",\"pipelines_readme.md\":\"Ee6LS-SU\",\"pipelines_test-posta.md\":\"Cxo_DGBs\",\"runbooks_aggiornamento-pm2.md\":\"f3LAxif4\",\"runbooks_deployment.md\":\"DvIOOsoG\",\"runbooks_etl-worker.md\":\"Bu05cEgT\",\"runbooks_graph-server.md\":\"BOXZqdXC\",\"runbooks_mask-key.md\":\"nZkhAjBf\",\"runbooks_oauth-google-posta.md\":\"Bs7QTkmU\",\"runbooks_rollback-di-pipeline.md\":\"6US0Wsdc\",\"runbooks_scd2-rehash.md\":\"DtmuXA67\",\"runbooks_sql-task-truncate-swap.md\":\"C8viT-fp\",\"runbooks_stato-incrementale.md\":\"hGZ8FlbZ\",\"sub-pipelines_readme.md\":\"CF8gmNPU\",\"sub-pipelines_riepilogo-ordini.md\":\"qCBZJ4nh\",\"technical_overview.md\":\"DQP0pWc8\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"it-IT\",\"dir\":\"ltr\",\"title\":\"Noeva ETL\",\"titleTemplate\":\":title · Noeva ETL\",\"description\":\"Documentazione di Noeva ETL: come usare la piattaforma e come creare pipeline con Claude Code.\",\"base\":\"/guida/core/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":{\"light\":\"/logo-dark.png\",\"dark\":\"/logo-light.png\",\"alt\":\"Noeva\"},\"siteTitle\":false,\"footer\":{\"message\":\"Noeva è un marchio registrato di 4D S.R.L.\",\"copyright\":\"© 2026 4D S.R.L. · Gruppo4D\"},\"outline\":{\"level\":[2,3],\"label\":\"In questa pagina\"},\"docFooter\":{\"prev\":\"Pagina precedente\",\"next\":\"Pagina successiva\"},\"darkModeSwitchLabel\":\"Tema\",\"lightModeSwitchTitle\":\"Passa al tema chiaro\",\"darkModeSwitchTitle\":\"Passa al tema scuro\",\"sidebarMenuLabel\":\"Menu\",\"returnToTopLabel\":\"Torna su\",\"langMenuLabel\":\"Lingua\",\"notFound\":{\"title\":\"PAGINA NON TROVATA\",\"quote\":\"Il documento che cercavi non c'è più, o non è mai stato pubblicato qui.\",\"linkLabel\":\"Torna alla home\",\"linkText\":\"Torna alla home\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Cerca\",\"buttonAriaLabel\":\"Cerca nella documentazione\"},\"modal\":{\"displayDetails\":\"Mostra i dettagli\",\"resetButtonTitle\":\"Azzera la ricerca\",\"backButtonTitle\":\"Chiudi la ricerca\",\"noResultsText\":\"Nessun risultato per\",\"footer\":{\"selectText\":\"per aprire\",\"selectKeyAriaLabel\":\"invio\",\"navigateText\":\"per spostarti\",\"navigateUpKeyAriaLabel\":\"freccia su\",\"navigateDownKeyAriaLabel\":\"freccia giù\",\"closeText\":\"per chiudere\",\"closeKeyAriaLabel\":\"esc\"}}}}},\"nav\":[{\"text\":\"Usare\",\"link\":\"/guide/usare/\",\"activeMatch\":\"^/guide/usare/\"},{\"text\":\"Creare con Claude Code\",\"link\":\"/guide/claude-code/\",\"activeMatch\":\"^/guide/claude-code/\"},{\"text\":\"Riferimento\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Tipi di nodo\",\"link\":\"/nodes/README\"},{\"text\":\"Connettori\",\"link\":\"/connectors/README\"},{\"text\":\"Pipeline pronte\",\"link\":\"/pipelines/README\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"},{\"text\":\"Operatività\",\"link\":\"/runbooks/graph-server\"}]}],\"sidebar\":[{\"text\":\"Usare Noeva ETL\",\"items\":[{\"text\":\"Come si usa\",\"link\":\"/guide/usare/\"},{\"text\":\"L'app desktop\",\"link\":\"/guide/usare/app-desktop\"},{\"text\":\"Leggere l'esito di una run\",\"link\":\"/guide/usare/esito-di-una-run\"},{\"text\":\"Panoramica di prodotto\",\"link\":\"/TECHNICAL_OVERVIEW\"}]},{\"text\":\"Creare con Claude Code\",\"items\":[{\"text\":\"Dal bisogno al processo\",\"link\":\"/guide/claude-code/\"},{\"text\":\"Comporre il prompt\",\"link\":\"/guide/claude-code/prompt\"},{\"text\":\"Skill e subagent\",\"link\":\"/guide/claude-code/strumenti\"},{\"text\":\"Guida allo sviluppo\",\"link\":\"/GUIDA_SVILUPPO\"}]},{\"text\":\"Concetti\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Versioni di pipeline\",\"link\":\"/conventions/versioni-di-pipeline\"},{\"text\":\"Descriptor dei nodi\",\"link\":\"/conventions/node-descriptor\"},{\"text\":\"Colonne dei nodi\",\"link\":\"/conventions/node-columns\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"}]},{\"text\":\"Tipi di nodo\",\"collapsed\":true,\"items\":[{\"text\":\"Cheatsheet\",\"link\":\"/nodes/README\"},{\"text\":\"action\",\"link\":\"/nodes/action\"},{\"text\":\"ai\",\"link\":\"/nodes/ai\"},{\"text\":\"join\",\"link\":\"/nodes/join\"},{\"text\":\"lookup\",\"link\":\"/nodes/lookup\"},{\"text\":\"pipeline\",\"link\":\"/nodes/pipeline\"},{\"text\":\"route\",\"link\":\"/nodes/route\"},{\"text\":\"sink\",\"link\":\"/nodes/sink\"},{\"text\":\"source\",\"link\":\"/nodes/source\"},{\"text\":\"task\",\"link\":\"/nodes/task\"},{\"text\":\"transform\",\"link\":\"/nodes/transform\"},{\"text\":\"try-catch\",\"link\":\"/nodes/try-catch\"},{\"text\":\"union\",\"link\":\"/nodes/union\"}]},{\"text\":\"Connettori\",\"collapsed\":true,\"items\":[{\"text\":\"Panoramica\",\"link\":\"/connectors/README\"},{\"text\":\"File (storage × codec)\",\"link\":\"/connectors/file\"},{\"text\":\"HTTP (API REST per i nodi lookup e action)\",\"link\":\"/connectors/http\"},{\"text\":\"IMAP (caselle di posta)\",\"link\":\"/connectors/imap\"},{\"text\":\"Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)\",\"link\":\"/connectors/jira\"},{\"text\":\"Noeva (file dei workspace)\",\"link\":\"/connectors/noeva\"},{\"text\":\"OAuth2 per i connettori di posta\",\"link\":\"/connectors/oauth\"},{\"text\":\"PostgreSQL\",\"link\":\"/connectors/postgres\"},{\"text\":\"processo esterno\",\"link\":\"/connectors/process\"},{\"text\":\"SendGrid (mail via API REST)\",\"link\":\"/connectors/sendgrid\"},{\"text\":\"SMTP (notifiche email)\",\"link\":\"/connectors/smtp\"},{\"text\":\"SQL Server\",\"link\":\"/connectors/sqlserver\"}]},{\"text\":\"Pipeline pronte\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una pipeline\",\"link\":\"/pipelines/README\"},{\"text\":\"test-posta\",\"link\":\"/pipelines/test-posta\"}]},{\"text\":\"Esempi\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una sub-pipeline\",\"link\":\"/sub-pipelines/README\"},{\"text\":\"crm-leads-sync\",\"link\":\"/pipelines/crm-leads-sync\"},{\"text\":\"cross-workspace-csv-merge\",\"link\":\"/pipelines/cross-workspace-csv-merge\"},{\"text\":\"movimenti-per-conto\",\"link\":\"/pipelines/movimenti-per-conto\"},{\"text\":\"orders-enriched-daily\",\"link\":\"/pipelines/orders-enriched-daily\"},{\"text\":\"riepilogo-ordini\",\"link\":\"/sub-pipelines/riepilogo-ordini\"}]},{\"text\":\"Operatività\",\"collapsed\":true,\"items\":[{\"text\":\"aggiornare un deploy PM2 di un repo cliente\",\"link\":\"/runbooks/aggiornamento-pm2\"},{\"text\":\"distribuzione del runner ETL\",\"link\":\"/runbooks/deployment\"},{\"text\":\"worker etl worker (polling su processes)\",\"link\":\"/runbooks/etl-worker\"},{\"text\":\"server grafi etl serve (HTTP)\",\"link\":\"/runbooks/graph-server\"},{\"text\":\"chiavi di mask (creazione, rotazione, compromissione)\",\"link\":\"/runbooks/mask-key\"},{\"text\":\"OAuth2 per una casella Google (IMAP + SMTP)\",\"link\":\"/runbooks/oauth-google-posta\"},{\"text\":\"rollback di una pipeline\",\"link\":\"/runbooks/rollback-di-pipeline\"},{\"text\":\"rehash di una dimensione storicizzata\",\"link\":\"/runbooks/scd2-rehash\"},{\"text\":\"task SQL, truncate e scambio di tabelle\",\"link\":\"/runbooks/sql-task-truncate-swap\"},{\"text\":\"stato di pipeline e watermark\",\"link\":\"/runbooks/stato-incrementale\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
|
|
42
42
|
|
|
43
43
|
</body>
|
|
44
44
|
</html>
|