Use the Repository page of project properties in Visual Studio to set options that determine how a Synergy/DE Repository project is built.
To access this page, select a Repository project node in Solution Explorer, select Project > Properties from the Visual Studio menu, and then select the Repository tab.
Repository projects can be referenced by or added as dependencies to traditional Synergy projects and Synergy .NET projects. By referencing or adding a dependency to a repository project, the repository files become part of the build system. If repository files change, projects that reference the repository are rebuilt. This eliminates the need to set RPSMFIL and RPSTFIL (or RPSDAT) in your environment.
See Using Synergy repositories in Visual Studio for more information.
Configuration
Specifies the configuration that settings on this page apply to. This can be Active (default), Debug, Release, All Configurations, or a configuration created for the project.
Platform
Specifies the platform that settings on this page apply to. The default is Active.
|
The following settings apply to the configuration/platform combination specified in the Configuration and Platform fields (described above). Settings on this page are used for a build only if the configuration/platform combination for those settings is active for the build. For more information on Configuration and Platform settings, see Configurations, platforms, and profiles and Microsoft documentation on creating and editing configurations (e.g., Create and edit configurations). |
Repository Mode
Build repository ISAM files from source
Select this to generate repository ISAM files for the project from schema files. Note that the Build Action for each schema file must be set to “Compile”.
Reference existing ISAM files
Select this to use existing repository files for the project. If this option is selected, the Output file option and schema files in the project will be ignored.
Schema Options
Target ISAM Revision 4
Select this to generate ISAM Revision 4 files for the repository. This is required for projects that target a Synergy runtime lower than 10.1.1.
Automatically generate schemas on exiting Repository UI
Select this to automatically generate schema files when you exit the Repository program.
|
Generate single schema file |
Select this and specify a filename to have one schema file generated for the repository. The default location is the project directory, but you can specify a different path, which will be relative to the project directory unless it’s fully qualified. |
|
Generate separate schema files. Output to path: |
Select this to have individual schema files for different repository elements generated to the directory specified in this field. You can specify a path relative to the project directory (e.g., you can enter .\ to specify the project directory), or you can specify a fully qualified path. See Build repository ISAM files from source above for naming information. |
Generated schema files have the following naming scheme:
type-name.sdl
where type is one of the following:
| Item type | type |
|---|---|
| Template | tmp |
| Enumeration | enm |
| File | fil |
| Structure | str |
| Format | fmt |
For example, for a structure named “customer”, the generated schema file would have the name str-customer.sdl.
|
If you use this feature, do not delete or change the following environment variables, which are used by the Repository program for automatic schema file generation:
|
Output File Settings
RPS Main File:
Specifies the name of the repository main file for the project. The default extensions are .ism and .is1. If “Reference existing ISAM files” is
- selected, this specifies the path and name of the repository main file to be used for this project. Paths can be absolute or relative to the project directory. You can also use MSBuild variables — e.g., $(SolutionDir).
- not selected, this specifies the name for the repository main file to be generated for the project (and Output path specifies the location for the generated file).
RPS Text File
Specifies the name of the repository text file for the project. The default extensions are .ism and .is1. If “Reference existing ISAM files” is
- selected, this specifies the path and name of the repository text file to be used for this project. Paths can be absolute or relative to the project directory. You can also use MSBuild variables — e.g., $(SolutionDir).
- not selected, this specifies the name for the repository text file that will be generated for the project (and Output path specifies the location for the generated file).
Output path
Specifies the location (relative to the project directory) for repository files generated for this project. The default location is the directory for the current configuration (e.g., bin\Debug\AnyCPU). This field is ignored if “Reference existing ISAM files” is selected.
