Last modified on 16 May 2024, at 08:50

Entry Points & Use Cases

Wiki Under Construction Start.PNG

Entry Points

To display various data in the Admin Tool, we have the following Entry Points with Use Cases under them:

00 - All Important


Under Entry Point 00 - All Important are the following Use Cases:

  • All Icons: Displays all icons that have already been created / set up.”
  • Job Runs: Displays all jobs that have been initialized for all turnaround projects.
  • Turnaround Project: Shows all Turnaround Projects in the database. It is important for the execution of jobs.

01 - All Other


For the 01 - All Other Entry Point, its Use Cases show all Data, regardless of whether instances are Templates or belong to a Project or not. Under Entry Point 01 - All Other, there are the following Use Cases:

  • Activity Codes
  • Commissioning Codes
  • Commissioning Packages
  • Commissioning Tasks
  • Companies
  • Daily HSE
  • Daily Meetings
  • Equipment Groups
  • Equipment Types
  • Equipment’s
  • Execution Documents
  • Functional Locations
  • Functionalities
  • Material
  • Media
  • Notifications
  • Operations
  • Plants
  • Plot Plans
  • Predefined Filters
  • Predefined Views
  • Preparation Documents
  • Punchpoint Attachments
  • Punchpoints
  • Quick Access Items
  • Reports
  • Scope Change attachments
  • Scope Changes
  • Subsystems
  • Systems
  • Timesheets
  • Users
  • Workorders
  • Zones

02 - Templates


The Use Cases under this entry point are for displaying data that is only marked as a template. By default, there are already pre-made Use Cases for displaying template data, which are the following:

  • Activity Codes
  • Commissioning Codes
  • Equipment Group
  • Equipment Type
  • Functionalities
  • Users

Turnaround Project

Project-specific Entry Points

These entry points display data that belongs to the respective project. For example, if the TurnaroundProjectCreationJob is executed for a Turnaround Project, there will be a new Entry Point created for this Turnaround Project. All Use Cases under such an entry point only display instances belonging to this specific project. There is also a difference between the TA Project Entry Points and the 01 - All Other, in that the TA Project Entry Point has one more use case, the Turnaround Project Use Case. This use case displays only the Turnaround Project in which it has been opened.


Use Cases


Under this use case, it is possible to create icons, which can then be assigned to Contractors / Companies.


MatapIcons.png


To be able to upload a photo, the name and description properties must be filled out and press “Enter”. Then a double click has to be made on the instances "Icon" property (without a sign on the left side) and then on the button with the three dots. After that a Windows Explorer will open and a selection can be made for the desired image. When the selection is uploaded the icon field will be filled automatically and the last step is to save everything. The icon is now successfully created and could now be assigned to a contractor/company.


With the "Companies" use case we display all Companies/Contractors that are created in total (Entry Point 01 - All Other) or are linked to a specific project (Entry Points Turnaround Project).


Under this use case, you can view and edit the root items (tiles) that are delivered to the clients.

The following Functionalities are displayed:

  • Commissioning Wallpaper
  • Communication
  • Daily HSE
  • Daily Meetings
  • Plant Layouts
  • Precom
  • Punchpoints
  • Quick access
  • Reports
  • Scope Changes
  • Turnaround Wallpaper


Functionalities


ORDERID & GROUPID

With these two properties, you can set the order (sorting) of the Functionalities (RootItems) on the client. See the SYSCLS SORTEDITEM and Sort Objects on Mobile Client articles for instructions on how to set up the sorting.


Visibility on Client

With this property, you can set the visibility of individual functionalities for the UWP and XAMARIN client. There are 5 options available that can be chosen:


  • Undefined
 undefined


  • Fully Visible
  UWP and XAMARIN users can see this functionality


  • Only Desktop
  Only Desktop (UWP) users can see this functionality


  • Only Mobile
  Only mobile users can see this functionality


  • Hidden
  No one can see this functionality 


Based on these options you can control and change the visibility of the functionalities for different clients depending on the application use. If this property changes for a functionality, the user group rights are adjusted in the background, and only users who are in the groups that have the rights can then see the functionality on the client. The users must be added to one of the following groups in order to make the visibility of the functionalities applicable to them:

  • G1 General WallpaperWrite Group (UWP)
  • G30 General ReadProject Group (Xamarin).


Whitelist

We can configure, with the help of the whitelist, which columns we want to have/see for each use case in the Bulk Editor. This helps us to present our data more clearly. For the Use Cases provided via the system definitions, we already have defined Whitelists that can be adapted when needed.

Now we come to the configuration of the whitelist for a use case: 1. Open your UBIK.Studio. 2. Navigate to the following point: System => System.Matap => System.Matap.AdminTool => USE_CASE_ADMIN_TOOL_QUERY. 3. Open the USE_CASE_ADMIN_TOOL_QUERY in the Bulk Editor. 4. Open the use case whose columns you want to change in the Relation Editor. 5. Drag and drop the Meta Property which you want to have shown into the REL_COLUMN_WHITELIST Section and the configuration is done.

MP_PRELOAD

There is also the possibility to preload properties, and this can be set with “MP_PRELOAD”. Just check this, and the property where the “MP_PRELOAD” was set will be preloaded. This can be set individually for each property.


Wiki Under Construction End.PNG