@noeva/etl-core 1.1.1 → 1.2.0

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.
Files changed (87) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/dist/chunk-IDQXX435.js +1 -0
  3. package/dist/{chunk-KEFIGSRS.js → chunk-SRO66WUJ.js} +1 -1
  4. package/dist/chunk-XRRC27NI.js +1 -0
  5. package/dist/cli.js +120 -120
  6. package/dist/connectors/process.js +1 -1
  7. package/dist/etl.config.js +6 -6
  8. package/dist/guida/404.html +2 -2
  9. package/dist/guida/GUIDA_SVILUPPO.html +4 -4
  10. package/dist/guida/TECHNICAL_OVERVIEW.html +4 -4
  11. package/dist/guida/assets/{app.uK-5scpr.js → app.Dsl1ZLFh.js} +1 -1
  12. package/dist/guida/assets/chunks/@localSearchIndexroot.DZbSWLHu.js +1 -0
  13. package/dist/guida/assets/chunks/{VPLocalSearchBox.CB5vaMvW.js → VPLocalSearchBox.CMLsenZG.js} +1 -1
  14. package/dist/guida/assets/chunks/{theme.z6u0J2Ii.js → theme.DspmxPAW.js} +7 -7
  15. package/dist/guida/assets/pipelines_analytics-snapshot.md.B8KfsjUs.js +1 -0
  16. package/dist/guida/assets/pipelines_analytics-snapshot.md.B8KfsjUs.lean.js +1 -0
  17. package/dist/guida/connectors/README.html +4 -4
  18. package/dist/guida/connectors/excel.html +4 -4
  19. package/dist/guida/connectors/file.html +4 -4
  20. package/dist/guida/connectors/http.html +4 -4
  21. package/dist/guida/connectors/imap.html +4 -4
  22. package/dist/guida/connectors/jira.html +4 -4
  23. package/dist/guida/connectors/mysql.html +4 -4
  24. package/dist/guida/connectors/noeva.html +4 -4
  25. package/dist/guida/connectors/oauth.html +4 -4
  26. package/dist/guida/connectors/odoo.html +4 -4
  27. package/dist/guida/connectors/postgres.html +4 -4
  28. package/dist/guida/connectors/process.html +4 -4
  29. package/dist/guida/connectors/sendgrid.html +4 -4
  30. package/dist/guida/connectors/smtp.html +4 -4
  31. package/dist/guida/connectors/sqlserver.html +4 -4
  32. package/dist/guida/connectors/zoho.html +4 -4
  33. package/dist/guida/conventions/node-columns.html +4 -4
  34. package/dist/guida/conventions/node-descriptor.html +4 -4
  35. package/dist/guida/conventions/run-report.html +4 -4
  36. package/dist/guida/conventions/run-trace.html +4 -4
  37. package/dist/guida/conventions/variabili-del-core.html +4 -4
  38. package/dist/guida/conventions/versioni-di-pipeline.html +4 -4
  39. package/dist/guida/guide/claude-code/index.html +4 -4
  40. package/dist/guida/guide/claude-code/prompt.html +4 -4
  41. package/dist/guida/guide/claude-code/strumenti.html +4 -4
  42. package/dist/guida/guide/grafo.html +4 -4
  43. package/dist/guida/guide/usare/app-desktop.html +4 -4
  44. package/dist/guida/guide/usare/esito-di-una-run.html +4 -4
  45. package/dist/guida/guide/usare/index.html +4 -4
  46. package/dist/guida/hashmap.json +1 -1
  47. package/dist/guida/index.html +3 -3
  48. package/dist/guida/nodes/README.html +4 -4
  49. package/dist/guida/nodes/action.html +4 -4
  50. package/dist/guida/nodes/ai.html +4 -4
  51. package/dist/guida/nodes/join.html +4 -4
  52. package/dist/guida/nodes/lookup.html +4 -4
  53. package/dist/guida/nodes/pipeline.html +4 -4
  54. package/dist/guida/nodes/route.html +4 -4
  55. package/dist/guida/nodes/sink.html +4 -4
  56. package/dist/guida/nodes/source.html +4 -4
  57. package/dist/guida/nodes/task.html +4 -4
  58. package/dist/guida/nodes/transform.html +4 -4
  59. package/dist/guida/nodes/try-catch.html +4 -4
  60. package/dist/guida/nodes/union.html +4 -4
  61. package/dist/guida/pagine.json +2 -0
  62. package/dist/guida/pipelines/README.html +5 -5
  63. package/dist/guida/pipelines/analytics-snapshot.html +40 -0
  64. package/dist/guida/pipelines/crm-leads-sync.html +4 -4
  65. package/dist/guida/pipelines/cross-workspace-csv-merge.html +4 -4
  66. package/dist/guida/pipelines/movimenti-per-conto.html +4 -4
  67. package/dist/guida/pipelines/orders-enriched-daily.html +4 -4
  68. package/dist/guida/pipelines/test-posta.html +5 -5
  69. package/dist/guida/runbooks/aggiornamento-pm2.html +4 -4
  70. package/dist/guida/runbooks/deploy-ecr.html +4 -4
  71. package/dist/guida/runbooks/deployment.html +4 -4
  72. package/dist/guida/runbooks/etl-worker.html +4 -4
  73. package/dist/guida/runbooks/excel-operazioni-distruttive.html +4 -4
  74. package/dist/guida/runbooks/graph-server.html +4 -4
  75. package/dist/guida/runbooks/mask-key.html +4 -4
  76. package/dist/guida/runbooks/oauth-google-posta.html +4 -4
  77. package/dist/guida/runbooks/rollback-di-pipeline.html +4 -4
  78. package/dist/guida/runbooks/scd2-rehash.html +4 -4
  79. package/dist/guida/runbooks/sql-task-truncate-swap.html +4 -4
  80. package/dist/guida/runbooks/stato-incrementale.html +4 -4
  81. package/dist/guida/sub-pipelines/README.html +4 -4
  82. package/dist/guida/sub-pipelines/riepilogo-ordini.html +4 -4
  83. package/dist/pipelines.d.ts +24 -1
  84. package/dist/pipelines.js +1 -1
  85. package/package.json +1 -1
  86. package/dist/chunk-5XVANFXO.js +0 -1
  87. package/dist/guida/assets/chunks/@localSearchIndexroot.AxYI9rrX.js +0 -1
