Workflow Actions

Workflow Actions provide a mechanism for sending ENPS content to external systems via custom menus in the ENPS desktop and mobile clients.

This can involve simple clipboard copy and paste, or more complex triggers designed to be used with API-based integrations.

ENPS ships with a simple built-in example of a Workflow Action called SOCIAL COPY, which is available in ENPS stories, planning items and contacts. This copies the text in the object and changes it to title case, readying it for posting to Twitter, for example.

Additional Workflow Actions can be configured on demand. Functionality includes the ability to open a website and optionally paste the content directly into a field on the website, as well as the option to call an external API.

The external API can then call functions in the ENPS API using the relevant roID / storyID. This dramatically increases the range of potential user-accessible functionality via custom integrations.

Settings

Setting	Description
UniqueID	Unique Identifier for the action.
Description	Label shown in the ENPS client describing the action.
Icon	Not relevant.
Action Type	Type of action. Options relevant to ENPS are ENPS, EXTERNAL API, and EXTERNAL WEBSITE.
Action	Either: the URL which will be called when the action is invoked, which may be a call to an custom API, or; a specific hard-coded action, such as SOCIALCOPY. See examples below. Check the box for the object types that can trigger the action. We recommend Script and Planning Item.
Topic Action	Not relevant to ENPS.
Assignment Action	Not relevant to ENPS.
Publication List Action	Not relevant to ENPS.
Rundown Action	Display this option in the Workflow Actions menu when a rundown is in focus.
NGG Action	Display this option on the Workflow Actions menu when a planning grid is in focus.
Grid Action	Display this option on the Workflow Actions menu when a generic grid is in focus.
Script Action	Display this option on the Workflow Actions menu when a story is in focus.
Planning Item Action	Display this option on the Workflow Actions menu when a planning item is in focus.
Contact Action	Display this option on the Workflow Actions menu when a contact is in focus.
Storyboard Action	Display this option on the Workflow Actions menu when a Storyboard is in focus.
Verb	Specifies whether the request to the Action URL should be a GET, POST, PUT, PATCH or DELETE (case specific).
Headers	Specifies the key/value pairs that should be added to the header prior to making the request to the external site. The header field should be a JSON array in the following format: `[{"Key":"key1name","Value":"key1value"},{"Key":"key2name","Value":"key2value"}]`
Visibility Criteria	Not relevant to ENPS.
Open External	Specifies if the site is opened using the workstation’s default browser or opened within ENPS.
Copy Plain Text	Specifies if the plain text version of the content is copied into the clipboard when the web browser is launched. For sites which cannot receive the content via query string, set this to true so that the user can manually paste the content once the site opens.

Example Uses

External Website, Facebook and Twitter

You can configure simple integration with external websites as follows, with Facebook and Twitter given as examples:

Setting	External Website (general)	Facebook	Twitter
UniqueID	Unique Identifier for the action.	SHAREFACEBOOK	SHARETWITTER
Description	Label shown in the ENPS client describing the action.	Share to Facebook	Share to Twitter
Icon		FACEBOOK	TWITTER
Action Type	EXTERNAL WEBSITE	EXTERNAL WEBSITE	EXTERNAL WEBSITE
Action	The URL that will be opened when the action is invoked. If the target website is capable of receiving content via the query string you can include ":plainText" in the URL and it will be replaced with the plain text version of the ENPS content. Check the box for the type of content you wish to enable for export. We recommend Script and Planning Item.	https://www.facebook.com	https://twitter.com/intent/tweet?text=:plainText
Topic Action
Assignment Action
Publication List Action
Rundown Action
NGG Action
Grid Action
Script Action	(recommended)
Planning Item Action	(recommended)
Contact Action
Storyboard Action
Verb	GET (case specific)	GET	GET
Headers
Visibility Criteria
Open External	Specifies if the site is opened using the workstation’s default browser or opened within ENPS.
Copy Plain Text	Specifies if the plain text version of the content is copied into the clipboard when the web browser is launched. For sites that cannot receive the content via query string, set this to true so that the user can manually paste the content once the site opens.