Custom attributes support flexible configuration of attributes and input specifications that describe complete information for different object types. When you manage assets in Asset > Catalog Management > Manual Listing, you can complete attribute values to provide detailed and accurate descriptions for each asset. This presents a more comprehensive content perspective for viewers and helps them understand the core characteristics and value of assets. This topic describes how to create and manage attributes for asset objects, DataService Studio APIs, or dashboards.
Limits
To use attribute management, you must purchase Metadata Center or the Data Management value-added service.
Permission description
Super administrators, system administrators, and custom global roles with the Planning-Attribute Management permission can create and manage object attributes.
Create table attributes
In the top menu bar of the Dataphin homepage, select Planning > Attribute Management.
On the Attribute Management page, click View Details on the right side of the object type card to go to the attribute management list page for the corresponding asset type.
On the attribute management list page for the corresponding asset type, click Create Custom Attribute.
In the Create Attribute dialog box, configure the following parameters. The configuration methods for technical metrics, business metrics, DataService Studio APIs, and dashboards are the same as those for tables. The following example uses Table.
Parameter
Description
Attribute Name
Enter the name of the current attribute. The name must be globally unique.
The name cannot exceed 32 characters.
Attribute Code
Enter the code of the current attribute. The code must be globally unique.
The code cannot exceed 64 characters and can contain only digits, letters, and underscores (_). The code must start with a letter.
Attribute Type
Select the type of the current attribute. The attribute type is used only for categorizing object attributes.
You can select Management Attribute, Business Attribute, or Technical Attribute.
Description (optional)
Enter a description for the attribute to help business personnel better understand its meaning. The description can be up to 1,000 characters long.
Input Type
Determines how attribute values are entered and stored when you edit assets. Different input types support different field types:
Text Input: String, Numeric.
Dropdown (Single): String, Numeric, Boolean.
Dropdown (Multiple): String, Numeric.
Hyperlink: String.
NoteField types include String (STRING), Numeric (BIGINT, DOUBLE with up to 6 decimal places), and Boolean (BOOLEAN with values of True or False).
If you set Input Type to Text Input or Hyperlink and the field type is String, you can set the maximum number of characters from 0 to 10,000.
Enumeration Values
Constrains the value range of an attribute. When you edit an asset, the available values are determined by the configuration for the selected input type.
Dropdown (Single)/(Multiple): If the field type is String, you can configure custom enumeration values or reference system attributes. If the field type is Numeric, you can configure custom enumeration values. If the input type is Dropdown (Single) and the field type is Boolean, the enumeration values default to True and False and cannot be edited.
Custom enumeration values: Separate multiple values with a comma (,). The type of the enumeration values must be the same as the field type. A single value cannot exceed 32 characters. The total length of all values cannot exceed 10,000 characters, including commas.
Click Batch Edit next to the enumeration values text box. In the Edit Enumeration Values dialog box, edit and preview the values. Separate multiple values with a comma (,) or a line break.
Reference system attributes: If the field type is String, you can reference Dataphin system attributes. These include user, user group, data category, subject area, project, asset topic folder, and department (available only if a third-party account system with department information is connected). This enhances the global adaptability of asset operations and simplifies unified management. For example, if you select data category as the system attribute, the selectable values for this attribute when you edit an asset are all data categories under the current tenant.
Click Interaction
Available when Input Type is set to Hyperlink. Select how the hyperlink opens when the asset is edited. Options are Open In Current Page and Open In New Page.
Editable In
The modules where the current attribute value can be set or modified. For example, if the value includes Development, users can set or modify attribute values in the corresponding interface of the Development menu (Development and Integration).
NoteThe default value is Asset and cannot be modified.
Visible In
The modules where the current attribute needs to be displayed. For example, if the value includes Development, the attribute is displayed in the corresponding interface of the Development menu (Development and Integration).
NoteThe default value is Asset and cannot be modified.
Click OK to complete the attribute creation.
Manage table attributes
The operations for technical metrics, business metrics, fields, DataService Studio APIs, and dashboards are the same as those for tables. The following example uses Table.
The object attributes page for tables displays the following information for both system and custom attributes: name, code, description, source, type, required status, value type, input method, and visibility and editability settings.
(Optional) On the Table page, you can filter for attributes by entering an attribute name or code, or by selecting the attribute source, attribute type, required status, or input method.
In the attribute list on the Table page, you can perform the following operations on attributes.
NoteField attributes can only be viewed.
Operation
Description
Sort
Click Sort, drag the target attribute to the target position, and then click Complete Sorting.
NoteYou can sort only custom attributes.
This sorting affects the display order of attributes when you edit asset attributes.
View
Click the
icon in the Actions column of the target attribute. In the View Attribute dialog box, you can view the details of the attribute. If the current user has the Attribute Management - Manage permission and the attribute is a custom attribute, you can click the Edit button at the bottom to quickly modify its configuration.Edit
Click the Actions
icon in the column of the target attribute. In the Edit Property dialog box, you can modify the attribute.NoteSystem attributes cannot be edited.
In addition to Editable In and Visible In, Attribute Code also cannot be edited.
Delete
Click the Actions
icon in the column of the target attribute. In the Delete Property dialog box, click OK to delete the current attribute.NoteSystem attributes cannot be deleted.
Deleted attributes cannot be restored.