A prebuilt process can include any number/combination of the following components:
As you browse the process flows marketplace, you'll see that each process flow is displayed with a visual summary of what's included - for example:
For more information about this summary please see The Patchworks marketplace.
To see a read-only view of a process flow before it's installed, find the required process flow in the marketplace and click the associated view button:
The process flow is displayed in read-only mode, with a breakdown of its components:
When working with Patchworks process flows, there are two possible paths:
Install prebuilt process flows from the Patchworks marketplace
Build your own process flows to meet more specific requirements
This section includes information for prebuilt process flows. If you want to build your own (or update a prebuilt process flow that you've installed), please see our section.
You can browse and install available prebuilt process flows from the :
All connectors used in process flows are installed, without instances. If the process flow which includes a connector that you have already installed from the , a fresh copy of that connector is added alongside the existing one. You can then decide which one to use.
All scripts defined in process flow are installed and deployed, ready for use.
All cross-reference lookups defined as process flow are installed and ready for use.
Any data pools defined in process flow are added. These are 'clean' data pools (i.e. with no associated data), ready for use.
Any caches and cache keys defined in process flow are added. These are 'clean' caches (i.e. with no associated data), ready for use.
Installing a prebuilt process flow is a straightforward, one-click operation via the Patchworks marketplace. All required components are installed and added to the relevant part of your Patchworks dashboard.
Once the installation is complete, you need to complete a few setup tasks in order to make the process flow live. This page details the installation and post-installation setup steps required.
When a prebuilt process flow is installed, all components (connectors, scripts, etc.) are added to the relevant area of your Patchworks dashboard - connectors are added to your connectors page, custom scripts are added to your scripts list, etc.
For more information about the components of a prebuilt process flow please see The anatomy of a prebuilt process flow.
If you install a prebuilt process flow which includes a connector that you have already installed from the connector marketplace, a fresh copy of that connector is installed alongside the existing one. You can then decide which one to use.
When a prebuilt process flow is installed, it is disabled and set to a draft status. When you are ready, you should enable and deploy the process flow. Keep in mind that your Patchworks subscription tier determines the number of process flows and connectors that you can deploy.
To install a prebuilt process flow, follow the steps below.
Step 1 Select marketplace from the left-hand navigation menu, then access the process flows section.
Step 2 Find the process flow that you want to install (if necessary, click the view button for a read-only view of the flow, to be sure):
Don't forget that you can use the search bar to find process flows.
Step 3 Click the install button for the required process flow:
Step 4 A confirmation message is displayed, advising that the process flow is queued for installation. Typically, installation is completed in a few seconds, but you can navigate away in the meantime. Once the installation is complete, you'll see a notification in your notification centre.
Having installed a prebuilt process flow, follow the steps below to complete its setup:
Select process flows | connectors & instances from the left-hand navigation menu. Here you'll find all of your installed connectors.
Any connectors installed via the prebuilt process flow will be shown here. If the process flow installs a connector that you already had, you'll find a fresh version of the connector next to your existing one, so you can decide which one to use.
Once you're satisfied that all required instances are in place with your connector credentials, you need to apply these to connection shapes in the new process flow.
To do this, select process flows | process flows from the left-hand navigation menu. Here you'll find all of your process flows, including any that you have installed from the marketplace.
Edit the new process flow and check all connection shapes - you'll notice a warning symbol, indicating that the shape is not configured - for example:
Click the settings icon for the connection shape and choose the required instance and endpoint (leave all other connection settings as the default):
Don't forget to save your changes!
Check all other shapes in the process flow for a warning symbol. If there is a warning, open settings and click save to confirm.
Other shapes should not need to be changed but sometimes you may need to confirm default details by saving the shape settings.
Once you're satisfied that all connection shapes are configured and you're ready to put the process flow live, you should deploy it. To do this, access process flow settings and change the draft status to deployed:
For more information please see Process flow versioning.
The final step is to enable the process flow. To do this, access process flow settings and toggle the ENABLE option to ON:
