Лёгкое программирование под Autodesk Vault Часть 35

Методы

Получение информации об элементе производится при помощи методов Get*Item* служб ItemService и PackageService.

Служба	Операция	Объект	Опция	Метод	Описание
Item Service	Get	Attachments	ByItemId	GetAttachments ByItemId	Получает вложенные файлы для элемента.
		Attachments	ByItemIds	GetAttachments ByItemIds	Получает вложенные файлы для набора элементов.
		Item	ByItem NumberAnd RevisionNumber	GetItemByItem NumberAnd RevisionNumber	Получает объект Item на основании номера элемента и номера редакции.
		Items	ByAttachment FileId	GetItemsBy AttachmentFileId	Получает элементы, к которым файл прикреплен. Только находит элементы, если файл прикреплен к головной редакции.
			ByFileId	GetItemsBy FileId	Получает все элементы, которые привязаны к файлу.
			ByFileId AndLink TypeOptions	GetItemsBy FileIdAndLink TypeOptions	Получает набор элементов, которые определенными способами связаны с конкретным файлом.
			ByIds	GetItems ByIds	Получает набор элементов, на основании их идентификаторов.
			ByItem MasterId	GetItems ByItemMasterId	Получает все редакции элементов, связанные с главным идентификатором элемента.
			ByRevision Ids	GetItems ByRevisionIds	Получает набор объектов Item на основании набора идентификаторов редакций элементов.
		Watermark	ByItem IdAnd FileId	GetWatermark ByItemId AndFileId	Получает водяной знак для элемента и файла.
		JobTypes	ByItem LifeCycle State TransitionIds	GetJobTypes ByItem LifeCycle State TransitionIds	Получает пользовательские работы, которые отменены для набора транзакций.
		AllItems	ByItem MasterId	GetAllItems ByItem MasterId	Возвращает все версии элемента.
		ItemBOM Association Properties		GetItem BOM Association Properties	Получает значения для свойств на ассоциациях спецификации.
		ItemBOM	ByItem IdAnd Date	GetItem BOMByItem IdAndDate	Получает элемент спецификации для заданного элемента по дате его вступления в силу.
		ItemBOM FileAssociations	Bydate	GetItem BOMFile Associations ByDate	Получает файлы, связанные с элементом спецификации.
		ItemBOM Links	ByItem Ids	GetItem BOMLinks ByItemIds	Получает ссылки дочернего элемента.
		ItemDelete Restrictions	ByIds	GetItem Delete Restrictions ByIds	Получает ограничения на удаление набора элементов.
		Item Duplicate Candidates		GetItem Duplicate Candidates	Получает список дочерних элементов с сопоставленными номерами деталей.
		Item Effectivity	ByItem IdsAnd Date	GetItem EffectivityBy ItemIds AndDate	Получает набор элементов и их эффективность для определенной даты.
		ItemFile Associations	ByItem Ids	GetItem FileAssociations ByItemIds	Получает все ассоциации файлов для данного элемента. Не включает вложения.
		ItemLife CycleStates ACL		GetItem LifeCycle StatesACL	Возвращает ACL для элементов, которые не находятся в состоянии «В работе».
		Item MasterIds ForItemVersion Delete		GetItem MasterIdsForItem VersionDelete	Возвращает список главных идентификаторов элемента, которые имеют историческую версию элемента, которая не может быть удалена основе указанных опций удаления.
		LastestItem InRevision	ByItem Id	GetLastest ItemInRevision ByItemId	Получить последний элемент для редакции.
		LatestItem	ByItem MasterId	GetLatest ItemBy ItemMasterId	Получает последнюю версию элемента.
		LatestItem	ByItem Number	GetLatest ItemBy ItemNumber	Получает последнюю редакцию элемента.
		LatestItems	ByItem MasterIDs	GetLatest ItemsBy ItemMasterIds	Получает последние версии для набора главных идентификаторов элемента.
		Next Revision Numbers	ByItem RevisionId	GetNext RevisionNumbers ByItemRevisionId	Получает доступные параметры нумерации следующей редакции.
		Property Constraint Failures	ByItem MasterIDs	GetProperty ConstraintFailures ByItemMasterIds	Получает все свойства, которые нарушают ограничение для данного элемента.
		Property Constraints	ByItem TypeId	GetProperty Constraints ByItemTypeId	Получает эффективные ограничения свойств для данного типа элемента.
		Released Items	ByItem MasterId	GetReleased ItemsByItem MasterId	Получает список опубликованных и эффективных (в прошлом, настоящем или будущем) версий элемента.
		Restorable Items	ByItem MasterId	GetRestorable ItemsByItem MasterId	Получает редакции, которые могут быть восстановлены для данного элемента.
		UseACL ForItem LifeCycle States		GetUse ACLForItem LifeCycleStates	Получает значение параметра UseACLForItemLifeCycleStates.
Package Service	Get	ItemsAndBOMs	From ItemIds	GetItems AndBOMs FromItemIds	Получает информацию элементов и спецификации для экспорта.

Примеры использования

Считаем, что работа происходит в модуле Vault2014PowerPack. Здесь:

$vltItemSvc — переменная, представляющая объект ItemService.

Элемент по его номеру и номеру редакции

Получим элемент по доступным данным

Код - PowerShell: [Выделить]

# Задание номеров элемента и редакции
$itemNo = «77-535»
$revNo = «A»
# Получение объекта Item
$item = $vltItemSvc.GetItemByItemNumberAndRevisionNumber($itemNo, $revNo)

Элементы по идентификатору файла

Код - PowerShell: [Выделить]

# Получим идентификатор файла
$fileId = ($vltDocumentSvc.GetLatestFilesByFolderId($fold.Id, $false) | Where-Object {$_.Name -eq "pump1.iam"}).Id
# Получим объекты Item
$items = $vltItemSvc.GetItemsByFileId($fileId)
# Проверка на наличие элементов
if(!$items){"У файла нет подвязанных элементов"}