ATM [autonomous topic maps] :Operator Definition

http://www.semports.org/mwp/getTableView

 

Lutz Maicher (maicher@informatik.uni-leipzig.de)

Last update: 2006-11-08

 

PSI: http://www.semports.org/mwp/getTableView

Description

This operator presents the user a projection of a given table and a string, which can be interpreted as a question. The user has to select some rows from the table. This selection is a view of the given Table and will be interpreted as the answer to the presented question. There are no constraints how the projection of the table is presented to the user and how the user can select rows.

Example: The presented table is a projection (columns “TEXT” and “SI”) of the table defined here.

TEXT

SI

Pablo Picasso

http://www.artists.org/PabloPicasso

Picassos Home

http://www.spain.org/phome

In the transition "ID2" the user selects the second row. In this case the operator stores in the forwarded token the following characteristics:

[ID2.http://psi.semports.org/pndm/table, “TABLE”]
[ID2.TABLE.TEXT.0, "Picassos Home"].
[ID2.TABLE.SI.0, "http://www.spain.org/phome"].

Input

Namespace pndm defined by http://psi.semports.org/pndm/

pndm:operand1
[mandatory]

The name of a table which should be presented.

pndm:operand2
[optionally]

A comma separated list of column names. This list is a projection of the specified table.

If no projection is defined, all rows of the table will be presented to the user.

pndm:operand3
[optionally]

The label which have to be presented to the user.

This label will be interpreted as a question which is the basis of the users selection.

Output

key rule

One item identifier of the current transition item +"http://psi.semports.org/pndm/table"

example

id24.http://psi.semports.org/pndm/table

value

TABLE

for each element of the view (column name, row index)

Note: The row index always starts with 0. If the user selected three rows, the index will iterate from 0 to 2.

key rule

One item identifier of the current transition item +".TABLE"+ "."+column name +"." + row index

example

id24.TABLE.$PERSON.1

value

The value representing the element from the selection at the given position.

If the result set is empty, the value is the string “null”.