You can change the value and description of an existing Spot data field in both the Android and iOS apps. The change is saved to the Spot’s shared information and is available to other users who have permission to view the Spot.
Requirements and editing limits
You need permission to view and edit the Spot, as well as an internet connection to save. View permission alone is not enough: the edit icon on the field row is visible only if you have edit permission. If the icon is missing, ask your organization’s administrator to check your permissions.
A deleted Spot cannot be edited using this mobile workflow. The Not in use and Faulty statuses do not by themselves prevent you from editing a data field. Changing a field does not change the Spot’s status.
In this view, you edit the contents of a field on an individual Spot. This action does not change the Spot’s name or general description, the field’s name or type, or the device card structure. If a field is missing, ask an administrator to check the Spot’s fields and any device card assigned to the folder. See also Editing Spot information in a browser and Configuring device card fields.
Open the field for editing
- Open the relevant Spot in the mobile app. For example, on the Home screen, select Browse folders and spots, open a folder, and select the Spot. For other ways to find a Spot, see Finding Spot information.
- In the Spot details, select View Device Card.
- Find the data field you want and tap the edit icon on the right side of its row. The edit view opens for that field.
- Check the Spot and field names before changing the information.
Value and description are separate
The value is the actual content of the field, such as a serial number, date, or selected option. The description is text that adds information about the value. For example, you can enter SN-12345 as the value of a serial number field and Checked against the device nameplate as its description.
On Android, an entered value appears under Add value, and the value of a selection field appears under Value. On iOS, the value is labeled Value. The description is labeled Description in both apps. This Description applies only to the selected field, not to the Spot’s general description. You can change just the value or just the description and leave the other unchanged.
The Android device card list does not show the value of an email field, although the field row and any description are visible. A value that appears blank therefore does not mean the saved value is empty. If you have edit permission, you can see the current value by opening the field with its edit icon. iOS shows the email value on the device card.
Enter content according to the field type
- Text and email address: enter the content in the value input. Enter the description separately under Description. On iOS, an email field opens the email keyboard.
- Number: enter a number without a unit or other explanatory text. On iOS, you can enter up to 10 digits in total, one decimal separator, and an optional minus sign at the beginning. You can use a comma or a period as the decimal separator; for example, 12,5 is sent for saving as 12.5. The conversion does not round the number. On Android, a number field opens the phone number keyboard; the available characters depend on the keyboard.
- Date: tap the value and select a date from the date picker. On iOS, confirm the selection with the picker’s Done button. Check the displayed date before saving.
- Selection: tap the current value and select an option from the list that opens. You can filter the options using the list’s search field. Select an option defined for the field; you cannot add a new option from this view.
- Web address: enter the address, preferably in full, for example https://example.com. If the address has no protocol, the server adds http:// at the beginning. An invalid address format may prevent saving.
The maximum length is 10,240 characters each for the value and the description. The Android device card list shows up to 200 characters of the value; open the field’s edit view to check longer content.
Speech and text recognized by the camera
The microphone and text recognition icon next to the value or description opens the options Record text with voice and Use camera to scan text. The actual values of date and selection fields are chosen using a picker; their descriptions can be entered as text.
The camera requires camera permission. The voice function requires available speech recognition and the microphone permissions it needs. When using the camera, photograph the text, crop the area to be recognized, and check the recognition result. Accept the corrected text using the button in the lower-right corner of the recognition window.
On Android, recognized text replaces the content of the selected input. On iOS, text recognized from speech is appended to existing text, while text recognized by the camera replaces the content after you accept it. Always check the final value and description. Accepting text into an input does not yet save the Spot’s information.
Save or cancel
- Select Save in the upper-right corner of the edit view.
- The app asks Are you sure you want to save? Confirm with Ok on Android or OK on iOS. The information is sent for saving only after you confirm.
- If you want to make further corrections, select Cancel in the confirmation dialog. You will return to editing.
To leave without saving, use the back arrow in the upper-left corner of the edit view on Android or the Cancel button in the upper-left corner on iOS.
What happens when you clear a field?
On Android, clearing an entered value or description changes the content sent for saving to a hyphen -. On iOS, entered text and descriptions can be sent empty. Web address formatting also applies to web addresses.
Clearing the content does not remove the data field row, change its type, or restore an earlier value. The date and selection field pickers do not offer a separate option to remove the field. To remove a field from the structure, use the relevant browser administration feature.
Verify the result
After a successful save, Android displays the message Spot saved! and updates the field list with the information returned by the server. iOS returns to the field list, but a save error can also close the edit view. The view closing alone therefore does not mean the save succeeded.
Leave the Spot details and reopen the same Spot to retrieve the information from the server. Open View Device Card and check both the value and the description. On Android, open the email field’s edit view to check its value; the device card row alone does not show it. Do not judge the result solely by the text shown in the edit view before saving.
If the change is missing, check your internet connection, any error message, your edit permission, and the field contents. A selection value must be one of the allowed options, and neither the value nor the description may exceed the maximum length. Determine what content was saved before trying again.
Saved changes to the field are recorded in its history. You can check earlier values in a browser using the instructions in Checking a Spot data field’s value history. This is separate from the history of fields being added to or removed from the device card.