@noeva/etl-core 1.0.1 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (211) hide show
  1. package/CHANGELOG.md +128 -0
  2. package/README.md +6 -11
  3. package/dist/{ai-BoTwcmUg.d.ts → ai-DyDIf-hQ.d.ts} +1 -1
  4. package/dist/{ambiente-della-pipeline-BoymQ6uN.d.ts → ambiente-della-pipeline-BhWsyLUR.d.ts} +2 -2
  5. package/dist/chunk-47NVGHUY.js +2 -0
  6. package/dist/chunk-5OE6F2MK.js +2 -0
  7. package/dist/{chunk-NZR6TZ42.js → chunk-5XVANFXO.js} +1 -1
  8. package/dist/chunk-672L5BGQ.js +1 -0
  9. package/dist/{chunk-4NPSBPBY.js → chunk-6QVYBDIS.js} +1 -1
  10. package/dist/{chunk-PE2QKU34.js → chunk-CEAMQIRO.js} +1 -1
  11. package/dist/chunk-DHQ3YOPX.js +5 -0
  12. package/dist/chunk-FBSNZG34.js +1 -0
  13. package/dist/{chunk-J3PBMWSP.js → chunk-GZWYRO3V.js} +1 -1
  14. package/dist/chunk-IODXIHU2.js +1 -0
  15. package/dist/{chunk-P6B2KLNJ.js → chunk-KEFIGSRS.js} +2 -2
  16. package/dist/chunk-KGWA46Y6.js +2 -0
  17. package/dist/chunk-L25W2QNS.js +1 -0
  18. package/dist/{chunk-JLPK6MMQ.js → chunk-OK3XRTGA.js} +1 -1
  19. package/dist/chunk-UHGHK6NP.js +1 -0
  20. package/dist/chunk-VL7DZWWO.js +2 -0
  21. package/dist/chunk-VVXT66DC.js +1 -0
  22. package/dist/chunk-ZKDCUSM2.js +6 -0
  23. package/dist/cli.js +2 -2
  24. package/dist/{client-DYA3wIyb.d.ts → client-BC_mLuT2.d.ts} +2 -2
  25. package/dist/config-BSdGSRPG.d.ts +37 -0
  26. package/dist/{config-BSUwK4p_.d.ts → config-DMafsY4H.d.ts} +3 -3
  27. package/dist/connector-kit.d.ts +14 -9
  28. package/dist/connector-kit.js +1 -1
  29. package/dist/connectors/excel.d.ts +391 -0
  30. package/dist/connectors/excel.js +10 -0
  31. package/dist/connectors/file.d.ts +12 -5
  32. package/dist/connectors/file.js +1 -1
  33. package/dist/connectors/http.d.ts +7 -7
  34. package/dist/connectors/http.js +1 -1
  35. package/dist/connectors/imap.d.ts +6 -6
  36. package/dist/connectors/imap.js +1 -1
  37. package/dist/connectors/jira.d.ts +6 -6
  38. package/dist/connectors/jira.js +2 -2
  39. package/dist/connectors/mail.d.ts +7 -7
  40. package/dist/connectors/mail.js +1 -1
  41. package/dist/connectors/mysql.d.ts +238 -0
  42. package/dist/connectors/mysql.js +2 -0
  43. package/dist/connectors/noeva.d.ts +6 -6
  44. package/dist/connectors/noeva.js +1 -1
  45. package/dist/connectors/oauth.d.ts +5 -5
  46. package/dist/connectors/oauth.js +1 -1
  47. package/dist/connectors/odoo.d.ts +309 -0
  48. package/dist/connectors/odoo.js +3 -0
  49. package/dist/connectors/postgres.d.ts +7 -6
  50. package/dist/connectors/postgres.js +1 -1
  51. package/dist/connectors/process.d.ts +1 -1
  52. package/dist/connectors/process.js +1 -1
  53. package/dist/connectors/sendgrid.d.ts +7 -7
  54. package/dist/connectors/sendgrid.js +1 -1
  55. package/dist/connectors/smtp.d.ts +8 -8
  56. package/dist/connectors/smtp.js +1 -1
  57. package/dist/connectors/sqlserver.d.ts +7 -6
  58. package/dist/connectors/sqlserver.js +1 -1
  59. package/dist/connectors/zoho.d.ts +6 -6
  60. package/dist/connectors/zoho.js +1 -1
  61. package/dist/contract.d.ts +2 -2
  62. package/dist/{credenziali-posta-f7HB2cYW.d.ts → credenziali-posta-C0az04uV.d.ts} +2 -2
  63. package/dist/{errors-bgSO6lGO.d.ts → errors-CRq1uNYZ.d.ts} +8 -1
  64. package/dist/etl.config.js +3 -3
  65. package/dist/guida/404.html +2 -2
  66. package/dist/guida/GUIDA_SVILUPPO.html +7 -7
  67. package/dist/guida/TECHNICAL_OVERVIEW.html +7 -7
  68. package/dist/guida/assets/{GUIDA_SVILUPPO.md.CrN52ZDN.js → GUIDA_SVILUPPO.md.Bvr7RKHN.js} +2 -2
  69. package/dist/guida/assets/TECHNICAL_OVERVIEW.md.C6HYc5_h.js +10 -0
  70. package/dist/guida/assets/{app.DeVEBaIz.js → app.zL1wgTBx.js} +1 -1
  71. package/dist/guida/assets/chunks/@localSearchIndexroot.B5GjWddx.js +1 -0
  72. package/dist/guida/assets/chunks/{VPLocalSearchBox.CsTQzJUK.js → VPLocalSearchBox.BSMd0tSF.js} +1 -1
  73. package/dist/guida/assets/chunks/{theme.Dfy0C_Zf.js → theme.CRpFq7vp.js} +2 -2
  74. package/dist/guida/assets/connectors_README.md.B5QWzWUK.js +1 -0
  75. package/dist/guida/assets/connectors_README.md.B5QWzWUK.lean.js +1 -0
  76. package/dist/guida/assets/connectors_excel.md.CqGtwEB4.js +92 -0
  77. package/dist/guida/assets/connectors_excel.md.CqGtwEB4.lean.js +1 -0
  78. package/dist/guida/assets/{connectors_file.md.B1NJe0VJ.js → connectors_file.md.Dbofo9W5.js} +3 -3
  79. package/dist/guida/assets/{connectors_file.md.B1NJe0VJ.lean.js → connectors_file.md.Dbofo9W5.lean.js} +1 -1
  80. package/dist/guida/assets/connectors_mysql.md.fVCxQWUW.js +34 -0
  81. package/dist/guida/assets/connectors_mysql.md.fVCxQWUW.lean.js +1 -0
  82. package/dist/guida/assets/connectors_odoo.md.DprabV5e.js +19 -0
  83. package/dist/guida/assets/connectors_odoo.md.DprabV5e.lean.js +1 -0
  84. package/dist/guida/assets/{conventions_node-descriptor.md.MQaGlm8a.js → conventions_node-descriptor.md.C19dB-Tb.js} +4 -4
  85. package/dist/guida/assets/conventions_node-descriptor.md.C19dB-Tb.lean.js +1 -0
  86. package/dist/guida/assets/{conventions_run-report.md.D_pG07VG.js → conventions_run-report.md.iVSN9fNV.js} +1 -1
  87. package/dist/guida/assets/{conventions_versioni-di-pipeline.md.cy5nsizS.js → conventions_versioni-di-pipeline.md.DJPSthZ8.js} +1 -1
  88. package/dist/guida/assets/{conventions_versioni-di-pipeline.md.cy5nsizS.lean.js → conventions_versioni-di-pipeline.md.DJPSthZ8.lean.js} +1 -1
  89. package/dist/guida/assets/{nodes_README.md.CHGy_go6.js → nodes_README.md.BNAiSoJJ.js} +2 -2
  90. package/dist/guida/assets/{nodes_README.md.CHGy_go6.lean.js → nodes_README.md.BNAiSoJJ.lean.js} +1 -1
  91. package/dist/guida/assets/{nodes_lookup.md.BI8tgBIq.js → nodes_lookup.md.DrJFsfOJ.js} +1 -1
  92. package/dist/guida/assets/{nodes_sink.md.yAf_z4wO.js → nodes_sink.md.C1S-lAh2.js} +2 -2
  93. package/dist/guida/assets/{nodes_source.md.DP2i3GFv.js → nodes_source.md.BitUNtug.js} +2 -2
  94. package/dist/guida/assets/{nodes_task.md.Dk6VB7as.js → nodes_task.md.CejEQZcD.js} +2 -2
  95. package/dist/guida/assets/{nodes_task.md.Dk6VB7as.lean.js → nodes_task.md.CejEQZcD.lean.js} +1 -1
  96. package/dist/guida/assets/{nodes_transform.md.Bv5fg2Xx.js → nodes_transform.md.Ciycywnb.js} +1 -1
  97. package/dist/guida/assets/{runbooks_deployment.md.CwG77qGO.js → runbooks_deployment.md.BV8Izw4I.js} +1 -1
  98. package/dist/guida/assets/runbooks_excel-operazioni-distruttive.md.CEygSROg.js +16 -0
  99. package/dist/guida/assets/runbooks_excel-operazioni-distruttive.md.CEygSROg.lean.js +1 -0
  100. package/dist/guida/assets/{runbooks_sql-task-truncate-swap.md.C8viT-fp.js → runbooks_sql-task-truncate-swap.md.DAz41942.js} +5 -3
  101. package/dist/guida/assets/{runbooks_sql-task-truncate-swap.md.C8viT-fp.lean.js → runbooks_sql-task-truncate-swap.md.DAz41942.lean.js} +1 -1
  102. package/dist/guida/connectors/README.html +5 -5
  103. package/dist/guida/connectors/excel.html +118 -0
  104. package/dist/guida/connectors/file.html +7 -7
  105. package/dist/guida/connectors/http.html +4 -4
  106. package/dist/guida/connectors/imap.html +4 -4
  107. package/dist/guida/connectors/jira.html +5 -5
  108. package/dist/guida/connectors/mysql.html +60 -0
  109. package/dist/guida/connectors/noeva.html +5 -5
  110. package/dist/guida/connectors/oauth.html +5 -5
  111. package/dist/guida/connectors/odoo.html +45 -0
  112. package/dist/guida/connectors/postgres.html +5 -5
  113. package/dist/guida/connectors/process.html +4 -4
  114. package/dist/guida/connectors/sendgrid.html +4 -4
  115. package/dist/guida/connectors/smtp.html +4 -4
  116. package/dist/guida/connectors/sqlserver.html +4 -4
  117. package/dist/guida/connectors/zoho.html +4 -4
  118. package/dist/guida/conventions/node-columns.html +4 -4
  119. package/dist/guida/conventions/node-descriptor.html +8 -8
  120. package/dist/guida/conventions/run-report.html +6 -6
  121. package/dist/guida/conventions/run-trace.html +4 -4
  122. package/dist/guida/conventions/variabili-del-core.html +4 -4
  123. package/dist/guida/conventions/versioni-di-pipeline.html +6 -6
  124. package/dist/guida/guide/claude-code/index.html +4 -4
  125. package/dist/guida/guide/claude-code/prompt.html +5 -5
  126. package/dist/guida/guide/claude-code/strumenti.html +4 -4
  127. package/dist/guida/guide/grafo.html +4 -4
  128. package/dist/guida/guide/usare/app-desktop.html +4 -4
  129. package/dist/guida/guide/usare/esito-di-una-run.html +4 -4
  130. package/dist/guida/guide/usare/index.html +4 -4
  131. package/dist/guida/hashmap.json +1 -1
  132. package/dist/guida/index.html +4 -4
  133. package/dist/guida/nodes/README.html +5 -5
  134. package/dist/guida/nodes/action.html +4 -4
  135. package/dist/guida/nodes/ai.html +4 -4
  136. package/dist/guida/nodes/join.html +4 -4
  137. package/dist/guida/nodes/lookup.html +6 -6
  138. package/dist/guida/nodes/pipeline.html +4 -4
  139. package/dist/guida/nodes/route.html +4 -4
  140. package/dist/guida/nodes/sink.html +7 -7
  141. package/dist/guida/nodes/source.html +7 -7
  142. package/dist/guida/nodes/task.html +6 -6
  143. package/dist/guida/nodes/transform.html +6 -6
  144. package/dist/guida/nodes/try-catch.html +4 -4
  145. package/dist/guida/nodes/union.html +4 -4
  146. package/dist/guida/pagine.json +4 -0
  147. package/dist/guida/pipelines/README.html +4 -4
  148. package/dist/guida/pipelines/crm-leads-sync.html +4 -4
  149. package/dist/guida/pipelines/cross-workspace-csv-merge.html +4 -4
  150. package/dist/guida/pipelines/movimenti-per-conto.html +4 -4
  151. package/dist/guida/pipelines/orders-enriched-daily.html +4 -4
  152. package/dist/guida/pipelines/test-posta.html +4 -4
  153. package/dist/guida/runbooks/aggiornamento-pm2.html +4 -4
  154. package/dist/guida/runbooks/deploy-ecr.html +4 -4
  155. package/dist/guida/runbooks/deployment.html +6 -6
  156. package/dist/guida/runbooks/etl-worker.html +5 -5
  157. package/dist/guida/runbooks/excel-operazioni-distruttive.html +42 -0
  158. package/dist/guida/runbooks/graph-server.html +5 -5
  159. package/dist/guida/runbooks/mask-key.html +4 -4
  160. package/dist/guida/runbooks/oauth-google-posta.html +4 -4
  161. package/dist/guida/runbooks/rollback-di-pipeline.html +4 -4
  162. package/dist/guida/runbooks/scd2-rehash.html +4 -4
  163. package/dist/guida/runbooks/sql-task-truncate-swap.html +8 -6
  164. package/dist/guida/runbooks/stato-incrementale.html +4 -4
  165. package/dist/guida/sub-pipelines/README.html +4 -4
  166. package/dist/guida/sub-pipelines/riepilogo-ordini.html +4 -4
  167. package/dist/index.d.ts +9 -9
  168. package/dist/index.js +1 -1
  169. package/dist/{invio-Dwz3J7sP.d.ts → invio-9Ubb_cdR.d.ts} +3 -3
  170. package/dist/{istanza-per-il-piano-CucqUF7b.d.ts → istanza-per-il-piano-74NYhIHc.d.ts} +1 -1
  171. package/dist/{manifest-variabili-U1UfPDfF.d.ts → manifest-variabili-DRWUzmxU.d.ts} +1 -1
  172. package/dist/pipelines.d.ts +3 -3
  173. package/dist/pipelines.js +1 -1
  174. package/dist/{runnable-pipeline-CArkLzfv.d.ts → runnable-pipeline-CWgPwi6w.d.ts} +2 -2
  175. package/dist/{config-DIthC7n7.d.ts → sql-watermark-CQVvxhPZ.d.ts} +9 -40
  176. package/dist/testing.d.ts +3 -3
  177. package/dist/testing.js +1 -1
  178. package/dist/{trasporto-DpPLCEQ1.d.ts → trasporto-BaRdP6Wl.d.ts} +4 -4
  179. package/dist/{types-BVA7BIou.d.ts → types-_3rgLhje.d.ts} +21 -2
  180. package/dist/{variabili-dichiarate-DmfcxsT9.d.ts → variabili-dichiarate-CS-eC53K.d.ts} +1 -1
  181. package/kit/skills/etl-graph/SKILL.md +6 -3
  182. package/kit/skills/etl-graph/references/data-patterns.md +1 -1
  183. package/kit/skills/etl-graph/references/error-handling.md +3 -3
  184. package/kit/skills/etl-graph/references/wiring.md +10 -10
  185. package/kit/skills/new-connector/SKILL.md +2 -2
  186. package/package.json +16 -1
  187. package/dist/chunk-BVUOUBLW.js +0 -1
  188. package/dist/chunk-CRR3Q2C7.js +0 -2
  189. package/dist/chunk-LJ7DVP5F.js +0 -2
  190. package/dist/chunk-PKBSETMV.js +0 -2
  191. package/dist/chunk-QPJC4GWR.js +0 -1
  192. package/dist/chunk-RCRMQPFH.js +0 -5
  193. package/dist/chunk-RS5SGDUU.js +0 -1
  194. package/dist/chunk-RWPHH4E2.js +0 -1
  195. package/dist/chunk-SRFFKE5W.js +0 -6
  196. package/dist/chunk-WVODQB6Z.js +0 -1
  197. package/dist/chunk-XZMCC6VQ.js +0 -1
  198. package/dist/chunk-ZCYGHS7P.js +0 -2
  199. package/dist/guida/assets/TECHNICAL_OVERVIEW.md.DTIhkkg9.js +0 -10
  200. package/dist/guida/assets/chunks/@localSearchIndexroot.NgfCNDyz.js +0 -1
  201. package/dist/guida/assets/connectors_README.md.BqI2RLCu.js +0 -1
  202. package/dist/guida/assets/connectors_README.md.BqI2RLCu.lean.js +0 -1
  203. package/dist/guida/assets/conventions_node-descriptor.md.MQaGlm8a.lean.js +0 -1
  204. /package/dist/guida/assets/{GUIDA_SVILUPPO.md.CrN52ZDN.lean.js → GUIDA_SVILUPPO.md.Bvr7RKHN.lean.js} +0 -0
  205. /package/dist/guida/assets/{TECHNICAL_OVERVIEW.md.DTIhkkg9.lean.js → TECHNICAL_OVERVIEW.md.C6HYc5_h.lean.js} +0 -0
  206. /package/dist/guida/assets/{conventions_run-report.md.D_pG07VG.lean.js → conventions_run-report.md.iVSN9fNV.lean.js} +0 -0
  207. /package/dist/guida/assets/{nodes_lookup.md.BI8tgBIq.lean.js → nodes_lookup.md.DrJFsfOJ.lean.js} +0 -0
  208. /package/dist/guida/assets/{nodes_sink.md.yAf_z4wO.lean.js → nodes_sink.md.C1S-lAh2.lean.js} +0 -0
  209. /package/dist/guida/assets/{nodes_source.md.DP2i3GFv.lean.js → nodes_source.md.BitUNtug.lean.js} +0 -0
  210. /package/dist/guida/assets/{nodes_transform.md.Bv5fg2Xx.lean.js → nodes_transform.md.Ciycywnb.lean.js} +0 -0
  211. /package/dist/guida/assets/{runbooks_deployment.md.CwG77qGO.lean.js → runbooks_deployment.md.BV8Izw4I.lean.js} +0 -0
