The purpose of the file loader option is to update/edit existing unit information 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
In the event that a field is updated via a bulk update, no other fields in the system need to be updated. For example, the “Balance update date” will not be updated as a result of updating the “Balance kWh”.
|
Requirements
Units:
The units that will appear in the file must already be present in the system.
Using the file, units cannot be moved between different groups and clusters.
Only fields that are supported by “Forms Gate” can be updated through the file. A list of all the fields which can be updated is available here.
User:
File:
The file must be in CSV (Comma Delimited) format.
The first column of the file must be a Unit ID (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).
Each field you wish to update must appear with its system name in the column headline (all the system names appear here below ("Field Unique Names").
Each value should match the field's type. The field can be of one of the following types:
Numeric - commas are not allowed (i.e., the valid format is 1000 and not 1,000). numeric fields cannot be empty.
Date - must be in the following format: yyyy-mm-dd hh:mm:ss (hh:mm:ss are optional).
Date and numeric fields cannot be empty.
String - free text. 
Note that empty fields will override the existing value (delete it).
List Options String - valid values are only predefined options.
Boolean fields (true or false) - valid values are "Yes"/ "No" (case insensitive).
You can write the following code in the relevant rows to avoid overriding existing settings: %DONOTCHANGE%
Example of a file:
File Uploading Process
Prepare the CSV (Comma Delimited) format.
file by the limitations listed above.
Open the Galooli Manager solution and enter the “My Units” menu.
Select "Bulk Update”.
Select “Upload File”.
Upload the prepared CSV (Comma Delimited) file.
Upon uploading the file, a validation process will begin, and the information from the file will appear in the table. The appearance of the data in the table indicates that the data was uploaded successfully, but this does not indicate that an actual update occurred.
If the column headline doesn't contain a valid parameter name the headline will be colored in red.
If one of the rows contains an invalid value, the value will be colored in red.
7. Only after all values are valid (no red values in the table), you can save the settings of the units.
If some units fail to update after saving the parameters, an email with the details of the failure will be sent to the user.
Example:
The report will contain the failure reason.
File Update Success and Error Messages
