Explore module¤

Configuration property: modules.explore | Scope: app-wide and per workspace

The Explore module of DataManager is used for graph data exploration.

js.config.modules.explore
- enable
- startWith
- overallSearchQuery
- mapServer
  - url
  - ext
- graphlist
  - defaultGraph
  - hideSearch
  - whiteList
- navigation
  - defaultClass
  - topQuery
  - subQuery
  - searchQuery
  - listQuery
  - itemsPerPage
- details
  - properties
    - enable
  - usage
    - enable
  - references
    - enable
  - turtle
    - enable
  - history
  - enable
  - statistics
    - enable
    - sunburst
      - enable
    - visualization
  - enable
  - webvowlConfig
    - filter
      - literals
      - relations
      - solitarySubclasses
      - classDisjointness
      - setOperators
      - degreeOfCollapsing
    - mode
      - dynamicLabelWidth
      - pickAndPin
      - nodeScaling
      - compactNotation
      - colorExternals
    - export
      - json
      - svg
    - gravity
      - classDistance
      - dataTypeDistance
    - reset
    - pause
    - search
    - externalTools
  - toolX
    - enable
    - tabname
    - iframeUrlTemplate

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.enable	true	no	none	boolean

Use this property to enable the Explore module of DataManager.

Info

If this property is set to false , all other settings of modules.explore are skipped.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.startWith	false	no	none	boolean

Use this property to load the Explore module as default one after login.

Info

