VideosLists & Table Sorting Support


Duration: 05:42
This video presentation walks you through the content sorting support for tables and lists offered by Oxygen.


00:00:07This video presentation walks you through the content sorting support for tables and
00:00:11lists offered by oXygen xml.
00:00:14For this demonstration we already prepared a DITA topic that contains both tables and
00:00:20Note that the sorting support is available for the DocBook, XHTML and TEI frameworks
00:00:26as well.
00:00:27Let's begin with a table that holds a transaction log.
00:00:30The table contains 4 columns: ID, Date, Value and Currency.
00:00:36The second column contains dates specified in different formats.
00:00:41Our goal is to sort the content of this table in chronological order.
00:00:46Place the caret in the Transaction Date column and invoke the sort action either from the
00:00:51table's contextual menu or from the application's toolbar.
00:00:55Note that the sorting operation will be performed over the entire table , since we selected
00:01:00no specific rows . Later on you'll see how you can sort a range
00:01:05of rows.
00:01:06In the next section you can choose how to sort the table based on at most 3 sorting
00:01:12Each sorting criterion is defined by a name,... which is actually the column's name, then
00:01:18the type of information that will be sorted ...and the sorting direction.
00:01:23Because we invoked the sorting operation when the caret was placed in the Transaction date
00:01:27column, the sorting criterion is automatically set to Transaction date.
00:01:33We set the information type to DATE since we want the table rows to be sorted chronologically.
00:01:39Oxygen's sorting mechanism recognizes multiple date short, medium, long , full
00:01:46, XS:date and XS:dateTime.
00:01:51We'll leave the sorting direction to ascending.
00:01:55Now the table is sorted by date.
00:01:57Moving on... to the Sales per region table...
00:02:01you will see the sorting support based on multiple criteria.
00:02:04We want to see who the top sales agents for each region are.
00:02:08We invoke the sort action.
00:02:12The first criterion is region, the information type is text and we'll leave the sort direction
00:02:19as ASCENDING.
00:02:21The second criterion is VOLUME, the information type is NUMERIC and the sorting direction
00:02:27is DESCENDING.
00:02:29Click OK to complete the sorting operation.
00:02:32As you can see now the table presents the sales agents of each region sorted by their
00:02:38total sales amount.
00:02:40Moving to the last table... If we try to sort it, we see that we are not allowed to do so.
00:02:48This is because the sorting operation is not allowed on tables with cells that span on
00:02:52multiple rows.
00:02:54Still, you can perform a sorting operation over a selection of rows.
00:02:59For example, let's select these 3 rows and click Sort.
00:03:04Now you can see that the ALL ROWS option is disabled.
00:03:08Since our table contains no headers, the elements of the sorting criteria have generic names.
00:03:14Since we would like to sort the first 3 months by the total sales value we select column
00:03:192, set the type to numeric and direction to descending,
00:03:25then click OK.
00:03:27Another common usage of the sorting support is editing using the track changes feature
00:03:32in a collaborative environment.
00:03:35As an example we enable the track changes support and we sort the table by the value
00:03:42Set the type to numeric and direction to descending.
00:03:47Now, the table holds first the newly sorted content and then the initial content rendered
00:03:54with a strike-through style.
00:03:57The sorting operation works also for lists both ordered and unordered.
00:04:03Place the caret inside the list and invoke the sort action.
00:04:09Note that the range is set to ALL ITEMS and only one sort criterion is available.
00:04:15We'll leave the type of sorting information to text and set the direction to ascending.
00:04:20Note that when sorting text, oxygen's sorting algorithm follows the natural sort order of
00:04:26the currently used language.
00:04:28Also you may choose to sort only a selection of list items.
00:04:32For example, select items 2, 3 and 4 and invoke the sort action.
00:04:38Now the range is set to "selected items" option.
00:04:42Again, configure the sorting criterion and click OK to complete the sorting operation.
00:04:48Summing up, these are the main topics showcased in this demonstration:
00:04:53The sorting support is available for DITA, DocBook, XHTML and TEI documents.
00:05:00oXygen offers API that allows you to extend the sorting support to other document types
00:05:06You can sort tables and lists both ordered and unordered,
00:05:10-oXygen sorting mechanism recognizes multiple date formats like short, medium, long, full,
00:05:18XS:date and XS:dateTime,
00:05:21-oXygen's text sorting algorithm follows the natural sort order of the currently used language,
00:05:28collected either from the system's language setting or specifically set in the XML:lang
00:05:36And this concludes our demonstration.
00:05:38Thanks for watching!

Use Oxygen Feedback to ask us anything about this video.