Version: Watney (Release July 2016)#

d3web is an extensible Java API for running knowledge-based systems. The Semantic Wiki KnowWE builds on the engine d3web and offers the web-based and distributed development of knowledge bases.

This distribution comes with the following files:

Release Notes.pdf This document.
Licenses License information of the d3web and KnowWE systems and all external libraries.
d3web Folder containing the binaries (libraries), the sources, the JavaDoc and a quick start guide for d3web
KnowWE Folder containing an installation archive (zip) as binary, the sources, the JavaDoc and a quick start guide for KnowWE

System Requirements#

Installation of d3web requires the Java Platform, Standard Edition JRE 8 or newer. KnowWE requires JDK version 8 or newer. A JRE will not be sufficient. For operating systems, the distribution runs with Windows, Mac OS, and Linux. We officially support Firefox 24 ESR or newer and current Google Chrome. Please note, that we do not officially support Internet Explorer or Safari at the moment, although Internet Explorer 11+ and Safari should both work fine.

What's New#

The release includes the following notable new features and fixes:

d3web#

  • TimeDB test cases. Using the TimeDB plugin, it is now possible to test the behavior of the knowledge base when setting values in the past (relative to the current time of the session).
  • Major code improvements, cleanup and modernizations
    • Reimplementation and modernization of test case interfaces and xml persistence. Much improved functionality, allows extensions, and is backwards compatible.
    • Cleaned source code of old verbose Java pre-1.8. statements and modernized it with up to date 1.8 syntax and utils.
  • New checks for test cases:
    • Check any property of terminology objects used in the test
    • Check the amount of solutions with a given state.

KnowWE #

  • Major overhaul of KnowWE SemanticCore (now uses denkbares-SemanticCore)
    • Removed outdated Rdf2Go dependencies
    • Instead, direct integration of Sesame/RDF4J
    • New Jena plugin
    • New GraphDB-Free plugin
    • New SPARQL auto format/prettify (soon to come to other markups as well)
  • Improvements to DiaFlux Editor:
    • Adaptive toolbar
    • Editor and menu styling
  • Markup tool menus can no longer be hidden below lower end of the browser window
  • Attachment markup
    • Allows to keep attachments up to date with a remote source url and update interval.
    • Allows to download articles and parts of articles of other KnowWE installations as attachments. These attachments can also be compiled and rendered via Include markup.
  • AttributeTable now supports negated answers (!= Answer-X) and Unknown in condition columns.
  • Debugger for TimeDB Javascript functions

Fixed Issues#

This is a list of all issues that were tracked and resolved using the tracking system available at https://dev.denkbares.com/
Only a small percentage of issues is handled using this (or any other) tracker, so the list is not representative of the work done on d3web and KnowWE. For more infos about the current development, check https://github.com/denkbares

