Mensen uitnodigen¶

Met een uitnodiging voeg je iemand toe aan je organisatie, met de rollen, groepen en eigenschappen die je meteen wilt geven. Deze pagina is voor beheerders: wie de rechten van beheerder of personenbeheerder heeft in de organisatie. Hoe de uitgenodigde de uitnodiging accepteert, staat in Een uitnodiging accepteren.

Iemand uitnodigen¶

Kies het e-mailadres van de persoon.
Kies de rollen, groepen en eigenschapswaarden die de persoon krijgt. Je kunt alleen geven wat je zelf hebt; anders weigert OS de uitnodiging (waarom).
Verstuur de uitnodiging. De uitgenodigde krijgt een link.

De mail zegt de uitgenodigde wat de volgende stap is: een wachtwoord kiezen (voor een adres dat nog geen account heeft), inloggen, of inloggen met het bedrijfsaccount. Welke het is, zie jij als beheerder niet: een uitnodiging ziet er voor jou altijd hetzelfde uit.

De link is geldig tot de uitnodiging verloopt (standaard zeven dagen). Alleen de uitgenodigde kan hem gebruiken, ingelogd met precies dat adres. Een doorgestuurde link geeft een ander geen toegang. Bij het accepteren controleert OS opnieuw of jij de gekozen rollen, groepen en waarden nog mag geven; verlies je die rechten intussen, dan is de uitnodiging ongeldig en nodig je opnieuw uit.

Veel mensen tegelijk uitnodigen¶

Op de pagina Leden opent Leden importeren twee manieren om veel mensen in één keer uit te nodigen. Iedereen krijgt een eigen uitnodiging per mail, en vult bij het accepteren zelf zijn naam in.

Lijst plakken. Plak één e-mailadres per regel, kaal of met een naam ervoor zoals een mailprogramma ze kopieert ("Henk de Vries" <henk@voorbeeld.nl>); de naam wordt niet gebruikt. Kies daarboven de groepen, rollen en het bereik die iedereen krijgt. Staat er één regel zonder geldig adres in, dan weigert de pagina de hele lijst.
CSV-bestand. Een bestand met een kolom e-mail en, naar keuze, groepen en rollen met de namen zoals ze onder Groepen en Rollen staan (meerdere gescheiden door een komma), zodat ieder eigen groepen en rollen krijgt. Download het voorbeeldbestand om te zien hoe het moet; een Excel- bestand sla je eerst op als CSV. Het bestand blijft in je browser en gaat niet naar OS. Tot 500 mensen per bestand, hoogstens 1 MB. Regels met een probleem (geen geldig adres, een adres dat al op een eerdere regel staat, een groep of rol die niet bestaat) worden overgeslagen; je kunt ze downloaden met de reden erbij, aanpassen en opnieuw importeren.

De pagina verstuurt de uitnodigingen in stukjes van 25. Laat hem open tot het klaar is: sluit je hem, dan stopt het versturen, en wie al een uitnodiging heeft, houdt die. Daarna zie je per persoon of de uitnodiging is verstuurd, en zo niet, waarom: dezelfde redenen als hieronder bij één uitnodiging. Mislukte uitnodigingen probeer je opnieuw met één knop, en het resultaat download je als CSV.

Openstaande uitnodigingen bekijken en intrekken¶

Je ziet de uitnodigingen die nog niet zijn geaccepteerd. Een openstaande uitnodiging trek je in; de link werkt dan niet meer. Een geaccepteerde uitnodiging trek je niet in: dan is de persoon lid, en deactiveer of verwijder je het lid.

Iemand opnieuw uitnodigen na een verwijdering maakt een nieuw lidmaatschap dat met niets begint.

Als OS weigert¶

403: je geeft een rol, groep of waarde die je zelf niet hebt; de melding noemt wat.
409: de uitnodiging zou je organisatie, of een eronder, meer dan 32 eigenschappen en labels laten gebruiken, of een rol met bereik descendants zou een organisatie eronder meer dan 500 regels in de AI-functies geven. Dat kan bij het versturen en bij het accepteren. Geef minder, geef de rol met bereik organisation, of vraag je operator.
422: een rol, groep of eigenschap die niet bestaat, of een waarde die de eigenschap niet toestaat.

Via de API¶

POST /api/v1/organisations/{id}/invitations met email en, naar keuze, roles (elk {"role": ..., "reach": ...}, zie Rollen beheren), groups (id's van groepen) en attributes (elk {"attribute": ..., "value": ...}, zie Eigenschappen beheren).
POST /api/v1/organisations/{id}/invitations/batch met invitations, een lijst van 1 tot 100 uitnodigingen in dezelfde vorm. Het antwoord geeft per uitnodiging, in dezelfde volgorde, sent met de uitnodiging of refused met de reden; een geweigerde regel houdt de andere niet tegen. Een regel die niet aan de vorm voldoet (een adres langer dan 320 tekens, meer dan 32 groepen of rollen) weigert het hele verzoek met 422, voordat er iets is verstuurd. Na een 500 kunnen de regels ervoor al zijn uitgenodigd; opnieuw versturen geeft voor hen 409, al uitgenodigd.
GET /api/v1/organisations/{id}/invitations toont de openstaande uitnodigingen.
DELETE /api/v1/organisations/{id}/invitations/{invitation_id} trekt er een in.