In onze release van april 2022 hebben we enkele wijzigingen aangebracht in groepen om problemen met time-outs op te lossen terwijl groepen werden gemaakt in Brightspace. De wijzigingen die we hebben aangebracht, hebben ertoe geleid dat het maken van groepscategorieën, hun onderliggende groepen en eventuele inschrijvingen nu worden verwerkt door een achtergrondtaak, zodat groepen altijd met succes worden gemaakt en hun inschrijvingen elke keer worden verwerkt zoals verwacht. Eerder heb je misschien fouten gezien bij het maken van groepscategorieën, waardoor de oudere methode van maken onbetrouwbaar werd. Op dit moment worden deze wijzigingen alleen toegepast op het maken van groepen binnen de Brightspace-interface - in de tool Groepen.
In onze release van juni 2022, of 20.22.06, zullen we dezelfde wijziging aanbrengen in onze API's voor het maken van groepen om dezelfde voordelen te bieden aan deze manier om groepen te maken. Vanaf juni, wanneer u de API-route 'POST /d2l/api/lp/(version)/(orgUnitId)/groupcategories/' gebruikt om een nieuwe groepscategorie in een organisatie-eenheid te maken, ontvangt u een antwoord met een andere statuscode (een 202 Geaccepteerd) dat aangeeft dat uw aanvraag is geaccepteerd, maar nog niet is voltooid. U kunt dan een nieuwe API-route gebruiken om de status van het verzoek voor het maken van de groepscategorie te controleren om er zeker van te zijn dat het met succes is voltooid. Gebruikers die op deze API posten, zouden normaal gesproken een statusbericht van 200 OK hebben gezien als de actie was geslaagd.
Alle API-routes zoals PUT-, POST- of DELETE-aanroepen voor het maken van de momenteel verwerkende groepscategorie zouden mislukken met een nieuw statuscodeantwoord - een 409-conflict - wat aangeeft dat het maken van de groepscategorie nog niet is voltooid en dat er op dit moment geen wijzigingen kunnen worden aangebracht tegen de groepscategorie.
Waarom voeren we deze verandering door?
Om over te stappen op een robuustere manier om groepen te maken en de voordelen te bieden die de nieuwe methode voor het maken van achtergronden ons biedt, moeten we ervoor zorgen dat deze verandering wordt toegepast op alle methoden voor het maken van groepen, zowel binnen de gebruikersinterface als via onze API's op dit moment.
Wat betekent dit voor mij?
Als u onze groepscategorie-API gebruikt als onderdeel van uw proces om groepen binnen organisatie-eenheden te maken, moet u een andere statuscode-reactie verwachten en deze met succes kunnen afhandelen.