Skip to Content

Version 13.9 by Caleb James DeLisle on 2012/06/18
Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 {{warning}}4.1 is not released yet, this is a work in progress{{/warning}}
6
7 This is the second release of the 4.x cycle ([[Roadmap>>Main.Roadmap]]). This release brings {{todo/}}
8
9 = New and Noteworthy (since XWiki Enterprise 4.0 version) =
10
11 Here are notable new features and improvements. For the full list of issues (including statistics) see the [[JIRA Dashboard>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=11191]].
12
13 == Improvements to the Extension Manager ==
14
15 The speed and reliability of the [[Extension Repository>>extensions:Extension.Extension Repository Application]] has been improved considerably. For example the [[XWiki.org Extension Repository>>extensions:Extension.WebHome]] is now much faster when you access it from XWiki Enterprise and you should now be able to browse and install extensions in no time.
16
17 Upgrading applications with related configuration documents is now handled using the merge conflict resolution UI. Changes are displayed as if you were comparing versions from a document's history.
18
19 {{image reference="EM-mergeConflict.png"/}}
20
21 If extension installation fails, the error message is extracted from the logs and displayed. You can view the full stack trace by clicking on the error message.
22
23 (in the image below the job of computing the install plan fails)
24
25 image:EM-extensionLog.png
26
27 The install and uninstall plans display extensions like in the dependency section. This way you can follow the link of an extension to find out more about what is going to be installed.
28
29 image:EM-uninstallPlan.png
30
31 The install and uninstall process is now completely asynchronous. You can see below how the progress is indicated.
32
33 image:EM-asyncInstall.png
34
35 See the [[Extension Manager Application documentation>>doc:extensions:Extension.Extension Manager Application]] for more details.
36
37 == Hide technical documents from non-technical users ==
38
39 * Users who do not opt to see hidden documents do not see them on panels or in search results.
40 * For advanced users, it is now possible to specify that a document should be hidden when editing the document (only //wiki// or //wysiwyg// edit modes):(((
41 [[image:HideDocument.png||style="border:1px solid silver" width="240px"]]
42
43 And now there's a new setting in the user profiles, letting users choose whether they want hidden documents to appear in search results and panels:
44
45 [[image:ShowHiddenDocuments.png||style="border:1px solid silver" width="300px"]]
46
47 * If the user doesn't set explicitly the Hidden setting value in his profile, he won't see hidden documents by default. Thus seeing hidden documents is an explicit choice.
48 )))
49
50
51 == New types of charts ==
52
53 We've [[added 2 new types of charts>>extensions:Extension.Chart Macro]], **bar3D** and **line3D**, which draw 3D charts.
54
55 For example the following code:
56
57 {{code}}
58 {{chart type='bar3D' source='inline' params='range:B2-B9;series:columns'}}
59 |=Date|=Value
60 |2012-02-21|1.97
61 |2012-02-26|2.96
62 |2012-03-04|3.93
63 |2012-03-11|4.84
64 |2012-03-18|5.83
65 |2012-03-25|4.5
66 |2012-04-01|3.85
67 |2012-04-08|4.87
68 {{/chart}}
69 {{/code}}
70
71 Will be rendered as this:
72
73 [[image:chart-example.png]]
74
75
76 It's now possible to select [[custom colors in Chart graphs>>extensions:Extension.Chart Macro]]. For example:
77
78 {{code}}
79 {{chart type="pie" source="inline" params="range:B2-D5;series:columns;colors:C3E3F7,1D9FF5,015891,012A45" title="Chart Test" width="320" height="240"}}
80 | |X |Y |Z
81 |Q1|1.2|3.4|1.3
82 |Q2|4.5|3.4|2.3
83 |Q3|1.2|4.5|9.0
84 |Q4|3.4|1.2|1.2
85 {{/chart}}
86 {{/code}}
87
88 Will generate:
89
90 {{image reference="extensions:Extension.Chart Macro@customcolors.png"/}}
91
92
93 == New macro for sending messages ==
94
95 Whereas the Activity Stream allows users to send a message as well as observing messages and activities of other users, this macro allows the explicit message sending functionality to be duplicated in other places without including the activity stream as well.
96
97 The code:
98
99 {{code language="none"}}
100 {{messageSender /}}
101 {{/code}}
102
103 Produces the following:
104
105 {{image reference="messageSenderMacro.png"/}}
106
107
108
109 = For developers =
110
111 * New rendering [[Compatibility Test Suite>>rendering:Main.CompatibilityTestSuite]] to make testing easier and simplify implementation of new syntax Parsers and Renderers. You can checkout the [[Compatibility report>>rendering:Main.SyntaxReport]] for all the syntaxes that are supported out of the box by XWiki.
112
113 * New API for upgrading installed XWiki Extensions.
114
115 * New diff/merge module has been added to make easier to deal with diff and merge both from component and scripts. See [[Diff module >>extensions:Extension.Diff Module]] for details.
116
117 == Taming of Groovy scripts ==
118
119 Since traditionally, Groovy scripts can enter into unstoppable infinite loops, use reflection to violate security assumptions, access server resources, or even crash the virtual machine, they have been off limits to non-administrators.
120
121 In a bid to open up new scripting options to less permitted users (especially in wiki farms where getting Programming Rights is a problem since it means having those rights on the whole farm), steps have been taken to make Groovy safer.
122
123 Groovy scripts are now technically allowed to users having simple Edit rights but the Groovy Sandbox is currently very restrictive (said differently, you cannot do anything useful with it at the moment! :)). Now that we have the mechanism in place our plan is to slowly open up allowed operations.
124
125 To enable and test this feature read the document for both the [[Commons Groovy Module>>extensions:Extension.GroovyModuleCommons]] and the [[Platform Groovy Module>>extensions:Extension.GroovyModulePlatform]].
126
127 === Compilation customizers ===
128
129 Customizers can be registered to alter the Groovy script as it is compiled such as filtering System.exit() calls and adding timeout checks to loops to prevent infinite looping. Learn more: http://www.jroller.com/melix/entry/upcoming_groovy_goodness_automatic_thread
130
131 === Stop run-away Groovy scripts after a configurable timeout ===
132
133 You can now configure your wiki to stop Groovy scripts after a configurable amount of run time. For example if you wish to have a timeout of 10 seconds for your XWiki runtime, you'd configure xwiki's ##xwiki.properties## with:
134
135 {{code language="none"}}
136 groovy.compilationCustomizers=timedinterrupt
137 groovy.customizer.timedInterrupt.timeout=10
138 {{/code}}
139
140 == New support for "short form" HQL queries in the Query Manager ==
141
142 When you send a search query to the Query Manager such as {{code language="none"}}where doc.creationDate > '2008-01-01'{{/code}} It is now assumed that you meant:
143
144 {{code language="none"}}
145 select doc.fullName from XWikiDocument as doc where doc.creationDate > '2008-01-01'
146 {{/code}}
147
148 == Bug fixes and improvements ==
149
150 * Fixed wrong calculation of IDs for stats values making it impossible to upgrade a wiki to version 4.0 if statistics collection is enabled.
151 * Faster first startup time by not running a database migration when it is not needed.
152 * Simplify reverse proxy setup by making all HTTP redirects use relitive URLs.
153 * Add support for bold, italic and monospace in the TeX Renderer
154 * Was impossible to delete then recreate a subwiki with the same name, fixed.
155 * Fixed Javascript error when scrolling over Search Suggest results in Internet Explorer 6.
156 * Trying to change a document's parent from the REST service resulted in an error, fixed.
157 * It is now possible for non-administrators to execute cross-wiki XWQL queries.
158 * Move ComponentManager deprecated methods to Legacy modules
159 * New Groovy module in xwiki-commons
160 * Add legacy module structure for XWiki Rendering
161 * Have one Maven module per XWiki Rendering syntax
162 * Separate Event Syntax from Rendering API by moving it to a Syntax module
163 * Plain syntax and Event syntax have been moved out of Rendering API nto their own modules.
164 * [[XWIKI-7913>>http://jira.xwiki.org/browse/XWIKI-7913]] Could not register a Javascript or CSS skin extension for the whole wiki.
165
166
167 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+%28fixVersion+%3D+%224.1-milestone-1%22+%7C%7C+fixVersion+%3D+%224.1-milestone-2%22+%7C%7C+fixVersion+%3D+%224.1-rc-1%22+%7C%7C+fixVersion+%3D+%224.1%22%29&tempMax=1000]] fixed in the 4.1 release cycle.
168
169
170 == Upgrades ==
171
172 The following dependencies have been upgraded since XWiki Enterprise 4.0
173
174 === Upgraded in XWiki Enterprise Milestone 1 ===
175
176 * Tika 1.1
177 * JGroups 3.0.10
178 * Pygments 1.5
179 * Selenium 2.21
180 * Maven AspectJ Plugin 1.4
181 * commons-io 2.3
182 * Maven Shade plugin 1.6
183
184 === Upgraded in XWiki Enterprise Milestone 2 ===
185
186 * Restlet 2.0.14
187 ** Prior to Restlet 2.0.14, there was a REST bug allowing arbitrary filesystem read access for registered users.
188 * Reflections 0.9.7
189
190 = Tested Browsers =
191
192 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]]):
193
194
195 {{todo/}}
196
197
198 = Tested Databases =
199
200 {{todo/}}
201
202
203 = Known issues =
204
205 * [[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]]
206
207 = Test Report =
208
209 You can check the [[manual test report>>TestReports.ManualTestReportXE41]] to learn about what was tested and the results on various browsers.
210
211 = Backward Compatibility and Migration Notes =
212
213 == General Notes ==
214
215 {{info}}
216 If you're running in a multiwiki setup you'll also need to define the property //xwiki.store.migration.databases// in your //xwiki.cfg// file if you want to explicitly name some databases to be migrated as the default is now to migrate all databases. Database that are not migrated could not be accessed.
217 {{/info}}
218
219 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above.
220
221 {{warning}}
222 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.
223 {{/warning}}
224
225 == Issues specific to XWiki Enterprise 4.1 Milestone 1 ==
226
227 The old experimental real-time synchronization plugin for the WYSIWYG content editor has been retired. We hope that its functionality will be replaced by the real-time editing feature developed on the [[Wiki 3.0>>https://github.com/xwiki-contrib/wiki30]] project. If you want to continue using the old plugin you need to:
228
229 * take the code from [[##xwiki-contrib/retired## GitHub repo>>https://github.com/xwiki-contrib/retired/tree/master/xwiki-platform-wysiwyg-plugin-sync]]
230 * add the client and server side as dependencies to the WYSIWYG client and server side respectively
231 * modify ##WysiwygEditorFactory## to register the factory of the sync plugin
232 * rebuild the editor and update the jars and client side resources on your XWiki Enterprise instance
233
234 == API Breakages ==
235
236 The following APIs were modified since version 4.0:
237
238 * Breakage in Query module done to support adding several Filters to a Query:(((
239 {{code language="none"}}
240 org.xwiki.query.QueryFilter: Method 'public java.util.List filterResults(java.util.List)' has been added to an interface
241 {{/code}}
242 )))
243 * This method should have been internal from the beginning:(((
244 {{code language="none"}}
245 org.xwiki.environment.EnvironmentConfiguration: Class org.xwiki.environment.EnvironmentConfiguration removed
246 {{/code}}
247 )))
248 * The Job module is new and is still considered a "young API":(((
249 {{code language="none"}}
250 org.xwiki.job.AbstractJob: Changed type of field status from org.xwiki.job.internal.DefaultJobStatus to org.xwiki.job.internal.AbstractJobStatus
251 org.xwiki.job.AbstractJob: Return type of method 'protected org.xwiki.job.internal.DefaultJobStatus createNewStatus(org.xwiki.job.Request)' has been changed to org.xwiki.job.internal.AbstractJobStatus
252 org.xwiki.job.AbstractJob: Method 'protected java.lang.String getId()' has been removed
253 org.xwiki.job.AbstractRequest: Return type of method 'public java.lang.String getId()' has been changed to java.util.List
254 org.xwiki.job.Job: Method 'public void join()' has been added to an interface
255 org.xwiki.job.Job: Method 'public boolean join(long, java.util.concurrent.TimeUnit)' has been added to an interface
256 org.xwiki.job.JobManager: Method 'public org.xwiki.job.event.status.JobStatus getJobStatus(java.util.List)' has been added to an interface
257 org.xwiki.job.Request: Return type of method 'public java.lang.String getId()' has been changed to java.util.List
258 org.xwiki.job.event.JobEvent: Return type of method 'public java.lang.String getJobId()' has been changed to java.util.List
259 org.xwiki.job.event.JobFinishedEvent: Return type of method 'public java.lang.String getJobId()' has been changed to java.util.List
260 org.xwiki.job.event.JobStartedEvent: Return type of method 'public java.lang.String getJobId()' has been changed to java.util.List
261 org.xwiki.job.event.status.JobStatus: Method 'public java.util.Date getEndDate()' has been added to an interface
262 org.xwiki.job.event.status.JobStatus: Method 'public java.util.Date getStartDate()' has been added to an interface
263 {{/code}}
264 )))
265 * The Extension module is relatively new and is still undergoing some API tuning:(((
266 {{code language="none"}}
267 org.xwiki.extension.job.plan.ExtensionPlan: Return type of method 'public java.util.Collection getTree()' has been changed to org.xwiki.extension.job.plan.ExtensionPlanTree
268 org.xwiki.extension.version.VersionConstraint: Method 'public boolean isCompatible(org.xwiki.extension.version.Version)' has been added to an interface
269 {{/code}}
270 )))
271 * This class was added in 3.2M2 by error in a user-public package. It's been moved again in the internal package as it should have been. We don't expect many users to be affected by this:(((
272 {{code language="none"}}
273 com.xpn.xwiki.doc.merge.MergeUtils: Class com.xpn.xwiki.doc.merge.MergeUtils removed
274 {{/code}}
275 )))
276 * In 2.2M1 we refactored BaseCollection to add getXClass() but we forgot to add it to the ObjectInterface interface. Even though this could break user we think it's very limited since nobody should implement directly ObjectInterface; instead everyone should extend BaseClass or BaseCollection:(((
277 {{code language="none"}}
278 com.xpn.xwiki.objects.ObjectInterface: Method 'public com.xpn.xwiki.objects.classes.BaseClass getXClass(com.xpn.xwiki.XWikiContext)' has been added to an interface
279 {{/code}}
280 )))
281 * The Autotag plugin has been extracted from the oldcore module and is now a module on its own so the following are not real breakages:(((
282 {{code language="none"}}
283 com.xpn.xwiki.plugin.autotag.AutoTagPlugin: Class com.xpn.xwiki.plugin.autotag.AutoTagPlugin removed
284 com.xpn.xwiki.plugin.autotag.AutoTagPluginAPI: Class com.xpn.xwiki.plugin.autotag.AutoTagPluginAPI removed
285 com.xpn.xwiki.plugin.autotag.FrenchStemmer: Class com.xpn.xwiki.plugin.autotag.FrenchStemmer removed
286 com.xpn.xwiki.plugin.autotag.Tag: Class com.xpn.xwiki.plugin.autotag.Tag removed
287 com.xpn.xwiki.plugin.autotag.TagCloud: Class com.xpn.xwiki.plugin.autotag.TagCloud removed
288 {{/code}}
289 )))
290 * The WYSIWYG Diff and Sync plugins have been extracted into their own modules so the following are not real breakages:(((
291 {{code language="none"}}
292 org.xwiki.gwt.wysiwyg.client.Images: Method 'public com.google.gwt.resources.client.ImageResource sync()' has been removed
293 org.xwiki.gwt.wysiwyg.client.Strings: Method 'public java.lang.String sync()' has been removed
294 org.xwiki.gwt.wysiwyg.client.diff.AddDelta: Class org.xwiki.gwt.wysiwyg.client.diff.AddDelta removed
295 org.xwiki.gwt.wysiwyg.client.diff.ChangeDelta: Class org.xwiki.gwt.wysiwyg.client.diff.ChangeDelta removed
296 org.xwiki.gwt.wysiwyg.client.diff.Chunk: Class org.xwiki.gwt.wysiwyg.client.diff.Chunk removed
297 org.xwiki.gwt.wysiwyg.client.diff.DeleteDelta: Class org.xwiki.gwt.wysiwyg.client.diff.DeleteDelta removed
298 org.xwiki.gwt.wysiwyg.client.diff.Delta: Class org.xwiki.gwt.wysiwyg.client.diff.Delta removed
299 org.xwiki.gwt.wysiwyg.client.diff.Diff: Class org.xwiki.gwt.wysiwyg.client.diff.Diff removed
300 org.xwiki.gwt.wysiwyg.client.diff.DiffAlgorithm: Class org.xwiki.gwt.wysiwyg.client.diff.DiffAlgorithm removed
301 org.xwiki.gwt.wysiwyg.client.diff.DiffException: Class org.xwiki.gwt.wysiwyg.client.diff.DiffException removed
302 org.xwiki.gwt.wysiwyg.client.diff.DifferentiationFailedException: Class org.xwiki.gwt.wysiwyg.client.diff.DifferentiationFailedException removed
303 org.xwiki.gwt.wysiwyg.client.diff.PatchFailedException: Class org.xwiki.gwt.wysiwyg.client.diff.PatchFailedException removed
304 org.xwiki.gwt.wysiwyg.client.diff.Revision: Class org.xwiki.gwt.wysiwyg.client.diff.Revision removed
305 org.xwiki.gwt.wysiwyg.client.diff.RevisionVisitor: Class org.xwiki.gwt.wysiwyg.client.diff.RevisionVisitor removed
306 org.xwiki.gwt.wysiwyg.client.diff.SimpleDiff: Class org.xwiki.gwt.wysiwyg.client.diff.SimpleDiff removed
307 org.xwiki.gwt.wysiwyg.client.diff.ToString: Class org.xwiki.gwt.wysiwyg.client.diff.ToString removed
308 org.xwiki.gwt.wysiwyg.client.diff.myers.DiffNode: Class org.xwiki.gwt.wysiwyg.client.diff.myers.DiffNode removed
309 org.xwiki.gwt.wysiwyg.client.diff.myers.MyersDiff: Class org.xwiki.gwt.wysiwyg.client.diff.myers.MyersDiff removed
310 org.xwiki.gwt.wysiwyg.client.diff.myers.PathNode: Class org.xwiki.gwt.wysiwyg.client.diff.myers.PathNode removed
311 org.xwiki.gwt.wysiwyg.client.diff.myers.Snake: Class org.xwiki.gwt.wysiwyg.client.diff.myers.Snake removed
312 org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncPlugin: Class org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncPlugin removed
313 org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncPluginFactory: Class org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncPluginFactory removed
314 org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncResult: Class org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncResult removed
315 org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncService: Class org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncService removed
316 org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncServiceAsync: Class org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncServiceAsync removed
317 org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncStatus: Class org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncStatus removed
318 org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncTools: Class org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncTools removed
319 org.xwiki.wysiwyg.server.plugin.sync.SyncEngine: Class org.xwiki.wysiwyg.server.plugin.sync.SyncEngine removed
320 org.xwiki.wysiwyg.server.plugin.sync.SyncException: Class org.xwiki.wysiwyg.server.plugin.sync.SyncException removed
321 {{/code}}
322 )))

About

About

Support

Platform

User Guide

Admin Guide

Developer Guide

Projects

XWiki

Extensions

Other

Contribute

Status

Practices

Under the Hood

Get Involved

Get Connected