Introduction

Le but de cette page est de documenter le processus d'intégration entre les plateformes Moodle et Dexero.

Dexero est une plateforme qui permet de vendre des produits, dans notre cas, il s'agit de cours. Nous allons utiliser un catalogue de Dexero pour permettre aux apprenants d'acheter/s'inscrire aux cours qui seront créés dans StudiUM formation continue (Moodle).

Il est possible de gérer les produits (cours) à travers de la console de Dexero. Un programme d'extraction de données va se connecter au catalogue Dexero et devrait être en mesure de créer les cours dans StudiUM formation continue, mais il faut spécifier les paramètres nécessaires à nos produits pour avoir les données correspondantes aux cours.

Communication Dexero - StudiUM formation continue

La première étape est de vous assurer que votre environnement Dexero est correctement configuré afin de communiquer avec StudiUM formation continue :
StudiUM formation continue - Intégration Dexero - Configurations

Il faut dans un premier temps créer les produits (cours) dans Dexero, puis une fois qu'ils sont ajoutés dans SutdiUM FC par le programme de peuplement les cours peuvent être bonifiés avec du contenu.

Création des produits dans Dexero

Voici les étapes à suivre afin de créer un produit dans Dexero qui sera associé à un cours dans StudiUM formation continue :

Se connecter dans la console de gestion de catalogue Dexero : https://ecommerce.dexero.com/Login.view
Accéder à la section Produits et cliquer sur le bouton : "Créer"

Remplir les champs nécessaires et enregistrer :

Champ	Valeur (exemples)	Observations
Type	Produit régulier	Voir les différentes options
Nom	Cours Test 1	Champ équivalent dans Moodle : Nom de cours
Identifiant	cours_test_1	Nous pouvons spécifier une valeur ou il sera généré automatiquement à partir du champs "Nom".
Visible	Dans le catalogue et la recherche	Voir les différentes options
Ensemble d'attributs	Cours non crédités	Contient les attributs : Activer (valeurs : vide ou Oui) et Nom abrégé du cours

Dans la liste des produits, aller dans les détails du produit (double clic dans le produit récemment créé)

Si vous désirez que le produit soit disponible sur votre catalogue, que le cours correspondant soit créé instantanément dans StudiUM formation continue, et effectuer toutes les inscriptions correspondantes, il faudrait faire aussi les étapes suivantes :

Activer le produit et Enregistrer

Aller dans le groupe d'attributs "StudiUM formation continue", dans la liste déroulante du paramètre "Activer", sélectionner l'option "Oui"
Remplir la valeur du paramètre "Nom abrégé du cours" pour avoir une valeur personnalisée (par défaut, le nom du produit sera utilisé)
- NOTE : Le nom abrégé du cours est affiché dans la piste de navigation et est utilisé dans l'objet des messages de courriel du cours sur StudiUM FC, il s'agit de trouver la forme réduite aux points essentiels du titre du cours.
Cliquer sur enregistrer

Correspondance des champs dans la catalogue

Voici la correspondance de certains champs et comment il seront affiché dans le catalogue Dexero :

Paramètres du produit

Champs affichés dans la description du produit dans le catalogue

Champs affichés dans la description du produit lors de l'achat

Création et peuplement des cours dans Moodle

Il existe dans StudiUM formation continue un programme d’extraction de données qui permet d'aller récupérer les produits (cours) dans Dexero et les créer dans Moodle.

Correspondance de champs d'un produit-cours dans Dexero avec les champs du cours dans Moodle

Le programme d'extraction fait la sélection des cours (produits) pour les créer automatiquement dans StudiUM formation continue, ces produits doivent avoir les caractéristiques suivantes :

Général
- ensemble d'attributs "Cours non crédités";
Général / Option de publication du produit
- "Actif" marqué "Actif";
- "Achetable" marqué "Achetable si actif"
- "Visible" marqué "dans le catalogue ou la recherche"
- "Visible" différent de "Non".

Voici la correspondance actuelle des champs Moodle construit à partir de ceux du produit dans Dexero :

Moodle (données du cours)	Dexero (données du produit)
Nom complet du cours	Nom
Nom abrégé du cours	Attribut "Nom abrégé du cours" si "non vide" sinon, utilise le Nom dans Dexero
N° d'identification du cours	Identifiant préfixé du code faculté. Ex :"FEP-" + Identifiant
Description	Description longue

Si un cours dont le N° d'identification du cours n'est pas déjà présent dans StudiUM formation continue, il se créé automatiquement mais sera caché par défaut. Sinon, vous pouvez le créer à l'avance en lui attribuant le N° d'identification du cours au format spécifié plus haut avant de l'activer dans Dexero.

Méthode d'inscription système externe

Procédure pour un lien Dexero qui ne s'est pas fait lors de la création de cours

