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

K: 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.

K: Mitkä ovat Learnin hakemiston ohjelmointirajapinnan käytön säännöt?

Tutustu Microsoft Learnin - ja Microsoftin ohjelmointirajapinnan käyttöehtojen .

K: Onko minun otettava käyttöön tai hankittava avaimia, jotta voin käyttää Learnin hakemiston ohjelmointirajapintaa?

Ei. Ohjelmointirajapinta on julkisesti käytettävissä. Katso Learnin hakemiston ohjelmointirajapinnan käytön aloittaminen cURL:n ja Visual Studio Coden avulla -artikkelista ja/tai Learnin hakemiston ohjelmointirajapinnan kehittäjäviiteartikkelista.

K: Salliiko tämä ohjelmointirajapinta käyttäjiemme käyttää Learn-sisältöä käyttö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öehtojenmukaisesti.

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 ohjelmointirajapintapyyntöjen Learnin hakemiston ohjelmointirajapinnan kehittäjäviiteartikkelista.

K: Voinko suodattaa vastauksen ennalta?

Kyllä. Katso kyselysuodattimet, jotka ovat käytettävissä Learnin hakemiston ohjelmointirajapinnan kehittäjäviittausta artikkelissa.

kysymys: Ovatko yksilöivät tunnisteet 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.

K: Miksi moduulin yhteenvedossa on HTML-tunnisteita?

Pyrimme yleensä pitämään yhteenvedon muotoilun mahdollisimman raakana, mutta joskus täytyy korostaa tai linkittää tiettyä tekstiä.

K: Miksi yksittäisille yksiköille ei ole linkkejä?

Yksikköjä ei kirjoiteta erillisenä sisältönä. Ne on tarkoitettu moduulia varten tietyssä järjestyksessä. Tästä syystä lisäämme linkin moduulin tietosivulle ja ensimmäiseen osioon, jotta käyttäjät voivat aloittaa siitä ja jatkaa sisällön läpi.

K: Mistä tiedän, mikä sisältö on uutta?

last_modified arvo kertoo, milloin tietuetta viimeksi muokattiin.

K: Onko single Sign-On (SSO) otettu käyttöön sisältölinkeille?

Et tällä kertaa. Tavoitteenamme on mahdollistaa kertakirjautuminen tulevaisuudessa.

Sisältö

kysymys: Onko yksilöivä yksilöivä tunniste sisällössä?

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: Ovatko kaikki moduulit osa 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 tämä on se, eivätkä he ole osa oppimispolkua. Toisille taas ne kootaan yhteen yhteen tai useampaan oppimispolkuun, joiden avulla käyttäjä voi luoda edistyneempiä käsitteitä. Moduulin ei tarvitse olla osa oppimispolkua, tai se voi olla osa yhtä tai useampaa.

K: Mistä tiedän, 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.

K: Miten voin käyttää 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

K: Mitkä kielet ovat käytettävissä Microsoft Learnissa?

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).

K: 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.

K: Onko sisältö erilainen tietylle sisältöobjektille 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.

Toinen

kysymys: Onko raportoinnin ohjelmointirajapintaa tai toimintoja, joiden avulla voidaan hakea tietoja, kuten näkymiä, napsautuksia, valmistumista?

Meillä ei ole raportoinnin ohjelmointirajapintaa tällä hetkellä. Meillä on organisaation raportointitoiminnoista, joiden avulla organisaatiot voivat raportoida käyttäjiensä valmistumisesta.

Seuraavat vaiheet

Lisätietoja Learn-hakemiston ohjelmointirajapinnasta on seuraavissa linkeissä:

• Microsoft Learnin hakemiston ohjelmointirajapinnan ominaisuuksien yleiskatsaus
• Microsoft Learnin hakemiston ohjelmointirajapinnan käytön aloittaminen