@@ -0,0 +1 @@
1
+ import{_ as s,C as o,o as n,c as l,a5 as t,E as a}from"./chunks/framework.qdetmeNX.js";const b=JSON.parse('{"title":"Pipeline: analytics-snapshot","description":"","frontmatter":{"pageClass":"etl-wide"},"headers":[],"relativePath":"pipelines/analytics-snapshot.md","filePath":"pipelines/analytics-snapshot.md"}'),r={name:"pipelines/analytics-snapshot.md"};function c(p,e,h,u,m,g){const i=o("PipelineDag"),d=o("PipelineVersions");return n(),l("div",null,[e[0]||(e[0]=t('<h1 id="pipeline-analytics-snapshot" tabindex="-1">Pipeline: analytics-snapshot <a class="header-anchor" href="#pipeline-analytics-snapshot" aria-label="Permalink to &quot;Pipeline: analytics-snapshot&quot;">​</a></h1><ul><li><strong>Scopo:</strong> lo snapshot delle dashboard NOEVA Analytics di un cliente, generato e pubblicato sul suo server da <code>noeva-snapshot</code>, lanciato dal worker ETL</li><li><strong>Ambito:</strong> core, pipeline <strong>standard</strong>: non si importa in <code>etl.config.ts</code>, la accende il <code>.env</code> del cliente con <code>CORE_ANALYTICS_SNAPSHOT</code> · <strong>Decisione:</strong> ADR-0113</li><li><strong>Cadenza:</strong> quella della schedulazione del workspace che porta lo stesso nome della pipeline</li><li><strong>Durata:</strong> qualche minuto (circa 9 sul DataSmart di un cliente reale); timeout 45 minuti</li></ul><p>La pipeline non ha dati suoi. Un record di avvio fa partire <code>noeva-snapshot giro</code>, che legge il database attraverso il modello semantico di NOEVA Analytics, controlla le cifre di <code>snapshot.yml</code> e, se tornano, pubblica lo snapshot nel contenitore delle dashboard con un biglietto dell&#39;API NOEVA. Le regole di business stanno solo nel modello.</p><h2 id="come-si-accende" tabindex="-1">Come si accende <a class="header-anchor" href="#come-si-accende" aria-label="Permalink to &quot;Come si accende&quot;">​</a></h2><p>Nel <code>.env</code> del cliente:</p><table tabindex="0"><thead><tr><th>Variabile</th><th>Valore</th></tr></thead><tbody><tr><td><code>CORE_ANALYTICS_SNAPSHOT</code></td><td>il nome della pipeline: minuscole, cifre e trattini. Assente o vuota, la pipeline <strong>non c&#39;è</strong></td></tr><tr><td><code>CORE_ANALYTICS_SNAPSHOT_ENV</code></td><td>opzionale: nomi, separati da virgola, delle variabili in più che il giro riceve (es. la password del database)</td></tr></tbody></table><p>Il nome è quattro cose insieme: il nome della pipeline nel catalogo, <code>processes.function</code>, il nome della schedulazione del workspace e la chiave <code>--pipeline</code> del <code>worker.json</code> di <code>noeva-snapshot</code>. <strong>Deve</strong> combaciare. Non è il nome di un servizio di Windows: <code>noeva-snapshot.exe</code> viene lanciato come processo figlio.</p><h2 id="flusso-dati" tabindex="-1">Flusso dati <a class="header-anchor" href="#flusso-dati" aria-label="Permalink to &quot;Flusso dati&quot;">​</a></h2>',8)),a(i,{name:"analytics-snapshot"}),e[1]||(e[1]=t('<table tabindex="0"><thead><tr><th>Nodo</th><th>Tipo</th><th>Dettaglio tecnico</th></tr></thead><tbody><tr><td><code>avvio</code></td><td><code>source</code></td><td>un record per run</td></tr><tr><td><code>giro-snapshot</code></td><td><code>action</code></td><td><code>processoEsternoAction</code>: <code>C:\\NOEVA\\snapshot\\noeva-snapshot\\noeva-snapshot.exe giro …</code>, timeout 45 minuti, senza dead-letter</td></tr><tr><td><code>esito</code></td><td><code>sink</code></td><td>in memoria: l&#39;esito del giro, che il report del nodo <code>giro-snapshot</code> riporta sotto <code>giri</code></td></tr></tbody></table><h2 id="che-cosa-serve-sul-server" tabindex="-1">Che cosa serve sul server <a class="header-anchor" href="#che-cosa-serve-sul-server" aria-label="Permalink to &quot;Che cosa serve sul server&quot;">​</a></h2><ol><li><code>noeva-snapshot</code> 0.3.0 o successivo (il comando <code>giro</code>), installato in <code>C:\\NOEVA\\snapshot</code> con <code>installa.ps1 -ConNoevaEtl</code>. Lo script toglie l&#39;attività pianificata, se c&#39;era.</li><li>Nel <code>.env</code> del worker: <code>NOEVA_API_KEY</code>, <code>NOEVA_MSSQL_DRIVER</code> e le variabili elencate in <code>CORE_ANALYTICS_SNAPSHOT_ENV</code>. Il giro riceve <strong>solo</strong> queste, più quelle di sistema di Windows (<code>SYSTEMROOT</code>, <code>PATH</code>, <code>TEMP</code>, proxy…): gli altri segreti dell&#39;ETL restano fuori.</li><li>L&#39;utente di servizio della chiave del worker, membro del workspace del cliente.</li></ol><h2 id="esito-ed-errori" tabindex="-1">Esito ed errori <a class="header-anchor" href="#esito-ed-errori" aria-label="Permalink to &quot;Esito ed errori&quot;">​</a></h2><table tabindex="0"><thead><tr><th>Caso</th><th>Run</th><th>Dove si legge</th></tr></thead><tbody><tr><td>Pubblicato</td><td><code>success</code></td><td>report del nodo <code>giro-snapshot</code>, <code>giri</code>: versione, data del dato</td></tr><tr><td>Una cifra di controllo non torna</td><td><code>failed</code></td><td>l&#39;errore del processo: «FALLITO, NON pubblico: …» in fondo a stderr</td></tr><tr><td>Database, driver o password</td><td><code>failed</code></td><td>come sopra, con il messaggio del driver</td></tr><tr><td>Eseguibile assente</td><td><code>failed</code></td><td>«Impossibile avviare il processo …»: <code>installa.ps1</code> non è passato</td></tr><tr><td>Oltre 45 minuti</td><td><code>failed</code></td><td>timeout: il processo viene terminato</td></tr></tbody></table><h2 id="versioni" tabindex="-1">Versioni <a class="header-anchor" href="#versioni" aria-label="Permalink to &quot;Versioni&quot;">​</a></h2><p>La versione corrente e lo storico stanno nel changelog della pipeline (<code>src/pipelines/analytics-snapshot/changelog.ts</code>). Vedi <a href="./../conventions/versioni-di-pipeline">versioni di pipeline</a>.</p>',7)),a(d,{name:"analytics-snapshot"})])}const _=s(r,[["render",c]]);export{b as __pageData,_ as default};
@@ -0,0 +1 @@
1
+ import{_ as s,C as o,o as n,c as l,a5 as t,E as a}from"./chunks/framework.qdetmeNX.js";const b=JSON.parse('{"title":"Pipeline: analytics-snapshot","description":"","frontmatter":{"pageClass":"etl-wide"},"headers":[],"relativePath":"pipelines/analytics-snapshot.md","filePath":"pipelines/analytics-snapshot.md"}'),r={name:"pipelines/analytics-snapshot.md"};function c(p,e,h,u,m,g){const i=o("PipelineDag"),d=o("PipelineVersions");return n(),l("div",null,[e[0]||(e[0]=t("",8)),a(i,{name:"analytics-snapshot"}),e[1]||(e[1]=t("",7)),a(d,{name:"analytics-snapshot"})])}const _=s(r,[["render",c]]);export{b as __pageData,_ as default};
@@ -9,9 +9,9 @@
9
9
  <link rel="preload stylesheet" href="/guida/core/assets/style.DFlUbYCk.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.uK-5scpr.js"></script>
12
+ <script type="module" src="/guida/core/assets/app.Dsl1ZLFh.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.z6u0J2Ii.js">
14
+ <link rel="modulepreload" href="/guida/core/assets/chunks/theme.DspmxPAW.js">
15
15
  <link rel="modulepreload" href="/guida/core/assets/chunks/framework.qdetmeNX.js">
16
16
  <link rel="modulepreload" href="/guida/core/assets/connectors_README.md.B5QWzWUK.lean.js">
17
17
  <link rel="icon" type="image/svg+xml" href="/guida/core/favicon.svg">
@@ -20,8 +20,8 @@
20
20
  <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
21
21
  </head>
22
22
  <body>
