Changes
==== Configuration Notes ====
'''Plugins'''<br>
The plugins needed for the injection folder can be fetched from the AdminTool package.
'''AppSettings'''<br>
Configure the AppSettings as usual for your environment.
'''Language Configuration'''<br>
Set the LanguageID according to the required language. This should be done via the AppSettings of the CONTENT webservice. Currently the following are supported:
* English - 1
</pre>
== 2. SQL Database Setup ==
[[File:DB_setting1.png]]
'''Data Path''': <br>Select a data path for your database.
'''Web Service Base Url''': <br>Enter the base URL of the web service. Example: If the URL to the content web service of Slot01 is eg. "https://dev.mycompany.net:888/UBIK/MATAP/Slot01/CONTENT/UBIKContent.svc" the base URL would be "https://dev.mycompany.net:888/UBIK/MATAP".
{{Hint|The MaTaP web services need to be structured in a certain way. The base URL/path can be chosen as liked. From there, a folder for every slot is needed (have to be called "Slot01", "Slot02", ...) and under each slot folder, there are the Content, Push and Usam folders containing the web service.}}
[[File:DB_setting2.png]]
== 3. Enable Recycle App Pool Functionality ==
As the recycling of application pools must be performed via the AdminTool, additional configuration steps are required.
=== Configuration of Properties ===
'''APPLICATION_POOL_NAME'''<br>
As the name suggests, this property must contain the exact name of the corresponding Application Pool.
'''CONTENT_SERVICE_URL'''<br>
This property should contain the URL path to the Content Webservice, like so: https://myserver:port/matap/slot01/CONTENT/UBIKContent.svc
Needed to import and view the data and execute other calculations
To connect to the database, you can either configure it manually in AdminTool or import an .smconnection file which can be then provided to others as well. An example of such an .smconnection file is listed below.
=== .smconnection Example ===
<pre>
<?xml version="1.0" encoding="utf-8"?>
=== Notes ===
'''RecordLifeTime'''<br>
Ensure that the RecordLifeTime is set to 10. If this value is not configured correctly, the refresh functionality in the AdminTool may not work properly when connected to the database.
'''Language'''<br>
Set the language according to your project configuration. Supported options are:
* German (de)
=== Notes ===
'''RepeateEveryMinutes'''<br>
No, RepeateEveryMinutes is not a typo – please don’t fix it otherwise it unfortunately won’t work.
'''Path to Json file'''<br>
Ensure to escape the Backslashes!
=== Configuration UBIK.EnterpriseService.config.exe ===
In order for the json files to be considered by the enterprise, the following changes need to be made in the respective Enterprise Service config:
<pre>
<add key="PluginExecutionConfigPath" value="C:\Path\Enterprise\json\MATAP.json" />
=== Executables ===
Copy and paste the already existing UBIK.EnterpriseService.BasicClient.App.exe + the UBIK.EnterpriseService.BasicClient.exe.config so you have three each and name them the following:
=== Notes ===
Ensure that the config ends with .exe.config, when copying and pasting the exe parts part sometimes gets removed which makes the config unusable.
=== Configuration RecalculateProjectJob.config.exe ===
=== Notes ===
It’s already defined in the configuration part but wanted to clarify that you must remove the content of the key PathToBasicEnterpriseServiceRequestJsonFileList, otherwise the value will be considered from the BasicClient exe.
=== Configuration UBIK.EnterpriseService.config.exe ===
In order for the BasicClient exe’s being executed accordingly, the following change needs to be made in the respective Enterprise config:
<pre>
<add key="ExecuteWebInterface" value="1" />
== 7. Windows Task Scheduler ==
* Create three tasks for each job
=== Configuration Tasks ===
For each task you must point to the respective BasicClient exe which was created in the steps above. This can be done via the tab Actions in the Task Scheduler when creating a task. The needed action is Start a program and below the path defined to the respective exe.
=== Execution Order ===
The timing of the jobs must be adapted as needed for the project use case, usually we plan them for the night when no one is working. The only thing that needs to be considered is the sequence which is the following.
# RecalculateProjectJob
# PublishCommissioningWallpaperJob
== 8. Multiple Slot Setup ==
If there is the need to create multiple slots for a project, some things must be considered. For each new slot webservice there is the need to create a new application, context and view.The respective MetaClasses for these can be found below.
=== Application Namespace ===
System.Matap.General.MATAPAPPLICATION
'''Note ''' <br>
Make sure to adapt the Application Pool Name and Content Service URL properties accordingly as described in point 3.
System.Matap.General.MATAPCONTEXT
'''Note ''' <br>
No need to configure everything, just use the template view (CTX_MATAP_TEMPLATE) to derivate from it.
Make sure to adapt to the correct slot in property SHOW_ON_WALLPAPER.
System.Matap.Content.MATAP_VIEW
'''Note ''' <br>
No need to configure everything, just use the template view (VIEW_MATAP_TEMPLATE) to derivate from it.
Make sure to adapt to the correct slot in property SHOW_ON_WALLPAPER.
== 9. Access to Clients ==
The client installation packages can be provided either by our project engineers or developers responsible for the MATAP product.
