2020.1

MetaFile
The MetaFile object represents the physical Metadata file and is used to load and save the
Metadata from and to the file system. It also publishes the "MetaJob" on page199 object, which
is the root node of the Metadata structure.
The MetaFile object is the only object that is formally published to the user. All the other objects
are obtained, directly or indirectly, through methods of this object.
A standalone, empty MetaFile object can be created using CreateObject
("MetadataLib.MetaFile") in any script program, even outside of Workflow, or the {145E89F9-
C2DF-4604-821A-9BD6C4B468DA} CLSID with CoCreateInstance.
The current job's Metadata file name can be obtained using the Watch.GetMetadataFilename
method (see "Watch.GetMetadataFilename" on page166) when using the "Run Script" on
page477 task. Note that the exact syntax may vary according to the selected script language.
When writing a plugin using the plugin SDK the current job's Metadata file name can be
obtained by calling the IWatchJob::MetadataFilename method from within
IWatchPlugin::Execute.
Warning
Under no circumstances should any other objects of this library be created directly.
Always use the published APIs to create new objects.
Warning
The Metadata objects point to an underlying persistent data store. This means that if there
are live references to Metadata objects and the underlying data is destroyed (e.g. a new
file is loaded), the objects would point to invalid data. The effect of calling any object
method in these circumstances is undefined and may result in memory corruption, crash
or loss of data.
Methods
Name Description
Page 197