Difference between revisions of "Injection Management"

Latest revision as of 14:18, 16 July 2026

The Injection Manamgent in UBIK^® features the possibility to extend the standard functionality of UBIK^® if necessary. The system can include project a/o customer specific implementations (like own Workflow activities) and supports a UBIK^® administrator to manage project a/o customer specific requirements.

Supported Applications

Following UBIK^® Applications support the Injection Management:

Supported Types

Two types of add-ons can be injected into UBIK^® via this Injection Management techique:

UBIK^® Plugin
UBIK^® Module
UBIK^® Studio Controls and Windows

An UBIK^® Plugin is intended to provide features on a rather low level (methods used within code, workflow activities, web service). The scope of a plugin should not cover additional structures (Metaclasses, Metaproperties, Classifications).

An UBIK^® Module can also include any kind of metastructures, additional to features as a UBIK^® Plugin. Hence, a UBIK^® Module is a much more comprehensive extension of the system.

Usage

Version 5.2.0+

"Add Plugins" Dialog

The Injection folder contained in the installation folder of the respective Server product is still supported, especially for custom plugins. However, all standard plugins are now shipped with the product and there is now the possibility to just select the required plugins using a dialog.

This "Add Plugins" dialog will be shown when connecting to a new database for the first time, and is accessible always via UBIK.Studio's Plugins dialog. When connecting to a database, UBIK^® will load all plugins previously selected in the dialog, and additionally everything from the Injection folder. This means, standard Plugins needn't be maintained manually in the Injection folder anymore.

Version Pre-5.2.0

Following folders are scanned for available plugins / modules:

[UBIK Installation Folder]\Injection
%LocalAppData%\Augmensys\UBIK\CUSTOM\[Project Folder]\Injection

These folders must be set in the privatePath parameter of the probing element in the config file:

The injection of plugins / modules requires that this folder is configured as probing path in the config file.

Loaded Plugins / Modules

A list of all currently loaded and available Plugins and Modules is shown in the View → Plugins dialog (UBIK^® Studio only).

@@ Line 1: / Line 1: @@
-Injection Management is available since Version 2.4.1.
+The Injection Manamgent in {{UBIK}} features the possibility to extend the standard functionality of {{UBIK}} if necessary. The system can include project a/o customer specific implementations (like own [[:Category:Activities|Workflow activities]]) and supports a {{UBIK}} administrator to manage project a/o customer specific requirements.
-The Injection Manamgent in UBIK provides the possibility to extend the standard functionality of UBIK on demand. This opens the system to include project a/o customer specific implementations (like project specific Workflow Activities). By using this feature, the UBIK admin gets the possibilty to solve project/customer specific problems.
 == Supported Applications ==
-Injection Management is supported by following UBIK Application:
+Following {{UBIK}} Applications support the Injection Management:
 * [[UBIK Studio Basics|Studio]]
-* [[Enterprise Server]]
+* [[Enterprise Service|Enterprise Service]]
 * [[Web Service]]
-== Supported Plugin types ==
+== Supported Types ==
-Following Plugin Types are supported:
+Two types of add-ons can be injected into {{UBIK}} via this Injection Management techique:
-* [[Create_UBIK_Workflow_Activity_Plugin|UBIK Workflow Activities]]
+* {{UBIK}} Plugin
+* {{UBIK}} Module
+* [[HowTo:Inject_UI_into_UBIK_Studio|{{UBIK}} Studio Controls and Windows]]
+An '''{{UBIK}} Plugin''' is intended to provide features on a rather low level (methods used within code, [[HowTo:Create_UBIK_Workflow_Activity_Plugin|workflow activities]], web service). The scope of a plugin should not cover additional structures (Metaclasses, Metaproperties, Classifications).
+An '''{{UBIK}} Module''' can also include any kind of metastructures, additional to features as a {{UBIK}} Plugin. Hence, a {{UBIK}} Module is a much more comprehensive extension of the system.
+== Usage ==
+=== Version 5.2.0+ ===
+[[File:AddPlugins_Studio.png|thumb|upright|220px|"Add Plugins" Dialog]]
+The Injection folder contained in the installation folder of the respective Server product is still supported, especially for custom plugins.
+However, all standard plugins are now shipped with the product and there is now the possibility to just select the required plugins using a dialog{{Version/ServerSince|5.2.0}}.
+This "Add Plugins" dialog will be shown when connecting to a new database for the first time, and is accessible always via UBIK.Studio's Plugins dialog.
+When connecting to a database, {{UBIK}} will load all plugins previously selected in the dialog, and additionally everything from the Injection folder.
+This means, standard Plugins needn't be maintained manually in the Injection folder anymore.
+<br clear="all" />
+=== Version Pre-5.2.0 ===
+Following folders are scanned for available plugins / modules:
+* '''[UBIK Installation Folder]\Injection'''
+* '''%LocalAppData%\Augmensys\UBIK\CUSTOM\[Project Folder]\Injection'''
-== Plugin Folders ==
+These folders must be set in the '''privatePath''' parameter of the '''probing''' element in the config file:
-Following folders are scanned for available plugins as default:
+<source lang="xml">
-* [UBIK Installation Folder]\Injection
+<runtime>
-* %LocalAppData%\Augmensys\UBIK\CUSTOM\[Project Folder]\Injection
+   <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
+      <probing privatePath="lib;Injection"/>
+   <assemblyBinding
+</runtime>
+</source>
-Additional folders can be added via the Config file.
+{{Attention|The injection of plugins / modules requires that this folder is configured as ''probing'' path in the config file.}}
-== Plugins ==
+== Loaded Plugins / Modules ==
-You cand find a list of all loaded Plugins in UBIK.Studio by accessing the Plugin Dialog (View | Plugins).
+A list of all currently loaded and available Plugins and Modules is shown in the ''[[Plugins|View &rarr; Plugins]]'' dialog ({{UBIK Studio}} only).
-If you are willing to find out how to create your own plugin:
+== See also ==
-[[Create_UBIK_Plugin|See here how to create your own Plugin]].
+* [[HowTo:Create_UBIK_Plugin|Create your own plugin]]
+* [[HowTo:Create_UBIK_Module|Create your own module]]
+* [[UBIK_Plugin_Design]]
+{{Category/Version|2.4.0}}
-[[Category:Injecting]]
+[[Category:2.4.0|Injection Management]]
+[[Category:Injecting|Injection Management]]
+[[Category:Server|Injection Management]]
+[[Category:Version 5.2|Injection Management]]