@noeva/etl-core 1.0.0-next.5 → 1.0.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.
- package/CHANGELOG.md +183 -0
- package/LICENSE +19 -0
- package/README.md +1 -1
- package/deploy/Dockerfile +1 -1
- package/dist/guida/404.html +3 -3
- package/dist/guida/GUIDA_SVILUPPO.html +6 -6
- package/dist/guida/TECHNICAL_OVERVIEW.html +8 -8
- package/dist/guida/assets/{TECHNICAL_OVERVIEW.md.iD1gDlJY.js → TECHNICAL_OVERVIEW.md.DTIhkkg9.js} +1 -1
- package/dist/guida/assets/{app.BrI3mcoI.js → app.DlsuGVZn.js} +1 -1
- package/dist/guida/assets/chunks/@localSearchIndexroot.LnC621Vy.js +1 -0
- package/dist/guida/assets/chunks/{VPLocalSearchBox.BlKLVNlB.js → VPLocalSearchBox.v4vBLemj.js} +2 -2
- package/dist/guida/assets/chunks/{theme.Cuah39Zj.js → theme.D9XEK7o0.js} +2 -2
- package/dist/guida/assets/{guide_claude-code_index.md.CxVSru8e.js → guide_claude-code_index.md.DEnzf9b_.js} +1 -1
- package/dist/guida/assets/{runbooks_aggiornamento-pm2.md.f3LAxif4.js → runbooks_aggiornamento-pm2.md.DrFr4blI.js} +1 -1
- package/dist/guida/assets/{runbooks_deployment.md.CsIYRa_5.js → runbooks_deployment.md.CwG77qGO.js} +1 -1
- package/dist/guida/assets/{style.BNn_AkzN.css → style.DFlUbYCk.css} +1 -1
- package/dist/guida/connectors/README.html +5 -5
- package/dist/guida/connectors/file.html +6 -6
- package/dist/guida/connectors/http.html +6 -6
- package/dist/guida/connectors/imap.html +6 -6
- package/dist/guida/connectors/jira.html +6 -6
- package/dist/guida/connectors/noeva.html +6 -6
- package/dist/guida/connectors/oauth.html +6 -6
- package/dist/guida/connectors/postgres.html +6 -6
- package/dist/guida/connectors/process.html +6 -6
- package/dist/guida/connectors/sendgrid.html +6 -6
- package/dist/guida/connectors/smtp.html +6 -6
- package/dist/guida/connectors/sqlserver.html +6 -6
- package/dist/guida/connectors/zoho.html +6 -6
- package/dist/guida/conventions/node-columns.html +6 -6
- package/dist/guida/conventions/node-descriptor.html +6 -6
- package/dist/guida/conventions/run-report.html +6 -6
- package/dist/guida/conventions/run-trace.html +6 -6
- package/dist/guida/conventions/variabili-del-core.html +5 -5
- package/dist/guida/conventions/versioni-di-pipeline.html +6 -6
- package/dist/guida/guide/claude-code/index.html +7 -7
- package/dist/guida/guide/claude-code/prompt.html +6 -6
- package/dist/guida/guide/claude-code/strumenti.html +5 -5
- package/dist/guida/guide/grafo.html +6 -6
- package/dist/guida/guide/usare/app-desktop.html +5 -5
- package/dist/guida/guide/usare/esito-di-una-run.html +6 -6
- package/dist/guida/guide/usare/index.html +5 -5
- package/dist/guida/hashmap.json +1 -1
- package/dist/guida/index.html +6 -6
- package/dist/guida/nodes/README.html +6 -6
- package/dist/guida/nodes/action.html +6 -6
- package/dist/guida/nodes/ai.html +6 -6
- package/dist/guida/nodes/join.html +6 -6
- package/dist/guida/nodes/lookup.html +6 -6
- package/dist/guida/nodes/pipeline.html +6 -6
- package/dist/guida/nodes/route.html +6 -6
- package/dist/guida/nodes/sink.html +6 -6
- package/dist/guida/nodes/source.html +6 -6
- package/dist/guida/nodes/task.html +6 -6
- package/dist/guida/nodes/transform.html +6 -6
- package/dist/guida/nodes/try-catch.html +6 -6
- package/dist/guida/nodes/union.html +6 -6
- package/dist/guida/pipelines/README.html +6 -6
- package/dist/guida/pipelines/crm-leads-sync.html +6 -6
- package/dist/guida/pipelines/cross-workspace-csv-merge.html +6 -6
- package/dist/guida/pipelines/movimenti-per-conto.html +6 -6
- package/dist/guida/pipelines/orders-enriched-daily.html +6 -6
- package/dist/guida/pipelines/test-posta.html +6 -6
- package/dist/guida/runbooks/aggiornamento-pm2.html +7 -7
- package/dist/guida/runbooks/deploy-ecr.html +6 -6
- package/dist/guida/runbooks/deployment.html +8 -8
- package/dist/guida/runbooks/etl-worker.html +6 -6
- package/dist/guida/runbooks/graph-server.html +6 -6
- package/dist/guida/runbooks/mask-key.html +6 -6
- package/dist/guida/runbooks/oauth-google-posta.html +6 -6
- package/dist/guida/runbooks/rollback-di-pipeline.html +6 -6
- package/dist/guida/runbooks/scd2-rehash.html +6 -6
- package/dist/guida/runbooks/sql-task-truncate-swap.html +6 -6
- package/dist/guida/runbooks/stato-incrementale.html +6 -6
- package/dist/guida/sub-pipelines/README.html +6 -6
- package/dist/guida/sub-pipelines/riepilogo-ordini.html +6 -6
- package/kit/boilerplate/.github/workflows/ci.yml +1 -1
- package/kit/boilerplate/.github/workflows/image.yml +1 -1
- package/kit/boilerplate/package.json +1 -1
- package/package.json +5 -4
- package/dist/guida/assets/chunks/@localSearchIndexroot.DjrQYH6x.js +0 -1
- /package/dist/guida/assets/{TECHNICAL_OVERVIEW.md.iD1gDlJY.lean.js → TECHNICAL_OVERVIEW.md.DTIhkkg9.lean.js} +0 -0
- /package/dist/guida/assets/{guide_claude-code_index.md.CxVSru8e.lean.js → guide_claude-code_index.md.DEnzf9b_.lean.js} +0 -0
- /package/dist/guida/assets/{runbooks_aggiornamento-pm2.md.f3LAxif4.lean.js → runbooks_aggiornamento-pm2.md.DrFr4blI.lean.js} +0 -0
- /package/dist/guida/assets/{runbooks_deployment.md.CsIYRa_5.lean.js → runbooks_deployment.md.CwG77qGO.lean.js} +0 -0
|
@@ -6,12 +6,12 @@
|
|
|
6
6
|
<title>Pipeline: test-posta · Noeva ETL</title>
|
|
7
7
|
<meta name="description" content="Documentazione di Noeva ETL: come usare la piattaforma e come creare pipeline con Claude Code.">
|
|
8
8
|
<meta name="generator" content="VitePress v1.6.4">
|
|
9
|
-
<link rel="preload stylesheet" href="/guida/core/assets/style.
|
|
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.
|
|
12
|
+
<script type="module" src="/guida/core/assets/app.DlsuGVZn.js"></script>
|
|
13
13
|
<link rel="preload" href="/guida/core/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
|
|
14
|
-
<link rel="modulepreload" href="/guida/core/assets/chunks/theme.
|
|
14
|
+
<link rel="modulepreload" href="/guida/core/assets/chunks/theme.D9XEK7o0.js">
|
|
15
15
|
<link rel="modulepreload" href="/guida/core/assets/chunks/framework.qdetmeNX.js">
|
|
16
16
|
<link rel="modulepreload" href="/guida/core/assets/pipelines_test-posta.md.Cxo_DGBs.lean.js">
|
|
17
17
|
<link rel="icon" type="image/svg+xml" href="/guida/core/favicon.svg">
|
|
@@ -20,7 +20,7 @@
|
|
|
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 etl-wide" data-v-f5dee57d><!--[--><!--]--><!--[--><span tabindex="-1" data-v-93360a68></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-93360a68>Skip to content</a><!--]--><!----><header class="VPNav" data-v-f5dee57d data-v-b9fcca01><div class="VPNavBar" data-v-b9fcca01 data-v-b140bbbf><div class="wrapper" data-v-b140bbbf><div class="container" data-v-b140bbbf><div class="title" data-v-b140bbbf><div class="VPNavBarTitle has-sidebar" data-v-b140bbbf data-v-fa0d91f3><a class="title" href="/guida/core/" data-v-fa0d91f3><!--[--><!--]--><!--[--><!--[--><!--[--><img class="VPImage dark logo" src="/guida/core/logo-light.png" alt="Noeva" data-v-05ca73a1><!--]--><!--[--><img class="VPImage light logo" src="/guida/core/logo-dark.png" alt="Noeva" data-v-05ca73a1><!--]--><!--]--><!--]--><!----><!--[--><!--[--><!--[--><!--[--><span class="etl-wordmark" aria-hidden="true">ETL</span><span class="etl-embedded-title">Documentazione</span><!--]--><!--]--><!--]--><!--]--></a></div></div><div class="content" data-v-b140bbbf><div class="content-body" data-v-b140bbbf><!--[--><!--]--><div class="VPNavBarSearch search" data-v-b140bbbf><!--[--><!----><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-b140bbbf data-v-bc0c15e0><span id="main-nav-aria-label" class="visually-hidden" data-v-bc0c15e0> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/guida/core/guide/usare/" tabindex="0" data-v-bc0c15e0 data-v-5860da0c><!--[--><span data-v-5860da0c>Usare</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/guida/core/guide/claude-code/" tabindex="0" data-v-bc0c15e0 data-v-5860da0c><!--[--><span data-v-5860da0c>Creare con Claude Code</span><!--]--></a><!--]--><!--[--><div class="VPFlyout VPNavBarMenuGroup" data-v-bc0c15e0 data-v-6f404e8a><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-6f404e8a><span class="text" data-v-6f404e8a><!----><span data-v-6f404e8a>Riferimento</span><span class="vpi-chevron-down text-icon" data-v-6f404e8a></span></span></button><div class="menu" data-v-6f404e8a><div class="VPMenu" data-v-6f404e8a data-v-1bb74cb7><div class="items" data-v-1bb74cb7><!--[--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/guide/grafo" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Il grafo, nodo per nodo</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/nodes/README" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Tipi di nodo</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/connectors/README" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Connettori</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/pipelines/README" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Pipeline pronte</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/conventions/run-report" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Il report di run</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/conventions/run-trace" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>La traccia di una run</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/conventions/variabili-del-core" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Variabili d'ambiente del core</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/runbooks/graph-server" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Operatività</span><!--]--></a></div><!--]--><!--]--></div><!--[--><!--]--></div></div></div><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-b140bbbf data-v-978134ec><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-978134ec data-v-139a0758 data-v-6ae48061><span class="check" data-v-6ae48061><span class="icon" data-v-6ae48061><!--[--><span class="vpi-sun sun" data-v-139a0758></span><span class="vpi-moon moon" data-v-139a0758></span><!--]--></span></span></button></div><!----><div class="VPFlyout VPNavBarExtra extra" data-v-b140bbbf data-v-0ddd3b74 data-v-6f404e8a><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-6f404e8a><span class="vpi-more-horizontal icon" data-v-6f404e8a></span></button><div class="menu" data-v-6f404e8a><div class="VPMenu" data-v-6f404e8a data-v-1bb74cb7><!----><!--[--><!--[--><!----><div class="group" data-v-0ddd3b74><div class="item appearance" data-v-0ddd3b74><p class="label" data-v-0ddd3b74>Tema</p><div class="appearance-action" data-v-0ddd3b74><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-0ddd3b74 data-v-139a0758 data-v-6ae48061><span class="check" data-v-6ae48061><span class="icon" data-v-6ae48061><!--[--><span class="vpi-sun sun" data-v-139a0758></span><span class="vpi-moon moon" data-v-139a0758></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-b140bbbf data-v-d8d7505f><span class="container" data-v-d8d7505f><span class="top" data-v-d8d7505f></span><span class="middle" data-v-d8d7505f></span><span class="bottom" data-v-d8d7505f></span></span></button></div></div></div></div><div class="divider" data-v-b140bbbf><div class="divider-line" data-v-b140bbbf></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-f5dee57d data-v-cff79b2d><div class="container" data-v-cff79b2d><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-cff79b2d><span class="vpi-align-left menu-icon" data-v-cff79b2d></span><span class="menu-text" data-v-cff79b2d>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-cff79b2d data-v-64e5faff><button data-v-64e5faff>Torna su</button><!----></div></div></div><aside class="VPSidebar" data-v-f5dee57d data-v-24ac7daa><div class="curtain" data-v-24ac7daa></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-24ac7daa><span class="visually-hidden" id="sidebar-aria-label" data-v-24ac7daa> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Usare Noeva ETL</h2><!----></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/usare/" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Come si usa</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/usare/app-desktop" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>L'app desktop</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/usare/esito-di-una-run" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Leggere l'esito di una run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/TECHNICAL_OVERVIEW" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Panoramica di prodotto</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Creare con Claude Code</h2><!----></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/claude-code/" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Dal bisogno al processo</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/claude-code/prompt" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Comporre il prompt</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/claude-code/strumenti" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Skill e subagent</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/GUIDA_SVILUPPO" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Guida allo sviluppo</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Concetti</h2><!----></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/grafo" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Il grafo, nodo per nodo</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/conventions/run-report" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Il report di run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/conventions/run-trace" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>La traccia di una run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/conventions/versioni-di-pipeline" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Versioni di pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/conventions/node-descriptor" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Descriptor dei nodi</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/conventions/node-columns" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Colonne dei nodi</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/conventions/variabili-del-core" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Variabili d'ambiente del core</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0 collapsible collapsed" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Tipi di nodo</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0fae8093><span class="vpi-chevron-right caret-icon" data-v-0fae8093></span></div></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/README" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Cheatsheet</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/action" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>action</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/ai" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>ai</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/join" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>join</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/lookup" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>lookup</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/pipeline" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/route" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>route</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/sink" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>sink</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/source" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>source</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/task" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>task</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/transform" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>transform</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/try-catch" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>try-catch</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/union" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>union</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0 collapsible collapsed" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Connettori</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0fae8093><span class="vpi-chevron-right caret-icon" data-v-0fae8093></span></div></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/README" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Panoramica</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/file" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>File (storage × codec)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/http" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>HTTP (API REST per i nodi lookup e action)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/imap" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>IMAP (caselle di posta)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/jira" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>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-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/noeva" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Noeva (file dei workspace)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/oauth" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>OAuth2 per i connettori</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/postgres" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>PostgreSQL</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/process" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>processo esterno</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/sendgrid" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>SendGrid (mail via API REST)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/smtp" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>SMTP (notifiche email)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/sqlserver" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>SQL Server</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/zoho" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Zoho CRM (record di un modulo, con i campi dichiarati)</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0 collapsible collapsed has-active" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Pipeline pronte</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0fae8093><span class="vpi-chevron-right caret-icon" data-v-0fae8093></span></div></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/pipelines/README" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Le schede di una pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/pipelines/test-posta" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>test-posta</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0 collapsible collapsed" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Esempi</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0fae8093><span class="vpi-chevron-right caret-icon" data-v-0fae8093></span></div></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/sub-pipelines/README" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Le schede di una sub-pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/pipelines/crm-leads-sync" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>crm-leads-sync</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/pipelines/cross-workspace-csv-merge" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>cross-workspace-csv-merge</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/pipelines/movimenti-per-conto" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>movimenti-per-conto</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/pipelines/orders-enriched-daily" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>orders-enriched-daily</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/sub-pipelines/riepilogo-ordini" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>riepilogo-ordini</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0 collapsible collapsed" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Operatività</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0fae8093><span class="vpi-chevron-right caret-icon" data-v-0fae8093></span></div></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/aggiornamento-pm2" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>aggiornare un deploy PM2 di un repo cliente</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/deploy-ecr" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>un cliente su ECR + ECS</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/deployment" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>distribuzione del runner ETL</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/etl-worker" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>worker etl worker (polling su processes)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/graph-server" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>server grafi etl serve (HTTP)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/mask-key" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>chiavi di mask (creazione, rotazione, compromissione)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/oauth-google-posta" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>OAuth2 per una casella Google (IMAP + SMTP)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/rollback-di-pipeline" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>rollback di una pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/scd2-rehash" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>rehash di una dimensione storicizzata</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/sql-task-truncate-swap" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>task SQL, truncate e scambio di tabelle</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/stato-incrementale" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>stato di pipeline e watermark</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-f5dee57d data-v-b2578848><div class="VPDoc has-sidebar has-aside" data-v-b2578848 data-v-303c7d43><!--[--><!--]--><div class="container" data-v-303c7d43><div class="aside" data-v-303c7d43><div class="aside-curtain" data-v-303c7d43></div><div class="aside-container" data-v-303c7d43><div class="aside-content" data-v-303c7d43><div class="VPDocAside" data-v-303c7d43 data-v-50c80a94><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-50c80a94 data-v-ba0e722b><div class="content" data-v-ba0e722b><div class="outline-marker" data-v-ba0e722b></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-ba0e722b>In questa pagina</div><ul class="VPDocOutlineItem root" data-v-ba0e722b data-v-d9a98cc8><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-50c80a94></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-303c7d43><div class="content-container" data-v-303c7d43><!--[--><!--]--><main class="main" data-v-303c7d43><div style="position:relative;" class="vp-doc _guida_core_pipelines_test-posta" data-v-303c7d43><div><h1 id="pipeline-test-posta" tabindex="-1">Pipeline: test-posta <a class="header-anchor" href="#pipeline-test-posta" aria-label="Permalink to "Pipeline: test-posta""></a></h1><ul><li><strong>Scopo:</strong> provare i connettori IMAP e SMTP di un'installazione, da soli, prima di dare la colpa alla pipeline vera</li><li><strong>Ambito:</strong> core — non appartiene a un cliente: si usa su qualunque installazione che legga o mandi posta · <strong>Owner:</strong> Simone</li><li><strong>Cadenza:</strong> nessuna. Si lancia a mano, quando serve</li><li><strong>Tetto:</strong> 5 messaggi per run</li><li><strong>Runbook:</strong> nessuno. La sezione <a href="#come-si-lancia">Come si lancia</a> esaurisce la procedura: un comando, nessun ripristino da orchestrare, nessun effetto da annullare</li></ul><p>Non fa nulla di utile al cliente, ed è il punto. Una pipeline di posta vera usa spesso IMAP e SMTP insieme a un modello, al gestionale e all'upload su Noeva: quando non parte, i sospetti sono troppi. Questa pipeline ne isola due. Se la mail di riepilogo arriva, host, porte, TLS e credenziali di posta sono a posto e il problema è altrove.</p><h2 id="flusso-dati" tabindex="-1">Flusso dati <a class="header-anchor" href="#flusso-dati" aria-label="Permalink to "Flusso dati""></a></h2><div class="level-nav" data-v-5318f34a data-v-c981a055><!----><!----><!----><figure class="graph-demo etl-panel" tabindex="0" aria-label="Grafo della pipeline test-posta: ← e → per andare avanti e indietro di un passo, spazio per play e pausa" data-v-c981a055 data-v-fc9b2f46><div class="graph-demo__toolbar" role="group" aria-label="Scene di Grafo della pipeline test-posta" data-v-fc9b2f46><!--[--><button type="button" class="etl-button graph-demo__scene" aria-pressed="false" data-v-fc9b2f46>Fai passare un record</button><!--]--><span class="graph-demo__spacer" data-v-fc9b2f46></span><div class="graph-demo__controls" role="group" aria-label="Riproduzione" data-v-fc9b2f46><button type="button" class="etl-button graph-demo__control" aria-label="Passo precedente" title="Passo precedente (←)" disabled data-v-fc9b2f46><svg viewBox="0 0 16 16" aria-hidden="true" data-v-fc9b2f46><rect x="3" y="3" width="2" height="10" rx="1" data-v-fc9b2f46></rect><path d="M13 3v10L6 8z" data-v-fc9b2f46></path></svg></button><button type="button" class="etl-button graph-demo__control" aria-label="Riproduci da solo" title="Riproduci da solo (spazio)" data-v-fc9b2f46><svg viewBox="0 0 16 16" aria-hidden="true" data-v-fc9b2f46><path d="M4.5 2.8v10.4L13 8z" data-v-fc9b2f46></path></svg></button><button type="button" class="etl-button graph-demo__control" aria-label="Passo successivo" title="Passo successivo (→)" data-v-fc9b2f46><svg viewBox="0 0 16 16" aria-hidden="true" data-v-fc9b2f46><path d="M3 3v10l7-5z" data-v-fc9b2f46></path><rect x="11" y="3" width="2" height="10" rx="1" data-v-fc9b2f46></rect></svg></button><span class="graph-demo__counter" aria-live="off" data-v-fc9b2f46>0/3</span></div></div><div class="graph-demo__stage etl-dotgrid" data-v-fc9b2f46><svg class="graph-demo__canvas" style="min-width:683px;" viewBox="0 0 948 98" role="img" aria-label="Grafo della pipeline test-posta" data-v-fc9b2f46><defs data-v-fc9b2f46><marker id="graph-demo-1-arrow" viewBox="0 0 8 8" refX="7" refY="4" markerWidth="7" markerHeight="7" orient="auto" data-v-fc9b2f46><path d="M0 0 L8 4 L0 8 z" class="graph-demo__arrow" data-v-fc9b2f46></path></marker></defs><!--[--><path data-edge="posta->salva-eml" d="M 206 49 C 229.6 49, 234.4 49, 258 49" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="salva-eml->riepilogo" d="M 448 49 C 471.6 49, 476.4 49, 500 49" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="riepilogo->notifica" d="M 690 49 C 713.6 49, 718.4 49, 742 49" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><!--]--><!--[--><!--]--><!--[--><g class="dag-node kind-source" data-v-fc9b2f46 data-v-340130bc><title data-v-340130bc>
|
|
23
|
+
<div id="app"><div class="Layout etl-wide" 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" 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" 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" 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/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/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/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 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>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/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_pipelines_test-posta" data-v-4f20312f><div><h1 id="pipeline-test-posta" tabindex="-1">Pipeline: test-posta <a class="header-anchor" href="#pipeline-test-posta" aria-label="Permalink to "Pipeline: test-posta""></a></h1><ul><li><strong>Scopo:</strong> provare i connettori IMAP e SMTP di un'installazione, da soli, prima di dare la colpa alla pipeline vera</li><li><strong>Ambito:</strong> core — non appartiene a un cliente: si usa su qualunque installazione che legga o mandi posta · <strong>Owner:</strong> Simone</li><li><strong>Cadenza:</strong> nessuna. Si lancia a mano, quando serve</li><li><strong>Tetto:</strong> 5 messaggi per run</li><li><strong>Runbook:</strong> nessuno. La sezione <a href="#come-si-lancia">Come si lancia</a> esaurisce la procedura: un comando, nessun ripristino da orchestrare, nessun effetto da annullare</li></ul><p>Non fa nulla di utile al cliente, ed è il punto. Una pipeline di posta vera usa spesso IMAP e SMTP insieme a un modello, al gestionale e all'upload su Noeva: quando non parte, i sospetti sono troppi. Questa pipeline ne isola due. Se la mail di riepilogo arriva, host, porte, TLS e credenziali di posta sono a posto e il problema è altrove.</p><h2 id="flusso-dati" tabindex="-1">Flusso dati <a class="header-anchor" href="#flusso-dati" aria-label="Permalink to "Flusso dati""></a></h2><div class="level-nav" data-v-5318f34a data-v-c981a055><!----><!----><!----><figure class="graph-demo etl-panel" tabindex="0" aria-label="Grafo della pipeline test-posta: ← e → per andare avanti e indietro di un passo, spazio per play e pausa" data-v-c981a055 data-v-fc9b2f46><div class="graph-demo__toolbar" role="group" aria-label="Scene di Grafo della pipeline test-posta" data-v-fc9b2f46><!--[--><button type="button" class="etl-button graph-demo__scene" aria-pressed="false" data-v-fc9b2f46>Fai passare un record</button><!--]--><span class="graph-demo__spacer" data-v-fc9b2f46></span><div class="graph-demo__controls" role="group" aria-label="Riproduzione" data-v-fc9b2f46><button type="button" class="etl-button graph-demo__control" aria-label="Passo precedente" title="Passo precedente (←)" disabled data-v-fc9b2f46><svg viewBox="0 0 16 16" aria-hidden="true" data-v-fc9b2f46><rect x="3" y="3" width="2" height="10" rx="1" data-v-fc9b2f46></rect><path d="M13 3v10L6 8z" data-v-fc9b2f46></path></svg></button><button type="button" class="etl-button graph-demo__control" aria-label="Riproduci da solo" title="Riproduci da solo (spazio)" data-v-fc9b2f46><svg viewBox="0 0 16 16" aria-hidden="true" data-v-fc9b2f46><path d="M4.5 2.8v10.4L13 8z" data-v-fc9b2f46></path></svg></button><button type="button" class="etl-button graph-demo__control" aria-label="Passo successivo" title="Passo successivo (→)" data-v-fc9b2f46><svg viewBox="0 0 16 16" aria-hidden="true" data-v-fc9b2f46><path d="M3 3v10l7-5z" data-v-fc9b2f46></path><rect x="11" y="3" width="2" height="10" rx="1" data-v-fc9b2f46></rect></svg></button><span class="graph-demo__counter" aria-live="off" data-v-fc9b2f46>0/3</span></div></div><div class="graph-demo__stage etl-dotgrid" data-v-fc9b2f46><svg class="graph-demo__canvas" style="min-width:683px;" viewBox="0 0 948 98" role="img" aria-label="Grafo della pipeline test-posta" data-v-fc9b2f46><defs data-v-fc9b2f46><marker id="graph-demo-1-arrow" viewBox="0 0 8 8" refX="7" refY="4" markerWidth="7" markerHeight="7" orient="auto" data-v-fc9b2f46><path d="M0 0 L8 4 L0 8 z" class="graph-demo__arrow" data-v-fc9b2f46></path></marker></defs><!--[--><path data-edge="posta->salva-eml" d="M 206 49 C 229.6 49, 234.4 49, 258 49" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="salva-eml->riepilogo" d="M 448 49 C 471.6 49, 476.4 49, 500 49" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="riepilogo->notifica" d="M 690 49 C 713.6 49, 718.4 49, 742 49" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><!--]--><!--[--><!--]--><!--[--><g class="dag-node kind-source" data-v-fc9b2f46 data-v-340130bc><title data-v-340130bc>
|
|
24
24
|
casella-prova — source
|
|
25
25
|
imap
|
|
26
26
|
host: imap.esempio
|
|
@@ -39,8 +39,8 @@ smtp
|
|
|
39
39
|
host: smtp.esempio
|
|
40
40
|
porta: 587
|
|
41
41
|
mittente: noeva@esempio
|
|
42
|
-
</title><rect class="dag-node__halo" x="738" y="12" width="198" height="74" rx="12" data-v-340130bc></rect><!----><rect class="dag-node__card" x="742" y="16" width="190" height="66" rx="9" data-v-340130bc></rect><rect class="dag-node__accent" x="742" y="22" width="3" height="54" rx="1.5" data-v-340130bc></rect><text class="dag-node__label" x="754" y="35" data-v-340130bc>notifica</text><text class="dag-node__kind" x="922" y="35" text-anchor="end" data-v-340130bc>sink</text><!--[--><text class="dag-node__sub" x="754" y="51" data-v-340130bc>smtp</text><text class="is-detail dag-node__sub" x="754" y="64" data-v-340130bc>host: smtp.esempio</text><!--]--><!--[--><!--]--></g><!--]--><!--[--><!--]--></svg><!--[--><!--]--><!----></div><!----><figcaption class="graph-demo__footer" data-v-fc9b2f46><span class="graph-demo__progress" aria-hidden="true" data-v-fc9b2f46><span style="width:0%;" data-v-fc9b2f46></span></span><span class="graph-demo__caption" aria-live="polite" data-v-fc9b2f46><!--[--> Scegli una scena e premi ▶ per guardarla scorrere, oppure → per andare avanti un passo alla volta. <!--]--></span></figcaption></figure><figure class="level-nav__purposes" data-v-c981a055><figcaption id="level-nav-purposes-v-0" class="level-nav__purposes-title" data-v-c981a055> Lo scopo dei nodi </figcaption><table aria-labelledby="level-nav-purposes-v-0" data-v-c981a055><thead data-v-c981a055><tr data-v-c981a055><th scope="col" data-v-c981a055>Nodo</th><th scope="col" data-v-c981a055>Tipo</th><th scope="col" data-v-c981a055>Scopo</th></tr></thead><tbody data-v-c981a055><!--[--><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>casella-prova</code></td><td data-v-c981a055><code data-v-c981a055>source</code></td><td data-v-c981a055>Legge alcune mail dalla cartella di posta configurata, senza segnarle come lette né spostarle. Se questo passo riesce, l'accesso alla casella funziona.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>salva-eml</code></td><td data-v-c981a055><code data-v-c981a055>action</code></td><td data-v-c981a055>Salva una copia di ogni mail letta nella cartella locale dell'installazione, per controllare che cosa è arrivato. Rilanciando la prova, le stesse mail riscrivono gli stessi file.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>riepilogo</code></td><td data-v-c981a055><code data-v-c981a055>transform</code></td><td data-v-c981a055>Riunisce le mail salvate in un unico riepilogo, con quante sono e quanto pesano. Serve perché la prova mandi una mail sola invece di una per messaggio.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>notifica</code></td><td data-v-c981a055><code data-v-c981a055>sink</code></td><td data-v-c981a055>Manda l'unica mail di riepilogo della prova. Se arriva, l'invio della posta da questa installazione funziona.</td></tr><!--]--></tbody></table></figure></div><p>Lo scopo di ogni nodo è nella tabella sotto il grafo, presa dal piano. Qui il dettaglio tecnico che lo scopo non dice:</p><table tabindex="0"><thead><tr><th>Nodo</th><th>Tipo</th><th>Dettaglio tecnico</th></tr></thead><tbody><tr><td><code>posta</code></td><td><code>source</code></td><td>IMAP, cartella configurata, al più <code>MAX_MESSAGES</code> mail</td></tr><tr><td><code>salva-eml</code></td><td><code>action</code></td><td>File <code><uid a 8 cifre>-<oggetto ripulito>.eml</code>, vedi <a href="#idempotenza">Idempotenza</a></td></tr><tr><td><code>riepilogo</code></td><td><code>transform</code></td><td><code>groupBy</code> su chiave costante: N messaggi → un record</td></tr><tr><td><code>notifica</code></td><td><code>sink</code></td><td>SMTP</td></tr></tbody></table><p>La chiave del <code>groupBy</code> di <code>riepilogo</code> è costante proprio perché il gruppo dev'essere uno solo.</p><h2 id="che-cosa-non-fa" tabindex="-1">Che cosa <strong>non</strong> fa <a class="header-anchor" href="#che-cosa-non-fa" aria-label="Permalink to "Che cosa **non** fa""></a></h2><p><strong>Non tocca la casella.</strong> Niente <code>\Seen</code>, niente keyword, niente spostamenti: dopo la run la cartella è esattamente com'era. È ciò che la rende rilanciabile quante volte serve mentre si sistema una configurazione — al contrario di una pipeline che usa la cartella come coda, dove lo spostamento in <code>Done</code> è il commit e una mail si lavora una volta sola.</p><p><strong>Non salva gli allegati.</strong> Sono dentro l'<code>.eml</code>, che è il messaggio RFC 822 integro; il riepilogo ne dichiara il numero per messaggio. Se serve verificarne i byte su disco, si apre l'<code>.eml</code>.</p><p><strong>Non elenca più di 50 messaggi nella mail.</strong> Oltre quella soglia il corpo tronca e lo dichiara («… e altri N messaggi»). Col tetto di default — 5 — non succede mai; succede se alzi <code>TEST_POSTA_MAX_MESSAGES</code>.</p><p><strong>Non ha dead-letter, e non è una dimenticanza.</strong> Un errore ferma la run e arriva intero nel report. In una pipeline di produzione mettere da parte il record rotto è giusto; qui il record rotto <strong>è</strong> il risultato dell'esperimento, e archiviarlo farebbe passare per riuscita una prova che non lo è. Un messaggio che IMAP non riesce a scaricare (<code>eml</code> nullo) alza <code>ExtractError</code> e nessuna mail parziale parte.</p><h2 id="idempotenza" tabindex="-1">Idempotenza <a class="header-anchor" href="#idempotenza" aria-label="Permalink to "Idempotenza""></a></h2><p>Il nome del file è <code><uid a 8 cifre>-<oggetto ripulito>.eml</code>. Due run sulla stessa casella riscrivono gli stessi file, non ne accumulano copie. Lo zero padding serve alla lettura a occhio: senza, <code>10.eml</code> verrebbe prima di <code>9.eml</code>.</p><p>L'oggetto che entra nel nome perde tutto ciò che non è lettera, cifra o trattino basso — punti e separatori di percorso compresi. Un oggetto costruito apposta (<code>../../etc/passwd</code>) non può quindi far uscire il file dalla cartella di destinazione.</p><h2 id="casella-vuota" tabindex="-1">Casella vuota <a class="header-anchor" href="#casella-vuota" aria-label="Permalink to "Casella vuota""></a></h2><p>Nessun messaggio letto significa nessuna mail inviata: il <code>groupBy</code> non ha gruppi da emettere. <strong>La run resta un successo</strong>, e che la casella fosse vuota si legge dal report (<code>extracted: 0</code>), non dall'assenza della mail. Vale la pena saperlo prima di concludere che SMTP non funziona.</p><p>È il limite di questa prova, e va conosciuto: su casella vuota dimostra metà della tesi — che IMAP si collega e non trova nulla — e di SMTP non dice niente. Per provare anche l'invio serve almeno un messaggio nella cartella.</p><h2 id="configurazione" tabindex="-1">Configurazione <a class="header-anchor" href="#configurazione" aria-label="Permalink to "Configurazione""></a></h2><p>Tutte le variabili stanno in <code>.env</code>, nessun indirizzo e nessun percorso è nel codice. I valori fittizi sono in <code>.env.example</code>.</p><table tabindex="0"><thead><tr><th>Variabile</th><th>Obbl.</th><th>Default</th><th>Che cos'è</th></tr></thead><tbody><tr><td><code>TEST_POSTA_CARTELLA_LOCALE</code></td><td>sì</td><td>—</td><td>Dove finiscono gli <code>.eml</code></td></tr><tr><td><code>TEST_POSTA_DESTINATARIO</code></td><td>sì</td><td>—</td><td>L'unico destinatario del riepilogo</td></tr><tr><td><code>TEST_POSTA_IMAP_INSTANCE</code></td><td>no</td><td><code>default</code></td><td>Istanza IMAP nel registry</td></tr><tr><td><code>TEST_POSTA_SMTP_INSTANCE</code></td><td>no</td><td><code>default</code></td><td>Istanza SMTP nel registry</td></tr><tr><td><code>TEST_POSTA_CARTELLA</code></td><td>no</td><td><code>INBOX</code></td><td>Cartella IMAP da leggere</td></tr><tr><td><code>TEST_POSTA_MAX_MESSAGES</code></td><td>no</td><td><code>5</code></td><td>Tetto ai messaggi per run</td></tr></tbody></table><p>Host, porte e credenziali vengono dai registry dei connettori (<code>IMAP_*</code>, <code>SMTP_*</code>). <strong>Usa le stesse istanze della pipeline vera</strong>: provare istanze diverse da quelle che userà la pipeline di produzione non prova niente di ciò che interessa.</p><p>Su Gmail, Workspace e Microsoft 365 la password via IMAP e SMTP non esiste più: l'autenticazione passa da OAuth2, e questa pipeline è il modo di verificarla. Vedi il runbook <a href="./../runbooks/oauth-google-posta">oauth-google-posta.md</a>.</p><p>Il mittente non è configurabile qui: è <code>SMTP_FROM</code> dell'istanza, perché un'identità diversa è un'altra istanza.</p><p>Con variabili mancanti la run si ferma prima di toccare la casella, con <strong>un</strong> <code>ConfigError</code> che le elenca tutte insieme, della pipeline e dei connettori: si corregge il <code>.env</code> in un giro solo. Le stesse si vedono prima di lanciarla con <code>pnpm run etl env check</code>: la pipeline dichiara le variabili che legge (<code>environment</code>), compresi l'utente della casella e, se la casella è su OAuth2 senza token, l'identità <code>OAUTH_*</code> che lo rinnova.</p><h3 id="che-cosa-mostra-il-dag" tabindex="-1">Che cosa mostra il DAG <a class="header-anchor" href="#che-cosa-mostra-il-dag" aria-label="Permalink to "Che cosa mostra il DAG""></a></h3><p>Il pannello di ogni nodo dice, per ogni valore, da quale variabile arriva e la sua origine: <code>env</code> (impostata), <code>default</code> (presa dal codice), <code>mancante</code> (obbligatoria e assente), <code>non impostata</code> (facoltativa). Host e porta sono righe distinte, e la credenziale è una riga a parte che dice solo la variante in uso: password, access token o identità OAuth2. Con OAuth2 dice anche se l'identità <code>OAUTH_*</code> che rinnova il token è completa, o quali sue variabili mancano; un <code>IMAP_USER</code> mancante, che non ha una riga sua, lo segnala questa stessa riga.</p><p>Il piano ricade sull'esempio <strong>un'istanza alla volta</strong>. Se manca <code>TEST_POSTA_CARTELLA_LOCALE</code>, solo <code>salva-eml</code> mostra <code>/percorso/di/esempio</code>, con la variabile marcata <code>mancante</code>; la casella IMAP e il server SMTP mostrano i valori veri del <code>.env</code>. Allo stesso modo, un'istanza IMAP rotta non trascina le altre: se <code>TEST_POSTA_IMAP_INSTANCE</code> indica una casella sana, il nodo la mostra anche quando un'altra casella del registry è incompleta. Se una casella non si costruisce per un valore non valido (password e token impostati insieme, una porta non numerica), il suo nodo porta la riga <code>configurazione: non valida</code>, con i nomi delle variabili da controllare.</p><p>A nodo non selezionato, il piano porta la <strong>configurazione della pipeline</strong>: tutte le variabili <code>TEST_POSTA_*</code>, con valore e origine. È l'unico posto in cui compare <code>TEST_POSTA_DESTINATARIO</code>, che non è il dettaglio di nessun nodo. Una variabile <code>mancante</code> non ha valore: qui non c'è un segnaposto d'esempio.</p><p>Il server dei grafi calcola il piano all'avvio: dopo una modifica al <code>.env</code> va riavviato. L'ora di calcolo del piano dice se il riavvio è avvenuto (<a href="./../runbooks/graph-server">runbook del server</a>).</p><p><code>test-posta</code> è una pipeline pronta: un repo cliente la usa dichiarandola nel catalogo del suo <code>etl.config.ts</code>. Se l'installazione limita le pipeline per workspace con <code>ETL_PIPELINE_WORKSPACES</code>, va assegnata anche ai workspace in cui deve girare, altrimenti lì non compare nella UI e il worker rifiuta un processo che la chiede. Da CLI funziona comunque: <code>etl run</code> risolve per nome senza passare dal filtro.</p><h2 id="come-si-lancia" tabindex="-1">Come si lancia <a class="header-anchor" href="#come-si-lancia" aria-label="Permalink to "Come si lancia""></a></h2><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">pnpm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> etl</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> test-posta</span></span></code></pre></div><p>Che cosa guardare, in ordine:</p><ol><li><strong>Il report</strong>: <code>extracted</code> sono le mail lette, <code>written</code> le mail <strong>inviate</strong> (quindi <code>1</code>, non il numero di file scritti), <code>rejected</code> gli scarti. Se <code>extracted</code> è 0 la casella era vuota e il resto non dimostra nulla. I file scritti si contano in <code>nodes[]</code>, alla voce <code>salva-eml</code>.</li><li><strong>La cartella locale</strong>: un <code>.eml</code> per messaggio, apribile con un client di posta.</li><li><strong>La mail</strong>: arriva al destinatario configurato, con mittente, data, numero di allegati e percorso per ciascun messaggio (fino a 50). Se gli accenti si leggono, la codifica ha attraversato IMAP e SMTP intatta. Una riga <code>ATTENZIONE: non interpretabile</code> segnala un messaggio che il parser ha rifiutato: l'<code>.eml</code> è stato comunque salvato, ma i suoi campi nel riepilogo sono vuoti perché non si sono potuti leggere, non perché la mail fosse vuota.</li></ol><h2 id="test" tabindex="-1">Test <a class="header-anchor" href="#test" aria-label="Permalink to "Test""></a></h2><table tabindex="0"><thead><tr><th>File</th><th>Che cosa copre</th></tr></thead><tbody><tr><td><code>config.test.ts</code></td><td>Variabili obbligatorie, default, <code>MAX_MESSAGES</code> non valido, tutte le mancanti in <code>ConfigError.mancanti</code>, configurazione d'esempio del piano</td></tr><tr><td><code>salvataggio.test.ts</code></td><td>Sanificazione dell'oggetto (compreso <code>../../etc/passwd</code>), zero padding, idempotenza per uid, <code>eml</code> nullo, motivo di parsing riportato</td></tr><tr><td><code>notifica.test.ts</code></td><td>Corpo della mail, troncamento a 50 righe, riga di attenzione, assenza di <code>chiave</code></td></tr><tr><td><code>pipeline.test.ts</code></td><td>End-to-end con <code>arraySource</code>/<code>arraySink</code>: N messaggi → <strong>una</strong> mail, casella vuota, messaggio illeggibile che ferma la run, topologia</td></tr><tr><td><code>run.test.ts</code></td><td>Registrazione, ricaduta per istanza (cartella locale mancante, istanza IMAP rotta), variabile e origine per riga, riga <code>credenziale</code>, configurazione della pipeline nel piano, piano deterministico senza <code>.env</code>, run fail-fast con l'elenco completo</td></tr></tbody></table><h2 id="versioni" tabindex="-1">Versioni <a class="header-anchor" href="#versioni" aria-label="Permalink to "Versioni""></a></h2><p>La storia della pipeline, dalla versione più recente: la voce di changelog di ogni versione (<code>src/pipelines/test-posta/changelog.ts</code>) e, sotto, cosa è cambiato nel piano rispetto alla precedente. Vedi <a href="./../conventions/versioni-di-pipeline">versioni di pipeline</a>.</p><div class="pipeline-versions" data-v-cdcb1722><!--[--><article class="pipeline-versions__entry" data-v-cdcb1722><header class="pipeline-versions__header" data-v-cdcb1722><strong class="pipeline-versions__number" data-v-cdcb1722>v3</strong><span class="pipeline-versions__meta" data-v-cdcb1722>2026-10-09 · ETL-193, ETL-194, ETL-195, ETL-202</span><!----></header><!----><!--[--><!--[--><!----><!--]--><!--[--><div class="pipeline-versions__list" data-v-cdcb1722><span class="pipeline-versions__list-title" data-v-cdcb1722>Modifiche</span><ul data-v-cdcb1722><!--[--><li data-v-cdcb1722>Nessun cambio di comportamento: il piano è identico alla v2. Gli import seguono l'infrastruttura (changelog, configurazione delle istanze, report di volume) uscita da `src/pipelines/` (ADR-0093 §1), e la pipeline si dichiara nel catalogo di `etl.config.ts` invece che in un registro (ADR-0093 §2)</li><li data-v-cdcb1722>Porta il marchio di pipeline pronta del core, che il caricamento del catalogo riconosce (ADR-0094 §2): il piano non cambia</li><li data-v-cdcb1722>Dichiara le variabili d'ambiente che legge (`environment`) per `etl env check`, dagli stessi manifest della run: casella IMAP, server SMTP, identità OAuth2 se la casella la usa, e `TEST_POSTA_*` (ADR-0094 §1). Il piano non cambia</li><!--]--></ul></div><!--]--><!--[--><!----><!--]--><!--]--><div class="pipeline-versions__diff" data-v-cdcb1722><p class="pipeline-versions__note" data-v-cdcb1722> Il piano non cambia rispetto alla v2. </p></div></article><article class="pipeline-versions__entry" data-v-cdcb1722><header class="pipeline-versions__header" data-v-cdcb1722><strong class="pipeline-versions__number" data-v-cdcb1722>v2</strong><span class="pipeline-versions__meta" data-v-cdcb1722>2026-10-05 · ETL-150, ETL-152, ETL-154</span><!----></header><!----><!--[--><!--[--><div class="pipeline-versions__list" data-v-cdcb1722><span class="pipeline-versions__list-title" data-v-cdcb1722>Aggiunte</span><ul data-v-cdcb1722><!--[--><li data-v-cdcb1722>Variabile e origine (env, default, mancante, non impostata) su ogni riga dei connettori IMAP, SMTP e della cartella locale (ADR-0089)</li><li data-v-cdcb1722>Riga `credenziale` con la variante in uso e il suo stato, mai il valore</li><li data-v-cdcb1722>Configurazione della pipeline nel piano: tutte le variabili `TEST_POSTA_*` con valore e origine, compreso il destinatario che nessun nodo mostra</li><!--]--></ul></div><!--]--><!--[--><div class="pipeline-versions__list" data-v-cdcb1722><span class="pipeline-versions__list-title" data-v-cdcb1722>Modifiche</span><ul data-v-cdcb1722><!--[--><li data-v-cdcb1722>Il piano ricade sulla configurazione d'esempio per istanza di connettore, non per l'intero piano: una cartella locale mancante non nasconde IMAP e SMTP</li><li data-v-cdcb1722>Host e porta sono righe separate</li><li data-v-cdcb1722>Con un utente IMAP mancante, la riga `credenziale` lo dice; con OAuth2, dice se l'identità che rinnova il token è completa</li><!--]--></ul></div><!--]--><!--[--><!----><!--]--><!--]--><div class="pipeline-versions__diff" data-v-cdcb1722><!--[--><p class="pipeline-versions__note" data-v-cdcb1722> Il piano rispetto alla v1: </p><dl data-v-cdcb1722><!----><!--[--><!--[--><dt data-v-cdcb1722>Nodi <!----></dt><dd data-v-cdcb1722><ul data-v-cdcb1722><!--[--><li class="is-changed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>~</span><code data-v-cdcb1722>posta</code><span data-v-cdcb1722>connettore</span></li><li class="is-changed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>~</span><code data-v-cdcb1722>salva-eml</code><span data-v-cdcb1722>connettore</span></li><li class="is-changed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>~</span><code data-v-cdcb1722>notifica</code><span data-v-cdcb1722>connettore</span></li><!--]--></ul></dd><!--]--><!--]--></dl><!--]--></div></article><article class="pipeline-versions__entry" data-v-cdcb1722><header class="pipeline-versions__header" data-v-cdcb1722><strong class="pipeline-versions__number" data-v-cdcb1722>v1</strong><span class="pipeline-versions__meta" data-v-cdcb1722>2026-10-05 · ETL-120</span><!----></header><!----><!--[--><!--[--><div class="pipeline-versions__list" data-v-cdcb1722><span class="pipeline-versions__list-title" data-v-cdcb1722>Aggiunte</span><ul data-v-cdcb1722><!--[--><li data-v-cdcb1722>Versione iniziale sotto versionamento (ADR-0086)</li><!--]--></ul></div><!--]--><!--[--><!----><!--]--><!--[--><!----><!--]--><!--]--><div class="pipeline-versions__diff" data-v-cdcb1722><p class="pipeline-versions__note" data-v-cdcb1722> Prima versione: non c'è una versione precedente da confrontare. </p></div></article><!--]--></div></div></div></main><footer class="VPDocFooter" data-v-303c7d43 data-v-64d0b887><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-64d0b887><span class="visually-hidden" id="doc-footer-aria-label" data-v-64d0b887>Pager</span><div class="pager" data-v-64d0b887><a class="VPLink link pager-link prev" href="/guida/core/pipelines/README" data-v-64d0b887><!--[--><span class="desc" data-v-64d0b887>Pagina precedente</span><span class="title" data-v-64d0b887>Le schede di una pipeline</span><!--]--></a></div><div class="pager" data-v-64d0b887><a class="VPLink link pager-link next" href="/guida/core/sub-pipelines/README" data-v-64d0b887><!--[--><span class="desc" data-v-64d0b887>Pagina successiva</span><span class="title" data-v-64d0b887>Le schede di una sub-pipeline</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-f5dee57d data-v-e10de3dd><div class="container" data-v-e10de3dd><p class="message" data-v-e10de3dd>Noeva è un marchio registrato di 4D S.R.L.</p><p class="copyright" data-v-e10de3dd>© 2026 4D S.R.L. · Gruppo4D</p></div></footer><!--[--><span hidden></span><!--]--></div></div>
|
|
43
|
-
<script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"BeotXAWb\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"BqI2RLCu\",\"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\":\"MQaGlm8a\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"CrN52ZDN\",\"guide_claude-code_index.md\":\"
|
|
42
|
+
</title><rect class="dag-node__halo" x="738" y="12" width="198" height="74" rx="12" data-v-340130bc></rect><!----><rect class="dag-node__card" x="742" y="16" width="190" height="66" rx="9" data-v-340130bc></rect><rect class="dag-node__accent" x="742" y="22" width="3" height="54" rx="1.5" data-v-340130bc></rect><text class="dag-node__label" x="754" y="35" data-v-340130bc>notifica</text><text class="dag-node__kind" x="922" y="35" text-anchor="end" data-v-340130bc>sink</text><!--[--><text class="dag-node__sub" x="754" y="51" data-v-340130bc>smtp</text><text class="is-detail dag-node__sub" x="754" y="64" data-v-340130bc>host: smtp.esempio</text><!--]--><!--[--><!--]--></g><!--]--><!--[--><!--]--></svg><!--[--><!--]--><!----></div><!----><figcaption class="graph-demo__footer" data-v-fc9b2f46><span class="graph-demo__progress" aria-hidden="true" data-v-fc9b2f46><span style="width:0%;" data-v-fc9b2f46></span></span><span class="graph-demo__caption" aria-live="polite" data-v-fc9b2f46><!--[--> Scegli una scena e premi ▶ per guardarla scorrere, oppure → per andare avanti un passo alla volta. <!--]--></span></figcaption></figure><figure class="level-nav__purposes" data-v-c981a055><figcaption id="level-nav-purposes-v-0" class="level-nav__purposes-title" data-v-c981a055> Lo scopo dei nodi </figcaption><table aria-labelledby="level-nav-purposes-v-0" data-v-c981a055><thead data-v-c981a055><tr data-v-c981a055><th scope="col" data-v-c981a055>Nodo</th><th scope="col" data-v-c981a055>Tipo</th><th scope="col" data-v-c981a055>Scopo</th></tr></thead><tbody data-v-c981a055><!--[--><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>casella-prova</code></td><td data-v-c981a055><code data-v-c981a055>source</code></td><td data-v-c981a055>Legge alcune mail dalla cartella di posta configurata, senza segnarle come lette né spostarle. Se questo passo riesce, l'accesso alla casella funziona.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>salva-eml</code></td><td data-v-c981a055><code data-v-c981a055>action</code></td><td data-v-c981a055>Salva una copia di ogni mail letta nella cartella locale dell'installazione, per controllare che cosa è arrivato. Rilanciando la prova, le stesse mail riscrivono gli stessi file.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>riepilogo</code></td><td data-v-c981a055><code data-v-c981a055>transform</code></td><td data-v-c981a055>Riunisce le mail salvate in un unico riepilogo, con quante sono e quanto pesano. Serve perché la prova mandi una mail sola invece di una per messaggio.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>notifica</code></td><td data-v-c981a055><code data-v-c981a055>sink</code></td><td data-v-c981a055>Manda l'unica mail di riepilogo della prova. Se arriva, l'invio della posta da questa installazione funziona.</td></tr><!--]--></tbody></table></figure></div><p>Lo scopo di ogni nodo è nella tabella sotto il grafo, presa dal piano. Qui il dettaglio tecnico che lo scopo non dice:</p><table tabindex="0"><thead><tr><th>Nodo</th><th>Tipo</th><th>Dettaglio tecnico</th></tr></thead><tbody><tr><td><code>posta</code></td><td><code>source</code></td><td>IMAP, cartella configurata, al più <code>MAX_MESSAGES</code> mail</td></tr><tr><td><code>salva-eml</code></td><td><code>action</code></td><td>File <code><uid a 8 cifre>-<oggetto ripulito>.eml</code>, vedi <a href="#idempotenza">Idempotenza</a></td></tr><tr><td><code>riepilogo</code></td><td><code>transform</code></td><td><code>groupBy</code> su chiave costante: N messaggi → un record</td></tr><tr><td><code>notifica</code></td><td><code>sink</code></td><td>SMTP</td></tr></tbody></table><p>La chiave del <code>groupBy</code> di <code>riepilogo</code> è costante proprio perché il gruppo dev'essere uno solo.</p><h2 id="che-cosa-non-fa" tabindex="-1">Che cosa <strong>non</strong> fa <a class="header-anchor" href="#che-cosa-non-fa" aria-label="Permalink to "Che cosa **non** fa""></a></h2><p><strong>Non tocca la casella.</strong> Niente <code>\Seen</code>, niente keyword, niente spostamenti: dopo la run la cartella è esattamente com'era. È ciò che la rende rilanciabile quante volte serve mentre si sistema una configurazione — al contrario di una pipeline che usa la cartella come coda, dove lo spostamento in <code>Done</code> è il commit e una mail si lavora una volta sola.</p><p><strong>Non salva gli allegati.</strong> Sono dentro l'<code>.eml</code>, che è il messaggio RFC 822 integro; il riepilogo ne dichiara il numero per messaggio. Se serve verificarne i byte su disco, si apre l'<code>.eml</code>.</p><p><strong>Non elenca più di 50 messaggi nella mail.</strong> Oltre quella soglia il corpo tronca e lo dichiara («… e altri N messaggi»). Col tetto di default — 5 — non succede mai; succede se alzi <code>TEST_POSTA_MAX_MESSAGES</code>.</p><p><strong>Non ha dead-letter, e non è una dimenticanza.</strong> Un errore ferma la run e arriva intero nel report. In una pipeline di produzione mettere da parte il record rotto è giusto; qui il record rotto <strong>è</strong> il risultato dell'esperimento, e archiviarlo farebbe passare per riuscita una prova che non lo è. Un messaggio che IMAP non riesce a scaricare (<code>eml</code> nullo) alza <code>ExtractError</code> e nessuna mail parziale parte.</p><h2 id="idempotenza" tabindex="-1">Idempotenza <a class="header-anchor" href="#idempotenza" aria-label="Permalink to "Idempotenza""></a></h2><p>Il nome del file è <code><uid a 8 cifre>-<oggetto ripulito>.eml</code>. Due run sulla stessa casella riscrivono gli stessi file, non ne accumulano copie. Lo zero padding serve alla lettura a occhio: senza, <code>10.eml</code> verrebbe prima di <code>9.eml</code>.</p><p>L'oggetto che entra nel nome perde tutto ciò che non è lettera, cifra o trattino basso — punti e separatori di percorso compresi. Un oggetto costruito apposta (<code>../../etc/passwd</code>) non può quindi far uscire il file dalla cartella di destinazione.</p><h2 id="casella-vuota" tabindex="-1">Casella vuota <a class="header-anchor" href="#casella-vuota" aria-label="Permalink to "Casella vuota""></a></h2><p>Nessun messaggio letto significa nessuna mail inviata: il <code>groupBy</code> non ha gruppi da emettere. <strong>La run resta un successo</strong>, e che la casella fosse vuota si legge dal report (<code>extracted: 0</code>), non dall'assenza della mail. Vale la pena saperlo prima di concludere che SMTP non funziona.</p><p>È il limite di questa prova, e va conosciuto: su casella vuota dimostra metà della tesi — che IMAP si collega e non trova nulla — e di SMTP non dice niente. Per provare anche l'invio serve almeno un messaggio nella cartella.</p><h2 id="configurazione" tabindex="-1">Configurazione <a class="header-anchor" href="#configurazione" aria-label="Permalink to "Configurazione""></a></h2><p>Tutte le variabili stanno in <code>.env</code>, nessun indirizzo e nessun percorso è nel codice. I valori fittizi sono in <code>.env.example</code>.</p><table tabindex="0"><thead><tr><th>Variabile</th><th>Obbl.</th><th>Default</th><th>Che cos'è</th></tr></thead><tbody><tr><td><code>TEST_POSTA_CARTELLA_LOCALE</code></td><td>sì</td><td>—</td><td>Dove finiscono gli <code>.eml</code></td></tr><tr><td><code>TEST_POSTA_DESTINATARIO</code></td><td>sì</td><td>—</td><td>L'unico destinatario del riepilogo</td></tr><tr><td><code>TEST_POSTA_IMAP_INSTANCE</code></td><td>no</td><td><code>default</code></td><td>Istanza IMAP nel registry</td></tr><tr><td><code>TEST_POSTA_SMTP_INSTANCE</code></td><td>no</td><td><code>default</code></td><td>Istanza SMTP nel registry</td></tr><tr><td><code>TEST_POSTA_CARTELLA</code></td><td>no</td><td><code>INBOX</code></td><td>Cartella IMAP da leggere</td></tr><tr><td><code>TEST_POSTA_MAX_MESSAGES</code></td><td>no</td><td><code>5</code></td><td>Tetto ai messaggi per run</td></tr></tbody></table><p>Host, porte e credenziali vengono dai registry dei connettori (<code>IMAP_*</code>, <code>SMTP_*</code>). <strong>Usa le stesse istanze della pipeline vera</strong>: provare istanze diverse da quelle che userà la pipeline di produzione non prova niente di ciò che interessa.</p><p>Su Gmail, Workspace e Microsoft 365 la password via IMAP e SMTP non esiste più: l'autenticazione passa da OAuth2, e questa pipeline è il modo di verificarla. Vedi il runbook <a href="./../runbooks/oauth-google-posta">oauth-google-posta.md</a>.</p><p>Il mittente non è configurabile qui: è <code>SMTP_FROM</code> dell'istanza, perché un'identità diversa è un'altra istanza.</p><p>Con variabili mancanti la run si ferma prima di toccare la casella, con <strong>un</strong> <code>ConfigError</code> che le elenca tutte insieme, della pipeline e dei connettori: si corregge il <code>.env</code> in un giro solo. Le stesse si vedono prima di lanciarla con <code>pnpm run etl env check</code>: la pipeline dichiara le variabili che legge (<code>environment</code>), compresi l'utente della casella e, se la casella è su OAuth2 senza token, l'identità <code>OAUTH_*</code> che lo rinnova.</p><h3 id="che-cosa-mostra-il-dag" tabindex="-1">Che cosa mostra il DAG <a class="header-anchor" href="#che-cosa-mostra-il-dag" aria-label="Permalink to "Che cosa mostra il DAG""></a></h3><p>Il pannello di ogni nodo dice, per ogni valore, da quale variabile arriva e la sua origine: <code>env</code> (impostata), <code>default</code> (presa dal codice), <code>mancante</code> (obbligatoria e assente), <code>non impostata</code> (facoltativa). Host e porta sono righe distinte, e la credenziale è una riga a parte che dice solo la variante in uso: password, access token o identità OAuth2. Con OAuth2 dice anche se l'identità <code>OAUTH_*</code> che rinnova il token è completa, o quali sue variabili mancano; un <code>IMAP_USER</code> mancante, che non ha una riga sua, lo segnala questa stessa riga.</p><p>Il piano ricade sull'esempio <strong>un'istanza alla volta</strong>. Se manca <code>TEST_POSTA_CARTELLA_LOCALE</code>, solo <code>salva-eml</code> mostra <code>/percorso/di/esempio</code>, con la variabile marcata <code>mancante</code>; la casella IMAP e il server SMTP mostrano i valori veri del <code>.env</code>. Allo stesso modo, un'istanza IMAP rotta non trascina le altre: se <code>TEST_POSTA_IMAP_INSTANCE</code> indica una casella sana, il nodo la mostra anche quando un'altra casella del registry è incompleta. Se una casella non si costruisce per un valore non valido (password e token impostati insieme, una porta non numerica), il suo nodo porta la riga <code>configurazione: non valida</code>, con i nomi delle variabili da controllare.</p><p>A nodo non selezionato, il piano porta la <strong>configurazione della pipeline</strong>: tutte le variabili <code>TEST_POSTA_*</code>, con valore e origine. È l'unico posto in cui compare <code>TEST_POSTA_DESTINATARIO</code>, che non è il dettaglio di nessun nodo. Una variabile <code>mancante</code> non ha valore: qui non c'è un segnaposto d'esempio.</p><p>Il server dei grafi calcola il piano all'avvio: dopo una modifica al <code>.env</code> va riavviato. L'ora di calcolo del piano dice se il riavvio è avvenuto (<a href="./../runbooks/graph-server">runbook del server</a>).</p><p><code>test-posta</code> è una pipeline pronta: un repo cliente la usa dichiarandola nel catalogo del suo <code>etl.config.ts</code>. Se l'installazione limita le pipeline per workspace con <code>ETL_PIPELINE_WORKSPACES</code>, va assegnata anche ai workspace in cui deve girare, altrimenti lì non compare nella UI e il worker rifiuta un processo che la chiede. Da CLI funziona comunque: <code>etl run</code> risolve per nome senza passare dal filtro.</p><h2 id="come-si-lancia" tabindex="-1">Come si lancia <a class="header-anchor" href="#come-si-lancia" aria-label="Permalink to "Come si lancia""></a></h2><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">pnpm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> etl</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> test-posta</span></span></code></pre></div><p>Che cosa guardare, in ordine:</p><ol><li><strong>Il report</strong>: <code>extracted</code> sono le mail lette, <code>written</code> le mail <strong>inviate</strong> (quindi <code>1</code>, non il numero di file scritti), <code>rejected</code> gli scarti. Se <code>extracted</code> è 0 la casella era vuota e il resto non dimostra nulla. I file scritti si contano in <code>nodes[]</code>, alla voce <code>salva-eml</code>.</li><li><strong>La cartella locale</strong>: un <code>.eml</code> per messaggio, apribile con un client di posta.</li><li><strong>La mail</strong>: arriva al destinatario configurato, con mittente, data, numero di allegati e percorso per ciascun messaggio (fino a 50). Se gli accenti si leggono, la codifica ha attraversato IMAP e SMTP intatta. Una riga <code>ATTENZIONE: non interpretabile</code> segnala un messaggio che il parser ha rifiutato: l'<code>.eml</code> è stato comunque salvato, ma i suoi campi nel riepilogo sono vuoti perché non si sono potuti leggere, non perché la mail fosse vuota.</li></ol><h2 id="test" tabindex="-1">Test <a class="header-anchor" href="#test" aria-label="Permalink to "Test""></a></h2><table tabindex="0"><thead><tr><th>File</th><th>Che cosa copre</th></tr></thead><tbody><tr><td><code>config.test.ts</code></td><td>Variabili obbligatorie, default, <code>MAX_MESSAGES</code> non valido, tutte le mancanti in <code>ConfigError.mancanti</code>, configurazione d'esempio del piano</td></tr><tr><td><code>salvataggio.test.ts</code></td><td>Sanificazione dell'oggetto (compreso <code>../../etc/passwd</code>), zero padding, idempotenza per uid, <code>eml</code> nullo, motivo di parsing riportato</td></tr><tr><td><code>notifica.test.ts</code></td><td>Corpo della mail, troncamento a 50 righe, riga di attenzione, assenza di <code>chiave</code></td></tr><tr><td><code>pipeline.test.ts</code></td><td>End-to-end con <code>arraySource</code>/<code>arraySink</code>: N messaggi → <strong>una</strong> mail, casella vuota, messaggio illeggibile che ferma la run, topologia</td></tr><tr><td><code>run.test.ts</code></td><td>Registrazione, ricaduta per istanza (cartella locale mancante, istanza IMAP rotta), variabile e origine per riga, riga <code>credenziale</code>, configurazione della pipeline nel piano, piano deterministico senza <code>.env</code>, run fail-fast con l'elenco completo</td></tr></tbody></table><h2 id="versioni" tabindex="-1">Versioni <a class="header-anchor" href="#versioni" aria-label="Permalink to "Versioni""></a></h2><p>La storia della pipeline, dalla versione più recente: la voce di changelog di ogni versione (<code>src/pipelines/test-posta/changelog.ts</code>) e, sotto, cosa è cambiato nel piano rispetto alla precedente. Vedi <a href="./../conventions/versioni-di-pipeline">versioni di pipeline</a>.</p><div class="pipeline-versions" data-v-cdcb1722><!--[--><article class="pipeline-versions__entry" data-v-cdcb1722><header class="pipeline-versions__header" data-v-cdcb1722><strong class="pipeline-versions__number" data-v-cdcb1722>v3</strong><span class="pipeline-versions__meta" data-v-cdcb1722>2026-10-09 · ETL-193, ETL-194, ETL-195, ETL-202</span><!----></header><!----><!--[--><!--[--><!----><!--]--><!--[--><div class="pipeline-versions__list" data-v-cdcb1722><span class="pipeline-versions__list-title" data-v-cdcb1722>Modifiche</span><ul data-v-cdcb1722><!--[--><li data-v-cdcb1722>Nessun cambio di comportamento: il piano è identico alla v2. Gli import seguono l'infrastruttura (changelog, configurazione delle istanze, report di volume) uscita da `src/pipelines/` (ADR-0093 §1), e la pipeline si dichiara nel catalogo di `etl.config.ts` invece che in un registro (ADR-0093 §2)</li><li data-v-cdcb1722>Porta il marchio di pipeline pronta del core, che il caricamento del catalogo riconosce (ADR-0094 §2): il piano non cambia</li><li data-v-cdcb1722>Dichiara le variabili d'ambiente che legge (`environment`) per `etl env check`, dagli stessi manifest della run: casella IMAP, server SMTP, identità OAuth2 se la casella la usa, e `TEST_POSTA_*` (ADR-0094 §1). Il piano non cambia</li><!--]--></ul></div><!--]--><!--[--><!----><!--]--><!--]--><div class="pipeline-versions__diff" data-v-cdcb1722><p class="pipeline-versions__note" data-v-cdcb1722> Il piano non cambia rispetto alla v2. </p></div></article><article class="pipeline-versions__entry" data-v-cdcb1722><header class="pipeline-versions__header" data-v-cdcb1722><strong class="pipeline-versions__number" data-v-cdcb1722>v2</strong><span class="pipeline-versions__meta" data-v-cdcb1722>2026-10-05 · ETL-150, ETL-152, ETL-154</span><!----></header><!----><!--[--><!--[--><div class="pipeline-versions__list" data-v-cdcb1722><span class="pipeline-versions__list-title" data-v-cdcb1722>Aggiunte</span><ul data-v-cdcb1722><!--[--><li data-v-cdcb1722>Variabile e origine (env, default, mancante, non impostata) su ogni riga dei connettori IMAP, SMTP e della cartella locale (ADR-0089)</li><li data-v-cdcb1722>Riga `credenziale` con la variante in uso e il suo stato, mai il valore</li><li data-v-cdcb1722>Configurazione della pipeline nel piano: tutte le variabili `TEST_POSTA_*` con valore e origine, compreso il destinatario che nessun nodo mostra</li><!--]--></ul></div><!--]--><!--[--><div class="pipeline-versions__list" data-v-cdcb1722><span class="pipeline-versions__list-title" data-v-cdcb1722>Modifiche</span><ul data-v-cdcb1722><!--[--><li data-v-cdcb1722>Il piano ricade sulla configurazione d'esempio per istanza di connettore, non per l'intero piano: una cartella locale mancante non nasconde IMAP e SMTP</li><li data-v-cdcb1722>Host e porta sono righe separate</li><li data-v-cdcb1722>Con un utente IMAP mancante, la riga `credenziale` lo dice; con OAuth2, dice se l'identità che rinnova il token è completa</li><!--]--></ul></div><!--]--><!--[--><!----><!--]--><!--]--><div class="pipeline-versions__diff" data-v-cdcb1722><!--[--><p class="pipeline-versions__note" data-v-cdcb1722> Il piano rispetto alla v1: </p><dl data-v-cdcb1722><!----><!--[--><!--[--><dt data-v-cdcb1722>Nodi <!----></dt><dd data-v-cdcb1722><ul data-v-cdcb1722><!--[--><li class="is-changed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>~</span><code data-v-cdcb1722>posta</code><span data-v-cdcb1722>connettore</span></li><li class="is-changed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>~</span><code data-v-cdcb1722>salva-eml</code><span data-v-cdcb1722>connettore</span></li><li class="is-changed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>~</span><code data-v-cdcb1722>notifica</code><span data-v-cdcb1722>connettore</span></li><!--]--></ul></dd><!--]--><!--]--></dl><!--]--></div></article><article class="pipeline-versions__entry" data-v-cdcb1722><header class="pipeline-versions__header" data-v-cdcb1722><strong class="pipeline-versions__number" data-v-cdcb1722>v1</strong><span class="pipeline-versions__meta" data-v-cdcb1722>2026-10-05 · ETL-120</span><!----></header><!----><!--[--><!--[--><div class="pipeline-versions__list" data-v-cdcb1722><span class="pipeline-versions__list-title" data-v-cdcb1722>Aggiunte</span><ul data-v-cdcb1722><!--[--><li data-v-cdcb1722>Versione iniziale sotto versionamento (ADR-0086)</li><!--]--></ul></div><!--]--><!--[--><!----><!--]--><!--[--><!----><!--]--><!--]--><div class="pipeline-versions__diff" data-v-cdcb1722><p class="pipeline-versions__note" data-v-cdcb1722> Prima versione: non c'è una versione precedente da confrontare. </p></div></article><!--]--></div></div></div></main><footer class="VPDocFooter" data-v-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/pipelines/README" data-v-0be8676d><!--[--><span class="desc" data-v-0be8676d>Pagina precedente</span><span class="title" data-v-0be8676d>Le schede di una pipeline</span><!--]--></a></div><div class="pager" data-v-0be8676d><a class="VPLink link pager-link next" href="/guida/core/sub-pipelines/README" data-v-0be8676d><!--[--><span class="desc" data-v-0be8676d>Pagina successiva</span><span class="title" data-v-0be8676d>Le schede di una sub-pipeline</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>
|
|
43
|
+
<script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"BeotXAWb\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"BqI2RLCu\",\"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\":\"MQaGlm8a\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"CrN52ZDN\",\"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\":\"BI8tgBIq\",\"nodes_pipeline.md\":\"DIMlyprm\",\"nodes_readme.md\":\"CHGy_go6\",\"nodes_route.md\":\"Bt9qH6OA\",\"nodes_sink.md\":\"yAf_z4wO\",\"nodes_source.md\":\"DP2i3GFv\",\"nodes_task.md\":\"Dk6VB7as\",\"nodes_transform.md\":\"Bv5fg2Xx\",\"nodes_try-catch.md\":\"DCYydDPm\",\"nodes_union.md\":\"CznVzHTK\",\"pipelines_crm-leads-sync.md\":\"BlZUnxYn\",\"pipelines_cross-workspace-csv-merge.md\":\"CsRE6GNe\",\"pipelines_movimenti-per-conto.md\":\"DRGfO1_5\",\"pipelines_orders-enriched-daily.md\":\"jESRtvBo\",\"pipelines_readme.md\":\"Ee6LS-SU\",\"pipelines_test-posta.md\":\"Cxo_DGBs\",\"runbooks_aggiornamento-pm2.md\":\"DrFr4blI\",\"runbooks_deploy-ecr.md\":\"4jQypInn\",\"runbooks_deployment.md\":\"CwG77qGO\",\"runbooks_etl-worker.md\":\"Bu05cEgT\",\"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\":\"C8viT-fp\",\"runbooks_stato-incrementale.md\":\"hGZ8FlbZ\",\"sub-pipelines_readme.md\":\"CF8gmNPU\",\"sub-pipelines_riepilogo-ordini.md\":\"qCBZJ4nh\",\"technical_overview.md\":\"DTIhkkg9\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"it-IT\",\"dir\":\"ltr\",\"title\":\"Noeva ETL\",\"titleTemplate\":\":title · Noeva ETL\",\"description\":\"Documentazione di Noeva ETL: come usare la piattaforma e come creare pipeline con Claude Code.\",\"base\":\"/guida/core/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":{\"light\":\"/logo-dark.png\",\"dark\":\"/logo-light.png\",\"alt\":\"Noeva\"},\"siteTitle\":false,\"footer\":{\"message\":\"Noeva è un marchio registrato di 4D S.R.L.\",\"copyright\":\"© 2026 4D S.R.L. · Gruppo4D\"},\"outline\":{\"level\":[2,3],\"label\":\"In questa pagina\"},\"docFooter\":{\"prev\":\"Pagina precedente\",\"next\":\"Pagina successiva\"},\"darkModeSwitchLabel\":\"Tema\",\"lightModeSwitchTitle\":\"Passa al tema chiaro\",\"darkModeSwitchTitle\":\"Passa al tema scuro\",\"sidebarMenuLabel\":\"Menu\",\"returnToTopLabel\":\"Torna su\",\"langMenuLabel\":\"Lingua\",\"notFound\":{\"title\":\"PAGINA NON TROVATA\",\"quote\":\"Il documento che cercavi non c'è più, o non è mai stato pubblicato qui.\",\"linkLabel\":\"Torna alla home\",\"linkText\":\"Torna alla home\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Cerca\",\"buttonAriaLabel\":\"Cerca nella documentazione\"},\"modal\":{\"displayDetails\":\"Mostra i dettagli\",\"resetButtonTitle\":\"Azzera la ricerca\",\"backButtonTitle\":\"Chiudi la ricerca\",\"noResultsText\":\"Nessun risultato per\",\"footer\":{\"selectText\":\"per aprire\",\"selectKeyAriaLabel\":\"invio\",\"navigateText\":\"per spostarti\",\"navigateUpKeyAriaLabel\":\"freccia su\",\"navigateDownKeyAriaLabel\":\"freccia giù\",\"closeText\":\"per chiudere\",\"closeKeyAriaLabel\":\"esc\"}}}}},\"nav\":[{\"text\":\"Usare\",\"link\":\"/guide/usare/\",\"activeMatch\":\"^/guide/usare/\"},{\"text\":\"Creare con Claude Code\",\"link\":\"/guide/claude-code/\",\"activeMatch\":\"^/guide/claude-code/\"},{\"text\":\"Riferimento\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Tipi di nodo\",\"link\":\"/nodes/README\"},{\"text\":\"Connettori\",\"link\":\"/connectors/README\"},{\"text\":\"Pipeline pronte\",\"link\":\"/pipelines/README\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"},{\"text\":\"Operatività\",\"link\":\"/runbooks/graph-server\"}]}],\"sidebar\":[{\"text\":\"Usare Noeva ETL\",\"items\":[{\"text\":\"Come si usa\",\"link\":\"/guide/usare/\"},{\"text\":\"L'app desktop\",\"link\":\"/guide/usare/app-desktop\"},{\"text\":\"Leggere l'esito di una run\",\"link\":\"/guide/usare/esito-di-una-run\"},{\"text\":\"Panoramica di prodotto\",\"link\":\"/TECHNICAL_OVERVIEW\"}]},{\"text\":\"Creare con Claude Code\",\"items\":[{\"text\":\"Dal bisogno al processo\",\"link\":\"/guide/claude-code/\"},{\"text\":\"Comporre il prompt\",\"link\":\"/guide/claude-code/prompt\"},{\"text\":\"Skill e subagent\",\"link\":\"/guide/claude-code/strumenti\"},{\"text\":\"Guida allo sviluppo\",\"link\":\"/GUIDA_SVILUPPO\"}]},{\"text\":\"Concetti\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Versioni di pipeline\",\"link\":\"/conventions/versioni-di-pipeline\"},{\"text\":\"Descriptor dei nodi\",\"link\":\"/conventions/node-descriptor\"},{\"text\":\"Colonne dei nodi\",\"link\":\"/conventions/node-columns\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"}]},{\"text\":\"Tipi di nodo\",\"collapsed\":true,\"items\":[{\"text\":\"Cheatsheet\",\"link\":\"/nodes/README\"},{\"text\":\"action\",\"link\":\"/nodes/action\"},{\"text\":\"ai\",\"link\":\"/nodes/ai\"},{\"text\":\"join\",\"link\":\"/nodes/join\"},{\"text\":\"lookup\",\"link\":\"/nodes/lookup\"},{\"text\":\"pipeline\",\"link\":\"/nodes/pipeline\"},{\"text\":\"route\",\"link\":\"/nodes/route\"},{\"text\":\"sink\",\"link\":\"/nodes/sink\"},{\"text\":\"source\",\"link\":\"/nodes/source\"},{\"text\":\"task\",\"link\":\"/nodes/task\"},{\"text\":\"transform\",\"link\":\"/nodes/transform\"},{\"text\":\"try-catch\",\"link\":\"/nodes/try-catch\"},{\"text\":\"union\",\"link\":\"/nodes/union\"}]},{\"text\":\"Connettori\",\"collapsed\":true,\"items\":[{\"text\":\"Panoramica\",\"link\":\"/connectors/README\"},{\"text\":\"File (storage × codec)\",\"link\":\"/connectors/file\"},{\"text\":\"HTTP (API REST per i nodi lookup e action)\",\"link\":\"/connectors/http\"},{\"text\":\"IMAP (caselle di posta)\",\"link\":\"/connectors/imap\"},{\"text\":\"Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)\",\"link\":\"/connectors/jira\"},{\"text\":\"Noeva (file dei workspace)\",\"link\":\"/connectors/noeva\"},{\"text\":\"OAuth2 per i connettori\",\"link\":\"/connectors/oauth\"},{\"text\":\"PostgreSQL\",\"link\":\"/connectors/postgres\"},{\"text\":\"processo esterno\",\"link\":\"/connectors/process\"},{\"text\":\"SendGrid (mail via API REST)\",\"link\":\"/connectors/sendgrid\"},{\"text\":\"SMTP (notifiche email)\",\"link\":\"/connectors/smtp\"},{\"text\":\"SQL Server\",\"link\":\"/connectors/sqlserver\"},{\"text\":\"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\":\"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>
|
|
44
44
|
|
|
45
45
|
</body>
|
|
46
46
|
</html>
|