A Document Management System (DMS) is Sparta TWD managed package application which is used to manage all corporate document with activities such as create, edit, upload, and manage the corporate documents. The application comes with pre-defined workflow process like review and approval process which could be used to make document effective before the document is made available to all the business users.
The TrackWise Digital Platform application must be installed for DMS to work, and TWD platform application must be installed prior to installing DMS application.
With Salesforce has three major releases per year, Sparta also releases 3 releases in a year with major enhancements and features. With such releases more and more features are made available to their customers without impacting business.
With DMS packaging being upgraded thrice a year there could be possibility the administrator could face one of the known errors during DMS package upgrade in salesforce orgs which is: The post install script failed ‘.
The error is caused by prerequisites checks the installer does before installing or upgrading DMS to next available version. There could be other error during DMS upgrade, but this error is commonly experienced one.
A quick note on custom settings and how DMS app configuration make use of custom settings to manage its application level data .
Custom settings has two types : List and Hierarchy .
A List type defines application-level data, such as country codes, that is stored in the application cache. A Hierarchy type defines personalization settings, such as default field values, that can be overridden at the organization, profile, or user level.
For managing DMS custom settings we create Hierarchy type settings as we need to override few parameters at organization level .
With DMS initial package installation an entry is created for DMS custom settings with name : DMS App Setting . Below is screenshot of DMS App Settings .
Click manage against the DMS APP settings and DMS entry will open as follows :
Here I have circled a field called ‘ Sync Version ‘ in red which is the organization parameter which is overridden in custom configurations settings.
Sync Version :
- The field is read /write field but should not be manually edited
- The field is auto populated when DMS data sync process is completed
The post install script failed ‘. Salesforce error
During DMS upgrade your DMS package upgrade will fail with error: The post install script failed ‘ . The root cause of this error may be several reasons. From product perspective the known reason is with the sync version field value in DMS custom app settings page . If the Sync Version field in DMS App Settings is less than 6 or empty then the DMS upgrade will fail with the said error . To overcome the ‘ The post install script failed ‘ error you need to rerun the DMS data sync operation from the DMS setup TAB .
One success completion of the DMS data sync process your salesforce admin your triggered the DMS data sync operation will receive a successful email with DMS completion operation. On successful completion of the DMS data sync operation the Sync Version field in DMS App Settings will be updated to latest value of DMS package say 9.0.0 .
The following is an email sample , the system admin who triggered the data sync job will receive the following email , post successful completion of data sync process job .
Once the Sync Version field in DMS App Settings is updated ( > 9.0.0 ) then re run the DMS package upgrade to complete DMS upgrade in salesforce org .
The DMS upgrade should complete smoothly .





Comments
Post a Comment