Added common issue section to Vendr migration guide

Author: mattbrailsford

10/umbraco-commerce/upgrading/migrate-from-vendr-to-umbraco-commerce/README.md

@@ -302,4 +302,25 @@ Any custom payment providers used with Vendr also need to be migrated to Umbraco
 [migrate-custom-payment-providers.md](migrate-custom-payment-providers.md)
 {% endcontent-ref %}
 
+## Common Issues
+
+### DB Migration Issue Due to Column Constraints
+
+Some users have reported issues running the Umbraco Commerce migrations resuling in an error along the lines of:
+
+````
+SqlException: The object 'remainingAmount_default' is dependent on column 'remainingAmount'.
+ALTER TABLE ALTER COLUMN remainingAmount failed because one or more objects access this column.
+Umbraco.Commerce.Persistence.Migrations.DbUpUmbracoCommerceMigrationsRunner.MigrateUp()
+````
+
+The issue generally revolves around the default constraints not having the expected name. To resolve this you should identify the table and the problematic constraint and manually drop the constraint:
+
+```sql
+ALTER TABLE [dbo].[umbracoCommerceGiftCard]
+DROP CONSTRAINT remainingAmount_default;
+```
+
+This will remove the constraint allowing the migrations to run which should re-add the constraints with the correct name.
+
 [^1]: Vendr previously used the `.js` file extension to serve JSON files without having to configure a new `.json` mime-type on the server. This is no longer necessary in Umbraco Commerce so we can now use the correct `.json` file extension.

13/umbraco-commerce/upgrading/migrate-from-vendr-to-umbraco-commerce/README.md

@@ -302,4 +302,25 @@ Any custom payment providers used with Vendr also need to be migrated to Umbraco
 [migrate-custom-payment-providers.md](migrate-custom-payment-providers.md)
 {% endcontent-ref %}
 
+## Common Issues
+
+### DB Migration Issue Due to Column Constraints
+
+Some users have reported issues running the Umbraco Commerce migrations resuling in an error along the lines of:
+
+````
+SqlException: The object 'remainingAmount_default' is dependent on column 'remainingAmount'.
+ALTER TABLE ALTER COLUMN remainingAmount failed because one or more objects access this column.
+Umbraco.Commerce.Persistence.Migrations.DbUpUmbracoCommerceMigrationsRunner.MigrateUp()
+````
+
+The issue generally revolves around the default constraints not having the expected name. To resolve this you should identify the table and the problematic constraint and manually drop the constraint:
+
+```sql
+ALTER TABLE [dbo].[umbracoCommerceGiftCard]
+DROP CONSTRAINT remainingAmount_default;
+```
+
+This will remove the constraint allowing the migrations to run which should re-add the constraints with the correct name.
+
 [^1]: Vendr previously used the `.js` file extension to serve JSON files without having to configure a new `.json` mime-type on the server. This is no longer necessary in Umbraco Commerce so we can now use the correct `.json` file extension.

14/umbraco-commerce/upgrading/migrate-from-vendr-to-umbraco-commerce/README.md

@@ -302,4 +302,25 @@ Any custom payment providers used with Vendr also need to be migrated to Umbraco
 [migrate-custom-payment-providers.md](migrate-custom-payment-providers.md)
 {% endcontent-ref %}
 
+## Common Issues
+
+### DB Migration Issue Due to Column Constraints
+
+Some users have reported issues running the Umbraco Commerce migrations resuling in an error along the lines of:
+
+````
+SqlException: The object 'remainingAmount_default' is dependent on column 'remainingAmount'.
+ALTER TABLE ALTER COLUMN remainingAmount failed because one or more objects access this column.
+Umbraco.Commerce.Persistence.Migrations.DbUpUmbracoCommerceMigrationsRunner.MigrateUp()
+````
+
+The issue generally revolves around the default constraints not having the expected name. To resolve this you should identify the table and the problematic constraint and manually drop the constraint:
+
+```sql
+ALTER TABLE [dbo].[umbracoCommerceGiftCard]
+DROP CONSTRAINT remainingAmount_default;
+```
+
+This will remove the constraint allowing the migrations to run which should re-add the constraints with the correct name.
+
 [^1]: Vendr previously used the `.js` file extension to serve JSON files without having to configure a new `.json` mime-type on the server. This is no longer necessary in Umbraco Commerce so we can now use the correct `.json` file extension.

15/umbraco-commerce/upgrading/migrate-from-vendr-to-umbraco-commerce/README.md

@@ -302,4 +302,25 @@ Any custom payment providers used with Vendr also need to be migrated to Umbraco
 [migrate-custom-payment-providers.md](migrate-custom-payment-providers.md)
 {% endcontent-ref %}
 
+## Common Issues
+
+### DB Migration Issue Due to Column Constraints
+
+Some users have reported issues running the Umbraco Commerce migrations resuling in an error along the lines of:
+
+````
+SqlException: The object 'remainingAmount_default' is dependent on column 'remainingAmount'.
+ALTER TABLE ALTER COLUMN remainingAmount failed because one or more objects access this column.
+Umbraco.Commerce.Persistence.Migrations.DbUpUmbracoCommerceMigrationsRunner.MigrateUp()
+````
+
+The issue generally revolves around the default constraints not having the expected name. To resolve this you should identify the table and the problematic constraint and manually drop the constraint:
+
+```sql
+ALTER TABLE [dbo].[umbracoCommerceGiftCard]
+DROP CONSTRAINT remainingAmount_default;
+```
+
+This will remove the constraint allowing the migrations to run which should re-add the constraints with the correct name.
+
 [^1]: Vendr previously used the `.js` file extension to serve JSON files without having to configure a new `.json` mime-type on the server. This is no longer necessary in Umbraco Commerce so we can now use the correct `.json` file extension.

16/umbraco-commerce/upgrading/migrate-from-vendr-to-umbraco-commerce/README.md

@@ -302,4 +302,25 @@ Any custom payment providers used with Vendr also need to be migrated to Umbraco
 [migrate-custom-payment-providers.md](migrate-custom-payment-providers.md)
 {% endcontent-ref %}
 
+## Common Issues
+
+### DB Migration Issue Due to Column Constraints
+
+Some users have reported issues running the Umbraco Commerce migrations resuling in an error along the lines of:
+
+````
+SqlException: The object 'remainingAmount_default' is dependent on column 'remainingAmount'.
+ALTER TABLE ALTER COLUMN remainingAmount failed because one or more objects access this column.
+Umbraco.Commerce.Persistence.Migrations.DbUpUmbracoCommerceMigrationsRunner.MigrateUp()
+````
+
+The issue generally revolves around the default constraints not having the expected name. To resolve this you should identify the table and the problematic constraint and manually drop the constraint:
+
+```sql
+ALTER TABLE [dbo].[umbracoCommerceGiftCard]
+DROP CONSTRAINT remainingAmount_default;
+```
+
+This will remove the constraint allowing the migrations to run which should re-add the constraints with the correct name.
+
 [^1]: Vendr previously used the `.js` file extension to serve JSON files without having to configure a new `.json` mime-type on the server. This is no longer necessary in Umbraco Commerce so we can now use the correct `.json` file extension.