@noeva/etl-core 1.0.0-next.4 → 1.0.0-next.5

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 (137) hide show
  1. package/README.md +2 -1
  2. package/dist/chunk-BVUOUBLW.js +1 -0
  3. package/dist/chunk-CRR3Q2C7.js +2 -0
  4. package/dist/chunk-J3PBMWSP.js +2 -0
  5. package/dist/{chunk-KMUNED7K.js → chunk-LJ7DVP5F.js} +1 -1
  6. package/dist/{chunk-ZBKP2UOF.js → chunk-P6B2KLNJ.js} +2 -2
  7. package/dist/chunk-PKBSETMV.js +2 -0
  8. package/dist/chunk-QPJC4GWR.js +1 -0
  9. package/dist/chunk-RCRMQPFH.js +5 -0
  10. package/dist/chunk-RS5SGDUU.js +1 -0
  11. package/dist/chunk-RWPHH4E2.js +1 -0
  12. package/dist/chunk-SRFFKE5W.js +6 -0
  13. package/dist/chunk-WVODQB6Z.js +1 -0
  14. package/dist/chunk-XZMCC6VQ.js +1 -0
  15. package/dist/chunk-ZCYGHS7P.js +2 -0
  16. package/dist/cli.js +2 -2
  17. package/dist/connector-kit.d.ts +4 -2
  18. package/dist/connector-kit.js +1 -1
  19. package/dist/connectors/file.js +1 -1
  20. package/dist/connectors/http.js +1 -1
  21. package/dist/connectors/imap.js +1 -1
  22. package/dist/connectors/jira.js +2 -2
  23. package/dist/connectors/mail.js +1 -1
  24. package/dist/connectors/noeva.js +1 -1
  25. package/dist/connectors/oauth.js +1 -1
  26. package/dist/connectors/postgres.js +1 -1
  27. package/dist/connectors/sendgrid.js +1 -1
  28. package/dist/connectors/smtp.js +1 -1
  29. package/dist/connectors/sqlserver.js +1 -1
  30. package/dist/connectors/zoho.d.ts +304 -0
  31. package/dist/connectors/zoho.js +2 -0
  32. package/dist/etl.config.js +2 -2
  33. package/dist/guida/404.html +2 -2
  34. package/dist/guida/GUIDA_SVILUPPO.html +6 -6
  35. package/dist/guida/TECHNICAL_OVERVIEW.html +5 -5
  36. package/dist/guida/assets/{GUIDA_SVILUPPO.md.D13C7Zwu.js → GUIDA_SVILUPPO.md.CrN52ZDN.js} +1 -1
  37. package/dist/guida/assets/{TECHNICAL_OVERVIEW.md.DQP0pWc8.js → TECHNICAL_OVERVIEW.md.iD1gDlJY.js} +1 -1
  38. package/dist/guida/assets/{app.CzIZwOrR.js → app.BrI3mcoI.js} +1 -1
  39. package/dist/guida/assets/chunks/@localSearchIndexroot.DjrQYH6x.js +1 -0
  40. package/dist/guida/assets/chunks/{VPLocalSearchBox.Cv9o56BQ.js → VPLocalSearchBox.BlKLVNlB.js} +1 -1
  41. package/dist/guida/assets/chunks/{theme.CsUxYN72.js → theme.Cuah39Zj.js} +2 -2
  42. package/dist/guida/assets/connectors_README.md.BqI2RLCu.js +1 -0
  43. package/dist/guida/assets/connectors_README.md.BqI2RLCu.lean.js +1 -0
  44. package/dist/guida/assets/connectors_oauth.md.BeotXAWb.js +7 -0
  45. package/dist/guida/assets/connectors_oauth.md.BeotXAWb.lean.js +1 -0
  46. package/dist/guida/assets/connectors_zoho.md.BfEzRNZk.js +17 -0
  47. package/dist/guida/assets/connectors_zoho.md.BfEzRNZk.lean.js +1 -0
  48. package/dist/guida/assets/{conventions_node-descriptor.md.D8Si7E2S.js → conventions_node-descriptor.md.MQaGlm8a.js} +1 -1
  49. package/dist/guida/assets/{nodes_source.md.V_vlNfOz.js → nodes_source.md.DP2i3GFv.js} +3 -3
  50. package/dist/guida/assets/{nodes_source.md.V_vlNfOz.lean.js → nodes_source.md.DP2i3GFv.lean.js} +1 -1
  51. package/dist/guida/connectors/README.html +5 -5
  52. package/dist/guida/connectors/file.html +4 -4
  53. package/dist/guida/connectors/http.html +4 -4
  54. package/dist/guida/connectors/imap.html +4 -4
  55. package/dist/guida/connectors/jira.html +4 -4
  56. package/dist/guida/connectors/noeva.html +5 -5
  57. package/dist/guida/connectors/oauth.html +6 -6
  58. package/dist/guida/connectors/postgres.html +5 -5
  59. package/dist/guida/connectors/process.html +4 -4
  60. package/dist/guida/connectors/sendgrid.html +4 -4
  61. package/dist/guida/connectors/smtp.html +4 -4
  62. package/dist/guida/connectors/sqlserver.html +5 -5
  63. package/dist/guida/connectors/zoho.html +43 -0
  64. package/dist/guida/conventions/node-columns.html +4 -4
  65. package/dist/guida/conventions/node-descriptor.html +6 -6
  66. package/dist/guida/conventions/run-report.html +4 -4
  67. package/dist/guida/conventions/run-trace.html +4 -4
  68. package/dist/guida/conventions/variabili-del-core.html +4 -4
  69. package/dist/guida/conventions/versioni-di-pipeline.html +4 -4
  70. package/dist/guida/guide/claude-code/index.html +4 -4
  71. package/dist/guida/guide/claude-code/prompt.html +5 -5
  72. package/dist/guida/guide/claude-code/strumenti.html +4 -4
  73. package/dist/guida/guide/grafo.html +4 -4
  74. package/dist/guida/guide/usare/app-desktop.html +4 -4
  75. package/dist/guida/guide/usare/esito-di-una-run.html +4 -4
  76. package/dist/guida/guide/usare/index.html +4 -4
  77. package/dist/guida/hashmap.json +1 -1
  78. package/dist/guida/index.html +4 -4
  79. package/dist/guida/nodes/README.html +4 -4
  80. package/dist/guida/nodes/action.html +4 -4
  81. package/dist/guida/nodes/ai.html +4 -4
  82. package/dist/guida/nodes/join.html +4 -4
  83. package/dist/guida/nodes/lookup.html +4 -4
  84. package/dist/guida/nodes/pipeline.html +4 -4
  85. package/dist/guida/nodes/route.html +4 -4
  86. package/dist/guida/nodes/sink.html +4 -4
  87. package/dist/guida/nodes/source.html +6 -6
  88. package/dist/guida/nodes/task.html +4 -4
  89. package/dist/guida/nodes/transform.html +4 -4
  90. package/dist/guida/nodes/try-catch.html +4 -4
  91. package/dist/guida/nodes/union.html +4 -4
  92. package/dist/guida/pagine.json +1 -0
  93. package/dist/guida/pipelines/README.html +5 -5
  94. package/dist/guida/pipelines/crm-leads-sync.html +4 -4
  95. package/dist/guida/pipelines/cross-workspace-csv-merge.html +4 -4
  96. package/dist/guida/pipelines/movimenti-per-conto.html +4 -4
  97. package/dist/guida/pipelines/orders-enriched-daily.html +4 -4
  98. package/dist/guida/pipelines/test-posta.html +4 -4
  99. package/dist/guida/runbooks/aggiornamento-pm2.html +4 -4
  100. package/dist/guida/runbooks/deploy-ecr.html +4 -4
  101. package/dist/guida/runbooks/deployment.html +4 -4
  102. package/dist/guida/runbooks/etl-worker.html +4 -4
  103. package/dist/guida/runbooks/graph-server.html +4 -4
  104. package/dist/guida/runbooks/mask-key.html +4 -4
  105. package/dist/guida/runbooks/oauth-google-posta.html +4 -4
  106. package/dist/guida/runbooks/rollback-di-pipeline.html +4 -4
  107. package/dist/guida/runbooks/scd2-rehash.html +4 -4
  108. package/dist/guida/runbooks/sql-task-truncate-swap.html +4 -4
  109. package/dist/guida/runbooks/stato-incrementale.html +4 -4
  110. package/dist/guida/sub-pipelines/README.html +4 -4
  111. package/dist/guida/sub-pipelines/riepilogo-ordini.html +4 -4
  112. package/dist/index.js +1 -1
  113. package/dist/pipelines.js +1 -1
  114. package/dist/testing.js +1 -1
  115. package/kit/skills/etl-graph/references/wiring.md +4 -3
  116. package/kit/skills/new-connector/SKILL.md +1 -1
  117. package/package.json +8 -3
  118. package/dist/chunk-BFW7HTF6.js +0 -2
  119. package/dist/chunk-BPRH262Y.js +0 -2
  120. package/dist/chunk-DPWGI266.js +0 -1
  121. package/dist/chunk-H75NY6Z4.js +0 -1
  122. package/dist/chunk-HMED2UDJ.js +0 -2
  123. package/dist/chunk-MOHJWOCB.js +0 -1
  124. package/dist/chunk-MXSKD3Z4.js +0 -2
  125. package/dist/chunk-PGJWGJEB.js +0 -5
  126. package/dist/chunk-R53642SH.js +0 -1
  127. package/dist/chunk-RU6CZIDB.js +0 -1
  128. package/dist/chunk-UN3BPCPA.js +0 -1
  129. package/dist/chunk-XFHTODDW.js +0 -6
  130. package/dist/guida/assets/chunks/@localSearchIndexroot.08YFQ5n8.js +0 -1
  131. package/dist/guida/assets/connectors_README.md.ChyXSf73.js +0 -1
  132. package/dist/guida/assets/connectors_README.md.ChyXSf73.lean.js +0 -1
  133. package/dist/guida/assets/connectors_oauth.md.DUHajB0u.js +0 -7
  134. package/dist/guida/assets/connectors_oauth.md.DUHajB0u.lean.js +0 -1
  135. /package/dist/guida/assets/{GUIDA_SVILUPPO.md.D13C7Zwu.lean.js → GUIDA_SVILUPPO.md.CrN52ZDN.lean.js} +0 -0
  136. /package/dist/guida/assets/{TECHNICAL_OVERVIEW.md.DQP0pWc8.lean.js → TECHNICAL_OVERVIEW.md.iD1gDlJY.lean.js} +0 -0
  137. /package/dist/guida/assets/{conventions_node-descriptor.md.D8Si7E2S.lean.js → conventions_node-descriptor.md.MQaGlm8a.lean.js} +0 -0
