Wiki source code of Release Notes for XWiki 7.4.1
Last modified by Thomas Mortagne on 2017/03/24
Show last authors
author | version | line-number | content |
---|---|---|---|
1 | {{box cssClass="floatinginfobox" title="**Contents**"}} | ||
2 | {{toc/}} | ||
3 | {{/box}} | ||
4 | |||
5 | This is the release notes for [[XWiki Commons>>http://commons.xwiki.org]], [[XWiki Rendering>>http://rendering.xwiki.org]], [[XWiki Platform>>http://platform.xwiki.org]] and [[XWiki Enterprise>>http://enterprise.xwiki.org]]. They share the same release notes as they are released together and have the same version. | ||
6 | |||
7 | 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. | ||
8 | |||
9 | = New and Noteworthy (since XWiki 7.4) = | ||
10 | |||
11 | [[Full list of issues fixed and Dashboard for <version>>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=<fill id here>]]. | ||
12 | |||
13 | {{jira style="list" url="https://jira.xwiki.org" fields="type, status, key, summary" source="jql"}} | ||
14 | category in ("Top Level Projects") AND fixVersion in ("7.4.1") AND resolution in (Fixed) and component not in ("Development Issues only") | ||
15 | {{/jira}} | ||
16 | |||
17 | = Translations = | ||
18 | |||
19 | The following translations have been updated: | ||
20 | |||
21 | {{language codes="fr, nl, pt_BR, ru"/}} | ||
22 | |||
23 | = Tested Browsers & Databases = | ||
24 | |||
25 | {{include reference="TestReports.ManualTestReportSummaryXWiki741"/}} | ||
26 | |||
27 | = Known issues = | ||
28 | |||
29 | * [[Bugs we know about>>https://jira.xwiki.org/secure/IssueNavigator.jspa?reset=true&jqlQuery=category+%3D+%22Top+Level+Projects%22+AND+issuetype+%3D+Bug+AND+resolution+%3D+Unresolved+ORDER+BY+updated+DESC]] | ||
30 | |||
31 | = Backward Compatibility and Migration Notes = | ||
32 | |||
33 | == General Notes == | ||
34 | |||
35 | 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. | ||
36 | |||
37 | == Issues specific to XWiki 7.4.1 == | ||
38 | |||
39 | == Mail API Unique Message Identifier == | ||
40 | |||
41 | In order to solve [[XWIKI-12165>>https://jira.xwiki.org/browse/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##. | ||
42 | |||
43 | == New Space prefix for wiki links == | ||
44 | |||
45 | 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]]##. | ||
46 | |||
47 | == API Breakages == | ||
48 | |||
49 | The following APIs were modified since XWiki 7.4: | ||
50 | |||
51 | * 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:((( | ||
52 | {{code language="none"}} | ||
53 | org.xwiki.refactoring.script.RefactoringScriptService: Method 'public org.xwiki.refactoring.job.EntityJobStatus getCopyAsJobStatus(java.lang.String)' has been removed | ||
54 | org.xwiki.refactoring.script.RefactoringScriptService: Method 'public org.xwiki.refactoring.job.EntityJobStatus getCopyJobStatus(java.lang.String)' has been removed | ||
55 | org.xwiki.refactoring.script.RefactoringScriptService: Method 'public org.xwiki.refactoring.job.EntityJobStatus getDeleteJobStatus(java.lang.String)' has been removed | ||
56 | org.xwiki.refactoring.script.RefactoringScriptService: Method 'public org.xwiki.refactoring.job.EntityJobStatus getMoveJobStatus(java.lang.String)' has been removed | ||
57 | org.xwiki.refactoring.script.RefactoringScriptService: Method 'public org.xwiki.refactoring.job.EntityJobStatus getRenameJobStatus(java.lang.String)' has been removed | ||
58 | {{/code}} | ||
59 | ))) | ||
60 | |||
61 | * New method that is useful for any WYSIWYG editor that accepts as input a full HTML page (with style sheets includes).((( | ||
62 | {{code language="none"}} | ||
63 | org.xwiki.wysiwyg.server.WysiwygEditorScriptService: Method 'public java.lang.String render(org.xwiki.model.reference.DocumentReference)' has been added to an interface | ||
64 | {{/code}} | ||
65 | ))) | ||
66 | |||
67 | * Young API, see [[Mail API Unique Message Identifier>>||anchor="HMailAPIUniqueMessageIdentifier"]]((( | ||
68 | {{code language="none"}} | ||
69 | 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 | ||
70 | 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 | ||
71 | 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 | ||
72 | 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 | ||
73 | 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 | ||
74 | 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 | ||
75 | 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 | ||
76 | org.xwiki.mail.script.ScriptMimeMessage: Removed org.xwiki.mail.internal.ExtendedMimeMessage from the list of superclasses | ||
77 | {{/code}} | ||
78 | ))) |