Summary

• Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Author

...	...	@@ -1,1 +1,1 @@
1		-XWiki.LudovicDubost
	1	+XWiki.VincentMassol

Content

...	...	@@ -1,3 +1,7 @@
	1	+{{box cssClass="floatinginfobox" title="**Contents**"}}
	2	+{{toc/}}
	3	+{{/box}}
	4	+
1	1	XWiki is not just your average wiki engine; it exposes a flexible data model that can be leveraged at the presentation level. Combined with its powerful presentation level scripting capabilities, XWiki's data model can help you build simple to complex Web applications with little or no need to access the XWiki core. In other words, you can build custom applications through the XWiki web interface without having to compile, package, and deploy software components.
2	2
3	3	This area explains XWiki's data model of Classes, Properties, and Objects for those users who want to build applications primarily at the presentation level. It will help you understand how you can achieve significant features by programming at this level alone.
...	...	@@ -15,23 +15,26 @@
15	15	; Properties
16	16	: Properties are the characteristics that an object can have. In a class definition, the properties define the data fields that each unique instance of the class can have values for. Properties have displayers which control how the property value is displayed in view or edit mode. Some displayers use advanced pickers to help you input a valid property value.
17	17	: XWiki currently supports the following kinds of properties (data types):(((
18		-* //String// Allows to store and display one line texts
19		-* //TextArea// Allows to store and display large text fields (text and wysiwyg)
20		-* //Number//: Allows to store and display Numbers of type integer,long,float,double
21		-* //Password// Allows to store password fields which can be encrypted or hashed
22		-* //EMail// (new in 4.2M3) Allows to store email fields that can be obfuscated at display time
23		-* //Boolean// Allows to store and display boolean values (yes/no or 1/0) which can be displayed as select or checkbox fields
24		-* //Static List// Allows to store and display single-select or multi-select fields that can be displayed as select, checkbox, radio or suggests fields. The possible values of static list fields are configured in the field definition.
25		-* //Database List// Allows to store and display single-select or multi-select fields that can be displayed as select, checkbox, radio or suggests fields. The possible values of static list fields are taken from a query from other XWiki data.
26		-* //Database Tree List// Same as before, with the addition that the data can be displayed as a tree, using the Yahoo Javascript Tree library
27		-* //Document List// (new in 4.2M3) Same as a String field, but made to store XWiki page names.
28		-* //Date// Allows to store and display date or datetime values. A date picker is used automatically for this field as shown below.
29		-{{image reference="datePicker.png"/}}
30		-* //User List// Allows to store and display single-select or multi-select users. The field uses a user picker as shown below.
31		-{{image reference="userPicker-editSingle-objectEditor.png"/}} {{image reference="userPicker-editMultiple.png"/}} {{image reference="userPicker-viewMultiple.png"/}}
32		-* //Group List// Allows to store nd display single-select or multi-select groups. The field uses a user picker as shown below.
33		-{{image reference="groupPicker-editMultiple.png"/}}
34		-* //Computed pseudofield// (new in 4.2M3) Allows to create a pseudo field for which the display can be configured using a script. It allows to combine other fields together.
	22	+
	23	+|= Field Type |= Since version |= Description |= Screenshots
	24	+| //String// | | Allows to store and display one line texts |
	25	+| //TextArea// | | Allows to store and display large text fields (text and wysiwyg)|
	26	+| //Number// | | Allows to store and display Numbers of type integer,long,float,double|
	27	+| //Password// | | Allows to store password fields which can be encrypted or hashed |
	28	+| //EMail// | new in 4.2M3 | Allows to store email fields that can be obfuscated at display time |
	29	+| //Boolean// | | Allows to store and display boolean values (yes/no or 1/0) which can be displayed as select or checkbox fields |
	30	+| //Static List// | | Allows to store and display single-select or multi-select fields that can be displayed as select, checkbox, radio or suggests fields. The possible values of static list fields are configured in the field definition.
	31	+| //Database List// | | Allows to store and display single-select or multi-select fields that can be displayed as select, checkbox, radio or suggests fields. The possible values of static list fields are taken from a query from other XWiki data.|
	32	+| //Database Tree List// | | Same as a Database List field, with the addition that the data can be displayed as a tree, using the Yahoo Javascript Tree library |
	33	+| //Document List// | new in 4.2M3 | Same as a String field, but made to store XWiki page names. |
	34	+| //Date// | | Allows to store and display date or datetime values. A date picker is used automatically for this field as shown below. |(((
	35	+{{image reference="datePicker.png"/}})))
	36	+| //User List// | | Allows to store and display single-select or multi-select users. The field uses a user picker as shown below.|(((
	37	+{{image reference="userPicker-editSingle-objectEditor.png"/}} {{image reference="userPicker-editMultiple.png"/}} {{image reference="userPicker-viewMultiple.png"/}} )))
	38	+| //Group List// | | Allows to store and display single-select or multi-select groups. The field uses a user picker as shown below.|(((
	39	+{{image reference="groupPicker-editMultiple.png"/}})))
	40	+| //Computed pseudofield// | new in 4.2M3 |Allows to create a pseudo field for which the display can be configured using a script. It allows to combine other fields together.|
	41	+
35	35	)))
36	36	: Starting with version 4.3M2 you can define [[your own property types>>CreatingNewXClassPropertyTypes]].
37	37
...	...	@@ -45,3 +45,10 @@
45	45	* Classes define an object type and the properties that are possible for an object of that type to have.
46	46	* Properties define the types of data that unique objects can have. The property types (datatypes) are defined for the class, but the actual values for the properties are defined for the objects when the objects are instantiated from the class.
47	47	* Objects are unique instances of a class with unique values for all of the properties that the class definition allows the objects to have.
	55	+
	56	+= Suggested Reading =
	57	+
	58	+* Armed with your knowledge of Classes and Objects you could try creating a small application, such as a FAQ application, by following this [[FAQ Tutorial>>FAQTutorial]].
	59	+* You could also start understanding how to display properties of Objects in wiki pages by using [[Scripting]].
	60	+* You could also try using the [[App Within Minutes extension>>extensions:Extension.App Within Minutes Application]] which simplifies how to get started developing an application with little required knowledge. After your application is generated, if you wish to go further and develop new features for your app, you'll need to use your knowledge about Classes, Objects and [[Scripting]].
	61	+