Návod na integraci katalogu kurzů do LMS Degreed
Tento dokument popisuje proces automatizovaného nahrávání kurzů ze Seduo.cz do platformy Degreed. Integrace probíhá formou pravidelného exportu metadat kurzů (CSV soubor) na SFTP server, odkud si je Degreed načítá.
Pro kompletní funkčnost je nutné mít nastavené také SSO (pro přihlášení) a xAPI (pro zápis výsledků studia).
Tento článek slouží jako popis pro správce Degreed (LMS Admin) pro povolení Seduo jako poskytovatele obsahu a importu dat.
Průběh synchronizace (logický tok)
Generování: Seduo vygeneruje CSV export s aktuální nabídkou kurzů (včetně nových a aktualizovaných).
Přenos: Seduo nahraje tento soubor na SFTP server (zřízený zákazníkem/Degreedem).
Import: Degreed si soubor automaticky stáhne a zpracuje (zpravidla 1x denně).
Studium: Uživatel klikne na kurz v Degreedu → přes SSO je přihlášen do Seduo → začíná studovat.
Reporting: Výsledky studia (dokončení) odesílá Seduo zpět do Degreedu (nebo propojeného LRS) přes xAPI v reálném čase.
Požadavky na stranu zákazníka (IT / Degreed Admin)
Pro zprovoznění integrace je potřeba zajistit následující kroky na straně infrastruktury a konfigurace Degreed.
1. Zřízení SFTP přístupu
Degreed musí vytvořit SFTP účet, kam budeme nahrávat CSV soubor. Je nutné povolit (whitelistovat) následující IP adresy Seduo pro přístup k vašemu SFTP serveru na portu 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. Konfigurace mapování v Degreed (CSV Template)
Degreed musí nastavit šablonu importu tak, aby odpovídala struktuře našeho CSV souboru (vychází ze standardu Degreed). Zasílaný soubor obsahuje následující sloupce a jejich hodnoty:
ContentType: Pevná hodnota Course.
ContentID: Unikátní ID kurzu v Seduo.
URL: Přímý odkaz na kurz (obsahuje parametr pro automatické SSO přihlášení).
Delete: Indikátor smazání. N = aktivní kurz, Y = kurz stažen z nabídky/skryt.
Title: Název kurzu.
Summary: Popis/anotace kurzu.
ImageURL: URL adresa náhledového obrázku.
Duration: Délka kurzu v hodinách (desetinné číslo, např. 0.35583333).
DurationUnits: Pevná hodnota Hours.
Language: Kód jazyka, např. cs.
Format: Pevná hodnota Online.
Publish Date: Datum publikace (ISO 8601, např. 2015-06-05T20:18:36.000-04:00).
Owner: Jména lektorů (oddělená čárkou).
Abilities: Kompetence/štítky (oddělené čárkou).
Údaje pro konfiguraci (Předat Seduo)
Abychom mohli začít nahrávat data, zašlete nám prosím bezpečně přístupové údaje k vytvořenému SFTP
SFTP Host: (Adresa serveru)
SFTP Port: (Standardně 22)
SFTP Username: (Uživatelské jméno)
SFTP Password: (Heslo)
Související nastavení (Nezapomeňte)
Tato integrace řeší pouze katalog kurzů. Pro plnou funkčnost a jednoduchost pro uživatele, je dobré implementovat i:
SSO (SAML 2.0): Nezbytné pro funkčnost odkazů v sloupci URL. (Viz článek ohledně SSO). Uživatel nebude muset řešit přihlášní na platformě Seduo.
xAPI Reporting: Nezbytné pro odesílání informací o tom, že uživatel kurz dokončil. (Viz článek xAPI). Degreed podporuje získávání výsledků studia a to stav dokončení kurzu