Difference between revisions of "Setting Up UBIK for CUI"

Revision as of 06:51, 1 September 2026

Setting up a UBIK Database for CUI Data Exchange

Instructions
Comos Project
Comos Login
Interface Admin Comos
Relation between Comos Project and Language

Instructions

To set up interfacing in a UBIK database you need the following configuration MetaClasses:

  •  (COMOS_PROJECT) Comos Project
  •  (COMOS_LOGIN) Comos Login
  •  (INTERFACE_ADMIN_COMOS) Interface Admin Comos
  •  (SYSREL_PROJECT_LANGUAGE) Comos Project <-> Language

Comos Project

The best approach is to go to the MetaClass COMOS_PROJECT and derive a new Metaclass. The reason is to create a MetaClass that is cut off from this SystemMetaClass, which could be changed during a UBIK update.

To find the MetaClass in UBIK^® where View set to „See all“ go to -> SYSROOT -> SYSTEMOBJECT -> COMOS_PROJECT

when View is set to „Content“ you can find it under Namespaces; go to -> {} Comos -> {} Comos.Interface ->COMOS_PROJECT

After assigning a name and description to the new MetaClass, please Save; then you can generate your setting by opening the MetaClass in a Bulk Editor and create a new Instance.

You can name and describe it as desired, but it is a good idea to use a name or description that is also in COMOS^®.

The Database ID is also the same as in COMOS^®, on the Project settings for Mobile Solutions, the Enterprise Server here is that one from UBIK^® like you set up the Notification Endpoint.

PROJECT_ID Comos Project SystemUID, WORKING_OVERLAY_ID Comos Working Overlay SystemUID is again form COMOS^®, PROJECT_ID is Mandatory anyway, if you want to connect with an WorkingOverly from Comos this ID is also needed.

The Registration folder is only needed when you want to use XML Files for Objects that are not Classified in COMOS^®.

Comos Login

Similar to COMOS_PROJECT go to MetaClass COMOS_LOGIN and derive a new Metaclass. The reason is to create a MetaClass that is cut off from this SystemMetaClass, which could be changed during a UBIK update.

To find the MetaClass in UBIK^® where View set to „See all“ go to -> SYSROOT -> SYSTEMOBJECT -> SERVICE_LOGIN -> BASICAUTH_SERVICE_LOGIN -> COMOS_LOGIN

when View is set to „Content“ you can find it under Namespaces; go to -> {} Comos -> {} Comos.Interface -> COMOS_LOGIN

After assigning a name and description to the new MetaClass, please Save; then you can generate you setting by opening the MetaClass in a Bulk Editor and create a new Instance.

You can name and describe it as desired, but it is a good idea to use a name or description that is also in COMOS^®.

You have to link an instance from COMOS_PROJECT or its children, so link here the Instance you created befor in the new Created COMOS_PROJECT Child Class,

with the checkbox "RESTAPI_PRE_AUTHENTICATE" you ask UBIK^® authenticates before sending data, depending on your system security requirements.

In Service URL you musst set the ComosWebstartPage URL, and user name and password for COMOS login (mostly Domain user)

Interface Admin Comos

Similar like before go to MetaClass INTERFACE_ADMIN_COMOS and derive a new Metaclass. The reason is to create a MetaClass that is cut off from this SystemMetaClass, which could be changed during a UBIK update.

To find the MetaClass in UBIK^® where View set to „See all“ go to -> SYSROOT -> INTERFACE_ADMIN_ROOT -> INTERFACE_ADMIN_COMOS

when View is set to „Content“ you can find it under Namespaces; go to -> {} Comos -> {} Comos.Interface -> {} Comos.Interface.Administration -> INTERFACE_ADMIN_COMOS

After assigning a name and description to the new MetaClass, don't forget to link to the Login Object please Save;

To Configure the Proxys that should be Imported and Exported please open the New InterfaceAdmin in a RelationEditor. Than drag an drop all the relevant Proxy to the Interface admin Object.

Relation between Comos Project and Language

Different to before RelationalClass SYSREL_PROJECT_LANGUAGE stays the SystemMetaClass.

To find the MetaClass in UBIK^® where View set to „See all“ go to -> RELATIONDATA -> SYSREL_PROJECT_LANGUAGE

when View is set to „Content“ you can find it under Namespaces; go to -> {} Comos -> {}Comos.Interface -> SYSREL_PROJECT_LANGUAGE

Please open the Class in a Bulk Editor;

To Create a new Instance set a Comos_Project Instance to LEFTUID and a Language Object to the RIGHTUID. Add the Microsoft LCID number for your Language. And also the Comos settings witch Language is the current Project, and User Default. The Languages from UBIK u find in To find the MetaClass in UBIK^® where View set to „See all“ go to -> SYSROOT -> INTERFACE_ADMIN_ROOT -> INTERFACE_ADMIN_COMOS when View is set to „Content“ you can find it under Namespaces; go to -> {}System -> {}System.Main -> {}System.Main.Language -> LANGUAGE -> {}System

@@ Line 52: / Line 52: @@
 You have to link an instance from COMOS_PROJECT or its children, so link here the Instance you created befor in the new Created COMOS_PROJECT Child Class,
-with the checkbox "RESTAPI_PRE_AUTHENTICATE" you ask {{UBIK}} to Authenticate before sending data, could be that System security is asking for this.
+with the checkbox "RESTAPI_PRE_AUTHENTICATE" you ask {{UBIK}} authenticates before sending data, depending on your system security requirements.
-In Service URL you have to give the Comos WebstartPage url, and User and Password for Comos login (mostly Domain user)
+In Service URL you musst set the ComosWebstartPage URL, and user name and password for COMOS login (mostly Domain user)
 [[File:New_Login.png|400px]]