Difference between revisions of "UBIK Studio Manual"

To add the newly created properties to a metaclass, drag the corresponding metaclass into the ClassDetails Editor. Then, drag the desired properties from CUSTOMMETAPROPERTY into the metaclass.

3. Creating SelectiveList and SelectiveItem

A SelectiveList provides a predefined list of selectable values that users can choose from instead of entering free text. Each individual entry in this list is reprexsented as a SelectiveItem. To add a list to a property, you must first switch to the Content View. Then, select Custom > List > SELECTIVELIST and drag it into a Bulk Editor (to access the Content View, switch to the "Content View" in the Class Browser – see screenshot). When creating the list, use the same data type as that of the corresponding Metaproperty.

To create SelectiveItems, navigate to Custom > List > SELECTIVEITEM and drag SELECTIVEITEM into a BulkEditor.

To add SelectiveItems to a list, the previously created list must be opened in a RelationEditor. To do this, for example, drag Custom->List->SELECTIVELIST->Custom->ANLEITUNG into the RelationEditor. Then, drag the SelectiveItems from the BulkEditor into the corresponding list.

To add the list to the property, select the previously created list in the SELECTIVELIST column of CUSTOMMETAPROPERTY.

4. Create References and Links

References define which object types a connection (link) may point to, while links, implemented as a property of type Guid, actually establish this connection between two instances. Both elements are required to model directed relationships between objects within the UBIK® data model, e.g. to point from one object to another without needing a fixed parent-child structure. To create a reference, navigate to Custom->Reference and drag Custom->Reference->REFERENCE into the BulkEditor (to access the content view, you must switch to the content area in the ClassBrowser). Then, specify the Name, Description, Namespace, and TargetType. When creating a new reference—for example, REF_ANLEITUNG—the corresponding metaclass ANLEITUNG must be set as the TargetType.

To create link properties, drag CUSTOMMETAPROPERTY into a BulkEditor. Select "Guid" as the data type. Then, assign the previously created reference—for example, REF_ANLEITUNG to the reference field.

The metaclass referenced by the link property must be dragged into a ClassDetails editor. Subsequently, the link property is assigned to the corresponding metaclass under MetaProperties.

5. Create View

To create ReferenceViewItems, drag Custom->View->REFERENCEVIEWITEM into a BulkEditor (To access the Content-View, switch to the Content area in the ClassBrowser).

Create a new instance of a ReferenceViewItem using the Bulk Editor. Specify the name of the reference property in the "Reference" cell. Select the "Reverse" checkbox if the ReferenceViewItem is to be evaluated in reverse (right-to-left) order. Assign a query instance of the ReferenceViewItem to the "Reversereftype" attribute—either by dragging and dropping a metaclass object onto the cell or by selecting the desired metaclass from the dialog box that appears when you double-click the field.

To add the ReferenceViewItem to the view, open the corresponding view in the RelationEditor: Custom -> View -> VIEW -> CUSTOM -> CUSTOM -> TEMPLATE -> VIE_01. The ReferenceViewItem can then be assigned to the view.

To correctly display data in hierarchical structures such as trees or nested lists, a view must retrieve the root objects (root elements) of the first level. This ensures that the view has the entry point for navigation and that child elements are referenced correctly. To create a RootObject, the MetaClass must be dragged into the BulkEditor. Then, an object can be created. This object must then be dragged onto the MetaClass in the Relation Editor.

6. Rebuild

To rebuild the customization, a rebuild process must be performed first. A rebuild recompiles all components of the UBIK data model, generates the required .NET assemblies and database objects, and ensures that all changes are applied consistently.

Once the rebuild is complete, first click the left icon (Syntax Check) and then the right icon (Compile and Release).

The program then restarts automatically.

7. View Test Environment

To test the Customizing, select the "View Test Environment" option from the Tools menu.

A window opens where the desired view can be selected from the drop-down menu. The root object should then be visible. A new object can be created by right-clicking on the object, though the triangle next to the name must be expanded first.

The properties can be edited in the newly opened window.

8. Scopes and display in the Client

Um die Inhalte im Client anzuzeigen, ist Custom->ACM->CONTEXT->CUSTOM->CUSTOM TEMPLATE zu öffnen. Anschließend kann der Context eingesehen werden (Um auf die Content-View zuzugreifen, muss im ClassBrowser auf den Bereich Content gewechselt werden).

Ubik Studio bietet einen Automatismus, der beim Erstellen der MetaClassScopes hilfreich ist. Um ihn zu nutzen, werden die MetaKlassen auf den Context gezogen. Nach dem Ziehen erscheint ein kleines Fenster mit der Option „Add fitting Scope to Context", welches ausgewählt wird. Danach öffnet sich die MetaClassScope – Configuration. Dort kann z.B. die Visibility oder der Lockstatus verändert werden. Wenn alles eingestellt ist, mit „OK" bestätigen. Diesen kann man in Custom->ACM->Scopes->METACLASSSCOPES einsehen.

Damit das Objekt später erzeugbar ist, wird der Default Context in den RelationEditor gezogen. Dort wird der ContextScope über das Plus-Symbol aufgeklappt und anschließend die Meta Class Scope ausgewählt. Es öffnet sich ein weiteres Fenster, in dem die Option „Creation enabled" aktiviert werden kann.

Alle Objekte/Klassen/Tasks/etc., die später im Client sichtbar sein sollen, müssen im Context enthalten sein. Um die Visibility der einzelnen Properties innerhalb der Scopes zu bearbeiten, wird der Default Context im RelationEditor benötigt. Dort wird der ContextScope aufgeklappt, anschließend das Plus-Symbol neben der gewünschten MetaClassScope geöffnet und die MetaProperties werden angezeigt. Beim Auswählen eines Properties öffnet sich ein neues Fenster, in dem die Visibility, der LockStatus, die Priorität und die SortOrder konfiguriert werden können.

9. Release Metadefinitions

Select Tools from the menu bar and then open the ACM Manager.

After opening the dialog window, two context areas are displayed: "Context objects" and "Custom Context objects." Only the "Custom Context objects" area is relevant for the subsequent steps. Expand the "Custom Context objects" area until the desired context is visible, and select it with a single mouse click. Then, perform the following actions in the toolbar in the order specified: Evaluate Temporary Meta Definitions -> Clear Released Meta Definitions (this icon appears only after the context has been successfully rebuilt at least once) -> Release Meta Definitions. Ensure that the actions are performed sequentially and in the specified order.

10. Create User

Custom->Main->User->LOGIN is dragged into a BulkEditor. Subsequently, the name and description can be specified, with the LoginName being populated automatically once the name has been entered.

11. Create Workpackages and Tasks

Navigate the hierarchy to "WORKPACKAGES MRO workpackages." Right-click this item and select "Derive new Object" to create a new metaclass for a new type of Workpackage [PF20.1][PF20.2]. The work package name can subsequently be adjusted in the ObjectEditor. The name should be entered in uppercase letters; the description field can be filled in as desired, and there is also an option to enable multilingual support. To create a new task, use "TASK MRO tasks." Again, right-click and select "Derive new object" to create the metaclass. The task type is determined by the data type; for example, a Texttask requires an additional value property of type "string," whereas a check task requires a value property of type "bool." This value property is then dragged from the CUSTOMMETAPROPERTIES onto the metaclass opened in the RelationEditor.

By deriving from the TASK MRO task, the task inherits the classification of the parent object. This classification determines the type assigned to the newly created task. You can view the required property in the Class Details; to do this, select the cube icon at the top. Then, open the "Task Classification Object"; color-coded markers (red and green) will indicate whether specific properties still need to be added.

12. Editors