Tables¶
The tables
service allows creating, accessing and maintaining tables that can be used by applications for cross-referencing or enrichment purposes, or to store settings for example.
To see the Tables menu entry on the Portal, the tables=view
permission is required.
Note
If you have the tables=*
and tables=allow(*)
permissions, you can have access to all the functions mentioned below.
List and view tables¶
To list and have access to the tables, you need to have the tables=allow(*)
permission.
It is possible to restrict access to specific tables by entering the names of these tables as parameters in the allow permission:
tables=allow('Table1'(*), 'Table2'(*))
It is also possible to restrict access to specific records:
tables=allow('Table1'('column1'='value1'))
Manage table records¶
You can browse the records of a table by double-clicking on the line associated with it.
Search records¶
You can search records using the ‘Search…’ input at the top right corner.
Edit records¶
After you’ve opened a table, you can add and edit records if you have the tables=edit-data
permission.
Simply use your tab key to switch between input fields. Use the ‘enter’ key to submit your changes, or the ‘Save’ button on the top button bar.
Delete records¶
You can delete records if you have the tables=delete-data
permission.
Import / Export records¶
You can export table records to an Excel spreadsheet.
You can create records by importing a file with the ‘Import’ button. Supported import files formats are CSV or Excel.
After uploading the file, a dialog window opens, with a few options to set:
Create, edit and delete tables¶
Create a table¶
To create tables, the tables=edit-table
permission is required.
The table’s structure consists of a name, a description and fields (ie: columns).
A key is a field that will be indexed and should be used for selection criteria.
Edit a table’s structure¶
To edit tables, the tables=edit-table
permission is required.
Warning
The table’s name and the English description are mandatory and cannot be empty. You must also provide at least one key field.
Delete a table¶
This operation requires the tables=delete-table
permission.
To delete a table, you can directly do it from the list with the delete icon. You can also delete multiple tables at a time by selecting them and hitting the Delete button in the top button bar.
Warning
The records are not deleted with the table.
Import/Export a table’s structure¶
The import and export buttons allow you to save any table structure and re-import the table in the UI. The export will create a .b2b file which you can use in a future import.
Interact with tables via scripts¶
You can manage tables with the Scripts service using the table DSL.