> Source: https://docs.cyberelements.io/bastion/4.6/nl/Usage/AdminConsoleReference/WorkplaceAccessContracts/

# Access to Workplace contracts

De module **Access to Workplace contracts** bevat de contracten die gebruikersgroepen toegang geven tot de applicaties en desktops die de bijbehorende Systancia Workplace-server publiceert. Een contract verbindt een of meer **gebruikersgroepen** met **één applicatie**, **één applicatiegroep** of **één desktop**, met een geldigheidsduur, een maximumaantal gelijktijdige instanties, **toegangsmodi** en, in voorkomend geval, **tijdslots**.

De contracten worden gedeeld tussen beide producten: een in Bastion uitgevoerde wijziging verschijnt in Workplace, en omgekeerd.

> **Voorwaarde: Workplace association**
>
> Deze module verschijnt alleen wanneer de **Workplace association** actief is **en** **het samenvoegen van merging** ook actief is.

## Lijst met contracten

| Kolom | Beschrijving |
|---|---|
| **Type** | Pictogram dat het doel van het contract aanduidt. Een gekleurde achtergrond markeert een contract met tijdslots. |
| **Application** | Naam van het doel, met het pictogram ervan — applicatie, applicatiegroep of desktop. |
| **Users group** | Eerste begunstigde groep; daarboven wordt een teller **+ *n* groups** toegevoegd. |
| **Beginning date** | Begin van de geldigheid. |
| **End Date** | Einde van de geldigheid, of **Unlimited**. |
| **Concurrent users** | Maximumaantal gelijktijdige instanties, of **Unlimited**. |
| **Access modes** | Vier indicatoren: **Web**, **Desktop**, **VD** en **Launcher**. |
| **Systancia Gate** | Twee indicatoren: **Authorized** en **Restricted**. |

Contracten buiten hun geldigheidsduur worden **grijs weergegeven**. Zolang er geen contract bestaat, geeft de tabel **No subscription to display** weer, gevolgd door een herinnering van de voorwaarden waaraan moet zijn voldaan voordat er een wordt aangemaakt.

Een **legenda** onder de tabel verklaart de pictogrammen: **Application group subscription**, **Application subscription**, **Desktop subscription** en **Contract with planning**.

### Acties van de werkbalk

