Configure the Semantic Web Service

All the tagging operations performed by the Cxense Semantic plug-in are carried out via the semantic web service. The semantic web service is installed together with the plug-in. To configure the web service:

  1. Create a configuration file by copying Configuration.properties from the plug-in distribution to your webapp configuration layer. For example:

    $ cp /opt/escenic/engine/plugins/semantic-cxense/misc/siteconfig/webservice-extensions/com/escenic/semantic/Configuration.properties \
      /etc/escenic/engine/webapp/webservice-extensions/com/escenic/semantic/Configuration.properties
  2. Open your configuration file for editing.

  3. Set the following properties:

    endPoint

    The URL of the Cxense tagging service. For example:

    endPoint=https://api.cxense.com/processing/linguistics/execute?persisted=tagging-id

    where tagging-id is the ID of a Cxense persisted API URL. In order to create such a URL you need to have set up a Cxense account. Once you have a Cxense account you can use the Cxense API to create the persisted API URLs you need, and get their IDs. For a description of how to do this, see Creating Cxense Persisted API URLs.

    category.name

    You need to add one setting like this for each Cxense tag category that you want to use in your publications, where name is the name of the Cxense category you want to use. The value you assign to the setting must be the scheme of the Content Engine tag structure you want to be mapped to the specified Cxense category. For example:

    category.organization=tag:organization@example.com,2011

    Note that you can, if you wish, map one CXense tag category to multiple Content Engine tag structures. You must then separate the scheme names with a ; character. For example:

    category.organization=tag:organization@example.com,2011;tag:company@example.com,2012
    minRelevance

    A minimum relevance below which tag suggestions will be rejected. Only tags which are assigned at least this relevance by Cxense will be accepted as suggestions by the Cxense Semantic plug-in. The specified value must be a number between 0 (no relevance) and 1 (maximum relevance). For example:

    minRelevance=0.5

The Content Engine tag structures you map on to Cxense categories must exist (that is, they must be defined in the Content Engine). Tag structures are defined using the escenic-admin web application. For details, see Create a Tag Structure.