ID Status Priority Title Tags
T358 Resolved High Multiple (small) ontology markups crash KnowWE at startup Ontology Engineering, KnowWE
T202 Resolved High Turtle Markup: Only first statement is parsed Ontology Engineering, KnowWE
T495 Resolved Normal KnowWE's terminology manager is not aware of the complete OWL vocabulary Ontology Engineering, KnowWE
T493 Wontfix Normal AttachmentType: references to ZIP entries require article name KnowWE
T490 Resolved Normal use of prefix definitions in turtle markup leads to NPE KnowWE
T262 Resolved Normal In DiaFlux editor the tool menu layout is corrupted KnowWE
T405 Resolved Normal Some fixes for %%AttachmentUpdater markup KnowWE
T404 Resolved Normal Exception in %%Ontology when caching URL import KnowWE
T402 Resolved Normal Improve tooltip of %%ShowSolutions markup KnowWE
T401 Resolved Normal Add Explanation Tooltip to Solutions KnowWE
T362 Resolved Normal Allow Unknown and Not(Value) in AbstractioTable KnowWE
T361 Resolved Normal Create docu page for TimeDB-Script on d3web.de TimeDB, d3web, KnowWE
T354 Resolved Normal Rendering of tables is broken KnowWE
T352 Resolved Normal Refresh button is missing in Ontology markup KnowWE
T351 Resolved Normal Add warning to knowledge base, if flowcharts are given, but non has autostart active KnowWE
T309 Resolved Normal Edit Mode buttons overlap content when left menu is collapsed KnowWE, Ontology Engineering
T266 Duplicate Normal owl:oneOf does not create term definitions Ontology Engineering, KnowWE
T260 Resolved Normal Weird behavior of OWL inference in KnowWE KnowWE
T254 Resolved Normal Automated tests for d3web should allow testing with old values KnowWE, d3web
T241 Resolved Normal CondRegularExpression is not parsed correctly when Question contains '-' character KnowWE
T465 Resolved Low KBB Diaflux export fails on nodes with special characters KnowWE
T431 Resolved Low Fix rendering of SPARQL queries that contain square bracket KnowWE
T253 Resolved Low Attachment preview ("»" button next to an attachment) looks weird Frontend, KnowWE
T119 Invalid Low KnowWE is not compatible with OpenJDK KnowWE
T491 Resolved Wishlist Limit number of stored CI builds KnowWE
T252 Resolved Wishlist Javascript debugging for %%Function markup KnowWE
T250 Resolved Wishlist Implement tool to open/expand section in KDOMRenderer KnowWE

Open-Source Modules#