@@ -9,18 +9,18 @@
9
9
  <link rel="preload stylesheet" href="/guida/core/assets/style.DFlUbYCk.css" as="style">
10
10
  <link rel="preload stylesheet" href="/guida/core/vp-icons.css" as="style">
11
11
 
12
- <script type="module" src="/guida/core/assets/app.DeVEBaIz.js"></script>
12
+ <script type="module" src="/guida/core/assets/app.zL1wgTBx.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.Dfy0C_Zf.js">
14
+ <link rel="modulepreload" href="/guida/core/assets/chunks/theme.CRpFq7vp.js">
15
15
  <link rel="modulepreload" href="/guida/core/assets/chunks/framework.qdetmeNX.js">
16
- <link rel="modulepreload" href="/guida/core/assets/conventions_run-report.md.D_pG07VG.lean.js">
16
+ <link rel="modulepreload" href="/guida/core/assets/conventions_run-report.md.iVSN9fNV.lean.js">
17
17
  <link rel="icon" type="image/svg+xml" href="/guida/core/favicon.svg">
18
18
  <meta name="theme-color" content="#0a0e15">
19
19
  <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
20
20
  <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
21
21
  </head>
22
22
  <body>
23
- <div id="app"><div class="Layout" data-v-22f0e4eb><!--[--><!--]--><!--[--><span tabindex="-1" data-v-3426c47a></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-3426c47a>Skip to content</a><!--]--><!----><header class="VPNav" data-v-22f0e4eb data-v-c0562b42><div class="VPNavBar" data-v-c0562b42 data-v-09e46d68><div class="wrapper" data-v-09e46d68><div class="container" data-v-09e46d68><div class="title" data-v-09e46d68><div class="VPNavBarTitle has-sidebar" data-v-09e46d68 data-v-373bba86><a class="title" href="/guida/core/" data-v-373bba86><!--[--><!--]--><!--[--><!--[--><!--[--><img class="VPImage dark logo" src="/guida/core/logo-light.png" alt="Noeva" data-v-b8fe04e5><!--]--><!--[--><img class="VPImage light logo" src="/guida/core/logo-dark.png" alt="Noeva" data-v-b8fe04e5><!--]--><!--]--><!--]--><!----><!--[--><!--[--><!--[--><!--[--><span class="etl-wordmark" aria-hidden="true">ETL</span><span class="etl-embedded-title">Documentazione</span><!--]--><!--]--><!--]--><!--]--></a></div></div><div class="content" data-v-09e46d68><div class="content-body" data-v-09e46d68><!--[--><!--]--><div class="VPNavBarSearch search" data-v-09e46d68><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Cerca nella documentazione"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Cerca</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-09e46d68 data-v-39d75b74><span id="main-nav-aria-label" class="visually-hidden" data-v-39d75b74> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/guida/core/guide/usare/" tabindex="0" data-v-39d75b74 data-v-d4ae6030><!--[--><span data-v-d4ae6030>Usare</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/guida/core/guide/claude-code/" tabindex="0" data-v-39d75b74 data-v-d4ae6030><!--[--><span data-v-d4ae6030>Creare con Claude Code</span><!--]--></a><!--]--><!--[--><div class="VPFlyout VPNavBarMenuGroup active" data-v-39d75b74 data-v-5d303cc7><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-5d303cc7><span class="text" data-v-5d303cc7><!----><span data-v-5d303cc7>Riferimento</span><span class="vpi-chevron-down text-icon" data-v-5d303cc7></span></span></button><div class="menu" data-v-5d303cc7><div class="VPMenu" data-v-5d303cc7 data-v-e79ccfeb><div class="items" data-v-e79ccfeb><!--[--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/guide/grafo" data-v-b2643254><!--[--><span data-v-b2643254>Il grafo, nodo per nodo</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/nodes/README" data-v-b2643254><!--[--><span data-v-b2643254>Tipi di nodo</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" 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 active" 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 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>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" 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_conventions_run-report" data-v-4f20312f><div><h1 id="graphrunreport-—-il-risultato-di-una-esecuzione" tabindex="-1">GraphRunReport — il risultato di una esecuzione <a class="header-anchor" href="#graphrunreport-—-il-risultato-di-una-esecuzione" aria-label="Permalink to &quot;GraphRunReport — il risultato di una esecuzione&quot;">​</a></h1><p>Il servizio è <strong>stateless e agnostico</strong>: esegue una pipeline e <strong>restituisce un GraphRunReport</strong> con tutti i dettagli del caso. Non possiede DB, non scrive da nessuna parte, non fa push. Cosa farne (archiviare, alert, ignorare) è deciso dal chiamante.</p><h2 id="contratto-di-i-o-cli-container" tabindex="-1">Contratto di I/O (CLI / container) <a class="header-anchor" href="#contratto-di-i-o-cli-container" aria-label="Permalink to &quot;Contratto di I/O (CLI / container)&quot;">​</a></h2><ul><li><strong><code>stdout</code></strong> = <strong>un solo oggetto JSON</strong>: il report. Parsabile con <code>jq</code>.</li><li><strong><code>stderr</code></strong> = log umani / progress (riga <code>pipeline.completed</code>, ecc.).</li><li><strong>exit code</strong>: <code>0</code> se <code>status</code> è <code>success</code>/<code>partial</code>; <code>≠0</code> se <code>failed</code>.</li><li><strong>Anche in caso di errore</strong> viene emesso un report (<code>status: &quot;failed&quot;</code>).</li></ul><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;">etl</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> sessions-daily</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> report.json</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> 2&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run.log</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> # separa report e log</span></span>
23
+ <div id="app"><div class="Layout" data-v-22f0e4eb><!--[--><!--]--><!--[--><span tabindex="-1" data-v-3426c47a></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-3426c47a>Skip to content</a><!--]--><!----><header class="VPNav" data-v-22f0e4eb data-v-c0562b42><div class="VPNavBar" data-v-c0562b42 data-v-09e46d68><div class="wrapper" data-v-09e46d68><div class="container" data-v-09e46d68><div class="title" data-v-09e46d68><div class="VPNavBarTitle has-sidebar" data-v-09e46d68 data-v-373bba86><a class="title" href="/guida/core/" data-v-373bba86><!--[--><!--]--><!--[--><!--[--><!--[--><img class="VPImage dark logo" src="/guida/core/logo-light.png" alt="Noeva" data-v-b8fe04e5><!--]--><!--[--><img class="VPImage light logo" src="/guida/core/logo-dark.png" alt="Noeva" data-v-b8fe04e5><!--]--><!--]--><!--]--><!----><!--[--><!--[--><!--[--><!--[--><span class="etl-wordmark" aria-hidden="true">ETL</span><span class="etl-embedded-title">Documentazione</span><!--]--><!--]--><!--]--><!--]--></a></div></div><div class="content" data-v-09e46d68><div class="content-body" data-v-09e46d68><!--[--><!--]--><div class="VPNavBarSearch search" data-v-09e46d68><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Cerca nella documentazione"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Cerca</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-09e46d68 data-v-39d75b74><span id="main-nav-aria-label" class="visually-hidden" data-v-39d75b74> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/guida/core/guide/usare/" tabindex="0" data-v-39d75b74 data-v-d4ae6030><!--[--><span data-v-d4ae6030>Usare</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/guida/core/guide/claude-code/" tabindex="0" data-v-39d75b74 data-v-d4ae6030><!--[--><span data-v-d4ae6030>Creare con Claude Code</span><!--]--></a><!--]--><!--[--><div class="VPFlyout VPNavBarMenuGroup active" data-v-39d75b74 data-v-5d303cc7><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-5d303cc7><span class="text" data-v-5d303cc7><!----><span data-v-5d303cc7>Riferimento</span><span class="vpi-chevron-down text-icon" data-v-5d303cc7></span></span></button><div class="menu" data-v-5d303cc7><div class="VPMenu" data-v-5d303cc7 data-v-e79ccfeb><div class="items" data-v-e79ccfeb><!--[--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/guide/grafo" data-v-b2643254><!--[--><span data-v-b2643254>Il grafo, nodo per nodo</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/nodes/README" data-v-b2643254><!--[--><span data-v-b2643254>Tipi di nodo</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" 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 active" 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 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>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/excel" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Excel</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/file" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>File (storage × codec)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/http" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>HTTP (API REST per i nodi lookup e action)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/imap" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>IMAP (caselle di posta)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/jira" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/mysql" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>MySQL e MariaDB</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/noeva" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Noeva (file dei workspace)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/oauth" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>OAuth2 per i connettori</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/odoo" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Odoo (record di un modello, con i campi dichiarati)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/postgres" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>PostgreSQL</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/process" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>processo esterno</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/sendgrid" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>SendGrid (mail via API REST)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/smtp" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>SMTP (notifiche email)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/sqlserver" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>SQL Server</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/zoho" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Zoho CRM (record di un modulo, con i campi dichiarati)</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Pipeline pronte</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/README" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Le schede di una pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/test-posta" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>test-posta</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Esempi</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/sub-pipelines/README" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Le schede di una sub-pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/crm-leads-sync" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>crm-leads-sync</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/cross-workspace-csv-merge" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>cross-workspace-csv-merge</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/movimenti-per-conto" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>movimenti-per-conto</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/orders-enriched-daily" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>orders-enriched-daily</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/sub-pipelines/riepilogo-ordini" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>riepilogo-ordini</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Operatività</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/aggiornamento-pm2" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>aggiornare un deploy PM2 di un repo cliente</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/deploy-ecr" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>un cliente su ECR + ECS</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/deployment" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>distribuzione del runner ETL</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/etl-worker" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>worker etl worker (polling su processes)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/excel-operazioni-distruttive" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>operazioni distruttive di excelSink</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/graph-server" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>server grafi etl serve (HTTP)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/mask-key" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>chiavi di mask (creazione, rotazione, compromissione)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/oauth-google-posta" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>OAuth2 per una casella Google (IMAP + SMTP)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/rollback-di-pipeline" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>rollback di una pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/scd2-rehash" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>rehash di una dimensione storicizzata</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/sql-task-truncate-swap" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>task SQL, truncate e scambio di tabelle</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/stato-incrementale" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>stato di pipeline e watermark</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-22f0e4eb data-v-0c4b08a9><div class="VPDoc has-sidebar has-aside" data-v-0c4b08a9 data-v-4f20312f><!--[--><!--]--><div class="container" data-v-4f20312f><div class="aside" data-v-4f20312f><div class="aside-curtain" data-v-4f20312f></div><div class="aside-container" data-v-4f20312f><div class="aside-content" data-v-4f20312f><div class="VPDocAside" data-v-4f20312f data-v-2db35001><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-2db35001 data-v-2f8395af><div class="content" data-v-2f8395af><div class="outline-marker" data-v-2f8395af></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-2f8395af>In questa pagina</div><ul class="VPDocOutlineItem root" data-v-2f8395af data-v-9c3b479d><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-2db35001></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-4f20312f><div class="content-container" data-v-4f20312f><!--[--><!--]--><main class="main" data-v-4f20312f><div style="position:relative;" class="vp-doc _guida_core_conventions_run-report" data-v-4f20312f><div><h1 id="graphrunreport-—-il-risultato-di-una-esecuzione" tabindex="-1">GraphRunReport — il risultato di una esecuzione <a class="header-anchor" href="#graphrunreport-—-il-risultato-di-una-esecuzione" aria-label="Permalink to &quot;GraphRunReport — il risultato di una esecuzione&quot;">​</a></h1><p>Il servizio è <strong>stateless e agnostico</strong>: esegue una pipeline e <strong>restituisce un GraphRunReport</strong> con tutti i dettagli del caso. Non possiede DB, non scrive da nessuna parte, non fa push. Cosa farne (archiviare, alert, ignorare) è deciso dal chiamante.</p><h2 id="contratto-di-i-o-cli-container" tabindex="-1">Contratto di I/O (CLI / container) <a class="header-anchor" href="#contratto-di-i-o-cli-container" aria-label="Permalink to &quot;Contratto di I/O (CLI / container)&quot;">​</a></h2><ul><li><strong><code>stdout</code></strong> = <strong>un solo oggetto JSON</strong>: il report. Parsabile con <code>jq</code>.</li><li><strong><code>stderr</code></strong> = log umani / progress (riga <code>pipeline.completed</code>, ecc.).</li><li><strong>exit code</strong>: <code>0</code> se <code>status</code> è <code>success</code>/<code>partial</code>; <code>≠0</code> se <code>failed</code>.</li><li><strong>Anche in caso di errore</strong> viene emesso un report (<code>status: &quot;failed&quot;</code>).</li></ul><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;">etl</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> sessions-daily</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> report.json</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> 2&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run.log</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> # separa report e log</span></span>
24
24
  <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">etl</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> sessions-daily</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> |</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> jq</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &#39;.status, .written&#39;</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> # consuma al volo</span></span></code></pre></div><p>Come libreria, <code>graph(...).build().run(ctx)</code> restituisce direttamente il report e <strong>lancia sull&#39;errore fatale</strong> — contratto invariato. L&#39;errore lanciato porta con sé un report <strong>completo</strong> (topologia reale e conteggi parziali), recuperabile con <code>graphRunReportOf(err)</code>:</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">try</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
25
25
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> report </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> pipeline.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">run</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(ctx);</span></span>
26
26
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">} </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">catch</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (err) {</span></span>
@@ -64,7 +64,7 @@
64
64
  <span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> &quot;durationMs&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">1360</span></span>
65
65
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
66
66
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
67
- <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">]</span></span></code></pre></div><p><code>etl runs show</code> mostra la sezione «Istanze» dopo la tabella dei nodi: una riga per istanza, indentata per profondità, con entrati, usciti per uscita, rifiutati e durata («mai avviata» o «interrotta» quando l&#39;istanza è partita ma nessun suo nodo si è concluso). Senza istanze la sezione non compare.</p><h3 id="task" tabindex="-1">Task <a class="header-anchor" href="#task" aria-label="Permalink to &quot;Task&quot;">​</a></h3><p>Un <code>task</code> è un nodo del report con <code>kind: &quot;task&quot;</code>. Non vede record: <code>extracted</code>, <code>written</code> e <code>rejected</code> restano a 0, e non entra nei totali della run. <code>startedAt</code> è l&#39;ingresso in <code>run()</code>, <code>finishedAt</code> l&#39;uscita. I dettagli, per esempio le righe toccate da un task SQL, stanno in <code>nodeReports</code>. <code>retries</code> compare con una policy di <code>retry</code>.</p><p><code>startedAt: null</code> <strong>non è un dato mancante</strong>: significa che il nodo non ha mai attraversato un record — input vuoto, filtro che scarta tutto a monte, o run abortita prima che il nodo partisse. È il corollario documentato su <code>ProgressReporter.onNodeStart</code>. In quel caso <code>durationMs</code> è <code>0</code>: una durata non misurata si dichiara zero, non si deriva da un solo estremo.</p><h3 id="run-fallita-topologia-e-conteggi-parziali" tabindex="-1">Run fallita: topologia e conteggi parziali <a class="header-anchor" href="#run-fallita-topologia-e-conteggi-parziali" aria-label="Permalink to &quot;Run fallita: topologia e conteggi parziali&quot;">​</a></h3><p>Al primo errore fatale il runner <strong>annulla tutti i rami</strong> e aspetta che ogni sink e ogni task chiuda, poi assembla il report: una run <code>failed</code> non scrive più niente dopo essere stata riportata tale. <code>error</code> è il primo errore, quello del nodo che è fallito; i nodi degli altri rami risultano interrotti.</p><p>Un report <code>failed</code> prodotto da una run che è <strong>partita</strong> contiene la topologia reale e i conteggi accumulati fino all&#39;abort — è proprio la run che più serve ispezionare, e lasciarla come guscio vuoto sarebbe un difetto.</p><p>Un report <code>failed</code> prodotto da <code>buildFailedGraphReport</code> (fallimento <strong>prima</strong> del grafo) ha invece <code>nodes: []</code> / <code>edges: []</code>, perché non c&#39;è alcuna topologia eseguita da riportare, e <code>instances: []</code>.</p><p>Il report allegato all&#39;errore porta anche <code>instances</code>, col riepilogo di quanto contato fino all&#39;interruzione.</p><h3 id="nodereports-e-writereport" tabindex="-1"><code>nodeReports</code> e <code>writeReport</code> <a class="header-anchor" href="#nodereports-e-writereport" aria-label="Permalink to &quot;`nodeReports` e `writeReport`&quot;">​</a></h3><p>Ogni nodo del grafo (source/transform/lookup/ai/action/route/join/union/sink/try-catch/task) può ricevere un&#39;opzione <code>writeReport: (ctx, stats) =&gt; Record&lt;string, unknown&gt;</code> in fase di costruzione: <code>GraphBuilder.source/transform/lookup/ai/action/route/join/union/sink/tryCatch/task(..., { writeReport })</code>. <code>stats</code> espone i conteggi del nodo (<code>extracted</code>/<code>written</code>/ <code>rejected</code>/<code>rejectedReasons</code>) così un nodo può riassumere i volumi senza scrivere il payload grezzo (es. <code>{ recordsFetched: 1_000_000 }</code> invece del milione di record). Se né il nodo né la sua transform (o il suo task) dichiarano un <code>writeReport</code>, o se quello in uso lancia, il runner scrive il default <code>{ name: node.name, success }</code>, dove <code>success</code> è <code>true</code> se il nodo non ha abortito la run (uno scarto isolato a dead-letter non conta come fallimento).</p><p>Una <strong>transform può dichiarare il proprio <code>writeReport</code> di default</strong> (<code>Transform.writeReport</code>): è il modo in cui <code>profile</code> porta il profilo delle colonne, <code>assert</code> l&#39;esito dei suoi check, e i nodi <code>lookup</code> e <code>ai</code> i propri contatori (sotto <code>lookup</code>), nel report senza che la pipeline cabli nulla. Un <strong>task</strong> fa lo stesso con <code>Task.writeReport</code>: il task SQL ci porta le righe toccate da ogni statement. L&#39;ordine è: <code>writeReport</code> del nodo, poi quello della transform, poi il default. Quello del nodo <strong>sostituisce</strong> quello della transform, non lo unisce. Il report dichiarato dalla transform si calcola anche quando il nodo fallisce, e un suo errore ricade sul default con un warning, come per quello del nodo. La forma di <code>nodeReports</code> non cambia (resta una mappa di oggetti liberi), quindi non ha inciso su <code>reportSchemaVersion</code>.</p><p>Sui nodi <code>lookup</code>, <code>ai</code> e <code>action</code>, l&#39;opzione <strong><code>recordReport: { row, key?, maxRows? }</code></strong> aggiunge al report del nodo una riga a campi semplici per ogni record riuscito, sotto <code>key</code> (default <code>records</code>), <strong>accanto</strong> al report della transform (o a <code>{ name }</code>, se la transform non ne ha uno). Un <code>writeReport</code> sullo stesso nodo è un errore di composizione. Al più <code>maxRows</code> righe (default 500, il resto in <code>rowsOmitted</code>; le righe che <code>row</code> non è riuscita a scrivere in <code>rowsFailed</code>), stringhe tagliate a 500 caratteri. I campi che <code>row</code> restituisce sono persistiti: la scheda della pipeline li elenca. Anche questo non tocca <code>reportSchemaVersion</code>.</p><p><code>processes.output_data</code> riceve gli stessi report <strong>incrementalmente</strong>, durante l&#39;esecuzione (non solo a fine run). Accanto a <code>nodeReports</code> viaggia <code>runningNodes: string[]</code> — i nodi che stanno elaborando <strong>adesso</strong> (partiti e non ancora completati), da <code>ProgressReporter.onNodeStart</code>. È ciò che permette alla UI di distinguere un nodo che lavora da uno in attesa, e quindi di mostrare due rami concorrenti. Assente sulle run concluse.</p><p>Con loro viaggia <code>skippedNodes: { [nodeId]: { because } }</code>, i nodi <strong>saltati</strong> fin qui. È sempre presente, <code>{}</code> se nessun nodo è saltato: una chiave assente vuol dire un motore precedente. Sta in una mappa a sé e non dentro <code>nodeReports[nodeId]</code>, che è l&#39;output di <code>writeReport</code> e ha le chiavi scelte dalla pipeline. Come <code>runningNodes</code> è assente sulle run concluse, dove <code>nodes[].skipped</code> del report dice la stessa cosa.</p><p>La quarta chiave è <code>nodeCounts: { [nodeId]: { entered, exited, errored, caught?, held? } }</code>, i contatori dal vivo. Anche lei sempre presente, <code>{}</code> finché nessun nodo ha contato nulla, e assente sulle run concluse, dove valgono i conteggi di <code>nodes[]</code>. <code>noeva-server-api</code> sostituisce <code>output_data</code> a ogni scrittura invece di fonderlo, quindi il worker rimanda ogni volta tutte e quattro le chiavi.</p><p><code>nodes</code> ed <code>edges</code> sono la topologia <strong>reale</strong> del grafo eseguito: un nodo per ogni <code>source</code>/<code>transform</code>/<code>lookup</code>/<code>ai</code>/<code>action</code>/<code>route</code>/<code>join</code>/<code>union</code>/<code>sink</code>/<code>try-catch</code>/<code>task</code> dichiarato nel builder. Non esiste un nodo sintetico che collassa la catena.</p><h3 id="contatori-dal-vivo" tabindex="-1">Contatori dal vivo <a class="header-anchor" href="#contatori-dal-vivo" aria-label="Permalink to &quot;Contatori dal vivo&quot;">​</a></h3><p>Mentre la run è in corso ogni nodo ha tre contatori, più due che hanno solo alcuni nodi. I primi quattro sono gli stessi numeri del report, letti prima che la run finisca:</p><table tabindex="0"><thead><tr><th>Contatore</th><th>Campo di <code>NodeCounts</code></th><th>A fine run, nel report</th></tr></thead><tbody><tr><td>Entrati</td><td><code>entered</code></td><td><code>extracted</code></td></tr><tr><td>Usciti</td><td><code>exited</code></td><td><code>written</code></td></tr><tr><td>In errore</td><td><code>errored</code></td><td><code>rejected</code> + i <code>caughtErrors</code> di tutti i guard con <code>sourceNodeId</code> = il nodo</td></tr><tr><td>Catturati</td><td><code>caught</code>, solo guard</td><td><code>caught</code> del <code>try-catch</code></td></tr><tr><td>In lavorazione</td><td><code>held</code>, solo chi lo dichiara</td><td>— (non c&#39;è: a fine run vale zero)</td></tr></tbody></table><p>«In errore» conta un errore catturato da un <code>try-catch</code> sul nodo <strong>in cui è nato</strong>, non sul guard: il guard mostra a parte i suoi catturati. Un retry poi riuscito non è un errore. In circuit-breaker, e su un sink opaco, la cattura è <strong>una per evento</strong> e non per record: il nodo segna un errore anche se lo stream interrotto ne portava di più, come <code>caught</code> sul guard.</p><p><strong>In lavorazione</strong> (<code>held</code>) sono i record che il nodo sta trattenendo ora. Non si ricava per differenza: c&#39;è solo sui nodi che lo sanno, e <strong>assente non vuol dire zero</strong>.</p><table tabindex="0"><thead><tr><th>Nodo</th><th>Cosa conta</th></tr></thead><tbody><tr><td><code>join</code></td><td>i record del probe letti in anticipo e non ancora confrontati</td></tr><tr><td><code>try-catch</code></td><td>gli errori in coda che il ramo <code>catch</code> non ha ancora preso</td></tr><tr><td>un nodo con più edge in uscita (fan-out), un <code>route</code></td><td>i record nel buffer del <code>tee</code> che il ramo più lento non ha ancora preso</td></tr><tr><td>una transform che dichiara <code>Transform.held</code></td><td>i record ricevuti e non ancora fatti uscire</td></tr><tr><td><code>lookup</code>, <code>ai</code></td><td>i record della finestra: accumulati, in volo col round-trip, non ancora emessi</td></tr><tr><td><code>action</code></td><td>il record in volo: uno mentre l&#39;azione non ha risposto</td></tr><tr><td>un sink con <code>retry</code> o <code>rateLimit</code></td><td>il blocco del runner, in riempimento o in scrittura; un <code>loadOne</code> in volo</td></tr><tr><td>un sink senza policy che dichiara <code>Sink.held</code></td><td>le righe nel batch del sink non ancora scritte</td></tr></tbody></table><p>Le transform di libreria che lo dichiarano oggi sono <code>sort</code>, <code>groupBy</code>, <code>pivot</code>, <code>chunk</code>, <code>serialize</code> e <code>assert</code> in gate. Un nodo che ha due di queste voci (un <code>sort</code> con un fan-out) le somma. Due nodi trattengono record <strong>senza</strong> dichiararlo, e quindi non hanno il campo: <code>dedup</code> con <code>keep: &quot;last&quot;</code> e i buffer di prefetch di un <code>union</code> in <code>concat</code>.</p><p>Su <code>lookup</code>, <code>ai</code> e <code>action</code> conta <strong>record</strong>, non chiamate: un round-trip copre una finestra intera, e un resolver che fa più richieste in parallelo (<code>httpLookup</code> per chiave) non cambia il numero. Dove il runner esegue il nodo record per record (guard per-record, dead-letter di nodo, <code>recordIds</code>) la finestra è da uno. Sui sink <code>Sink.held</code> lo dichiarano Postgres e SQL Server, upsert e SCD2. Con una policy il blocco del runner comprende già il batch del sink, quindi conta solo lui: sommarli conterebbe due volte le stesse righe. Il batch del sink conta finché lo statement non risponde; le righe già scritte ma non ancora confermate dal commit non sono né in lavorazione né uscite. A run conclusa, riuscita o fallita, l&#39;ultima emissione porta <code>held: 0</code> su ogni nodo che lo dichiara, anche se un fallimento ha lasciato un buffer pieno.</p><p>Gli usciti di un <strong>sink</strong> salgono quando il sink dice di aver scritto: a ogni record sotto un guard per-record, a ogni blocco di <code>batchSize</code> con una policy di <code>retry</code>. Senza nessuno dei due il sink scrive in un solo <code>load</code>, e i suoi usciti arrivano tutti a fine scrittura, mentre gli entrati salgono record per record.</p><p>Il runner li emette con <code>ProgressReporter.onProgress</code>: <strong>un evento per run</strong>, al più ogni secondo (<code>PROGRESS_INTERVAL_MS</code>), con i soli nodi cambiati. Un nodo mai partito o saltato non compare mai. A run conclusa, riuscita o fallita, arriva un&#39;ultima emissione prima che <code>runGraph</code> restituisca: l&#39;ultimo valore di ogni nodo è quello del report. Senza un <code>onProgress</code> nel reporter non parte nessun timer.</p><p>I nodi sono quelli del grafo <strong>eseguito</strong>: su una root con sub-pipeline, che l&#39;appiattimento riduce a nodi piatti al <code>build()</code>, i contatori arrivano per <strong>id qualificato</strong> (<code>inst</code>, <code>inst/per-due</code>, <code>inst/dentro/per-due</code>), come nel report. Il nodo di confine d&#39;ingresso di un&#39;istanza ha l&#39;id dell&#39;istanza, ed è lì che un record fuori schema conta «in errore».</p><p>Il worker non inoltra ogni emissione: accumula i contatori nodo per nodo e li scrive su <code>processes</code> al più ogni cinque secondi, la prima volta subito e poi a fine finestra con l&#39;ultimo valore, se nel frattempo un avvio o un completamento di nodo non li ha già portati. Una scrittura fallita si riprova alla finestra dopo. A run conclusa il worker chiude la finestra e aspetta la scrittura in volo prima del report finale: arrivata dopo, lo sostituirebbe. Chi segue una run sul worker col solo polling vede quindi i contatori fino a ~5 s indietro, più i 2 s del polling della UI.</p><table tabindex="0"><thead><tr><th>Canale</th><th>Dove</th></tr></thead><tbody><tr><td><code>ProgressReporter.onProgress</code></td><td><code>update.nodes: NodeCounts[]</code></td></tr><tr><td>Stream SSE <code>GET /runs/:id/events</code></td><td><code>node-progress</code> con <code>nodes</code>; a chi si connette tardi il bus ritrasmette solo l&#39;ultimo valore per nodo</td></tr><tr><td>Polling su <code>processes</code> (<code>noeva-server-api</code>)</td><td><code>output_data.nodeCounts: { [nodeId]: { entered, exited, errored, caught?, held? } }</code>, scritto dal worker al più ogni ~5 s (<code>WORKER_PROGRESS_INTERVAL_MS</code>)</td></tr></tbody></table><p><strong>Il report non cambia</strong>: i contatori dal vivo non aggiungono campi, e lo schema resta quello di <a href="#versione-di-pipeline-e-release">§ «Versione di pipeline e release»</a> (<code>reportSchemaVersion</code> 8). Chi riapre una run conclusa ricava «in errore» da <code>rejected</code> e da <code>caughtErrors[].sourceNodeId</code>. La lista è limitata a <code>caughtErrorsLimit</code> voci per guard (default 100): oltre il tetto, una parte dei catturati non è più attribuibile a un nodo, e il numero ricavato dal report è un minimo. La UI lo segna con «≥».</p><h2 id="scarti-report-vs-payload" tabindex="-1">Scarti: report vs payload <a class="header-anchor" href="#scarti-report-vs-payload" aria-label="Permalink to &quot;Scarti: report vs payload&quot;">​</a></h2><p>Il report contiene <strong>solo conteggi e categorie</strong> di scarto (niente payload → niente PII). I <strong>record scartati completi</strong> vanno nel <strong>dead-letter sink</strong>, che è <strong>scelto dal chiamante</strong> (file, tabella, coda). Così il servizio resta agnostico e il report è sicuro da archiviare.</p><p>Il <code>DeadLetter</code> porta quindi campi che il report <strong>non</strong> ha, perché contengono payload reale:</p><table tabindex="0"><thead><tr><th>Campo</th><th>Quando</th><th>Nel report?</th></tr></thead><tbody><tr><td><code>raw</code></td><td>catture per-record (transform isolate, sink con <code>loadOne</code>)</td><td>Solo con <code>includeRawInReport</code> sul guard</td></tr><tr><td><code>lastConsumed</code></td><td>nodi non isolabili, durante il <strong>consumo</strong></td><td><strong>Mai</strong></td></tr><tr><td><code>guardSnapshots</code></td><td>record d&#39;ingresso da cui deriva il fallimento, risalendo <code>derivedFrom</code></td><td><strong>Mai</strong></td></tr></tbody></table><p>Sintetici e quindi sicuri da esporre: <code>error.context.recordId</code> (id del record entrato nel nodo che ha fallito) e <code>error.context.derivedFrom</code> (id dei contribuenti, quando il fallimento avviene in emissione di un nodo stateful). Sono id, non dati.</p><p>Nota: <code>guardSnapshots</code> è additivo e opzionale, quindi non ha inciso su <code>reportSchemaVersion</code>.</p><p>Per seguire <strong>quali</strong> record sono passati da un nodo, e com&#39;erano, c&#39;è la <strong>traccia</strong> di una run tracciata (<code>etl run --trace</code>): un documento separato, con i valori in chiaro, che il report non contiene. Vedi <a href="./run-trace">La traccia di una run</a>.</p><h3 id="versione-di-pipeline-e-release" tabindex="-1">Versione di pipeline e release <a class="header-anchor" href="#versione-di-pipeline-e-release" aria-label="Permalink to &quot;Versione di pipeline e release&quot;">​</a></h3><p>Una run dice con quale codice è girata in quattro campi. Lo <strong>schema v7</strong> ha separato la versione di pipeline dalla release; lo <strong>schema v8</strong> aggiunge la versione del core e il cliente:</p><ul><li><code>pipelineVersion</code> è la <strong>versione di pipeline</strong>: con quale codice della pipeline è girata la run. È l&#39;ultima voce del changelog della pipeline nel catalogo, e la mettono nel <code>RunContext</code><code>etl run</code>, il worker e le run tracciate lanciate da <code>etl serve</code>, non l&#39;ambiente. Una pipeline pronta porta il suo changelog con sé, dal pacchetto del core: la sua versione è quella che il core le ha dato. Un grafo lanciato fuori dal catalogo, come nei test, ha <code>null</code>.</li><li><code>release</code> è la <strong>release</strong> del deploy: con quale artefatto è girata, cioè il commit del repo cliente. Due run con la stessa <code>pipelineVersion</code> e <code>release</code> diverse sono girate sullo stesso codice di pipeline ma su un artefatto diverso. Viene da <code>ETL_RELEASE</code> se è impostata (l&#39;immagine la riceve come build arg); altrimenti, quando il deploy gira da un checkout (sotto PM2), è il commit del repo dell&#39;<code>etl.config.ts</code>, <code>git:&lt;sha&gt;</code> con <code>-dirty</code> se ha modifiche non committate a file tracciati (<code>src/release.ts</code>). Si chiede a git nella cartella del config e non in quella del core, che in un repo cliente sta in <code>node_modules</code>; se quella cartella non è la radice del checkout, la release è <code>null</code>. Si calcola una volta all&#39;avvio del processo.</li><li><code>core</code> è la <strong>versione del core</strong>: la <code>version</code> del <code>package.json</code> del pacchetto installato, letta a runtime e mai da un build arg. La release la fissa già, attraverso il lockfile del repo cliente, ma qui si legge senza aprirlo. Se il pacchetto non si trova, l&#39;avvio si ferma con un <code>ConfigError</code> che nomina dove l&#39;ha cercato.</li><li><code>client</code> è il <strong>cliente</strong> del deploy, il <code>client</code> di <code>defineEtlConfig</code>.</li></ul><p><code>etl run</code>, il worker e le run tracciate calcolano i tre campi del deploy dal catalogo caricato (<code>src/deploy-identity.ts</code>), uguali per tutte le run del processo. Un grafo lanciato fuori dalla CLI li ha a <code>null</code>.</p><p>Fino allo schema v6 la release stava in <code>version</code>, un nome ambiguo. È l&#39;unico rename dello schema: un consumer che legge <code>version</code> non lo trova più, e deve leggere <code>release</code> a partire da <code>reportSchemaVersion</code> 7. Il report del worker arriva com&#39;è in <code>processes.output_data</code>, quindi anche lo storico Noeva porta tutti i campi.</p><p>Lo store locale delle run (<code>etl runs</code>, <code>GET /runs/:id</code>) rilegge i report salvati con uno schema precedente nella forma corrente: prima del v7 <code>version</code> diventa <code>release</code> e <code>pipelineVersion</code> vale <code>null</code>, prima del v8 <code>core</code> e <code>client</code> valgono <code>null</code>, perché quelle run non li hanno mai registrati. <code>reportSchemaVersion</code> resta quello con cui il report è nato.</p><h2 id="esempio-successo" tabindex="-1">Esempio (successo) <a class="header-anchor" href="#esempio-successo" aria-label="Permalink to &quot;Esempio (successo)&quot;">​</a></h2><div class="language-json vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
67
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">]</span></span></code></pre></div><p><code>etl runs show</code> mostra la sezione «Istanze» dopo la tabella dei nodi: una riga per istanza, indentata per profondità, con entrati, usciti per uscita, rifiutati e durata («mai avviata» o «interrotta» quando l&#39;istanza è partita ma nessun suo nodo si è concluso). Senza istanze la sezione non compare.</p><h3 id="task" tabindex="-1">Task <a class="header-anchor" href="#task" aria-label="Permalink to &quot;Task&quot;">​</a></h3><p>Un <code>task</code> è un nodo del report con <code>kind: &quot;task&quot;</code>. Non vede record: <code>extracted</code>, <code>written</code> e <code>rejected</code> restano a 0, e non entra nei totali della run. <code>startedAt</code> è l&#39;ingresso in <code>run()</code>, <code>finishedAt</code> l&#39;uscita. I dettagli, per esempio le righe toccate da un task SQL, stanno in <code>nodeReports</code>. <code>retries</code> compare con una policy di <code>retry</code>.</p><p><code>startedAt: null</code> <strong>non è un dato mancante</strong>: significa che il nodo non ha mai attraversato un record — input vuoto, filtro che scarta tutto a monte, o run abortita prima che il nodo partisse. È il corollario documentato su <code>ProgressReporter.onNodeStart</code>. In quel caso <code>durationMs</code> è <code>0</code>: una durata non misurata si dichiara zero, non si deriva da un solo estremo.</p><h3 id="run-fallita-topologia-e-conteggi-parziali" tabindex="-1">Run fallita: topologia e conteggi parziali <a class="header-anchor" href="#run-fallita-topologia-e-conteggi-parziali" aria-label="Permalink to &quot;Run fallita: topologia e conteggi parziali&quot;">​</a></h3><p>Al primo errore fatale il runner <strong>annulla tutti i rami</strong> e aspetta che ogni sink e ogni task chiuda, poi assembla il report: una run <code>failed</code> non scrive più niente dopo essere stata riportata tale. <code>error</code> è il primo errore, quello del nodo che è fallito; i nodi degli altri rami risultano interrotti.</p><p>Un report <code>failed</code> prodotto da una run che è <strong>partita</strong> contiene la topologia reale e i conteggi accumulati fino all&#39;abort — è proprio la run che più serve ispezionare, e lasciarla come guscio vuoto sarebbe un difetto.</p><p>Un report <code>failed</code> prodotto da <code>buildFailedGraphReport</code> (fallimento <strong>prima</strong> del grafo) ha invece <code>nodes: []</code> / <code>edges: []</code>, perché non c&#39;è alcuna topologia eseguita da riportare, e <code>instances: []</code>.</p><p>Il report allegato all&#39;errore porta anche <code>instances</code>, col riepilogo di quanto contato fino all&#39;interruzione.</p><h3 id="nodereports-e-writereport" tabindex="-1"><code>nodeReports</code> e <code>writeReport</code> <a class="header-anchor" href="#nodereports-e-writereport" aria-label="Permalink to &quot;`nodeReports` e `writeReport`&quot;">​</a></h3><p>Ogni nodo del grafo (source/transform/lookup/ai/action/route/join/union/sink/try-catch/task) può ricevere un&#39;opzione <code>writeReport: (ctx, stats) =&gt; Record&lt;string, unknown&gt;</code> in fase di costruzione: <code>GraphBuilder.source/transform/lookup/ai/action/route/join/union/sink/tryCatch/task(..., { writeReport })</code>. <code>stats</code> espone i conteggi del nodo (<code>extracted</code>/<code>written</code>/ <code>rejected</code>/<code>rejectedReasons</code>) così un nodo può riassumere i volumi senza scrivere il payload grezzo (es. <code>{ recordsFetched: 1_000_000 }</code> invece del milione di record). Se né il nodo né la sua transform (o il suo task) dichiarano un <code>writeReport</code>, o se quello in uso lancia, il runner scrive il default <code>{ name: node.name, success }</code>, dove <code>success</code> è <code>true</code> se il nodo non ha abortito la run (uno scarto isolato a dead-letter non conta come fallimento).</p><p>Una <strong>transform può dichiarare il proprio <code>writeReport</code> di default</strong> (<code>Transform.writeReport</code>): è il modo in cui <code>profile</code> porta il profilo delle colonne, <code>assert</code> l&#39;esito dei suoi check, e i nodi <code>lookup</code> e <code>ai</code> i propri contatori (sotto <code>lookup</code>), nel report senza che la pipeline cabli nulla. Un <strong>task</strong> fa lo stesso con <code>Task.writeReport</code>: il task SQL ci porta le righe toccate da ogni statement. L&#39;ordine è: <code>writeReport</code> del nodo, poi quello della transform, poi il default. Quello del nodo <strong>sostituisce</strong> quello della transform, non lo unisce. Il report dichiarato dalla transform si calcola anche quando il nodo fallisce, e un suo errore ricade sul default con un warning, come per quello del nodo. La forma di <code>nodeReports</code> non cambia (resta una mappa di oggetti liberi), quindi non ha inciso su <code>reportSchemaVersion</code>.</p><p>Sui nodi <code>lookup</code>, <code>ai</code> e <code>action</code>, l&#39;opzione <strong><code>recordReport: { row, key?, maxRows? }</code></strong> aggiunge al report del nodo una riga a campi semplici per ogni record riuscito, sotto <code>key</code> (default <code>records</code>), <strong>accanto</strong> al report della transform (o a <code>{ name }</code>, se la transform non ne ha uno). Un <code>writeReport</code> sullo stesso nodo è un errore di composizione. Al più <code>maxRows</code> righe (default 500, il resto in <code>rowsOmitted</code>; le righe che <code>row</code> non è riuscita a scrivere in <code>rowsFailed</code>), stringhe tagliate a 500 caratteri. I campi che <code>row</code> restituisce sono persistiti: la scheda della pipeline li elenca. Anche questo non tocca <code>reportSchemaVersion</code>.</p><p><code>processes.output_data</code> riceve gli stessi report <strong>incrementalmente</strong>, durante l&#39;esecuzione (non solo a fine run). Accanto a <code>nodeReports</code> viaggia <code>runningNodes: string[]</code> — i nodi che stanno elaborando <strong>adesso</strong> (partiti e non ancora completati), da <code>ProgressReporter.onNodeStart</code>. È ciò che permette alla UI di distinguere un nodo che lavora da uno in attesa, e quindi di mostrare due rami concorrenti. Assente sulle run concluse.</p><p>Con loro viaggia <code>skippedNodes: { [nodeId]: { because } }</code>, i nodi <strong>saltati</strong> fin qui. È sempre presente, <code>{}</code> se nessun nodo è saltato: una chiave assente vuol dire un motore precedente. Sta in una mappa a sé e non dentro <code>nodeReports[nodeId]</code>, che è l&#39;output di <code>writeReport</code> e ha le chiavi scelte dalla pipeline. Come <code>runningNodes</code> è assente sulle run concluse, dove <code>nodes[].skipped</code> del report dice la stessa cosa.</p><p>La quarta chiave è <code>nodeCounts: { [nodeId]: { entered, exited, errored, caught?, held? } }</code>, i contatori dal vivo. Anche lei sempre presente, <code>{}</code> finché nessun nodo ha contato nulla, e assente sulle run concluse, dove valgono i conteggi di <code>nodes[]</code>. <code>noeva-server-api</code> sostituisce <code>output_data</code> a ogni scrittura invece di fonderlo, quindi il worker rimanda ogni volta tutte e quattro le chiavi.</p><p><code>nodes</code> ed <code>edges</code> sono la topologia <strong>reale</strong> del grafo eseguito: un nodo per ogni <code>source</code>/<code>transform</code>/<code>lookup</code>/<code>ai</code>/<code>action</code>/<code>route</code>/<code>join</code>/<code>union</code>/<code>sink</code>/<code>try-catch</code>/<code>task</code> dichiarato nel builder. Non esiste un nodo sintetico che collassa la catena.</p><h3 id="contatori-dal-vivo" tabindex="-1">Contatori dal vivo <a class="header-anchor" href="#contatori-dal-vivo" aria-label="Permalink to &quot;Contatori dal vivo&quot;">​</a></h3><p>Mentre la run è in corso ogni nodo ha tre contatori, più due che hanno solo alcuni nodi. I primi quattro sono gli stessi numeri del report, letti prima che la run finisca:</p><table tabindex="0"><thead><tr><th>Contatore</th><th>Campo di <code>NodeCounts</code></th><th>A fine run, nel report</th></tr></thead><tbody><tr><td>Entrati</td><td><code>entered</code></td><td><code>extracted</code></td></tr><tr><td>Usciti</td><td><code>exited</code></td><td><code>written</code></td></tr><tr><td>In errore</td><td><code>errored</code></td><td><code>rejected</code> + i <code>caughtErrors</code> di tutti i guard con <code>sourceNodeId</code> = il nodo</td></tr><tr><td>Catturati</td><td><code>caught</code>, solo guard</td><td><code>caught</code> del <code>try-catch</code></td></tr><tr><td>In lavorazione</td><td><code>held</code>, solo chi lo dichiara</td><td>— (non c&#39;è: a fine run vale zero)</td></tr></tbody></table><p>«In errore» conta un errore catturato da un <code>try-catch</code> sul nodo <strong>in cui è nato</strong>, non sul guard: il guard mostra a parte i suoi catturati. Un retry poi riuscito non è un errore. In circuit-breaker, e su un sink opaco, la cattura è <strong>una per evento</strong> e non per record: il nodo segna un errore anche se lo stream interrotto ne portava di più, come <code>caught</code> sul guard.</p><p><strong>In lavorazione</strong> (<code>held</code>) sono i record che il nodo sta trattenendo ora. Non si ricava per differenza: c&#39;è solo sui nodi che lo sanno, e <strong>assente non vuol dire zero</strong>.</p><table tabindex="0"><thead><tr><th>Nodo</th><th>Cosa conta</th></tr></thead><tbody><tr><td><code>join</code></td><td>i record del probe letti in anticipo e non ancora confrontati</td></tr><tr><td><code>try-catch</code></td><td>gli errori in coda che il ramo <code>catch</code> non ha ancora preso</td></tr><tr><td>un nodo con più edge in uscita (fan-out), un <code>route</code></td><td>i record nel buffer del <code>tee</code> che il ramo più lento non ha ancora preso</td></tr><tr><td>una transform che dichiara <code>Transform.held</code></td><td>i record ricevuti e non ancora fatti uscire</td></tr><tr><td><code>lookup</code>, <code>ai</code></td><td>i record della finestra: accumulati, in volo col round-trip, non ancora emessi</td></tr><tr><td><code>action</code></td><td>il record in volo: uno mentre l&#39;azione non ha risposto</td></tr><tr><td>un sink con <code>retry</code> o <code>rateLimit</code></td><td>il blocco del runner, in riempimento o in scrittura; un <code>loadOne</code> in volo</td></tr><tr><td>un sink senza policy che dichiara <code>Sink.held</code></td><td>le righe nel batch del sink non ancora scritte</td></tr></tbody></table><p>Le transform di libreria che lo dichiarano oggi sono <code>sort</code>, <code>groupBy</code>, <code>pivot</code>, <code>chunk</code>, <code>serialize</code> e <code>assert</code> in gate. Un nodo che ha due di queste voci (un <code>sort</code> con un fan-out) le somma. Due nodi trattengono record <strong>senza</strong> dichiararlo, e quindi non hanno il campo: <code>dedup</code> con <code>keep: &quot;last&quot;</code> e i buffer di prefetch di un <code>union</code> in <code>concat</code>.</p><p>Su <code>lookup</code>, <code>ai</code> e <code>action</code> conta <strong>record</strong>, non chiamate: un round-trip copre una finestra intera, e un resolver che fa più richieste in parallelo (<code>httpLookup</code> per chiave) non cambia il numero. Dove il runner esegue il nodo record per record (guard per-record, dead-letter di nodo, <code>recordIds</code>) la finestra è da uno. Sui sink <code>Sink.held</code> lo dichiarano Postgres, SQL Server e MySQL, upsert e SCD2 dove c&#39;è. Con una policy il blocco del runner comprende già il batch del sink, quindi conta solo lui: sommarli conterebbe due volte le stesse righe. Il batch del sink conta finché lo statement non risponde; le righe già scritte ma non ancora confermate dal commit non sono né in lavorazione né uscite. A run conclusa, riuscita o fallita, l&#39;ultima emissione porta <code>held: 0</code> su ogni nodo che lo dichiara, anche se un fallimento ha lasciato un buffer pieno.</p><p>Gli usciti di un <strong>sink</strong> salgono quando il sink dice di aver scritto: a ogni record sotto un guard per-record, a ogni blocco di <code>batchSize</code> con una policy di <code>retry</code>. Senza nessuno dei due il sink scrive in un solo <code>load</code>, e i suoi usciti arrivano tutti a fine scrittura, mentre gli entrati salgono record per record.</p><p>Il runner li emette con <code>ProgressReporter.onProgress</code>: <strong>un evento per run</strong>, al più ogni secondo (<code>PROGRESS_INTERVAL_MS</code>), con i soli nodi cambiati. Un nodo mai partito o saltato non compare mai. A run conclusa, riuscita o fallita, arriva un&#39;ultima emissione prima che <code>runGraph</code> restituisca: l&#39;ultimo valore di ogni nodo è quello del report. Senza un <code>onProgress</code> nel reporter non parte nessun timer.</p><p>I nodi sono quelli del grafo <strong>eseguito</strong>: su una root con sub-pipeline, che l&#39;appiattimento riduce a nodi piatti al <code>build()</code>, i contatori arrivano per <strong>id qualificato</strong> (<code>inst</code>, <code>inst/per-due</code>, <code>inst/dentro/per-due</code>), come nel report. Il nodo di confine d&#39;ingresso di un&#39;istanza ha l&#39;id dell&#39;istanza, ed è lì che un record fuori schema conta «in errore».</p><p>Il worker non inoltra ogni emissione: accumula i contatori nodo per nodo e li scrive su <code>processes</code> al più ogni cinque secondi, la prima volta subito e poi a fine finestra con l&#39;ultimo valore, se nel frattempo un avvio o un completamento di nodo non li ha già portati. Una scrittura fallita si riprova alla finestra dopo. A run conclusa il worker chiude la finestra e aspetta la scrittura in volo prima del report finale: arrivata dopo, lo sostituirebbe. Chi segue una run sul worker col solo polling vede quindi i contatori fino a ~5 s indietro, più i 2 s del polling della UI.</p><table tabindex="0"><thead><tr><th>Canale</th><th>Dove</th></tr></thead><tbody><tr><td><code>ProgressReporter.onProgress</code></td><td><code>update.nodes: NodeCounts[]</code></td></tr><tr><td>Stream SSE <code>GET /runs/:id/events</code></td><td><code>node-progress</code> con <code>nodes</code>; a chi si connette tardi il bus ritrasmette solo l&#39;ultimo valore per nodo</td></tr><tr><td>Polling su <code>processes</code> (<code>noeva-server-api</code>)</td><td><code>output_data.nodeCounts: { [nodeId]: { entered, exited, errored, caught?, held? } }</code>, scritto dal worker al più ogni ~5 s (<code>WORKER_PROGRESS_INTERVAL_MS</code>)</td></tr></tbody></table><p><strong>Il report non cambia</strong>: i contatori dal vivo non aggiungono campi, e lo schema resta quello di <a href="#versione-di-pipeline-e-release">§ «Versione di pipeline e release»</a> (<code>reportSchemaVersion</code> 8). Chi riapre una run conclusa ricava «in errore» da <code>rejected</code> e da <code>caughtErrors[].sourceNodeId</code>. La lista è limitata a <code>caughtErrorsLimit</code> voci per guard (default 100): oltre il tetto, una parte dei catturati non è più attribuibile a un nodo, e il numero ricavato dal report è un minimo. La UI lo segna con «≥».</p><h2 id="scarti-report-vs-payload" tabindex="-1">Scarti: report vs payload <a class="header-anchor" href="#scarti-report-vs-payload" aria-label="Permalink to &quot;Scarti: report vs payload&quot;">​</a></h2><p>Il report contiene <strong>solo conteggi e categorie</strong> di scarto (niente payload → niente PII). I <strong>record scartati completi</strong> vanno nel <strong>dead-letter sink</strong>, che è <strong>scelto dal chiamante</strong> (file, tabella, coda). Così il servizio resta agnostico e il report è sicuro da archiviare.</p><p>Il <code>DeadLetter</code> porta quindi campi che il report <strong>non</strong> ha, perché contengono payload reale:</p><table tabindex="0"><thead><tr><th>Campo</th><th>Quando</th><th>Nel report?</th></tr></thead><tbody><tr><td><code>raw</code></td><td>catture per-record (transform isolate, sink con <code>loadOne</code>)</td><td>Solo con <code>includeRawInReport</code> sul guard</td></tr><tr><td><code>lastConsumed</code></td><td>nodi non isolabili, durante il <strong>consumo</strong></td><td><strong>Mai</strong></td></tr><tr><td><code>guardSnapshots</code></td><td>record d&#39;ingresso da cui deriva il fallimento, risalendo <code>derivedFrom</code></td><td><strong>Mai</strong></td></tr></tbody></table><p>Sintetici e quindi sicuri da esporre: <code>error.context.recordId</code> (id del record entrato nel nodo che ha fallito) e <code>error.context.derivedFrom</code> (id dei contribuenti, quando il fallimento avviene in emissione di un nodo stateful). Sono id, non dati.</p><p>Nota: <code>guardSnapshots</code> è additivo e opzionale, quindi non ha inciso su <code>reportSchemaVersion</code>.</p><p>Per seguire <strong>quali</strong> record sono passati da un nodo, e com&#39;erano, c&#39;è la <strong>traccia</strong> di una run tracciata (<code>etl run --trace</code>): un documento separato, con i valori in chiaro, che il report non contiene. Vedi <a href="./run-trace">La traccia di una run</a>.</p><h3 id="versione-di-pipeline-e-release" tabindex="-1">Versione di pipeline e release <a class="header-anchor" href="#versione-di-pipeline-e-release" aria-label="Permalink to &quot;Versione di pipeline e release&quot;">​</a></h3><p>Una run dice con quale codice è girata in quattro campi. Lo <strong>schema v7</strong> ha separato la versione di pipeline dalla release; lo <strong>schema v8</strong> aggiunge la versione del core e il cliente:</p><ul><li><code>pipelineVersion</code> è la <strong>versione di pipeline</strong>: con quale codice della pipeline è girata la run. È l&#39;ultima voce del changelog della pipeline nel catalogo, e la mettono nel <code>RunContext</code><code>etl run</code>, il worker e le run tracciate lanciate da <code>etl serve</code>, non l&#39;ambiente. Una pipeline pronta porta il suo changelog con sé, dal pacchetto del core: la sua versione è quella che il core le ha dato. Un grafo lanciato fuori dal catalogo, come nei test, ha <code>null</code>.</li><li><code>release</code> è la <strong>release</strong> del deploy: con quale artefatto è girata, cioè il commit del repo cliente. Due run con la stessa <code>pipelineVersion</code> e <code>release</code> diverse sono girate sullo stesso codice di pipeline ma su un artefatto diverso. Viene da <code>ETL_RELEASE</code> se è impostata (l&#39;immagine la riceve come build arg); altrimenti, quando il deploy gira da un checkout (sotto PM2), è il commit del repo dell&#39;<code>etl.config.ts</code>, <code>git:&lt;sha&gt;</code> con <code>-dirty</code> se ha modifiche non committate a file tracciati (<code>src/release.ts</code>). Si chiede a git nella cartella del config e non in quella del core, che in un repo cliente sta in <code>node_modules</code>; se quella cartella non è la radice del checkout, la release è <code>null</code>. Si calcola una volta all&#39;avvio del processo.</li><li><code>core</code> è la <strong>versione del core</strong>: la <code>version</code> del <code>package.json</code> del pacchetto installato, letta a runtime e mai da un build arg. La release la fissa già, attraverso il lockfile del repo cliente, ma qui si legge senza aprirlo. Se il pacchetto non si trova, l&#39;avvio si ferma con un <code>ConfigError</code> che nomina dove l&#39;ha cercato.</li><li><code>client</code> è il <strong>cliente</strong> del deploy, il <code>client</code> di <code>defineEtlConfig</code>.</li></ul><p><code>etl run</code>, il worker e le run tracciate calcolano i tre campi del deploy dal catalogo caricato (<code>src/deploy-identity.ts</code>), uguali per tutte le run del processo. Un grafo lanciato fuori dalla CLI li ha a <code>null</code>.</p><p>Fino allo schema v6 la release stava in <code>version</code>, un nome ambiguo. È l&#39;unico rename dello schema: un consumer che legge <code>version</code> non lo trova più, e deve leggere <code>release</code> a partire da <code>reportSchemaVersion</code> 7. Il report del worker arriva com&#39;è in <code>processes.output_data</code>, quindi anche lo storico Noeva porta tutti i campi.</p><p>Lo store locale delle run (<code>etl runs</code>, <code>GET /runs/:id</code>) rilegge i report salvati con uno schema precedente nella forma corrente: prima del v7 <code>version</code> diventa <code>release</code> e <code>pipelineVersion</code> vale <code>null</code>, prima del v8 <code>core</code> e <code>client</code> valgono <code>null</code>, perché quelle run non li hanno mai registrati. <code>reportSchemaVersion</code> resta quello con cui il report è nato.</p><h2 id="esempio-successo" tabindex="-1">Esempio (successo) <a class="header-anchor" href="#esempio-successo" aria-label="Permalink to &quot;Esempio (successo)&quot;">​</a></h2><div class="language-json vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
68
68
  <span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> &quot;reportSchemaVersion&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">8</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
69
69
  <span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> &quot;runId&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;ebe7d7cc-…&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
70
70
  <span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> &quot;pipeline&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;sessions-daily&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
@@ -223,7 +223,7 @@
223
223
  <span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> &quot;nodeId&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">null</span></span>
224
224
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
225
225
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></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/guide/grafo" data-v-0be8676d><!--[--><span class="desc" data-v-0be8676d>Pagina precedente</span><span class="title" data-v-0be8676d>Il grafo, nodo per nodo</span><!--]--></a></div><div class="pager" data-v-0be8676d><a class="VPLink link pager-link next" href="/guida/core/conventions/run-trace" data-v-0be8676d><!--[--><span class="desc" data-v-0be8676d>Pagina successiva</span><span class="title" data-v-0be8676d>La traccia di una run</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>
226
- <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>
226
+ <script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_excel.md\":\"CqGtwEB4\",\"connectors_file.md\":\"Dbofo9W5\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_mysql.md\":\"fVCxQWUW\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"BeotXAWb\",\"connectors_odoo.md\":\"DprabV5e\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"B5QWzWUK\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"connectors_zoho.md\":\"BfEzRNZk\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"C19dB-Tb\",\"conventions_run-report.md\":\"iVSN9fNV\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"DJPSthZ8\",\"guida_sviluppo.md\":\"Bvr7RKHN\",\"guide_claude-code_index.md\":\"DEnzf9b_\",\"guide_claude-code_prompt.md\":\"C7uETA9W\",\"guide_claude-code_strumenti.md\":\"BWhQnAlY\",\"guide_grafo.md\":\"Dy8_YMeh\",\"guide_usare_app-desktop.md\":\"CcDu8cJL\",\"guide_usare_esito-di-una-run.md\":\"DkvAOPBE\",\"guide_usare_index.md\":\"BJqi3P7J\",\"index.md\":\"kMhsF-sv\",\"nodes_action.md\":\"DOsTbV-i\",\"nodes_ai.md\":\"CVtP9gEJ\",\"nodes_join.md\":\"DSYbIDG6\",\"nodes_lookup.md\":\"DrJFsfOJ\",\"nodes_pipeline.md\":\"DIMlyprm\",\"nodes_readme.md\":\"BNAiSoJJ\",\"nodes_route.md\":\"Bt9qH6OA\",\"nodes_sink.md\":\"C1S-lAh2\",\"nodes_source.md\":\"BitUNtug\",\"nodes_task.md\":\"CejEQZcD\",\"nodes_transform.md\":\"Ciycywnb\",\"nodes_try-catch.md\":\"DCYydDPm\",\"nodes_union.md\":\"CznVzHTK\",\"pipelines_crm-leads-sync.md\":\"BlZUnxYn\",\"pipelines_cross-workspace-csv-merge.md\":\"CsRE6GNe\",\"pipelines_movimenti-per-conto.md\":\"DRGfO1_5\",\"pipelines_orders-enriched-daily.md\":\"jESRtvBo\",\"pipelines_readme.md\":\"Ee6LS-SU\",\"pipelines_test-posta.md\":\"Cxo_DGBs\",\"runbooks_aggiornamento-pm2.md\":\"DrFr4blI\",\"runbooks_deploy-ecr.md\":\"4jQypInn\",\"runbooks_deployment.md\":\"BV8Izw4I\",\"runbooks_etl-worker.md\":\"Bu05cEgT\",\"runbooks_excel-operazioni-distruttive.md\":\"CEygSROg\",\"runbooks_graph-server.md\":\"opGHnuzK\",\"runbooks_mask-key.md\":\"nZkhAjBf\",\"runbooks_oauth-google-posta.md\":\"Bs7QTkmU\",\"runbooks_rollback-di-pipeline.md\":\"6US0Wsdc\",\"runbooks_scd2-rehash.md\":\"DtmuXA67\",\"runbooks_sql-task-truncate-swap.md\":\"DAz41942\",\"runbooks_stato-incrementale.md\":\"hGZ8FlbZ\",\"sub-pipelines_readme.md\":\"CF8gmNPU\",\"sub-pipelines_riepilogo-ordini.md\":\"qCBZJ4nh\",\"technical_overview.md\":\"C6HYc5_h\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"it-IT\",\"dir\":\"ltr\",\"title\":\"Noeva ETL\",\"titleTemplate\":\":title · Noeva ETL\",\"description\":\"Documentazione di Noeva ETL: come usare la piattaforma e come creare pipeline con Claude Code.\",\"base\":\"/guida/core/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":{\"light\":\"/logo-dark.png\",\"dark\":\"/logo-light.png\",\"alt\":\"Noeva\"},\"siteTitle\":false,\"footer\":{\"message\":\"Noeva è un marchio registrato di 4D S.R.L.\",\"copyright\":\"© 2026 4D S.R.L. · Gruppo4D\"},\"outline\":{\"level\":[2,3],\"label\":\"In questa pagina\"},\"docFooter\":{\"prev\":\"Pagina precedente\",\"next\":\"Pagina successiva\"},\"darkModeSwitchLabel\":\"Tema\",\"lightModeSwitchTitle\":\"Passa al tema chiaro\",\"darkModeSwitchTitle\":\"Passa al tema scuro\",\"sidebarMenuLabel\":\"Menu\",\"returnToTopLabel\":\"Torna su\",\"langMenuLabel\":\"Lingua\",\"notFound\":{\"title\":\"PAGINA NON TROVATA\",\"quote\":\"Il documento che cercavi non c'è più, o non è mai stato pubblicato qui.\",\"linkLabel\":\"Torna alla home\",\"linkText\":\"Torna alla home\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Cerca\",\"buttonAriaLabel\":\"Cerca nella documentazione\"},\"modal\":{\"displayDetails\":\"Mostra i dettagli\",\"resetButtonTitle\":\"Azzera la ricerca\",\"backButtonTitle\":\"Chiudi la ricerca\",\"noResultsText\":\"Nessun risultato per\",\"footer\":{\"selectText\":\"per aprire\",\"selectKeyAriaLabel\":\"invio\",\"navigateText\":\"per spostarti\",\"navigateUpKeyAriaLabel\":\"freccia su\",\"navigateDownKeyAriaLabel\":\"freccia giù\",\"closeText\":\"per chiudere\",\"closeKeyAriaLabel\":\"esc\"}}}}},\"nav\":[{\"text\":\"Usare\",\"link\":\"/guide/usare/\",\"activeMatch\":\"^/guide/usare/\"},{\"text\":\"Creare con Claude Code\",\"link\":\"/guide/claude-code/\",\"activeMatch\":\"^/guide/claude-code/\"},{\"text\":\"Riferimento\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Tipi di nodo\",\"link\":\"/nodes/README\"},{\"text\":\"Connettori\",\"link\":\"/connectors/README\"},{\"text\":\"Pipeline pronte\",\"link\":\"/pipelines/README\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"},{\"text\":\"Operatività\",\"link\":\"/runbooks/graph-server\"}]}],\"sidebar\":[{\"text\":\"Usare Noeva ETL\",\"items\":[{\"text\":\"Come si usa\",\"link\":\"/guide/usare/\"},{\"text\":\"L'app desktop\",\"link\":\"/guide/usare/app-desktop\"},{\"text\":\"Leggere l'esito di una run\",\"link\":\"/guide/usare/esito-di-una-run\"},{\"text\":\"Panoramica di prodotto\",\"link\":\"/TECHNICAL_OVERVIEW\"}]},{\"text\":\"Creare con Claude Code\",\"items\":[{\"text\":\"Dal bisogno al processo\",\"link\":\"/guide/claude-code/\"},{\"text\":\"Comporre il prompt\",\"link\":\"/guide/claude-code/prompt\"},{\"text\":\"Skill e subagent\",\"link\":\"/guide/claude-code/strumenti\"},{\"text\":\"Guida allo sviluppo\",\"link\":\"/GUIDA_SVILUPPO\"}]},{\"text\":\"Concetti\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Versioni di pipeline\",\"link\":\"/conventions/versioni-di-pipeline\"},{\"text\":\"Descriptor dei nodi\",\"link\":\"/conventions/node-descriptor\"},{\"text\":\"Colonne dei nodi\",\"link\":\"/conventions/node-columns\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"}]},{\"text\":\"Tipi di nodo\",\"collapsed\":true,\"items\":[{\"text\":\"Cheatsheet\",\"link\":\"/nodes/README\"},{\"text\":\"action\",\"link\":\"/nodes/action\"},{\"text\":\"ai\",\"link\":\"/nodes/ai\"},{\"text\":\"join\",\"link\":\"/nodes/join\"},{\"text\":\"lookup\",\"link\":\"/nodes/lookup\"},{\"text\":\"pipeline\",\"link\":\"/nodes/pipeline\"},{\"text\":\"route\",\"link\":\"/nodes/route\"},{\"text\":\"sink\",\"link\":\"/nodes/sink\"},{\"text\":\"source\",\"link\":\"/nodes/source\"},{\"text\":\"task\",\"link\":\"/nodes/task\"},{\"text\":\"transform\",\"link\":\"/nodes/transform\"},{\"text\":\"try-catch\",\"link\":\"/nodes/try-catch\"},{\"text\":\"union\",\"link\":\"/nodes/union\"}]},{\"text\":\"Connettori\",\"collapsed\":true,\"items\":[{\"text\":\"Panoramica\",\"link\":\"/connectors/README\"},{\"text\":\"Excel\",\"link\":\"/connectors/excel\"},{\"text\":\"File (storage × codec)\",\"link\":\"/connectors/file\"},{\"text\":\"HTTP (API REST per i nodi lookup e action)\",\"link\":\"/connectors/http\"},{\"text\":\"IMAP (caselle di posta)\",\"link\":\"/connectors/imap\"},{\"text\":\"Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)\",\"link\":\"/connectors/jira\"},{\"text\":\"MySQL e MariaDB\",\"link\":\"/connectors/mysql\"},{\"text\":\"Noeva (file dei workspace)\",\"link\":\"/connectors/noeva\"},{\"text\":\"OAuth2 per i connettori\",\"link\":\"/connectors/oauth\"},{\"text\":\"Odoo (record di un modello, con i campi dichiarati)\",\"link\":\"/connectors/odoo\"},{\"text\":\"PostgreSQL\",\"link\":\"/connectors/postgres\"},{\"text\":\"processo esterno\",\"link\":\"/connectors/process\"},{\"text\":\"SendGrid (mail via API REST)\",\"link\":\"/connectors/sendgrid\"},{\"text\":\"SMTP (notifiche email)\",\"link\":\"/connectors/smtp\"},{\"text\":\"SQL Server\",\"link\":\"/connectors/sqlserver\"},{\"text\":\"Zoho CRM (record di un modulo, con i campi dichiarati)\",\"link\":\"/connectors/zoho\"}]},{\"text\":\"Pipeline pronte\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una pipeline\",\"link\":\"/pipelines/README\"},{\"text\":\"test-posta\",\"link\":\"/pipelines/test-posta\"}]},{\"text\":\"Esempi\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una sub-pipeline\",\"link\":\"/sub-pipelines/README\"},{\"text\":\"crm-leads-sync\",\"link\":\"/pipelines/crm-leads-sync\"},{\"text\":\"cross-workspace-csv-merge\",\"link\":\"/pipelines/cross-workspace-csv-merge\"},{\"text\":\"movimenti-per-conto\",\"link\":\"/pipelines/movimenti-per-conto\"},{\"text\":\"orders-enriched-daily\",\"link\":\"/pipelines/orders-enriched-daily\"},{\"text\":\"riepilogo-ordini\",\"link\":\"/sub-pipelines/riepilogo-ordini\"}]},{\"text\":\"Operatività\",\"collapsed\":true,\"items\":[{\"text\":\"aggiornare un deploy PM2 di un repo cliente\",\"link\":\"/runbooks/aggiornamento-pm2\"},{\"text\":\"un cliente su ECR + ECS\",\"link\":\"/runbooks/deploy-ecr\"},{\"text\":\"distribuzione del runner ETL\",\"link\":\"/runbooks/deployment\"},{\"text\":\"worker etl worker (polling su processes)\",\"link\":\"/runbooks/etl-worker\"},{\"text\":\"operazioni distruttive di excelSink\",\"link\":\"/runbooks/excel-operazioni-distruttive\"},{\"text\":\"server grafi etl serve (HTTP)\",\"link\":\"/runbooks/graph-server\"},{\"text\":\"chiavi di mask (creazione, rotazione, compromissione)\",\"link\":\"/runbooks/mask-key\"},{\"text\":\"OAuth2 per una casella Google (IMAP + SMTP)\",\"link\":\"/runbooks/oauth-google-posta\"},{\"text\":\"rollback di una pipeline\",\"link\":\"/runbooks/rollback-di-pipeline\"},{\"text\":\"rehash di una dimensione storicizzata\",\"link\":\"/runbooks/scd2-rehash\"},{\"text\":\"task SQL, truncate e scambio di tabelle\",\"link\":\"/runbooks/sql-task-truncate-swap\"},{\"text\":\"stato di pipeline e watermark\",\"link\":\"/runbooks/stato-incrementale\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
227
227
 
228
228
  </body>
229
229
  </html>