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:19lists.
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:12criteria.
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 formats...like: 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:41column.
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:05too.
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:35attribute.
00:05:36And this concludes our demonstration.
00:05:38Thanks for watching!