Version: 2.0 Moneypenny (Beta Release 2010-12-15)#

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.pdf License information of the d3web and KnowWE systems and all external libraries.
Quickstart_d3web A first steps installation readme for using the d3web libraries
Quickstart_KnowWE.pdf A first steps manual for installing and starting KnowWE
d3web Folder containing the binaries (libraries), the sources, and the JavaDoc information of d3web
KnowWE Folder containing an installation archive (zip) as binary, the sources, and the JavaDoc information of KnowWE
quality_report Folder containing all files of the quality assessment report for this release. It contains the test protocols of the system tests (based on Fitnesse), a summary of the integration tests, and a detailed analysis of the unit tests (Clover report of the JUnit tests)

System Requirements#

Installation of d3web/KnowWE requires the Java Platform, Standard Edition JDK 6 Update 21 or better. For operating systems, the distribution runs with MS-Windows XP, Windows 7 and Mac OS 10.6. Linux is not officially supported. We officially support Firefox 3.6 or better but most parts are also working with Google Chrome. Please note, that we do not officially support Internet Explorer at the moment.

What's New#

The release includes the following notable features:

d3web#

  • Version of a temporal database storing and reasoning with sequential system inputs.
  • DiaFlux engine for representing and running procedural guideline knowledge.
  • Properties for terminological objects refactored: For instance, now it is very simple to internationalize knowledge bases.

KnowWE#

General#

  • A knowledge base is now created by defining packages of knowledge elements. Simply annotate markups with packages and compile them into one knowledge base. See documentation and demos for further details.
  • Changed the default article storage to a version provider: Now, old versions of wiki articles are also stored (see directory OLD in the wikicontent directory).
  • Introduced user "admin"/"admin" as administrator of the wiki (can delete and rename pages, please change password when deploying into productive use).

Plugins#

  • Version of markups to define time-values events and abstractions.
  • New solutions panel: The ShowSolutions markup shows derived solutions and abstractions in a configurable manner.
  • Refactored input possibilities and style for the QuickInterview.
  • Property markup to attach (localized) properties to terminological objects.
  • Experimental plugin to perform continuous integration on d3web knowledge bases (see: car fault diagnosis demo).
  • denkbares Dialog (commercial plugin) syncs with the problem-solving session of KnowWE (and thus with QuickI).

Fixed Issues#

The IDs of the listed issues correspond to the ticket tracking system available at https://tickets.denkbares.com.

