Product(s):	Promis.e CONNECT
	Version(s):	through 10.04.XX.XX
	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.

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 [[Error - Database version does not match the application|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 ([[Error - Unable to restore project, project's database version is newer|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

Application	Application Version	Database Version
Promis.e CONNECT Update 4	10.04.00.22	10.0.13
Promis.e CONNECT Update 3	10.03.00.35	10.0.11
Promis.e CONNECT Update 2	10.02.00.29	10.0.09
Promis.e CONNECT Update 1	10.01.00.07	10.0.04
Promis.e CONNECT	10.00.00.49	10.0.04

Determining the application version

The installed version of Promis.e ("Application Version" in the chart) can be found on the [[5842|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.

See Also

[[Updating and Upgrading promis.e]]

[[How to download the promis.e software]]

[[Creating and Updating the Project Database]]

[[Error - Unable to restore project, project's database version is newer]]

[[Error - Database version does not match the application]]

[[Project Database Version - Substation]]

Original Author:

Matt_P