If more than one module has defined startWith: true the top most module in the navigation bar will be set as default.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.overallSearchQuery	see below	no	none	string (query

Use this property to define a custom query for the search field provided in the Module bar.

# default query
js.config.modules.explore.overallSearchQuery: |
  SELECT DISTINCT ?resource ?_resource
  {{FROM}}
  WHERE {
    ?resource ?p0 ?label.
    FILTER (!isBLANK(?resource)).
    BIND (?resource as ?_resource) .
    FILTER (contains (lcase(str(?label)), lcase("{{QUERY}}"))).
    }

Info

The placeholder {{QUERY}} is replaced with the search string entered by the user. A placeholder {{FROM}} can be used to insert the currently selected graph URI.

Property	Default	Required	Conflicts with	Valid values
`js.config.modules.explore.mapServer.url`	none	no	none	string (URI)

Extension of the tiles as provided by OpenMapTiles Map Server

Info

It works together with js.config.modules.explore.mapServer.ext, and only if it is set.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.mapServer.ext	none	no	none	string (URI)

The service url as provided by OpenMapTiles Map Server. If not defined, the wikimedia server is used.

Info

It works together with js.config.modules.explore.mapServer.url, and only if it is set.

This is how mapServer.ext and mapServer.url are used in your configuration:

js.config.modules.explore:
  mapServer:
    url: 'https://osm.your-host.com/styles/osm-bright'
    ext: 'png'

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.graphlist.defaultGraph	none	no	none	string (file extension)

Use this property to define a graph URI the user is allowed to work on.

Info

If the property is set the Graph box is hidden.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.graphlist.hideSearch	true	no	none	boolean

Set this property to true to hide the Search field in the Graph box

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.graphlist.whiteList	none	no	none	list of strings (query)

Use this property to specify a list of graphs the user can see.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.navigation.defaultClass	none	no	none	string (URI)

Use this property to setup a default class.

Info

It works together with defaultGraph, and only if it is set.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.navigation.topQuery	see below	no	none	string (query)

Use this property to specify a custom query that defines which top level classes of a graph are displayed.

# default query
js.config.modules.explore.navigation.topQuery: |
  PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
  PREFIX owl: <http://www.w3.org/2002/07/owl#>
  SELECT  ?resource ?hasChildren
  {{FROM}}
  WHERE {
    {
        ?resource rdfs:subClassOf owl:Thing .
    } UNION {
        ?r a ?resource .
        FILTER NOT EXISTS { ?resource rdfs:subClassOf ?super } .
    } UNION {
        ?resource a owl:Class
        FILTER NOT EXISTS { ?resource rdfs:subClassOf ?super } .
    }
    OPTIONAL{
        ?child rdfs:subClassOf ?resource .
        FILTER(isIRI(?child)) .
    }
    FILTER(isIRI(?resource)) .
    BIND(IF(BOUND(?child), "hasChildren", "noChildren") AS ?hasChildren)
    FILTER (!regex(
        STR(?resource),
        "^http://(www.w3.org/(2002/07/owl|2000/01/rdf-schema|1999/02/22-rdf-syntax-ns))#",
        "i"
    ))
  }

Info

A placeholder {{FROM}} can be used to insert the currently selected graph URI. The {{FROM}}placeholder will be resolved to FROM <graphUri>.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.navigation.subQuery	see below	no	none	string (query)

Use this property to specify a custom query that defines which subclasses of top level classes of a graph are displayed.

# default query
js.config.modules.explore.navigation.subQuery: |
  PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
  PREFIX owl: <http://www.w3.org/2002/07/owl#>
  SELECT ?resource ?hasChildren
  {{FROM}}
  WHERE {
    ?resource rdfs:subClassOf {{RESOURCE}} .
    OPTIONAL{
        ?child rdfs:subClassOf ?resource .
        FILTER(isIRI(?child)) .
    }
    FILTER(isIRI(?resource)) .
    BIND(IF(BOUND(?child), "hasChildren", "noChildren") AS ?hasChildren)
  }

Info

The placeholder {{RESOURCE}} is replaced with the selected parent class. A placeholder {{FROM}} can be used to insert the currently selected graph URI. The {{FROM}} placeholder will be resolved to FROM <graphUri>.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.navigation.searchQuery	see below	no	none	string (query)

Use this property to specify a custom query that defines which classes of a graph are displayed when the user uses the Search field in the Navigation box.

# default query
js.config.modules.explore.navigation.searchQuery: |
  PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
  PREFIX owl: <http://www.w3.org/2002/07/owl#>
  PREFIX skos: <http://www.w3.org/2004/02/skos/core#>
  SELECT  ?resource ?hasChildren
  {{FROM}}
  WHERE {
    {
        ?resource rdfs:subClassOf+ owl:Thing
    } UNION {
        ?r a ?resource .
    } UNION {
        ?resource a owl:Class
    }
    OPTIONAL{
        ?child rdfs:subClassOf ?resource .
        FILTER(isIRI(?child)) .
    }
    OPTIONAL {
        ?resource rdfs:label ?label1 .
    }
    OPTIONAL {
        ?resource skos:prefLabel ?label2 .
    }
    BIND(IF(BOUND(?child), "hasChildren", "noChildren") AS ?hasChildren)
    FILTER(isIRI(?resource)) .
    FILTER(
      regex(str(?resource),"{{QUERY}}","i") || regex(str(?label1),"{{QUERY}}","i") || regex(str(?label2),"{{QUERY}}","i")
    )
  }

Info

The placeholder {{QUERY}} is replaced with the search string. A placeholder {{GRAPH}} can be used for insert currently selected graph URI (will be resolved to <graphUri> ).

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.navigation.listQuery	see below	no	none	string (query)

Use this property to specify a custom query that defines which resources are displayed that are type of a selected class of a graph.

# default query
js.config.modules.explore.navigation.listQuery: |
  PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
  SELECT ?instance
  {{FROM}}
  WHERE {
    {
      ?instance a {{RESOURCE}} .
      FILTER isIRI(?instance) .
    } UNION {
      ?class rdfs:subClassOf+ {{RESOURCE}} .
      ?instance a ?class .
      FILTER isIRI(?instance).
    }
  }

Info

The placeholder {{RESOURCE}} is replaced by the selected resource URI. A placeholder {{GRAPH}}can be used for insert currently selected graph URI (will be resolved to <graphUri> ).

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.navigation.itemsPerPage	15	no	none	number

Use this property to specify the number of items shown per page of navigation.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.properties.enable	true	no	none	boolean

Use this property to enable the properties tab of DataManager

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.usage.enable	true	no	none	boolean

Use this property to enable the usage tab of DataManager.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.references.enable	true	no	none	boolean

Use this property to enable the references tab of DataManager.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.turtle.enable	true	no	none	boolean

Use this property to enable the turtle tab of DataManager.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.history.enable	true	no	none	boolean

Use this property to enable the History tab of DataManager.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.statistics.enable	true	no	none	boolean

Use this property to enable the statistic tab of DataManager.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.statistics.sunburst.enable	true	no	none	boolean

Sunburst is the visualization element in statistic tab.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.visualization.enable	true	no	none	boolean

Use this property to enable the visualization tab of DataManager.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.visualization.webvowlConfig.filter.literals	true	no	none	boolean

Use this property to enable the literals filter in the OWL viewer.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.visualization.webvowlConfig.filter.relations	true	no	none	boolean

Use this property to enable the relations filter in the OWL viewer.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.visualization.webvowlConfig.filter.solitarySubclasses	true	no	none	boolean

Use this property to enable the solitary subclasses filter in the OWL viewer.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.visualization.webvowlConfig.filter.classDisjointness	true	no	none	boolean

Use this property to enable the class disjointness filter in the OWL viewer.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.visualization.webvowlConfig.filter.setOperators	true	no	none	boolean

Use this property to enable the set operators filter in the OWL viewer.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.visualization.webvowlConfig.filter.degreeOfCollapsing	true	no	none	boolean

Use this property to enable the degree of collapsing function in the OWL viewer.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.visualization.webvowlConfig.mode.dynamicLabelWidth	true	no	none	boolean

Use this property to enable the dynamic label width mode in the OWL viewer.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.visualization.webvowlConfig.mode.pickAndPin	true	no	none	boolean

Use this property to enable the pick and pin mode in the OWL viewer.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.visualization.webvowlConfig.mode.nodeScaling	true	no	none	boolean

Use this property to enable the node scaling mode in the OWL viewer.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.visualization.webvowlConfig.mode.compactNotation	true	no	none	boolean

Use this property to enable the compact notation mode in the OWL viewer.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.visualization.webvowlConfig.mode.colorExternals	true	no	none	boolean

Use this property to enable the color externals mode in the OWL viewer.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.visualization.webvowlConfig.export.json	true	no	none	boolean

Use this property to enable the feature export as json in the OWL viewer.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.visualization.webvowlConfig.export.svg	true	no	none	boolean

Use this property to enable the feature export as svg in the OWL viewer.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.visualization.webvowlConfig.gravity.classDistance	true	no	none	boolean

Use this property to enable the class distance option in the OWL viewer.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.visualization.webvowlConfig.gravity.dataTypeDistance	true	no	none	boolean

Use this property to enable the dataType distance option in the OWL viewer.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.visualization.webvowlConfig.reset	true	no	none	boolean

Use this property to enable the reset function in the OWL viewer.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.visualization.webvowlConfig.pause	true	no	none	boolean

Use this property to enable the pause function in the OWL viewer.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.details.visualization.webvowlConfig.search	true	no	none	boolean

Use this property to enable the search function in the OWL viewer.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.externalTools.toolX.enable	false	no	none	boolean

The externTools section can be used to configure one or more external tools which will be integrated as additional tabs in a resource detail view. The tool is then presented in the content of an iFrame. In addition to that, a JSON representation of the presented resource is send via postmate to the running application inside of the iFrame.

Use this property to enable or disable one specific external tool configuration.

js.config.modules.explore.externalTools.toolX.enable: true

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.externalTools.toolX.tabname	none	yes	none	string

The externTools section can be used to configure one or more external tools which will be integrated as additional tabs in a resource detail view. The tool is then presented in the content of an iFrame. In addition to that, a JSON representation of the presented resource is send via postmate to the running application inside of the iFrame.

Use this property to name the tab for the external tool.

Property	Default	Required	Conflicts with	Valid values
js.config.modules.explore.externalTools.toolX.iframeUrlTemplate	none	yes	none	string (URL)

The externTools section can be used to configure one or more external tools which will be integrated as additional tabs in a resource detail view. The tool is then presented in the content of an iFrame. In addition to that, a JSON representation of the presented resource is send via postmate to the running application inside of the iFrame.

Use this property to specify the URL which will be loaded in the iFrame inside of the new application tab.

js.config.modules.explore.externalTools.toolX.iframeUrlTemplate:
    "http://example.org/app/{{RESOURCE}}"

Info

The placeholder {{RESOURCE}} is replaced by the selected resource URI. The placeholder {{RESOURCELABEL}} is replaced with the titleHelper generated label of the resource.

Configuration example¤

js.config.modules.explore:
  enable: true
  startWith: true
  overallSearchQuery: |
    SELECT DISTINCT ?resource ?_resource
    {{FROM}}
    WHERE {
      ?resource ?p0 ?label.
      FILTER (!isBLANK(?resource)).
      BIND (?resource as ?_resource) .
      FILTER (contains (lcase(str(?label)), lcase("{{QUERY}}"))).
    }
  graphlist:
    defaultGraph: ''
    hideSearch: true
  navigation:
    topQuery: |
      SELECT DISTINCT ?resource
      WHERE {
        ?r a ?resource .
        FILTER NOT EXISTS { ?resource rdfs:subClassOf ?super } .
      }
    subQuery: |
      SELECT DISTINCT ?resource
      WHERE {
        ?r a ?resource .
        ?resource rdfs:subClassOf {{RESOURCE}} .
      }
    searchQuery: |
      SELECT DISTINCT ?resource
      WHERE {
        ?r a ?resource .
        ?resource rdfs:label ?label .
        FILTER(contains(?label, "{{QUERY}}")) .
      }
    listQuery: |
      SELECT DISTINCT ?resource
      WHERE {
        {
          ?resource a {{RESOURCE}} .
        } UNION {
          ?class rdfs:subClassOf+ {{RESOURCE}} .
          ?resource a ?class .
        }
      }
  details:
    properties:
      enable: true
    usage:
      enable: true
    references:
      enable: true
    turtle:
      enable: true
    statistics:
      enable: true
      sunburst:
        enable: true
    visualization:
      enable: true
      webvowlConfig:
        filter:
          literals: true
          relations: true
          solitarySubclasses: true
          classDisjointness: true
          setOperators: true
          degreeOfCollapsing: true
        mode:
          dynamicLabelWidth: true
          pickAndPin: true
          nodeScaling: true
          compactNotation: true
          colorExternals: true
        export:
          json: true
          svg: true
        gravity:
          classDistance: true
          dataTypeDistance: true
        reset: true
        pause: true
        search: true

Explore module¤

Configuration example¤

Comments