The Staging Asset list displays assets collected from specified data sources through collection adapters and from the Data Middle Platform. You can view, filter, edit, and manage the listing status and permissions of these assets.
Prerequisites
Table asset/Metric asset/Dashboard asset: You have purchased the asset operation value-added service and enabled the asset operation module for your tenant.
API asset: You have purchased the asset operation value-added service and the data service feature.
To manage dashboard assets, you must create an application system and a Quick BI metadata collection task. For instructions, see Create and Manage Application Systems and Create and Manage Metadata Collection Tasks.
Permissions
Super administrators, operations administrators, and users assigned a custom global role with the listing management - manage permission can create, list, and manage quasi-assets.
Business system operators and maintainers with the asset maintenance permission can manage assets in their respective business systems.
Procedure
On the Dataphin home page, go to Assets > Catalog Management.
In the navigation pane on the left, click Manual Listing and select an asset type to open the Staging Asset page.
The Staging Asset list shows assets collected through collection adapters and from the data middle platform. It includes information such as Asset Name, Metric Type, Associated Technical Metric, asset source, category, latest status, info integrity, previously listed, Asset Import Time, Latest Data Time, and Last Updated.
Asset source: The asset's origin. API assets originate from a Data Service project, while Quick BI dashboards come from a Quick BI workspace. The Dataphin data section contains only logical tables.
Latest status: If an asset's status is Listing Failed, hover over the
icon next to the status to view the failure reason. After you resolve the issue, you can list the asset again.Info integrity: Indicates whether all required attributes for the asset are complete and valid.
Previously listed: Indicates whether the asset has been unlisted and then listed again.
(Optional) You can filter assets by criteria such as asset source, BI Space/Directory, category, info integrity, latest status, maintainer, metric type, latest data time, last updated, asset import time, last lister, previously listed, first lister, and first list time. You can also search for assets based on specified conditions.
In the Actions column, you can perform several operations on an asset. The available operations, illustrated here with a table asset, are the same for all asset types. You can select up to 10,000 assets for a single batch operation.
Actions
Description
Edit
You can modify the basic information, usage instructions, and visibility permissions of an asset. For more information, see Edit asset information.
List
Click List, or select one or more assets and then click List at the bottom of the page, to list the assets in the front-end asset catalog. If an approval rule is configured for an asset, the listing request requires approval. The approval comments cannot exceed 100 characters. After the request is approved, the asset appears in the front-end asset catalog. If no approval rule is configured, the asset is listed immediately.
NoteAssets can be listed only if all required information is complete.
You must list the parent table asset before you can list its custom metric assets.
Only users and roles with asset maintenance permissions can list assets.
This operation is available only for Staging Assets with a status of Not Listed or Listing Failed.
The names of listed business metrics must be unique within a tenant.
Do Not List
Click Do Not List and provide a reason to set the asset's status accordingly. Assets with this status do not appear in the front-end asset catalog.
To edit an asset with the Do Not List status, you must first change its status back to Staging Asset.
NoteThe Do Not List operation on a table asset also applies to its custom metrics, but it skips any metrics that you do not have maintenance permissions for. To list a custom metric when its parent table has the Do Not List status, you must first change the table asset's status back to Staging Asset and then list the metric asset.
Set Maintenance Permissions
This operation is not supported for business metrics.
Single operation: Click Set Maintenance Permissions to assign maintainers to the asset. Maintainers are responsible for daily maintenance, such as modifying information and managing the listing status.
Batch operation: Click Set Maintenance Permissions at the bottom of the page to add or modify maintainers in batches.
Modify: Replaces the maintainers of the selected assets with the newly specified ones.
Append: Retains the existing maintainers of the selected assets and adds the newly specified ones.
View change history
Displays an asset's change history over the last 30 days, including attribute and status changes.
NoteFor custom metrics, a change in statistical granularity corresponds to a change in the fields defined as dimensions in the parent table. This change takes effect when the table asset is listed.
Delete
This operation is available only for business metrics. You can delete a business metric if its status is Not Listed, Do Not List, or Listing Failed. Deleting the business metric also removes its associations with related business metrics and technical metrics.
Modify attributes
Select one or more assets and click Modify Attributes at the bottom of the page to edit their attributes in bulk.
Compared to editing a single asset, some attributes offer more flexible configuration options.
Add all required attributes: Click to quickly add all attributes required for listing the current asset type.
Table display name/Description: You can use DDL comments or custom input. You can select the Apply only to assets with an empty display name option. If this option is not selected, the existing display names of the selected tables will be overwritten.
Reference DDL comment: Uses the comment of the data table as the asset's display name or description. The value updates automatically when the DDL comment changes.
Custom: Allows you to select the Table/Field Name or DDL comment as the asset's display name. You can select the DDL comment as the asset's description or Clear the description.
Field display name/Description: You can use a DDL comment or a custom value. You can also select Apply only to assets with empty display names. If you do not select this option, the existing display names of the selected table fields are overwritten.
Reference DDL comment: If you select Apply only to assets with empty display names, this setting applies to all fields in the current table that have an empty display name or description. It uses the comment of the data field as the asset's display name or description, which updates automatically with DDL comment changes.
Custom: If you select Apply only to assets with empty display names, this setting applies to individual fields in the current table that have an empty display name or description. You can select the Field Name or DDL comment as the display name. You can select the DDL comment as the asset's description or Clear the description.
NoteWhether you reference DDL comments or use custom values, you must use the same method for all fields in the current table.
If you change the setting for a field's display name or description from Reference DDL comment to Custom and select Apply only to assets with empty display names, the change takes effect only if the DDL comments for all fields in the current table are empty.
If you change the setting for a field's display name or description from Custom to another Custom setting and select Apply only to assets with empty display names, the change takes effect for any individual field in the current table that has an empty value.
Category/Asset tag/Related business metrics: You can Append to the existing configuration or Replace it with the current configuration.
If your account has the Listing Management-Manage permission, you can click the Tag Management button to navigate to the Assets > Catalog Management > Other Settings > Basic Settings page to create new tags.
Business owner: Modifiable only for business metrics.
Visibility/Data profiling report: Controls whether to display the corresponding content on the asset details page in the asset catalog.
Atomic metric/Business qualifier/Statistical period/Unit of measure: Modifiable only for custom technical metrics.
Is additive/Related business metrics: Modifiable only for technical metrics.
Data lineage/Quality profile: Modifiable only for table and metric assets. Controls whether to display the corresponding content on the asset details page.
Metric relationship diagram: Modifiable only for standard modeling metric assets. Controls whether to display this diagram on the asset details page.
Metadata change history: Modifiable only for table assets. Controls whether to display this information on the asset details page.
Other custom attributes: You can configure other custom attributes for assets in Planning > Attribute Management to enrich asset information.
Data consumption: Modifiable only for table assets. Controls whether users can apply for consumption permissions on the asset details page.
NoteFor API and dashboard assets, you can modify the following system attributes: Category, Asset Tag, and Visibility.
For business metric assets, you can modify the following attributes: Category, Asset Tag, Business Owner, Visibility, and Related Business Metrics.
When the table type is a physical table, physical view, materialized view, or data source table, the display names and descriptions for the table and its fields can reference DDL comments.
Export assets
Click Export Assets at the bottom of the page to export the selected assets in batches. The system automatically skips assets for which the current user does not have maintenance permissions.
If you are exporting a large number of assets, the export file may take some time to generate. You can monitor the export task and download the file from the Batch Management-Batch Operation History page.
NoteChanges to some asset attributes, such as Category and asset tags, require you to list the asset again to update the front-end catalog. Other changes, such as field or dashboard chart information, update immediately without relisting.
If a listed asset is deleted, the Relisting required column shows Yes. We recommend that you list the asset again to maintain data consistency and availability.
If an asset has been deleted, it can only be viewed.
Edit asset
Saving a
table assetautomatically generates the correspondingmetric assets.If you select the Publish related metrics simultaneously checkbox, the system publishes the
table assetand its relatedmetric assetstogether.You must publish the
table assetbefore publishing itscustom metrics.When the
table typeisphysical table,physical view,materialized view, ordata source table, you can useDDL commentsto define thedisplay nameanddescriptionfor the table and itsfields.
Table asset
Parameter | Description | |
Basic information | Name | Displays the name of the asset. This field cannot be modified. |
Display name | Enter a display name for the asset. You can use a DDL comment or enter a custom name.
| |
Catalog | Select one or more published catalogs from the table subject. | |
Tags | You can select up to 20 tags. If your account has the Listing Management-Manage permission, you can click Tag Management to navigate to the Assets > Catalog Management > Other Settings > Basic Settings page to create new tags. | |
Description | You can use a DDL comment or enter a custom description.
| |
Attribute information | Business attributes/Management attributes/Technical attributes | Displays the system and custom attributes of the asset. You can select Hide read-only attributes in the upper-right corner to focus on editable information.
|
Field information | No. | You can click the Sort |
Field name | You can click the Sort | |
Data type | Displays the data type of the field. | |
Field display name | Enter a display name for the field. You can use a DDL comment or a custom name.
| |
Description | You can use a DDL comment or enter a custom description.
| |
Business type | You can select one of three business types: dimension, metric, or statistical period. | |
Associated entity |
| |
Data classification | The data security module must be enabled to view the data classification of the field. | |
Data sensitivity level | The data security module must be enabled to view the data sensitivity level of the field. You can click the Sort | |
Actions |
| |
Related metrics | When the business type of one or more fields is set to metric, the related metrics list is displayed. This list shows the metric's name, listing status, catalog, tags, atomic metric, business qualifier, statistical period, and unit of measure. You can perform the following operations on the metrics (requires maintenance permission for the metric asset).
| |
Usage instructions | Enable | This feature is disabled by default. If you enable it, the usage instructions are visible on the asset details page in the asset catalog. You can add instructions to introduce the asset and guide data consumers, helping them evaluate its usability and apply for access. Note
|
Access control | Visibility | Controls whether the asset is visible in the asset catalog. Three options are available:
|
Data profiling report | The data profiling report is available only if data profiling is enabled for the asset in the asset inventory (requires the Data quality module). You can set its visibility to Visible to all users, Visible to specific users, or Not visible to any users. The configuration is the same as for Visibility. | |
Data lineage | If you enable this option, the asset details page in the asset catalog displays the complete, direct data lineage, including unlisted objects and objects you do not have permission to view. However, you cannot view the details of those objects. | |
Quality profile | If you enable this option, the asset details page displays a quality profile, including scores for the six quality dimensions (Completeness, Uniqueness, Timeliness, Validity, Consistency, and Stability) and the results of monitoring rules. Selecting Hide quality rule validation details hides the rule validation details in the quality profile on the asset details page. | |
Metadata change history | To configure this option, you must first enable metadata change versioning on the Metadata > Metadata Change History page. Once enabled, the metadata version history is visible on the asset details page. To change the maximum number of versions to retain, see Metadata Change History. | |
Data consumption | If you enable this option, users can apply for data consumption permissions from the asset details page in the asset catalog. | |
Associated row-level security | If you have enabled the row-level security feature, this section displays information about the row-level security policies associated with the asset, including Policy Name, Control Rules, and Associated Fields. You can view the control rules or edit the policy.
| |
Business metric
Business metrics represent business requirements in a standardized form that developers can act on. Associating them with technical metrics simplifies metric analysis for business personnel.
To create a business metric, click Create Business Metric on the quasi-asset page. The procedures for creating and editing are identical.
Parameter | Description | |
Basic information | Name | Enter a globally unique name for the business metric. The name can contain English letters, numbers, and the following special characters: |
Display name | Enter a display name for the asset, up to 1,000 characters long. You can click Fill in Asset Name or Fill in Asset Description to quickly populate this field. | |
Parent directory | Select one or more published directories under the metric subject. | |
Tag | Select up to 20 tags. If your account has the Listing Management-Manage permission, you can click Tag Management to create new tags on the Asset > Directory Management > Other Settings > Basic Settings page. | |
Description | Enter a description for the asset, up to 1,000 characters long. | |
Metric definition | Metric definition | You can add a metric definition in two ways: through custom input or by referencing another business metric. This definition helps business personnel understand the metric.
In the configuration box, use operators to define the relationships between selected metrics. Supported operators include plus (+), minus (-), multiply (*), divide (/), parentheses (), percent (%), and sum (∑). |
Related business metrics |
Note You can associate a maximum of 100 business metrics. | |
Metric relationship diagram | Based on the related business metrics you have added, you can configure a metric relationship diagram to clearly and intuitively break down the metric's composition. This feature is disabled by default. When enabled, click the Edit icon to open the Configure Metric Relationship Diagram dialog box. A diagram starting with the current metric node is displayed. You can configure the calculation logic for related business metrics on the right. Click OK to save the configuration. The diagram can be viewed when editing the business metric.
Note
| |
Attribute information | Business attributes | Displays the system and custom attributes of the asset. You can select Hide Read-only Attributes in the upper-right corner to focus on editable information.
|
Associated technical metrics | Associate technical metrics |
|
Usage instructions | Enable | Disabled by default. When enabled, usage instructions appear on the asset details page in the asset catalog. You can add instructions to introduce the asset and guide data consumers. This helps users assess the asset's suitability and provides justification when they request access permissions. Note
|
Permission control | Visibility scope | This setting controls the asset's visibility in the asset catalog but does not affect its visibility within its summary table. Three visibility scopes are available:
|
Technical indicator
Parameter | Description | |
Basic information | Name | Displays the name of the asset. This field is read-only. |
Display name | Enter a display name for the asset, up to 1,000 characters. You can click Fill in Asset Name or Fill in Asset Description to quickly populate this field with the asset's name or description. | |
Parent directory | Select one or more published directories from the indicator topic. | |
Tag | Select up to 20 tags. If your account has the Listing Management-Manage permission, click Tag Management to go to Asset > Directory Management > Other Settings > Basic Settings and create new tags. | |
Indicator definition | This field is displayed only for modeled indicators. It shows the indicator definition entered in Development > Develop > Indicator. | |
Description | Enter a description for the asset, up to 1,000 characters. | |
Attribute information | Business attribute/Technical attribute | Displays the system and custom attributes of the asset. In the upper-right corner, you can select Hide Read-only Attributes to focus on editable attributes.
|
Usage instructions | Enable | This feature is disabled by default. If enabled, the usage instructions are visible on the asset details page in the asset catalog. You can add instructions to introduce the asset and guide data consumers in evaluating its usability and applying for access. Note
|
Access control | Visible Scope | Controls whether the asset is visible in the asset catalog. This setting does not affect the indicator's visibility in the aggregation table. Three visibility options are supported:
|
Data profiling report | To view a data profiling report, enable data profiling for the asset in the asset inventory (requires the Data Quality feature). It supports Visible to All Users, Visible to Some Users, and Invisible to All Users. The configuration is the same as for the visibility scope. | |
Data lineage | When enabled, the asset details page displays the complete direct data lineage. This lineage includes staged assets and objects for which you do not have view permissions, although you cannot view their details. | |
Indicator relationship diagram | When enabled, the asset details page shows an indicator relationship breakdown diagram rooted at this indicator. This helps you understand the indicator derivation logic. Selecting Hide SQL Calculation Logic hides the calculation logic in the indicator details dialog box in Asset Catalog > Asset Details. | |
Quality overview | When enabled, the asset details page displays a quality overview, including scores for six quality dimensions (Completeness, Uniqueness, Timeliness, Validity, Consistency, and Stability) and monitoring rule statistics. Selecting Hide Quality Rule Check Details hides these details in the Quality Overview section of the asset details page. | |
API asset
Parameter | Description | |
Basic information | API_ID | Displays the ID of the asset. This field cannot be modified. |
API name | Displays the name of the asset. This field cannot be modified. | |
Directory | Select one or more published directories from the API topic. | |
Tag | Select up to 20 tags. If your account has the Listing Management-Manage permission, you can click Tag Management to go to the Asset > Directory Management > Other Settings > Basic Settings page to create tags. | |
Description | This field displays the API's original description by default. You can edit the description, which has a 128-character limit. | |
Attribute information | Business Attributes/Management Attributes/Technical Attributes | Displays the asset's system and custom attributes. In the upper-right corner, select Hide Read-only Properties to view only editable fields.
|
Business Parameter Request List, Public Parameter Request List, and Response Parameter List | Displays the business request parameters, public request parameters, and response parameters for the API. For details, navigate to the API Documentation for the target API on the Service > Market > API tab. | |
Row-level permission list | Displays the API's enabled row-level permissions. For details, go to the Service > Development > API page and select the target API. | |
Usage Instructions | Enable | This feature is disabled by default. When enabled, the instructions you provide here appear on the asset's details page. Use these instructions to help data consumers evaluate the asset and justify their access requests. Note
|
Access control | Visibility Scope | Controls the asset's visibility in the asset catalog. The available options are:
|
Dashboard asset
Parameter | Description | |
Basic information | Dashboard name | Displays the name of the asset. This field is read-only. |
Parent directory | Select one or more published directories under the dashboard topic. The root directory cannot be selected. | |
Tags | You can select up to 20 tags. If your account has the Listing Management-Manage permission, you can click Tag Management to navigate to the Assets > Catalog Management > Other Settings > Basic Settings page and create new tags. | |
Description | Enter a description for the asset. The description can be up to 1,000 characters long. | |
Attribute information | Business attribute/Management attribute/Technical attribute | Displays the system and custom attributes for the asset. Select Hide Read-only Attributes in the upper-right corner to focus on editable information.
|
Chart information | This section displays detailed information about the charts on the current dashboard, which you can view on the Governance > Metadata > Metadata List > Dashboard tab.
| |
User guide | Enable | This feature is disabled by default. If enabled, the user guide is visible on the asset details page in the asset catalog. Use this guide to introduce the asset and provide instructions for data viewers, helping them evaluate its usability and request access permissions. Note
|
Access control | Visible Scope | Determines the asset's visibility in the asset catalog. The following options are available:
|
Intelligent generation
Dataphin uses large language models (LLMs) to generate basic information for tables, fields, and business metrics from table assets, reducing manual data configuration effort.
On the intelligent generation page, the first row displays the existing configuration, and the second row shows the intelligently generated information. You can only edit the generated information.
Generating information for a large number of fields or
technical metricscan be time-consuming. Please be patient while the process completes.
On the pre-asset tab, click the Edit icon in the Actions column of the target asset to open the Edit Asset page.
On the Edit Asset page, click the Intelligent Generation button in the upper-right corner to open the intelligent generation page. The system generates basic information for the current asset (for
technical metricassets, only basic information can be edited), field information, and table-related metric information. You can modify the generated information.Table asset
Parameter
Description
Basic information
Display name
The system intelligently generates a display name, which you can modify. The display name must be 256 characters or less.
Directory
The system recommends published directories from the table's subject area. You can select multiple directories.
Tag
The system intelligently recommends tags. You can select up to 20 tags.
Description
The system will intelligently generate content based on your custom description (up to 1000 characters), and you can modify the generated content.
Field information
Field display name
The system intelligently generates a display name for the field, which you can modify. The display name must be 512 characters or less.
Description
The system intelligently generates a description for the field, which you can modify. The description must be 2,048 characters or less.
Business type
You can select from three business types: dimension, metric, and statistical period. Click Clear to remove all business type information at once.
Dimension: When a field name is
id(case-insensitive), itsbusiness typeis automatically set to dimension. You can change this setting.Metric:
For non-measure fields, the system determines if the field is a metric by analyzing its name, display name, and description. If it is, the
business typeis set to metric. You can change this setting. Examples include refund rate, total refund amount, and top 3 purchases per capita.For measure fields, if the data type is
bigint, double, int, smallint, tinyint, float, thebusiness typeis automatically set to metric. You can change this setting.
Statistical period: If a field's data type is
date, datetime, timestamp, itsbusiness typeis automatically set to statistical period. You can change this setting.
Associated entity
This field applies only when the field's
business typeis dimension. The system automatically populates this field with a business entity from the corresponding data domain. You can change this selection.If a field is already associated with a business entity, changing its
data domainalso updates thebusiness entity.Intelligently generate related metrics
You can click the Intelligently Generate Related Metrics button only if the field's business type includes metrics. If the business type also includes dimensions, you must first select a Data Domain in the field information area before you can click the Intelligently Generate Related Metrics button. Clicking the button generates a list of related metrics.
Intelligently generate related metrics
Metric
Fields with a
business typeof metric are added as metric information. You can modify this information on the metric editing page.Directory
The system intelligently recommends up to five published directories from the table's subject area, including those already added. You can select multiple directories.
Tag
The system intelligently recommends up to eight tags, including those already added. You can select up to 20 tags.
Technical metric
Parameter
Description
Basic information
Display name
The system intelligently generates a display name for the metric, which you can modify. The display name must be 256 characters or less.
Directory
The system recommends published directories from the metric's subject area. You can select multiple directories.
Tag
The system intelligently recommends tags. You can select up to 20 tags.
Description
The system intelligently generates a description for the asset, which you can modify. The description must be 1,000 characters or less.
After you confirm that the generated information for related metrics is correct, click Save. If the saved information does not meet your needs, you can click Clear in the upper-right corner to remove the directory and tag information for the metrics.
After confirming that all information is correct, click Apply to populate the Edit Asset page with the generated information.
You can perform the following actions on all generated information:
Retry: Regenerates the related metrics or all information.
Discard: Discards the currently generated related metrics or all information.
Terminate: Stops the in-progress generation of related metrics or all information.
Resume Generation: Resumes the stopped generation of related metrics or all information.