Introduction
Docebo Connect is a Docebo module acting as a connector between your platform and third-party SaaS systems, helping you to integrate your platform with more than 400 third-party external systems, reducing the integration effort.
Docebo Connect offers a large catalog of connectors for the most popular SaaS systems, to manage automated workflows (called recipes) shared among systems in order to exchange and share data on the basis of triggers.
Please note that Docebo Connect takes advantage of the APIs and business logic already existing in the integrating systems and does not create new ones. In addition, Docebo Connect does not manage SSO flows with Identity Providers (such as SAML, OpenID Connect, etc), JavaScript integrations (such as Google Analytics or Google Tag Manager) or iframe integrations (such as Docebo OEM or Salesforce Canvas).
The integration for EdCast LXP provides a way for you to integrate EdCast content with your Docebo platform via the usage of Docebo Connect recipes.
The Docebo Connect Integration for Edcast can be used by clients for managing
- Content
- Completions
Content is grouped under the source through which they are created. Completions can be created only for content that is created through the Docebo Connect integration for EdCast. It cannot be used for creating assignments and completions for content imported through any other sources.
For more information on the definition of terms and concepts used throughout this article, please read Docebo Connect Glossary of Terms.
Activating Docebo Connect
To activate Docebo Connect on your platform or sandbox, please reach out to your Docebo account manager. Please note that depending on the integration requirements, there may be associated costs.
Before you start
All the recipes for this integration can be found in the project's folder. This folder should be considered a “special folder” as all the recipes contained within are subject to automatic updates. As such, any customizations you make to recipes located within the folder can be overwritten by Docebo. In order to prevent such an occurrence, it is strongly advised to create a new project folder for any recipes you wish to use in production and copy or clone the recipes from the project's folder inside.
Prior to configuring and using the integration, you need to make clones of all the recipes used in this integration. For more information on how to clone and edit a cloned recipe, please see Docebo Connect usage: Copying recipes. The list of recipes that need to be cloned can be found in the Recipe list chapter of this article. All recipes that call another recipe will require editing, the called recipes can be found in a list inside the recipe description.
Configuring EdCast LXP recipe templates
The first step in connecting EdCast with Docebo is to log in to your EdCast LXP administration console with the necessary credentials.
Creating a Docebo source
Next, you have to create a Docebo Source. Select LMS Integrations in the navigation menu and then click on the plus button in the LMS Api Integration box.
In the following window, in the Display Name field enter the Connection Name in the EdCast system. Leave the Language field set as unspecified. In the Host field enter Docebo and for the Assigner Name field set the user as the owner of the smart card created in EdCast. Next, you will be asked to provide a logo and a banner. The logo should have a width of 180px
and a height of 100px
with little to no padding. For the banner choose an image that has a width of 1018px
and a height of 160px
. The next three options should be left as is, Allow Mark As Complete should remain off and Share to Groups as well as Restrict to Groups can be left as untouched. Then press the Add button.
Setup OAuth credential
Once your Docebo Source is configured you can move on to configuring the OAuth credentials within EdCast.
In your Administrator panel, under Integrations, press OAuth2 Apps.
In the resulting screen, press the Create button to bring up the Create OAuth2 Credentials window.
In the Create OAuth2 Credentials window provide a unique name for the credentials. In the Sources drop-down box select the previously created Docebo source. Press the Create button.
You will then be presented with your list of credentials. Copy and paste the Client ID and the Client Secret (which can be accessed by clicking on the Client ID) into a text editor so you can easily enter them in Docebo Connect later.
Next you can configure the connection inside Docebo Connect.
Configuring Docebo Connect for EdCast
Configuring and managing the recipes takes place in Docebo Connect. To access this area click on the gear icon in the top left corner of your screen and find Docebo Connect, there click on Manage.
Configure the connector in Docebo Connect
In the Project folder with your EdCast recipes click on the down arrow next to the Create Recipe button and press Create Connection.
In the New connection screen, type EdCast into the search box and choose the EdCast LXP connector.
In the following screen enter the Connection name; this name will be the name visible within Docebo Connect. In the Location drop-down field, select the folder where you have stored your EdCast recipes.
In the Client ID and Client Secret fields enter the relevant fields you copied from the EdCast OAuth2 section earlier.
The LMS Host URL field requires a URL that is dependent on your geographical location or requirement. Please consult the following table for the possible entries:
Location / Purpose | URL |
---|---|
US |
https://lms.edcast.io |
EU |
https://lms-europe.edcast.io |
US Prod 3 |
https://lms-app-us-prod3.edcast.com |
Preview |
https://aws-eu-central1-lms-integration.edcastpreview.com |
Once you have entered all the relevant information press the Connect button. When you return to your EdCast project folder you will see the active connector in your project list:
Managing recipes
Configure the lookup table
In order for the recipes to function properly, the associated Lookup Table must be populated with data first. In order to do so, first navigate to the Projects tab and locate your EdCast project folder where you will find a recipe called #1 Table Setup.
Click on the recipe called #1 Table setup to open the recipe in the editor. Next, click on Edit Recipe.
Once the recipe editor has opened, single-click the first item in the recipe flow. In the details panel on the right, locate the Trigger at box and click on the square icon in the right side of the input box. Select any time and then click on the Test button to run the recipe once.
The lookup table has now been populated. Next you need to click on the Lookup Table tab and select the Docebo-Connect - Edcast Sync Last Run Times table. Edit the Sync LP and Sync Courses records and change the date to sometime in the past that is just before the publishing date of the course or learning plan you would like to replicate from Docebo to EdCast.
To edit a record in the Lookup Table, hover your mouse over the record you wish to edit, in the right side of the record a pencil and a trashcan will appear, click on the pencil to enter edit mode for the record.
You can now edit the fields directly in the table. When editing the date, take care to only change the numbers to the left of the letter T in the format YYYY-mm-dd, for example to change the date of a record containing the following Last Run Time information: 2022-03-08T05:21:53.293-08:00
to August 12th 2020, the new record would look like this: 2020-08-12T05:21:53.293-08:00
.
When you are satisfied with the changes, press the checkmark button at the end of the record to save your changes.
Next, move on to the course replication recipe configurations.
Editing configuration parameters in recipes
In the Content Fetch folder of the project, locate the recipe titled #2 Content Fetch - Callable Recipe and press the ellipsis button. In the drop down menu, press Edit Recipe.
Next, in the recipe editor, scroll down to the stand-alone item labeled Configuration Parameters and click on it. In the resulting slide-out window, locate the Docebo URL text box and replace the edcast-demo.docebosaas.com
part of the value with the location of your own platform, keeping the /learn/course/internal/view
part of the URL in place.
For example, if your platform URL is https://thisismyexampleplatform.docebosaas.com
, the value you would enter in this text box would be: https://thisismyexampleplatform.docebosaas.com/learn/course/internal/view
.
Next, press the Save button.
Next, move to the Content Fetch - Learning Plan folder, locate the recipe named #2 Content Fetch - Callable Recipe (Learning Plan) and press the ellipsis button in that recipe's row, followed by Edit recipe in the resulting drop-down window.
Next, in the recipe editor, scroll down to the stand-alone item labeled Configuration Parameters and click on it. In the resulting slide-out window, locate the Docebo URL text box and replace the edcast-demo.docebosaas.com
part of the value with the location of your own platform, keeping the /learn/lp
part of the URL in place.
For example, if your platform URL is https://thisismyexampleplatform.docebosaas.com
, the value you would enter in this text box would be: https://thisismyexampleplatform.docebosaas.com/learn/lp
.
Next, press the Save button.
Start course replication recipes
The next step is to initialize the course replication recipes. First, enter the Content Fetch folder in your EdCast Project and start the recipe #1 Docebo Connect - Content Fetch by clicking on the ellipsis button in the right corner of the recipe and pressing Start in the dropdown menu.
You will then need to repeat this same process for the recipe called #2 Content Fetch - Callable Recipe:
In the event that this recipe produces an error, please see the section on Troubleshooting Recipes to correct the issue.
Once the recipe has run successfully you can move on to starting the Learning Plan replication recipes.
Next, move to the Content Fetch Learning Plan sub folder of your project. Once there, you can start the recipe #1 Docebo Connect - Content Fetch (Learning Plan) in the same manner you started the other recipes; click on the ellipsis button and choose Start. Once the recipe has started, move on to the following Recipe called #2 Content Fetch - Callable Recipe (Learning Plan). In the event that this recipe produces an error, please see the section on Troubleshooting Recipes to correct the issue.
Once the recipe has run successfully you can move on to starting the Completion Fetch recipes.
In the Completion Fetch sub folder of your project, you can start the recipe #1 Docebo Connect - Completion Fetch in the same manner you started the other recipes; click on the ellipsis button and choose Start. Once the recipe has started, move on to the following Recipe called #2 Completion Fetch - Callable Recipe. In the event that this recipe produces an error, please see the section on Troubleshooting Recipes to correct the issue.
Once the recipes have all successfully been started you will have completed the EdCast LXP / Docebo Connect configuration.
Troubleshooting recipes
In the event that you receive an error message stating that the recipe was unable to start, you will need to open the recipe and find the elements that have an orange exclamation mark icon next to them. Click on the first one of those elements and press the Edit button. In the slide-out window asking for a connector to be configured, choose the EdCast LXP Connector by clicking on the item in the list, press Save and then press Exit. You can now start the connector as described in the instructions.
Recipe list
Please note: In order for this integration to work properly, the following recipes need to be started first:
- #1 Docebo Connect - Completion fetch
- #2 Completion Fetch - Callable Recipe
- #1 Docebo Connect - Content Fetch
- #2 Content Fetch - Callable Recipe
For more information about starting recipes, please see Docebo Connect usage: Common recipe actions.
The configuration of these recipes is covered in the chapter Managing recipes.
Utility recipe
#1 Table setup
This recipe is used only for the initial configuration of the lookup-tables and should not be started; instead it should be run once using the Test Recipe button in the recipe editor.
- Trigger
- This recipe should not be started, it should be run only once via test recipe in the recipe editor.
- Calls to other recipes
-
- None
Workflow recipes
#1 Docebo Connect - Completion fetch
- Trigger
- Triggered automatically every five minutes
- Calls to other recipes
-
- Docebo Completion Fetch Pagination Recipe (an alias for #2 Completion Fetch - Callable Recipe)
#2 Completion Fetch - Callable Recipe
- Trigger
- Triggered via function call
- Calls to other recipes
-
- None
#1 Docebo Connect - Content Fetch
- Trigger
- Triggered automatically every five minutes
- Calls to other recipes
-
- Docebo Content Fetch Pagination Recipe (an alias for #2 Content Fetch - Callable Recipe)
#2 Content Fetch - Callable Recipe
- Trigger
- Triggered via function call
- Calls to other recipes
-
- None