All versions of this manual
X
Welcome to Linkurious administration manual v3.1.15. Use the menu to access other documentations.
  1. Introduction
  2. FAQ
  3. Getting started
    1. Release notes
    2. Client requirements
    3. Graph DB Feature Map
  4. Deploying on premise
    1. Technical requirements
    2. Downloading
    3. Installing
    4. Starting Linkurious
    5. Stopping Linkurious
  5. Deploying on Azure
    1. Pre-requisites
    2. Step-by-step deployment
    3. Updating
    4. Backing up your data
  6. Configuring
  7. Troubleshooting
    1. Checking Linkurious status
    2. Reading the logs
    3. Getting support
    4. Managing licenses
    5. Vulnerabilities
  8. Importing graph data
    1. Neo4j
    2. Cosmos db
    3. Updating your graph data
  9. Updating Linkurious
    1. Checking for updates
    2. Backing up your data
    3. Update procedure
  10. Configuring data-sources
    1. Neo4j
    2. Cosmos DB
    3. Alternative IDs
    4. Merging data-sources
    5. Advanced settings
  11. Search index
    1. Search Option Comparison
    2. Neo4j
    3. Azure search
    4. Configuring Elasticsearch
    5. Using Elasticsearch on AWS
    6. Incremental Indexing
    7. Numerical/Date search
  12. User-data store
    1. Migrating to an external database
    2. Backing-up your store
  13. Web server
  14. Authentication
    1. Getting started
    2. LDAP / Active Directory
    3. SSO with Azure AD
    4. SSO with Google
    5. SSO with OpenID Connect
    6. SSO with SAML2 / ADFS
    7. Configuration
  15. Access control
    1. Managing users
    2. Managing groups
    3. Standard access-rights
    4. Property-key access-rights
  16. Guest mode
    1. Guest mode
  17. Data Schema
    1. Property types
    2. Hiding data
    3. Strict mode
  18. Alerts
    1. Configuration
  19. Email Notifications
    1. Configuration
  20. Visualizations appearance
    1. Default styles
    2. Default captions
    3. Default properties order
    4. Geographic tiles
  21. Audit trail
    1. Log format
  22. Plugins
  23. Deep link
 

Data Schema: Property types

The type of a property can be set by clicking on the "Set a type" button next to a property's name. A popup allows you to choose a type.

Once a property type has been set, the type is displayed next to the property name, and it is possible to change it using the "Edit" link.

IMPORTANT

Setting a property type in Linkurious Enterprise will not change the type of the corresponding values in the graph database. The consequences are explained below for each property type.

Property types

String

Settings

Setting a property type as String does not require any additional information:

Consequences

Once a property type has been set as a String, all values for that property are processed as a String.

In the Workspace Filter panel:

  • The type of the property cannot be changed (the String icon "Abc" next to the property name is disabled).
  • Values are displayed as a list and ordered alphabetically.

Number

Settings

Setting a property type as Number does not require any additional information:

Consequences

Once a property type has been set as a Number, values for that property fall into 2 categories:

  • Valid values if they are actual numbers.
  • Invalid values if they cannot be interpreted as number.

In the Workspace Property panel, invalid values are displayed as string with a warning.

In the Workspace Filter panel:

  • The type of the property cannot be changed (the Number icon "123" next to the property name is disabled).
  • Valid values are displayed in a histogram.
  • The number of invalid values is displayed at the bottom of the histogram.

When editing or creating a node/edge, properties set as Number can only accept a valid number.

Enum

Settings

Setting a property type as "Enum" requires to enter a list of authorized values:

  • Separate values with comma , or click on the "Add" button.
  • At least 2 values are required.

Consequences

Once a property type has been set as Enum, values for that property fall into 2 categories:

  • Valid values if the values are within the list of authorized values.
  • Invalid values otherwise.

In the Workspace Property panel, invalid values are displayed as string with a warning.

In the Workspace Filter panel:

  • The type of the property cannot be changed.
  • Authorized values are displayed as list.
  • Invalid values are grouped under a single "Invalid values" option at the top of the list.

When editing or creating a node/edge, the user pick the value of an Enum property from the list of the authorized values.

True/False

Settings

Setting a property type as True/false does not require any additional information:

Consequences

Once a property type has been set as a True/false, values for that property fall into 2 categories:

  • Valid values if the values are either "true" or "false".
  • Invalid values otherwise.

In the Workspace Property panel, invalid values are displayed as string with a warning.

In the Workspace Filter panel:

  • The type of the property cannot be changed.
  • Authorized values ("true" and "false") are displayed as list.
  • Invalid values are grouped under a single "Invalid values" option at the top of the list.

