Home
Table Tree
The Table Tree is an input specification for uploading tables to 1010data.
<users> (Top-level wrapper for users)
The users tree may have one attribute (type) and, depending on the value of that attribute, may contain multiple instances of the <user> element.

Table Tree
The Table Tree is an input specification for uploading tables to 1010data.
- <table> (Top-level wrapper for table tree)
  The table tree is required and may have one attribute (name) and must contain certain elements.
- <title> (Table title)
  The title of a table. The table title identifies the table in the Insights Platform.
- <sdesc> (Short description of a table)
  The short description of a table from the table metadata.
- <ldesc> (Long description of a table)
  The long description of a table from the table metadata.
- <link> (Link header)
  The link header of a table. The link header is used to indicate which columns have come from a foreign table after it has been linked to another table.
- <maxdown> (Download limit)
  The maximum amount of data that can be downloaded at one time.
- <cols> (Metadata for all columns)
  The metadata for all columns in a table.
- <th> (Meta information for one column)
  The metadata for a single column in a table.
- <links> (Top-level wrapper for links)
  <links> can contain an arbitrary number of <link> tags, which act a wrapper used by the addtab transaction.
- <users> (Top-level wrapper for users)
  The users tree may have one attribute (type) and, depending on the value of that attribute, may contain multiple instances of the <user> element.
- <user> (User entry)
  The username or group name. The name provided must be a user or group that already exists in 1010data.
- <segmentation> (Specify the segmentation of a table)
  Specifies which columns should define the segmentation of a table.
- <sort> (Specify the sorting of a table)
  Specifies which column or columns on which the table should be sorted.
- <advise> (Specify segmentation relationships)
  Specifies how different columns are related in a segby or sortseg operation.
- <totals> (Table contains tabulation results)
  Indicates whether table contains results from a tabulation.
- <data> (Table data)
  The data in a table.
- <tr> (Data for one row)
  The data for a single row in a table.
- <td> (One cell of data in a table)
  The value of a single cell (column/row) of the table.

`<users>` (Top-level wrapper for users)

The users tree may have one attribute (type) and, depending on the value of that attribute, may contain multiple instances of the <user> element.

Attributes

Attribute	Value
`type`	The type of access specification (optional) `type` may have one of the following values: `private` - No user, other than the table's owner, may access the table. `list` - Only the table's owner and users listed in the users tree may access the table. `inherit` - All users that have access to the table's parent directory may access the table. If omitted, the default is `private`.

A user with access to a table's parent directory, but not to the table itself, will not see the table in the directory's listing.

Note that a user's access to any table is subject to the user's "maximum row limit." The largest table (in terms of number of rows) that a user may access is dependent on the user's subscription level. If a user is granted access to a table via the users tree, but the table has more rows than the user's maximum row limit, the user will see the table's title in the directory listing but will be unable to access it.

Contents

If type="private" or type="inherit", <users> must be empty.

If type="list", <users> must contain one or more <user> elements, each identifying a single user or group.