# 2022 10 10 release notes (dashboard)

## Introduction <a href="#introduction" id="introduction"></a>

This page summarises release information for the Patchworks release to Production dated: **10th October 2022**.

## New features <a href="#updated-connectors" id="updated-connectors"></a>

### ​Troubleshoot services

A new **run service** tab is available within a service, to help admin users troubleshoot sync queries. Here, you can define a range of settings to run a service manually and work with the results:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FSUtNipCVekU16GXDK8xw%2Frun%20service%20-%20full%20page%20with%20service%20log%20-%20no%20JSON%20editor.png?alt=media&#x26;token=32405163-1ad8-4700-b6f9-c930398ee94d" alt=""><figcaption></figcaption></figure>

You can enter **specific ids** to be pulled, **define filters** and set from/to options to determine how the service should run.

Options are available to **stop the service run before the push phase** and/or to **force a push** irrespective of any retry limits that may be set. Another really useful setting is the ability to download payloads for the push and pull operations:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FqNDWpjakKUSTpyOfh3dk%2Frun%20service%20-%20payload%20options.png?alt=media&#x26;token=e5bfe5f9-8ea0-4f9b-961b-8cc288dfbc7c" alt=""><figcaption></figcaption></figure>

If these options are set, download options are displayed in the service log (which auto-refreshes every 5 seconds) when the run completes.

{% hint style="warning" %}
This tab is only available for **admin users**.
{% endhint %}