Project Name Contents QA State
denkbares-PluginManager PluginManager used in d3web and KnowWE. x release
denkbares-Progress Tools for handling progress bares and state changes. x release
denkbares-Utils General utils used all over d3web and KnowWE. x release
denkbares-SemanticCore Core module for all ontology related code. Provides sesame repositories (triple stores) in various configurations.   release
denkbares-SemanticCore-Plugin-ExtensionPoints Defines possible extensions for denkbares-SemanticCore.   release
denkbares-SemanticCore-Plugin-GraphDB Provides various RDF, RDFS, OWL and OWL2 repository configurations for denkbares-SemanticCore using OntoTexts GraphDB.   release
denkbares-SemanticCore-Plugin-Jena Provides various RDF and RDFS repository configurations for denkbares-SemanticCore using apache Jena.   release
d3web-GlobalTests A summarizing project for integration tests combining different projects and components, respectively.   release
d3web-Kernel Knowledge representation, basic problem-solvers, session management, default dialog control X release
d3web-Persistence IO component for saving and loading knowledge bases X release
d3web-Plugin-BasicProperties Definition of properties for terminology objects using the plugin.xml file X release
d3web-Plugin-Interview Interviews interfaces and form strategies X release
d3web-Plugin-Kernel-ExtensionPoints Defines possible extension for d3web. X release
d3web-Plugin-Persistence-Basic see d3web-Persistence X release
d3web-Plugin-Persistence-ExtensionPoints see d3web-Persistence X release
d3web-Plugin-SessionPersistence-Basic see d3web-SessionPersistence X release
d3web-Plugin-SessionPersistence-ExtensionPoints see d3web-SessionPersistence X release
d3web-Plugin-TestCase Components for executing test cases on a d3web knowledge base X release
d3web-Plugin-Tests Contains tests to be run with the TestingFramework X release
d3web-SessionPersistence IO components for loading and saving standard cases (i.e. sessions) X release
d3web-Plugin-DiaFlux Reasoning problem-solver for the DiaFlux language X release
d3web-Plugin-CostBenefit Implementation of a dialog strategy (indication of questions) based on a cost-benefit principle.   release
d3web-Plugin-TestingFramework Framework allowing the continuous execution of tests on knowledge bases and other objects. X release
d3web-Plugin-XCL The set-covering model reasoning engine implemented as problem-solver plugin for the d3web Kernel.   release
KnowWE-App Framework app of KnowWE X release
KnowWE-core Basic engines for parsing and the management of wiki content X release
KnowWE-GlobalTestUtils Small set of classes for testing the KnowWE implementation   release
KnowWE-KDOMParseUtils Utils for internal data structure of KnowWE   release
KnowWE-Plugin-Core Core plugins and handlers of KnowWE X release
KnowWE-Plugin-ExtensionPoints Defines possible extension for KnowWE. X release
KnowWE-Plugin-JSPWiki-Connector The connector between the parent wiki engine JSPWiki and the extension KnowWE X release
KnowWE-Resources Template files for the KnowWE server engine X release
KnowWE-Plugin-CI4KE Plugin for implementing the continuous integration dashboard and engine of KnowWE X release
KnowWE-Plugin-CI4KE-d3web Continuous integration tests for d3web knowledge bases in KnowWE X release
KnowWE-Plugin-d3web-basic The fundamental components to integrate the d3web engine into KnowWE X release
KnowWE-Plugin-d3web-MarkupSet Standard markup components used by some KnowWE/d3web plugins X release
KnowWE-Plugin-DiaFlux Authoring plugin for KnowWE of the DiaFlux language X release
KnowWE-Plugin-Include Allows to render contents of other wiki pages with a simple markup   release
KnowWE-Plugin-InstantEdit Plugin to allow fast and easy editing of KnowWE articles   release
KnowWE-Plugin-JSPWiki-MarkupSet Allows the interaction of KnowWE plugins with the default JSPWiki-Markup   beta
KnowWE-Plugin-KBRenderer Plugin for easy rendering of the knowledge base content inside KnowWE articles   beta
KnowWE-Plugin-Ontology-MarkupSet Provides several markups (e.g. turtle) for the creation of ontological knowledge in KnowWE   release
KnowWE-Plugin-OntoVis Various visualization markups for ontologies   release
KnowWE-Plugin-QuickInterview A plugin to quickly enter a problem-solving session X release
KnowWE-Plugin-Rdf2GoSemanticCore Provides Rdf2Go triple store to KnowWE enabling creation of ontological knowledge   release
KnowWE-Plugin-RightPanel Adds a panel on the right sight of KnowWE UI, which can be filled with additional app (e.g. Watches)   release
KnowWE-Plugin-Table Default markups for tables, also usable by other plugins.   release
KnowWE-Plugin-Tagging Tagging plugin of KnowWE X release
KnowWE-Plugin-TestCase Markups for entering test cases in KnowWE X release
KnowWE-Plugin-TestCases Executing test cases in KnowWE X release
KnowWE-Plugin-Visualizations Utility for graphical visualizations of ontologies and knowledge bases   alpha
KnowWE-Plugin-Wikicontent-Download Admin-Tool allowing to download the wiki content as a zip file   release

Closed-Source and Commercial Projects#

