Thanks for your feedback!
EDIT
Attributes
A tela Attributes é encontrada dentro de Governance, no menu principal do Manager. Ela oferece uma funcionalidade de classificação de APIs por meio de tags personalizáveis, o que aumenta a rastreabilidade dentro do portfólio das APIs e o entendimento do contexto de negócio em que as APIs estão inseridas. Além disso, como é possível criar atributos com base em regras de negócio, a funcionalidade dá uma maior visibilidade da estratégia de APIs seguida.
Os atributos são formados por um nome acompanhado de um ou mais valores (as tags, ou etiquetas). Depois de cadastrar os atributos que condizem com as suas necessidades de governança, você pode associar esses atributos e tags às suas APIs, promovendo uma classificação para elas. E você também pode utilizar os atributos como requisitos dos workflows.
Isso significa que, quando você cria atributos adequados aos modelos de negócio da sua empresa, você consegue associar determinadas APIs a um modelo de negócio específico e, com os workflows, garantir que as APIs usem os atributos adequados. Em exemplos abaixo, como ilustração disso, classificamos APIs por unidade de negócio (business unit), incluindo as áreas de Marketing, P&D (R&D) e Vendas (Sales).
A tela Attributes inclui uma área para inclusão de novos atributos e a lista de atributos já criados. A associação de atributos a APIs é feita na criação ou edição de uma API ().
Gerenciando atributos
Cadastro
Para cadastrar um novo atributo, informe um nome no campo Name e insira as tags que desejar no campo Value (é possível adicionar até 30 tags por atributo). Quando terminar de adicionar as tags, clique em ADD ATTRIBUTE.
|
Regras que se aplicam à criação de atributos:
|
No exemplo abaixo, vemos uma tela de atributos vazia e vamos adicionar um primeiro atributo, formado pelo nome Business Unit e valores referentes às diferentes áreas de negócio:
Edição
Você pode editar um atributo já criado, modificando seu nome e/ou valores.
Para isso, clique no ícone 
, na linha do atributo desejado, dentro da lista de atributos existentes.
Para remover uma tag, clique no ícone X ao lado do seu nome.
| O sistema não permitirá que você exclua uma tag se ela estiver associada a uma API. Veja como vincular tags a APIs abaixo. |
No exemplo abaixo, estamos editando o atributo Business Unit criado acima, adicionando uma nova área e substituindo uma das áreas por outro valor:
Exclusão
Você pode excluir completamente um atributo (apagando o nome e todos os valores).
Para isso, clique no ícone 
na linha do atributo desejado, dentro da lista de atributos existentes.
|
O sistema não permitirá que você apague um atributo se ele estiver vinculado a uma API (veja como vincular atributos a APIs abaixo). Por outro lado, é possível apagar um atributo que esteja associado somente a um workflow. Por isso, sugerimos que você verifique se um atributo está associado a um workflow antes de removê-lo, analisando se ele realmente deve ser deletado. Veja como usar os atributos como requisitos de workflows aqui. |
Vinculando atributos a APIs
Depois de um atributo ter sido cadastrado, ele pode ser associado às APIs que queremos categorizar por meio de suas tags.
A vinculação de atributos a uma API é feita na tela de cadastro ou edição da API (mais especificamente, no campo Attributes da seção API Basic Definitions). Você pode ler mais sobre a criação/edição de APIs aqui.
No exemplo abaixo, estamos trabalhando com uma API de demonstração para uso na documentação técnica do Adaptive Governance.
Para categorizá-la de forma condizente, vamos adicionar o atributo Documentation:Adaptive Governance:
Depois de vincular atributos e APIs, podemos nos beneficiar da funcionalidade de busca avançada de APIs, usando atributos ou tags para filtragem. Você pode ler mais sobre a busca avançada de APIs aqui.