ID Product Short description
1d3webRefactoring of AnswerMChoice
7d3webRuleAction: Refactoring
18d3webInternationalization of terminological knowledge base objects
34d3webIncorrect Comparison in SessionConverter
37d3web[TimeDB] Setting identical values do not propagate
41d3webJavadoc for all sources (incl. closed sources)
42d3webConcurrentModificationException occurred in TimeDB
43d3webNullPointerException in DefaultPropagationManager
46d3webQuestionYN returns Yes / No english-only as answer alternatives
57d3webInfinite Recursion for cyclic question hierarchies
111d3webProperty unit should be localizable
139d3webLoading a KB without TimeDB is not possible when TimeDB was present when saving - even though no TimeDB feature is used
29KnowWERemove all exceptions on KnowWE startup
36KnowWEPreview+Save removes content
39KnowWE[Denkbares Dialog] Creating a new Case doesn't work
40KnowWE[TimeDB] Bug in incremental update for Constant Markup
44KnowWEIncrease HeapSpace of the VM in the startup batch
48KnowWECompile article with blanks
49KnowWEdenkbares interview get stuck if there are empty questionnaires
50KnowWE[QuickI] Collapse of questionnaires does not work
51KnowWE[QuickI] Input field for num questions expect . als float separator
54KnowWE%%Rule markup does not support FormulaExpressions
55KnowWE%%Rule markup does not support KNOWN[...] conditions
56KnowWEDefinition of init questionnaires in the question tree
58KnowWEEmpiricalTesting plugin breaks Wiki page after execution
59KnowWENPE during test execution of KnowWE-core-Plugins
64KnowWENullpointer exception on KnowWE Startup by FlowchartSubTreeHandler
65KnowWEProblems with QuestionYN and QuestionMarkup
67KnowWEComments are not allowed in %%rule-markup
68KnowWEMatch IDObjects in all markups case insensitive: warn if case differs
69KnowWEDisabling Package-Autocompile breaks several tests
71KnowWETime-DB markups does not support incremental compile
72KnowWEPlugin generel.css overwrites the main file
73KnowWE[QuickI] Bug when resetting Multiple-Choice-Questions
74KnowWE%%QuestionTree does not remove quotes of questionnaire name
76KnowWE%%Rule markup does not understand quotes for objects in rule action
77KnowWE[EmpiricalTesting] Download of test suites broken
78KnowWE%%CoveringList-Parser creates solutions
79KnowWE[QuickI] Input boxes don't work in IE
80KnowWE%%Rule markup does not support solution conditions
84KnowWE%%Question: Order of init questions not appropriate
85KnowWEStandard markup to create arbitrary properties for knowledge base objects
86KnowWE%%Question: JUnit Test fails: QuestionTreeTest.testNumberOfQuestions()
87KnowWE[QuickI] Submitting empty NumValue causes NumberFormatException
88KnowWENullpointer exception in UpperOntology while running tests in Research
89KnowWEUnplug the dialog from %%Question Markup
90KnowWE[QuickI] Auto-expansion of parental questionnaires
91KnowWE[QuickI] Cannot answer multiple num. questions
92KnowWE%%Variable does not support @package annotation
93KnowWEProblem with incremental compilation and derivation of solutions
94KnowWESometimes Flowchart DialogRendering has to be manually reloaded
101KnowWEMissing Error Message in Solution Markup
102KnowWEMenu of DefaultMarkup retracting
103KnowWEUnuseful Filename when using empty knowledge base content
105KnowWEStackOverflow when cyclic questionnaire definitions are provided
107KnowWELocally build KnowWE does not provide 'Version' information
110KnowWEIcon missing for TestSuiteRunner
112KnowWENormal SubtreeHandlers not called
113KnowWERules in DefaultMarkup are rendered in columns
114KnowWE[QuickI] quicki.js throws JS-Exception on pages without QuickI
115KnowWETags are not deleted when page is deleted
118KnowWEFlowchart 'eats up' one line-break at end
119KnowWEKnowWEPlugin tageditpanel is no longer functional
121KnowWEMisleading warning Object already defined: XXX in solution hierarchy
122KnowWE[DiaFlux] Formulas are not calculated when entered in DiaFlux
123KnowWEReRenderContentPartAction throws NPE when used with TagHandler in DefaultMarkup
125KnowWE%%TestSuite not parsing properly
126KnowWE& in Pagename collapses all DefaultMarkup Toolmenues
128KnowWE[QuickI] Layout is broken when using DefaultMarkup to embedd it
129KnowWEMessages destroy DefaultMarkupRendering
131KnowWE[QuickI] can't handle QuestionText at all
137KnowWE[Internet Explorer] Styling issues in QuickI
143KnowWEQuestionMarkup & '#' => Wrong KDOM-ID
145KnowWEIncremental parsing issue on numeric conditions in questionTree
147KnowWEFlowchart editor does not shows questionnaire if master article name contains &
150KnowWEReloading page after flowchart editing

Known Issues#

The IDs of the listed issues correspond to the ticket tracking system available at https://tickets.denkbares.com.

