Obtaining a Subject Tree

Function

This API is used to obtain the data asset subject tree of l1, l2, and l3.

URI

GET /v2/{project_id}/design/subjects/business

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID

Request Parameters

None

Response Parameters

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
name_ch	String	Chinese name Maximum: 600
name_en	String	English name Maximum: 600
description	String	Description Maximum: 2000
qualified_name	String	Extension name
guid	String	GUID, which is automatically generated
code	String	Code
alias	String	Alias
data_owner	String	Data owner
data_owner_list	String	Data owner list
data_department	String	Data domain
path	String	Path information
level	Integer	Level information
ordinal	Integer	Ordinal
owner	String	Owner Maximum: 4000
parent_id	Long	Parent catalog ID. If there is no parent catalog, the current catalog is the root catalog.
swap_order_id	Long	ID of the target node at the same level
id	Long	ID
qualified_id	String	Authentication ID, which is automatically generated
create_by	String	Creator
update_by	String	User who updated the catalog
create_time	String	Creation time
update_time	String	Update time
children_num	Integer	Number of sub-processes, excluding those of sub-processes. This parameter is not required for the front end.
children	Array of CatalogVO objects	Sub-catalog
self_defined_fields	Array of SelfDefinedFieldVO objects	Custom fields

**Table 3** SelfDefinedFieldVO
Parameter	Type	Description
fd_name_ch	String	Custom field name in Chinese Maximum: 200
fd_name_en	String	Custom field name in English Maximum: 200
not_null	Boolean	Whether the field is mandatory
fd_value	String	Field value

Status code: 400

**Table 4** Response body parameters
Parameter	Type	Description
error_code	String	Error code, for example, DS.000 which indicates that the request was successfully processed.
error_msg	String	Error message
data	Object	Returned data

Status code: 401

**Table 5** Response body parameters
Parameter	Type	Description
error_code	String	Error code, for example, DS.000 which indicates that the request was successfully processed.
error_msg	String	Error message
data	Object	Returned data

Status code: 403

**Table 6** Response body parameters
Parameter	Type	Description
error_code	String	Error code, for example, DS.000 which indicates that the request was successfully processed.
error_msg	String	Error message
data	Object	Returned data

Example Requests

None

Example Responses

Status code: 200

The operation succeed. The l1, l2, and l3 entities are returned.

{
  "name_ch" : "City traffic",
  "name_en" : "city_traffic",
  "description" : "",
  "qualified_name" : "city_traffic@Business.0cf68da0ba80f2962ff7c01ba8c0b7f7-workspace-f7eee36e67e541a59679f9b1b7f4eab0",
  "guid" : "f6e674d6-f657-4734-b417-837536c12eee",
  "code" : null,
  "alias" : "",
  "data_owner" : "",
  "data_owner_list" : "[\"abc\"]",
  "data_department" : null,
  "path" : "City traffic",
  "level" : 1,
  "ordinal" : 1,
  "owner" : "abc",
  "parent_id" : null,
  "swap_order_id" : null,
  "id" : "873232498044411904",
  "qualified_id" : null,
  "create_by" : "abc",
  "update_by" : "abc",
  "create_time" : "2021-08-06T15:54:11+08:00",
  "update_time" : "2022-08-30T10:59:38+08:00",
  "self_defined_fields" : [ {
    "fd_name_ch" : "Remarks",
    "fd_name_en" : "ez",
    "not_null" : false,
    "fd_value" : ""
  } ],
  "children_num" : null,
  "children" : null
}