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

Получение информации о папках возможно при помощи методов Get*Folder* службы DocumentService.

Get	Folder	ById	GetFolderById	Получение объекта типа Folder на основании его ID.
	Folder	ByPath	GetFolderByPath	Получение объекта Folder на основании пути.
	Folders	ByFileMasterId	GetFolders ByFileMasterId	Получение всех папок, в которых содержится файл.
		ByFileMasterIds	GetFolders ByFileMasterIds	Получение всех папок, в которых содержится набор файлов.
		ByIds	GetFolders ByIds	Получение объектов Folder на основании их ID.
		ByParentId	GetFolders ByParentId	Получение подпапок папки хранилища.
		ByParentIds	GetFolders ByParentIds	Получение подпапок набора папок хранилища.
		ByPaths	GetFolders ByPaths	Получение списка объектов Folder на основании путей к ним.
	FileFolders	ByLabelId	GetFile FoldersBy LabelId	Получение списка объектов FileFolder на основании ID метки.
	LatestFiles	ByFolderId	GetLatestFiles ByFolderId	Получение последних версий всех файлов в папке.
	LatestFiles	ByFolderIds	GetLatestFiles ByFolderIds	Получение последних версий всех файлов в наборе папок.
	FolderDelete Restrictions	ById	GetFolder Delete Restrictions ById	Получение всех ограничений на удаление для папки.
	FolderDelete Restrictions	ByIds	GetFolder Delete Restrictions ByIds	Получение всех ограничений на удаление для набора папок.
	FolderIds	ByParentIds	GetFolderIds ByParentIds	Получение ID подпапок набора папок.
	FolderMove Restrictions		GetFolder Move Restrictions	Получение всех ограничений на перемещение для папки.
	FolderRename Restrictions		GetFolder Rename Restrictions	Получение всех ограничений на переименование папки.
	FolderRoot		GetFolderRoot	Получение корневой папки хранилища.

Давайте посмотрим, как это можно реализовать на практике.

Для удобства будем пользоваться Vault2014PowerPack.

Корневая папка хранилища

Самый простой метод – это GetFolderRoot(), которому даже не требуется параметров. Пример:

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

$vltDocumentSvc.GetFolderRoot()

Здесь $vltDocumentSvc – объект DocumentService.

Папка на основании пути

Метод public Folder GetFolderByPath(System.string Путь) возвращает объект Folder.Пример:

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

# Зададим путь к папке
$path1 = "$/Design/ Проект 1"
# Получим папку
$folder1 = $vltDocumentSvc .GetFolderByPath($path1)
# Выведем информацию по папке в таблицу
$folder1 | Format-Table -Property Name,CreateDate,ID

Дочерние файлы и папки

При помощи метода public System.long[] GetFolderIdsByParentIds(System.long[] ИдРодителя, System.bool Рекурсивно) можно получить дочерние папки для папки.

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

# Получим Id корневой папки
$FolderId = $vltDocumentSvc.GetFolderRoot().Id
# Получим Id прямых детей
$ChildrenIds = $vltDocumentSvc .GetFolderIdsByParentIds($FolderId, $false)
# Получим объекты по их Id
$Children = $vltDocumentSvc .GetFoldersByIds($ChildrenIds, $false)
$Children | Format-Table -Property Name,CreateDate,ID
# Произведём то же самое, с небольшой оптимизацией
$Children = $vltDocumentSvc.GetFoldersByParentId($FolderId, $false)
# Получим дочерние папки полученных детей. Фактически, папки хранилища второго уровня
$Children1 = $null;
$Children | ForEach-Object {$Children1+=$vltDocumentSvc.GetFoldersByParentId($_.Id, $false)}
$Children1 | Format-Table -Property FullName

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

Предлагаю для ознакомления части модуля Vault2014PowerPack

Set-VaultLocation

Аналог команды cd для файловых систем – изменяет текущий каталог.

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

function Set-VaultLocation
{
switch ($args.Count)
{
    0 { $fldr = $vltFolderCurrent }
    1 {
        $folderName = $args[0].ToString()
        if($folderName -like "$*") { $fldr = $vltDocumentSvc.GetFolderByPath($folderName) }
        elseif($folderName -eq "..") { if ($vltFolderCurrent.ParId -eq -1) {$fldr = $vltDocumentSvc.GetFolderRoot()} else {$fldr = $vltDocumentSvc.GetFolderById($vltFolderCurrent.ParId)} }
        elseif($folderName -eq "/") { $fldr = $vltDocumentSvc.GetFolderRoot() }
        else { $fldr = $vltDocumentSvc.GetFoldersByParentId($vltFolderCurrent.ID, $false) | Where-Object {$_.Name -eq $folderName} }
      }
    Default {}
}
}

Get-VaultChildItem

Аналог команды dir для файловых систем – возвращает список дочерних объектов.

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

function Get-VaultChildItem
{
[OutputType([Autodesk.Connectivity.WebServices.FileFolder])]
$vltObjects = $null
$total = 0
$global:vltFolders = $vltDocumentSvc.GetFoldersByParentId($vltFolderCurrent.ID, $false)
$vltObjects += $vltFolders #| Format-Table -Property Name, CreateDate
$total += $vltFolders.Count
$global:vltFiles = $vltDocumentSvc.GetLatestFilesByFolderId($vltFolderCurrent.ID, $false)
$vltObjects += $vltFiles #| Format-Table -Property Name, CkInDate -HideTableHeaders
$vltObjects
#$total += $vltFiles.Count
if($total -eq 0){"Folder is empty"}
}