Release Notes for XWiki 7.4.1

Last modified by Thomas Mortagne on 2017/03/24

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 is a bug fix release including some important improvements such as: asynchronous copy and rename page actions, improved location picker when copying and renaming, ability to omit "WebHome" in wiki links and images syntaxes.

New and Noteworthy (since XWiki 7.4)

Full list of issues fixed and Dashboard for <version>.

Translations

The following translations have been updated: 

Tested Browsers & Databases

Failed to execute the [velocity] macro. Cause: [The execution of the [velocity] script macro is not allowed in [xwiki:TestReports.ManualTestReportSummaryXWiki741]. Check the rights of its last author or the parameters if it's rendered from another script.]. Click on this message for details.

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

BrowserTest Result
Chrome30.pngGoogle Chrome 47Partially tested
Firefox30.pngMozilla Firefox 43Partially tested
IE30.pngInternet Explorer 10Not Tested
IE30.pngInternet Explorer 11Jira Tickets Marked as Fixed in the Release Notes

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

DatabaseTest Result
hypersql.pngHyperSQL 2.3.3Partially tested
mysql.pngMySQL 5.6.24Not Tested
oracle.pngOracle 11.2Not Tested
postgresql.pngPostgreSQL 9.5Jira Tickets Marked as Fixed in the Release Notes

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.

Issues specific to XWiki 7.4.1

Mail API Unique Message Identifier

In order to solve XWIKI-12165, the unique identifier of each mime message sent has been changed to a SHA1 based on the Message-ID header and the list of recipients of the mails, ensuring uniqueness during a newsletter or mailing sending. To introduce this change, the MailContentStore and the MailListener API has been broken, and now use a new ExtendedMimeMessage instead of the simple MimeMessage for all arguments. The values messageId returned or used as argument in the API is no more equivalent to the Message-ID header, but is now the unique identifier returned by ExtendedMimeMessage#getUniqueMessageId(). Finally, the MessageMimeMessageFactory now returns cloned MimeMessage without changing the Message-ID.

We've introduced the possibility to explicitly create a link to a Space in XWiki Syntax 2.1, e.g. [[space:Space1.Space2]]. However if you had a subwiki named space the new notation will conflict with the syntax for referencing that wiki. Thus you'll need to edit existing links such as [[space:something]] to [[doc:space:something]]. And if you wish to reference a given space in the space subwiki, you'd write [[space:space:something]].

API Breakages

The following APIs were modified since XWiki 7.4:

  • We can get the job status in a generic way using the job script service. This method is part of an unstable (young) API and it wasn't working anyway, as it was throwing a ClassCastException:
    org.xwiki.refactoring.script.RefactoringScriptService: Method 'public org.xwiki.refactoring.job.EntityJobStatus getCopyAsJobStatus(java.lang.String)' has been removed
    org.xwiki.refactoring.script.RefactoringScriptService: Method 'public org.xwiki.refactoring.job.EntityJobStatus getCopyJobStatus(java.lang.String)' has been removed
    org.xwiki.refactoring.script.RefactoringScriptService: Method 'public org.xwiki.refactoring.job.EntityJobStatus getDeleteJobStatus(java.lang.String)' has been removed
    org.xwiki.refactoring.script.RefactoringScriptService: Method 'public org.xwiki.refactoring.job.EntityJobStatus getMoveJobStatus(java.lang.String)' has been removed
    org.xwiki.refactoring.script.RefactoringScriptService: Method 'public org.xwiki.refactoring.job.EntityJobStatus getRenameJobStatus(java.lang.String)' has been removed
  • New method that is useful for any WYSIWYG editor that accepts as input a full HTML page (with style sheets includes).
    org.xwiki.wysiwyg.server.WysiwygEditorScriptService: Method 'public java.lang.String render(org.xwiki.model.reference.DocumentReference)' has been added to an interface
  • Young API, see Mail API Unique Message Identifier
    org.xwiki.mail.MailContentStore: Return type of method 'public javax.mail.internet.MimeMessage load(javax.mail.Session, java.lang.String, java.lang.String)' has been changed to org.xwiki.mail.ExtendedMimeMessage
    org.xwiki.mail.MailContentStore: Parameter 2 of 'public void save(java.lang.String, javax.mail.internet.MimeMessage)' has changed its type to org.xwiki.mail.ExtendedMimeMessage
    org.xwiki.mail.MailListener: Parameter 1 of 'public void onPrepareMessageError(javax.mail.internet.MimeMessage, java.lang.Exception, java.util.Map)' has changed its type to org.xwiki.mail.ExtendedMimeMessage
    org.xwiki.mail.MailListener: Parameter 1 of 'public void onPrepareMessageSuccess(javax.mail.internet.MimeMessage, java.util.Map)' has changed its type to org.xwiki.mail.ExtendedMimeMessage
    org.xwiki.mail.MailListener: Parameter 1 of 'public void onSendMessageError(javax.mail.internet.MimeMessage, java.lang.Exception, java.util.Map)' has changed its type to org.xwiki.mail.ExtendedMimeMessage
    org.xwiki.mail.MailListener: Parameter 1 of 'public void onSendMessageSuccess(javax.mail.internet.MimeMessage, java.util.Map)' has changed its type to org.xwiki.mail.ExtendedMimeMessage
    org.xwiki.mail.MailStatus: Parameter 2 of 'public MailStatus(java.lang.String, javax.mail.internet.MimeMessage, org.xwiki.mail.MailState)' has changed its type to org.xwiki.mail.ExtendedMimeMessage
    org.xwiki.mail.script.ScriptMimeMessage: Removed org.xwiki.mail.internal.ExtendedMimeMessage from the list of superclasses

Get Connected