This feature is available only to organizations with a Platinum license.
My X-Ray Management provides an environment for managing configurations, defining valid ranges for each configuration and setting the required values for each sitedifferent devices.
All operations are carried out by creating and managing 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.
...
tables that contain information about the device parameters, the valid ranges selected by the user, and, of course, the set values that binds the X-Ray item to a specific OID,
...
stores and
...
applies the
...
| 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:
...
appropriate parameter types and factors, and applies them accordingly.
The proper way to manage site configuration using X-Ray is to define each unit type according to the configured devices and attach the matching X-Ray table.
...
| Table of Contents |
|---|
X-Ray Existing Tables Section
This section includes the X-Ray tables prepared by the user and all X-Ray 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.
The system tables do not contain default set values due to the sensitivity of the mechanism. The customer must, however, define this for himself.
Name
Device
Description
...
X-Ray Table Configuration Section
Upon selecting one of the existing X-Ray tables, the following data will appear on the right side of the screen:
Name
Description
X-Ray Items (Parameters)
Valid Range
Set Value
...
X-Ray Table 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 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. In order to reset the valid range and the set value, simply remove the previous values and save the changes.
...
Textual fields popup:
Numeric fields popup:
Save the configuration.
| Info |
|---|
Characteristics of “Set” values:
|
Removal
To remove an X-Ray table, you must first separate all associated units from the table by selecting "blank" option under the "Table Name" field in the “My Units” configurations - https://galooli.atlassian.net/wiki/spaces/KP/pages/3094183938/X-Ray+KPIs#X-Ray-Definitions.
It is only after this action that you are able to proceed to the next step.
Select an existing user-costumed type table (not a system type table).
Click on “Remove”
