Getting started Umbraco V8 & Enterspeed
The easiest way getting started with Umbraco and Enterspeed is using the pre-built Umbraco integration.
GitHub: Enterspeed Source Umbraco CMS
This integration takes care of calling the Enterspeed Ingest API when changes occurs in Umbraco. For a full overview of what Umbraco entities are send to Enterspeed, please see Umbraco entities.
Prerequisite: Umbraco 8.7 or above.
The fastest way to get up and running, is to install the Enterspeed Umbraco integration with NuGet.
You can either install it manually from the NuGet manager in Visual Studio or execute the Install-Package command:
Install specific version
Install-Package Enterspeed.Source.UmbracoCms.V8 -Version <version>
Using Umbraco Cloud? If you have used the Umbraco Cloud UaaS.cmd tool to setup your solution, you need to manually update the referenced dlls after installing the Enterspeed NuGet package. Specifically Microsoft.Bcl.AsyncInterfaces.dll needs to be updated.
From Visual Studio navigate to the [Namespace].Web\bin folder, and right click on Microsoft.Bcl.AsyncInterfaces.dll, and select "Update Reference".
When the installation above has completed two new dashboards has been added to your Umbraco solution.
- Content: To seed and check errors when data is ingested
- Settings: To configure Enterspeed in Umbraco
Before Umbraco starts sending data to Enterspeed you will need to add a little piece of configuration.
Luckily this can easily be done within Umbraco itself or via Web.config.
Source API key and Ingest endpoint
Firstly go to Settings and then select the Enterspeed Settings dashboard in your Umbraco backoffice.
You should see something like this:
The Enterspeed endpoint is the ingest endpoint, that Umbraco will use to send content to Enterspeed.
Unless you have gotten a specific Enterspeed endpoint to call, please use: https://api.enterspeed.com
The Media domain is to tell the Enterspeed integration where you have your media placed, e.g. if you have a CDN.
If you leave it empty, it will just use your current Umbraco installation domain.
Before you can insert an API key, you must have created a Source within the Enterspeed Management.
The API key looks something like this: source-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. When you have gotten it, insert it in the Api key input field.
Preview API key
Optional API key, serves the purpose of ingesting draft and unpublished content to the secondary (preview) source. Can be leveraged for your content editors to preview content, similarly to in-built 'Save & Preview' functionality in Umbraco.
Before you can insert a Preview API key, you must have created a Source within the Enterspeed Management.
Enterspeeds connector will automatically push data to relevant primary or secondary sources based on actions performed in Umbraco backoffice, such as - Unpublish, trash, save, publish, etc.
When you have inserted the Enterspeed endpoint and the API key(-s) click on Test connection and make sure that you get a successful response. When you do go ahead and Save the configuration.
For Web.config, please use the following appSettings:
<add key="Enterspeed.Endpoint" value="" />
<add key="Enterspeed.MediaDomain" value="" />
<add key="Enterspeed.Apikey" value="" />
Processed Umbraco entities
Here is an overview of what is processed and send to Enterspeed and what is not.
- Published content
- Draft content (unpublished content/saved content)
Not processed entities