# 2023 09 21 release notes (core)

## Release summary

The information detailed on this page refers to updates included in the following releases to the Patchworks Production environment:

**Patchworks core (backend)**

| Release version | Release date        |
| --------------- | ------------------- |
| 1.6.8           | 21st September 2023 |

**Patchworks dashboard (frontend)**

| Release version | Release date        |
| --------------- | ------------------- |
| 1.5.12          | 21st September 2023 |

New features, updates, and enhancements of note are summarised by product area, below:

* [Process flows](#process-flows)
* [Custom scripts](#custom-scripts)
* [Connectors & instances](#connectors-and-instances)
* [Prebuilt connectors](#prebuilt-connectors)

## Process flows

<table><thead><tr><th>Type<select><option value="edbc33cea7f34e16b3a205c7a65c3172" label="New" color="blue"></option><option value="d8457d8925c74fab90fa132d141b764b" label="Update" color="blue"></option><option value="030babd6286a4fe19214da74af9afb98" label="Enhancement" color="blue"></option><option value="9a29ee576f43448f9b1623baca59c3db" label="Bug" color="blue"></option></select></th><th width="388">Summary</th><th>Version &#x26; Ref #</th></tr></thead><tbody><tr><td><span data-option="edbc33cea7f34e16b3a205c7a65c3172">New</span></td><td><strong>All-new dashboard home/overview page</strong><br>The dashboard home page has been overhauled - now you have more information at your fingertips to see how your process flows are performing and any actions required.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&#x26;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""><a href="../../process-flows/the-process-flows-overview-page">The process flow home page</a></td><td>Core 1.6.8<br>Dashboard 1.5.12<br>CPT-234</td></tr><tr><td><span data-option="edbc33cea7f34e16b3a205c7a65c3172">New</span></td><td><strong>Tracked data</strong><br>When field tags are applied for the data schema associated with a connector endpoint, you can now choose if the field should be ‘tracked’.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&#x26;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""><a href="../../../process-flows/the-process-flows-overview-page#about-tracked-fields">About tracked fields</a></td><td>Core 1.6.8<br>CPT-975</td></tr><tr><td><span data-option="edbc33cea7f34e16b3a205c7a65c3172">New</span></td><td><strong>Process flow run failure email notifications</strong><br>You can now associate a notification group with a process flow so recipients receive an email notification in the event that a process flow run fails.<br><a href="../../process-flows/error-reporting-and-exception-handling/run-logs-and-queue"><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&#x26;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt="" data-size="original"></a><a href="../../process-flows/error-reporting-and-exception-handling/email-notifications-for-failed-process-flow-runs">Email notifications for process flow run failures</a></td><td>Core 1.6.8<br>Dashboard 1.5.12<br>CPT-125</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Lookup cache transform now accepts incoming transform value as the cache key</strong><br>When defining a lookup cache transform function you can now use the output from multi-stage transform as the key for the cache lookup.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&#x26;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""><a href="../../../process-flows/building-process-flows/process-flow-shapes/advanced-shapes/cache/referencing-a-cache-in-mapping-transformations#using-output-from-a-transform-as-the-lookup-cache-key">Using output from a transform as the lookup cache key</a></td><td>Core 1.6.8<br>CPT-767</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Allow payload variables to be sourced from metadata</strong> <br>It's now possible to target payload metadata in variables. <br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&#x26;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""><a href="../../../process-flows/building-process-flows/dynamic-variables/payload-variables#variables-and-parameters-from-payload-metadata">Variables &#x26; parameters from payload metadata</a></td><td>Core 1.6.8<br>CPT-780</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Run logs now show incoming payload from a webhook or inbound API call</strong><br>If a process flow receives data from a trigger webhook or an inbound API call, the associated payload can now be viewed in run logs.<br><a href="../../process-flows/error-reporting-and-exception-handling/run-logs-and-queue"><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&#x26;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt="">Retrospective run logs</a></td><td>Core 1.6.8<br>Dashboard 1.5.12<br>CPT-753</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Real-time run logs now show body content for connection requests &#x26; responses</strong><br>The request and response tabs for real-time logs now show associated body content for a connection.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&#x26;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""><a href="../../process-flows/error-reporting-and-exception-handling/real-time-run-logs">Real-time run logs</a></td><td>Core 1.6.8<br>Dashboard 1.5.12<br>CPT-924</td></tr><tr><td><span data-option="d8457d8925c74fab90fa132d141b764b">Update</span></td><td><strong>Retrospective run logs now show the last seven days by default</strong><br>When you access run logs, logs for the last 7 days are shown by default (previously the default showed logs for the last 12 hours).<br><a href="../../process-flows/error-reporting-and-exception-handling/run-logs-and-queue"><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&#x26;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt="">Retrospective run logs</a></td><td>Core 1.6.8<br>Dashboard 1.5.12<br>CPT-752</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>The cache retention period can now be defined when a new cache is created</strong><br>When you drop an <em>add to cache</em> shape into a process flow and choose to create a new <em>flow-level</em> or <em>company-level</em> cache, you can now define when that cached data should expire. The maximum retention period is 7 days.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&#x26;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""><a href="../../process-flows/building-process-flows/process-flow-shapes/advanced-shapes/cache/add-to-cache-shape">Add to cache shape</a></td><td>Core 1.6.8<br>Dashboard 1.5.12<br>CPT-870</td></tr><tr><td><span data-option="d8457d8925c74fab90fa132d141b764b">Update</span></td><td><strong>The connector marketplace is now accessible from dashboard navigation bar</strong><br>You can now browse the connector marketplace straight from the left-hand navigation bar, using a new 'marketplace' option.<br><a href="../../process-flows/error-reporting-and-exception-handling/run-logs-and-queue"><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&#x26;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""></a><a href="../../marketplace/the-patchworks-marketplace">The Patchworks marketplace</a></td><td>Dashboard 1.5.12<br>CPT-671</td></tr><tr><td><span data-option="edbc33cea7f34e16b3a205c7a65c3172">New</span></td><td><strong>New transform functions</strong><br>New transform functions include <em>Math</em>, <em>string to number</em>, <em>number to string</em>, <em>boolean to string</em>, and <em>null value</em>. <br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&#x26;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""><a href="../../process-flows/building-process-flows/process-flow-shapes/standard-shapes/map-shape/working-with-field-transformations/available-transform-functions">Available transform functions</a></td><td>Core 1.6.8<br>CPT-903<br>CPT-709</td></tr></tbody></table>

## Custom scripts

<table><thead><tr><th>Type<select><option value="edbc33cea7f34e16b3a205c7a65c3172" label="New" color="blue"></option><option value="d8457d8925c74fab90fa132d141b764b" label="Update" color="blue"></option><option value="030babd6286a4fe19214da74af9afb98" label="Enhancement" color="blue"></option><option value="9a29ee576f43448f9b1623baca59c3db" label="Bug" color="blue"></option></select></th><th width="388">Summary</th><th>Version &#x26; Ref #</th></tr></thead><tbody><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Improved UI</strong> <br>The custom script edit UI has had a facelift, with separate code and test panes. <br><a href="../../process-flows/error-reporting-and-exception-handling/run-logs-and-queue"><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&#x26;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt="" data-size="original"></a><a href="../../developer-hub/custom-scripting/creating-and-testing-custom-scripts">Adding &#x26; testing custom scripts</a></td><td>Core 1.6.8<br>CPT-642</td></tr><tr><td><span data-option="edbc33cea7f34e16b3a205c7a65c3172">New</span></td><td><strong>Variables can now be passed into custom scripts for testing</strong><br>When testing a custom script you can now pass in variables (and flow variables) as well as a payload for testing.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&#x26;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""><a href="../../developer-hub/custom-scripting/creating-and-testing-custom-scripts">Adding &#x26; testing custom scripts</a></td><td>Core 1.6.8<br>CPT-642</td></tr></tbody></table>

## Connectors & instances

<table><thead><tr><th>Type<select><option value="edbc33cea7f34e16b3a205c7a65c3172" label="New" color="blue"></option><option value="d8457d8925c74fab90fa132d141b764b" label="Update" color="blue"></option><option value="030babd6286a4fe19214da74af9afb98" label="Enhancement" color="blue"></option><option value="9a29ee576f43448f9b1623baca59c3db" label="Bug" color="blue"></option></select></th><th width="388">Summary</th><th>Version &#x26; Ref #</th></tr></thead><tbody><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>More information for invalid credentials</strong><br>If credentials cannot be validated when an instance is added, a <em>more details</em> option is provided so you can view the authentication request and response. <br><a href="../../process-flows/error-reporting-and-exception-handling/run-logs-and-queue"><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&#x26;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt="" data-size="original"></a><a href="../../connectors-and-instances/working-with-instances/adding-an-instance">Adding an instance</a></td><td>Core 1.6.8<br>Dashboard 1.5.12<br>CPT-643</td></tr></tbody></table>

## Prebuilt connectors

The following prebuilt connectors have been added to the Patchworks marketplace:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2Frs938CLp6qAKenYihJnX%2Fcybertill2.svg?alt=media&#x26;token=1385e7a3-4a2b-4f8b-97cc-eeba628619b0" alt="" width="76"><figcaption></figcaption></figure> <figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2Fp43z13RT1SiH4bX6Zu1Q%2FDeposco.svg?alt=media&#x26;token=d0103b2a-f61f-49a7-9b06-9dc2f95ef8ba" alt="" width="75"><figcaption></figcaption></figure> <figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FqYA3AGbvds1GZ8Tgyjd2%2Fonbuy.svg?alt=media&#x26;token=0b2db8ae-1ddc-4630-8c8c-bf690b18d729" alt="" width="75"><figcaption></figcaption></figure> <figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FgEezSstIlSu2RXRz5q72%2Fjohnlewis.svg?alt=media&#x26;token=176b9946-10d3-4242-aae1-7ae8dd31c77e" alt="" width="75"><figcaption></figcaption></figure> <figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2Fsa6ROitgYiaIYU0R6zfl%2Frebound.svg?alt=media&#x26;token=4a1258f8-128d-419d-9bc8-743630b1adba" alt="" width="76"><figcaption></figcaption></figure> <figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2Fn74vlmjtXQ3YGxwX49aa%2Fklaviyo.svg?alt=media&#x26;token=61a8bb9f-a8b1-49c0-93ae-fc06f1dab4e2" alt="" width="75"><figcaption></figcaption></figure></div>