IDSeverityStatusTitleRelease Comment
81minorASSIGNEDReRenderSectionMarkerRenderer should support external wiki pagesFor the Moneypenny release no primary plugins are affected by this issue.
104Average problemNEWMalicious HTML code in wiki pages/requestsFor relevant KnowWE applications we recommend to secure the wiki server by htaccess controls and to provide user authentication.
108minorNEWPage rename yields compile errors when the renamed page defines the knowledge baseWorkaround: In these rare cases simply restart KnowWE.
117Serious problemNEWURIDecoding of request parameters is done twice: once by Tomcat and once in KnowWEParameterMapFor the currently deployed plugins this issue is resolved by workarounds. In further releases this problem should be fixed in a fundamental manner.
132Average problemNEWKnowWE / d3web session identifies the users by their IP adressesThis issue may be a problem when users behind a proxy use KnowWE.
136trivialNEW[Internet Explorer] DefaultMarkup-ToolMenu is shiftedWe do not officially support the Internet Explorer for the release Moneypenny.
138Lightweight problemNEW[Internet Explorer] Rendering output lacks a lot of line breaksWe do not officially support the Internet Explorer for the release Moneypenny.
141minorNEWWrong resolution of case-sensitive article namesAt the moment users should be aware of the case-sensitiveness when opening articles by entering the URL directly in the browser.
142minorNEWPackages and articles cannot share the same nameWorkaround: Simply choose a package name that you do not need to use as a name for an article.
146minorNEWFlowchart arrows/guards layout issues after reloadWe do not officially support Chrome for the release Moneypenny.
148trivialNEWApple's command-key is not recognized in DiaFlux editor
152minorNEWDeleting attachments of an article can yield broken page viewWorkaround: In the rare cases you have to delete the attachment folder in the respective wikicontent directory on your server. Sometimes restarting KnowWE also helps.

Delivered Open-Source Projects #

Project Name Contents QA State
d3web-EmpiricalTesting Validation of knowledge bases using test cases release
d3web-GlobalTests A summarizing project for integration tests combining different projects and components, respectively. beta
d3web-Kernel Knowledge representation, basic problem-solvers, session management, default dialog control X release
d3web-Persistence XML knowledge base storage (archived as Jar) X release
d3web-Plugin-BasicProperties Definition of properties for terminology objects using the plugin.xml file X release
d3web-Plugin-CostBenefit Implementation of a dialog strategy (indication of questions) based on a cost-benefit principle. beta
d3web-Plugin-DiaFlux Reasoning problem-solver for the DiaFlux language. X beta
d3web-Plugin-Kernel-ExtensionPoints The extension possibilities of the d3web kernel defined in the plugin.xml file. X release
d3web-Plugin-Persistence-Basic see d3web-Persistence X release
d3web-Plugin-Persistence-ExtensionPoints see d3web-Persistence X release
d3web-Plugin-SharedKnowledgePersistence see d3web-SharedKnowledge X release
d3web-Plugin-XCL The set-covering model reasoning engine implemented as problem-solver plugin for the d3web Kernel. beta
d3web-PluginManager Basic management for connecting plugins to the d3web kernel x release
d3web-SharedKnowledge Common extensions to the basic knowledge representation, e.g., question weights, abnormalities, similarities X release
d3web-Utilities A small set of utility classes for the kernel X release
d3web-Verbalizer Components for the verbalization of a knowledge base X release
KnowWE-App Basic engines for parsing and the management of wiki content X release
KnowWE-GlobalTestUtils Small set of classes for testing the KnowWE implementation beta
KnowWE-Plugin-CI4KE Plugin for implementing the continuous integration dashboard and engine of KnowWE beta
KnowWE-Plugin-Core Core plugins and handlers of KnowWE X beta
KnowWE-Plugin-ExtensionPoints All extension possibilities for plugging KnowWE X release
KnowWE-Plugin-Flowchart Authoring plugin for KnowWE of the DiaFlux language X beta
KnowWE-Plugin-JSPWiki-Connector The connector between the parent wiki engine JSPWiki and the extension KnowWE X release
KnowWE-Plugin-QuickInterview A plugin to quickly enter a problem-solving session X beta
KnowWE-Plugin-SemanticCore Semantic extensions of KnowWE to represent ontologies X beta
KnowWE-Plugin-Tagging Tagging plugin of KnowWE X beta
KnowWE-Plugin-TestCase Entering and using test cases in KnowWE beta
KnowWE-Plugin-d3web-MarkupSet Standard markup components used by some KnowWE/d3web plugins X beta
KnowWE-Plugin-d3web-basic The fundamental components to integrate the d3web engine into KnowWE X beta
KnowWE-Resources Template files for the KnowWE server engine X release
KnowWE-core Basic engines for parsing and the management of wiki content X beta
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., *jpf-plugin)
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)