IRepository interface
Library: TFORMer9Lib
Opens or creates a Repository, opens a stand-alone FormLayout.
Usage and notes
Overview
A Repository is represented by a master file (extension *.tfr) and a subfolder structure on the file system. It references an arbitrary number of user-defined Project objects. These user-defined Projects are used to divide a Repository into logical areas. Each Project is a container which holds DataField definitions, DataSource definitions and references an arbitrary number of FormLayout objects.
The so-called GlobalProject is allocated by default and is used to define DataFields and DataSources which are available for all FormLayouts regardless of their actual Project membership.
Note
In contrast to a stand-alone FormLayout, the GlobalProject of a Repository can not store references to a FormLayout.
Examples
To open a stand-alone FormLayout do the following:
' Create TFORMer SDK instance '
Set tformer = CreateObject("TFORMer9Lib.TFORMer")
' Create a new Repository instance using a stand-alone FormLayout (extension *.tff) '
' Examples are usually installed in '
' - Windows Vista or later: C:/Program Data/TEC-IT/TFORMer/9/Examples '
' - Older Microsoft Windows versions: C:/Documents and Settings/All Users/Application Data/TEC-IT/TFORMer/9/Examples '
Set repository = tformer.LoadRepository("C:/Documents and Settings/All Users/Application Data/TEC-IT/TFORMer/9/Examples/Command Line/ODBCReportPDF/ODBCReportPDF.tff", True)
To open a Repository do the following:
' Create TFORMer SDK instance '
Set tformer = CreateObject("TFORMer9Lib.TFORMer")
' Create a new Repository instance using a Repository (extension *.tfr) '
' Examples are usually installed in '
' - Windows Vista: C:/Program Data/TEC-IT/TFORMer/9/Examples '
' - Older Microsoft Windows versions: C:/Documents and Settings/All Users/Application Data/TEC-IT/TFORMer/9/Examples '
Set repository = tformer.LoadRepository("C:/Documents and Settings/All Users/Application Data/TEC-IT/TFORMer/9/Examples/Demo Repository/Demos.tfr", True)
Note
This class writes only changes to Repository-files (extension *.tfr) to disk. A stand-alone FormLayout cannot be created, saved or permanently modified on disk via this class.
Note
Thread-safety: A single instance of this class must not be used by different threads.
Inheritance and related types
Base types: IDispatch
Properties
| Member | Description |
|---|---|
| AutoSave | Gets/Sets a flag indicating whether to save changes to the Repository automatically. |
| BuildNumber | Gets the build number of the Repository. |
| Comment | Gets/Sets the comment for the Repository. |
| DefaultJobTrayControl | Gets the default JobTrayControl in the Repository. |
| Description | Gets/Sets the description of the Repository. |
| FirstJobTrayControl | Gets the first JobTrayControl in the Repository. |
| FirstProject | Gets the first Project stored in the Repository. |
| FullPath | Gets the full pathname of the Repository. |
| GlobalProject | Gets the global Project of the Repository. |
| IsModified | Gets/Sets a flag indicating whether this Repository has been modified. |
| IsReadOnly | Gets a flag indicating whether this Repository is read-only. |
| NumberOfJobTrayControls | Gets the number of JobTrayControl-objects stored in the Repository. |
| NumberOfProjects | Gets the number of Project-objects stored in the Repository. |
| VersionMajor | Gets the major version number of the Repository. |
| VersionMinor | Gets the minor version number of the Repository. |
Methods
| Member | Description |
|---|---|
| AddJobTrayControl(String) | Creates and adds a new JobTrayControl to the Repository. |
| AddProject(String) | Creates and adds the Project in the Repository. |
| Close(Boolean) | Close this Repository. |
| GetJobTrayControl(String) | Gets a JobTrayControl defined in the Repository. |
| GetProject(String) | Gets the Project defined in the Repository. |
| RemoveJobTrayControl(IJobTrayControl) | Removes the JobTrayControl from the Repository. |
| RemoveProject(IProject) | Removes the Project from the Repository. |
| Save() | Saves this Repository. |
| SaveAs(String) | Saves a copy of this Repository. |