Project Name Contents QA Free2Use State
d3web-Plugin-TimeDB Knowledge representation, persistence, and fact storage of temporal values X   release
d3web-Plugin-ImageMap Allows the annotation of images to be connected with answers of questions   X beta
d3web-Plugin-Tests-ClosedSource Closed source tests for the TestingFramework and the TestingApp X   release
KnowWE-Admin-Utils Various tools for Admins of KnowWE   X release
KnowWE-Plugin-Admin-Utils Collection of utility markups to be used by KnowWE Admins   X release
KnowWE-Plugin-AutoComplete A code completion feature for KnowWE markups   X release
KnowWE-Plugin-d3web-ClosedSource Closed source d3web functionality     beta
KnowWE-Plugin-DenkbaresDialog Interactive, web-based interview for running a problem-solving session   X release
KnowWE-Plugin-EditMode Special editing mode for KnowWE to allow faster and direct editing an rearranging of the wiki page   X release
KnowWE-Plugin-ImageMap see d3web-Plugin-ImageMap   X beta
KnowWE-Plugin-KBB Allows to download the "Knowledge Base Book" directly from the knowledge base section in KnowWE     release
KnowWE-Plugin-KPI Allows to analyse KPIs of a knowledge base X   release
KnowWE-Plugin-PlantUML Allows to create UML diagrams directly in KnowWE   X release
KnowWE-Plugin-RightPanel Provides panel on the right side of a KnowWE page, can contain content like d3web variable watches.   X release
KnowWE-Plugin-SparqlEndpoint Accepts and answers SPARQL queries via Http-Requests   X beta
KnowWE-Plugin-TimeDB Wiki-based authoring markups for temporal values X   release
KnowWE-Plugin-TimeDBScript Allows to define additional TimeDB functions in KnowWE using JavaScript     beta
KnowWE-Plugin-Todos A simple plugin to manage todos within the wiki X X release
KnowWE-Plugin-XSL Provides the xsl libraries for KnowWE to be used for example by the KBB plugin     release
Project Name Contents QA Free2Use State
d3web-Plugin-KBB-Basic Exporter components for Knowledge Base Book X   release
d3web-Plugin-KBB-ExtensionPoints Extension possibilities for Knowledge Base Book X   release
KnowledgeBaseBook-Core Core classes and interfaces for Knowledge Base Book X   release
KnowledgeBaseBook Default and helper classes for "Knowledge Base Book" X   release
KnowledgeBaseBook-App Application to create a Knowledge Base Book X   release
KnowWE-Headless-App Application to create knowledge bases from a wikicontent folder without having to use the wiki environment     release
TestingApp Application to continuously run tests on knowledge bases and other test objects X   release
Legend:

Project Name Corresponds to the name of the Maven project, i.e., the name of the source code project. For simplicity, plugin postfixes are omitted (e.g. version).
Contents A further description of the contents of this module
QA Under regulation of the project contract. All contracted projects are certainly subject of the quality management system. Non-contracted modules may be subject to changes in the proposed release plan.
State Quality assessment of the project:
no: Not officially included, experimental demo
alpha: Basic functions included, API to be considered as "unstable" documentation partly available/not available mostly untested
beta: All functions are included documentation available functionality tested on unit level
release: All functions are included documentation available functionality tested on system level (integration tests) internal processes fully applied (issue management, development process)

Changes concerning compatibility#

The following sections describe changes of this release, that are of importance to users migrating from previous releases:

d3web API#

  • d3web now requires Java 8!
  • Removed deprecated, unused methods:
    • RatedTestCase#getDerivedSolutionsAreUpToDate()
    • RatedTestCase#setDerivedSolutionsAreUpToDate(boolean)

  • Various changes in d3web artifact names, so dependencies have to be revised!
    • Some functionality was moved from d3web artifacts to denkbares artifacts.
    • Be aware, that the following artifacts are for testing purposes only and are therefore not needed and should not be included in d3web runtime projects: d3web-Plugin-TestCase, d3web-Plugin-TestingFramework, d3web-Plugin-Tests, d3web-Plugin-Tests-ClosedSource, jgrapht.
  • The packages of the classes in d3web-Utils were renamed from de.d3web.* to com.denkbares.*
  • In particular, the former de.d3web.plugin.JPFPluginManager is now com.denkbares.plugin.JPFPluginManager, also de.d3web.utils.EqualUtils is now com.denkbares.utils.EqualUtils

KnowWE#

The new denkbares-SemanticCore-Plugin-GraphDB, which is included in this release of KnowWE, needs Javas JDK instead of the JRE to work, so make sure the JDK is installed and the JAVA_HOME environment variable to be set correctly. If you can't or don't want to install the JDK, you can optionally remove the denkbares-SemanticCore-Plugin-GraphDB-11.0.jar from the KnowWE webapp (path: KnowWE-Tomcat/webapps/KnowWE/WEB-INF/lib/denkbares-SemanticCore-Plugin-GraphDB-11.0.jar). If you remove the plugin, you will have less and slightly slower rule-sets available in the Ontology markup. d3web knowledge bases will not be affected.