
Mise en vedette
Les « mises en vedette » permettent de mettre en avant des sessions de formation ou des cohortes de programme dans les catalogues, au moyen d'une pastille colorée portant un titre et un libellé. Une mise en vedette dans l'API est nommée « catalogspotlight ». | ![]() |
Mise en vedette : catalogspotlight/get
https://www.domaine.com/lmsapi/catalogspotlight/get
![]() | Retourne un objet représentant une mise en vedette de votre environnement. |
Requête
Exemple de contenu d'appel de requête des informations pour une mise en vedette :
{
"id" : "Eiakb2wlFfzKdJgH23kygQ%3d%3d"
}Description des champs
| Nom | Obligatoire | Commentaires/description |
| id | X | Identifiant unique de la mise en vedette. (Type string) |
Réponse
Exemple de contenu d'appel de réponse des informations pour une mise en vedette :
{
"id": "Eiakb2wlFfzKdJgH23kygQ%3d%3d",
"title": {
"texts": [
{
"text": "API_CS_TITLE",
"languageId": 1
}
],
"ErrorID": 0
},
"label": {
"texts": [
{
"text": "API_LABEL",
"languageId": 1
}
],
"ErrorID": 0
},
"color": "F40000"
}Description des champs
| Nom | Commentaires/description |
| id | Identifiant unique de la mise en vedette. (Type string) |
| title | Titre de la mise en vedette, sous forme de textes multilingues (texts).
|
| label | Libellé de la mise en vedette, sous forme de textes multilingues (texts).
|
| color | Couleur de la pastille de mise en vedette. (Type string) |
Mise en vedette : catalogspotlight/getlist
https://www.domaine.com/lmsapi/catalogspotlight/getlist
![]() | Retourne la liste de l’ensemble des mises en vedette de votre environnement. |
Requête
Exemple de contenu d'appel de requête de la liste des mises en vedette :
Description des champs
| Nom | Obligatoire | Commentaires/description |
| La méthode ne requiert aucun paramètre. |
Réponse
Exemple de contenu d'appel de réponse de la liste des mises en vedette :
[
{
"id": "Eiakb2wlFfzKdJgH23kygQ%3d%3d",
"title": {
"texts": [
{
"text": "API_CS_TITLE",
"languageId": 1
},
{
"languageId": 2
},
{
"languageId": 3
},
{
"languageId": 4
}
],
"ErrorID": 0
},
"label": {
"texts": [
{
"text": "API_LABEL",
"languageId": 1
},
{
"languageId": 2
},
{
"languageId": 3
},
{
"languageId": 4
}
],
"ErrorID": 0
},
"color": "F40000"
},
{
"id": "k0gEJ48oDezizeIqAsmhmQ%3d%3d",
"title": {
"texts": [
{
"text": "CatalogSpotlightTitle",
"languageId": 1
},
{
"languageId": 2
},
{
"languageId": 3
},
{
"languageId": 4
}
],
"ErrorID": 0
},
"label": {
"texts": [
{
"text": "CSLabel",
"languageId": 1
},
{
"languageId": 2
},
{
"languageId": 3
},
{
"languageId": 4
}
],
"ErrorID": 0
},
"color": "FFFFFF"
}
]Description des champs
Chaque élément de la liste contient les mêmes champs que ceux retournés par catalogspotlight/get :
| Nom | Commentaires/description |
| id | Identifiant unique de la mise en vedette. (Type string) |
| title | Titre de la mise en vedette, sous forme de textes multilingues (texts).
|
| label | Libellé de la mise en vedette, sous forme de textes multilingues (texts).
|
| color | Couleur de la pastille de mise en vedette. (Type string) |
Mise en vedette : catalogspotlight/create
https://www.domaine.com/lmsapi/catalogspotlight/create
![]() | Permet de créer une mise en vedette dans votre environnement. |
Requête
Exemple de contenu d'appel de requête de création d'une mise en vedette :
{
"title": {
"texts": [{
"text": "CatalogSpotlightTitle",
"languageId": 1
}
]
},
"label": {
"texts": [{
"text": "CSLabel",
"languageId": 1
}
]
},
"color": "FFFFFF"
}Description des champs
| Nom | Obligatoire | Commentaires/description |
| title | X | Titre de la mise en vedette, sous forme de textes multilingues (texts).
|
| label | X | Libellé de la mise en vedette, sous forme de textes multilingues (texts).
|
| color | Couleur de la pastille de mise en vedette. (Type string) |
Réponse
Exemple de contenu d'appel de réponse de création d'une mise en vedette :
{
"id": "k0gEJ48oDezizeIqAsmhmQ%3d%3d"
}Description des champs
| Nom | Commentaires/description |
| id | Identifiant unique de la mise en vedette créée. (Type string) |
Mise en vedette : catalogspotlight/edit
https://www.domaine.com/lmsapi/catalogspotlight/edit
![]() | Permet de modifier une mise en vedette existante. |
Requête
Exemple de contenu d'appel de requête de modification d'une mise en vedette :
{
"id": "Eiakb2wlFfzKdJgH23kygQ%3d%3d",
"title": {
"texts": [{
"text": "titleCS",
"languageId": 1
}
]
},
"label": {
"texts": [{
"text": "labelCS",
"languageId": 1
}
]
},
"color": "123456"
}Description des champs
| Nom | Obligatoire | Commentaires/description |
| id | X | Identifiant unique de la mise en vedette. (Type string) |
| title | Titre de la mise en vedette, sous forme de textes multilingues (texts).
| |
| label | Libellé de la mise en vedette, sous forme de textes multilingues (texts).
| |
| color | Couleur de la pastille de mise en vedette. (Type string) |
Réponse
Exemple de contenu d'appel de réponse de modification d'une mise en vedette :
{
"id": "Eiakb2wlFfzKdJgH23kygQ%3d%3d"
}Description des champs
| Nom | Commentaires/description |
| id | Identifiant unique de la mise en vedette modifiée. (Type string) |
Mise en vedette : catalogspotlight/delete
https://www.domaine.com/lmsapi/catalogspotlight/delete
![]() | Permet de supprimer une mise en vedette existante. |
Requête
Exemple de contenu d'appel de requête de suppression d'une mise en vedette :
{
"id": "j9XoGU3mn7f5K7vuvsg9LQ%3d%3d"
}Description des champs
| Nom | Obligatoire | Commentaires/description |
| id | X | Identifiant unique de la mise en vedette. (Type string) |
Réponse
Exemple de contenu d'appel de réponse de suppression d'une mise en vedette :
{
"id": "j9XoGU3mn7f5K7vuvsg9LQ%3d%3d"
}Description des champs
| Nom | Commentaires/description |
| id | Identifiant unique de la mise en vedette supprimée. (Type string) |
Mise en vedette : catalogspotlight/setworkspaceinstances
https://www.domaine.com/lmsapi/catalogspotlight/setworkspaceinstances
![]() | Permet d'associer des sessions de formation à une mise en vedette. |
Requête
Exemple de contenu d'appel de requête d'association de sessions à une mise en vedette :
{
"id": "Eiakb2wlFfzKdJgH23kygQ%3d%3d",
"spotlightAssociations":
[
{
"id" : "jt9UU9fr%2fppeVdmulnSbPQ%3d%3d",
"activeFromDate": "2010-01-01T00:00:00",
"activeUpToDate": "2031-01-01T00:00:00"
},
{
"id" : "1odV3GTk6pHhgLNDBK1bnQ%3d%3d"
}
]
}Description des champs
| Nom | Obligatoire | Commentaires/description |
| id | X | Identifiant unique de la mise en vedette. (Type string) |
| spotlightAssociations | X | Contient la liste des sessions qui seront associées à la mise en vedette.
|
Réponse
Exemple de contenu d'appel de réponse d'association de sessions à une mise en vedette :
{
"id": "Eiakb2wlFfzKdJgH23kygQ%3d%3d"
}Description des champs
| Nom | Commentaires/description |
| id | Identifiant unique de la mise en vedette. (Type string) |
Mise en vedette : catalogspotlight/getworkspaceinstances
https://www.domaine.com/lmsapi/catalogspotlight/getworkspaceinstances
![]() | Retourne la liste des sessions de formation associées à une mise en vedette. |
Requête
Exemple de contenu d'appel de requête de la liste des sessions associées à une mise en vedette :
{
"id" : "Eiakb2wlFfzKdJgH23kygQ%3d%3d"
}Description des champs
| Nom | Obligatoire | Commentaires/description |
| id | X | Identifiant unique de la mise en vedette. (Type string) |
Réponse
Exemple de contenu d'appel de réponse de la liste des sessions associées à une mise en vedette :
{
"id": "Eiakb2wlFfzKdJgH23kygQ%3d%3d",
"spotlightAssociations": [
{
"id": "jt9UU9fr%2fppeVdmulnSbPQ%3d%3d",
"activeFromDate": "2010-01-01T00:00:00",
"activeUpToDate": "2031-01-01T00:00:00"
},
{
"id": "1odV3GTk6pHhgLNDBK1bnQ%3d%3d",
"activeFromDate": "0001-01-01T00:00:00",
"activeUpToDate": "0001-01-01T00:00:00"
},
{
"id": "C81F0WSGq7p505Q97UjFlQ%3d%3d",
"activeFromDate": "0001-01-01T00:00:00",
"activeUpToDate": "0001-01-01T00:00:00"
}
]
}Description des champs
| Nom | Commentaires/description |
| id | Identifiant unique de la mise en vedette. (Type string) |
| spotlightAssociations | Contient la liste des sessions qui seront associées à la mise en vedette.
|
Mise en vedette : catalogspotlight/setcohorts
https://www.domaine.com/lmsapi/catalogspotlight/setcohorts
![]() | Permet d'associer des cohortes de programme à une mise en vedette. |
Requête
Exemple de contenu d'appel de requête d'association de cohortes à une mise en vedette :
{
"id": "Eiakb2wlFfzKdJgH23kygQ%3d%3d",
"spotlightAssociations":
[
{
"id" : "eWAFhEFBmzdeDcziVz93Ag%3d%3d",
"activeFromDate": "2010-01-01T00:00:00",
"activeUpToDate": "2021-01-01T00:00:00"
}
]
}Description des champs
| Nom | Obligatoire | Commentaires/description |
| id | X | Identifiant unique de la mise en vedette. (Type string) |
| spotlightAssociations | X | Contient la liste des cohortes qui seront associées à la mise en vedette.
|
Réponse
Exemple de contenu d'appel de réponse d'association de cohortes à une mise en vedette :
{
"id": "Eiakb2wlFfzKdJgH23kygQ%3d%3d"
}Description des champs
| Nom | Commentaires/description |
| id | Identifiant unique de la mise en vedette. (Type string) |
Mise en vedette : catalogspotlight/getcohorts
https://www.domaine.com/lmsapi/catalogspotlight/getcohorts
![]() | Retourne la liste des cohortes de programme associées à une mise en vedette. |
Requête
Exemple de contenu d'appel de requête de la liste des cohortes associées à une mise en vedette :
{
"id" : "Eiakb2wlFfzKdJgH23kygQ%3d%3d"
}Description des champs
| Nom | Obligatoire | Commentaires/description |
| id | X | Identifiant unique de la mise en vedette. (Type string) |
Réponse
Exemple de contenu d'appel de réponse de la liste des cohortes associées à une mise en vedette :
{
"id": "Eiakb2wlFfzKdJgH23kygQ%3d%3d",
"spotlightAssociations": [
{
"id": "eWAFhEFBmzdeDcziVz93Ag%3d%3d",
"activeFromDate": "2010-01-01T00:00:00",
"activeUpToDate": "2021-01-01T00:00:00"
}
]
}Description des champs
| Nom | Commentaires/description |
| id | Identifiant unique de la mise en vedette. (Type string) |
| spotlightAssociations | Contient la liste des cohortes qui seront associées à la mise en vedette.
|
Description des codes d’erreurs de mise en vedette
| Numéro | Message | Commentaire/description |
| 2201 | RequiredID | Vous devez fournir un identifiant pour le catalogspotlight |
| 2202 | InvalidID | Vous devez fournir un identifiant valide pour le catalogspotlight |
| 2203 | RequiredTitle | Vous devez fournir un titre |
| 2204 | InvalidTitleLength | La longueur du titre fourni est invalide |
| 2205 | RequiredLabel | Vous devez fournir un libellé |
| 2206 | InvalidLabelLength | La longueur du libellé fourni est invalide |
| 2207 | RequiredSpotlightAssociationID | Vous devez fournir un identifiant pour l'objet d'association |
| 2208 | InvalidSpotlightAssociationID | L'identifiant fourni à l'objet d'association est invalide |
| 2209 | InvalidSpotlightAssociationData | Les données contenues dans l'objet d'association sont invalides |
| 2210 | InvalidActiveFromDate | La date de début d'association n'est pas valide |
| 2211 | InvalidActiveUpToDate | La date de fin d'association n'est pas valide |
| 2212 | InvalidLanguageID | L'identifiant de langue n'est pas valide |
| 2213 | UndefinedLanguageID | L'identifiant de langue ne correspond à aucune langue |
| 2214 | DeleteHasFailed | La suppression a échoué |
| 2215 | AssociationHasFailed | L'association a échoué |


