Create and manage asset topics

更新时间: 2026-01-17 20:31:36

Asset topics enable centralized management of created topics and their associated directories, enhancing the efficiency of topic management. This topic describes the steps for creating and managing asset topics.

Prerequisites

  • Table asset: The intelligent R&D edition has been enabled or the value-added module of asset operation - Standard Edition has been purchased.

  • Metric asset/dashboard asset: The intelligent R&D edition has been enabled or the value-added module of asset operation - Pro has been purchased.

  • API asset: The intelligent R&D edition has been enabled or the value-added module of asset operation - Pro has been purchased, and the data service feature has been purchased.

Limits

Supports creating directories with up to 10 levels.

Permission description

  • Super administrators, operation administrators, and custom global roles with Catalog Design-Management permissions can view, create, and manage asset topics and manage the directories of asset topics.

  • Topic administrators can manage the asset topics they have created, including editing basic information of the topic, managing the scope of visibility, managing topic directories, and other operations.

Create a new topic

  1. In the top menu bar on the Dataphin home page, select Asset > Directory Management.

    You can create separate asset topics and directories for different assets. The creation methods for metric topics, API topics, dashboard topics, and table topics are the same. The following describes the process using table topics as an example.

  2. In the left navigation bar, select Catalog Design > Catalog Design. In the topic list on the Table Directory tab, click the image icon to enter the Create New Asset Topic dialog box.

  3. In the Create New Asset Topic dialog box, configure the parameters.

    Parameter

    Description

    Topic Name

    Enter the name of the asset topic. The topic name must be unique and no more than 256 characters.

    Description

    Enter the background information of the asset topic to help relevant personnel quickly understand it. No more than 512 characters.

    Topic Administrator

    The default is the current user. You can select users in normal status under the current tenant.

    Visible To

    Determines whether the asset topic is visible in the asset directory. Supports two visibility scopes:

    • Visible To All: All users under this tenant can view the asset topic.

    • Visible To Topic Administrators And Specified Members: Supports topic administrators and specified members viewing the asset topic. Members can be specified by user or user group.

      • Select by user: Select users in normal status under the current tenant.

      • Select by user group: You can select user groups in normal and enabled status. Members are automatically updated with changes in user group members. To create a user group, see Create and manage user groups.

    Publish Approval

    Default is off. When enabled, the topic must be approved before it can be published.

  4. Click OK to complete the creation of the asset topic.

Manage asset topics

The page display of metric directories, API directories, and dashboard directories is consistent with that of table directories. The following describes the process using table directories as an example.

You can view the configured asset topics on the Table Directory tab and perform operations such as editing and deleting.

image

Area

Description

Topic Directory List

  • Displays the configured asset topics, including the topic name, publish status, and description information.

    After selecting a topic, the directory belonging to the current topic is automatically displayed in the right list.

  • Batch Management: You can fill in configuration information based on the system template and batch import the content sorted offline into Dataphin. You can also download the existing asset directory configuration to your local, modify it, and then import it. For more information, see Batch import and export asset topics.

Topic Basic Information

Displays the name, administrator, visibility scope, publish approval, and description information of the asset topic. You can also perform edit and delete operations on the asset topic.

  • Edit: Supports modifying all information of the topic.

  • Delete: After the asset topic is deleted, the directories under the asset topic and the directories to which the assets belong will be automatically deleted. You can add directories again by modifying properties later.

Directory List

Displays the publish status, name, description, last updated by, and last updated time information of the published online directories. You can expand the directory to view the subdirectory information belonging to the current directory. You can also perform operations such as publishing topics or editing directories.

  • Publish Topic: If the topic is in the publishing or pending publish status, click the Publish Topic button. The system will publish the latest content in the directory edit state. You can click View to enter the directory edit page to view the latest directory content. If the topic has enabled publish approval, it must be approved before it can be successfully published.

  • Edit Directory: Supports creating directories under the topic. For more information, see Manage directories of asset topics.

Manage directories of asset topics

Directories can help you perform more fine-grained analysis and management of assets, allowing you to search for assets more quickly and accurately and better manage asset operations. The management methods for metric directories, API directories, and dashboard directories are consistent with those of table directories. The following describes the process using table directories as an example.

  1. On the Dataphin home page, select Asset > Directory Management in the top menu bar.

  2. Click Directory Planning in the left navigation bar, then click Edit Directory.

  3. On the Edit Directory page, click the Create First-level Directory button to create a directory.

    Parameter

    Description

    Directory Name

    Enter the name of the directory. Directories at the same level in the same directory cannot have the same name. No more than 128 characters.

    Directory Description

    Enter the relevant description of the directory. No more than 128 characters.

  4. Click the Save image icon to complete the creation of the directory.