{% hint style="info" %}
Please see the [How to run a service manually](https://doc.wearepatchworks.com/product-documentation/release-information/tapestry-release-notes/broken-reference) page in our product documentation for more information on this feature.
{% endhint %}

### Service notes

It's now possible to add notes for a service - select the required service, access the **settings** tab and scroll down to the **service notes** panel:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FfqV1ruhrvtUcjZKK97P2%2Fservice%20notes%20annotated%20on%20full%20page%20-%20client%20admin.png?alt=media&#x26;token=d9336efb-3c92-4cf0-a533-ba0ddfbfe472" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Please see the [service notes](#service-notes) page in our product documentation for more information on this feature.
{% endhint %}

### Clone service

If you need to add a service with similar attributes to one that already exists, it's now possible to clone an existing service:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FmPexuRKjierdUow7cmrq%2Fcloned%20service%20full%20client%20admin%20user.png?alt=media&#x26;token=b54db998-5b32-471a-bbdf-c684e809bf1d" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Please see the [cloning an existing service](https://doc.wearepatchworks.com/product-documentation/release-information/tapestry-release-notes/broken-reference) page in our product documentation for more information on this feature.
{% endhint %}

### Stop a running sync from the services list

It's now possible to stop a running sync from the service **summary** tab:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FODGRdrvO1VgSnaz9930h%2Fstop%20running%20service%20no%20headings.png?alt=media&#x26;token=cf1ce8c8-a4e5-4d76-a1ae-0486aca5e3b2" alt=""><figcaption></figcaption></figure>

### Sync failure email notifications

A daily 'sync failure' email can now be sent to defined recipients for example:\
\
![](https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FDcoK0BHcXlfiiJJHcoCX%2Fsync%20failure%20sample%20email.png?alt=media\&token=8f583891-03f5-4380-8fda-2dd09e25e454)

Optionally, these emails can include a preview of the [sync report](https://doc.wearepatchworks.com/product-documentation/release-information/tapestry-release-notes/broken-reference), displaying up to 50 failures. Whether or not these emails include a preview of the sync report can be set at the service level, via the **alerts** tab:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FvCDl4xo4Pj1d4prk9rz8%2Fservices%20alerts%20tab%20-%20toggle%20failures%20preview.png?alt=media&#x26;token=08fd0937-1d77-490e-9fa8-76b463ac2776" alt=""><figcaption></figcaption></figure>

To receive these emails, recipients must be added to a [notification group](https://doc.wearepatchworks.com/product-documentation/general-settings/notification-groups) and then this group must be added to your [company profile](https://doc.wearepatchworks.com/product-documentation/company-management/accessing-your-company-profile).&#x20;

{% hint style="info" %}
Please see the [sync failure email notifications](https://doc.wearepatchworks.com/product-documentation/release-information/tapestry-release-notes/broken-reference) page in our product documentation for more information on this feature.
{% endhint %}

### Connector health check

When working with a connector you can check its current status from the **summary** tab: :

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FKtYgD8ZVChKFHZQJ9RE5%2Fconnector%20health%20check%20example%20-%20full.png?alt=media&#x26;token=b7c9e177-0339-43cd-bdff-b1bcecb17c01" alt=""><figcaption></figcaption></figure>

Possible connector statuses are:

| Status                | Summary                                                                |
| --------------------- | ---------------------------------------------------------------------- |
| Connector Operational | The system can be reached and authenticated with the details provided. |
| System Unreachable    | The URL provided for this connector cannot be reached.                 |
| Failed Authentication | Authentication cannot be completed using the details provided.         |

{% hint style="info" %}
Please see the [anatomy of a connector](https://doc.wearepatchworks.com/product-documentation/release-information/tapestry-release-notes/broken-reference) page in our product documentation for more information on this feature.
{% endhint %}

### My company profile

Accessing your company details (including [groups](https://doc.wearepatchworks.com/product-documentation/release-information/tapestry-release-notes/broken-reference) and [users](https://doc.wearepatchworks.com/product-documentation/users-roles-and-permissions/updating-general-details-for-an-existing-user-account)) is now easier, via a new **my company profile** option in **settings**:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FFiSQHaN1BFFeyz2qOBUF%2Fmy%20company%20profile%20journey.png?alt=media&#x26;token=58ad2732-90f8-4429-9b1a-e5b5d7891ff6" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Please see the [accessing your company profile](https://doc.wearepatchworks.com/product-documentation/company-management/accessing-your-company-profile) page in our product documentation for more information on this feature.
{% endhint %}

### Welcome email messages

Two new 'welcome' emails have been added in this release:

* When a new company registration is completed for Patchworks, a welcome email is sent to the person who completed the registration.
* When a new user is added to their company's Patchworks system, they will receive a welcome email which includes a link to set their own password.

## Updated features <a href="#updated-connectors" id="updated-connectors"></a>

### Service list improvements

The **services list** now identifies **sweeper** and **standard** services:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FK6l1HqH2UDGYuVXDth8E%2Fservices%20with%20sweeper%20annotated%20-%20cropped.png?alt=media&#x26;token=39f7d9ef-3068-483b-8d36-8e2997c527c1" alt=""><figcaption></figcaption></figure>

It also includes a separate category for **other** services - these are custom services that Patchworks set up for clients, typically for cases where clients need to integrate a system that's not available in the dashboard:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FPfaANmNfJNB6QumfTaOf%2Fother%20services.png?alt=media&#x26;token=3e6f2b73-99b2-484d-adf4-635ac2bcacb1" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Please see the [services list](https://doc.wearepatchworks.com/product-documentation/release-information/tapestry-release-notes/broken-reference) page in our product documentation for more information on this feature.
{% endhint %}

### Service summary tab includes pending & running syncs

**Running** and **pending** entries are now included in the sync list, on service **summary** tabs:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FxI6DWqwwdZVhv9aGAaDl%2Fservice%20summary%20sync%20list%20pull%20and%20push.png?alt=media&#x26;token=ac7b05f2-d95e-4818-9a4e-62a4ffc65ef9" alt=""><figcaption></figcaption></figure>

### Service logs&#x20;

#### New columns for the service summary sync list

When viewing [summary logs for a service](https://doc.wearepatchworks.com/product-documentation/release-information/tapestry-release-notes/broken-reference), you will now see **total count** and **processed count** columns - for example:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FAMmf9HFM4ZOhttPAB9qc%2Fservice%20summary%20syncs%20new%20columns%20annotated.png?alt=media&#x26;token=a7965849-a650-4a7e-9b27-5736ff54119f" alt=""><figcaption></figcaption></figure>

The **total count** is the number of records retrieved from the source for processing and the **processed count** is the number of records actually processed by the sync.&#x20;

These numbers may vary for a number of reasons. For example, if a service is run manually with filters to pull all records from the last hour but a scheduled sync completed ten minutes previously, the manual sync will contain records that have already been processed so they won't be processed again.

#### Enhanced detailed logs

[Detailed service logs](https://doc.wearepatchworks.com/product-documentation/release-information/tapestry-release-notes/broken-reference) have been improved to show more information, with auto-refresh every five seconds. This means that if you access a log for a service that's running, you have a live view of the sync:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FbyR1nxQAdjmEMzSjtDYR%2Fview%20logs%20with%20autorefresh.png?alt=media&#x26;token=643b10e1-e9cd-4599-ba56-a4e1834adfad" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Please see the [service sync log](https://doc.wearepatchworks.com/product-documentation/release-information/tapestry-release-notes/broken-reference)s page in our product documentation for more information on this feature.
{% endhint %}

### Field mappings

#### Improved mapping page layout

The service [field mapping page](https://doc.wearepatchworks.com/product-documentation/release-information/tapestry-release-notes/broken-reference) is now easier to use, with fields displayed in logical categories based on the **destination** connector - for example:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FN7Z7rOpIwiLV6NqopoyA%2Ffield%20mapping%20page%20categories%20NEW.png?alt=media&#x26;token=a53ce5a8-276c-47b0-868d-abd3ffc0dc82" alt=""><figcaption></figcaption></figure>

When a new row is added, it is shown in a **new** section at the end of the page, so you can see what's been added at a glance:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FUpxPdH3AzhbKi2lxesdE%2Fnew%20section.png?alt=media&#x26;token=9bdd2f37-5530-475c-b020-e82caac1a9dc" alt=""><figcaption></figcaption></figure>

...when mappings are saved, all new items take their natural place in the list.&#x20;

#### Mapping transforms can now be created without a source field

A transform can now be added for a field mapping without the need for a **source** field to be present. This is useful for cases where a value needs to be passed to a destination system but there is no relationship with a source field. For example:&#x20;

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F0fFYBwLZlgRk4GhrD6Di%2Fno%20source%20required.png?alt=media&#x26;token=aff2c04c-4268-45e2-bd4f-3aa8839cc22c" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Please see the [field mappings](https://doc.wearepatchworks.com/product-documentation/release-information/tapestry-release-notes/broken-reference) page in our product documentation for more information on this feature.
{% endhint %}

### Password validation

Password validation now includes checks to determine if the password specified for registration or reset is compromised.&#x20;

Checks are made using the **haveibeenpwned.com** service with the **k-anonymity** model, to determine if a password has been leaked.

If a specified password is found to be compromised, it cannot be used and you will be prompted to try again. &#x20;

## New connectors

#### Sitoo

<table><thead><tr><th width="374">Push to other systems</th><th width="374">Pull from other systems</th></tr></thead><tbody><tr><td>Fulfillments</td><td>Orders</td></tr></tbody></table>

## Bug fixes <a href="#updated-connectors" id="updated-connectors"></a>

<table><thead><tr><th width="204">Affected feature</th><th width="407">Summary</th><th>Patchworks #</th></tr></thead><tbody><tr><td>Password validation</td><td><p>Password validation was not working as expected. This is now fixed and the following rules apply:</p><ul><li>A minimum length of 8 characters </li><li>At least 1 lowercase letter (a - z) </li><li>At least 1 uppercase letter (A - Z) </li><li>At least 1 number (0 - 9) </li><li>At least 1 special character (!, $, #, or %)</li></ul></td><td>TSYS-1794, 1795 </td></tr><tr><td>Dropdown behaviour</td><td>In some circumstances, dropdown lists were not behaving correctly.</td><td>TSYS-2173</td></tr></tbody></table>