When editing or creating a node/edge, the user picks the value of a True/false property from a list containing "true" and "false".

Date

Settings

Setting a property type as Date requires to select the storage format of the date in the graph database:

  • Native: the value is stored as native date (available only with Neo4j since version 3.5)

  • yyyy-mm-dd, dd/mm/yyyy, mm/dd/yyyy: the values are stored as String in the graph database according to one of these formats.

  • Timestamp (in milliseconds), Timestamp (in seconds): the values are stored as Numbers in the graph database. They represent a date as the number of milliseconds (or seconds) elapsed since January 1st, 1970 GMT and the date to be encoded.

Consequences

Once a property type has been set as Date, values for that property fall into 2 categories:

  • Valid values: values that can be parsed as date according to the storage format provided.
  • Invalid values otherwise.

In the Workspace Property panel:

  • Invalid values are displayed as string with a warning.

Anywhere a date value is displayed (including the Property panel):

  • All properties are displayed in the ISO format yyyy-mm-dd regardless of their storage format.

In the Workspace Filter panel:

  • Dates can be filtered from the Timeline.

When editing or creating a node/edge, the user picks the value of a Date property from a Date picker.

Date-time

Settings

Setting a property type as Datetime requires to select the storage format of the date in the graph database:

  • Native: the value is stored as native date-time (available only with Neo4j since version 3.5)

  • YYYY-MM-DDThh:mm:ss: the values are stored as String in the graph database according to one of this format.

  • Timestamp (in milliseconds), Timestamp (in seconds): the values are stored as Numbers in the graph database. They represent a date as the number of milliseconds or seconds between January 1st 1970 and the date to be encoded.

In case the Date-time is stored as Native type in Neo4j, there are 2 possible options:

  • Using a Neo4j DateTime object: these object contain an explicit time zone which is used.
  • Using a Neo4j LocalDateTime object: these objects do not contain an explicit time zone, the default time zone configured in Linkurious Enterprise is assumed.

Consequences

Once a property type has been set as Datetime, values for that property fall into 2 categories:

  • Valid values: values that can be parsed as date according to the storage format provided.
  • Invalid values otherwise.

In the Workspace Property panel:

  • Invalid values are displayed as string with a warning.

Anywhere a date value is displayed (including the Property panel):

  • All properties are displayed in the ISO format YYYY-MM-DDThh:mm:ss regardless of their storage format.

In the Workspace Filter panel:

  • Date-times can be filtered from the Timeline.

When editing or creating a node/edge, the user picks the value of a Datetime property from a Date picker.

Currency

Settings

Setting a property type as Currency requires to select the currency symbol and the display format of values in Linkurious Enterprise:

  • [Symbol] #,###.##: Currency symbol is displayed first, comma is used as thousands separator and dot as decimal separator.

  • #.###,## [Symbol]: Currency symbol is displayed last, dot is used as thousands separator and comma as decimal separator.

  • # ###,## [Symbol]: Currency symbol is displayed last, space is used as thousands separator and comma as decimal separator.

Consequences

Once a property type has been set as Currency, values for that property fall into 2 categories:

  • Valid values if they are actual numbers.
  • Invalid values if they cannot be interpreted as number.

In the Workspace Property panel, invalid values are displayed as string with a warning.

In the Workspace, displayed currency values are formatted according to their property type configuration.

In the Workspace Filter panel:

  • The type of the property cannot be changed (the Number icon "123" next to the property name is disabled).
  • Valid values are displayed in a histogram.
  • The number of invalid values is displayed at the bottom of the histogram.

When editing or creating a node/edge, properties set as Currency can only accept a valid number.

Mandatory properties

Each property can be set as "Mandatory" by clicking the corresponding checkbox in the property type popup.

Consequences of making a property mandatory:

In the Workspace Property panel:

  • The property key is always displayed.
  • If the item at hand does not have this property, the property is displayed with a warning that the value is missing.

When editing or creating a node/edge, the value of a mandatory property cannot be empty.

Property type conflict

When nodes have multiple categories, it is possible that a property can be given 2 different types. For example:

  • Given a Supplier category declared with a property Size of type Number.
  • Given a Buyer category declared with a property Size of type Enum ("Big"/"Medium"/"Small").
  • Given a node that has both categories.
  • Then Linkurious Enterprise cannot determine the type of the Size property.

When such conflicts arise:

  • In the Workspace Property panel, the value of the property is displayed as string with a warning.
  • When editing or creating a node, the value of the property is displayed as string and cannot be edited.