You can perform operations such as editing, deleting, and moving on the created directories on the edit directory page.

image

Area

Description

Search Area

You can search for directories based on the directory name or description.

Function Area

  • Batch Edit: Click the Batch Edit button. After modifying the content that needs to be changed, click the Finish Editing button in the upper right corner to complete the batch modification of the directory. When the application status of the topic directory is pending publish (deleted) or under publish approval, batch editing operations are not supported.

  • Sort: Click the Sort button to drag the directory (including the current directory and its subdirectories) for sorting or select Sort By Directory Name Ascending or Sort By Directory Name Descending for sorting. It takes effect immediately. Click the Exit Sorting button in the upper right corner to exit the directory sorting page.

    Note
    • If the status of the current first-level directory is publishing or under approval, you cannot move the first-level directory and its subdirectories or move other directories to the first-level directory and its subdirectories. However, you can move the order of the subdirectories under the directory.

    • If you move a first-level directory and its subdirectories to a new parent directory, the parent directory cannot be in the publishing or under approval status.

    • After the order of the first-level directories changes, the topic must be published to take effect.

  • Publish Topic: Click the Publish Topic button to publish the unpublished first-level directories. If the topic has enabled publish approval, it must be approved before it can be successfully published.

  • Create First-level Directory: Create a first-level directory. For more information, see Manage directories of asset topics.

  • Refresh: Click to refresh the directory list.

  • Expand All/Collapse All: Click to expand or collapse the directory tree.

Directory List

Displays the name, ID, description, application status, and the last updated by and last updated time information of the directory. Different directory statuses support different operations. For more information, see Directory operations.

Batch Operation Area

You can perform batch operations such as moving, publishing, deleting, and restoring deleted directories.

Exit Directory Editing

You can click the Exit Editing button to exit the directory edit mode. Click the Publish And Exit button to publish the directory and exit the directory edit mode.

Directory operations

Directory status

Directory application status

Operations

Pending publish

Create subdirectory, save and create a new row, edit, move, delete, publish.

Published

Create subdirectory, save and create a new row, edit, move, delete.

Under publish approval

View approval, revoke approval, restore deletion.

Rejected

Create subdirectory, save and create a new row, edit, publish, move, view approval, delete.

Pending publish (deleted)

Restore deletion, publish.

Rejected (deleted)

View approval, restore deletion, publish.

Operation description

Operations

Description

Create Subdirectory

Supports creating directories with up to 10 levels.

Save And Create A New Row

Save subdirectory information and automatically create a directory at the same level.

Edit

Supports modifying directory information.

Publish

When there are changes such as adding, editing, deleting, or moving in the directory, the first-level directory to which the changed directory belongs must be published to take effect.

Note
  • If there is a cross-first-level directory move, the first-level directories of both the source parent directory and the target parent directory must be published.

  • If the topic has enabled approval, the directory can only be successfully published after approval.

  • When publishing directories in batches, the system will automatically ignore first-level directories that are being published or under approval, along with directories in the pending publish or pending publish (deleted) status.

Move

Supports moving the parent directory to which the directory belongs. Cross-topic directory moves are not supported.

Note

The status of the source directory and the target directory must be not in publishing or under approval.

Delete

After deleting a directory, the current directory and its subdirectories will be deleted synchronously, and the status will change to pending publish (deleted). Click the Publish Topic button to complete the deletion of the directory. If the topic has enabled approval, the directory can only be successfully deleted after approval.

Note
  • If there are assets under the directory, deleting the directory will cause the assets to not belong to any directory. You can modify the asset properties and then list the assets again.

  • When deleting directories in batches, the system will automatically ignore directories that are being published or under approval.

Revoke Approval

If the topic has enabled publish approval, you can revoke directories that are under approval.

View Approval

Click the View Approval icon to jump to the Task Center to view the approval progress of the approval order.

Restore Deletion

After restoring deletion, the directory and its subdirectories in the pending publish (deleted) status will be restored to the state before deletion.

Note

When restoring deleted directories in batches, the system will automatically ignore directories that are being published or under approval.

What to do next

After the asset topic is created, you can categorize assets into the directories of the asset topic for fine-grained management of assets. For more information, see Manage quasi-assets.

上一篇: Catalog Design 下一篇: Batch import and export of asset topics
阿里云首页 智能数据建设与治理 Dataphin 相关技术圈