Share

iLogicVaultClass Class

Provides functions to query, download, and check out files from Vault.
It also has a function to add files (with limitations), and another function to update properties.

In a rule, this class is instantiated by the predefined object named iLogicVault.

Note: these functions will only work if the Vault add-in is loaded. Vault Basic is not supported.

Inheritance Hierarchy

System.Object
  Autodesk.iLogic.Vault.iLogicVaultClass

Namespace:  Autodesk.iLogic.Vault
Assembly:  Autodesk.iLogic.Vault (in Autodesk.iLogic.Vault.dll) Version: 30.0

Syntax

VB

Public NotInheritable Class iLogicVaultClass

C#

public sealed class iLogicVaultClass

The iLogicVaultClass type exposes the following members.

Constructors

  NameDescription
Public methodiLogicVaultClass

Properties

  NameDescription
Public propertyIsVaultBasic
Returns True if we are running on Vault Basic.
Public propertyIsVaultPro
Returns True if we are running on Vault Pro.
Public propertyLoggedIn
Property representing the current user's Vault connection state. Returns true if the current user is logged in.

Methods

  NameDescription
Public methodAddFile
Adds local file to Vault and optionally attaches it to a parent file.
Does NOT build parent-child relationships!
So this function should not be used on any file (e.g. an assembly or drawing) that contains references to other files.
Public methodCheckFilesExistBySearchCriteria(Dictionary(String, String), Boolean, String[])
Search for multiple file(s) by one to many search criteria (specified as property/value pairs).
Returns a list of file names found, matching the criteria.
Preset Search Operator Options: [Property] is (exactly) [Value]; multiple conditions link up using AND/OR condition, depending MatchAllCriteria = True/False
Public methodCheckFilesExistBySearchCriteria(Dictionary(String, String), Dictionary(String, Dictionary(String, String)) , Boolean, String[])
Search multiple file(s) by one to many search criteria as property/value pairs.
Returns list of file names found, matching the criteria.
Preset Search Operator Options: [Property] is (exactly) [Value]; multiple conditions link up using AND/OR condition, depending MatchAllCriteria = True/False
Public methodConvertLocalPathToVaultPath
Convert the local file or folder path to the corresponding folder path in Vault.
Public methodCopyLocalFile
Copies a local file to a new name.
The source file's location and extension are captured and applied to the copy.
Use Check-In (iLogic) command for adding the new file to Vault.
Public methodGetFileByFullFilePath(String, Boolean)
Downloads Vault file using full file path, e.g. "$/Designs/Base.ipt". Returns full file name in local working folder.
Children and attachments are also downloaded.
Public methodGetFileByFullFilePath(String, Dictionary(String, String) , Boolean)
Downloads Vault file using full file path, e.g. "$/Designs/Base.ipt". Returns full file name in local working folder.
Children and attachments are also downloaded.
File Properties return all values converted to text. Access the value using the Vault property display name as key.
Public methodGetFileByFullFilePath(String, Dictionary(String, String) , Dictionary(String, String) , Boolean)
Downloads Vault file using full file path, e.g. "$/Designs/Base.ipt". Returns full file name in local working folder, download options include children and attachments.
File and Item property dictionaries return all values converted to text. Access the value using the Vault property display name as key.
Public methodGetFileBySearchCriteria(Dictionary(String, String), Boolean, Boolean, String[])
Search for a file by one to many search criteria as property/value pairs.
Downloads the first file found, if the search result lists more than a single file. Dependents and attachments are included. Overwrites existing files.
Preset Search Operator Options: [Property] is (exactly) [Value]; multiple conditions link up using AND/OR condition, depending MatchAllCriteria = True/False
Returns the file name downloaded (does not return names of downloaded children and attachments).
Public methodGetFileBySearchCriteria(Dictionary(String, String), Dictionary(String, String) , Boolean, Boolean, String[])
Search for a file by one to many search criteria as property/value pairs.
Downloads the first file found, if the search result lists more than a single file. Dependents and attachments are included. Overwrites existing files.
Preset Search Operator Options: [Property] is (exactly) [Value]; multiple conditions link up using AND/OR condition, depending MatchAllCriteria = True/False
Returns the file name downloaded (does not return names of downloaded children and attachments).
File property dictionaries return all values converted to text. Access the value using the Vault property display name as key.
Public methodGetFileBySearchCriteria(Dictionary(String, String), Dictionary(String, String) , Dictionary(String, String) , Boolean, Boolean, String[])
Search for a file by 1 to many search criteria as property/value pairs.
Downloads the first file found, if the search result lists more than a single file. Dependents and attachments are included. Overwrites existing files.
Preset Search Operator Options: [Property] is (exactly) [Value]; multiple conditions link up using AND/OR condition, depending MatchAllCriteria = True/False
Returns the file name downloaded (does not return names of downloaded children and attachments).
File and Item property dictionaries return all values converted to text. Access the value using the Vault property display name as key.
Public methodGetFileCopyBySourceFileNameAndAutoNumber
Copy Vault file on file server and download using full file path, e.g. "$/Designs/Base.ipt".
Create new file name using default or named numbering scheme.
Preset Options: Download Children (recursively) = Enabled, Enforce Overwrite = True
Public methodGetFileCopyBySourceFileNameAndNewName
Copy Vault file on file server and download using full file path, e.g. "$/Designs/Base.ipt".
Create new file name re-using source file's extension and new file name variable.
Preset Options: Download Children (recursively) = Enabled, Enforce Overwrite = True
Public methodGetFileCopyBySourceFileSearchAndAutoNumber
Search multiple file(s) by 1 to many search criteria as property/value pairs.
Downloads first file matching all or any search criteria.
Preset Search Operator Options: [Property] is (exactly) [Value]; multiple conditions link up using AND condition.
Preset Download Options: Download Children (recursively) = Enabled, Enforce Overwrite = True
Public methodGetFileCopyBySourceFileSearchAndNewName
Search multiple file(s) by 1 to many search criteria as property/value pairs.
Downloads first file matching all or any search criteria.
Preset Search Operator Options: [Property] is (exactly) [Value]; multiple conditions link up using AND condition.
Preset Download Options: Download Children (recursively) = Enabled, Enforce Overwrite = True
Public methodGetFilesBySearchCriteria
Search for multiple files by 1 to many search criteria as property/value pairs.
Downloads all files found, matching the criteria. Dependents and attachments are included. Overwrites existing files.
Preset Search Operator Options: [Property] is (exactly) [Value]; multiple conditions link up using AND/OR condition, depending MatchAllCriteria = True/False
Returns list of files names downloaded (does not return names of downloaded children and attachments).
Public methodGetNewNumber
Create single file number by scheme name and optional input parameters.
Public methodGetThumbnailFileByFullSourceFilePath
Download Thumbnail Image of the given file as Image file.
Public methodGetThumbnailFileBySearchCriteria
Download Thumbnail Image of the file searched as Image file.
Public methodGetThumbnailImageByFullSourceFilePath
Get Thumbnail of the given file as Image object.
Public methodGetThumbnailImageBySearchCriteria
Get Thumbnail Image of the file searched as Image object.
Public methodGetVaultConnection
Deprecated. Returns current Vault connection. Leverage LoggedIn property whenever possible. Null value returned if user is not logged in.
Public methodGetVaultFileStatus
Get the local file's status in Vault.
Validate the ErrorState = "None" to get all return values for vaulted files.
Validate the ErrorState = (LocalFileNotFoundVaultFileNotFound|VaultFileNotFound) to validate files before first time check-in
Public methodUpdateVaultFileProperties
Update multiple Vault file properties.

See Also

Reference

Was this information helpful?