@@ -9,9 +9,9 @@
9
9
  <link rel="preload stylesheet" href="/guida/core/assets/style.BNn_AkzN.css" as="style">
10
10
  <link rel="preload stylesheet" href="/guida/core/vp-icons.css" as="style">
11
11
 
12
- <script type="module" src="/guida/core/assets/app.CzIZwOrR.js"></script>
12
+ <script type="module" src="/guida/core/assets/app.BrI3mcoI.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.CsUxYN72.js">
14
+ <link rel="modulepreload" href="/guida/core/assets/chunks/theme.Cuah39Zj.js">
15
15
  <link rel="modulepreload" href="/guida/core/assets/chunks/framework.qdetmeNX.js">
16
16
  <link rel="modulepreload" href="/guida/core/assets/connectors_sendgrid.md.dJzIWepq.lean.js">
17
17
  <link rel="icon" type="image/svg+xml" href="/guida/core/favicon.svg">
@@ -20,7 +20,7 @@
20
20
  <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
21
21
  </head>
22
22
  <body>
23
- <div id="app"><div class="Layout" data-v-f5dee57d><!--[--><!--]--><!--[--><span tabindex="-1" data-v-93360a68></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-93360a68>Skip to content</a><!--]--><!----><header class="VPNav" data-v-f5dee57d data-v-b9fcca01><div class="VPNavBar" data-v-b9fcca01 data-v-b140bbbf><div class="wrapper" data-v-b140bbbf><div class="container" data-v-b140bbbf><div class="title" data-v-b140bbbf><div class="VPNavBarTitle has-sidebar" data-v-b140bbbf data-v-fa0d91f3><a class="title" href="/guida/core/" data-v-fa0d91f3><!--[--><!--]--><!--[--><!--[--><!--[--><img class="VPImage dark logo" src="/guida/core/logo-light.png" alt="Noeva" data-v-05ca73a1><!--]--><!--[--><img class="VPImage light logo" src="/guida/core/logo-dark.png" alt="Noeva" data-v-05ca73a1><!--]--><!--]--><!--]--><!----><!--[--><!--[--><!--[--><!--[--><span class="etl-wordmark" aria-hidden="true">ETL</span><span class="etl-embedded-title">Documentazione</span><!--]--><!--]--><!--]--><!--]--></a></div></div><div class="content" data-v-b140bbbf><div class="content-body" data-v-b140bbbf><!--[--><!--]--><div class="VPNavBarSearch search" data-v-b140bbbf><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Cerca nella documentazione"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Cerca</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-b140bbbf data-v-bc0c15e0><span id="main-nav-aria-label" class="visually-hidden" data-v-bc0c15e0> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/guida/core/guide/usare/" tabindex="0" data-v-bc0c15e0 data-v-5860da0c><!--[--><span data-v-5860da0c>Usare</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/guida/core/guide/claude-code/" tabindex="0" data-v-bc0c15e0 data-v-5860da0c><!--[--><span data-v-5860da0c>Creare con Claude Code</span><!--]--></a><!--]--><!--[--><div class="VPFlyout VPNavBarMenuGroup" data-v-bc0c15e0 data-v-6f404e8a><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-6f404e8a><span class="text" data-v-6f404e8a><!----><span data-v-6f404e8a>Riferimento</span><span class="vpi-chevron-down text-icon" data-v-6f404e8a></span></span></button><div class="menu" data-v-6f404e8a><div class="VPMenu" data-v-6f404e8a data-v-1bb74cb7><div class="items" data-v-1bb74cb7><!--[--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/guide/grafo" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Il grafo, nodo per nodo</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/nodes/README" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Tipi di nodo</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/connectors/README" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Connettori</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/pipelines/README" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Pipeline pronte</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/conventions/run-report" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Il report di run</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/conventions/run-trace" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>La traccia di una run</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/conventions/variabili-del-core" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Variabili d'ambiente del core</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/runbooks/graph-server" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Operatività</span><!--]--></a></div><!--]--><!--]--></div><!--[--><!--]--></div></div></div><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-b140bbbf data-v-978134ec><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-978134ec data-v-139a0758 data-v-6ae48061><span class="check" data-v-6ae48061><span class="icon" data-v-6ae48061><!--[--><span class="vpi-sun sun" data-v-139a0758></span><span class="vpi-moon moon" data-v-139a0758></span><!--]--></span></span></button></div><!----><div class="VPFlyout VPNavBarExtra extra" data-v-b140bbbf data-v-0ddd3b74 data-v-6f404e8a><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-6f404e8a><span class="vpi-more-horizontal icon" data-v-6f404e8a></span></button><div class="menu" data-v-6f404e8a><div class="VPMenu" data-v-6f404e8a data-v-1bb74cb7><!----><!--[--><!--[--><!----><div class="group" data-v-0ddd3b74><div class="item appearance" data-v-0ddd3b74><p class="label" data-v-0ddd3b74>Tema</p><div class="appearance-action" data-v-0ddd3b74><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-0ddd3b74 data-v-139a0758 data-v-6ae48061><span class="check" data-v-6ae48061><span class="icon" data-v-6ae48061><!--[--><span class="vpi-sun sun" data-v-139a0758></span><span class="vpi-moon moon" data-v-139a0758></span><!--]--></span></span></button></div></div></div><!----><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-b140bbbf data-v-d8d7505f><span class="container" data-v-d8d7505f><span class="top" data-v-d8d7505f></span><span class="middle" data-v-d8d7505f></span><span class="bottom" data-v-d8d7505f></span></span></button></div></div></div></div><div class="divider" data-v-b140bbbf><div class="divider-line" data-v-b140bbbf></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-f5dee57d data-v-cff79b2d><div class="container" data-v-cff79b2d><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-cff79b2d><span class="vpi-align-left menu-icon" data-v-cff79b2d></span><span class="menu-text" data-v-cff79b2d>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-cff79b2d data-v-64e5faff><button data-v-64e5faff>Torna su</button><!----></div></div></div><aside class="VPSidebar" data-v-f5dee57d data-v-24ac7daa><div class="curtain" data-v-24ac7daa></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-24ac7daa><span class="visually-hidden" id="sidebar-aria-label" data-v-24ac7daa> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Usare Noeva ETL</h2><!----></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/usare/" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Come si usa</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/usare/app-desktop" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>L'app desktop</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/usare/esito-di-una-run" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Leggere l'esito di una run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/TECHNICAL_OVERVIEW" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Panoramica di prodotto</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Creare con Claude Code</h2><!----></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/claude-code/" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Dal bisogno al processo</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/claude-code/prompt" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Comporre il prompt</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/claude-code/strumenti" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Skill e subagent</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/GUIDA_SVILUPPO" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Guida allo sviluppo</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Concetti</h2><!----></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/grafo" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Il grafo, nodo per nodo</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/conventions/run-report" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Il report di run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/conventions/run-trace" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>La traccia di una run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/conventions/versioni-di-pipeline" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Versioni di pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/conventions/node-descriptor" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Descriptor dei nodi</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/conventions/node-columns" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Colonne dei nodi</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/conventions/variabili-del-core" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Variabili d'ambiente del core</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0 collapsible collapsed" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Tipi di nodo</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0fae8093><span class="vpi-chevron-right caret-icon" data-v-0fae8093></span></div></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/README" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Cheatsheet</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/action" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>action</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/ai" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>ai</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/join" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>join</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/lookup" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>lookup</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/pipeline" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/route" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>route</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/sink" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>sink</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/source" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>source</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/task" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>task</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/transform" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>transform</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/try-catch" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>try-catch</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/union" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>union</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0 collapsible collapsed has-active" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Connettori</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0fae8093><span class="vpi-chevron-right caret-icon" data-v-0fae8093></span></div></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/README" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Panoramica</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/file" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>File (storage × codec)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/http" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>HTTP (API REST per i nodi lookup e action)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/imap" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>IMAP (caselle di posta)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/jira" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/noeva" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Noeva (file dei workspace)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/oauth" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>OAuth2 per i connettori di posta</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/postgres" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>PostgreSQL</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/process" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>processo esterno</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/sendgrid" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>SendGrid (mail via API REST)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/smtp" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>SMTP (notifiche email)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/sqlserver" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>SQL Server</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0 collapsible collapsed" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Pipeline pronte</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0fae8093><span class="vpi-chevron-right caret-icon" data-v-0fae8093></span></div></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/pipelines/README" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Le schede di una pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/pipelines/test-posta" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>test-posta</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0 collapsible collapsed" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Esempi</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0fae8093><span class="vpi-chevron-right caret-icon" data-v-0fae8093></span></div></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/sub-pipelines/README" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Le schede di una sub-pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/pipelines/crm-leads-sync" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>crm-leads-sync</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/pipelines/cross-workspace-csv-merge" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>cross-workspace-csv-merge</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/pipelines/movimenti-per-conto" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>movimenti-per-conto</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/pipelines/orders-enriched-daily" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>orders-enriched-daily</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/sub-pipelines/riepilogo-ordini" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>riepilogo-ordini</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0 collapsible collapsed" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Operatività</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0fae8093><span class="vpi-chevron-right caret-icon" data-v-0fae8093></span></div></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/aggiornamento-pm2" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>aggiornare un deploy PM2 di un repo cliente</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/deploy-ecr" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>un cliente su ECR + ECS</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/deployment" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>distribuzione del runner ETL</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/etl-worker" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>worker etl worker (polling su processes)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/graph-server" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>server grafi etl serve (HTTP)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/mask-key" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>chiavi di mask (creazione, rotazione, compromissione)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/oauth-google-posta" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>OAuth2 per una casella Google (IMAP + SMTP)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/rollback-di-pipeline" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>rollback di una pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/scd2-rehash" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>rehash di una dimensione storicizzata</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/sql-task-truncate-swap" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>task SQL, truncate e scambio di tabelle</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/stato-incrementale" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>stato di pipeline e watermark</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-f5dee57d data-v-b2578848><div class="VPDoc has-sidebar has-aside" data-v-b2578848 data-v-303c7d43><!--[--><!--]--><div class="container" data-v-303c7d43><div class="aside" data-v-303c7d43><div class="aside-curtain" data-v-303c7d43></div><div class="aside-container" data-v-303c7d43><div class="aside-content" data-v-303c7d43><div class="VPDocAside" data-v-303c7d43 data-v-50c80a94><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-50c80a94 data-v-ba0e722b><div class="content" data-v-ba0e722b><div class="outline-marker" data-v-ba0e722b></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-ba0e722b>In questa pagina</div><ul class="VPDocOutlineItem root" data-v-ba0e722b data-v-d9a98cc8><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-50c80a94></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-303c7d43><div class="content-container" data-v-303c7d43><!--[--><!--]--><main class="main" data-v-303c7d43><div style="position:relative;" class="vp-doc _guida_core_connectors_sendgrid" data-v-303c7d43><div><h1 id="connettore-sendgrid-mail-via-api-rest" tabindex="-1">Connettore: SendGrid (mail via API REST) <a class="header-anchor" href="#connettore-sendgrid-mail-via-api-rest" aria-label="Permalink to &quot;Connettore: SendGrid (mail via API REST)&quot;">​</a></h1><p>Invia mail con l&#39;<strong>API v3 di SendGrid</strong> (<code>POST /v3/mail/send</code>), con una chiave propria dell&#39;ETL e <code>fetch</code> nativo, senza SDK. Codice in <code>src/connectors/sendgrid/</code>, subpath <code>@noeva/etl-core/connectors/sendgrid</code>; <code>mailAction</code> e <code>mailSink</code> stanno in <code>@noeva/etl-core/connectors/mail</code>. La mail è la stessa del <a href="./smtp">connettore SMTP</a>: una pipeline cambia trasporto cambiando nodo e istanza, non il template.</p><table tabindex="0"><thead><tr><th>Funzione</th><th>Tipo</th><th>Cosa fa</th></tr></thead><tbody><tr><td><code>sendgridAction</code></td><td><code>Action&lt;I, O&gt;</code></td><td>Invia una mail per record e passa avanti il record con l&#39;esito</td></tr><tr><td><code>sendgridSink</code></td><td><code>Sink&lt;T&gt;</code></td><td>Invia una mail per record come ultimo passo; isolabile per record</td></tr></tbody></table><h2 id="configurazione" tabindex="-1">Configurazione <a class="header-anchor" href="#configurazione" aria-label="Permalink to &quot;Configurazione&quot;">​</a></h2><p><code>loadSendgridConfig(prefix?, env?)</code> legge le variabili con prefisso (default <code>SENDGRID_</code>); <code>loadSendgridRegistry(env?)</code> le risolve per istanza: con <code>SENDGRID_INSTANCES=notifiche</code> ogni account ha le sue <code>SENDGRID_&lt;ID&gt;_*</code>, senza lista valgono le variabili base come istanza <code>default</code>. La configurazione si valida all&#39;avvio, e il <code>ConfigError</code> elenca <strong>tutte</strong> le variabili mancanti, mai i valori.</p><table tabindex="0"><thead><tr><th>Variabile</th><th>Default</th><th>Note</th></tr></thead><tbody><tr><td><code>SENDGRID_API_KEY</code></td><td>—</td><td>obbligatoria: una chiave <strong>ristretta al solo Mail Send</strong></td></tr><tr><td><code>SENDGRID_FROM</code></td><td>—</td><td>obbligatorio: <code>x@dominio</code> o <code>Nome &lt;x@dominio&gt;</code>, una Sender Identity</td></tr><tr><td><code>SENDGRID_SANDBOX</code></td><td><code>false</code></td><td><code>true</code> = <code>sandbox_mode</code>: SendGrid valida e risponde <code>200</code>, non spedisce</td></tr><tr><td><code>SENDGRID_BASE_URL</code></td><td><code>https://api.sendgrid.com</code></td><td>per un account EU <code>https://api.eu.sendgrid.com</code>; solo <code>https</code></td></tr></tbody></table><ul><li><strong>Sandbox per le prove</strong>: in locale e in sviluppo <code>SENDGRID_SANDBOX=true</code> controlla mittente, destinatari e corpo senza mandare nulla. L&#39;esito ha <code>sandbox: true</code> e nessun <code>messageId</code>.</li><li><strong>La chiave non esce</strong>: viaggia solo nell&#39;header <code>Authorization</code>. Il descriptor ne dice lo stato e gli errori la tolgono dai messaggi di SendGrid.</li><li><strong>Il mittente non è nella mail</strong>: è <code>SENDGRID_FROM</code> dell&#39;istanza, e un&#39;identità diversa è un&#39;altra istanza.</li></ul><h2 id="la-mail" tabindex="-1">La mail <a class="header-anchor" href="#la-mail" aria-label="Permalink to &quot;La mail&quot;">​</a></h2><p>È la <code>MailInUscita</code> condivisa con SMTP (<code>src/connectors/shared/mail.ts</code>): <code>a</code>, <code>cc</code>, <code>ccn</code>, <code>oggetto</code>, <code>testo</code> e/o <code>html</code>, <code>allegati</code>, <code>rispondiA</code>, <code>chiave</code>. Si valida allo stesso modo prima di partire (vedi <a href="./smtp#la-mail-una-funzione-del-record">smtp.md § La mail</a>): un problema è un <code>ValidationError</code> del record e non parte nessuna richiesta.</p><p>Verso l&#39;API diventa una sola <code>personalization</code> con tutti i destinatari, il testo prima dell&#39;HTML, gli allegati in base64 con <code>disposition: attachment</code>. Della <code>chiave</code> parte solo l&#39;impronta, nel custom arg <code>noeva_chiave</code>: si ritrova nell&#39;Activity e negli eventi di SendGrid e rende riconoscibile un reinvio.</p><h2 id="cambiare-trasporto-da-configurazione" tabindex="-1">Cambiare trasporto da configurazione <a class="header-anchor" href="#cambiare-trasporto-da-configurazione" aria-label="Permalink to &quot;Cambiare trasporto da configurazione&quot;">​</a></h2><p>Per una pipeline che deve poter usare SMTP <strong>o</strong> SendGrid c&#39;è il nodo neutro di <code>src/connectors/mail/</code>: riceve un <code>TrasportoMail</code> (<code>{ tipo: &quot;smtp&quot;, config }</code> o <code>{ tipo: &quot;sendgrid&quot;, config }</code>) e diventa <code>smtpAction</code>/<code>sendgridAction</code> (o i sink), con il loro descriptor e i loro errori. Il <code>merge</code> riceve l&#39;esito comune <code>EsitoInvioMail</code> (<code>messageId?</code>, <code>accettati</code>). Il grafo resta lo stesso, e il trasporto è un valore della configurazione.</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;">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> trasporto</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">:</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> TrasportoMail</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span></span>
23
+ <div id="app"><div class="Layout" data-v-f5dee57d><!--[--><!--]--><!--[--><span tabindex="-1" data-v-93360a68></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-93360a68>Skip to content</a><!--]--><!----><header class="VPNav" data-v-f5dee57d data-v-b9fcca01><div class="VPNavBar" data-v-b9fcca01 data-v-b140bbbf><div class="wrapper" data-v-b140bbbf><div class="container" data-v-b140bbbf><div class="title" data-v-b140bbbf><div class="VPNavBarTitle has-sidebar" data-v-b140bbbf data-v-fa0d91f3><a class="title" href="/guida/core/" data-v-fa0d91f3><!--[--><!--]--><!--[--><!--[--><!--[--><img class="VPImage dark logo" src="/guida/core/logo-light.png" alt="Noeva" data-v-05ca73a1><!--]--><!--[--><img class="VPImage light logo" src="/guida/core/logo-dark.png" alt="Noeva" data-v-05ca73a1><!--]--><!--]--><!--]--><!----><!--[--><!--[--><!--[--><!--[--><span class="etl-wordmark" aria-hidden="true">ETL</span><span class="etl-embedded-title">Documentazione</span><!--]--><!--]--><!--]--><!--]--></a></div></div><div class="content" data-v-b140bbbf><div class="content-body" data-v-b140bbbf><!--[--><!--]--><div class="VPNavBarSearch search" data-v-b140bbbf><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Cerca nella documentazione"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Cerca</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-b140bbbf data-v-bc0c15e0><span id="main-nav-aria-label" class="visually-hidden" data-v-bc0c15e0> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/guida/core/guide/usare/" tabindex="0" data-v-bc0c15e0 data-v-5860da0c><!--[--><span data-v-5860da0c>Usare</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/guida/core/guide/claude-code/" tabindex="0" data-v-bc0c15e0 data-v-5860da0c><!--[--><span data-v-5860da0c>Creare con Claude Code</span><!--]--></a><!--]--><!--[--><div class="VPFlyout VPNavBarMenuGroup" data-v-bc0c15e0 data-v-6f404e8a><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-6f404e8a><span class="text" data-v-6f404e8a><!----><span data-v-6f404e8a>Riferimento</span><span class="vpi-chevron-down text-icon" data-v-6f404e8a></span></span></button><div class="menu" data-v-6f404e8a><div class="VPMenu" data-v-6f404e8a data-v-1bb74cb7><div class="items" data-v-1bb74cb7><!--[--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/guide/grafo" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Il grafo, nodo per nodo</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/nodes/README" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Tipi di nodo</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/connectors/README" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Connettori</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/pipelines/README" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Pipeline pronte</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/conventions/run-report" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Il report di run</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/conventions/run-trace" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>La traccia di una run</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/conventions/variabili-del-core" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Variabili d'ambiente del core</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/runbooks/graph-server" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Operatività</span><!--]--></a></div><!--]--><!--]--></div><!--[--><!--]--></div></div></div><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-b140bbbf data-v-978134ec><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-978134ec data-v-139a0758 data-v-6ae48061><span class="check" data-v-6ae48061><span class="icon" data-v-6ae48061><!--[--><span class="vpi-sun sun" data-v-139a0758></span><span class="vpi-moon moon" data-v-139a0758></span><!--]--></span></span></button></div><!----><div class="VPFlyout VPNavBarExtra extra" data-v-b140bbbf data-v-0ddd3b74 data-v-6f404e8a><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-6f404e8a><span class="vpi-more-horizontal icon" data-v-6f404e8a></span></button><div class="menu" data-v-6f404e8a><div class="VPMenu" data-v-6f404e8a data-v-1bb74cb7><!----><!--[--><!--[--><!----><div class="group" data-v-0ddd3b74><div class="item appearance" data-v-0ddd3b74><p class="label" data-v-0ddd3b74>Tema</p><div class="appearance-action" data-v-0ddd3b74><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-0ddd3b74 data-v-139a0758 data-v-6ae48061><span class="check" data-v-6ae48061><span class="icon" data-v-6ae48061><!--[--><span class="vpi-sun sun" data-v-139a0758></span><span class="vpi-moon moon" data-v-139a0758></span><!--]--></span></span></button></div></div></div><!----><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-b140bbbf data-v-d8d7505f><span class="container" data-v-d8d7505f><span class="top" data-v-d8d7505f></span><span class="middle" data-v-d8d7505f></span><span class="bottom" data-v-d8d7505f></span></span></button></div></div></div></div><div class="divider" data-v-b140bbbf><div class="divider-line" data-v-b140bbbf></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-f5dee57d data-v-cff79b2d><div class="container" data-v-cff79b2d><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-cff79b2d><span class="vpi-align-left menu-icon" data-v-cff79b2d></span><span class="menu-text" data-v-cff79b2d>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-cff79b2d data-v-64e5faff><button data-v-64e5faff>Torna su</button><!----></div></div></div><aside class="VPSidebar" data-v-f5dee57d data-v-24ac7daa><div class="curtain" data-v-24ac7daa></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-24ac7daa><span class="visually-hidden" id="sidebar-aria-label" data-v-24ac7daa> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Usare Noeva ETL</h2><!----></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/usare/" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Come si usa</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/usare/app-desktop" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>L'app desktop</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/usare/esito-di-una-run" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Leggere l'esito di una run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/TECHNICAL_OVERVIEW" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Panoramica di prodotto</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Creare con Claude Code</h2><!----></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/claude-code/" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Dal bisogno al processo</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/claude-code/prompt" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Comporre il prompt</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/claude-code/strumenti" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Skill e subagent</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/GUIDA_SVILUPPO" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Guida allo sviluppo</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Concetti</h2><!----></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/grafo" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Il grafo, nodo per nodo</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/conventions/run-report" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Il report di run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/conventions/run-trace" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>La traccia di una run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/conventions/versioni-di-pipeline" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Versioni di pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/conventions/node-descriptor" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Descriptor dei nodi</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/conventions/node-columns" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Colonne dei nodi</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/conventions/variabili-del-core" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Variabili d'ambiente del core</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0 collapsible collapsed" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Tipi di nodo</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0fae8093><span class="vpi-chevron-right caret-icon" data-v-0fae8093></span></div></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/README" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Cheatsheet</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/action" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>action</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/ai" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>ai</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/join" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>join</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/lookup" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>lookup</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/pipeline" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/route" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>route</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/sink" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>sink</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/source" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>source</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/task" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>task</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/transform" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>transform</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/try-catch" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>try-catch</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/union" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>union</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0 collapsible collapsed has-active" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Connettori</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0fae8093><span class="vpi-chevron-right caret-icon" data-v-0fae8093></span></div></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/README" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Panoramica</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/file" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>File (storage × codec)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/http" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>HTTP (API REST per i nodi lookup e action)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/imap" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>IMAP (caselle di posta)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/jira" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/noeva" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Noeva (file dei workspace)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/oauth" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>OAuth2 per i connettori</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/postgres" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>PostgreSQL</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/process" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>processo esterno</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/sendgrid" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>SendGrid (mail via API REST)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/smtp" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>SMTP (notifiche email)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/sqlserver" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>SQL Server</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/zoho" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Zoho CRM (record di un modulo, con i campi dichiarati)</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0 collapsible collapsed" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Pipeline pronte</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0fae8093><span class="vpi-chevron-right caret-icon" data-v-0fae8093></span></div></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/pipelines/README" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Le schede di una pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/pipelines/test-posta" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>test-posta</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0 collapsible collapsed" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Esempi</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0fae8093><span class="vpi-chevron-right caret-icon" data-v-0fae8093></span></div></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/sub-pipelines/README" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Le schede di una sub-pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/pipelines/crm-leads-sync" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>crm-leads-sync</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/pipelines/cross-workspace-csv-merge" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>cross-workspace-csv-merge</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/pipelines/movimenti-per-conto" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>movimenti-per-conto</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/pipelines/orders-enriched-daily" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>orders-enriched-daily</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/sub-pipelines/riepilogo-ordini" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>riepilogo-ordini</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0 collapsible collapsed" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Operatività</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0fae8093><span class="vpi-chevron-right caret-icon" data-v-0fae8093></span></div></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/aggiornamento-pm2" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>aggiornare un deploy PM2 di un repo cliente</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/deploy-ecr" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>un cliente su ECR + ECS</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/deployment" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>distribuzione del runner ETL</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/etl-worker" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>worker etl worker (polling su processes)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/graph-server" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>server grafi etl serve (HTTP)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/mask-key" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>chiavi di mask (creazione, rotazione, compromissione)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/oauth-google-posta" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>OAuth2 per una casella Google (IMAP + SMTP)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/rollback-di-pipeline" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>rollback di una pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/scd2-rehash" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>rehash di una dimensione storicizzata</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/sql-task-truncate-swap" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>task SQL, truncate e scambio di tabelle</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/stato-incrementale" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>stato di pipeline e watermark</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-f5dee57d data-v-b2578848><div class="VPDoc has-sidebar has-aside" data-v-b2578848 data-v-303c7d43><!--[--><!--]--><div class="container" data-v-303c7d43><div class="aside" data-v-303c7d43><div class="aside-curtain" data-v-303c7d43></div><div class="aside-container" data-v-303c7d43><div class="aside-content" data-v-303c7d43><div class="VPDocAside" data-v-303c7d43 data-v-50c80a94><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-50c80a94 data-v-ba0e722b><div class="content" data-v-ba0e722b><div class="outline-marker" data-v-ba0e722b></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-ba0e722b>In questa pagina</div><ul class="VPDocOutlineItem root" data-v-ba0e722b data-v-d9a98cc8><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-50c80a94></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-303c7d43><div class="content-container" data-v-303c7d43><!--[--><!--]--><main class="main" data-v-303c7d43><div style="position:relative;" class="vp-doc _guida_core_connectors_sendgrid" data-v-303c7d43><div><h1 id="connettore-sendgrid-mail-via-api-rest" tabindex="-1">Connettore: SendGrid (mail via API REST) <a class="header-anchor" href="#connettore-sendgrid-mail-via-api-rest" aria-label="Permalink to &quot;Connettore: SendGrid (mail via API REST)&quot;">​</a></h1><p>Invia mail con l&#39;<strong>API v3 di SendGrid</strong> (<code>POST /v3/mail/send</code>), con una chiave propria dell&#39;ETL e <code>fetch</code> nativo, senza SDK. Codice in <code>src/connectors/sendgrid/</code>, subpath <code>@noeva/etl-core/connectors/sendgrid</code>; <code>mailAction</code> e <code>mailSink</code> stanno in <code>@noeva/etl-core/connectors/mail</code>. La mail è la stessa del <a href="./smtp">connettore SMTP</a>: una pipeline cambia trasporto cambiando nodo e istanza, non il template.</p><table tabindex="0"><thead><tr><th>Funzione</th><th>Tipo</th><th>Cosa fa</th></tr></thead><tbody><tr><td><code>sendgridAction</code></td><td><code>Action&lt;I, O&gt;</code></td><td>Invia una mail per record e passa avanti il record con l&#39;esito</td></tr><tr><td><code>sendgridSink</code></td><td><code>Sink&lt;T&gt;</code></td><td>Invia una mail per record come ultimo passo; isolabile per record</td></tr></tbody></table><h2 id="configurazione" tabindex="-1">Configurazione <a class="header-anchor" href="#configurazione" aria-label="Permalink to &quot;Configurazione&quot;">​</a></h2><p><code>loadSendgridConfig(prefix?, env?)</code> legge le variabili con prefisso (default <code>SENDGRID_</code>); <code>loadSendgridRegistry(env?)</code> le risolve per istanza: con <code>SENDGRID_INSTANCES=notifiche</code> ogni account ha le sue <code>SENDGRID_&lt;ID&gt;_*</code>, senza lista valgono le variabili base come istanza <code>default</code>. La configurazione si valida all&#39;avvio, e il <code>ConfigError</code> elenca <strong>tutte</strong> le variabili mancanti, mai i valori.</p><table tabindex="0"><thead><tr><th>Variabile</th><th>Default</th><th>Note</th></tr></thead><tbody><tr><td><code>SENDGRID_API_KEY</code></td><td>—</td><td>obbligatoria: una chiave <strong>ristretta al solo Mail Send</strong></td></tr><tr><td><code>SENDGRID_FROM</code></td><td>—</td><td>obbligatorio: <code>x@dominio</code> o <code>Nome &lt;x@dominio&gt;</code>, una Sender Identity</td></tr><tr><td><code>SENDGRID_SANDBOX</code></td><td><code>false</code></td><td><code>true</code> = <code>sandbox_mode</code>: SendGrid valida e risponde <code>200</code>, non spedisce</td></tr><tr><td><code>SENDGRID_BASE_URL</code></td><td><code>https://api.sendgrid.com</code></td><td>per un account EU <code>https://api.eu.sendgrid.com</code>; solo <code>https</code></td></tr></tbody></table><ul><li><strong>Sandbox per le prove</strong>: in locale e in sviluppo <code>SENDGRID_SANDBOX=true</code> controlla mittente, destinatari e corpo senza mandare nulla. L&#39;esito ha <code>sandbox: true</code> e nessun <code>messageId</code>.</li><li><strong>La chiave non esce</strong>: viaggia solo nell&#39;header <code>Authorization</code>. Il descriptor ne dice lo stato e gli errori la tolgono dai messaggi di SendGrid.</li><li><strong>Il mittente non è nella mail</strong>: è <code>SENDGRID_FROM</code> dell&#39;istanza, e un&#39;identità diversa è un&#39;altra istanza.</li></ul><h2 id="la-mail" tabindex="-1">La mail <a class="header-anchor" href="#la-mail" aria-label="Permalink to &quot;La mail&quot;">​</a></h2><p>È la <code>MailInUscita</code> condivisa con SMTP (<code>src/connectors/shared/mail.ts</code>): <code>a</code>, <code>cc</code>, <code>ccn</code>, <code>oggetto</code>, <code>testo</code> e/o <code>html</code>, <code>allegati</code>, <code>rispondiA</code>, <code>chiave</code>. Si valida allo stesso modo prima di partire (vedi <a href="./smtp#la-mail-una-funzione-del-record">smtp.md § La mail</a>): un problema è un <code>ValidationError</code> del record e non parte nessuna richiesta.</p><p>Verso l&#39;API diventa una sola <code>personalization</code> con tutti i destinatari, il testo prima dell&#39;HTML, gli allegati in base64 con <code>disposition: attachment</code>. Della <code>chiave</code> parte solo l&#39;impronta, nel custom arg <code>noeva_chiave</code>: si ritrova nell&#39;Activity e negli eventi di SendGrid e rende riconoscibile un reinvio.</p><h2 id="cambiare-trasporto-da-configurazione" tabindex="-1">Cambiare trasporto da configurazione <a class="header-anchor" href="#cambiare-trasporto-da-configurazione" aria-label="Permalink to &quot;Cambiare trasporto da configurazione&quot;">​</a></h2><p>Per una pipeline che deve poter usare SMTP <strong>o</strong> SendGrid c&#39;è il nodo neutro di <code>src/connectors/mail/</code>: riceve un <code>TrasportoMail</code> (<code>{ tipo: &quot;smtp&quot;, config }</code> o <code>{ tipo: &quot;sendgrid&quot;, config }</code>) e diventa <code>smtpAction</code>/<code>sendgridAction</code> (o i sink), con il loro descriptor e i loro errori. Il <code>merge</code> riceve l&#39;esito comune <code>EsitoInvioMail</code> (<code>messageId?</code>, <code>accettati</code>). Il grafo resta lo stesso, e il trasporto è un valore della configurazione.</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;">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> trasporto</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">:</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> TrasportoMail</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span></span>
24
24
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> config.trasportoMail </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">===</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;sendgrid&quot;</span></span>
25
25
  <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> ?</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { tipo: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;sendgrid&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, config: </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">loadSendgridRegistry</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(env).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">get</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;notifiche&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) }</span></span>
26
26
  <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> :</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { tipo: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;smtp&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, config: </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">loadSmtpRegistry</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(env).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">get</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;notifiche&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) };</span></span>
