Návod na integráciu katalógu kurzov do LMS Degreed
Tento dokument opisuje proces automatizovaného nahrávania kurzov zo Seduo.cz do platformy Degreed. Integrácia prebieha formou pravidelného exportu metadát kurzov (CSV súbor) na SFTP server, odkiaľ si ich Degreed načítava.
Pre kompletnú funkčnosť je nutné mať nastavené aj SSO (na prihlásenie) a xAPI (na zápis výsledkov štúdia).
Tento článok slúži ako opis pre správcu Degreed (LMS Admin) na povolenie Seduo ako poskytovateľa obsahu a importu dát.
Priebeh synchronizácie (logický tok)
Generovanie: Seduo vygeneruje CSV export s aktuálnou ponukou kurzov (vrátane nových a aktualizovaných).
Prenos: Seduo nahrá tento súbor na SFTP server (zriadený zákazníkom/Degreedom).
Import: Degreed si súbor automaticky stiahne a spracuje (spravidla 1x denne).
Štúdium: Používateľ klikne na kurz v Degreede → cez SSO je prihlásený do Seduo → začína študovať.
Reporting: Výsledky štúdia (dokončenie) odosiela Seduo späť do Degreedu (alebo prepojeného LRS) cez xAPI v reálnom čase.
Požiadavky na stranu zákazníka (IT / Degreed Admin)
Na sprevádzkovanie integrácie je potrebné zaistiť nasledujúce kroky na strane infraštruktúry a konfigurácie Degreed.
1. Zriadenie SFTP prístupu
Degreed musí vytvoriť SFTP účet, kam budeme nahrávať CSV súbor. Je nutné povoliť (whitelistovať) nasledujúce IP adresy Seduo na prístup k vášmu SFTP serveru na porte 22:
185.120.68.37/8
10.8.6.0/24
185.120.69.0/24
185.120.68.0/24
95.173.210.128/27
95.173.210.160/27
15.197.158.115
35.71.162.162
2. Konfigurácia mapovania v Degreed (CSV Template)
Degreed musí nastaviť šablónu importu tak, aby zodpovedala štruktúre nášho CSV súboru (vychádza zo štandardu Degreed). Zasielaný súbor obsahuje nasledujúce stĺpce a ich hodnoty:
ContentType: Pevná hodnota
Course.ContentID: Unikátne ID kurzu v Seduo.
URL: Priamy odkaz na kurz (obsahuje parameter na automatické SSO prihlásenie).
Delete: Indikátor zmazania.
N= aktívny kurz,Y= kurz stiahnutý z ponuky/skrytý.Title: Názov kurzu.
Summary: Popis/anotácia kurzu.
ImageURL: URL adresa náhľadového obrázka.
Duration: Dĺžka kurzu v hodinách (desatinné číslo, napr. 0.35583333).
DurationUnits: Pevná hodnota
Hours.Language: Kód jazyka, napr.
cs.Format: Pevná hodnota
Online.Publish Date: Dátum publikácie (ISO 8601, napr. 2015-06-05T20:18:36.000-04:00).
Owner: Mená lektorov (oddelené čiarkou).
Abilities: Kompetencie/štítky (oddelené čiarkou).
Údaje pre konfiguráciu (Odoslať do Seduo)
Aby sme mohli začať nahrávať dáta, zašlite nám, prosím, bezpečne prístupové údaje k vytvorenému SFTP:
SFTP Host: (Adresa servera)
SFTP Port: (Štandardne 22)
SFTP Username: (Používateľské meno)
SFTP Password: (Heslo)
Súvisiace nastavenia (Nezabudnite)
Táto integrácia rieši iba katalóg kurzov. Pre plnú funkčnosť a jednoduchosť pre používateľa je dobré implementovať aj:
SSO (SAML 2.0): Nevyhnutné pre funkčnosť odkazov v stĺpci URL. (Pozri článok o SSO). Používateľ nebude musieť riešiť prihlásenie na platforme Seduo.
xAPI Reporting: Nevyhnutné na odosielanie informácií o tom, že používateľ kurz dokončil. (Pozri článok xAPI). Degreed podporuje získavanie výsledkov štúdia, a to stavu dokončenia kurzu.