Home > LIB_Device > modify

LIB_Device.modify() method

This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.

Modify Device

Signature

function modify(
	deviceUuid: string,
	libraryUuid: string,
	deviceName?: string,
	classification?: ILIB_ClassificationIndex | Array<string> | null,
	association?: {
		symbolUuid?: string;
		symbol?: { uuid: string; libraryUuid: string };
		footprintUuid?: string | null;
		footprint?: { uuid: string; libraryUuid: string } | null;
		model3D?: { uuid: string; libraryUuid: string } | null;
		imageData?: File | Blob | null;
	},
	description?: string | null,
	property?: {
		name?: string | null;
		designator?: string;
		addIntoBom?: boolean;
		addIntoPcb?: boolean;
		net?: string;
		manufacturer?: string | null;
		manufacturerId?: string | null;
		supplier?: string | null;
		supplierId?: string | null;
		otherProperty?: Record<string, boolean | number | string | undefined | null>;
	},
): Promise<boolean>;

Parameters

Parameter	Type	Description
deviceUuid	string	Device UUID
libraryUuid	string	Library UUID, you can use LIB_LibrariesList APIs in
deviceName	string	(Optional) Device name
classification	ILIB_ClassificationIndex | Array<string> | null	(Optional) Classification
association	{ symbolUuid?: string; symbol?: { uuid: string; libraryUuid: string }; footprintUuid?: string | null; footprint?: { uuid: string; libraryUuid: string } | null; model3D?: { uuid: string; libraryUuid: string } | null; imageData?: File | Blob | null }	(Optional) Associated symbol, footprint, image
description	string | null	(Optional) Description
property	{ name?: string | null; designator?: string; addIntoBom?: boolean; addIntoPcb?: boolean; net?: string; manufacturer?: string | null; manufacturerId?: string | null; supplier?: string | null; supplierId?: string | null; otherProperty?: Record<string, boolean | number | string | undefined | null> }	(Optional) Other property

Returns

Promise<boolean>

Whether the operation is successful

Remarks

If you want to clear certain properties, set their values to null

Example

// 1. 获取个人库 UUID 并新建修改对象
const libraryUuid = await eda.lib_LibrariesList.getPersonalLibraryUuid();
const deviceUuid = await eda.lib_Device.create(
	libraryUuid,
	`嘉立创示例_修改前_${Date.now()}`,
	[],
	{ symbolType: 2 },
	'修改前的描述'
);

// 2. 修改名称和描述（分类保持不变传 []）
const newName = `嘉立创示例_修改后_${Date.now()}`;
const modified = await eda.lib_Device.modify(deviceUuid, libraryUuid, newName, [], '修改后的描述');

// 3. 再补充修改扩展属性（位号、制造商）
await eda.lib_Device.modify(deviceUuid, libraryUuid, undefined, [], undefined, { designator: 'R', manufacturer: '嘉立创' });

// 修改类保留现场

console.log('deviceUuid:', deviceUuid);
console.log('modified:', modified);
console.log('newName:', newName);