@@ -36,7 +36,7 @@
36
36
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}), { deadLetter })</span></span></code></pre></div><h2 id="sink-—-sendgridsink" tabindex="-1">Sink — <code>sendgridSink</code> <a class="header-anchor" href="#sink-—-sendgridsink" aria-label="Permalink to &quot;Sink — `sendgridSink`&quot;">​</a></h2><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:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">tryCatch</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;esito&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;prova&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
37
37
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sink</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;prova&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sendgridSink</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&lt;</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">Esito</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&gt;(config, { name: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;mail-esito&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, mail: mailEsito }))</span></span>
38
38
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sink</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;prova&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, mailNonInviate, { fromPort: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;catch&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> })</span></span></code></pre></div><p>Implementa <code>loadOne</code>, quindi sotto un <code>try-catch</code> è isolabile per record. Non è <code>retrySafe</code>.</p><h2 id="esito-ed-errori" tabindex="-1">Esito ed errori <a class="header-anchor" href="#esito-ed-errori" aria-label="Permalink to &quot;Esito ed errori&quot;">​</a></h2><table tabindex="0"><thead><tr><th>Risposta</th><th>Che cosa vuol dire</th><th>Effetto</th></tr></thead><tbody><tr><td><code>202</code></td><td>presa in carico</td><td>esito, con <code>messageId</code> da <code>X-Message-Id</code></td></tr><tr><td><code>200</code></td><td>validata in sandbox</td><td>esito con <code>sandbox: true</code></td></tr><tr><td>altro <code>2xx</code></td><td>inatteso per la modalità</td><td>esito, con un avviso <code>sendgrid.esito-inatteso</code></td></tr><tr><td><code>4xx</code> (tranne <code>429</code>)</td><td>richiesta rifiutata</td><td><code>LoadError</code> del record coi messaggi di SendGrid</td></tr><tr><td><code>429</code>, <code>5xx</code></td><td>non presa in carico, da riprovare</td><td>retry con backoff; finiti i tentativi, <code>LoadError</code></td></tr><tr><td>rete, timeout</td><td>la richiesta potrebbe essere arrivata</td><td><code>LoadError</code> del record, <strong>senza</strong> retry</td></tr></tbody></table><ul><li>I messaggi di SendGrid arrivano nel report senza la chiave, senza gli indirizzi (sostituiti da <code>[indirizzo]</code>) e troncati; i <code>campi</code> rifiutati (<code>personalizations.0.to.0.email</code>) stanno nei <code>details</code>.</li><li>Il retry usa <code>withRetry</code> del core: <code>RETRY_SENDGRID</code> è quattro tentativi da 1 a 30 secondi, rispetta <code>Retry-After</code> e si ferma con l&#39;annullamento della run. Si cambia con <code>trasporto: { retry }</code>, si spegne con <code>{ attempts: 1 }</code>. Ogni retry è un log <code>sendgrid.retry</code> con lo status, senza dati della mail.</li><li><code>trasporto: { timeoutMs }</code> cambia il timeout della richiesta (default 30 secondi); <code>trasporto: { fetchImpl }</code> sostituisce <code>fetch</code>, nei test.</li><li>L&#39;annullamento della run si propaga com&#39;è, non diventa un errore del record.</li></ul><h2 id="idempotenza" tabindex="-1">Idempotenza <a class="header-anchor" href="#idempotenza" aria-label="Permalink to &quot;Idempotenza&quot;">​</a></h2><p><strong>Una mail inviata non si ritira</strong>, e un retry della run la rimanda: la difesa è quella di SMTP, l&#39;invio va dopo il passo che fa da commit (vedi <a href="./smtp#idempotenza-dove-metterlo">smtp.md § Idempotenza</a>). Il retry interno dei <code>5xx</code> può, raramente, duplicare una mail che SendGrid aveva preso in carico: è un rischio accettato.</p><h2 id="descriptor-ui-del-dag" tabindex="-1">Descriptor (UI del DAG) <a class="header-anchor" href="#descriptor-ui-del-dag" aria-label="Permalink to &quot;Descriptor (UI del DAG)&quot;">​</a></h2><p>Kind <code>sendgrid</code> per action e sink, con <code>connection</code> = <code>instanceId</code> se passato. Dettagli: <code>mittente</code>, <code>base</code> e <code>sandbox</code>, ognuno con la sua variabile e la sua origine, e in fondo <code>credenziale</code>: <code>API key · impostata</code>, o la variabile che manca. Mai la chiave né i destinatari. Le variabili sono dichiarate in <code>MANIFEST_SENDGRID</code>; per il piano ci sono <code>istanzaSendgridPerIlPiano(id, env)</code> e <code>loadSendgridInstance(id, env)</code>. Per <code>etl env check</code>, <code>istanzaSendgridDichiarata(id)</code> è l&#39;account da passare ad <code>ambienteDellaPipeline</code>: con lo stesso manifest della run il check vede anche <code>SENDGRID_API_KEY</code>, che il piano non mostra.</p><h2 id="test" tabindex="-1">Test <a class="header-anchor" href="#test" aria-label="Permalink to &quot;Test&quot;">​</a></h2><p>Unit colocati in <code>src/connectors/sendgrid/*.test.ts</code> con un <code>fetch</code> finto (<code>fetchSendgridFinto</code> di <code>@noeva/etl-core/testing</code>): invio riuscito, corpo della richiesta, allegati, sandbox, <code>4xx</code> con messaggio leggibile e senza chiave, <code>429</code> e <code>5xx</code> ritentati, rete senza retry, annullamento della run (prima, durante la richiesta, durante l&#39;attesa del retry), istanze con nome e configurazione mancante o non valida. Nessun test d&#39;integrazione: la sandbox vuole una chiave vera.</p></div></div></main><footer class="VPDocFooter" data-v-303c7d43 data-v-64d0b887><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-64d0b887><span class="visually-hidden" id="doc-footer-aria-label" data-v-64d0b887>Pager</span><div class="pager" data-v-64d0b887><a class="VPLink link pager-link prev" href="/guida/core/connectors/process" data-v-64d0b887><!--[--><span class="desc" data-v-64d0b887>Pagina precedente</span><span class="title" data-v-64d0b887>processo esterno</span><!--]--></a></div><div class="pager" data-v-64d0b887><a class="VPLink link pager-link next" href="/guida/core/connectors/smtp" data-v-64d0b887><!--[--><span class="desc" data-v-64d0b887>Pagina successiva</span><span class="title" data-v-64d0b887>SMTP (notifiche email)</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-f5dee57d data-v-e10de3dd><div class="container" data-v-e10de3dd><p class="message" data-v-e10de3dd>Noeva è un marchio registrato di 4D S.R.L.</p><p class="copyright" data-v-e10de3dd>© 2026 4D S.R.L. · Gruppo4D</p></div></footer><!--[--><span hidden></span><!--]--></div></div>
39
- <script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"DUHajB0u\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"ChyXSf73\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"D8Si7E2S\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"D13C7Zwu\",\"guide_claude-code_index.md\":\"CxVSru8e\",\"guide_claude-code_prompt.md\":\"C7uETA9W\",\"guide_claude-code_strumenti.md\":\"BWhQnAlY\",\"guide_grafo.md\":\"Dy8_YMeh\",\"guide_usare_app-desktop.md\":\"CcDu8cJL\",\"guide_usare_esito-di-una-run.md\":\"DkvAOPBE\",\"guide_usare_index.md\":\"BJqi3P7J\",\"index.md\":\"kMhsF-sv\",\"nodes_action.md\":\"DOsTbV-i\",\"nodes_ai.md\":\"CVtP9gEJ\",\"nodes_join.md\":\"DSYbIDG6\",\"nodes_lookup.md\":\"BI8tgBIq\",\"nodes_pipeline.md\":\"DIMlyprm\",\"nodes_readme.md\":\"CHGy_go6\",\"nodes_route.md\":\"Bt9qH6OA\",\"nodes_sink.md\":\"yAf_z4wO\",\"nodes_source.md\":\"V_vlNfOz\",\"nodes_task.md\":\"Dk6VB7as\",\"nodes_transform.md\":\"Bv5fg2Xx\",\"nodes_try-catch.md\":\"DCYydDPm\",\"nodes_union.md\":\"CznVzHTK\",\"pipelines_crm-leads-sync.md\":\"BlZUnxYn\",\"pipelines_cross-workspace-csv-merge.md\":\"CsRE6GNe\",\"pipelines_movimenti-per-conto.md\":\"DRGfO1_5\",\"pipelines_orders-enriched-daily.md\":\"jESRtvBo\",\"pipelines_readme.md\":\"Ee6LS-SU\",\"pipelines_test-posta.md\":\"Cxo_DGBs\",\"runbooks_aggiornamento-pm2.md\":\"f3LAxif4\",\"runbooks_deploy-ecr.md\":\"4jQypInn\",\"runbooks_deployment.md\":\"CsIYRa_5\",\"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\":\"DQP0pWc8\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"it-IT\",\"dir\":\"ltr\",\"title\":\"Noeva ETL\",\"titleTemplate\":\":title · Noeva ETL\",\"description\":\"Documentazione di Noeva ETL: come usare la piattaforma e come creare pipeline con Claude Code.\",\"base\":\"/guida/core/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":{\"light\":\"/logo-dark.png\",\"dark\":\"/logo-light.png\",\"alt\":\"Noeva\"},\"siteTitle\":false,\"footer\":{\"message\":\"Noeva è un marchio registrato di 4D S.R.L.\",\"copyright\":\"© 2026 4D S.R.L. · Gruppo4D\"},\"outline\":{\"level\":[2,3],\"label\":\"In questa pagina\"},\"docFooter\":{\"prev\":\"Pagina precedente\",\"next\":\"Pagina successiva\"},\"darkModeSwitchLabel\":\"Tema\",\"lightModeSwitchTitle\":\"Passa al tema chiaro\",\"darkModeSwitchTitle\":\"Passa al tema scuro\",\"sidebarMenuLabel\":\"Menu\",\"returnToTopLabel\":\"Torna su\",\"langMenuLabel\":\"Lingua\",\"notFound\":{\"title\":\"PAGINA NON TROVATA\",\"quote\":\"Il documento che cercavi non c'è più, o non è mai stato pubblicato qui.\",\"linkLabel\":\"Torna alla home\",\"linkText\":\"Torna alla home\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Cerca\",\"buttonAriaLabel\":\"Cerca nella documentazione\"},\"modal\":{\"displayDetails\":\"Mostra i dettagli\",\"resetButtonTitle\":\"Azzera la ricerca\",\"backButtonTitle\":\"Chiudi la ricerca\",\"noResultsText\":\"Nessun risultato per\",\"footer\":{\"selectText\":\"per aprire\",\"selectKeyAriaLabel\":\"invio\",\"navigateText\":\"per spostarti\",\"navigateUpKeyAriaLabel\":\"freccia su\",\"navigateDownKeyAriaLabel\":\"freccia giù\",\"closeText\":\"per chiudere\",\"closeKeyAriaLabel\":\"esc\"}}}}},\"nav\":[{\"text\":\"Usare\",\"link\":\"/guide/usare/\",\"activeMatch\":\"^/guide/usare/\"},{\"text\":\"Creare con Claude Code\",\"link\":\"/guide/claude-code/\",\"activeMatch\":\"^/guide/claude-code/\"},{\"text\":\"Riferimento\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Tipi di nodo\",\"link\":\"/nodes/README\"},{\"text\":\"Connettori\",\"link\":\"/connectors/README\"},{\"text\":\"Pipeline pronte\",\"link\":\"/pipelines/README\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"},{\"text\":\"Operatività\",\"link\":\"/runbooks/graph-server\"}]}],\"sidebar\":[{\"text\":\"Usare Noeva ETL\",\"items\":[{\"text\":\"Come si usa\",\"link\":\"/guide/usare/\"},{\"text\":\"L'app desktop\",\"link\":\"/guide/usare/app-desktop\"},{\"text\":\"Leggere l'esito di una run\",\"link\":\"/guide/usare/esito-di-una-run\"},{\"text\":\"Panoramica di prodotto\",\"link\":\"/TECHNICAL_OVERVIEW\"}]},{\"text\":\"Creare con Claude Code\",\"items\":[{\"text\":\"Dal bisogno al processo\",\"link\":\"/guide/claude-code/\"},{\"text\":\"Comporre il prompt\",\"link\":\"/guide/claude-code/prompt\"},{\"text\":\"Skill e subagent\",\"link\":\"/guide/claude-code/strumenti\"},{\"text\":\"Guida allo sviluppo\",\"link\":\"/GUIDA_SVILUPPO\"}]},{\"text\":\"Concetti\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Versioni di pipeline\",\"link\":\"/conventions/versioni-di-pipeline\"},{\"text\":\"Descriptor dei nodi\",\"link\":\"/conventions/node-descriptor\"},{\"text\":\"Colonne dei nodi\",\"link\":\"/conventions/node-columns\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"}]},{\"text\":\"Tipi di nodo\",\"collapsed\":true,\"items\":[{\"text\":\"Cheatsheet\",\"link\":\"/nodes/README\"},{\"text\":\"action\",\"link\":\"/nodes/action\"},{\"text\":\"ai\",\"link\":\"/nodes/ai\"},{\"text\":\"join\",\"link\":\"/nodes/join\"},{\"text\":\"lookup\",\"link\":\"/nodes/lookup\"},{\"text\":\"pipeline\",\"link\":\"/nodes/pipeline\"},{\"text\":\"route\",\"link\":\"/nodes/route\"},{\"text\":\"sink\",\"link\":\"/nodes/sink\"},{\"text\":\"source\",\"link\":\"/nodes/source\"},{\"text\":\"task\",\"link\":\"/nodes/task\"},{\"text\":\"transform\",\"link\":\"/nodes/transform\"},{\"text\":\"try-catch\",\"link\":\"/nodes/try-catch\"},{\"text\":\"union\",\"link\":\"/nodes/union\"}]},{\"text\":\"Connettori\",\"collapsed\":true,\"items\":[{\"text\":\"Panoramica\",\"link\":\"/connectors/README\"},{\"text\":\"File (storage × codec)\",\"link\":\"/connectors/file\"},{\"text\":\"HTTP (API REST per i nodi lookup e action)\",\"link\":\"/connectors/http\"},{\"text\":\"IMAP (caselle di posta)\",\"link\":\"/connectors/imap\"},{\"text\":\"Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)\",\"link\":\"/connectors/jira\"},{\"text\":\"Noeva (file dei workspace)\",\"link\":\"/connectors/noeva\"},{\"text\":\"OAuth2 per i connettori di posta\",\"link\":\"/connectors/oauth\"},{\"text\":\"PostgreSQL\",\"link\":\"/connectors/postgres\"},{\"text\":\"processo esterno\",\"link\":\"/connectors/process\"},{\"text\":\"SendGrid (mail via API REST)\",\"link\":\"/connectors/sendgrid\"},{\"text\":\"SMTP (notifiche email)\",\"link\":\"/connectors/smtp\"},{\"text\":\"SQL Server\",\"link\":\"/connectors/sqlserver\"}]},{\"text\":\"Pipeline pronte\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una pipeline\",\"link\":\"/pipelines/README\"},{\"text\":\"test-posta\",\"link\":\"/pipelines/test-posta\"}]},{\"text\":\"Esempi\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una sub-pipeline\",\"link\":\"/sub-pipelines/README\"},{\"text\":\"crm-leads-sync\",\"link\":\"/pipelines/crm-leads-sync\"},{\"text\":\"cross-workspace-csv-merge\",\"link\":\"/pipelines/cross-workspace-csv-merge\"},{\"text\":\"movimenti-per-conto\",\"link\":\"/pipelines/movimenti-per-conto\"},{\"text\":\"orders-enriched-daily\",\"link\":\"/pipelines/orders-enriched-daily\"},{\"text\":\"riepilogo-ordini\",\"link\":\"/sub-pipelines/riepilogo-ordini\"}]},{\"text\":\"Operatività\",\"collapsed\":true,\"items\":[{\"text\":\"aggiornare un deploy PM2 di un repo cliente\",\"link\":\"/runbooks/aggiornamento-pm2\"},{\"text\":\"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>
39
+ <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\":\"CxVSru8e\",\"guide_claude-code_prompt.md\":\"C7uETA9W\",\"guide_claude-code_strumenti.md\":\"BWhQnAlY\",\"guide_grafo.md\":\"Dy8_YMeh\",\"guide_usare_app-desktop.md\":\"CcDu8cJL\",\"guide_usare_esito-di-una-run.md\":\"DkvAOPBE\",\"guide_usare_index.md\":\"BJqi3P7J\",\"index.md\":\"kMhsF-sv\",\"nodes_action.md\":\"DOsTbV-i\",\"nodes_ai.md\":\"CVtP9gEJ\",\"nodes_join.md\":\"DSYbIDG6\",\"nodes_lookup.md\":\"BI8tgBIq\",\"nodes_pipeline.md\":\"DIMlyprm\",\"nodes_readme.md\":\"CHGy_go6\",\"nodes_route.md\":\"Bt9qH6OA\",\"nodes_sink.md\":\"yAf_z4wO\",\"nodes_source.md\":\"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\":\"f3LAxif4\",\"runbooks_deploy-ecr.md\":\"4jQypInn\",\"runbooks_deployment.md\":\"CsIYRa_5\",\"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\":\"iD1gDlJY\"}");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>
40
40
 
41
41
  </body>
42
42
  </html>