Itens

O que pode ser solicitado?

Tipos de itens

Para cada um dos tipos de itens do Catálogo, um acesso em específico é concedido.

Tipo	O que é concedido?
Recurso	Uma nova conta.
Direito	Um novo membro de direito.
Papel	Um novo membro de papel.
Check-in de conta administrativa	As credenciais de uma conta administrativa é adicionada ao cofre de senhas do beneficiário.
Usuário	Um novo usuario é criado no diretório do Blazon.

Recurso

Um item do Catálogo, do tipo Recurso, representa uma solicitação de acesso a um recurso, ou seja, uma solicitação de uma conta num recurso.

Cada recurso do diretório do Blazon, e que está habilitado pra self-service, terá seu item respectivo pra configurações adicionais.

Dentre as configurações adicionais possíveis, está a possibilidade de se associar ao item, um Formulário, o qual será renderizado no momento da solicitação do recurso pra viabilizar configurações necessárias de alguns tipos de contas.

O item de um recurso temporário deve ter, necessariamente, associado a ele um Formulário, com um campo para definir a data de expiração (campo "expireAt")

Direito

Um item do Catálogo, do tipo Direito, representa uma solicitação de acesso a um direito, ou seja, uma solicitação de um direito pra uma conta de um recurso.

Cada direito do diretório do Blazon, e que está habilitado pra self-service, terá seu item respectivo pra configurações adicionais.

Caso seja necessário, é também possível associar um Formulário a um item do tipo Papel.

Papel

Um item do Catálogo, do tipo Papel, representa uma solicitação de acesso a um papel.

Cada papel do diretório do Blazon, e que está habilitado pra self-service, terá seu item respectivo pra configurações adicionais.

Caso seja necessário, é também possível associar um Formulário a um item do tipo Direito.

Check-in de conta administrativa

Um item do Catálogo, do tipo check-in de conta administrativa, representa uma solicitação de acesso às credenciais da respectiva conta administrativa.

Cada conta de um recurso administrativo do diretório do Blazon, e que está habilitado pra self-service, terá seu item respectivo pra configurações adicionais.

Caso seja necessário, é também possível associar um Formulário a um item do tipo Check-in de conta administrativa.

Usuário

Todos os itens, dos tipos citados acima, são gerados automaticamente por processos internos do Blazon, verificando o diretório, com exceção do item do tipo Usuário.

Um item do tipo Usuário, representa uma pessoa a ser registrada/cadastrada no Blazon, via Workspace.

Além de configurar, você pode adicionar um item do tipo Usuário, diretamente no Admin console.

Cada item do Catálogo do tipo Usuário deve ter associado a ele um Formulário o qual será renderizado no momento da solicitaçãono Workspace.

Adicionando um item de Usuário

A adição de um item de Usuário é constituída de dois passos, o primeiro deles é a criação de um formulário. Este formulário é responsável por obter as informações do novo usuário cadastrado e posteriormente enviar estas informações para que de fato o mesmo seja criado. Após a criação do formulário, devemos criar um item de catálogo do tipo Usuário e atrelar o formulário configurado.

Configurando um formulário

1. Autentique-se no Admin console

2. Acione o menu Plataforma > Workspace > Geral > Formulários

3. Acione o botão Novo

4. Especifique o Nome, a Descrição

5. Acione o botão Salvar

Após a adição do formulário, ele irá aparecer na listagem de formulários, basta acessá-lo e clicar sob a aba "Campos". Nesta aba você deve adicionar os campos necessários para a criação de um novo usuário, conforme descrito a seguir.

Para a definição de um formulário para o cadastro de um novo usuário, devemos sempre nos atentar a criar uma configuração que seja realmente válida. Para isto, devemos:

• Lembrar que todos os campos obrigatórios do usuário devem ser adicionados no seu formulário;

• Para cada campo do formulário, o mesmo deve possuir uma ligação ao campo do schema do usuário.

A tabela abaixo demonstra uma configuração básica para o seu formulário:

Nome	Label	Campo de vínculação
nome	Nome completo	displayName
empresa	Empresa	organization
email	Email	email
telefone	Telefone	primaryPhone

O campo "Nome" é uma identificação única para o campo do seu formulário, ele pode ser utilizado posteriormente em um script de validação ou manipulação do seu formulário. O campo "Label" é o nome que irá aparecer para o seu usuário durante a criação do usuário. Já o campo "Campo de vinculação" é utilizado para vincular os dados do formulário ao campo de fato do usuário, ou seja, é assim que o Blazon sabe em qual atributo do usuário a informação do formulário deve ser persistida.

Para adicionar campos que não foram citados no exemplo acima lembre-se apenas que o mesmo deve ter uma configuração válida entre o formulário e o schema do Usuário e isto deve ser feito. partir do campo "Campo de vinculação".

Adicionando um item do tipo Usuário

1. Autentique-se no Admin console

2. Acione o menu Plataforma > Workspace > Catálogo de itens > Usuários

3. Acione o botão Novo

4. Especifique o Nome, a Descrição e Formulário

5. Acione o botão Salvar

Pronto, você acaba de adicionar um item do tipo Usuário, no Catálogo.

Este novo item estará disponível no Workspace dentro de poucos minutos. O Blazon leva um período até realizar o sincronismo entre estas configurações e o catálogo que está disponível para o usuário.

Editando um item

Você pode, a qualquer momento, editar qualquer item do Catálogo de itens. Para editar um item do Catálogo:

1. Autentique-se no Admin console

2. Acione o menu Plataforma > Workspace > Catálogo de itens

3. Realize a busca pelo nome ou tipo do item que deseja-se alterar

4. Selecione o item que deseja-se alterar no resultado de busca

5. Realize as alterações desejadas

6. Acione o botão Salvar

Pronto, você acaba de editar um item do Catálogo! A edição de um item do Catálogo vai naturalmente refletir na sua apresentação e funcionalidade lá no Workspace.

Por exemplo, a edição de um item, configurando um Formulário irá afetar o processo de checkout que irá renderizar um formulário pra ser preenchido pelo usuário do Workspace.

Editando as qualificações de um item:

Cada item do catálogo pode ter de 0 a várias qualificações. Essas qualificações irão definir se o usuário final no workspace irá ou não ter acesso ao item.

Para editar as qualificações do item, na tela de edição do item, basta arrastar as qualificações desejadas da esquerda para a direita e salvar o item.

Além da configuração de qualificação do item, pode-se configurar se a justificativa de solicitação do item se é obrigatória ou não, e para os items do tipo USUÁRIO e RECURSO, pode-se configurar o formulário associado.

Removendo um item

Para remover um item do Catálogo:

1. Autentique-se no Admin console

2. Acione o menu Plataforma > Workspace > Catálogo de itens

3. Realize a busca pelo nome ou tipo do item que deseja-se remover

4. Selecione o check-box do item que deseja-se remover

5. Acione o botão Remover

6. Acione o botão Confirmar

Pronto, você acaba de remover um item do Catálogo!