Release Notes for XWiki 9.3

Last modified by Thomas Mortagne on 2017/04/25

This is the release notes for XWiki Commons, XWiki Rendering, XWiki Platform and XWiki Enterprise. They share the same release notes as they are released together and have the same version.

This release brings a couple of small, but very useful improvements like the ability to filter the sections in Administration, reset changes done to extension pages and alternative configuration locations. Developers get some helpful API in writing clean queries when escaping and filtering, a new API to find documents belonging to extensions and more control through a new extension point for the content menu.

The following regressions were found after this version was released. We recommend using the 9.3.1 release which fixes the problem.

  • Closed XWIKI-14227 Subwikis migration fail 
  • Closed XWIKI-14217 The children viewer live table is empty if the parent page contains a square bracket in its name 

New and Noteworthy (since XWiki 9.2)

Full list of issues fixed and Dashboard for 9.3.

For Users

Failed to execute the [velocity] macro. Cause: [[1,532] Unknown token: &]. Click on this message for details.
Failed to execute the [velocity] macro. Cause: [[1,536] Unknown token: &]. Click on this message for details.

For Admins

Failed to execute the [velocity] macro. Cause: [[1,532] Unknown token: &]. Click on this message for details.
Failed to execute the [velocity] macro. Cause: [[1,536] Unknown token: &]. Click on this message for details.

For Developers

Failed to execute the [velocity] macro. Cause: [could not resolve property: product of: com.xpn.xwiki.objects.BaseObject [ select doc.fullName from com.xpn.xwiki.doc.XWikiDocument as doc , com.xpn.xwiki.objects.BaseObject as entries , com.xpn.xwiki.objects.BaseObject as changes where ( ( entries.product like :product1 ) and ( changes.audience like :audience1 ) and ( entries.version like :version1 or entries.version like :version2 or entries.version like :version3 ) and ( changes.category like :category1 ) and ( changes.importance like :importance1 or changes.importance like :importance2 ) ) and doc.fullName=entries.name and entries.className='ReleaseNotes.Code.EntryClass' and doc.fullName=changes.name and changes.className='ReleaseNotes.Code.Change.ChangeClass' order by changes.importance desc ]]. Click on this message for details.
Failed to execute the [velocity] macro. Cause: [could not resolve property: product of: com.xpn.xwiki.objects.BaseObject [ select doc.fullName from com.xpn.xwiki.doc.XWikiDocument as doc , com.xpn.xwiki.objects.BaseObject as entries , com.xpn.xwiki.objects.BaseObject as changes where ( ( entries.product like :product1 ) and ( changes.audience like :audience1 or changes.audience like :audience2 ) and ( entries.version like :version1 or entries.version like :version2 or entries.version like :version3 ) and ( changes.category like :category1 ) and ( changes.importance like :importance1 ) ) and doc.fullName=entries.name and entries.className='ReleaseNotes.Code.EntryClass' and doc.fullName=changes.name and changes.className='ReleaseNotes.Code.Change.ChangeClass' order by changes.importance desc ]]. Click on this message for details.

Moved Modules

  • Blog Application has been moved from XWiki Platform to Contrib.

Upgrades

The following runtime dependencies have been upgraded (they have a different release cycle than XWiki Commons, XWiki Rendering, XWiki Platform and XWiki Enterprise):

Translations

The following translations have been updated: 

  • Czech
  • Danish
  • German
  • Persian
  • French
  • Italian
  • Latvian
  • Dutch
  • Portuguese (Brazil)
  • Romanian
  • Russian
  • Slovak
  • Swedish

Tested Browsers & Databases

Here is the list of browsers we support and how they have been tested for this release:

BrowserTest Result
Chrome30.pngGoogle Chrome 58Jira Tickets Marked as Fixed in the Release Notes + New and Noteworthy Features
Firefox30.pngMozilla FirefoxNot Tested
IE30.pngInternet Explorer 10Not Tested
IE30.pngInternet Explorer 11Not Tested

Here is the list of databases we support and how they have been tested for this release:

DatabaseTest Result
hypersql.pngHyperSQL 2.4.0Jira Tickets Marked as Fixed in the Release Notes + New and Noteworthy Features
mysql.pngMySQLNot Tested
oracle.pngOracleNot Tested
postgresql.pngPostgreSQLNot Tested

Known issues

Backward Compatibility and Migration Notes

General Notes

When upgrading make sure you compare your xwiki.cfg, xwiki.properties and web.xml files with the newest version since some configuration parameters may have been modified or added. Note that you should add xwiki.store.migration=1 so that XWiki will attempt to automatically migrate your current database to the new schema. Make sure you backup your Database before doing anything.

API Breakages

The following APIs were modified since XWiki 9.3:

  • Really don't see how adding a new constructor could be a breakage...
    • Violation type:
      java.field.serialVersionUIDUnchanged
    • Code:
      ## Old:
      field org.xwiki.extension.ExtensionException.serialVersionUID

      ## New:
      field org.xwiki.extension.ExtensionException.serialVersionUID
  • Not a binary breakage and should not change anything at build either time most of the time
    • Violation type:
      java.generics.formalTypeParameterAdded
    • Code:
      ## Old:
      method <T> T org.xwiki.extension.script.AbstractExtensionScriptService::safe(T)

      ## New:
      method <S, T> S org.xwiki.extension.script.AbstractExtensionScriptService::safe(T)
  • Not a binary breakage and should not change anything at build either time most of the time
    • Violation type:
      java.generics.formalTypeParameterAdded
    • Code:
      ## Old:
      method <T> T org.xwiki.extension.script.AbstractExtensionScriptService::safe(T) @ org.xwiki.extension.xar.script.XarExtensionScriptService

      ## New:
      method <S, T> S org.xwiki.extension.script.AbstractExtensionScriptService::safe(T) @ org.xwiki.extension.xar.script.XarExtensionScriptService
  • Not a binary breakage and should not change anything at build either time most of the time
    • Violation type:
      java.generics.formalTypeParameterAdded
    • Code:
      ## Old:
      method <T> T org.xwiki.extension.script.AbstractExtensionScriptService::safe(T) @ org.xwiki.platform.flavor.script.FlavorManagerScriptService

      ## New:
      method <S, T> S org.xwiki.extension.script.AbstractExtensionScriptService::safe(T) @ org.xwiki.platform.flavor.script.FlavorManagerScriptService
  • Not a breakage
    • Violation type:
      java.field.serialVersionUIDUnchanged
    • Code:
      ## Old:
      field org.xwiki.extension.xar.job.diff.DocumentVersionReference.serialVersionUID

      ## New:
      field org.xwiki.extension.xar.job.diff.DocumentVersionReference.serialVersionUID

Credits

The following people have contributed code to this release (sorted alphabetically):

Ecaterina Moraru (Valica)
Eduard Moraru
Guillaume Delhumeau
Krzysztof PÅ‚achno
Marius Dumitru Florea
Thomas Mortagne
Vincent Massol

Tags:
Created by Ecaterina Moraru (Valica) on 2017/04/21
   

Get Connected