# 2023 12 05 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.8.4           | 5th December 2023 |

**Patchworks dashboard (frontend)**

| Release version | Release date      |
| --------------- | ----------------- |
| 1.6.3           | 5th December 2023 |

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

* [General](#general)
* [Process flows](#process-flows)
* [Connectors & instances](#connectors-and-instances)
* [Dashboard UI](#dashboard-ui)
* [Prebuilt connectors](#prebuilt-connectors)

## General

<table><thead><tr><th width="180">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>Ref #</th></tr></thead><tbody><tr><td><span data-option="edbc33cea7f34e16b3a205c7a65c3172">New</span></td><td><strong>Patchworks marketplace</strong><br>The Patchworks marketplace is now your one-stop stop for all resources that you may want to install to streamline your integrations. You can now browse and install apps, connectors, process flows, and cross-reference lookups.<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="../../marketplace/the-patchworks-marketplace">The Patchworks marketplace</a></td><td>CPT-1576</td></tr><tr><td><span data-option="edbc33cea7f34e16b3a205c7a65c3172">New</span></td><td><strong>Patchworks apps</strong><br>This release introduced apps - install everything you need (connectors, process flows, scripts, etc.) to perform a specific task.<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="../../marketplace/the-patchworks-marketplace">The Patchworks marketplace</a></td><td>CPT-1576</td></tr></tbody></table>

## Process flows

<table><thead><tr><th width="180">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>Ref #</th></tr></thead><tbody><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>Forward slashes in cache keys</strong><br>Fixed issue where the forward slash character was not permitted when defining cache keys.<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">Cache shapes</a></td><td>CPT-1524</td></tr><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>Incorrect mapping structure</strong><br>Fixed issue where mapping a flat array to an indexed array resulted in an incorrect structure.<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">Map shape</a></td><td>CPT-1524</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Filter logs by process flow</strong><br>It's now possible to filter process flow run logs by process flow.<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=""> Documentation coming soon</td><td>CPT-905</td></tr><tr><td><span data-option="d8457d8925c74fab90fa132d141b764b">Update</span></td><td><strong>All shapes now support manual input for payload fields</strong><br>All shapes have been updated to include a manual input option wherever the user has the option to select a payload field.<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">Shapes</a></td><td>CPT-1419</td></tr><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>Empty payloads</strong><br>Fixed issue passing 'empty' payloads into a shape (which can happen if a null is returned from a script, or if a cache expires). As part of this fix, a new <code>string length</code> option is available on the filter shape.<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/filter-shape">The filter shape</a></td><td>CPT-1763</td></tr><tr><td><span data-option="edbc33cea7f34e16b3a205c7a65c3172">New</span></td><td><strong>Custom string transform now supports payload metadata</strong><br>The custom string field mapping transform now supports payload metadata values using <code>[[meta.unique_key]]</code> syntax. <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/flow-variables/referencing-flow-and-meta-variables-in-mapping-transformations">Referencing flow &#x26; meta variables in mapping transformations</a></td><td>CPT-1440</td></tr><tr><td><span data-option="edbc33cea7f34e16b3a205c7a65c3172">New</span></td><td><strong>Inbound API now supports flow variables</strong><br>When initialising a process flow using the Inbound API, it's now possible to pass in flow 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/managing-process-flows/initialising-a-process-flow-manually-with-a-payload">Initialising a process flow manually with a payload</a></td><td>CPT-1519</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>Ref #</th></tr></thead><tbody><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Installing a connector includes required scripts</strong><br>If a marketplace connector requires pre/post scripts, these are now included when a user chooses to install the connector (previously these would be added manually).<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="../../connectors-and-instances/working-with-connectors/installing-a-connector">Installing a connector</a></td><td>CPT-821</td></tr><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>URL parameters excluded from POST requests</strong><br>Fixed issue where URL parameters were not being passed in POST requests.<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/connector-builder/building-your-own-connector/4-endpoints/endpoint-options/url">URL parameters</a></td><td>CPT-1436</td></tr></tbody></table>

## Dashboard UI

<table><thead><tr><th width="156">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="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td>Field select UI<br>Fixed issue where the dropdown for payload field selection could be partially hidden.</td><td>CPT-35</td></tr></tbody></table>

## Prebuilt connectors

The following prebuilt connectors have been added to the Patchworks marketplace since our previous release:

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Bloomreach Engagement</strong> is an eCommerce platform specialising in marketing automation, product discovery, and content management systems.</td><td></td><td></td><td><a href="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FbfQ8IjJXFFbcGphQyWU3%2Fbloomreach.svg?alt=media&#x26;token=77abdca0-08ce-49fd-bd8a-fb12e7ee73d2">bloomreach.svg</a></td><td><a href="../../connectors-and-instances/patchworks-connectors/bloomreach-engagement-prebuilt-connector">bloomreach-engagement-prebuilt-connector</a></td></tr><tr><td><strong>EKM Insight</strong> is a leading managed print service (MPS) software supplier, helping customers optimise their print and imaging operations.</td><td></td><td></td><td><a href="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FclOgJBjEB3IC61rdwpT8%2FEKM.svg?alt=media&#x26;token=5f451c34-834e-446d-bb53-dae06f2946ce">EKM.svg</a></td><td><a href="../../connectors-and-instances/patchworks-connectors/ekm-insight-prebuilt-connector">ekm-insight-prebuilt-connector</a></td></tr><tr><td><strong>Gorgias</strong> is a customer support platform built for e-commerce companies.</td><td></td><td></td><td><a href="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FL8S3zfffO1lm8s5LyH6d%2FGorgias.svg?alt=media&#x26;token=e7456395-8d58-44d5-9e24-16fb09c2dc56">Gorgias.svg</a></td><td><a href="../../connectors-and-instances/patchworks-connectors/gorgias-prebuilt-connector">gorgias-prebuilt-connector</a></td></tr><tr><td><strong>ShipBob</strong> is a global fulfillment solution used by brands to ship orders from everywhere their customers shop.</td><td></td><td></td><td><a href="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FsQInQNZ4fvOV8gRb7ocm%2Fshipbob.svg?alt=media&#x26;token=839383d9-b3ec-4f97-9cc5-438758ae9d17">shipbob.svg</a></td><td><a href="../../connectors-and-instances/patchworks-connectors/shipbob-prebuilt-connector">shipbob-prebuilt-connector</a></td></tr><tr><td><strong>Snowflake</strong> provides a single platform for data warehousing, data lakes, data engineering, etc., with secure sharing and consumption of real-time / shared data.</td><td></td><td></td><td><a href="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FITbWg8KztgojAtp6DrhZ%2Fsnowflake.svg?alt=media&#x26;token=a3ec3290-2593-46c3-9986-901092ba22e8">snowflake.svg</a></td><td><a href="../../connectors-and-instances/patchworks-connectors/snowflake-prebuilt-connector">snowflake-prebuilt-connector</a></td></tr><tr><td><strong>Stok.ly</strong> provides seamless, multi-channel and multi-location order and warehouse management for retailers and wholesalers. </td><td></td><td></td><td><a href="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2Fj106krpVUVKxZemAPydS%2Fstockly.svg?alt=media&#x26;token=4e04975c-349d-4236-a8d6-b93b9b6051a0">stockly.svg</a></td><td><a href="../../connectors-and-instances/patchworks-connectors/stok.ly-prebuilt-connector">stok.ly-prebuilt-connector</a></td></tr><tr><td><strong>Virtualstock</strong> is Europe's largest drop-shipping and curated marketplace SaaS (software-as-a-service) platform.</td><td></td><td></td><td><a href="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FrSxulQmFAsYJeMbxEUQF%2Fvirtualstock.svg?alt=media&#x26;token=ebbea7b7-8cbb-4089-83d2-7e287da895e9">virtualstock.svg</a></td><td><a href="../../connectors-and-instances/patchworks-connectors/virtualstock-prebuilt-connector">virtualstock-prebuilt-connector</a></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.wearepatchworks.com/product-documentation/release-information/core-release-notes/2023-12-05-release-notes-core.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
