Inleiding
De Exchange-integratie zet het rooster uit Xedule in de Outlook-agenda's van medewerkers, studenten en faciliteiten. U publiceert per week en per organisatorische eenheid, en u kiest daarbij zelf van welke personen en faciliteiten de agenda wordt bijgewerkt. Er komen geen gegevens uit Exchange terug naar Xedule.
De integratie werkt via de Graph-API van Microsoft. Daarvoor richt de instelling in Azure een eigen Application Registration in; Xedule gebruikt die om de agenda's bij te werken. Er bestaat ook nog een ouder protocol met een serveradres, een account en een wachtwoord. Zodra het Application id is ingevuld en opgeslagen, schakelt Xedule automatisch over op de Graph-API en worden de velden Server, Account en Password niet meer gebruikt. Dit document beschrijft de werking met de Graph-API; waar het oudere protocol afwijkt, staat dat erbij.
Een publicatie werkt per postbus. Xedule leest in elke betrokken agenda alleen de afspraken die het zelf eerder heeft aangemaakt, vergelijkt die met het rooster van de gepubliceerde dagen en maakt aan, werkt bij of verwijdert. Afspraken van de gebruiker zelf en afspraken buiten de gepubliceerde dagen blijven ongemoeid.
Randvoorwaarden en functionele eisen
De Graph-API in Azure
- In Microsoft Azure is een Application Registration aangemaakt. Daarbij worden een Application ID en een Tenant ID zichtbaar; beide legt u in Xedule vast (paragraaf “Verbinding met de Graph-API”).
- Bij Certificates & Secrets is een Client Secret aangemaakt. Die waarde is eenmalig zichtbaar en moet direct worden overgenomen.
- Een Application Secret heeft altijd een verloopdatum. Vernieuw de secret vóór die datum en vul de nieuwe waarde in Xedule in de Exchange-configuratie in en sla die op. Gebeurt dat niet, dan kan Xedule de agenda's niet meer bijwerken.
- Voor het aanmaken van online meetings richt de systeembeheerder een Application Access Policy in en autoriseert daarin de betrokken gebruikers. Microsoft beschrijft dit in de documentatie over de application access policy voor online meetings.
- Het advies is om per organisatorische eenheid een eigen Graph-API in te richten. Zo voorkomt u dat publicaties uit verschillende eenheden samen via één Graph-API de limieten van Microsoft raken.
Rechten van de Graph-API
De Graph-API heeft twee soorten permissies nodig: Application en Delegated. De onderstaande permissies moeten zijn toegevoegd.
| Soort | Permissie | Waarvoor |
|---|---|---|
| Application | Calendars.Read | De bestaande afspraken in een agenda lezen. |
| Application | Calendars.ReadWrite | Afspraken aanmaken, bijwerken en verwijderen. |
| Application | MailboxSettings.Read | De instellingen van de postbus lezen. |
| Delegated | User.Read | De aangemelde gebruiker herkennen. |
| Application | User.Read.All | Een e-mailadres opzoeken in de directory. Vereist toestemming van een beheerder. |
| Delegated (werk- of schoolaccount) | OnlineMeetings.ReadWrite | Teams-meetings aanmaken en bijwerken. |
| Application | OnlineMeetings.ReadWrite.All | Idem, namens de gebruikers. Vereist toestemming van een beheerder. |
Een persoonlijk Microsoft-account wordt niet ondersteund. De laatste drie permissies zijn het minimum voor het werken met online meetings, waaronder de knop Maak online beschikbaar in MyXedule (paragraaf “Online lessen en Teams-meetings”).
Inrichtingseisen in Xedule
- De module Exchange onder Services is geactiveerd. Daarmee komen de configuratiepagina en de service in Export, onderdeel Services, beschikbaar.
- Bij medewerkers, studenten en — indien van toepassing — faciliteiten is het veld e-mail gevuld. Dit is het belangrijkste inrichtingspunt: het e-mailadres bepaalt wie wordt bijgewerkt. Een deelnemer zonder e-mailadres gaat niet mee.
- De e-mailadressen komen uit het domein van de schoolorganisatie. Een extern adres kan nooit organisator zijn; het gebruik van externe adressen zoals gmail, live, icloud, outlook of yahoo wordt afgeraden.
- Elk vak heeft een unieke vakcode. Regels met een afwijkende code maar dezelfde vakcode worden als hetzelfde vak behandeld. Dit is van belang voor het hergebruik van Teams-meetings (paragraaf “Online lessen en Teams-meetings”).
- Voor de kleuren van de afspraken gebruikt u de categoriekleuren die in Outlook standaard beschikbaar zijn (paragraaf “Nieuwe, gewijzigde en verwijderde afspraken”).
- Wilt u met online lessen werken, dan markeert u een activiteit in Roosteren als online meeting. Daarvoor is in de overzichten Lessen (Periode/Week) en Weekroosters een kolom beschikbaar, standaard zichtbaar in het overzicht Publicatie.
De configuratiepagina
De koppeling wordt ingericht via Beheer, onderdeel Configuratie. De verbindingsgegevens kunt u organisatiebreed vastleggen of per organisatorische eenheid; de instellingen over de afspraken zelf gelden voor de gehele organisatie. Voor onderwijsinstellingen die de integratie al langer gebruiken kunnen hier nog waarden bij Server, Account en Password staan. De Graph-API gebruikt die velden niet.
Verbinding met de Graph-API
| Veld | Waarde / voorbeeld | Toelichting |
|---|---|---|
| Application id | De Application ID uit Azure | Zodra dit veld gevuld is — organisatiebreed of bij de eenheid — gebruikt Xedule de Graph-API. Is het nergens gevuld, dan valt Xedule terug op het oudere protocol met Server, Account en Password. |
| Application secret | ••••••••• | De Client Secret die bij deze registratie hoort. De waarde wordt niet aan andere gebruikers getoond en heeft een verloopdatum (paragraaf “De Graph-API in Azure”). |
| Tenant id | De Tenant ID uit Azure | De Microsoft-omgeving waarin de Graph-API is ingericht. |
| Shared organiser | een e-mailadres | Optioneel. Zie paragraaf “Shared organiser”. De invoer wordt op het formaat van een e-mailadres gecontroleerd. |
| Server, Account, Password | niet van toepassing | Alleen in gebruik bij het oudere protocol. Het serveradres wordt op het formaat van een webadres gecontroleerd en het account op dat van een e-mailadres. |
Instellingen over de afspraken
Met de onderstaande instellingen bepaalt u hoe de afspraken in de agenda's terechtkomen. De velden Subject, Body en Location zijn maskers: u kiest uit een vaste lijst met gegevens van de activiteit, de groep, de student, de medewerker of de faciliteit, en u kunt die combineren met vaste tekst. Enkele zaken staan voor deze integratie vast en zijn niet instelbaar; die staan in hoofdstuk “Inhoud van een afspraak”.
| Instelling | Betekenis en standaardwaarde |
|---|---|
| Throttling | Het maximale aantal agenda's dat tegelijk wordt verwerkt, en daarmee het maximale aantal gelijktijdige aanroepen naar de Graph-API. Standaard: 200. Staat de waarde op nul, dan wordt 200 gebruikt. |
| Hybride mode publication | Bepaalt de publicatiemethode. Standaard: uit. Zie de paragrafen 4.2 en 4.3. |
| Students can be organiser | Bepaalt of een student organisator kan zijn wanneer Hybride mode publication uit staat. Standaard: aan. Zie paragraaf “Hybride mode uit: organisator en deelnemers”. |
| Create online meeting in publication | Vraagt bij de publicatie een Teams-meeting op voor activiteiten die als online meeting zijn gemarkeerd. Standaard: uit. Zie paragraaf “Online lessen en Teams-meetings”. |
| New event color / Modified event color / Removed event color | De categoriekleur voor een nieuwe, een gewijzigde en een verwijderde afspraak. Zie paragraaf “Nieuwe, gewijzigde en verwijderde afspraken”. |
| Remove removed events | Bepaalt of afspraken die niet meer in het rooster staan automatisch worden verwijderd of alleen worden gemarkeerd. Zie paragraaf “Nieuwe, gewijzigde en verwijderde afspraken”. |
| Subject | Wordt het onderwerp van de afspraak in Outlook. |
| Body | Wordt de inhoud van de afspraak in Outlook. |
| Location | Wordt de locatie van de afspraak in Outlook. |
| Vrij/bezet per soort activiteit | Per soort activiteit — les, bpv, vakantie, afspraak en toets — en apart voor een conceptrooster stelt u in hoe de afspraak in de agenda staat. Zie paragraaf “Vrij/bezet-status”. |
| Geplande uitval exporteren | Werkt niet voor deze integratie: deze momenten worden vlak voor het bijwerken van de agenda's uit het rooster gehaald. Zie paragraaf “Welke momenten niet worden meegestuurd”. |
Shared organiser
Normaal wordt per afspraak een organisator uit de deelnemers gekozen (paragraaf “Hybride mode uit: organisator en deelnemers”). Met een Shared organiser — een centrale organisator — werkt dat anders: alle uitnodigingen worden dan vanuit één account verstuurd. Dat account moet gemachtigd zijn om afspraken aan te maken.
Alle afspraken van de publicatie komen dan in de agenda van dat ene account te staan. Alle overige deelnemers worden reguliere deelnemers en zijn dus geen organisator meer — daar is er immers maar één van. Dat geldt ook voor medewerkers.
Met een centrale organisator staan alle afspraken in één agenda.
Bij het inrichten en gebruiken van deze functie gelden vier aandachtspunten:
- De functie werkt alleen met de Graph-API, dus met een gevuld Application id.
- De functie werkt alleen wanneer Hybride mode publication uit staat. Zet u beide aan, dan komen gewone lessen bij niemand in de agenda: de publicatie verwerkt dan uitsluitend de centrale organisator, terwijl de afspraken naar de agenda's van de afzonderlijke deelnemers worden gestuurd. Alleen online lessen komen dan nog bij de centrale organisator terecht, omdat die altijd volgens de andere methode worden gepubliceerd.
- Voer geen centrale organisator in voor een e-mailadres waarvoor al lessen via deze integratie zijn geëxporteerd.
- Waar u het adres invult, bepaalt of het werkt. Heeft een organisatorische eenheid een eigen Application id, dan geldt uitsluitend de Shared organiser die bij díe eenheid staat — ook wanneer dat veld daar leeg is. De organisatiebrede Shared organiser wordt in dat geval niet gebruikt. Vul de centrale organisator dus in bij dezelfde eenheid waar het Application id staat.
Het rooster publiceren
Het scherm Export – Services en het venster Selecteer
Publiceren gaat via het hoofdmenu Export, onderdeel Services. Bovenaan kiest u in Instellingen de periode en de week; in de lijst met services staat Exchange met tijdsbestek week. De wereldbol is pas actief wanneer u een week hebt geselecteerd en u rechten op de actie hebt.
Klikt u op de wereldbol, dan opent het venster Selecteer. Daarin kiest u de medewerkers, de studenten en de faciliteiten van wie de agenda moet worden bijgewerkt, en in de Daglijst de dagen die u publiceert. U moet ten minste één medewerker, student of faciliteit kiezen én ten minste één dag; anders volgt de melding dat een keuze verplicht is en wordt er niets gepubliceerd. Alleen de gekozen personen en faciliteiten worden verwerkt: zij bepalen welke agenda's worden bijgewerkt en wie als deelnemer op een afspraak komt te staan.
Na Ok wordt voor elke geselecteerde week één publicatie gestart. In het paneel Resultaten onderin volgt u de voortgang en kunt u de meldingen opvragen (hoofdstuk “Foutafhandeling en meldingen”).
Hybride mode uit: organisator en deelnemers
Dit is de standaardmethode. Per afspraak wordt één organisator gekozen uit de gekozen deelnemers: de eerste medewerker, op alfabetische volgorde van e-mailadres. Staat Students can be organiser aan en is er geen medewerker bij de afspraak, dan kan een student organisator worden. De afspraak komt in de agenda van die organisator te staan, met de overige gekozen deelnemers en faciliteiten als deelnemer; zij krijgen de afspraak via de uitnodiging in hun agenda.
Is er voor een afspraak geen organisator te bepalen — bijvoorbeeld omdat er geen medewerker bij hoort en studenten geen organisator mogen zijn — dan wordt die afspraak niet gepubliceerd.
Hybride mode aan: iedereen een eigen afspraak
Staat Hybride mode publication aan, dan krijgt iedere gekozen deelnemer de afspraak in zijn eigen agenda, zonder deelnemers en zonder uitnodiging. Er is dan geen organisator meer. Voor het bijwerken van een bestaande afspraak die nog deelnemers had, worden die deelnemers verwijderd; zij krijgen een afzegging, die in de nazorg wordt opgeruimd (paragraaf “Accepteren en opruimen na de publicatie”).
Online lessen vormen hierop de uitzondering: die worden altijd volgens de methode van paragraaf “Hybride mode uit: organisator en deelnemers” gepubliceerd, zodat de Teams-link kan worden aangemaakt en meegestuurd.
De twee publicatiemethoden en het gevolg van een fout.
Overstappen tussen beide methoden
Van uit naar aan is de overstap naadloos. U zet het vinkje aan en publiceert alle relevante weken opnieuw. Deelnemers krijgen dan hun eigen afspraak, en de afspraak die zij eerder via de uitnodiging hadden wordt afgezegd. Tijdelijk staan er dus twee afspraken in hun agenda; de afgezegde wordt in de laatste stap automatisch verwijderd.
Van aan naar uit is de overstap naadloos wanneer het alleen om medewerkers gaat: u zet het vinkje uit en publiceert de betreffende lessen opnieuw. Gaat het om medewerkers én studenten, dan moet u bij die eerste herpublicatie ook Students can be organiser aanzetten. Dat is nodig om de eigen afspraken van studenten correct te laten verwijderen; zonder dat blijven er dubbele afspraken staan. Stond die instelling oorspronkelijk uit, dan mag u hem daarna weer uitzetten.
Nieuwe, gewijzigde en verwijderde afspraken
Xedule herkent zijn eigen afspraken aan een sleutel die begint met Xedule en de naam van de organisatorische eenheid; afspraken uit een reservering worden apart herkend. Per agenda wordt de gepubliceerde week gelezen en vergeleken met het rooster.
Wat er per agenda gebeurt.
- Staat de afspraak in beide, dan wordt hij bijgewerkt: onderwerp, inhoud, locatie, begin- en eindtijd, vrij/bezet-status en deelnemers. Er wordt alleen daadwerkelijk bijgewerkt wanneer er iets is veranderd, en de afspraak krijgt de kleur voor een gewijzigde afspraak.
- Staat er een Xedule-afspraak in de agenda die niet meer in het rooster voorkomt, en valt die op een gepubliceerde dag, dan wordt hij verwijderd wanneer Remove removed events aan staat. Staat die instelling uit, dan blijft de afspraak staan en krijgt hij de kleur voor een verwijderde afspraak.
- Staat de afspraak alleen in het rooster, dan wordt hij aangemaakt met de kleur voor een nieuwe afspraak.
- Afspraken buiten de gepubliceerde dagen worden niet aangeraakt. Publiceert u dus alleen maandag, dan verandert er in de rest van de week niets.
De kleuren komen uit de categorieënlijst van de agenda zelf en worden op kleur opgezocht. Heeft een gebruiker geen categorie met die kleur, dan krijgt de afspraak geen categorie; gebruik daarom de kleuren die standaard beschikbaar zijn.
De inhoud van de afspraak wordt door Xedule tussen twee vaste markeringen geplaatst. Tekst die iemand daarbuiten in de afspraak zet, blijft bij een volgende publicatie staan.
Houd rekening met extra doorlooptijd aan de Exchange-zijde. De Graph-API verwerkt de opdrachten via een wachtrij, waardoor het langer kan duren voordat alle verwijderingen zijn doorgevoerd. Opnieuw publiceren voordat alles is verwerkt is niet nodig en maakt het verwerken alleen langzamer.
Accepteren en opruimen na de publicatie
Na de publicatie start een taak op de achtergrond die de agenda's netjes achterlaat. Die wacht een minuut en loopt daarna de betrokken agenda's langs: afspraken waarop nog niet is gereageerd worden geaccepteerd en afgezegde afspraken worden verwijderd. De taak raakt alleen afspraken met een andere organisator die de markering van Xedule in de inhoud hebben, en herhaalt zichzelf voor agenda's waarin iets is bijgewerkt tot er niets meer te doen is.
De taak die na de publicatie de agenda's afrondt.
Deze taak loopt buiten de publicatie om. De status in Xedule kan dus al op gereed staan terwijl Exchange nog bezig is.
Inhoud van een afspraak
Eigenschappen van een afspraak
Elke afspraak in de agenda wordt met de onderstaande eigenschappen gevuld. Wat er in het onderwerp, de inhoud en de locatie staat, bepaalt u met de maskers uit paragraaf “Instellingen over de afspraken”; de overige eigenschappen staan vast.
| Extern veld (exacte benaming) | Betekenis | Vulling vanuit Xedule | Verwerking / filter |
|---|---|---|---|
| TransactionId | De sleutel waaraan Xedule de afspraak herkent. | Xedule, de naam van de eenheid en de activiteit, met volgnummer, jaar en week en of de activiteit online is. | Staat vast en is niet instelbaar. Afspraken uit een reservering krijgen een eigen opbouw. Verandert de naam van de eenheid, dan herkent Xedule zijn eerdere afspraken niet meer. |
| Subject | Het onderwerp van de afspraak. | De instelling Subject. | Instelbaar met een masker. |
| Body | De inhoud van de afspraak. | De instelling Body. | Wordt tussen twee vaste markeringen geplaatst; tekst daarbuiten blijft bewaard (paragraaf “Nieuwe, gewijzigde en verwijderde afspraken”). |
| Location | De locatie van de afspraak. | De instelling Location. | Is de waarde een geldig e-mailadres, dan wordt de locatie als postbus gekoppeld; anders wordt de tekst als naam gebruikt. |
| Start / End | Begin- en eindtijd. | De werkelijke begin- en eindtijd. | In de tijdzone van de organisatorische eenheid. |
| ShowAs | Hoe de afspraak in de agenda staat. | Zie paragraaf “Vrij/bezet-status”. | — |
| Attendees | De deelnemers van de afspraak. | Zie paragraaf “Deelnemers”. | Deelnemers worden als geaccepteerd meegestuurd. |
| IsOnlineMeeting | Of de afspraak een online meeting is. | De markering online meeting bij de activiteit. | Bij een online meeting wordt Teams als aanbieder meegestuurd (paragraaf “Online lessen en Teams-meetings”). |
| Categories | De categorie, en daarmee de kleur. | De kleur voor een nieuwe, gewijzigde of verwijderde afspraak. | Zie paragraaf “Nieuwe, gewijzigde en verwijderde afspraken”. |
| ResponseRequested, IsReminderOn, AllowNewTimeProposals | Of er een reactie wordt gevraagd, of er een herinnering afgaat en of een andere tijd kan worden voorgesteld. | Alle drie: nee. | Staat vast. Deelnemers hoeven dus niet te reageren en krijgen geen herinnering. |
Kenmerken
Bij het samenstellen van het rooster krijgt elke activiteit een aantal kenmerken mee. Die komen niet als zodanig in de agenda terecht, maar de publicatie gebruikt ze. Standaard zijn vier kenmerken ingericht; daarnaast wordt het kenmerk online toegevoegd bij een activiteit die als online meeting is gemarkeerd.
| Extern veld (exacte benaming) | Betekenis | Standaardvulling | Verwerking / filter |
|---|---|---|---|
| opdrachtType | Het soort activiteit, in verkorte notatie. | Het verkorte type van de activiteit. | Bepaalt de vrij/bezet-status (paragraaf “Vrij/bezet-status”) en het weglaten van vakanties (paragraaf “Welke momenten niet worden meegestuurd”). Pas dit kenmerk niet aan en verwijder het niet: zonder dit kenmerk kan een afspraak niet worden verwerkt. |
| OrganisatorischeEenheid | De organisatorische eenheid. | Het nummer van de eenheid. | Uit de configuratie. |
| afspraakType | Het afspraaktype van de activiteit. | Het afspraaktype van de activiteit. | Uit de configuratie. |
| leeractiviteitType | Het soort leeractiviteit. | Het type van de leeractiviteit. | Uit de configuratie. |
| online | Dat de activiteit een online meeting is. | De aanduiding online. | Wordt alleen toegevoegd bij een activiteit die als online meeting is gemarkeerd. |
Deelnemers
Op een afspraak komen personen en faciliteiten te staan. Groepen gaan bij deze integratie nooit mee: studenten worden altijd afzonderlijk meegestuurd, ook wanneer zij via een groep aan de activiteit hangen. Dat staat vast en is niet instelbaar.
| Deelnemer | Code en adres | Wanneer meegestuurd |
|---|---|---|
| Medewerkers | Het e-mailadres van de medewerker. | Wanneer de medewerker in het venster Selecteer is gekozen en een e-mailadres heeft. |
| Studenten | Het e-mailadres van de student. | Wanneer de student is gekozen en een e-mailadres heeft. |
| Faciliteiten | De referentie als naam, het e-mailadres als adres. | Wanneer de faciliteit is gekozen. Zonder e-mailadres wordt de faciliteit bij het oudere protocol als resource meegestuurd. |
| Groepen | — | Nooit. |
Een adres zonder apenstaartje wordt niet als deelnemer meegestuurd. Komt hetzelfde e-mailadres meer dan één keer in de selectie voor, dan volgt een foutmelding en wordt die agenda niet verwerkt (hoofdstuk “Foutafhandeling en meldingen”).
Vrij/bezet-status
Per soort activiteit stelt u in hoe de afspraak in de agenda komt te staan, bijvoorbeeld als vrij, met voorbehoud, bezet of elders werkzaam. De publicatie leidt het soort af uit het kenmerk opdrachtType.
| Soort activiteit | Kenmerkwaarde | Instelling |
|---|---|---|
| Les | l | De vrij/bezet-instelling voor lessen. |
| BPV | b | De vrij/bezet-instelling voor bpv. |
| Vakantie | v | De vrij/bezet-instelling voor vakanties. Zie de opmerking hieronder. |
| Afspraak | a | De vrij/bezet-instelling voor afspraken. |
| Toets | t | De vrij/bezet-instelling voor toetsen. |
| Conceptrooster | — | Voor een conceptrooster geldt één aparte instelling, ongeacht het soort activiteit. |
Omdat vakanties bij de Graph-API vóór het bijwerken uit het rooster worden gehaald (paragraaf “Welke momenten niet worden meegestuurd”), heeft de instelling voor vakanties daar geen effect; die is alleen van belang bij het oudere protocol.
Online lessen en Teams-meetings
Een activiteit die u in Roosteren als online meeting markeert, kan bij de publicatie een Teams-meeting krijgen. Daarvoor moet Create online meeting in publication aan staan. De afspraak wordt dan als online meeting met Teams als aanbieder in de agenda gezet, en de link komt ook in Xedule terug bij de activiteit.
Teams-meetings worden hergebruikt. Elke combinatie van organisator, vakcode en groep krijgt een eigen meeting, die bij een volgende publicatie opnieuw wordt gebruikt. Daardoor blijven berichten, bestanden en chatgeschiedenis bewaard. Geeft dezelfde docent hetzelfde vak aan een andere groep, dan is dat een eigen meeting; geeft een andere docent hetzelfde vak aan dezelfde groep, ook.
Wanneer dezelfde Teams-meeting opnieuw wordt gebruikt.
Het hergebruik werkt op een sleutel die is opgebouwd uit de vakcode en de codes van de groepen. Die sleutel is maximaal 193 tekens lang en leestekens worden erin vervangen door een liggend streepje. Hierom is een unieke vakcode per vak een voorwaarde (paragraaf “Inrichtingseisen in Xedule”).
Via MyXedule kan een docent van een gewone les een online les maken met de knop Maak online beschikbaar. MyXedule vraagt dan via deze configuratie een Teams-link op. Daarvoor zijn de drie permissies voor online meetings en een Application Access Policy nodig (paragraaf “Rechten van de Graph-API”).
Welke momenten niet worden meegestuurd
- Lessen, afspraken en toetsen gaan alleen mee wanneer ze volledig zijn ingepland.
- Alleen momenten op de dagen die in het venster Selecteer zijn aangevinkt.
- Vakanties en geplande uitval worden bij de Graph-API vlak voor het bijwerken uit het rooster gehaald en bereiken de agenda's dus niet. De instelling Geplande uitval exporteren heeft daarmee voor deze integratie geen effect.
- Momenten waarbij geen enkele gekozen deelnemer met een e-mailadres hoort.
- Bij Hybride mode publication uit: afspraken waarvoor geen organisator te bepalen is (paragraaf “Hybride mode uit: organisator en deelnemers”).
- Het splitsen van een activiteit rond een kleine pauze gebeurt bij deze integratie niet: één activiteit levert één afspraak op.
Foutafhandeling en meldingen
In het paneel Resultaten ziet u de status van de publicatie: bezig met vrijgeven terwijl de agenda's worden bijgewerkt, vrijgegeven wanneer de publicatie klaar is, en fout wanneer er voor een of meer agenda's iets is misgegaan. Fout betekent bij deze integratie niet dat de hele publicatie is mislukt: de publicatie is als geheel uitgevoerd, maar voor de agenda's met een foutmelding is er geen agendavulling.
Wat dat betekent, hangt af van de publicatiemethode. Staat Hybride mode publication uit en gaat het om een organisator, dan hebben ook alle deelnemers van die organisator geen agendavulling gekregen. Staat hybride mode aan, dan raakt een fout alleen de persoon in wiens agenda het misging.
Via de informatieknop bij het resultaat opent u de meldingen van de publicatie. Elke melding begint met het tijdstip.
| Melding | Niveau | Betekenis en actie |
|---|---|---|
| Start update Exchange / Eind update Exchange | Informatie | Het begin en het einde van de publicatie. |
| <aantal> attendees worden verwerkt | Informatie | Het aantal agenda's dat wordt bijgewerkt. |
| verwerken '<adres>' (…r/…c/…u/…d events) …s | Informatie | Per agenda: het aantal afspraken uit het rooster, en hoeveel er zijn aangemaakt, bijgewerkt en verwijderd, met de verwerkingstijd. |
| <adres> duplicaten gevonden, niet verwerkt | Fout | Dit e-mailadres komt meer dan één keer in de selectie voor. Deze agenda is niet bijgewerkt; controleer of het adres bij twee personen staat. |
| <adres> niet gevonden in directory, controleer toegang | Waarschuwing | De agenda kon niet worden gelezen. Controleer het e-mailadres en de rechten van de Graph-API. |
| User with mail '<adres>' was not found. | Waarschuwing | Het e-mailadres bestaat niet in de directory. De publicatie gaat verder met de overige agenda's. |
| <adres> [MailboxNotEnabledForRESTAPI] … of [Authorization_RequestDenied] … | Waarschuwing | De postbus is niet via de Graph-API beschikbaar, of de toegang is geweigerd. Controleer de licentie van de postbus en de permissies uit paragraaf “Rechten van de Graph-API”. |
| <adres> <fout>; performing retry 1 | Waarschuwing | De eerste poging is mislukt; na twee seconden wordt het nog één keer geprobeerd. Slaagt dat, dan is er verder niets aan de hand. |
| '<adres>' <fout> | Fout | Het bijwerken van deze agenda is definitief mislukt. De melding bevat de reactie van Microsoft. |
| Niet gelukt om online afspraken aan te maken. | Fataal | Er kon geen Teams-meeting worden aangemaakt. Controleer de permissies voor online meetings en de Application Access Policy (paragraaf “Rechten van de Graph-API”). |
Opmerkingen
0 opmerkingen
Artikel is gesloten voor opmerkingen.