| Actie | Beschikbaarheid | Effect |
|---|---|---|
| **+** — tooltip **New subscription** | Er moeten een doel **en** een gebruikersgroep bestaan | Opent het formulier (zie hoofdstuk [Een contract toevoegen](#add-a-contract)). |
| Wijzigingspictogram — tooltip **Properties** | Selectie = 1 | Opent hetzelfde formulier. Dubbelklikken is gelijkwaardig. |
| **×** — tooltip **Delete** | Selectie = 1 | Vraagt **Are you sure you want to remove this subscription?** |
| **Enable** *of* **Disable** | Selectie = 1, contract binnen zijn geldigheidsduur | ⚠ De twee knoppen zijn **nooit gelijktijdig zichtbaar**: alleen die welke overeenkomt met de status van het geselecteerde contract wordt weergegeven. |

> **Waarom de knop + inactief kan blijven**
>
> Er zijn minstens één doel en één gebruikersgroep nodig. Anders legt de console het uit: **To create a subscription you need at least one application, applications group or desktop.**, of **To create a subscription you need at least one users group.**

### Filters en zoeken

Een uitklapbaar paneel **Filters** biedt een **Type** — **All**, **Application**, **Application group** of **Desktop** — en een **User group**. Daarnaast filtert het zoekveld, waarvan de placeholder **Search** is, 700 ms na de laatste toetsaanslag. De voettekst van de tabel biedt een selector **Items per page:** ingesteld op `15`, `25` of `50`.

## Een contract toevoegen

De knop **+** opent het venster **New Subscription**, met twee tabbladen: **General Information** en **Authorized slots**.

### Tabblad General Information

Het kader **Contract type** biedt drie keuzerondjes — **alleen bij het aanmaken** beschikbaar:

| Optie | Beschrijving |
|---|---|
| **for a group of applications** | In Workplace gepubliceerde applicatiegroep. Inactief wanneer er geen groep bestaat. Wanneer de recursie aan de Workplace-zijde actief is, wordt het label in het rood aangevuld: *(recursion is enabled on contracts publication)*. |
| **For an application** | **Standaard gekozen optie.** |
| **For a desktop** | Desktop of desktopgroep. |

Daarna volgen de velden:

| Veld | Beschrijving |
|---|---|
| **Application** | Verplicht. Lijst van de doelen van het gekozen type; enkele tekens typen filtert die lijst. |
| **User group** | Een dubbele lijst, met zoekfunctie en een knop **Select All**. |
| **Access modes** | Vier selectievakjes, **standaard alle aangevinkt**: **Web portal**, **Desktop**, **Virtual desktop** en **Launcher**. |
| **Access from Systancia Gate** | Twee selectievakjes, **standaard niet aangevinkt**: **Outside publication authorized** en **Restrict access to compliant clients**. Het tweede blijft **inactief** totdat het eerste is aangevinkt. |
| **Subscription start date:** | Verplicht. Standaard vandaag. |
| **Subscription end date:** | Moet later dan of gelijk aan de begindatum zijn. Het selectievakje **Unlimited** ernaast schakelt het veld uit. |
| **Maximum number of simultaneous instances:** | Geheel getal, minimaal `1`. Het selectievakje **Unlimited** schakelt het uit; bij een desktopcontract wordt het **Unlimited (to the extent of available clones)** en wordt het maximum begrensd door de capaciteit van de desktop. |

### Tabblad Authorized slots

Het tabblad toont een weektabel — één rij per tijdslot, de uren als kolommen — en drie acties: **Add**, **Properties** (ook door te dubbelklikken) en **Delete**, waarbij die laatste vraagt **Are you sure you want to remove this time slot?**

Het venster **Edit slot** bestaat uit drie delen:

| Deel | Inhoud |
|---|---|
| Selectievakje bovenaan | **Impose the closure of the application when the access slots limit is reached** — **standaard aangevinkt**. |
| **Slot type** | Zes onderling uitsluitende keuzerondjes: **Day of the week**, **Date**, **Day of the month**, **Day of a month**, **Month** en **Months**. Elk schakelt zijn eigen selector vrij. |
| **Slots** | Twee velden, **Start** en **End**, in de vorm `hh:mm`, en een knop **Add** die de intervallen in een tabel stapelt. |

| Melding | Geval |
|---|---|
| **Bad time format! (hh:mm)** | De ingevoerde tijd heeft niet de verwachte vorm. |
| **Error while adding slot: the given slot overlaps an already existing slot.** | Het nieuwe interval overlapt een bestaand interval. |

> **Geen tijdslots voor een desktopgroep**
>
> Het tabblad **Authorized slots** is niet van toepassing op een contract dat een desktopgroep dekt; het tabblad **General Information** herinnert daaraan met een waarschuwing.

## Een contract wijzigen

Selecteer een contract en klik op het pictogram **Properties** (of dubbelklik). Het venster **Edit Subscription** toont het formulier opnieuw, waarbij **Contract type** niet meer te wijzigen is. Bij het opslaan toont de console **Subscription successfully updated.** — en **The new subscription properties have been successfully registered.** bij een aanmaak.

## Een contract inschakelen of uitschakelen

De zichtbare knop — **Enable** of **Disable** naargelang de status — werkt op de **datums** van het contract: inschakelen zet de begindatum terug op vandaag, uitschakelen zet die op de dag na de einddatum. De rest van de configuratie blijft onaangeroerd.

## Een contract verwijderen

Selecteer een contract, klik op **×** en bevestig. Bij een contract op een **applicatiegroep** met actieve recursie aan de Workplace-zijde wordt een updatetaak gestart; de tabel wordt opnieuw geladen wanneer die eindigt.