23
- <div id="app"><div class="Layout" data-v-22f0e4eb><!--[--><!--]--><!--[--><span tabindex="-1" data-v-3426c47a></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-3426c47a>Skip to content</a><!--]--><!----><header class="VPNav" data-v-22f0e4eb data-v-c0562b42><div class="VPNavBar" data-v-c0562b42 data-v-09e46d68><div class="wrapper" data-v-09e46d68><div class="container" data-v-09e46d68><div class="title" data-v-09e46d68><div class="VPNavBarTitle has-sidebar" data-v-09e46d68 data-v-373bba86><a class="title" href="/guida/core/" data-v-373bba86><!--[--><!--]--><!--[--><!--[--><!--[--><img class="VPImage dark logo" src="/guida/core/logo-light.png" alt="Noeva" data-v-b8fe04e5><!--]--><!--[--><img class="VPImage light logo" src="/guida/core/logo-dark.png" alt="Noeva" data-v-b8fe04e5><!--]--><!--]--><!--]--><!----><!--[--><!--[--><!--[--><!--[--><span class="etl-wordmark" aria-hidden="true">ETL</span><span class="etl-embedded-title">Documentazione</span><!--]--><!--]--><!--]--><!--]--></a></div></div><div class="content" data-v-09e46d68><div class="content-body" data-v-09e46d68><!--[--><!--]--><div class="VPNavBarSearch search" data-v-09e46d68><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Cerca nella documentazione"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Cerca</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-09e46d68 data-v-39d75b74><span id="main-nav-aria-label" class="visually-hidden" data-v-39d75b74> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/guida/core/guide/usare/" tabindex="0" data-v-39d75b74 data-v-d4ae6030><!--[--><span data-v-d4ae6030>Usare</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/guida/core/guide/claude-code/" tabindex="0" data-v-39d75b74 data-v-d4ae6030><!--[--><span data-v-d4ae6030>Creare con Claude Code</span><!--]--></a><!--]--><!--[--><div class="VPFlyout VPNavBarMenuGroup active" data-v-39d75b74 data-v-5d303cc7><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-5d303cc7><span class="text" data-v-5d303cc7><!----><span data-v-5d303cc7>Riferimento</span><span class="vpi-chevron-down text-icon" data-v-5d303cc7></span></span></button><div class="menu" data-v-5d303cc7><div class="VPMenu" data-v-5d303cc7 data-v-e79ccfeb><div class="items" data-v-e79ccfeb><!--[--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/guide/grafo" data-v-b2643254><!--[--><span data-v-b2643254>Il grafo, nodo per nodo</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/nodes/README" data-v-b2643254><!--[--><span data-v-b2643254>Tipi di nodo</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link active" href="/guida/core/connectors/README" data-v-b2643254><!--[--><span data-v-b2643254>Connettori</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/pipelines/README" data-v-b2643254><!--[--><span data-v-b2643254>Pipeline pronte</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/conventions/run-report" data-v-b2643254><!--[--><span data-v-b2643254>Il report di run</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/conventions/run-trace" data-v-b2643254><!--[--><span data-v-b2643254>La traccia di una run</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/conventions/variabili-del-core" data-v-b2643254><!--[--><span data-v-b2643254>Variabili d'ambiente del core</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/runbooks/graph-server" data-v-b2643254><!--[--><span data-v-b2643254>Operatività</span><!--]--></a></div><!--]--><!--]--></div><!--[--><!--]--></div></div></div><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-09e46d68 data-v-41033a42><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-41033a42 data-v-16571e93 data-v-3d2b146f><span class="check" data-v-3d2b146f><span class="icon" data-v-3d2b146f><!--[--><span class="vpi-sun sun" data-v-16571e93></span><span class="vpi-moon moon" data-v-16571e93></span><!--]--></span></span></button></div><!----><div class="VPFlyout VPNavBarExtra extra" data-v-09e46d68 data-v-6ab99828 data-v-5d303cc7><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-5d303cc7><span class="vpi-more-horizontal icon" data-v-5d303cc7></span></button><div class="menu" data-v-5d303cc7><div class="VPMenu" data-v-5d303cc7 data-v-e79ccfeb><!----><!--[--><!--[--><!----><div class="group" data-v-6ab99828><div class="item appearance" data-v-6ab99828><p class="label" data-v-6ab99828>Tema</p><div class="appearance-action" data-v-6ab99828><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-6ab99828 data-v-16571e93 data-v-3d2b146f><span class="check" data-v-3d2b146f><span class="icon" data-v-3d2b146f><!--[--><span class="vpi-sun sun" data-v-16571e93></span><span class="vpi-moon moon" data-v-16571e93></span><!--]--></span></span></button></div></div></div><!----><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-09e46d68 data-v-91920283><span class="container" data-v-91920283><span class="top" data-v-91920283></span><span class="middle" data-v-91920283></span><span class="bottom" data-v-91920283></span></span></button></div></div></div></div><div class="divider" data-v-09e46d68><div class="divider-line" data-v-09e46d68></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-22f0e4eb data-v-caa5a72f><div class="container" data-v-caa5a72f><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-caa5a72f><span class="vpi-align-left menu-icon" data-v-caa5a72f></span><span class="menu-text" data-v-caa5a72f>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-caa5a72f data-v-731b3d50><button data-v-731b3d50>Torna su</button><!----></div></div></div><aside class="VPSidebar" data-v-22f0e4eb data-v-ac566ed2><div class="curtain" data-v-ac566ed2></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-ac566ed2><span class="visually-hidden" id="sidebar-aria-label" data-v-ac566ed2> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Usare Noeva ETL</h2><!----></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/usare/" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Come si usa</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/usare/app-desktop" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>L'app desktop</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/usare/esito-di-una-run" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Leggere l'esito di una run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/TECHNICAL_OVERVIEW" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Panoramica di prodotto</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Creare con Claude Code</h2><!----></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/claude-code/" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Dal bisogno al processo</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/claude-code/prompt" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Comporre il prompt</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/claude-code/strumenti" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Skill e subagent</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/GUIDA_SVILUPPO" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Guida allo sviluppo</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Concetti</h2><!----></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/grafo" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Il grafo, nodo per nodo</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/run-report" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Il report di run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/run-trace" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>La traccia di una run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/versioni-di-pipeline" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Versioni di pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/node-descriptor" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Descriptor dei nodi</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/node-columns" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Colonne dei nodi</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/variabili-del-core" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Variabili d'ambiente del core</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Tipi di nodo</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/README" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Cheatsheet</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/action" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>action</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/ai" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>ai</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/join" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>join</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/lookup" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>lookup</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/pipeline" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/route" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>route</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/sink" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>sink</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/source" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>source</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/task" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>task</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/transform" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>transform</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/try-catch" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>try-catch</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/union" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>union</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed has-active" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Connettori</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/README" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Panoramica</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/excel" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Excel</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/file" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>File (storage × codec)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/http" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>HTTP (API REST per i nodi lookup e action)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/imap" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>IMAP (caselle di posta)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/jira" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/mysql" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>MySQL e MariaDB</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/noeva" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Noeva (file dei workspace)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/oauth" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>OAuth2 per i connettori</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/odoo" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Odoo (record di un modello, con i campi dichiarati)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/postgres" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>PostgreSQL</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/process" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>processo esterno</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/sendgrid" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>SendGrid (mail via API REST)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/smtp" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>SMTP (notifiche email)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/sqlserver" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>SQL Server</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/zoho" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Zoho CRM (record di un modulo, con i campi dichiarati)</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Pipeline pronte</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/README" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Le schede di una pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/test-posta" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>test-posta</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Esempi</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/sub-pipelines/README" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Le schede di una sub-pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/crm-leads-sync" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>crm-leads-sync</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/cross-workspace-csv-merge" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>cross-workspace-csv-merge</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/movimenti-per-conto" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>movimenti-per-conto</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/orders-enriched-daily" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>orders-enriched-daily</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/sub-pipelines/riepilogo-ordini" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>riepilogo-ordini</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Operatività</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/aggiornamento-pm2" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>aggiornare un deploy PM2 di un repo cliente</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/deploy-ecr" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>un cliente su ECR + ECS</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/deployment" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>distribuzione del runner ETL</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/etl-worker" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>worker etl worker (polling su processes)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/excel-operazioni-distruttive" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>operazioni distruttive di excelSink</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/graph-server" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>server grafi etl serve (HTTP)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/mask-key" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>chiavi di mask (creazione, rotazione, compromissione)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/oauth-google-posta" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>OAuth2 per una casella Google (IMAP + SMTP)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/rollback-di-pipeline" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>rollback di una pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/scd2-rehash" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>rehash di una dimensione storicizzata</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/sql-task-truncate-swap" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>task SQL, truncate e scambio di tabelle</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/stato-incrementale" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>stato di pipeline e watermark</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-22f0e4eb data-v-0c4b08a9><div class="VPDoc has-sidebar has-aside" data-v-0c4b08a9 data-v-4f20312f><!--[--><!--]--><div class="container" data-v-4f20312f><div class="aside" data-v-4f20312f><div class="aside-curtain" data-v-4f20312f></div><div class="aside-container" data-v-4f20312f><div class="aside-content" data-v-4f20312f><div class="VPDocAside" data-v-4f20312f data-v-2db35001><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-2db35001 data-v-2f8395af><div class="content" data-v-2f8395af><div class="outline-marker" data-v-2f8395af></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-2f8395af>In questa pagina</div><ul class="VPDocOutlineItem root" data-v-2f8395af data-v-9c3b479d><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-2db35001></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-4f20312f><div class="content-container" data-v-4f20312f><!--[--><!--]--><main class="main" data-v-4f20312f><div style="position:relative;" class="vp-doc _guida_core_connectors_README" data-v-4f20312f><div><h1 id="connettori" tabindex="-1">Connettori <a class="header-anchor" href="#connettori" aria-label="Permalink to &quot;Connettori&quot;">​</a></h1><p>I connettori sono le implementazioni reali di <code>Source</code> (estrazione) e <code>Sink</code> (caricamento) verso sistemi esterni. Vivono in <code>src/connectors/&lt;sistema&gt;/</code> e si <strong>iniettano</strong> nelle pipeline (mai istanziati dentro la definizione).</p><h2 id="indice" tabindex="-1">Indice <a class="header-anchor" href="#indice" aria-label="Permalink to &quot;Indice&quot;">​</a></h2><table tabindex="0"><thead><tr><th>Connettore</th><th>Source</th><th>Sink</th><th>Doc</th></tr></thead><tbody><tr><td>PostgreSQL</td><td>✅ streaming (cursor)</td><td>✅ upsert idempotente (ON CONFLICT), o <a href="./postgres#scd2">SCD2</a></td><td><a href="./postgres">postgres.md</a></td></tr><tr><td>SQL Server</td><td>✅ streaming (pause/resume)</td><td>✅ upsert idempotente (MERGE), o <a href="./sqlserver#scd2">SCD2</a></td><td><a href="./sqlserver">sqlserver.md</a></td></tr><tr><td>MySQL e MariaDB</td><td>✅ streaming (<code>mysql2</code>)</td><td>✅ upsert idempotente (ON DUPLICATE KEY UPDATE)</td><td><a href="./mysql">mysql.md</a></td></tr><tr><td>File (storage × codec)</td><td>✅ <code>fileSource</code></td><td>✅ <code>fileSink</code></td><td><a href="./file">file.md</a></td></tr><tr><td>— storage: filesystem · <strong>S3</strong> · <strong>SFTP</strong> · <strong>FTP/FTPS</strong> · memory</td><td>(vedi file.md)</td><td>(vedi file.md)</td><td><a href="./file">file.md</a></td></tr><tr><td>— codec: <strong>CSV</strong> (anche grezzo) · <strong>JSON/NDJSON</strong> · <strong>XML</strong> · <strong>XLSX</strong> · <strong>Parquet</strong></td><td>(vedi file.md)</td><td>(vedi file.md)</td><td><a href="./file">file.md</a></td></tr><tr><td>Excel (workbook <code>.xlsx</code>/<code>.xlsm</code>)</td><td>✅ uno o più fogli, a flusso, colonne per titolo</td><td>✅ <code>append</code>, <code>upsert</code> per chiave e <code>replace</code> su workbook nuovo o esistente, che conserva grafici, pivot e macro; più <code>excelTask</code> (fogli e colonne)</td><td><a href="./excel">excel.md</a></td></tr><tr><td>Noeva (file dei workspace)</td><td>✅ file singolo · cartella</td><td>✅ file singolo · multi-file, <code>overwrite</code>/<code>new-version</code></td><td><a href="./noeva">noeva.md</a></td></tr><tr><td>IMAP (caselle di posta)</td><td>✅ messaggi di una cartella</td><td>— (action: flag, spostamento)</td><td><a href="./imap">imap.md</a></td></tr><tr><td>SMTP (notifiche email)</td><td>— (action: invio con esito)</td><td>✅ una mail per record, isolabile</td><td><a href="./smtp">smtp.md</a></td></tr><tr><td>SendGrid (mail via API REST; <code>mailAction</code>/<code>mailSink</code> per scegliere il trasporto)</td><td>— (action: invio con esito)</td><td>✅ una mail per record, isolabile</td><td><a href="./sendgrid">sendgrid.md</a></td></tr><tr><td>HTTP (API REST)</td><td>— (lookup: <code>httpLookup</code>)</td><td>— (action: <code>httpAction</code>)</td><td><a href="./http">http.md</a></td></tr><tr><td>Jira Cloud (issue)</td><td>✅ JQL; lookup per chiave e liste</td><td>— (action: <code>jiraCreateIssue</code>, <code>jiraUpdateIssue</code>, <code>jiraTransition</code>, <code>jiraUpsertIssue</code>, <code>jiraAddComment</code>, <code>jiraAddWorklog</code>, <code>jiraLinkIssues</code>)</td><td><a href="./jira">jira.md</a></td></tr><tr><td>Odoo (record di un modello, conteggi)</td><td>✅ un modello, campi dichiarati</td><td>—</td><td><a href="./odoo">odoo.md</a></td></tr><tr><td>Zoho CRM (record di un modulo)</td><td>✅ un modulo, campi dichiarati</td><td>—</td><td><a href="./zoho">zoho.md</a></td></tr><tr><td>OAuth2 (identità per IMAP, SMTP e Zoho)</td><td>—</td><td>—</td><td><a href="./oauth">oauth.md</a></td></tr><tr><td>Processo esterno (un programma sulla macchina del worker)</td><td>—</td><td>— (action: <code>processoEsternoAction</code>)</td><td><a href="./process">process.md</a></td></tr></tbody></table><p>Noeva offre anche un nodo <code>action</code> (<code>noevaUploadAction</code>: upload con elaborazione AI, <code>fileId</code> in uscita), due resolver di <code>lookup</code> non SQL (<code>noevaElaborazioneLookup</code>, <code>noevaContenutoLookup</code>) e l&#39;estrazione AI <code>noevaAiExtract</code>, la configurazione completa di un nodo <code>ai</code> che estrae campi validati con Zod: vedi <a href="./noeva#elaborazione-ai-upload-stato-testo">noeva.md § Elaborazione AI</a>.</p><p>Oltre a Source e Sink, <strong>ogni connettore SQL</strong> fornisce un resolver del nodo <code>lookup</code>, che interroga il DB <strong>in sola lettura</strong> a metà grafo, a batch di chiavi:</p><table tabindex="0"><thead><tr><th>DBMS</th><th>Resolver</th><th>Parametri bindati</th><th>Doc</th></tr></thead><tbody><tr><td>PostgreSQL</td><td><code>postgresLookup</code></td><td><code>$1, $2, …</code></td><td><a href="./postgres#lookup--postgreslookup">postgres.md § Lookup</a></td></tr><tr><td>SQL Server</td><td><code>mssqlLookup</code></td><td><code>@k0, @k1, …</code></td><td><a href="./sqlserver#lookup--mssqllookup">sqlserver.md § Lookup</a></td></tr><tr><td>MySQL, MariaDB</td><td><code>mysqlLookup</code></td><td><code>?, ?, …</code></td><td><a href="./mysql#lookup--mysqllookup">mysql.md § Lookup</a></td></tr></tbody></table><p>Ogni connettore SQL fornisce anche un <strong>task</strong>, per il nodo <code>task</code> del grafo: statement statici in una transazione, senza flusso di record. Serve a svuotare uno staging prima del caricamento e a scambiare le tabelle dopo.</p><table tabindex="0"><thead><tr><th>DBMS</th><th>Task</th><th>Parametri bindati</th><th>Doc</th></tr></thead><tbody><tr><td>PostgreSQL</td><td><code>postgresSqlTask</code></td><td><code>@nome</code> → <code>$1, $2, …</code></td><td><a href="./postgres#task--postgressqltask">postgres.md § Task</a></td></tr><tr><td>SQL Server</td><td><code>mssqlSqlTask</code></td><td><code>@nome</code></td><td><a href="./sqlserver#task--mssqlsqltask">sqlserver.md § Task</a></td></tr><tr><td>MySQL, MariaDB</td><td><code>mysqlSqlTask</code></td><td><code>@nome</code> → <code>?</code></td><td><a href="./mysql#task--mysqlsqltask">mysql.md § Task</a></td></tr></tbody></table><p>La parte comune vive in <code>src/connectors/shared/sql-task.ts</code>. Un task con <code>destructive: true</code> cancella o sostituisce dati: prima di usarlo in produzione leggi il <a href="./../runbooks/sql-task-truncate-swap">runbook</a>.</p><p>Per un&#39;<strong>API REST</strong> c&#39;è <code>httpLookup</code> (<a href="./http">http.md</a>): una richiesta per batch o una <code>GET</code> per chiave, risposta validata con Zod, credenziali dal registry <code>HTTP_INSTANCES</code>. Per <strong>scrivere</strong> sulla stessa API c&#39;è <code>httpAction</code> (<a href="./http#scritture--httpaction">http.md § Scritture</a>), un nodo <code>action</code> che prosegue con l&#39;esito della chiamata.</p><p>Per <strong>leggere Jira Cloud</strong> c&#39;è <code>jiraIssues</code> (<a href="./jira">jira.md</a>, ADR-0100): le issue di una JQL, pagina dopo pagina, con i siti nel registry <code>JIRA_INSTANCES</code> e il trasporto condiviso di <code>http</code>. Ogni campo dichiarato, per id o per nome, è una colonna normalizzata, con il testo ADF convertito da <code>adfInTesto</code> (ADR-0101). Per arricchire record che hanno già una chiave (<code>ABC-42</code>) c&#39;è <code>jiraIssueLookup</code>, un nodo <code>lookup</code> con le issue nella stessa forma; changelog, commenti e worklog completi di una issue arrivano come lista con <code>jiraChangelogLookup</code>, <code>jiraCommentsLookup</code> e <code>jiraWorklogsLookup</code> (<a href="./jira#le-liste-di-una-issue--changelog-commenti-e-worklog">jira.md § Le liste</a>). Per <strong>scriverci</strong> ci sono i nodi <code>action</code> <code>jiraCreateIssue</code>, <code>jiraUpdateIssue</code>, <code>jiraTransition</code>, che porta una issue in uno stato per nome, <code>jiraUpsertIssue</code>, che crea o aggiorna per ID esterno, <code>jiraAddComment</code> e <code>jiraAddWorklog</code>, che aggiungono commenti e worklog senza doppioni con una chiave di deduplica, e <code>jiraLinkIssues</code>, che collega due issue senza duplicare il link (<a href="./jira#scritture">jira.md § Scritture</a>, ADR-0102), con il testo in markdown convertito in ADF da <code>marklassian</code>.</p><p>Per <strong>leggere Zoho CRM</strong> c&#39;è <code>zohoCrmRecords</code> (<a href="./zoho">zoho.md</a>, ADR-0106): i record di un modulo con i soli campi dichiarati, che sono anche la regola di privacy, in ordine di <code>id</code>: con la Records API fino a 100.000 record, con la Query API (COQL) a chiavi crescenti di <code>id</code> oltre. Le organizzazioni stanno nel registry <code>ZOHO_INSTANCES</code>, il token lo rinnova un&#39;identità <a href="./oauth">OAuth2</a> e il trasporto è quello condiviso di <code>http</code>.</p><p>Per <strong>leggere Odoo</strong> c&#39;è <code>odooRecords</code> (<a href="./odoo">odoo.md</a>, ADR-0108): i record di un modello con i soli campi dichiarati, a pagine in ordine di <code>id</code>, dopo un <code>fields_get</code> che rifiuta i campi assenti o non stored; <code>odooConteggi</code> dà i <code>search_count</code> da confrontare con le righe caricate. Solo metodi di lettura, al più una chiamata al secondo per database e mai due in parallelo, come vuole l&#39;Acceptable Use Policy di Odoo. I database stanno nel registry <code>ODOO_INSTANCES</code>; il protocollo è XML-RPC, JSON-2 arriverà con Odoo 19.</p><p>Per <strong>lanciare un programma</strong> su dei file del record, con file e un riepilogo JSON in uscita, c&#39;è <code>processoEsternoAction</code> (<a href="./process">process.md</a>): un nodo <code>action</code> senza shell, con ambiente da allowlist, timeout obbligatorio e una cartella temporanea per record.</p><p>La query è la stessa sui due database — segnaposto <code>@chiavi</code>, stesso controllo di sola lettura, stessa normalizzazione delle chiavi — perché la parte comune vive in <code>src/connectors/shared/sql-lookup.ts</code>. Un nuovo connettore SQL ottiene il lookup aggiungendo solo la sintassi dei parametri e la chiamata al driver.</p><h2 id="regole-comuni" tabindex="-1">Regole comuni <a class="header-anchor" href="#regole-comuni" aria-label="Permalink to &quot;Regole comuni&quot;">​</a></h2><ul><li><strong>DI del client:</strong> il <code>Pool</code>/connessione è iniettato dal chiamante, che ne gestisce il ciclo di vita. Fanno eccezione gli storage remoti di <code>file</code> (S3, SFTP, FTP): prendono la config dell&#39;istanza e aprono e chiudono la sessione da sé (ADR-0103).</li><li><strong>Streaming:</strong> i Source restituiscono <code>AsyncIterable</code>, mai array interi.</li><li><strong>Idempotenza:</strong> i Sink usano upsert/merge/swap sulla chiave naturale.</li><li><strong>Segreti:</strong> solo in <code>.env</code> (vedi <code>.env.example</code>), mai nel codice/log.</li><li><strong>Descriptor UI:</strong> ogni Source/Sink espone un <code>descriptor</code> non sensibile (tipo + puntamenti) per la visualizzazione del nodo nel DAG — whitelist esplicita, mai segreti. Contratto e how-to: <a href="./../conventions/node-descriptor">../conventions/node-descriptor.md</a>.</li><li><strong>Errori:</strong> <code>ExtractError</code>/<code>LoadError</code>/<code>TaskError</code>/<code>ConfigError</code> da <code>src/core/errors.ts</code>. <code>ConfigError.mancanti</code> elenca in forma strutturata tutte le variabili mancanti.</li><li><strong>Variabili d&#39;ambiente:</strong> i prefissi base delle istanze sono costanti di <code>src/connectors/shared/prefissi.ts</code> (<code>PREFISSO_PG</code>, <code>PREFISSO_MSSQL</code>, <code>PREFISSO_IMAP</code>…), e il prefisso di un&#39;istanza si ricava con <code>instanceEnvPrefix</code>. Le variabili di un connettore si dichiarano in un manifest e si risolvono con <code>risolviVariabili</code>, che dà per ognuna nome e origine. Gli stessi manifest, con <code>ambienteDellaPipeline</code>, dicono a <code>etl env check</code> quali variabili legge una pipeline. Oggi lo usano i loader di IMAP, SMTP, HTTP, Jira, OAuth2, del client Noeva, Postgres, SQL Server, MySQL, SendGrid e degli storage S3, SFTP e FTP (<code>MANIFEST_IMAP</code>, <code>MANIFEST_SMTP</code>, <code>MANIFEST_HTTP</code>, <code>MANIFEST_JIRA</code>, <code>MANIFEST_OAUTH</code>, <code>MANIFEST_NOEVA</code>, <code>MANIFEST_PG</code>, <code>MANIFEST_MSSQL</code>, <code>MANIFEST_MYSQL</code>, <code>MANIFEST_SENDGRID</code>, <code>MANIFEST_S3</code>, <code>MANIFEST_SFTP</code>, <code>MANIFEST_FTP</code>); gli altri connettori migrano un tipo alla volta. La cartella locale non ha un loader suo: la indica la pipeline, che la dichiara nel proprio manifest. Vedi <a href="./../conventions/node-descriptor#variabile-e-origine-dal-manifest-mai-a-mano">node-descriptor.md</a>.</li><li><strong>Test:</strong> logica pura in unit (CI); I/O reale in <code>tests/integration/</code> (<code>pnpm run test:integration</code>).</li></ul></div></div></main><footer class="VPDocFooter" data-v-4f20312f data-v-0be8676d><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-0be8676d><span class="visually-hidden" id="doc-footer-aria-label" data-v-0be8676d>Pager</span><div class="pager" data-v-0be8676d><a class="VPLink link pager-link prev" href="/guida/core/nodes/union" data-v-0be8676d><!--[--><span class="desc" data-v-0be8676d>Pagina precedente</span><span class="title" data-v-0be8676d>union</span><!--]--></a></div><div class="pager" data-v-0be8676d><a class="VPLink link pager-link next" href="/guida/core/connectors/excel" data-v-0be8676d><!--[--><span class="desc" data-v-0be8676d>Pagina successiva</span><span class="title" data-v-0be8676d>Excel</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-22f0e4eb data-v-331f077b><div class="container" data-v-331f077b><p class="message" data-v-331f077b>Noeva è un marchio registrato di 4D S.R.L.</p><p class="copyright" data-v-331f077b>© 2026 4D S.R.L. · Gruppo4D</p></div></footer><!--[--><span hidden></span><!--]--></div></div>
24
- <script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_excel.md\":\"CqGtwEB4\",\"connectors_file.md\":\"Dbofo9W5\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_mysql.md\":\"fVCxQWUW\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"BeotXAWb\",\"connectors_odoo.md\":\"DprabV5e\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"B5QWzWUK\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"connectors_zoho.md\":\"BfEzRNZk\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"C19dB-Tb\",\"conventions_run-report.md\":\"iVSN9fNV\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"DJPSthZ8\",\"guida_sviluppo.md\":\"Bvr7RKHN\",\"guide_claude-code_index.md\":\"DEnzf9b_\",\"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\":\"DrJFsfOJ\",\"nodes_pipeline.md\":\"DIMlyprm\",\"nodes_readme.md\":\"BNAiSoJJ\",\"nodes_route.md\":\"Bt9qH6OA\",\"nodes_sink.md\":\"C1S-lAh2\",\"nodes_source.md\":\"BitUNtug\",\"nodes_task.md\":\"CejEQZcD\",\"nodes_transform.md\":\"Ciycywnb\",\"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\":\"DrFr4blI\",\"runbooks_deploy-ecr.md\":\"4jQypInn\",\"runbooks_deployment.md\":\"BV8Izw4I\",\"runbooks_etl-worker.md\":\"Bu05cEgT\",\"runbooks_excel-operazioni-distruttive.md\":\"CEygSROg\",\"runbooks_graph-server.md\":\"opGHnuzK\",\"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\":\"DAz41942\",\"runbooks_stato-incrementale.md\":\"hGZ8FlbZ\",\"sub-pipelines_readme.md\":\"CF8gmNPU\",\"sub-pipelines_riepilogo-ordini.md\":\"qCBZJ4nh\",\"technical_overview.md\":\"C6HYc5_h\"}");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\":\"Excel\",\"link\":\"/connectors/excel\"},{\"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\":\"MySQL e MariaDB\",\"link\":\"/connectors/mysql\"},{\"text\":\"Noeva (file dei workspace)\",\"link\":\"/connectors/noeva\"},{\"text\":\"OAuth2 per i connettori\",\"link\":\"/connectors/oauth\"},{\"text\":\"Odoo (record di un modello, con i campi dichiarati)\",\"link\":\"/connectors/odoo\"},{\"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\":\"Zoho CRM (record di un modulo, con i campi dichiarati)\",\"link\":\"/connectors/zoho\"}]},{\"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\":\"un cliente su ECR + ECS\",\"link\":\"/runbooks/deploy-ecr\"},{\"text\":\"distribuzione del runner ETL\",\"link\":\"/runbooks/deployment\"},{\"text\":\"worker etl worker (polling su processes)\",\"link\":\"/runbooks/etl-worker\"},{\"text\":\"operazioni distruttive di excelSink\",\"link\":\"/runbooks/excel-operazioni-distruttive\"},{\"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>
23
+ <div id="app"><div class="Layout" data-v-22f0e4eb><!--[--><!--]--><!--[--><span tabindex="-1" data-v-3426c47a></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-3426c47a>Skip to content</a><!--]--><!----><header class="VPNav" data-v-22f0e4eb data-v-c0562b42><div class="VPNavBar" data-v-c0562b42 data-v-09e46d68><div class="wrapper" data-v-09e46d68><div class="container" data-v-09e46d68><div class="title" data-v-09e46d68><div class="VPNavBarTitle has-sidebar" data-v-09e46d68 data-v-373bba86><a class="title" href="/guida/core/" data-v-373bba86><!--[--><!--]--><!--[--><!--[--><!--[--><img class="VPImage dark logo" src="/guida/core/logo-light.png" alt="Noeva" data-v-b8fe04e5><!--]--><!--[--><img class="VPImage light logo" src="/guida/core/logo-dark.png" alt="Noeva" data-v-b8fe04e5><!--]--><!--]--><!--]--><!----><!--[--><!--[--><!--[--><!--[--><span class="etl-wordmark" aria-hidden="true">ETL</span><span class="etl-embedded-title">Documentazione</span><!--]--><!--]--><!--]--><!--]--></a></div></div><div class="content" data-v-09e46d68><div class="content-body" data-v-09e46d68><!--[--><!--]--><div class="VPNavBarSearch search" data-v-09e46d68><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Cerca nella documentazione"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Cerca</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-09e46d68 data-v-39d75b74><span id="main-nav-aria-label" class="visually-hidden" data-v-39d75b74> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/guida/core/guide/usare/" tabindex="0" data-v-39d75b74 data-v-d4ae6030><!--[--><span data-v-d4ae6030>Usare</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/guida/core/guide/claude-code/" tabindex="0" data-v-39d75b74 data-v-d4ae6030><!--[--><span data-v-d4ae6030>Creare con Claude Code</span><!--]--></a><!--]--><!--[--><div class="VPFlyout VPNavBarMenuGroup active" data-v-39d75b74 data-v-5d303cc7><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-5d303cc7><span class="text" data-v-5d303cc7><!----><span data-v-5d303cc7>Riferimento</span><span class="vpi-chevron-down text-icon" data-v-5d303cc7></span></span></button><div class="menu" data-v-5d303cc7><div class="VPMenu" data-v-5d303cc7 data-v-e79ccfeb><div class="items" data-v-e79ccfeb><!--[--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/guide/grafo" data-v-b2643254><!--[--><span data-v-b2643254>Il grafo, nodo per nodo</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/nodes/README" data-v-b2643254><!--[--><span data-v-b2643254>Tipi di nodo</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link active" href="/guida/core/connectors/README" data-v-b2643254><!--[--><span data-v-b2643254>Connettori</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/pipelines/README" data-v-b2643254><!--[--><span data-v-b2643254>Pipeline pronte</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/conventions/run-report" data-v-b2643254><!--[--><span data-v-b2643254>Il report di run</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/conventions/run-trace" data-v-b2643254><!--[--><span data-v-b2643254>La traccia di una run</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/conventions/variabili-del-core" data-v-b2643254><!--[--><span data-v-b2643254>Variabili d'ambiente del core</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/runbooks/graph-server" data-v-b2643254><!--[--><span data-v-b2643254>Operatività</span><!--]--></a></div><!--]--><!--]--></div><!--[--><!--]--></div></div></div><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-09e46d68 data-v-41033a42><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-41033a42 data-v-16571e93 data-v-3d2b146f><span class="check" data-v-3d2b146f><span class="icon" data-v-3d2b146f><!--[--><span class="vpi-sun sun" data-v-16571e93></span><span class="vpi-moon moon" data-v-16571e93></span><!--]--></span></span></button></div><!----><div class="VPFlyout VPNavBarExtra extra" data-v-09e46d68 data-v-6ab99828 data-v-5d303cc7><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-5d303cc7><span class="vpi-more-horizontal icon" data-v-5d303cc7></span></button><div class="menu" data-v-5d303cc7><div class="VPMenu" data-v-5d303cc7 data-v-e79ccfeb><!----><!--[--><!--[--><!----><div class="group" data-v-6ab99828><div class="item appearance" data-v-6ab99828><p class="label" data-v-6ab99828>Tema</p><div class="appearance-action" data-v-6ab99828><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-6ab99828 data-v-16571e93 data-v-3d2b146f><span class="check" data-v-3d2b146f><span class="icon" data-v-3d2b146f><!--[--><span class="vpi-sun sun" data-v-16571e93></span><span class="vpi-moon moon" data-v-16571e93></span><!--]--></span></span></button></div></div></div><!----><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-09e46d68 data-v-91920283><span class="container" data-v-91920283><span class="top" data-v-91920283></span><span class="middle" data-v-91920283></span><span class="bottom" data-v-91920283></span></span></button></div></div></div></div><div class="divider" data-v-09e46d68><div class="divider-line" data-v-09e46d68></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-22f0e4eb data-v-caa5a72f><div class="container" data-v-caa5a72f><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-caa5a72f><span class="vpi-align-left menu-icon" data-v-caa5a72f></span><span class="menu-text" data-v-caa5a72f>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-caa5a72f data-v-731b3d50><button data-v-731b3d50>Torna su</button><!----></div></div></div><aside class="VPSidebar" data-v-22f0e4eb data-v-ac566ed2><div class="curtain" data-v-ac566ed2></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-ac566ed2><span class="visually-hidden" id="sidebar-aria-label" data-v-ac566ed2> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Usare Noeva ETL</h2><!----></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/usare/" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Come si usa</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/usare/app-desktop" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>L'app desktop</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/usare/esito-di-una-run" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Leggere l'esito di una run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/TECHNICAL_OVERVIEW" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Panoramica di prodotto</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Creare con Claude Code</h2><!----></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/claude-code/" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Dal bisogno al processo</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/claude-code/prompt" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Comporre il prompt</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/claude-code/strumenti" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Skill e subagent</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/GUIDA_SVILUPPO" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Guida allo sviluppo</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Concetti</h2><!----></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/grafo" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Il grafo, nodo per nodo</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/run-report" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Il report di run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/run-trace" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>La traccia di una run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/versioni-di-pipeline" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Versioni di pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/node-descriptor" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Descriptor dei nodi</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/node-columns" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Colonne dei nodi</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/variabili-del-core" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Variabili d'ambiente del core</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Tipi di nodo</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/README" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Cheatsheet</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/action" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>action</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/ai" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>ai</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/join" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>join</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/lookup" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>lookup</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/pipeline" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/route" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>route</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/sink" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>sink</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/source" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>source</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/task" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>task</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/transform" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>transform</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/try-catch" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>try-catch</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/union" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>union</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed has-active" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Connettori</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/README" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Panoramica</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/excel" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Excel</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/file" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>File (storage × codec)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/http" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>HTTP (API REST per i nodi lookup e action)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/imap" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>IMAP (caselle di posta)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/jira" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/mysql" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>MySQL e MariaDB</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/noeva" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Noeva (file dei workspace)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/oauth" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>OAuth2 per i connettori</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/odoo" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Odoo (record di un modello, con i campi dichiarati)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/postgres" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>PostgreSQL</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/process" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>processo esterno</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/sendgrid" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>SendGrid (mail via API REST)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/smtp" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>SMTP (notifiche email)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/sqlserver" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>SQL Server</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/zoho" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Zoho CRM (record di un modulo, con i campi dichiarati)</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Pipeline pronte</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/README" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Le schede di una pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/analytics-snapshot" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>analytics-snapshot</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/test-posta" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>test-posta</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Esempi</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/sub-pipelines/README" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Le schede di una sub-pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/crm-leads-sync" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>crm-leads-sync</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/cross-workspace-csv-merge" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>cross-workspace-csv-merge</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/movimenti-per-conto" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>movimenti-per-conto</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/orders-enriched-daily" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>orders-enriched-daily</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/sub-pipelines/riepilogo-ordini" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>riepilogo-ordini</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Operatività</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/aggiornamento-pm2" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>aggiornare un deploy PM2 di un repo cliente</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/deploy-ecr" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>un cliente su ECR + ECS</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/deployment" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>distribuzione del runner ETL</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/etl-worker" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>worker etl worker (polling su processes)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/excel-operazioni-distruttive" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>operazioni distruttive di excelSink</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/graph-server" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>server grafi etl serve (HTTP)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/mask-key" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>chiavi di mask (creazione, rotazione, compromissione)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/oauth-google-posta" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>OAuth2 per una casella Google (IMAP + SMTP)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/rollback-di-pipeline" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>rollback di una pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/scd2-rehash" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>rehash di una dimensione storicizzata</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/sql-task-truncate-swap" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>task SQL, truncate e scambio di tabelle</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/stato-incrementale" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>stato di pipeline e watermark</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-22f0e4eb data-v-0c4b08a9><div class="VPDoc has-sidebar has-aside" data-v-0c4b08a9 data-v-4f20312f><!--[--><!--]--><div class="container" data-v-4f20312f><div class="aside" data-v-4f20312f><div class="aside-curtain" data-v-4f20312f></div><div class="aside-container" data-v-4f20312f><div class="aside-content" data-v-4f20312f><div class="VPDocAside" data-v-4f20312f data-v-2db35001><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-2db35001 data-v-2f8395af><div class="content" data-v-2f8395af><div class="outline-marker" data-v-2f8395af></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-2f8395af>In questa pagina</div><ul class="VPDocOutlineItem root" data-v-2f8395af data-v-9c3b479d><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-2db35001></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-4f20312f><div class="content-container" data-v-4f20312f><!--[--><!--]--><main class="main" data-v-4f20312f><div style="position:relative;" class="vp-doc _guida_core_connectors_README" data-v-4f20312f><div><h1 id="connettori" tabindex="-1">Connettori <a class="header-anchor" href="#connettori" aria-label="Permalink to &quot;Connettori&quot;">​</a></h1><p>I connettori sono le implementazioni reali di <code>Source</code> (estrazione) e <code>Sink</code> (caricamento) verso sistemi esterni. Vivono in <code>src/connectors/&lt;sistema&gt;/</code> e si <strong>iniettano</strong> nelle pipeline (mai istanziati dentro la definizione).</p><h2 id="indice" tabindex="-1">Indice <a class="header-anchor" href="#indice" aria-label="Permalink to &quot;Indice&quot;">​</a></h2><table tabindex="0"><thead><tr><th>Connettore</th><th>Source</th><th>Sink</th><th>Doc</th></tr></thead><tbody><tr><td>PostgreSQL</td><td>✅ streaming (cursor)</td><td>✅ upsert idempotente (ON CONFLICT), o <a href="./postgres#scd2">SCD2</a></td><td><a href="./postgres">postgres.md</a></td></tr><tr><td>SQL Server</td><td>✅ streaming (pause/resume)</td><td>✅ upsert idempotente (MERGE), o <a href="./sqlserver#scd2">SCD2</a></td><td><a href="./sqlserver">sqlserver.md</a></td></tr><tr><td>MySQL e MariaDB</td><td>✅ streaming (<code>mysql2</code>)</td><td>✅ upsert idempotente (ON DUPLICATE KEY UPDATE)</td><td><a href="./mysql">mysql.md</a></td></tr><tr><td>File (storage × codec)</td><td>✅ <code>fileSource</code></td><td>✅ <code>fileSink</code></td><td><a href="./file">file.md</a></td></tr><tr><td>— storage: filesystem · <strong>S3</strong> · <strong>SFTP</strong> · <strong>FTP/FTPS</strong> · memory</td><td>(vedi file.md)</td><td>(vedi file.md)</td><td><a href="./file">file.md</a></td></tr><tr><td>— codec: <strong>CSV</strong> (anche grezzo) · <strong>JSON/NDJSON</strong> · <strong>XML</strong> · <strong>XLSX</strong> · <strong>Parquet</strong></td><td>(vedi file.md)</td><td>(vedi file.md)</td><td><a href="./file">file.md</a></td></tr><tr><td>Excel (workbook <code>.xlsx</code>/<code>.xlsm</code>)</td><td>✅ uno o più fogli, a flusso, colonne per titolo</td><td>✅ <code>append</code>, <code>upsert</code> per chiave e <code>replace</code> su workbook nuovo o esistente, che conserva grafici, pivot e macro; più <code>excelTask</code> (fogli e colonne)</td><td><a href="./excel">excel.md</a></td></tr><tr><td>Noeva (file dei workspace)</td><td>✅ file singolo · cartella</td><td>✅ file singolo · multi-file, <code>overwrite</code>/<code>new-version</code></td><td><a href="./noeva">noeva.md</a></td></tr><tr><td>IMAP (caselle di posta)</td><td>✅ messaggi di una cartella</td><td>— (action: flag, spostamento)</td><td><a href="./imap">imap.md</a></td></tr><tr><td>SMTP (notifiche email)</td><td>— (action: invio con esito)</td><td>✅ una mail per record, isolabile</td><td><a href="./smtp">smtp.md</a></td></tr><tr><td>SendGrid (mail via API REST; <code>mailAction</code>/<code>mailSink</code> per scegliere il trasporto)</td><td>— (action: invio con esito)</td><td>✅ una mail per record, isolabile</td><td><a href="./sendgrid">sendgrid.md</a></td></tr><tr><td>HTTP (API REST)</td><td>— (lookup: <code>httpLookup</code>)</td><td>— (action: <code>httpAction</code>)</td><td><a href="./http">http.md</a></td></tr><tr><td>Jira Cloud (issue)</td><td>✅ JQL; lookup per chiave e liste</td><td>— (action: <code>jiraCreateIssue</code>, <code>jiraUpdateIssue</code>, <code>jiraTransition</code>, <code>jiraUpsertIssue</code>, <code>jiraAddComment</code>, <code>jiraAddWorklog</code>, <code>jiraLinkIssues</code>)</td><td><a href="./jira">jira.md</a></td></tr><tr><td>Odoo (record di un modello, conteggi)</td><td>✅ un modello, campi dichiarati</td><td>—</td><td><a href="./odoo">odoo.md</a></td></tr><tr><td>Zoho CRM (record di un modulo)</td><td>✅ un modulo, campi dichiarati</td><td>—</td><td><a href="./zoho">zoho.md</a></td></tr><tr><td>OAuth2 (identità per IMAP, SMTP e Zoho)</td><td>—</td><td>—</td><td><a href="./oauth">oauth.md</a></td></tr><tr><td>Processo esterno (un programma sulla macchina del worker)</td><td>—</td><td>— (action: <code>processoEsternoAction</code>)</td><td><a href="./process">process.md</a></td></tr></tbody></table><p>Noeva offre anche un nodo <code>action</code> (<code>noevaUploadAction</code>: upload con elaborazione AI, <code>fileId</code> in uscita), due resolver di <code>lookup</code> non SQL (<code>noevaElaborazioneLookup</code>, <code>noevaContenutoLookup</code>) e l&#39;estrazione AI <code>noevaAiExtract</code>, la configurazione completa di un nodo <code>ai</code> che estrae campi validati con Zod: vedi <a href="./noeva#elaborazione-ai-upload-stato-testo">noeva.md § Elaborazione AI</a>.</p><p>Oltre a Source e Sink, <strong>ogni connettore SQL</strong> fornisce un resolver del nodo <code>lookup</code>, che interroga il DB <strong>in sola lettura</strong> a metà grafo, a batch di chiavi:</p><table tabindex="0"><thead><tr><th>DBMS</th><th>Resolver</th><th>Parametri bindati</th><th>Doc</th></tr></thead><tbody><tr><td>PostgreSQL</td><td><code>postgresLookup</code></td><td><code>$1, $2, …</code></td><td><a href="./postgres#lookup--postgreslookup">postgres.md § Lookup</a></td></tr><tr><td>SQL Server</td><td><code>mssqlLookup</code></td><td><code>@k0, @k1, …</code></td><td><a href="./sqlserver#lookup--mssqllookup">sqlserver.md § Lookup</a></td></tr><tr><td>MySQL, MariaDB</td><td><code>mysqlLookup</code></td><td><code>?, ?, …</code></td><td><a href="./mysql#lookup--mysqllookup">mysql.md § Lookup</a></td></tr></tbody></table><p>Ogni connettore SQL fornisce anche un <strong>task</strong>, per il nodo <code>task</code> del grafo: statement statici in una transazione, senza flusso di record. Serve a svuotare uno staging prima del caricamento e a scambiare le tabelle dopo.</p><table tabindex="0"><thead><tr><th>DBMS</th><th>Task</th><th>Parametri bindati</th><th>Doc</th></tr></thead><tbody><tr><td>PostgreSQL</td><td><code>postgresSqlTask</code></td><td><code>@nome</code> → <code>$1, $2, …</code></td><td><a href="./postgres#task--postgressqltask">postgres.md § Task</a></td></tr><tr><td>SQL Server</td><td><code>mssqlSqlTask</code></td><td><code>@nome</code></td><td><a href="./sqlserver#task--mssqlsqltask">sqlserver.md § Task</a></td></tr><tr><td>MySQL, MariaDB</td><td><code>mysqlSqlTask</code></td><td><code>@nome</code> → <code>?</code></td><td><a href="./mysql#task--mysqlsqltask">mysql.md § Task</a></td></tr></tbody></table><p>La parte comune vive in <code>src/connectors/shared/sql-task.ts</code>. Un task con <code>destructive: true</code> cancella o sostituisce dati: prima di usarlo in produzione leggi il <a href="./../runbooks/sql-task-truncate-swap">runbook</a>.</p><p>Per un&#39;<strong>API REST</strong> c&#39;è <code>httpLookup</code> (<a href="./http">http.md</a>): una richiesta per batch o una <code>GET</code> per chiave, risposta validata con Zod, credenziali dal registry <code>HTTP_INSTANCES</code>. Per <strong>scrivere</strong> sulla stessa API c&#39;è <code>httpAction</code> (<a href="./http#scritture--httpaction">http.md § Scritture</a>), un nodo <code>action</code> che prosegue con l&#39;esito della chiamata.</p><p>Per <strong>leggere Jira Cloud</strong> c&#39;è <code>jiraIssues</code> (<a href="./jira">jira.md</a>, ADR-0100): le issue di una JQL, pagina dopo pagina, con i siti nel registry <code>JIRA_INSTANCES</code> e il trasporto condiviso di <code>http</code>. Ogni campo dichiarato, per id o per nome, è una colonna normalizzata, con il testo ADF convertito da <code>adfInTesto</code> (ADR-0101). Per arricchire record che hanno già una chiave (<code>ABC-42</code>) c&#39;è <code>jiraIssueLookup</code>, un nodo <code>lookup</code> con le issue nella stessa forma; changelog, commenti e worklog completi di una issue arrivano come lista con <code>jiraChangelogLookup</code>, <code>jiraCommentsLookup</code> e <code>jiraWorklogsLookup</code> (<a href="./jira#le-liste-di-una-issue--changelog-commenti-e-worklog">jira.md § Le liste</a>). Per <strong>scriverci</strong> ci sono i nodi <code>action</code> <code>jiraCreateIssue</code>, <code>jiraUpdateIssue</code>, <code>jiraTransition</code>, che porta una issue in uno stato per nome, <code>jiraUpsertIssue</code>, che crea o aggiorna per ID esterno, <code>jiraAddComment</code> e <code>jiraAddWorklog</code>, che aggiungono commenti e worklog senza doppioni con una chiave di deduplica, e <code>jiraLinkIssues</code>, che collega due issue senza duplicare il link (<a href="./jira#scritture">jira.md § Scritture</a>, ADR-0102), con il testo in markdown convertito in ADF da <code>marklassian</code>.</p><p>Per <strong>leggere Zoho CRM</strong> c&#39;è <code>zohoCrmRecords</code> (<a href="./zoho">zoho.md</a>, ADR-0106): i record di un modulo con i soli campi dichiarati, che sono anche la regola di privacy, in ordine di <code>id</code>: con la Records API fino a 100.000 record, con la Query API (COQL) a chiavi crescenti di <code>id</code> oltre. Le organizzazioni stanno nel registry <code>ZOHO_INSTANCES</code>, il token lo rinnova un&#39;identità <a href="./oauth">OAuth2</a> e il trasporto è quello condiviso di <code>http</code>.</p><p>Per <strong>leggere Odoo</strong> c&#39;è <code>odooRecords</code> (<a href="./odoo">odoo.md</a>, ADR-0108): i record di un modello con i soli campi dichiarati, a pagine in ordine di <code>id</code>, dopo un <code>fields_get</code> che rifiuta i campi assenti o non stored; <code>odooConteggi</code> dà i <code>search_count</code> da confrontare con le righe caricate. Solo metodi di lettura, al più una chiamata al secondo per database e mai due in parallelo, come vuole l&#39;Acceptable Use Policy di Odoo. I database stanno nel registry <code>ODOO_INSTANCES</code>; il protocollo è XML-RPC, JSON-2 arriverà con Odoo 19.</p><p>Per <strong>lanciare un programma</strong> su dei file del record, con file e un riepilogo JSON in uscita, c&#39;è <code>processoEsternoAction</code> (<a href="./process">process.md</a>): un nodo <code>action</code> senza shell, con ambiente da allowlist, timeout obbligatorio e una cartella temporanea per record.</p><p>La query è la stessa sui due database — segnaposto <code>@chiavi</code>, stesso controllo di sola lettura, stessa normalizzazione delle chiavi — perché la parte comune vive in <code>src/connectors/shared/sql-lookup.ts</code>. Un nuovo connettore SQL ottiene il lookup aggiungendo solo la sintassi dei parametri e la chiamata al driver.</p><h2 id="regole-comuni" tabindex="-1">Regole comuni <a class="header-anchor" href="#regole-comuni" aria-label="Permalink to &quot;Regole comuni&quot;">​</a></h2><ul><li><strong>DI del client:</strong> il <code>Pool</code>/connessione è iniettato dal chiamante, che ne gestisce il ciclo di vita. Fanno eccezione gli storage remoti di <code>file</code> (S3, SFTP, FTP): prendono la config dell&#39;istanza e aprono e chiudono la sessione da sé (ADR-0103).</li><li><strong>Streaming:</strong> i Source restituiscono <code>AsyncIterable</code>, mai array interi.</li><li><strong>Idempotenza:</strong> i Sink usano upsert/merge/swap sulla chiave naturale.</li><li><strong>Segreti:</strong> solo in <code>.env</code> (vedi <code>.env.example</code>), mai nel codice/log.</li><li><strong>Descriptor UI:</strong> ogni Source/Sink espone un <code>descriptor</code> non sensibile (tipo + puntamenti) per la visualizzazione del nodo nel DAG — whitelist esplicita, mai segreti. Contratto e how-to: <a href="./../conventions/node-descriptor">../conventions/node-descriptor.md</a>.</li><li><strong>Errori:</strong> <code>ExtractError</code>/<code>LoadError</code>/<code>TaskError</code>/<code>ConfigError</code> da <code>src/core/errors.ts</code>. <code>ConfigError.mancanti</code> elenca in forma strutturata tutte le variabili mancanti.</li><li><strong>Variabili d&#39;ambiente:</strong> i prefissi base delle istanze sono costanti di <code>src/connectors/shared/prefissi.ts</code> (<code>PREFISSO_PG</code>, <code>PREFISSO_MSSQL</code>, <code>PREFISSO_IMAP</code>…), e il prefisso di un&#39;istanza si ricava con <code>instanceEnvPrefix</code>. Le variabili di un connettore si dichiarano in un manifest e si risolvono con <code>risolviVariabili</code>, che dà per ognuna nome e origine. Gli stessi manifest, con <code>ambienteDellaPipeline</code>, dicono a <code>etl env check</code> quali variabili legge una pipeline. Oggi lo usano i loader di IMAP, SMTP, HTTP, Jira, OAuth2, del client Noeva, Postgres, SQL Server, MySQL, SendGrid e degli storage S3, SFTP e FTP (<code>MANIFEST_IMAP</code>, <code>MANIFEST_SMTP</code>, <code>MANIFEST_HTTP</code>, <code>MANIFEST_JIRA</code>, <code>MANIFEST_OAUTH</code>, <code>MANIFEST_NOEVA</code>, <code>MANIFEST_PG</code>, <code>MANIFEST_MSSQL</code>, <code>MANIFEST_MYSQL</code>, <code>MANIFEST_SENDGRID</code>, <code>MANIFEST_S3</code>, <code>MANIFEST_SFTP</code>, <code>MANIFEST_FTP</code>); gli altri connettori migrano un tipo alla volta. La cartella locale non ha un loader suo: la indica la pipeline, che la dichiara nel proprio manifest. Vedi <a href="./../conventions/node-descriptor#variabile-e-origine-dal-manifest-mai-a-mano">node-descriptor.md</a>.</li><li><strong>Test:</strong> logica pura in unit (CI); I/O reale in <code>tests/integration/</code> (<code>pnpm run test:integration</code>).</li></ul></div></div></main><footer class="VPDocFooter" data-v-4f20312f data-v-0be8676d><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-0be8676d><span class="visually-hidden" id="doc-footer-aria-label" data-v-0be8676d>Pager</span><div class="pager" data-v-0be8676d><a class="VPLink link pager-link prev" href="/guida/core/nodes/union" data-v-0be8676d><!--[--><span class="desc" data-v-0be8676d>Pagina precedente</span><span class="title" data-v-0be8676d>union</span><!--]--></a></div><div class="pager" data-v-0be8676d><a class="VPLink link pager-link next" href="/guida/core/connectors/excel" data-v-0be8676d><!--[--><span class="desc" data-v-0be8676d>Pagina successiva</span><span class="title" data-v-0be8676d>Excel</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-22f0e4eb data-v-331f077b><div class="container" data-v-331f077b><p class="message" data-v-331f077b>Noeva è un marchio registrato di 4D S.R.L.</p><p class="copyright" data-v-331f077b>© 2026 4D S.R.L. · Gruppo4D</p></div></footer><!--[--><span hidden></span><!--]--></div></div>
24
+ <script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_excel.md\":\"CqGtwEB4\",\"connectors_file.md\":\"Dbofo9W5\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_mysql.md\":\"fVCxQWUW\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"BeotXAWb\",\"connectors_odoo.md\":\"DprabV5e\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"B5QWzWUK\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"connectors_zoho.md\":\"BfEzRNZk\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"C19dB-Tb\",\"conventions_run-report.md\":\"iVSN9fNV\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"DJPSthZ8\",\"guida_sviluppo.md\":\"Bvr7RKHN\",\"guide_claude-code_index.md\":\"DEnzf9b_\",\"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\":\"DrJFsfOJ\",\"nodes_pipeline.md\":\"DIMlyprm\",\"nodes_readme.md\":\"BNAiSoJJ\",\"nodes_route.md\":\"Bt9qH6OA\",\"nodes_sink.md\":\"C1S-lAh2\",\"nodes_source.md\":\"BitUNtug\",\"nodes_task.md\":\"CejEQZcD\",\"nodes_transform.md\":\"Ciycywnb\",\"nodes_try-catch.md\":\"DCYydDPm\",\"nodes_union.md\":\"CznVzHTK\",\"pipelines_analytics-snapshot.md\":\"B8KfsjUs\",\"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\":\"DrFr4blI\",\"runbooks_deploy-ecr.md\":\"4jQypInn\",\"runbooks_deployment.md\":\"BV8Izw4I\",\"runbooks_etl-worker.md\":\"Bu05cEgT\",\"runbooks_excel-operazioni-distruttive.md\":\"CEygSROg\",\"runbooks_graph-server.md\":\"opGHnuzK\",\"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\":\"DAz41942\",\"runbooks_stato-incrementale.md\":\"hGZ8FlbZ\",\"sub-pipelines_readme.md\":\"CF8gmNPU\",\"sub-pipelines_riepilogo-ordini.md\":\"qCBZJ4nh\",\"technical_overview.md\":\"C6HYc5_h\"}");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\":\"Excel\",\"link\":\"/connectors/excel\"},{\"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\":\"MySQL e MariaDB\",\"link\":\"/connectors/mysql\"},{\"text\":\"Noeva (file dei workspace)\",\"link\":\"/connectors/noeva\"},{\"text\":\"OAuth2 per i connettori\",\"link\":\"/connectors/oauth\"},{\"text\":\"Odoo (record di un modello, con i campi dichiarati)\",\"link\":\"/connectors/odoo\"},{\"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\":\"Zoho CRM (record di un modulo, con i campi dichiarati)\",\"link\":\"/connectors/zoho\"}]},{\"text\":\"Pipeline pronte\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una pipeline\",\"link\":\"/pipelines/README\"},{\"text\":\"analytics-snapshot\",\"link\":\"/pipelines/analytics-snapshot\"},{\"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\":\"un cliente su ECR + ECS\",\"link\":\"/runbooks/deploy-ecr\"},{\"text\":\"distribuzione del runner ETL\",\"link\":\"/runbooks/deployment\"},{\"text\":\"worker etl worker (polling su processes)\",\"link\":\"/runbooks/etl-worker\"},{\"text\":\"operazioni distruttive di excelSink\",\"link\":\"/runbooks/excel-operazioni-distruttive\"},{\"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>
25
25
 
26
26
  </body>
27
27
  </html>