|
1 | | -# lke-plugins |
2 | | -Plugins for Linkurious Enterprise |
| 1 | +# Data-table plugin for Linkurious Enterprise |
| 2 | + |
| 3 | +This Linkurious Enterprise plugin allow displaying the result of a |
| 4 | +query (or query template) as a table. |
| 5 | + |
| 6 | +## Configuration |
| 7 | + |
| 8 | +These are the configuration keys that need to be set in the plugin |
| 9 | +configuration, via the Linkurious Configuration. |
| 10 | + |
| 11 | +- `entityType` (**required**, `"edge"` or `"node"`): whether to display |
| 12 | + nodes or edges in the table (e.g. `"node"`). |
| 13 | +- `itemType` (**required**, string): name of the node-category or |
| 14 | + edge-type to display in the table (e.g. `"COMPANY"`). |
| 15 | +- `properties` (**optional**, array): property names to include in the |
| 16 | + table (e.g. `["name", "age", "date_of_birth"]`). Defaults to all |
| 17 | + properties of the configured `itemType`. |
| 18 | +- `basePath` (**optional**, string): URL path in which the plugin will |
| 19 | + be deployed (e.g. `"my-plugin"`). Defaults to plugin name. |
| 20 | + |
| 21 | +Full configuration example: |
| 22 | +```json |
| 23 | +{ |
| 24 | + "data-table": { |
| 25 | + "basePath": "table", |
| 26 | + "entityType": "node", |
| 27 | + "itemType": "Company", |
| 28 | + "properties": ["name", "address", "vat_number"] |
| 29 | + } |
| 30 | +} |
| 31 | +``` |
| 32 | + |
| 33 | +## Options |
| 34 | + |
| 35 | +These are the options that this plugin accepts as URL parameters: |
| 36 | + |
| 37 | +- `queryId` (**required**, integer): query to run (e.g. `queryId=26`). |
| 38 | +- `sourceKey` (**required**, string): Key of the data-source to run the |
| 39 | + query on (e.g. `sourceKey=b16e9ed5`). |
| 40 | +- `limit` (**optional**, integer): maximum number of results to display |
| 41 | + (e.g. `limit=1000`). |
| 42 | +- `param_number_PARAM NAME` (**optional**, number): *for query |
| 43 | + templates*, any numerical parameter of the template (e.g. |
| 44 | + `param_number_my%20number=123`). |
| 45 | +- `param_string_PARAM NAME` (**optional**, string): *for query |
| 46 | + templates*, any string parameter of the template (e.g. |
| 47 | + `param_string_my%20param=abc`). |
| 48 | +- `param_ids_PARAM NAME` (**optional**, comma-separated list): *for |
| 49 | + query templates*, any edgeset/nodeset parameter of the template (e.g. |
| 50 | + `param_ids_my%20id%20list=1,2,3`). |
| 51 | + |
| 52 | +Full URL example (line breaks for readability): |
| 53 | +``` |
| 54 | +https://linkurious.example.com/plugins/data-table |
| 55 | + ?queryId=26 |
| 56 | + &sourceKey=b16e9ed5 |
| 57 | + &limit=1000 |
| 58 | + ¶m_string_city=Paris |
| 59 | +``` |
0 commit comments