Home > LIB_Classification > getIndexByName

LIB_Classification.getIndexByName() method

此 API 当前处于 BETA 预览状态，希望得到开发者的反馈。它的任何功能都可能在接下来的开发进程中被修改，请不要将它用于任何正式环境。

警告：此 API 现已弃用。

since EDA v3.2; dropped EDA v3.3

获取指定名称的分类的分类索引

签名

function getIndexByName(
	libraryUuid: string,
	libraryType: ELIB_LibraryType,
	primaryClassificationName: string,
	secondaryClassificationName?: string,
): Promise<ILIB_ClassificationIndex | undefined>;

参数名

参数	类型	描述
libraryUuid	string	库 UUID
libraryType	ELIB_LibraryType	库类型
primaryClassificationName	string	一级分类名称
secondaryClassificationName	string	（可选） 二级分类名称

返回值

Promise<ILIB_ClassificationIndex | undefined>

分类索引

备注

分类索引内包含分类的 UUID，具体可查阅 ILIB_ClassificationIndex

示例

// 1. 获取个人库 UUID
const libraryUuid = await eda.lib_LibrariesList.getPersonalLibraryUuid();

// 2. 创建两级测试分类（复用模块库，ELIB_LibraryType.CBB = '1'）
const tag = Date.now();
const primaryName = `嘉立创示例_按名索引一级_${tag}`;
const secondaryName = `嘉立创示例_按名索引二级_${tag}`;
const primaryIndex = await eda.lib_Classification.createPrimary(libraryUuid, '1', primaryName);
await eda.lib_Classification.createSecondary(
	libraryUuid,
	'1',
	primaryIndex.primaryClassificationUuid,
	secondaryName
);

// 3. 只按一级名称查索引
const primaryOnly = await eda.lib_Classification.getIndexByName(libraryUuid, '1', primaryName);

// 4. 按一级 + 二级名称查索引（secondaryClassificationName 可选）
const withSecondary = await eda.lib_Classification.getIndexByName(
	libraryUuid,
	'1',
	primaryName,
	secondaryName
);

// 5. 清理测试分类（查询类需要清理）
await eda.lib_Classification.deleteByUuid(libraryUuid, primaryIndex.primaryClassificationUuid);

console.log('primaryOnly.primaryClassificationUuid:', primaryOnly.primaryClassificationUuid);
console.log('withSecondary.secondaryClassificationUuid:', withSecondary.secondaryClassificationUuid);