Last modified by Thomas Mortagne on 2017/03/24

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 This is the first milestone of the XWiki 4.3 version ([[Roadmap>>xwiki:Main.Roadmap]]).
8
9 This release brings several improvements in Workspaces, Extension Manager, Distribution Wizard and the REST API. It is also possible to activate the multiwiki feature when using the HSQLDB database (i.e., in the standalone version of XWiki Enterprise).
10
11 It also provides several important fixes for bugs related to importing Office Documents while using filesystem attachments.
12
13 = New and Noteworthy (since XWiki 4.2) =
14
15 == Workspace Templates ==
16
17 Similar to what admins were doing with the [[Wiki Manager Application>>extensions:Extension.Wiki Manager Application]], we noticed the need for the [[Workspace Application>>extensions:Extension.Workspace Application]] to allow users to choose what type of workspace they want to create.
18
19 {{image reference="workspaceTemplates.png"/}}
20
21 Please see the current workaround for [[creating workspace templates>>https://jira.xwiki.org/browse/XWIKI-8285]] (as admin) until an easy UI becomes available.
22
23 == Extension Manager improvements ==
24
25 === UI ===
26
27 When you click on "Show details" to get more information about an extension, the extension manager tries to resolve all the dependencies of that extension by making requests to the configured remote extension repositories. These requests slow down considerably the time needed to display the extension details. We fixed this by resolving only the local dependencies at first and then making consecutive AJAX requests to resolve the remote dependencies.
28
29 {{image reference="EM-AsyncDependencyLoading.png"/}}
30
31 The install and uninstall plan is now progressively displayed while it is being created. This is especially useful for the Distribution Wizard since you don't have to wait anymore for the install plan to be created without getting any feedback about its progress.
32
33 {{image reference="EM-liveInstallPlan.png"/}}
34
35 As you can see in the previous image, we also limited the height of the progress tab and the extension job log is automatically scrolled to the end while the job is running.
36
37 === Private repositories ===
38
39 Maven and XWiki repositories now support authentication. You can indicate a user and a password in ##xwiki.properties## file the following way:
40
41 {{code language="properties"}}
42 extension.repositories=privatemavenid:maven:http://host.com/private/maven/
43 extension.repositories.privatemavenid.auth.user=someuser
44 extension.repositories.privatemavenid.auth.user=password
45
46 extension.repositories=extensions.xwiki.org:xwiki:http://extensions.xwiki.org/xwiki/rest/
47 extension.repositories.extensions.xwiki.org.auth.user=someuser
48 extension.repositories.extensions.xwiki.org.auth.user=password
49 {{/code}}
50
51 == Distribution Wizard improvements ==
52
53 The welcome step now lists only the available steps. For instance, when you install XWiki for the first time you don't have any extensions to upgrade so the "Extensions" step is not available.
54
55 {{image reference="DistributionWizard-emptyDatabase.png"/}}
56
57 When a step is done we visually mark it.
58
59 {{image reference="DistributionWizard-stepDone.png"/}}
60
61 == REST API improvements ==
62
63 Some improvements have been done to the REST API in order to allow more powerful searches of the data stored in the wiki.
64
65 * Results can be ordered using the ##/wikis/{wikiName}/search## and ##/wikis/{wikiName}/spaces/{spaceName}/search## resources with the following parameters:
66 ** //orderField//: one of the XWiki document field, as specified in [[HQL Query Examples in Velocity>>platform:DevGuide.velocityHqlExamples]]
67 ** //order//: ##asc## or ##desc##". By default ##asc## is used.
68
69 * Advanced search queries can be specified using ##/wikis/{wikiName}/query## resources with the following parameters:
70 ** //q//: the query to be executed (it depends on the query type)
71 ** //type//: ##hql##, ##xwql## or ##lucene##. Depending on the query type, the //q// parameter will contain a query matching the type
72 *** For ##hql## it's like a searchDocuments query, as shown in specified in [[HQL Query Examples in Velocity>>platform:DevGuide.velocityHqlExamples]].
73 *** For ##xwql## the user is allowed to use XWQL syntax for short queries ([[XWiki Query Language Specification>>dev:Design.XWiki Query Language Specification]])
74 *** For ##lucene## it's a standard Lucene query handled by the Lucene plugin ([[Lucene Plugin>>extensions:Extension.Lucene Plugin]])
75 ** Standard parameters like //start//, //number// can be specified to control the number of the results to be returned.
76
77 * Multi-wiki Lucene search using the ##/wikis/query## resource with the following parameters:
78 ** //q//: the Lucene query handled by the Lucene plugin ([[Lucene Plugin>>extensions:Extension.Lucene Plugin]])
79 ** //wikis//: a comma separated list of wikis where to perform the search.
80
81 == Miscellaneous ==
82
83 * XWiki's multiwiki feature (a.k.a "virtual mode") now works with the HSQLDB database
84 * It's now possible to configure the LDAP timeout. See ##xwiki.authentication.ldap.timeout## property in xwiki.cfg file.
85 * New available [[Rendering syntax>>rendering:Main.WebHome]]: [[APT>>http://maven.apache.org/doxia/references/apt-format.html]]
86 * Technical pages of the [[IRCBot Application>>extensions:Extension.IRC Bot Application]] are now hidden and the application now registers itself in the Application panel:(((
87 {{image reference="ircbotapp.png"/}}
88 )))
89
90 == Important Bug Fixes ==
91
92 * Fixed failure to import Office documents when using Filesystem Attachments.
93 * Fixed regression that caused "share by email" and "reset password" functions to fail to send any email.
94
95 See the [[full list of JIRA issues>>https://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-1%22&tempMax=1000]] fixed in this release.
96
97 = For Developers =
98
99 == Deprecated and Retired projects ==
100
101 * The ##userdirectorty## and ##usertools## plugins have been retired since they were unmaintained and mostly replaced by other features such as the Invitation module.
102
103 == Upgrades ==
104
105 The following dependencies have been upgraded:
106
107 * HSQLDB [[2.2.9>>http://hsqldb.org/doc/2.0/changelist_2_0.txt]]
108 * mysql-connector-java [[5.1.21>>http://dev.mysql.com/doc/refman/5.1/en/cj-news-5-1-x.html]]
109 * slf4j [[1.7.2>>http://www.slf4j.org/news.html]]
110 * logback [[1.0.7>>http://logback.qos.ch/news.html]]
111
112 == Miscellaneous ==
113
114 * New ##org.xwiki.rendering.block.CompositeBlock## introduce to allow passing several Blocks as one Block
115 * New ##$services.model.getEntityReferenceValue## method that returns the value configured for a specific entity type
116 * Many classes in the REST API Server module that were not meant to be part of the public API have been moved to internal packages. This was done to correct a mistake that was done when the REST API module was initially developed.
117
118 == Translations ==
119
120 The following translations have been updated:
121
122 {{language codes="fr, sv"/}}
123
124 = Tested Browsers =
125
126 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]]):
127
128 {{velocity}}
129 ## name = iexplorer, firefox, chrome, safari, opera
130 {{/velocity}}
131
132 {{browser name="firefox" version="10.6.1"/}}
133
134 = Known issues =
135
136 * [[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]]
137
138 = Backward Compatibility and Migration Notes =
139
140 == General Notes ==
141
142 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above.
143
144 {{warning}}
145 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.
146 {{/warning}}
147
148 == Issues specific to XWiki 4.3 Milestone 1 ==
149
150 * Since the ##userdirectorty## and ##usertools## have been retired you'll need to make sure that your ##xwiki.cfg## configuration files doesn't reference them anymore in the ##plugins## property.
151
152 == API Breakages ==
153
154 The following APIs were modified since 4.2:
155
156 * [Young API] Introduce API to associate dependency status to the namespace.(((
157 {{code language="none"}}
158 org.xwiki.extension.InstalledExtension: Method 'public boolean isDependency(java.lang.String)' has been added to an interface
159 {{/code}}
160 )))
161
162 * [Young API] Introduce ExtensionRepositoryDescriptor as a replacement of ExtensionRepositoryId(((
163 {{code language="none"}}
164 org.xwiki.extension.ExtensionManagerConfiguration: Method 'public java.util.Collection getExtensionRepositoryDescriptors()' has been added to an interface
165 org.xwiki.extension.repository.ExtensionRepository: Method 'public org.xwiki.extension.repository.ExtensionRepositoryDescriptor getDescriptor()' has been added to an interface
166 org.xwiki.extension.repository.ExtensionRepositoryFactory: Method 'public org.xwiki.extension.repository.ExtensionRepository createRepository(org.xwiki.extension.repository.ExtensionRepositoryDescriptor)' has been added to an interface
167 org.xwiki.extension.repository.ExtensionRepositoryManager: Method 'public org.xwiki.extension.repository.ExtensionRepository addRepository(org.xwiki.extension.repository.ExtensionRepositoryDescriptor)' has been added to an interface
168 org.xwiki.extension.repository.ExtensionRepositorySource: Method 'public java.util.Collection getExtensionRepositoryDescriptors()' has been added to an interface
169 {{/code}}
170 )))
171
172 * The ##userdirectory## and ##usertools## plugins have been retired(((
173 {{code language="none"}}
174 com.xpn.xwiki.plugin.userdirectory.Group: Class com.xpn.xwiki.plugin.userdirectory.Group removed
175 com.xpn.xwiki.plugin.userdirectory.UserDirectoryPlugin: Class com.xpn.xwiki.plugin.userdirectory.UserDirectoryPlugin removed
176 com.xpn.xwiki.plugin.userdirectory.UserDirectoryPluginAPI: Class com.xpn.xwiki.plugin.userdirectory.UserDirectoryPluginAPI removed
177 com.xpn.xwiki.plugin.usertools.XWikiUserManagementTools: Class com.xpn.xwiki.plugin.usertools.XWikiUserManagementTools removed
178 com.xpn.xwiki.plugin.usertools.XWikiUserManagementToolsAPI: Class com.xpn.xwiki.plugin.usertools.XWikiUserManagementToolsAPI removed
179 com.xpn.xwiki.plugin.usertools.XWikiUserManagementToolsImpl: Class com.xpn.xwiki.plugin.usertools.XWikiUserManagementToolsImpl removed
180 {{/code}}
181 )))
182
183 * This should be fixed: a new 'sendMessageFromTemplate' method was added before the 4.2 release and then removed only from master (4.3-SNAPSHOT). We need to decide what we do with this method.(((
184 {{code language="none"}}
185 com.xpn.xwiki.plugin.mailsender.MailSender: Method 'public int sendMessageFromTemplate(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.util.Map)' has been removed
186 {{/code}}
187 )))
188
189 * Many REST API module classes that were not meant to be public have been moved to internal package.(((
190 {{code language="none"}}
191 org.xwiki.rest.ComponentsObjectFactory: Class org.xwiki.rest.ComponentsObjectFactory removed
192 org.xwiki.rest.Constants: Field ALLOWED_VALUES_ATTRIBUTE_NAME has been removed, but it was previously a constant
193 org.xwiki.rest.Constants: Field RELEASABLE_COMPONENT_REFERENCES has been removed, but it was previously a constant
194 org.xwiki.rest.Constants: Field XWIKI_COMPONENT_MANAGER has been removed, but it was previously a constant
195 org.xwiki.rest.DomainObjectFactory: Class org.xwiki.rest.DomainObjectFactory removed
196 org.xwiki.rest.RangeIterable: Class org.xwiki.rest.RangeIterable removed
197 org.xwiki.rest.Utils: Class org.xwiki.rest.Utils removed
198 org.xwiki.rest.XWikiAuthentication: Class org.xwiki.rest.XWikiAuthentication removed
199 org.xwiki.rest.XWikiJaxRsApplication: Class org.xwiki.rest.XWikiJaxRsApplication removed
200 org.xwiki.rest.XWikiRestletJaxRsApplication: Class org.xwiki.rest.XWikiRestletJaxRsApplication removed
201 org.xwiki.rest.XWikiRestletServlet: Class org.xwiki.rest.XWikiRestletServlet removed
202 org.xwiki.rest.XWikiSecretVerifier: Class org.xwiki.rest.XWikiSecretVerifier removed
203 org.xwiki.rest.XWikiSetupCleanupFilter: Class org.xwiki.rest.XWikiSetupCleanupFilter removed
204 org.xwiki.rest.exceptions.QueryExceptionMapper: Class org.xwiki.rest.exceptions.QueryExceptionMapper removed
205 org.xwiki.rest.exceptions.XWikiExceptionMapper: Class org.xwiki.rest.exceptions.XWikiExceptionMapper removed
206 org.xwiki.rest.representations.TextPlainReader: Class org.xwiki.rest.representations.TextPlainReader removed
207 org.xwiki.rest.representations.comments.FormUrlEncodedCommentReader: Class org.xwiki.rest.representations.comments.FormUrlEncodedCommentReader removed
208 org.xwiki.rest.representations.comments.TextPlainCommentReader: Class org.xwiki.rest.representations.comments.TextPlainCommentReader removed
209 org.xwiki.rest.representations.objects.FormUrlEncodedObjectReader: Class org.xwiki.rest.representations.objects.FormUrlEncodedObjectReader removed
210 org.xwiki.rest.representations.objects.FormUrlEncodedPropertyReader: Class org.xwiki.rest.representations.objects.FormUrlEncodedPropertyReader removed
211 org.xwiki.rest.representations.objects.TextPlainPropertyReader: Class org.xwiki.rest.representations.objects.TextPlainPropertyReader removed
212 org.xwiki.rest.representations.pages.FormUrlEncodedPageReader: Class org.xwiki.rest.representations.pages.FormUrlEncodedPageReader removed
213 org.xwiki.rest.representations.pages.TextPlainPageReader: Class org.xwiki.rest.representations.pages.TextPlainPageReader removed
214 org.xwiki.rest.representations.tags.FormUrlEncodedTagsReader: Class org.xwiki.rest.representations.tags.FormUrlEncodedTagsReader removed
215 org.xwiki.rest.representations.tags.TextPlainTagsReader: Class org.xwiki.rest.representations.tags.TextPlainTagsReader removed
216 org.xwiki.rest.resources.BaseAttachmentsResource: Class org.xwiki.rest.resources.BaseAttachmentsResource removed
217 org.xwiki.rest.resources.BaseAttachmentsResource$AttachmentInfo: Class org.xwiki.rest.resources.BaseAttachmentsResource$AttachmentInfo removed
218 org.xwiki.rest.resources.BaseSearchResult: Class org.xwiki.rest.resources.BaseSearchResult removed
219 org.xwiki.rest.resources.BaseSearchResult$SearchScope: Class org.xwiki.rest.resources.BaseSearchResult$SearchScope removed
220 org.xwiki.rest.resources.BrowserAuthenticationResource: Class org.xwiki.rest.resources.BrowserAuthenticationResource removed
221 org.xwiki.rest.resources.ModificationsResource: Class org.xwiki.rest.resources.ModificationsResource removed
222 org.xwiki.rest.resources.RootResource: Class org.xwiki.rest.resources.RootResource removed
223 org.xwiki.rest.resources.SyntaxesResource: Class org.xwiki.rest.resources.SyntaxesResource removed
224 org.xwiki.rest.resources.attachments.AttachmentAtPageVersionResource: Class org.xwiki.rest.resources.attachments.AttachmentAtPageVersionResource removed
225 org.xwiki.rest.resources.attachments.AttachmentHistoryResource: Class org.xwiki.rest.resources.attachments.AttachmentHistoryResource removed
226 org.xwiki.rest.resources.attachments.AttachmentResource: Class org.xwiki.rest.resources.attachments.AttachmentResource removed
227 org.xwiki.rest.resources.attachments.AttachmentVersionResource: Class org.xwiki.rest.resources.attachments.AttachmentVersionResource removed
228 org.xwiki.rest.resources.attachments.AttachmentsAtPageVersionResource: Class org.xwiki.rest.resources.attachments.AttachmentsAtPageVersionResource removed
229 org.xwiki.rest.resources.attachments.AttachmentsResource: Class org.xwiki.rest.resources.attachments.AttachmentsResource removed
230 org.xwiki.rest.resources.classes.ClassPropertiesResource: Class org.xwiki.rest.resources.classes.ClassPropertiesResource removed
231 org.xwiki.rest.resources.classes.ClassPropertyResource: Class org.xwiki.rest.resources.classes.ClassPropertyResource removed
232 org.xwiki.rest.resources.classes.ClassResource: Class org.xwiki.rest.resources.classes.ClassResource removed
233 org.xwiki.rest.resources.classes.ClassesResource: Class org.xwiki.rest.resources.classes.ClassesResource removed
234 org.xwiki.rest.resources.comments.CommentResource: Class org.xwiki.rest.resources.comments.CommentResource removed
235 org.xwiki.rest.resources.comments.CommentVersionResource: Class org.xwiki.rest.resources.comments.CommentVersionResource removed
236 org.xwiki.rest.resources.comments.CommentsResource: Class org.xwiki.rest.resources.comments.CommentsResource removed
237 org.xwiki.rest.resources.comments.CommentsVersionResource: Class org.xwiki.rest.resources.comments.CommentsVersionResource removed
238 org.xwiki.rest.resources.objects.AllObjectsForClassNameResource: Class org.xwiki.rest.resources.objects.AllObjectsForClassNameResource removed
239 org.xwiki.rest.resources.objects.BaseObjectsResource: Class org.xwiki.rest.resources.objects.BaseObjectsResource removed
240 org.xwiki.rest.resources.objects.ObjectAtPageVersionResource: Class org.xwiki.rest.resources.objects.ObjectAtPageVersionResource removed
241 org.xwiki.rest.resources.objects.ObjectPropertiesAtPageVersionResource: Class org.xwiki.rest.resources.objects.ObjectPropertiesAtPageVersionResource removed
242 org.xwiki.rest.resources.objects.ObjectPropertiesResource: Class org.xwiki.rest.resources.objects.ObjectPropertiesResource removed
243 org.xwiki.rest.resources.objects.ObjectPropertyAtPageVersionResource: Class org.xwiki.rest.resources.objects.ObjectPropertyAtPageVersionResource removed
244 org.xwiki.rest.resources.objects.ObjectPropertyResource: Class org.xwiki.rest.resources.objects.ObjectPropertyResource removed
245 org.xwiki.rest.resources.objects.ObjectResource: Class org.xwiki.rest.resources.objects.ObjectResource removed
246 org.xwiki.rest.resources.objects.ObjectsAtPageVersionResource: Class org.xwiki.rest.resources.objects.ObjectsAtPageVersionResource removed
247 org.xwiki.rest.resources.objects.ObjectsForClassNameResource: Class org.xwiki.rest.resources.objects.ObjectsForClassNameResource removed
248 org.xwiki.rest.resources.objects.ObjectsResource: Class org.xwiki.rest.resources.objects.ObjectsResource removed
249 org.xwiki.rest.resources.pages.ModifiablePageResource: Class org.xwiki.rest.resources.pages.ModifiablePageResource removed
250 org.xwiki.rest.resources.pages.PageChildrenResource: Class org.xwiki.rest.resources.pages.PageChildrenResource removed
251 org.xwiki.rest.resources.pages.PageHistoryResource: Class org.xwiki.rest.resources.pages.PageHistoryResource removed
252 org.xwiki.rest.resources.pages.PageResource: Class org.xwiki.rest.resources.pages.PageResource removed
253 org.xwiki.rest.resources.pages.PageTagsResource: Class org.xwiki.rest.resources.pages.PageTagsResource removed
254 org.xwiki.rest.resources.pages.PageTranslationHistoryResource: Class org.xwiki.rest.resources.pages.PageTranslationHistoryResource removed
255 org.xwiki.rest.resources.pages.PageTranslationResource: Class org.xwiki.rest.resources.pages.PageTranslationResource removed
256 org.xwiki.rest.resources.pages.PageTranslationVersionResource: Class org.xwiki.rest.resources.pages.PageTranslationVersionResource removed
257 org.xwiki.rest.resources.pages.PageTranslationsResource: Class org.xwiki.rest.resources.pages.PageTranslationsResource removed
258 org.xwiki.rest.resources.pages.PageVersionResource: Class org.xwiki.rest.resources.pages.PageVersionResource removed
259 org.xwiki.rest.resources.pages.PagesResource: Class org.xwiki.rest.resources.pages.PagesResource removed
260 org.xwiki.rest.resources.spaces.SpaceAttachmentsResource: Class org.xwiki.rest.resources.spaces.SpaceAttachmentsResource removed
261 org.xwiki.rest.resources.spaces.SpaceResource: Class org.xwiki.rest.resources.spaces.SpaceResource removed
262 org.xwiki.rest.resources.spaces.SpaceSearchResource: Class org.xwiki.rest.resources.spaces.SpaceSearchResource removed
263 org.xwiki.rest.resources.spaces.SpacesResource: Class org.xwiki.rest.resources.spaces.SpacesResource removed
264 org.xwiki.rest.resources.tags.PagesForTagsResource: Class org.xwiki.rest.resources.tags.PagesForTagsResource removed
265 org.xwiki.rest.resources.tags.TagsResource: Class org.xwiki.rest.resources.tags.TagsResource removed
266 org.xwiki.rest.resources.wikis.WikiAttachmentsResource: Class org.xwiki.rest.resources.wikis.WikiAttachmentsResource removed
267 org.xwiki.rest.resources.wikis.WikiPagesResource: Class org.xwiki.rest.resources.wikis.WikiPagesResource removed
268 org.xwiki.rest.resources.wikis.WikiSearchResource: Class org.xwiki.rest.resources.wikis.WikiSearchResource removed
269 org.xwiki.rest.resources.wikis.WikisResource: Class org.xwiki.rest.resources.wikis.WikisResource removed
270 {{/code}}
271 )))
272
273 * The version field has been moved from Page to PageSummary which is the superclass of Page(((
274 {{code language="none"}}
275 org.xwiki.rest.model.jaxb.Page: Removed field version
276 {{/code}}
277 )))
278
279 * Added methods for creating workspaces and retrieving workspace templates.(((
280 {{code language="none"}}
281 org.xwiki.workspace.WorkspaceManager: Method 'public com.xpn.xwiki.plugin.wikimanager.doc.XWikiServer createWorkspace(java.lang.String, com.xpn.xwiki.plugin.wikimanager.doc.XWikiServer, java.lang.String)' has been added to an interface
282 org.xwiki.workspace.WorkspaceManager: Method 'public java.util.List getWorkspaceTemplates()' has been added to an interface
283 {{/code}}
284 )))

Get Connected