This feature is available only to organizations with a Platinum license.
X-Ray Management provides an environment for managing configurations, defining valid ranges for each configuration and setting the required values for each sitedevice.
X-Ray Management serves the following purposes:
Define and update the valid configurations for each sitedevice, which will be compared to the actual readings in the X-Ray Accuracy dashboardsKPIs menu.
Set (write) the valid configurations that the user has defined. For each sitedevice, the user will define the specific value for each X-Ray item (can be uploaded from Excel or edited through the management toolconfiguration table). It will bind the X-Ray item to a specific OID, store and apply the suitable parameter type and factor.
Image - TBA
| Table of Contents |
|---|
...
X-Ray Management Structure
X-Ray Organization Tree
The organization tree for X-Ray Management shows the organization's regular structure. The tree cannot be edited and not include the “STOCK” cluster.
It is necessary to peak a specific unit in order to see and set the different configuration values.
...
X-Ray Configuration Table
This table contains all the relevant configurations that can be made at a particular site.
The table includes the following columns:
...
Name
...
Active
...
Min Valid Value
...
Max Valid Value
...
Set Value
...
Actual Value
...
A configuration category and a configuration name are contained in the name column
...
Indicating if the item is supported for the unit.
There is a checkbox for each item and category
...
The minimal valid value of the X-RAY item. Can be float or textual. For textual items, this column will display the expected value.
...
The maximal valid value of the X-RAY item. Will be disabled for textual items.
...
The value that is being written to the device when updating the configuration (set).
The set value can be empty - N.A. As default, set values will be empty for new items.
If the value is empty, when applying "Set" nothing will be written to the device.
...
The current value of the X-RAY item, displayed in "read only" mode.
...
There is a search component included in the table.
X-Ray Export & Import
By selecting the “Export” option, you will be able to download an Excel file containing the data table as displayed on the screen.
By selecting the "Import" option, the user can upload a CSV file in order to set the values for the: "Min Valid Value", "Max Valid Value", and "Set Value". A detailed description of the "Import" file usage will be provided here - https://galooli.atlassian.net/wiki/spaces/KP/pages/2915762177/X-Ray+Management#X-Ray-Management-File-Import
...
X-Ray Management File Import
The purpose of the file import option is to update/edit the X-Ray configuration table parameters for a large number of units by uploading a file, as opposed to manually updating each unit.
| Note |
|---|
The data in the file will overwrite the information in the system, if there are units in the system that are not in the file, then they will not be changed |
Requirements
Units:
The units that will appear in the file must already be present in the system.
User:
Users with "Full” permission to the "X-Ray" tool will be able to view the button and upload the file.
The user must have permission at least to view the cluster/group that the unit belongs to.
File:
The file must be in CSV (Comma Delimited) format.
Columns should not be rearranged.
The order of the columns must be unit_id, X-RAY Field Name, Active, Min Valid Value, Max Valid Value, Set Value, and use the exact names.
The first column of the file must be a “unit_id”. This column must include valid unit ids, so its values must be filled. In addition, each Id should have a single row (the same unit cannot be updated with 2 different rows).
"X-RAY Field Name" column values must appear in the system key structure. You can view the system key fields by clicking on the following link - Forms Gate Supported Fields List.
In the "Active" column, the value must be "Yes" or "No" (empty rows will be considered as “No”). If active is "No", all the other parameter's column will be ignored, even if they are filled.
Ensure that there are no empty lines. It is possible to verify this by opening the file as a text file and deleting the lines containing commas.
The user can upload a file with X-Ray fields that are not defined for the unit, and they will be ignored.
Example of a file:
File Uploading Process
...
Prepare the CSV (Comma Delimited) format.
...
Open the Galooli Manager solution and enter the “X-Ray Management” tool.
...
Click on the three-dot menu.
...
Select “Import”.
...
Upload the prepared CSV (Comma Delimited) file.
After uploading a file, the user will get an immediate error message in the following cases:
The file is not in a CSV format.
The columns are not in the correct order - The columns order must be: unit_id must be unit_id, X-RAY Field Name, Active, Min Valid Value, Max Valid Value, Set Value
If the file structure is valid (CSV format + Valid columns) - the file will be processed and the results will be displayed to the user.
...
In case of a failure, the file will not update any unit.
In case of a failure, the reasons for the failure will be detailed.
Example:
...
Existing Calibrations Section
A table with all the calibrations prepared by the user and all system tables prepared by Galooli.
The table specifies:
Type (system/user-costumed tables) indicated by icons.
System tables:Appear as default for all organizations.
Will appear first in the table (before all user-costumed tables).
Will appear with a "System" icon (Gear).
Cannot be edited or removed.
Name
Device
Description
Image - TBA
Calibration Configuration Section
By selecting one of the rows in the calibrations in the existing calibrations section, the X-Ray table will appear on the right side of the screen, specifying:
Name
Description
X-Ray Items (Parameters)
Valid Range
Set Value
Image - TBA
Calibration Creation/Editing/Removal
Creation/Editing
Click on "Add" to create a new table, a dropdown will open with the options of the table types, according to the possible devices. Alternatively, you may edit an existing table by clicking on it.
From the right side of the screen add the “Name” and “Description” for your calibration table.
There will be a list of all fields associated with the selected device. Identify the relevant fields.
When you double-click on the relevant field, a popup will appear where you can enter the valid range and set value.
Image - TBA
Textual fields popup:
Numeric fields popup:
Save the configuration.
Removal
Select an existing user-costumed type table (not a system type table).
Click on “Remove”
Image - Remove