Xtension examples

You can integrate any services or data sources that are accessible via a RESTful Representational State Transfer: a style of software architecture that separates state and functionality into distributed resources, with each resource uniquely addressable, typically using HTTP commands. RESTful applications are usually stateless and support caching. web call as Xtensions A set of instructions for the Nintex Workflow Platform to use third-party API functionality with Nintex workflows. An Xtension may include workflow actions, start events, forms or file control. for Nintex Workflow Cloud. The following examples walk you through creating some specific Xtensions.

Create a basic Xtension with no authentication to sanitize profanity from text using PurgoMalum, and create a work-safe customer suggestion box.

Create a suggestion box

 

No authentication

Create a new GitHub repository and post an issue using Basic authentication Identifying the API requestor using a username and password passed in the HTTP header..

Add basic authentication

 

 

Basic authentication (username and password)

Use API key authentication An authorization code passed in an API request, either inside the header or as a parameter, to identify the requester. to convert currency and create an automatic international purchase approval workflow.

Add API key authentication

 

API key authentication

Use OAuth2 authentication A two-step authorization protocol that both identifies the requestor, and allows a user to grant access to a third-party account without revealing their credentials to the requesting software. to create a new task list in the Google Tasks of the connected user.

Add OAuth2 authentication

 

OAuth2 authentication

Rename custom actions and configuration fields with the summarySpecification Extension. A Nintex-specific OpenAPI Specification key that allows special functionality within Nintex Xtensions.

Rename fields (x-ntx-summary)

 

summary

Populate a drop-down configuration field with a list of the designer's Google Tasks tasklists using the dynamic-values Specification Extension.

Create drop-downs (x-ntx-dynamic-values)

 

dynamic-values

Streamline your Workflow designer by concealing unnecessary operations A single request to a third-party API. Operations often become actions in the workflow designer. and configuration fields with the visibility Specification Extension.

Hide operations (x-ntx-visibility)

 

visibility

Use the dynamic-schema Specification Extension to dynamically generate a parameter's data structure from the API using a helper operation A single request to a third-party API. Operations often become actions in the workflow designer., to support operations whose parameters may change at runtime.

Note: Nintex Workflow Cloud provides SharePoint Online actions out-of-the-box. This example is provided for demonstrative purposes only.

Create dynamic fields (x-ntx-dynamic-schema)

  dynamic-schema

Use the query-builder Specification Extension to create an OData query from a hard-coded or dynamically-generated set of fields.

Note: Nintex Workflow Cloud provides SharePoint Online actions out-of-the-box. This example is provided for demonstrative purposes only.

Create OData queries (x-ntx-query-builder)

  query-builder

Convert a Nintex Workflow Cloud workflow into a custom connector to be used as an action inside other workflows.

Add a Nintex workflow as an Xtension

 

Component workflow

Validate input from a configuration field using regular expressions A seqence of symbols used to identify a particular pattern or piece of text within a larger body of text. Often used to validate input, such as valid URLs or email addresses. before sending it to your API.

Validate with regex

 

Regular expressions (validate)

Convert an XML response into JSON JavaScript Object Notation: a data format based on JavaScript that is commonly used for API request parameters and responses. to send a motivating word-of-the-day message to your team on Slack.

Accept an XML response

 

XML response (serverless functions)

Pre-process parameters A piece of information passed to a third-party API during a request. from Nintex Workflow Cloud into an API's required format to send an email from an external email server within a workflow.

Pre-process parameters

 

Pre-process parameters(serverless functions)

Assess the opportunity cost of business proposals with WolframAlpha to automate their initial approval process.

Extract data with a regex

 

Regular expressions (extract)

Add qualified prospects to your company mailing list with Mailchimp.

Add subscribers to Mailchimp

   

Upload a file to a new task in Asana using file streaming.

Upload files by streaming

 

Streaming files (upload)

Upload a file into a GitHub repository using base64 encoding.

Upload base64 files

 

Base64 files (upload)

Upload a file to Flowdock by passing a file URL reference.

Upload files by URL

 

File reference (upload)

Download a welcome pack to send with a file URL reference.

Download files by URL

 

File reference (download)

Download the documentation from a GitHub repository with base64 encoding.

Download base64 files

 

Base64 files (download)

Also see...

Examples created by third-party services, such as Theobald Software's SAP integration using ECS Core.

Xtensions solutions you can import into your Nintex Workflow Cloud tenant in the Nintex Solution Accelerator Gallery.