Difference between revisions of "HowTo:Create a new MetaProperty"
(→VALUE TYPE) |
|||
| (20 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
== Creation of a new MetaProperty == | == Creation of a new MetaProperty == | ||
| − | A new [[MetaProperty]] has to be created as an instance from [[ | + | A new [[MetaProperty]] has to be created as an instance from [[CUSTOMMETAPROPERTY]] using the ''[[Bulk Editor]]'' control |
# Navigate to the MetaClass [[CUSTOMMETAPROPERTY]] | # Navigate to the MetaClass [[CUSTOMMETAPROPERTY]] | ||
| Line 7: | Line 7: | ||
# It is recommenmded to set at least the description and namespace | # It is recommenmded to set at least the description and namespace | ||
# Save the changes with {{key press|Ctrl|S}} or the save command | # Save the changes with {{key press|Ctrl|S}} or the save command | ||
| + | |||
| + | ===VALUE TYPE=== | ||
| + | {{Version/WinXSince|4.7.0}} Since Version 4.7 we support the possibility to define the value type of a property. | ||
| + | |||
| + | With this property, the customizer can control how the property is displayed on the client. | ||
| + | |||
| + | Possible values are: | ||
| + | * Standard (default) | ||
| + | * MinNormMax (supported for string, double and int properties) | ||
| + | * MinMax (supported for string, double and int properties) | ||
| + | |||
| + | [[Category:How-To|Create a new MetaProperty]] | ||
| + | [[Category:Studio|Create a new MetaProperty]] | ||
== Optional Attributes == | == Optional Attributes == | ||
| Line 13: | Line 26: | ||
Assign a reference if the value of the property should link to an {{UBIK}} object. The data type of the MetaProperty has to be ''Guid'' that the data (guid) can hold a reference to an {{UBIK}} object. | Assign a reference if the value of the property should link to an {{UBIK}} object. The data type of the MetaProperty has to be ''Guid'' that the data (guid) can hold a reference to an {{UBIK}} object. | ||
| − | # Locate an existing or create a new | + | # Locate an existing or [[HowTo:Create_a_new_Reference|create a new Reference]] |
| − | # Assign the reference to the REFERENCE | + | # Assign the reference to the '''REFERENCE''' property either by |
#* dragging and dropping the reference object onto the cell | #* dragging and dropping the reference object onto the cell | ||
#* selecting the desired reference from the dialog appearing after double-clicking the cell | #* selecting the desired reference from the dialog appearing after double-clicking the cell | ||
| Line 22: | Line 35: | ||
Assign a selective list to a property, if the respective column should display a Combobox with all items of the list instead of the value field. The value can then only be selected from the list, but not be edited manually anymore. | Assign a selective list to a property, if the respective column should display a Combobox with all items of the list instead of the value field. The value can then only be selected from the list, but not be edited manually anymore. | ||
| − | # Locate an existing or create a new | + | # Locate an existing or [[HowTo:Create_a_new_Selective_List|create a new Selective List]] |
| − | # Assign the list to the SELECTIVELIST | + | # Assign the list to the '''SELECTIVELIST''' property either by |
#* dragging and dropping the list object onto the cell | #* dragging and dropping the list object onto the cell | ||
#* selecting the desired list from the dialog appearing after double-clicking the cell | #* selecting the desired list from the dialog appearing after double-clicking the cell | ||
| Line 29: | Line 42: | ||
=== UNITITEM === | === UNITITEM === | ||
[[File:IL_HowTo_CreateMetaProperty_UnitItem_01.png|thumb|alt=Set a unit item|Set a unit item]] | [[File:IL_HowTo_CreateMetaProperty_UnitItem_01.png|thumb|alt=Set a unit item|Set a unit item]] | ||
| − | + | If the property should consider a [[Unit]] (for example Ampere, Volt, etc.) the underlying [[MetaProperty]] has to incorporate a [[UNITITEM|Unit Item]] either by | |
* dragging and dropping the unit item object onto the cell | * dragging and dropping the unit item object onto the cell | ||
* selecting the desired unit item from the dialog appearing after double-clicking the cell | * selecting the desired unit item from the dialog appearing after double-clicking the cell | ||
| + | |||
| + | {{Hint|Only properties of type Double can posses measuring units!}} | ||
=== FORMAT === | === FORMAT === | ||
| Line 52: | Line 67: | ||
=== NEEDSVALIDATION === | === NEEDSVALIDATION === | ||
| − | Enable [[ | + | Enable [[MetaProperty#Needs_Validation|validation]] by checking the '''NEEDSVALIDATION''' attribute of the MetaProperty and let the system explicitely store a validation time stamp information in the database. This is particularly used on the mobile client in combination with the [[SYSCLS_TASK]] and [[SYSCLS_MEASUREMENTTASK]] classification. |
| + | |||
| + | {{Attention|'''NEEDSVALIDATION''' is replaced by UBIK Attribute technique since Version 2.5!}} | ||
| + | Learn more about [[UBIK Attributes]]. | ||
=== VALUEVALIDATION === | === VALUEVALIDATION === | ||
| − | Assign a [[Value_Validation|value validation]] object to the VALUEVALIDATION attribute of the MetaProperty either by | + | Assign a [[MetaProperty#Value_Validation|value validation]] object to the '''VALUEVALIDATION''' attribute of the MetaProperty either by |
* dragging and dropping the validation object onto the cell | * dragging and dropping the validation object onto the cell | ||
* selecting the desired validation object from the dialog appearing after double-clicking the cell | * selecting the desired validation object from the dialog appearing after double-clicking the cell | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
==See also== | ==See also== | ||
| − | * [[Create a new MetaClass]] | + | * [[HowTo:Create a new MetaClass]] |
* [[MetaProperty]] | * [[MetaProperty]] | ||
| − | [[Category:How-To]] | + | [[Category:How-To|Create a new MetaProperty]] |
| − | [[Category: | + | [[Category:Studio|Create a new MetaProperty]] |
Latest revision as of 16:32, 1 February 2024
Contents
Creation of a new MetaProperty
A new MetaProperty has to be created as an instance from CUSTOMMETAPROPERTY using the Bulk Editor control
- Navigate to the MetaClass CUSTOMMETAPROPERTY
- Create a new instance of CUSTOMMETACLASS by entering a name
- Set the data type for the property
- It is recommenmded to set at least the description and namespace
- Save the changes with Ctrl+S or the save command
VALUE TYPE
Since Version 4.7 we support the possibility to define the value type of a property.
With this property, the customizer can control how the property is displayed on the client.
Possible values are:
- Standard (default)
- MinNormMax (supported for string, double and int properties)
- MinMax (supported for string, double and int properties)
Optional Attributes
REFERENCE
Assign a reference if the value of the property should link to an UBIK® object. The data type of the MetaProperty has to be Guid that the data (guid) can hold a reference to an UBIK® object.
- Locate an existing or create a new Reference
- Assign the reference to the REFERENCE property either by
- dragging and dropping the reference object onto the cell
- selecting the desired reference from the dialog appearing after double-clicking the cell
SELECTIVELIST
Assign a selective list to a property, if the respective column should display a Combobox with all items of the list instead of the value field. The value can then only be selected from the list, but not be edited manually anymore.
- Locate an existing or create a new Selective List
- Assign the list to the SELECTIVELIST property either by
- dragging and dropping the list object onto the cell
- selecting the desired list from the dialog appearing after double-clicking the cell
UNITITEM
If the property should consider a Unit (for example Ampere, Volt, etc.) the underlying MetaProperty has to incorporate a Unit Item either by
- dragging and dropping the unit item object onto the cell
- selecting the desired unit item from the dialog appearing after double-clicking the cell
 | Only properties of type Double can posses measuring units! |
FORMAT
INDEXCOUNT
Set the number of named index keys, for example to 4.
INDEXKEYS
Enter the index keys as a comma separated list of strings, for example "a,b,c,d" (INDEXCOUNT = 4).
DEFAULTVALUE
Set up to 10 default value(s) for the MetaProperty.
INITIALVALUE
Set up to 10 initial value(s) for the MetaProperty.
CATEGORY
If desired change the category of the MetaProperty to a value of the list. The property will then be moved to a new tab if the object is viewed in the View Test Environment or using the Object Editor.
NEEDSVALIDATION
Enable validation by checking the NEEDSVALIDATION attribute of the MetaProperty and let the system explicitely store a validation time stamp information in the database. This is particularly used on the mobile client in combination with the SYSCLS TASK and SYSCLS MEASUREMENTTASK classification.
 | 'NEEDSVALIDATION' is replaced by UBIK Attribute technique since Version 2.5! |
Learn more about UBIK Attributes.
VALUEVALIDATION
Assign a value validation object to the VALUEVALIDATION attribute of the MetaProperty either by
- dragging and dropping the validation object onto the cell
- selecting the desired validation object from the dialog appearing after double-clicking the cell
