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

# Access to Workplace contracts

O módulo **Access to Workplace contracts** contém os contratos que concedem aos grupos de utilizadores acesso às aplicações e aos desktops publicados pelo servidor Systancia Workplace associado. Um contrato associa um ou vários **grupos de utilizadores** a **uma aplicação**, **um grupo de aplicações** ou **um desktop**, com um período de validade, um número máximo de instâncias simultâneas, **modos de acesso** e, se aplicável, **faixas** horárias.

Os contratos são partilhados entre os dois produtos: uma alteração feita no Bastion reflete-se no Workplace e a vice-versa.

> **Pré-requisito: associação do Workplace**
>
> Este módulo só aparece quando a **associação do Workplace** está ativa **e** a **fusão de consolas** também está ativa.

## Lista de contratos

| Coluna | Descrição |
|---|---|
| **Type** | Ícone que designa o destino do contrato. Um fundo de cor assinala um contrato com faixas. |
| **Application** | Nome do destino, com o seu ícone — aplicação, grupo de aplicações ou desktop. |
| **Users group** | Primeiro grupo beneficiário; para além disso, é adicionado um contador **+ *n* groups**. |
| **Beginning date** | Início da validade. |
| **End Date** | Fim da validade, ou **Unlimited**. |
| **Concurrent users** | Número máximo de instâncias simultâneas, ou **Unlimited**. |
| **Access modes** | Quatro indicadores: **Web**, **Desktop**, **VD** e **Launcher**. |
| **Systancia Gate** | Dois indicadores: **Authorized** e **Restricted**. |

Os contratos fora do seu período de validade aparecem **esbatidos**. Enquanto não existir nenhum contrato, a grelha indica **No subscription to display**, seguido de uma recordação das condições que devem estar reunidas antes de criar um.

Uma **legenda** sob a grelha explica os ícones: **Application group subscription**, **Application subscription**, **Desktop subscription** e **Contract with planning**.

### Ações da barra de ferramentas

| Ação | Disponibilidade | Efeito |
|---|---|---|
| **+** — dica **New subscription** | Devem existir um destino **e** um grupo de utilizadores | Abre o formulário (ver o capítulo [Adicionar um contrato](#add-a-contract)). |
| Ícone de edição — dica **Properties** | Seleção = 1 | Abre o mesmo formulário. Fazer duplo clique é equivalente. |
| **×** — dica **Delete** | Seleção = 1 | Pergunta **Are you sure you want to remove this subscription?** |
| **Enable** *ou* **Disable** | Seleção = 1, contrato dentro do seu período de validade | ⚠ Os dois botões **nunca estão visíveis ao mesmo tempo**: apenas é apresentado o que corresponde ao estado do contrato selecionado. |

> **Por que motivo o botão + pode permanecer inativo**
>
> É necessário pelo menos um destino e um grupo de utilizadores. Caso contrário, a consola explica: **To create a subscription you need at least one application, applications group or desktop.**, ou **To create a subscription you need at least one users group.**

### Filtros e pesquisa

Um painel recolhível **Filters** oferece um **Type** — **All**, **Application**, **Application group** ou **Desktop** — e um **User group**. Ao seu lado, o campo de pesquisa, cujo texto de ajuda é **Search**, filtra 700 ms após a última pressão de tecla. O rodapé da grelha oferece um seletor **Items per page:** configurável em `15`, `25` ou `50`.

## Adicionar um contrato

O botão **+** abre a janela **New Subscription**, com dois separadores: **General Information** e **Authorized slots**.

### Separador General Information

A caixa **Contract type** oferece três botões de opção — disponíveis **apenas na criação**:

| Opção | Descrição |
|---|---|
| **for a group of applications** | Grupo de aplicações publicado em Workplace. Inativo quando não existe nenhum grupo. Quando a recursividade está ativa do lado de Workplace, a etiqueta é completada em vermelho: *(recursion is enabled on contracts publication)*. |
| **For an application** | **Opção retida por predefinição.** |
| **For a desktop** | Desktop ou grupo de desktops. |

Seguem-se os campos:

| Campo | Descrição |
|---|---|
| **Application** | Obrigatório. Lista dos destinos do tipo retido; escrever alguns caracteres filtra-a. |
| **User group** | Uma lista dupla, com pesquisa e um botão **Select All**. |
| **Access modes** | Quatro caixas de verificação, **todas selecionadas por predefinição**: **Web portal**, **Desktop**, **Virtual desktop** e **Launcher**. |
| **Access from Systancia Gate** | Duas caixas de verificação, **não selecionadas por predefinição**: **Outside publication authorized** e **Restrict access to compliant clients**. A segunda permanece **inativa** até que a primeira seja selecionada. |
| **Subscription start date:** | Obrigatório. Hoje por predefinição. |
| **Subscription end date:** | Deve ser posterior ou igual à data de início. A caixa de verificação **Unlimited** ao seu lado neutraliza o campo. |
| **Maximum number of simultaneous instances:** | Número inteiro, mínimo `1`. A caixa de verificação **Unlimited** neutraliza-o; num contrato de desktop passa a **Unlimited (to the extent of available clones)** e o máximo fica limitado pela capacidade do desktop. |

### Separador Authorized slots

O separador apresenta uma grelha semanal — uma linha por faixa, as horas como colunas — e três ações: **Add**, **Properties** (também com duplo clique) e **Delete**, esta última com a pergunta **Are you sure you want to remove this time slot?**

A janela **Edit slot** é composta por três partes:

| Parte | Conteúdo |
|---|---|
| Caixa de verificação na parte superior | **Impose the closure of the application when the access slots limit is reached** — **selecionada por predefinição**. |
| **Slot type** | Seis botões de opção exclusivos: **Day of the week**, **Date**, **Day of the month**, **Day of a month**, **Month** e **Months**. Cada um ativa o seu próprio seletor. |
| **Slots** | Dois campos, **Start** e **End**, no formato `hh:mm`, e um botão **Add** que acumula os intervalos numa grelha. |

| Mensagem | Caso |
|---|---|
| **Bad time format! (hh:mm)** | A hora introduzida não tem a forma esperada. |
| **Error while adding slot: the given slot overlaps an already existing slot.** | O novo intervalo sobrepõe-se a um existente. |

> **Nenhuma faixa para um grupo de desktops**
>
> O separador **Authorized slots** não se aplica a um contrato que abranja um grupo de desktops; o separador **General Information** recorda-o com um aviso.

## Modificar um contrato

Selecione um contrato e clique no ícone **Properties** (ou faça duplo clique). A janela **Edit Subscription** volta a apresentar o formulário, com **Contract type** já não editável. Ao guardar, a consola mostra **Subscription successfully updated.** — e **The new subscription properties have been successfully registered.** no caso de uma criação.

## Ativar ou desativar um contrato

O botão visível — **Enable** ou **Disable** conforme o estado — atua sobre as **datas** do contrato: ativar traz a data de início de volta a hoje, desativar coloca-a no dia seguinte ao da data de fim. O resto da configuração fica intacto.

## Eliminar um contrato

Selecione um contrato, clique em **×** e confirme. No caso de um contrato sobre um **grupo de aplicações** com a recursividade ativa do lado de Workplace, é lançada uma tarefa de atualização; a grelha é recarregada quando termina.