Une fois que le cours a été créé dans StudiUM formation continue, s'il n'y déjà eu des inscriptions provenant de Dexero, la méthode d'inscription sera déjà présente.
Autrement, si vous souhaitez modifier le message, il faudra ajouter la méthode d'inscription "Inscription système externe".

Si vous devez l'ajouter, assurez vous de sélectionner la méthode d'inscription Système externe qui correspond à votre environnement Dexero (Ex : "FEP - Dexero" pour la Faculté d'éducation Permanente) :

Marche à suivre et liste des clients de Dexero en intégration avec StudiUM formation continue

Si l'option "Envoyer un message de bienvenue" est cochée (oui par défaut), les personnes qui ont achetés le cours chez Dexero vont recevoir un courriel de la part de Moodle (StudiUM formation continue). Il est possible pour les enseignants ou personnes chargées des cours de remplacer le message par défaut par un message personnalisé :

Pour ajouter un message personnalisé nous pouvons utiliser des variables de Moodle :

Variable	Description	Valeur affiché dans le message (Exemples)
{$a->coursename}	Nom de cours	CRS-E-1 - Cours Test 1
{$a->profileurl}	Adresse URL du profil personnel de l'utilisateur authentifié	https://studiumfc.umontreal.ca/user/view.php?id=3&course=79
{$a->courseurl}	Adresse URL du cours	https://studiumfc.umontreal.ca/course/view.php?id=79
{$a->fullname}	Nom complet de l'usager	Jérôme Danel
{$a->email}	Courriel de l'usager	jerome.danel@example.com

Bienvenue au cours « {$a->coursename} » !
 
Pour accéder à votre cours, cliquez ici :
{$a->courseurl}
 
Bon succès dans ce cours !

Welcome to {$a->coursename}!

To access your course, click here:
{$a->courseurl}

We wish you a successful course!

Bonjour {$a->fullname},
Bienvenue au cours non crédité « {$a->coursename} » !

Ceci est un message personnalisé :
{$a->profileurl}

Voici le lien vers votre cours :
{$a->courseurl}

Le courriel reçu devrait être :

Bonjour Jérôme Danel,

Bienvenue au cours non crédité « CRS-E-1 - Cours Test 1 » !

Ceci est un message personnalisé :
https://studiumfc.umontreal.ca/user/view.php?id=3&course=79

Voici le lien vers votre cours :
https://studiumfc.umontreal.ca/course/view.php?id=79

Le message personnalisé doit être écrit dans les deux langues.

Processus d'achat en ligne

Les clients peuvent acheter des cours dans le catalogue en ligne.

Voir l'image avec le catalogue exemple.

Votre catalogue à une adresse sous ce format :
https://ecommerce.dexero.com/shopping/clemarchand/clecatalogue/

Ex : https://ecommerce.dexero.com/shopping/fep/fep/

Le catalogue fonctionne comme un panier d'achat. Après avoir payé, votre commande sera traitée automatiquement par le programme d'extraction de données et vous devriez être inscrit dans votre cours acheté après quelques minutes.

Au moment de se créer un compte pour magasiner chez Dexero, on encourage les usagers de la communauté universitaire d'utiliser leur compte de courriel "umontreal". De cette façon, nous serons en mesure de les inscrire dans le cours de StudiUM formation continue avec leur compte déjà existant. Les apprenants n'aurons pas besoin d'avoir deux comptes et on réduit ainsi la complexité dans la gestion des identités.

Dans le cas d'un nouvel utilisateur, il recevra un courriel lui invitant de modifier son mot de passe dans Moodle, étant donné que son profil sera créé avec un mot de passe temporaire.

Vous devriez également recevoir un courriel de confirmation de votre achat de la part de Dexero ainsi qu'un courriel de bienvenue à votre cours dans StudiUM formation continue.

Environnement de test

Les test de l’intégration Moodle-Dexero pourront être effectuées dans notre environnement de Développement, voici les liens :

Moodle Devel : https://studium-devel.ena.umontreal.ca/studiumfc/

Catalogue Dexero Devel : https://ecommerce.dexero.com/shopping/moodle/developpement_moodle/

Vous devrez demander aux administrateurs du Catalogue Dexero Devel (Équipe StudiUM) de contacter Dexero pour vous créer un compte administrateur dans le catalogue.
Les cours seront créés dans la catégorie Cours Dexero : https://studium-devel.ena.umontreal.ca/studiumfc/course/index.php?categoryid=2
- Vous devrez demander aux administrateurs de StudiUM de vous donner le rôle de gestionnaire dans la catégorie pour accéder à vos cours même s'il ne sont pas ouvert aux apprenants.

Liens utiles

Voici quelques liens utiles provenant de l'aide en ligne Dexero :