OpenUtilities Wiki Project Database Version - Promis.e

Project Database Version - Promis.e

	Product(s):	Promis.e
	Version(s):	through 08.11.13.96
	Environment:	N/A
	Area:	Database Platform Support
	Subarea:	N/A

Background

Each version of Promis.e has its own corresponding project database schema, identified by a version number. The version number of the database is stored as an extended property of the Project table in SQL Server databases and as a comment on the Project table for Oracle databases.

When connecting to the project database, if the "Version" property/comment of the database does not match what Promis.e expects or cannot be retrieved for some reason, a Database version does not match the application message will appear. Generally, this means that either the Promis.e application or the database schema needs to be updated, whichever is older.

Database version numbers can also be revealed in a prompt when restoring a project from a different version of Promis.e. In this case, when the current project database version is newer than the database version for the backup listed in the message, the message is purely informational and no action is necessary. If the database version of the backup is newer than the application, the backup cannot be restored and the message typically indicates this (Unable to restore project because the project's database version is newer than your current database version).

The purpose of this document is to help determine the proper course of action, if any is necessary.

Version Chart

This chart applies to SELECT releases of Promis.e.

Application	Application Version	Database Version
Promis.e V8i SS8 REFRESH	08.11.13.96	8.1.42
Promis.e V8i SS8	08.11.13.57	8.1.33
promis.e V8i SS7 REFRESH Q1 2015	08.11.12.137	8.1.14
promis.e V8i SS7 REFRESH Q3 2014	08.11.12.120	8.1.12
promis.e V8i SS7 REFRESH Q2 2014	08.11.12.101	8.1.10
promis.e V8i SS7 REFRESH	08.11.12.88	8.1.10
promis.e V8i SS7	08.11.12.18	8.1.06
promis.e V8i SS6 REFRESH	08.11.11.85	8.0.75
promis.e V8i SS6	08.11.11.18	8.0.72
promis.e V8i SS5 REFRESH	08.11.10.66 - .68	8.0.71
promis.e V8i SS5	08.11.10.60 - .62	8.0.69
promis.e V8i SS3 REFRESH	08.11.08.22	8.0.55
promis.e V8i SS3	08.11.08.14	8.0.55
promis.e V8i SS2	08.11.07.1xx	8.0.49
promis.e V8i SR1	08.11.07.82	8.0.15
promis.e V8i (base)	08.11.05.9x	8.0.06
promis.e 2007	3.0.3	3.0.36
promis.e 2007	3.0.2	3.0.28
promis.e 2007	3.0.1	3.0.18
promis.e 2007	3.0.0	3.0.16
promis.e 2007	2.0.3	2.0.07

Determining the application version

The installed version of Promis.e ("Application Version" in the chart) can be found on the About promis-e dialog.

Determining the database version (SQL Server)

The current database version can be determined by connecting to the SQL Server using SQL Server Management Studio (SSMS) and checking the extended properties of the Project table in the database used by Promis.e. In SSMS, expand Object Explorer > Databases > promise > Tables, right click dbo.Project, and select Properties > Extended Properties.

Alternatively, executing the following query will also return the database version.

use promise
SELECT * FROM fn_listextendedproperty ('Version', 'user', 'dbo', 'table', 'project', default, default)

Replace "promise" in the above query with the name of the database if different.

Additional Notes

"SS" in the above chart stands for SELECTseries.
The version of the database that will be created by a script file can typically be found as a comment near the beginning of the script. For example: --$DBVersion:8.1.42$--
Similarly, an update script will list the version to which the script will update the database.
The SQL Server and database used by Promis.e can be determined by looking in the Project Database area of the Promis.e Setup dialog.