Attributes: Exemplo prático

Esse artigo tem como objetivo explicar um pouco sobre os atributos na plataforma. 

A funcionalidade attributtes encontra-se no menu principal na aba "governance" localizada no lado esquerdo da tela principal do manager.

Após clicar na funcionalidade, você será encaminhado para a seguinte tela:

Nesta tela, você precisará preencher os campos name e value. Feito isso, basta clicar no botão ADD ATTRIBUTE e o atributo será criado.

Feito isso criamos uma API (API vendas artigos 1.0) e associamos na mesma a tag de vendas. 

Essa associação ocorre no momento da criação/edição da API na tela de Overview. Veja na Imagem abaixo a associação de uma tag no momento da criação da API.

Caso queira associar uma tag à uma API criada anteriormente, basta ir na tela de configurações da API em questão e, após clicar no botão EDIT será possível inserir tags a mesma. Veja o print abaixo:

Com as tags criadas e associadas à(s) API(s), será possível realizar a rastreabilidade das API(s) por tags. Para isso, vá até tela de listagem, ao abrir o menu Keywords será possível encontrar vários itens para customizar a busca por uma API. 

Dentre estes itens, está a busca por atributos. Veja o exemplo abaixo:

Veja na imagem acima que para que a busca seja realizada com sucesso, basta selecionar a tag e seu valor. Após isso, basta clicar No botão SEARCH.

Note que o resultado da busca foi apenas a API que está associada à tag em questão.

Vale ressaltar que uma tag pode ter vários valores. No exemplo abaixo vamos adicionar mais valores à tag. Para isso, apenas é necessário clicar no no ícone de lápis localizado à direita da tag.

Feito isso, o campo para inserir value será habilitado. Após inserir o(s) value(s) desejado(s), basta clicar no botão SAVE.

No exemplo abaixo, inserimos na tag o value lojas.

Após isso, criamos a API lojas artigos 1.0 e associamos à mesma à tag artigo vendas com o value lojas.

Em Keywords, selecionamos a tag artigos vendas. No entanto, a mesma agora possui 2 values.

Para o exemplo abaixo, selecionamos  o value lojas.

Na imagem abaixo, podemos ver que o filtro foi aplicado de acordo com o valor lojas. No qual, apenas a API lojas artigos foi retornada.

Um outro cenário é a possibilidade  do mesmo valor estar presentes em mais de uma API.

Para mostrar um exemplo desse cenário criamos a API lojas e vendas artigos que vai possuir os dois valores da tag. Veja a imagem abaixo:

Ao ir em Keywords e filtrar pelo value vendas, note que é retornado a API vendas artigos 1.0 que contém o valor da tag vendas e a API lojas artigos 1.0 que contém os valores das duas tags.

Da mesma forma, caso o filtro seja realizado pelo value lojas, note que é retornado a API lojas artigos 1.0 que contém o valor da tag lojas e a API lojas artigos 1.0 que contém os valores das duas tags.

Para resumir o caso de uso, basicamente a funcionalidade voltada para rastreabilidade de APIs. isso é possível a partir do momento em que definimos atributos contendo tags que serão associadas nas APIs que manipulam o mesmo modelo de negócio vigente no atributo.