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 site.
X-Ray Management serves the following purposes:
Define and update the valid configurations for each site, which will be compared to the actual readings in the X-Ray Accuracy dashboards.
Set (write) the valid configurations that the user has defined. For each site, the user will define the specific value for each X-Ray item (can be uploaded from Excel or edited through the management tool). It will bind the X-Ray item to a specific OID, store and apply the suitable parameter type and factor
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.
| 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 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.
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: