Version 15.1 by Caleb James DeLisle on 2012/05/18

Show last authors
1 (% style="font-size:x-large;" %)
2
3 {{box cssClass="floatinginfobox" title="**Contents**"}}
4 {{toc/}}
5 {{/box}}
6
7 This is the first milestone of the XWiki Enterprise 4.1 version ([[Roadmap>>Main.Roadmap]]). This release brings new 3D graphs made with pure XWiki syntax, safer Groovy scripting, and better hiding of internal application related documents.
8
9 = New and Noteworthy (since XWiki Enterprise 4.0 version) =
10
11 == 3D Charting ==
12
13 We've [[added 2 new types of charts>>extensions:Extension.Chart Macro]], **bar3D** and **line3D**, which draw 3D charts.
14
15 For example the following code:
16
17 {{code}}
18 {{chart type='bar3D' source='inline' params='range:B2-B9;series:columns'}}
19 |=Date|=Value
20 |2012-02-21|1.97
21 |2012-02-26|2.96
22 |2012-03-04|3.93
23 |2012-03-11|4.84
24 |2012-03-18|5.83
25 |2012-03-25|4.5
26 |2012-04-01|3.85
27 |2012-04-08|4.87
28 {{/chart}}
29 {{/code}}
30
31 Will be rendered as this:
32
33 [[image:chart-example.png]]
34
35 == Hide Technical Documents ==
36
37 This effort was started in XWiki 4.0. However in 4.0 we had only implemented the technical solution to mark documents as hidden but we didn't get the time to use it. Now in 4.1 we've marked a lot of documents as Technical and we've modified a lot of UI screens to only display technical documents for users who ask for it.
38
39 Specifically there's a User Profile preference that you can set if you wish to see technical documents:
40
41 {{image reference="hidetechnicaldocuments.png"/}}
42
43 More precisely, the following was implemented:
44 * Mark a lot of documents as technical documents in the default XWiki Enterprise XAR
45 * Filter hidden documents from Lucene search results
46 * Filter hidden documents from database search results
47 * Filter hidden documents from default panels
48 * Filter hidden documents in REST APIs
49 * Filter hidden documents in LiveTable results
50
51 As a consequence, by default, a user will only about 24 documents out of 300+ that exist in the default XWiki Enterprise XAR, making it a lot nicer and simpler to apprehend.
52
53 == Improvements to the Extension Manager ==
54
55 The following improvements were made:
56 * Performance improved by several order of magnitude
57 * Install/Uninstall extensions asynchronously
58 * Improve the display of extension install/uninstall plan
59
60 TODO: Add sceenshots
61
62 == Taming of Groovy scripts ==
63
64 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.
65
66 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.
67
68 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.
69
70 To enable and test this feature read the [[configuration guide>>platform:AdminGuide.Configuration||anchor="HSecuringGroovyScripts"]].
71
72 === Compilation customizers ===
73
74 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
75
76 === Stop run-away Groovy scripts after a configurable timeout ===
77
78 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:
79
80 {{code language="none"}}
81 groovy.compilationCustomizers=timedinterrupt
82 groovy.customizer.timedInterrupt.timeout=10
83 {{/code}}
84
85 == New support for "short form" HQL queries in the query manager ==
86
87 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:
88
89 {{code language="none"}}
90 select doc.fullName from XWikiDocument as doc where doc.creationDate > '2008-01-01'
91 {{/code}}
92
93 == For developers ==
94
95 * New rendering compatibility test suite to make testing easier and simplify implementation of new syntax renderers. The compatibility report can be found here: http://rendering.xwiki.org/xwiki/bin/view/Main/SyntaxReport
96
97 * New API for upgrading installed XWiki Extensions.
98
99 = Bug fixes and improvements =
100
101 * Fixed wrong calculation of IDs for stats values making it impossible to upgrade a wiki to version 4.0 if statistics collection is enabled.
102 * Faster first startup time by not running a database migration when it is not needed.
103 * Simplify reverse proxy setup by making all HTTP redirects use relitive URLs.
104 * Add support for bold, italic and monospace in the TeX Renderer
105 * Was impossible to delete then recreate a subwiki with the same name, fixed.
106 * Fixed Javascript error when scrolling over Search Suggest results in Internet Explorer 6.
107 * Trying to change a document's parent from the REST service resulted in an error, fixed.
108 * It is now possible for non-administrators to execute cross-wiki XWQL queries.
109
110
111 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.1-milestone-1%22&tempMax=1000]] fixed in this release.
112
113 == For Developers ==
114
115 * Move ComponentManager deprecated methods to Legacy modules
116 * New Groovy module in xwiki-commons
117 * Add legacy module structure for XWiki Rendering
118 * Have one Maven module per XWiki Rendering syntax
119 * Separate Event Syntax from Rendering API by moving it to a Syntax module
120 * Plain syntax and Event syntax have been moved out of Rendering API nto their own modules.
121
122
123 == Upgrades ==
124
125 The following dependencies have been upgraded:
126
127 * Tika 1.1
128 * JGroups 3.0.10
129 * Pygments 1.5
130 * Selenium 2.21
131 * Maven AspectJ Plugin 1.4
132 * commons-io 2.3
133 * Maven Shade plugin 1.6
134
135 = Test Report =
136
137 You can check the [[manual test report>>TestReports.ManualTestReportXE41M1]] to learn about what was tested and the results on various browsers.
138
139 == Tested Browsers ==
140
141 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]]):
142
143 {{browser name='firefox' version= '12.0.1'/}}
144
145 = Known issues =
146
147 * [[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]]
148
149 = General Notes =
150
151 {{info}}
152 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.
153 {{/info}}
154
155 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above.
156
157 {{warning}}
158 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.
159 {{/warning}}
160
161 == API Breakages ==
162
163 The following APIs were modified since version 4.0:
164
165 {{code language="none"}}
166 org.xwiki.query.QueryFilter: Method 'public java.util.List filterResults(java.util.List)' has been added to an interface
167 org.xwiki.gwt.wysiwyg.client.Images: Method 'public com.google.gwt.resources.client.ImageResource sync()' has been removed
168 org.xwiki.gwt.wysiwyg.client.Strings: Method 'public java.lang.String sync()' has been removed
169 org.xwiki.gwt.wysiwyg.client.diff.AddDelta: Class org.xwiki.gwt.wysiwyg.client.diff.AddDelta removed
170 org.xwiki.gwt.wysiwyg.client.diff.ChangeDelta: Class org.xwiki.gwt.wysiwyg.client.diff.ChangeDelta removed
171 org.xwiki.gwt.wysiwyg.client.diff.Chunk: Class org.xwiki.gwt.wysiwyg.client.diff.Chunk removed
172 org.xwiki.gwt.wysiwyg.client.diff.DeleteDelta: Class org.xwiki.gwt.wysiwyg.client.diff.DeleteDelta removed
173 org.xwiki.gwt.wysiwyg.client.diff.Delta: Class org.xwiki.gwt.wysiwyg.client.diff.Delta removed
174 org.xwiki.gwt.wysiwyg.client.diff.Diff: Class org.xwiki.gwt.wysiwyg.client.diff.Diff removed
175 org.xwiki.gwt.wysiwyg.client.diff.DiffAlgorithm: Class org.xwiki.gwt.wysiwyg.client.diff.DiffAlgorithm removed
176 org.xwiki.gwt.wysiwyg.client.diff.DiffException: Class org.xwiki.gwt.wysiwyg.client.diff.DiffException removed
177 org.xwiki.gwt.wysiwyg.client.diff.DifferentiationFailedException: Class org.xwiki.gwt.wysiwyg.client.diff.DifferentiationFailedException removed
178 org.xwiki.gwt.wysiwyg.client.diff.PatchFailedException: Class org.xwiki.gwt.wysiwyg.client.diff.PatchFailedException removed
179 org.xwiki.gwt.wysiwyg.client.diff.Revision: Class org.xwiki.gwt.wysiwyg.client.diff.Revision removed
180 org.xwiki.gwt.wysiwyg.client.diff.RevisionVisitor: Class org.xwiki.gwt.wysiwyg.client.diff.RevisionVisitor removed
181 org.xwiki.gwt.wysiwyg.client.diff.SimpleDiff: Class org.xwiki.gwt.wysiwyg.client.diff.SimpleDiff removed
182 org.xwiki.gwt.wysiwyg.client.diff.ToString: Class org.xwiki.gwt.wysiwyg.client.diff.ToString removed
183 org.xwiki.gwt.wysiwyg.client.diff.myers.DiffNode: Class org.xwiki.gwt.wysiwyg.client.diff.myers.DiffNode removed
184 org.xwiki.gwt.wysiwyg.client.diff.myers.MyersDiff: Class org.xwiki.gwt.wysiwyg.client.diff.myers.MyersDiff removed
185 org.xwiki.gwt.wysiwyg.client.diff.myers.PathNode: Class org.xwiki.gwt.wysiwyg.client.diff.myers.PathNode removed
186 org.xwiki.gwt.wysiwyg.client.diff.myers.Snake: Class org.xwiki.gwt.wysiwyg.client.diff.myers.Snake removed
187 org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncPlugin: Class org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncPlugin removed
188 org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncPluginFactory: Class org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncPluginFactory removed
189 org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncResult: Class org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncResult removed
190 org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncService: Class org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncService removed
191 org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncServiceAsync: Class org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncServiceAsync removed
192 org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncStatus: Class org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncStatus removed
193 org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncTools: Class org.xwiki.gwt.wysiwyg.client.plugin.sync.SyncTools removed
194 org.xwiki.wysiwyg.server.plugin.sync.SyncEngine: Class org.xwiki.wysiwyg.server.plugin.sync.SyncEngine removed
195 org.xwiki.wysiwyg.server.plugin.sync.SyncException: Class org.xwiki.wysiwyg.server.plugin.sync.SyncException removed
196 {{/code}}

Get Connected