Microsoft Learnin hakemiston ohjelmointirajapinnan usein kysytyt kysymykset
Tässä artikkelissa on Microsoft Learnin hakemiston ohjelmointirajapintaa koskevien usein kysyttyjen kysymysten luettelo sekä vastaukset ja linkit tarvittaessa lisätietoihin.
Yleiset
Kysymys: Kuinka paljon Learnin hakemiston ohjelmointirajapinnan käyttäminen maksaa?
Learn-hakemiston ohjelmointirajapinnan käyttäminen ei maksa mitään. Lisätietoja on Learnin hakemiston ohjelmointirajapinnan ominaisuuksien yleiskatsaus -artikkelin kohdassa Saatavuus ja hinnoittelu.
Kysymys: Mitkä ovat Learnin hakemiston ohjelmointirajapinnan käytön säännöt?
Tutustu Microsoft Learnin ja Microsoftin ohjelmointirajapinnan käyttöehtoihin.
K: Onko minun otettava käyttöön tai hankittava avaimia, jotta voin käyttää Learnin hakemiston ohjelmointirajapintaa?
Ei. Ohjelmointirajapinta on julkisesti käytettävissä. Lisätietoja on artikkelissa Learnin hakemiston ohjelmointirajapinnan käytön aloittaminen cURL:n ja Visual Studio Coden avulla ja/tai artikkelissa Learnin hakemiston ohjelmointirajapinnan kehittäjäviite.
K: antaako tämä ohjelmointirajapinta käyttäjiemme käyttää Learn-sisältöä ympäristössämme?
Ei. Learnin hakemiston ohjelmointirajapinta tarjoaa metatietoja sisällöstä ja suoria linkkejä sisältöön. Käyttäjät voivat integroida nämä linkit mihin tahansa oppimisenhallintajärjestelmään tai verkkokokemukseen Microsoftin ohjelmointirajapinnan käyttöehtojen mukaisesti.
K: Pysyvätkö Learn-hakemiston ohjelmointirajapinnasta palautetut tiedot staattisina vai muuttuvatko ne?
Tiedot muuttuvat aina, kun uutta sisältöä lisätään, muokataan tai poistetaan, mikä tapahtuu yleensä päivittäin.
Ohjelmointirajapinnan vastaus
K: Voinko hakea kaikki tiedot kerralla?
Kyllä. Saat täyden vastauksen käyttämällä peruspäätepistettä learn.microsoft.com/api/catalog. Katso lisätietoja API-pyyntöjen ohjeartikkelista Learnin hakemiston ohjelmointirajapinnan kehittäjäviittaus.
K: Voinko suodattaa vastauksen ennalta?
Kyllä. Katso kyselysuodattimet, jotka ovat käytettävissä Learnin hakemiston ohjelmointirajapinnan kehittäjäviittaus -artikkelissa.
K: Ovatko yksilöivät UID-tunnukset kullekin sisältöobjektille?
Kyllä. UID tarkoittaa yksilöllistä tunnusta, ja se on yksilöllinen kullekin sisältöobjektille. Jos UID-tunnus muuttuu, vaikka otsikko tai muut metatiedot pysyvät samoina, sisältöä pidetään uutena objektina.
Kysymys: miksi moduulin yhteenvedossa on HTML-tunnisteita?
Pyrimme yleensä pitämään yhteenvedon muotoilun mahdollisimman puhtaana, mutta joskus tiettyjä tekstejä on korostettava tai linkitettävä.
Kysymys: miksi yksittäisiin oppitunteihin ei ole linkkejä?
Oppitunteja ei kirjoiteta erillisenä sisältönä. Ne on tarkoitettu suoritettavaksi moduulissa tietyssä järjestyksessä. Tästä syystä lisäämme linkin moduulin tietosivulle ja ensimmäiseen oppituntiin, jotta käyttäjät voivat aloittaa siitä ja jatkaa sitten sisällön läpi.
Kysymys: mistä tiedän, mikä on uutta sisältöä?
last_modified arvo kertoo, milloin tietuetta viimeksi muokattiin.
Kysymys: Onko kertakirjautuminen (SSO) käytössä sisältölinkeille?
Et tällä hetkellä. Tavoitteenamme on mahdollistaa kertakirjautuminen tulevaisuudessa.
Sisältö
Kysymys: UID-tunnus sisältökohtainen?
Kyllä. UID tarkoittaa yksilöllistä tunnusta, ja se on yksilöllinen kullekin sisältöobjektille. Jos UID-tunnus muuttuu, vaikka otsikko tai muut metatiedot pysyvät samoina, sisältöä pidetään uutena objektina.
K: ovatko kaikki moduulit osa jotain oppimispolkua?
Ei. Moduulit kykenevät seisomaan yksin siinä mielessä, että ne opettavat skenaarioita tai käsitteitä niiden sisältä, eivätkä ne vaadi edellytettävien moduulien käyttöä. Joillekin moduuleille tämä riittää, jolloin ne eivät ole osa mitään oppimispolkua. Toiset moduulit taas kootaan osaksi yhtä tai useampaa oppimispolkua, joiden avulla käyttäjä voi opetella vaativampia asioita. Moduulin ei siis tarvitse olla osa oppimispolkua, mutta se voi olla osa yhtä tai useampaa oppimispolkua.
Kysymys: Ohjevalikko tietävät, milloin sisältöä on lisätty, päivitetty tai poistettu?
Kun uusia sisältöobjekteja lisätään, ne näkyvät vastauksessa uutena objektina (yksilöitynä YKSILÖIVÄN tunnisteen avulla). Kun sisältöä muokataan, näet sen last_modified arvon perusteella. Kun sisältö poistetaan, sisältöobjekti poistetaan vastauksesta. Vaikka ohjelmointirajapinnan vastauksessa päivittyvässä sisällössä on joskus pieni viive, käyttäjä näkee aina sisällön URL-osoitteen ajantasaisimmat tiedot. Kun sisältö poistetaan, vanha URL-osoite uudelleenohjataan uuteen sisältöön tai käyttökokemukseen tai seuraavaan parhaaseen vaihtoehtoon.
Erityisesti sisältöä päivitetään koko ajan. Saatavilla olevat päivitykset julkaistaan kahdesti päivässä. Ne voivat olla pieniä, kuten vähäisiä tekstimuutoksia tai merkittäviä, kuten merkittäviä muutoksia, lisäyksiä tai poistoja. Yleisesti ottaen sisältösalkkua hallitaan valtavana, hyvin hallittuna avoimen lähdekoodin projektina, jossa on tuhansia osallistujia, ja näin ollen muutoksia tapahtuu jatkuvasti. Jos käytät Learnin hakemiston ohjelmointirajapintaa tuotantojärjestelmässäsi, sinun on syytä olla tietoinen tästä ja antaa järjestelmäsi käsitellä sitä.
Kysymys: Seurasin kirjanmerkillä merkittyä linkkiä sisältöön, mutta nyt se näyttää minulle erilaisen sisällön kuin odotin. Miksi?
Pyrimme varmistamaan, että kukaan ei osu umpikujaan (404) linkeillä sivustollemme. Kun sisältöä muokataan tai korvataan, otat käyttöön uudelleenohjauksen vanhalle linkille, joka vie sinut automaattisesti uuteen sisältöön. Jos sisältö poistetaan käytöstä eri syistä eikä sitä korvata, uudelleenohjataan seuraavaan parhaaseen sopivaan sisältöön, joka voi olla hieman muokattu vaikutusalue tai aloitussivulle jne.
Kysymys: Ohjevalikko pääset käyttämään dokumentaatio-, video- ja koodimalliluetteloita?
Tällä hetkellä ei ole ohjelmallista tapaa päästä käyttämään näitä luetteloita. Tavoitteenamme on mahdollistaa näiden luetteloiden ohjelmallinen käyttö tulevaisuudessa.
Lokalisointi
Kysymys: Mitä kieliä Microsoft Learnissa on saatavilla?
Microsoft Learnissa on käytettävissä yli 65 kieliasetusta. Näet täydellisen luettelon täällä sivuston alatunnisteen kautta (valitse tarkastelemasi kieli, jotta näet koko luettelon).
Kysymys: Onko sisältöä saatavilla muilla kielillä?
Riippuu tilanteesta. Tavoitteenamme on saada sisältö saataville kaikilla kielillä, joilla sisällössä opetettavat tuotteet ovat saatavilla. Kun opiskelijat vierailevat Microsoft Learn -sivustossa tietyllä alueella ja jos sisältö ei ole käytettävissä kyseisellä alueella, käyttäjä näkee ylä- ja alatunnisteen haluamassaan kieliasetuksessa, ja ydinsisällön oletuksena on englanti, kunnes lokalisoitu versio on saatavilla.
Kysymys: Onko tietyn sisältöobjektin sisältö erilainen sen mukaan, millä kielellä sitä tarkastelet?
Mahdollisesti. Kun englanninkieliseen sisältöön julkaistaan päivityksiä, lokalisointijaksot pyrimme saamaan lokalisoidut versiot päivitettyä mahdollisimman pian – yleensä muutaman päivän kuluessa alkuperäisestä muutoksesta.
Muu
Kysymys: Onko raportoinnin ohjelmointirajapintaa tai toimintoja, joiden avulla voit hakea tietoja, kuten näkymiä, napsautuksia, valmistumista?
Meillä ei ole raportoinnin ohjelmointirajapintaa tällä hetkellä. Tarjoamme organisaatioraportointitoimintoja, joiden avulla organisaatiot voivat raportoida käyttäjiensä valmistumisista.
Seuraavat vaiheet
Lisätietoja Learn-hakemiston ohjelmointirajapinnasta on seuraavissa linkeissä: