Attributes

Attributes is a feature for classifying APIs through customisable tags, which makes it easier to find APIs in the portfolio and to understand the business context around the APIs. Furthermore, since you can create attributes following business rules, the feature gives more visibility to the company’s API strategy.

Attributes are composed of a name and one or more values (the tags). After you enter the attributes that fit your governance needs, you can associate these attributes and their corresponding tags with your APIs, classifying the latter. And you can also use the attributes as requirements for workflows.

This means that, when you create attributes that fit your company’s business models, you are able to classify your APIs by associating them with a given business model and, with the workflows, ensure that the APIs use the adequate attributes.

Managing attributes

The Attributes screen is accessible from the Sensedia Adaptive Governance main menu. There you can register new attributes, as well as edit or delete those already registered.

The linking of attributes to APIs managed on Sensedia API Platform is done at the stage of creating or editing an API on the Platform itself.
attributes
"Attributes" screen

Creating attributes

To add a new attribute, click the + button, located in the bottom right corner of the Attributes screen.

A modal window containing a form for creating the attribute will open. The form contains the following fields:

  • Name: Provide a name for the attribute.

  • Values: Insert the tags for the attribute. To assign a new value, type the desired text and then press the ENTER key.

Once the fields have been filled, click on the CREATE ATTRIBUTE button to save the attribute.

The following rules apply to the creation of attributes:

  • attributes must have a unique name;

  • it’s not possible to use the character : in the attribute’s name or value;

  • names and values must have at least 3 and at most 40 characters.

Editing and deleting attributes

The Attributes screen displays a table listing the attributes that have already been registered.

For each attribute (row), the following information is displayed (columns):

  • NAME: Name of the attribute.

  • VALUE: Values (tags) assigned to the attribute.

  • ACTIONS: Contains the following buttons:

    • icon edit: Allows you to edit the attribute.

    • icon delete: Allows you to delete the attribute.

Editing existing attributes

To edit an attribute (i.e. insert or remove values), click on the icon edit button of the row corresponding to the attribute you want to edit, in the list of registered attributes.

A modal window containing a form with the attribute information will open. In the Values field of this form you can:

  • add new values to the attribute;

  • remove a specific value. If the tag is not linked to an API, the X icon will be available next to its name. Click this icon to delete the tag;

  • remove all values registered for the attribute that are not linked to an API. To do so, click the X icon located in the upper right corner of the Values field.

Once you have made all the desired changes, click on the EDIT ATTRIBUTE button to save them (or on CANCEL to discard them).

  • It is not possible to modify the name of the attribute.

  • The same restrictions as for attribute creation apply to the inclusion of new values.

  • It is not possible to delete a tag that is associated with an API.

Deleting attributes

It is possible to completely delete an attribute (deleting the name and all values). To do this, click the icon delete button on the row of the desired attribute, within the list of existing attributes. In the window that opens, click DELETE to confirm the deletion of the attribute or CANCEL to cancel the operation.

It is not possible to delete an attribute that is being used in a workflow stage.
Thanks for your feedback!
EDIT

Share your suggestions with us!
Click here and then [+ Submit idea]