Version 29.1 by Thomas Mortagne on 2012/11/07

Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 This is the release notes for XWiki Platform, XWiki Enterprise and XWiki Enterprise Manager. They share the same release notes as they are released together and have the same version.
6
7 <insert description of release here>
8
9 = New and Noteworthy (since XWiki 4.3 Milestone 1) =
10
11 == Experimental Solr based search engine ==
12
13 A new and experimental search engine based on [[Apache Solr>>http://lucene.apache.org/solr/]] is now available.
14
15 The new search UI offers advanced search features and results highlighting. Future versions will also include [[Faceted Search>>http://en.wikipedia.org/wiki/Faceted_search]].
16
17 {{image reference="solrSearchFilters.png"/}}
18
19 The new engine has it's own index, separate from the Lucene one, which is stored by default in the ##<permanent directory>/solr## folder. In the same folder you can also access Solr's configuration files together with the index's schema.xml which you can tweek to achieve better results. To change this folder's location, you can either pass the ##-Dsolr.solr.home## system property when you start the application container (tomcat/jetty/etc.) or you can set the ##search.solr.home## property in ##WEB-INF/xwiki.preferences##.
20
21 For now, indexing is done only __manually__ by using the Search Administration UI. Because of this, in order to get any search results, you have to go to ##Administration > Applications > Search## and index/reindex the wiki. Any changes in the content of the wiki will not be searchable until you manually reindex. This limitation will be removed in future versions, once the feature matures.
22
23 {{image reference="solrSearchAdmin.png"/}}
24
25 This new search engine is not enable by default, since Lucene is still the default one, but, if you wish to try it out, it can be enable by going to ##Administration > Applications > Search > Search engine to use## and selecting ##Solr (Experimental)##.
26
27 == Default date picker ==
28
29 The date picker from [[AppWithinMinutes>>extensions:Extension.App Within Minutes Application]] is now the default picker for all [[XClass>>platform:DevGuide.DataModel]] properties of type Date. This means that you'll get a date picker when editing an object with a Date property even if you didn't use AppWithinMinutes to create the XClass.
30
31 {{image reference="DatePicker.png"/}}
32
33 If for some reason you don't want to use the new date picker then you can edit the XClass and uncheck "Use Date Picker" for the Date property.
34
35 == User picker ==
36
37 We added a user picker that is used by default for all [[XClass>>platform:DevGuide.DataModel]] properties of type "List of Users". When multiple selection is enabled, each selected user is added to the list above the picker. You can remove individual users from the list of selected users or you can clear the entire list.
38
39 {{image reference="userPicker-editMultiple.png"/}}
40
41 In single selection mode whenever you select an user it overwrites the previously selected user.
42
43 {{image reference="userPicker-editSingle-objectEditor.png"/}}
44
45 The list of selected users is displayed in view mode in a similar way. For each user there is a link to their profile page.
46
47 {{image reference="userPicker-viewMultiple.png"/}}
48
49 == Miscellaneous ==
50
51 <insert misc user stuff and important bug fix descriptions here in a list, when they are too small to warrant a section by themselves - Change the version in the URL below!>
52
53 * Search Admin UI improvements ({{jira style="enum" url="http://jira.xwiki.org"}}XWIKI-8408{{/jira}}):(((
54 {{image reference="searchAdminUINew.png"/}}
55 )))
56
57 See the [[full list of JIRA issues>>http://jira.xwiki.org/sr/jira.issueviews:searchrequest-printable/temp/SearchRequest.html?jqlQuery=project+in+%28XCOMMONS%2C+XRENDERING%2C+XWIKI%2C+XE%2C+XEM%29+and+status+%3D+Closed+and+resolution+%3D+Fixed+and+fixVersion+%3D+%224.3-milestone-2%22&tempMax=1000]] fixed in this release.
58
59 = For Developers =
60
61 == New Localization Module ==
62
63 A new localization module has been introduced to replace the old XWikiMessageTool.
64
65 See [[extensions:Extension.Localization Module]] for more details.
66
67 == REST API Improvements ==
68
69 Some improvements have been done to the REST API with respect to wiki management.
70
71 * XARs can be imported in Wikis by POSTing it to the /wikis/{wikiName}
72 * New wikis can be created using the /wikimanager resource. (This resource is only available with XWiki Enterprise Manager)
73
74 For more information see [[XWiki RESTful API>>platform:Features.XWikiRESTfulAPI]]
75
76 In addition there was an XWiki REST API refactoring done with the introduction of a new ##xwiki-platform-rest-api## module containing all resource declarations. This is important for client and modules willing to use the REST API so that they can have all the information about resources using Java annotation. See [[XWiki RESTful API>>platform:Features.XWikiRESTfulAPI]].
77
78 == Execution context property declarations ==
79
80 Execution context properties can now be associated with various metadata attributes. See [[the documentation on the execution context>>doc:platform:DevGuide.SavingData||anchor="HExecutionContext"]] for more information.
81
82 == Deprecated and Retired projects ==
83
84 <description of deprecated and retired projects>
85
86 == Upgrades ==
87
88 The following dependencies have been upgraded:
89
90 * [[XStream 1.4.3>>http://xstream.codehaus.org/changes.html]]
91 * [[commons-io 2.4>>http://commons.apache.org/io/upgradeto2_4.html]]
92 * [[httpclient 4.2.2>>http://www.apache.org/dist/httpcomponents/httpclient/RELEASE_NOTES.txt]]
93 * [[commons-configuration 1.9>>http://commons.apache.org/configuration/changes-report.html#a1.9]]
94 * [[jcl-over-slf4j and log4j-over-slf4j 1.7.2>>http://www.slf4j.org/news.html]]
95 * Groovy [[1.8.7>>http://jira.codehaus.org/secure/ReleaseNote.jspa?projectId=10242&version=18317]] [[1.8.8>>http://jira.codehaus.org/secure/ReleaseNote.jspa?projectId=10242&version=18684]]
96 * [[JGroups 3.2.0.Final>>http://belaban.blogspot.fr/2012/10/jgroups-320final-released.html]]
97 * [[Xerces-J 2.10.0>>http://xerces.apache.org/xerces2-j/releases.html]]
98
99 == Miscellaneous ==
100
101 <other dev stuff to add and link to JIRA for all issues fixed>
102
103 = Translations =
104
105 The following translations have been updated:
106
107 {{language codes="code1, code2"/}}
108
109 = Tested Browsers =
110
111 Here's the list of browsers tested with this version (i.e. browsers that we've tested as working - Check the list of [[supported browsers>>dev:Community.BrowserSupportStrategy]]):
112
113 {{velocity}}
114 ## name = iexplorer, firefox, chrome, safari, opera
115 {{/velocity}}
116
117 {{browser name="browser" version="x.x"/}}
118
119 = Known issues =
120
121 * [[Bugs we know about>>http://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]]
122
123 = Test Report =
124
125 You can check the [[manual test report>>TestReports.WebHome#<anchor to test report>]] to learn about what was tested and the results on various browsers.
126
127 = Backward Compatibility and Migration Notes =
128
129 == General Notes ==
130
131 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above.
132
133 {{warning}}
134 Always make sure you compare your ##xwiki.cfg## and ##xwiki.properties## files with the newest version since some configuration parameters were 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.
135 {{/warning}}
136
137 == Issues specific to XWiki 4.3 Milestone 2 ==
138
139 * The methods setUrlPatternMatcher and getUrlPatternMatcher have been removed from the core class com.xpn.xwiki.XWiki. The underlying URLPatternMatcher could not really be used as a singleton instance and was causing irregular failures in the basic authentication method. Thus these methods cannot be meaningfully relied upon and have therefore been removed.
140 * When setting the value using setValue (or setList) on a list field in an XWiki object, the list will now be copied. To be able to update the list, you must call getValue (or getList) and update the returned list. This is due to {{jira style="enum" url="http://jira.xwiki.org"}}XWIKI-8398{{/jira}}.
141
142 == API Breakages ==
143
144 The following APIs were modified since <project> <version - 1>:
145
146 {{code language="none"}}
147 <clirr output here>
148 {{/code}}

Get Connected