> For the complete documentation index, see [llms.txt](https://help.blazon.im/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.blazon.im/guias/guias-do-produto/configurando-buscas-do-self-service.md).

# Configurando buscas do Self-service

A configuração de buscas do Self-service é um recurso poderoso e bem versátil do Blazon e esse documento demonstra alguns exemplos para melhor entendimento.

### Público alvo deste guia

Analista de IAM, ou qualquer outro profissional que será responsável pela administração do Blazon.

### O que é este guia?

Este guia tem como objetivo fornecer as informações necessárias e o direcionamento para que você possa configurar as buscas do Self-service.

Os exemplos a seguir se baseiam nas informações de configuração descritas na página [Buscas do Self-service](https://docs.blazon.im/administrador/self-service/solicitacao-de-acessos/buscas#criando-uma-busca) na documentação do **Administrador**.

### O que este guia não é?

Esse guia não tem como objetivo ser um guia definitivo sobre as buscas do Self-service, ou seja, ele apenas cita exemplos de configurações comuns das buscas.

## Criando busca para itens do tipo recurso

Devido a forma de ligação dos atributos de uma busca com relação aos campos de um formulário, você pode configurar de diversas maneiras buscas para filtrar itens de recursos no self-service. Vamos ver uma delas!

### Busca de recursos usando campos do tipo String

Você pode criar uma busca pelo nome aproximando do recurso usando apenas dois campos do tipo String. 

Nesse caso, um dos campos irá definir o tipo do item, recurso no caso,  e ou outro campo irá referenciar ao nome completo ou parcial de um item de recurso. 

As configurações das propriedades do primeiro campo são:

<table><thead><tr><th>Propriedade</th><th>Valor</th><th data-hidden></th></tr></thead><tbody><tr><td><strong>Nome</strong></td><td>tipo</td><td></td></tr><tr><td><strong>Rótulo</strong></td><td>Tipo</td><td></td></tr><tr><td><strong>Campo para bind</strong></td><td><strong>type</strong></td><td></td></tr><tr><td><strong>Tipo</strong></td><td>String</td><td></td></tr><tr><td><strong>Valor padrão</strong></td><td><strong>RESOURCE</strong></td><td></td></tr><tr><td><strong>Esconder</strong></td><td><strong>Sim</strong></td><td></td></tr></tbody></table>

As configurações das propriedades do segundo campo são:

<table><thead><tr><th>Propriedade</th><th>Valor</th><th data-hidden></th></tr></thead><tbody><tr><td><strong>Nome</strong></td><td>recurso</td><td></td></tr><tr><td><strong>Rótulo</strong></td><td>Recurso</td><td></td></tr><tr><td><strong>Campo para bind</strong></td><td><strong>name</strong></td><td></td></tr><tr><td><strong>Tipo</strong></td><td>String</td><td></td></tr></tbody></table>

{% hint style="info" %}

#### Nota

Ainda é possível **adicionar** campos para filtrar pelos atributos como o tipo do recurso, a categoria do recurso, etc.
{% endhint %}

## Criando busca para itens do tipo direito

Da mesma forma que para buscar itens do tipo recurso tem-se várias possibilidades de configuração de campos, também o é para as buscas sobre itens do tipo direito.

Vamos ver uma dessas formas.

### Busca de direitos de um recurso específico

Você pode criar uma busca pelo nome aproximando do direito, mas fixando o recurso no qual irá ser filtrado os direitos. Serão necessários 3 campos, sendo que um deles será oculto na renderização do formulário.

Nesse caso, um dos campos irá definir o tipo do item, direito no caso, outro campo irá referenciar ao nome completo ou parcial de um item de direito e outro campo irá definir o recurso.&#x20;

As configurações das propriedades do primeiro campo são:

<table><thead><tr><th>Propriedade</th><th>Valor</th><th data-hidden></th></tr></thead><tbody><tr><td><strong>Nome</strong></td><td>tipo</td><td></td></tr><tr><td><strong>Rótulo</strong></td><td>Tipo</td><td></td></tr><tr><td><strong>Campo para bind</strong></td><td><strong>type</strong></td><td></td></tr><tr><td><strong>Tipo</strong></td><td>String</td><td></td></tr><tr><td><strong>Valor padrão</strong></td><td><strong>ENTITLEMENT</strong></td><td></td></tr><tr><td><strong>Esconder</strong></td><td><strong>Sim</strong></td><td></td></tr></tbody></table>

As configurações das propriedades do segundo campo são:

<table><thead><tr><th>Propriedade</th><th>Valor</th><th data-hidden></th></tr></thead><tbody><tr><td><strong>Nome</strong></td><td>recurso</td><td></td></tr><tr><td><strong>Rótulo</strong></td><td>Recurso</td><td></td></tr><tr><td><strong>Campo para bind</strong></td><td><strong>name</strong></td><td></td></tr><tr><td><strong>Tipo</strong></td><td><strong>Recurso</strong></td><td></td></tr></tbody></table>

As configurações das propriedades do terceiro campo são:

<table><thead><tr><th>Propriedade</th><th>Valor</th><th data-hidden></th></tr></thead><tbody><tr><td><strong>Nome</strong></td><td>direito</td><td></td></tr><tr><td><strong>Rótulo</strong></td><td>Direito</td><td></td></tr><tr><td><strong>Campo para bind</strong></td><td><strong>name</strong></td><td></td></tr><tr><td><strong>Tipo</strong></td><td>String</td><td></td></tr></tbody></table>

{% hint style="info" %}

#### Nota

Ainda é possível **adicionar** campos para filtrar pelos atributos como o tipo do direito, a categoria do direito, etc.
{% endhint %}

{% hint style="info" %}

#### Nota

Caso se deseje buscar por algum direito apenas pelo nome aproximado, basta eliminar o campo da definição do resource (segundo campo na sequencia acima).
{% endhint %}

Pronto, basta associar um Formulário com esses três campos à uma busca criada e habilitar a mesma.

## Criando busca para itens do tipo papel

Dada a natureza dos papéis, num sistema de gestão de identidades e acessos, como o BLAZON, as buscas por um acesso a um papel geralmente são simples e diretas e levam em consideração o nome do papel.

Sendo assim vamos configurar um Formulário com dois campos do tipo String para essa busca. Um dos campos irá definir o tipo do item, papel no caso, o outro campo irá definir o nome completo ou parcial do papel.

As configurações das propriedades do primeiro campo são:

<table><thead><tr><th>Propriedade</th><th>Valor</th><th data-hidden></th></tr></thead><tbody><tr><td><strong>Nome</strong></td><td>tipo</td><td></td></tr><tr><td><strong>Rótulo</strong></td><td>Tipo</td><td></td></tr><tr><td><strong>Campo para bind</strong></td><td><strong>type</strong></td><td></td></tr><tr><td><strong>Tipo</strong></td><td>String</td><td></td></tr><tr><td><strong>Valor padrão</strong></td><td><strong>ROLE</strong></td><td></td></tr><tr><td><strong>Esconder</strong></td><td><strong>Sim</strong></td><td></td></tr></tbody></table>

As configurações das propriedades do segundo campo são:

<table><thead><tr><th>Propriedade</th><th>Valor</th><th data-hidden></th></tr></thead><tbody><tr><td><strong>Nome</strong></td><td>papel</td><td></td></tr><tr><td><strong>Rótulo</strong></td><td>Papel</td><td></td></tr><tr><td><strong>Campo para bind</strong></td><td><strong>name</strong></td><td></td></tr><tr><td><strong>Tipo</strong></td><td>String</td><td></td></tr></tbody></table>

Pronto, basta associar um Formulário com esses dois campos à uma busca criada e habilitar a mesma.

## Criando busca para itens do tipo check-in

De forma análoga às buscas por papel, as buscas por um acesso administrativo geralmente são simples e diretas e levam em consideração o nome do acesso administrativo.

Sendo assim vamos configurar um Formulário com dois campos do tipo String para essa busca. Um dos campos irá definir o tipo do item, acesso administrativo no caso, o outro campo irá definir o nome completo ou parcial da conta administrativa.

As configurações das propriedades do primeiro campo são:

<table><thead><tr><th>Propriedade</th><th>Valor</th><th data-hidden></th></tr></thead><tbody><tr><td><strong>Nome</strong></td><td>tipo</td><td></td></tr><tr><td><strong>Rótulo</strong></td><td>Tipo</td><td></td></tr><tr><td><strong>Campo para bind</strong></td><td><strong>type</strong></td><td></td></tr><tr><td><strong>Tipo</strong></td><td>String</td><td></td></tr><tr><td><strong>Valor padrão</strong></td><td><strong>ADMIN_PASSWORD</strong></td><td></td></tr><tr><td><strong>Esconder</strong></td><td><strong>Sim</strong></td><td></td></tr></tbody></table>

As configurações das propriedades do segundo campo são:

<table><thead><tr><th>Propriedade</th><th>Valor</th><th data-hidden></th></tr></thead><tbody><tr><td><strong>Nome</strong></td><td>acessoAdmin</td><td></td></tr><tr><td><strong>Rótulo</strong></td><td>Acesso administrativo</td><td></td></tr><tr><td><strong>Campo para bind</strong></td><td><strong>name</strong></td><td></td></tr><tr><td><strong>Tipo</strong></td><td>String</td><td></td></tr></tbody></table>

Pronto, basta associar um Formulário com esses dois campos à uma busca criada e habilitar a mesma.

## Criando busca para itens do tipo usuário

De forma análoga às buscas por papel, as buscas por um item do tipo usuário geralmente são simples e diretas e levam em consideração o nome do item.

Sendo assim vamos configurar um Formulário com dois campos do tipo String para essa busca. Um dos campos irá definir o tipo do item, usuário no caso, o outro campo irá definir o nome completo ou parcial do item usuário.

As configurações das propriedades do primeiro campo são:

<table><thead><tr><th>Propriedade</th><th>Valor</th><th data-hidden></th></tr></thead><tbody><tr><td><strong>Nome</strong></td><td>tipo</td><td></td></tr><tr><td><strong>Rótulo</strong></td><td>Tipo</td><td></td></tr><tr><td><strong>Campo para bind</strong></td><td><strong>type</strong></td><td></td></tr><tr><td><strong>Tipo</strong></td><td>String</td><td></td></tr><tr><td><strong>Valor padrão</strong></td><td><strong>USER</strong></td><td></td></tr><tr><td><strong>Esconder</strong></td><td><strong>Sim</strong></td><td></td></tr></tbody></table>

As configurações das propriedades do segundo campo são:

<table><thead><tr><th>Propriedade</th><th>Valor</th><th data-hidden></th></tr></thead><tbody><tr><td><strong>Nome</strong></td><td>usuario</td><td></td></tr><tr><td><strong>Rótulo</strong></td><td>Item de usuário</td><td></td></tr><tr><td><strong>Campo para bind</strong></td><td><strong>name</strong></td><td></td></tr><tr><td><strong>Tipo</strong></td><td>String</td><td></td></tr></tbody></table>

Pronto, basta associar um Formulário com esses dois campos à uma busca criada e habilitar a mesma.