Added section about migrating from DOM issue 16

This commit is contained in:
Ed Chipman 2012-11-22 19:42:25 -04:00
parent a6a73c2b24
commit 25c180929c
1 changed files with 8 additions and 0 deletions

View File

@ -31,5 +31,13 @@ $myGridConfig->addComponent(new GridFieldSortableRows('{Column to store sort}'))
To move an item to another page drag the row over the respective page button and release.
## Migrating from SilverStripe 2.4 and Data Object Manager's SortableDataObject
SortableGridField is not the same as SortableDataObject, since it is only a component of GridField it does not have the ability to catch the object when it is saved for the first time. So SortableGridField uses 1 as the first sort index because 0 is the default for an integer field/column in the database. For migrations from 2.4 with SortableDataObject you need to setup your DataObject based on the instructions above however you must name your sort column "SortOrder" to maintain your sort indexes defined by SortableDataObject. Then you need to run the following query on the table containing your sort field, for many_many relationships this will be something like {RelationshipClass}_{RelationshipName}. This query will maintain your sort order from SortableDataObject but increment the index by 1 giving it a starting number of 1.
```sql
UPDATE YourTable SET SortOrder=SortOrder+1;
```
## @TODO
* Optimize re-ordering of a has_many relationship when sorting on a single page