The integration for EdCast LXP provides a way for you to integrate EdCast content with your Docebo Learn platform via the usage of Docebo Connect recipes.
The Docebo Connect Integration for Edcast can be used by clients for managing
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.
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 green 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 blue 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.
Copy The Recipes
As with all recipes provided by Docebo or other sources, before making any changes you should copy or clone the recipes in case you make any errors in configuration. This allows you to easily undo any mistakes without requiring third-party intervention. Once the recipes are copied or cloned, references within those recipes will need to be updated. Please see Troubleshooting Recipes for more information.
Configure the Connector in Docebo Connect
In the Project folder with your EdCast recipes click on the down arrow next to the blue 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 Prod 3||
Once you have entered all the relevant information press the blue Connect button. When you return to your EdCast project folder you will see the active connector in your project list:
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 Learn 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:
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.
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.
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.