2019.2

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201 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168) when using the "Run Script" on
page503 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
Job() Returns the "MetaJob" on page201 node, which sits
Page 199