Jump to: navigation, search

Difference between revisions of "METACLASSSCOPE"


(Priority)
 
(23 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
__NOTOC__
 
{{MetaClassInfoBox
 
{{MetaClassInfoBox
 
| title = MetaClass Scope
 
| title = MetaClass Scope
 
| name = METACLASSSCOPE
 
| name = METACLASSSCOPE
| internalname = MetaClassScope
+
| internalname = SystemObjects.{{PAGENAME}}
| namespace = System.ACM.Scopes<br/>Custom.ACM.Scopes
+
| namespace = System.ACM.Scopes
 
| image = [[File:SY_METACLASSSCOPE.png|220px]]
 
| image = [[File:SY_METACLASSSCOPE.png|220px]]
 
| imagecaption = MetaClass Scope
 
| imagecaption = MetaClass Scope
 
| purpose = Configure context scopes for MetaClasses
 
| purpose = Configure context scopes for MetaClasses
 
| version = 2.1.13+
 
| version = 2.1.13+
 +
| typestring = UBIK.Kernel.MetaClass
 +
| runtimetype = UBIK.Content.ACM.MetaClassScope
 
}}
 
}}
 
 
A MetaClassScope specifies the published meta data (MetaClass and MetaProperties) which should be accessible on the mobile device. Further, it is possible to configure the permissions granted on those objects on the mobile.
 
A MetaClassScope specifies the published meta data (MetaClass and MetaProperties) which should be accessible on the mobile device. Further, it is possible to configure the permissions granted on those objects on the mobile.
  
The system tries to load the most accurate MetaClassScope object, where the MetaClass of the current object serves as filter criterion. If the system can not directly locate a proper MetaClassScope it searches up the inheritance hierarchy to find the most suitable.
+
If an object is published to the client the {{Web Service}} tries to load the most accurate MetaClassScope corresponding to the object's MetaClass. If no MetaClass scope for exactely that MetaClass can be located the system looks up the inheritance hierarchy (regarding the data model) if it can find a suitable one.
  
== Configuration ==
+
== Own Properties ==
=== MetaClassScope ===
+
The '''Metaclass''' property of an instance references to the according MetaClass (see [[Create a new MetaClassScope]]).
+
 
+
=== MetaProperties ===
+
* '''Initial value''': configure specific [[MetaProperty#Initial_value|initial values]]
+
* '''Priority''': set a priority value, e.g. used in combination with the Measurement Task Classification
+
* '''Write enabled''': property value can be changed by the mobile user
+
* '''Visibility''': set the [[visibility]] of the property
+
* '''Sort order''': set how the property should be sorted
+
 
+
==== Priority ====
+
 
{| class="wikitable" width=50%
 
{| class="wikitable" width=50%
 
|-
 
|-
! width=30% | Value !! Comment
+
! width=30% | Name !! width=20% | Data type !! width=10% | Optional !! Comment
 
|-
 
|-
| >120 || Property is shown in the pop-up dialog if the object is classified as [[SYSCLS_TASK]]
+
| METACLASS || Guid || no || Reference to the according MetaClass
 +
|-
 +
| DELETE_CONFIG|| Integer || no || Possibility to configure the delete behavior when a instance of the defined MetaClass gets deleted via the ACM (Web Service)
 
|}
 
|}
  
==== Visibility ====
+
 
 +
== Classifications ==
 +
If a MetaClass implements a certain classification the MetaClassScope must publish all required MetaProperties as declared by the classification. Only then the classification is known on the mobile client.
 +
 
 +
== Icons ==
 +
For deploying MetaClass specific icons it is necessary to create an own MetaClassScope for each MetaClass. Otherwise, the system will always deliver the icon of the most suitable MetaClassScope fitting a parent's MetaClass.
 +
 
 +
== Delete Configuration ==
 +
The Delete Configuration gives the possibility to configure whether an instance of the configured MetaClass may be deleted via ACM.
 +
 
 
{| class="wikitable" width=50%
 
{| class="wikitable" width=50%
 
|-
 
|-
! width=30% | Value !! Comment
+
! width=30% | Setting !! width=70% | Description
 
|-
 
|-
| Visible || Property will always be shown on the mobile device
+
| NotDeleteable || Deletion of an instance of the configured MetaClass via the WebService is not supported
 
|-
 
|-
| Hidden || Property will only be shown on the mobile device if [[UBIK_Client_Basics#Options|ShowSystemProperties]] is set to true
+
| RemoveFromOwner || Deletion of an instance is possible via the WebService. The instance will be removed from its owner (the relation/reference will be deleted) but the instance itself will not be deleted from the database.
 +
|-
 +
| Deleteable || Deletion of an instance of the configured MetaClass via the WebService is not supported and the deleted object will get totally be removed from Ubik  (will get deleted in the database).
 
|}
 
|}
 
==== Classifications ====
 
If a MetaClass implements a certain classification the MetaClassScope must publish all required MetaProperties as declared by the classification. Only then the classification is known on the mobile client.
 
  
  
 +
== See also ==
 +
* [[HowTo:Assign an Icon to a MetaClass]]
  
=== Icons ===
+
[[Category:Context scope|METACLASSSCOPE]]
For deploying MetaClass specific icons it is necessary to create an own MetaClassScope for each MetaClass. Otherwise, the system will always deliver the icon of the most suitable MetaClassScope fitting a parent's MetaClass.
+
[[Category:Metaclasses|METACLASSSCOPE]]
 
+
[[Category:System MetaClasses]]
+
[[Category:Context Scopes]]
+

Latest revision as of 12:17, 29 September 2015

IC METACLASS.gif MetaClass Scope
Name METACLASSSCOPE
Namespace System.ACM.Scopes
Internal Name SystemObjects.METACLASSSCOPE
TypeString UBIK.Kernel.MetaClass
RuntimeType UBIK.Content.ACM.MetaClassScope
Purpose Configure context scopes for MetaClasses
Version 2.1.13+

A MetaClassScope specifies the published meta data (MetaClass and MetaProperties) which should be accessible on the mobile device. Further, it is possible to configure the permissions granted on those objects on the mobile.

If an object is published to the client the Web Service tries to load the most accurate MetaClassScope corresponding to the object's MetaClass. If no MetaClass scope for exactely that MetaClass can be located the system looks up the inheritance hierarchy (regarding the data model) if it can find a suitable one.

Own Properties

Name Data type Optional Comment
METACLASS Guid no Reference to the according MetaClass
DELETE_CONFIG Integer no Possibility to configure the delete behavior when a instance of the defined MetaClass gets deleted via the ACM (Web Service)


Classifications

If a MetaClass implements a certain classification the MetaClassScope must publish all required MetaProperties as declared by the classification. Only then the classification is known on the mobile client.

Icons

For deploying MetaClass specific icons it is necessary to create an own MetaClassScope for each MetaClass. Otherwise, the system will always deliver the icon of the most suitable MetaClassScope fitting a parent's MetaClass.

Delete Configuration

The Delete Configuration gives the possibility to configure whether an instance of the configured MetaClass may be deleted via ACM.

Setting Description
NotDeleteable Deletion of an instance of the configured MetaClass via the WebService is not supported
RemoveFromOwner Deletion of an instance is possible via the WebService. The instance will be removed from its owner (the relation/reference will be deleted) but the instance itself will not be deleted from the database.
Deleteable Deletion of an instance of the configured MetaClass via the WebService is not supported and the deleted object will get totally be removed from Ubik (will get deleted in the database).


See also