Text recognition lets you transfer text captured with your camera into an editable field in Spotilla. For example, you can scan a device ID into a device card or transfer a written observation into a task description. Check and correct the result: recognition makes entering text easier, but it does not verify that the information is correct.
Before you begin
You need a phone with a camera, permission to use it, and permission to create or edit the information in question. View-only access to the item does not allow you to edit it. Recognition is available in editable fields that have a combined microphone and text recognition icon.
The feature captures text using the camera. It does not import text from a photo in the gallery or a PDF file. The image captured for recognition is not saved as an attachment to the item by this feature; add any required photo attachment separately.
Keep an internet connection available, especially when using the feature for the first time on Android. The information is saved to the service only when its actual save operation succeeds.
Where do I open text recognition?
First open the correct item and editable field. On Android, the recognition icon is usually at the right edge of the field. On iOS, it is the microphone and text recognition icon associated with the field. Select the icon for the field where you want the text.
Device card value or definition
In the Spot details, open View Device Card and select the edit icon on the row for the desired data field. In the edit view, use the recognition icon for the Value or Definition field. Editing requires permission to edit the Spot.
You can use recognition to fill in the value of text, web address and number fields. Dates and selection field values are selected using their own controls; you can use recognition for their definitions. The value and definition are separate pieces of information, so check the destination field before applying the result. If needed, see finding Spot details on mobile.
New task, service request or Spot message
In the Spot details, open Add items and select Add task, Add service request or Add message.
- When creating a task, use the icon in the Task description field.
- When creating a service request, use the icon in the Title or Description field. Recognition is also available in text-based additional fields where the icon appears.
- For a Spot message, use the icon in the message text field. Recognition also works when editing a message.
These options are available on both Android and iOS. Check that you have the correct Spot and review the other form details: recognition fills only the field you selected.
Task form
Open Fill task form from the task and select the section you want to fill in. On both platforms, you can use the recognition icon in a text or number field. On Android, you can also recognize text for an individual field comment: open the comment function for that field and use the microphone icon in the comment window.
iOS field comment limitation: applying the recognition result changes the field comment, but saving from the open comment window writes the text displayed in that window to the field comment. This may overwrite the text you just recognized. Therefore, type the field comment manually in the comment window and save it. This limitation applies to field comments on task forms; these are different from the task's general completion comment.
If the section has been saved and the fields are locked, open the section's Edit function when your permissions and the task status allow it. Recognition does not bypass the lock or complete the section or task. See also filling in a task form.
Editing service request additional information
You can also use recognition when editing text-based additional fields in an existing service request on both platforms. Open the edit icon for the service request's additional fields and use the recognition icon for the desired field in the form that opens. On Android, the fields are under Additional fields. Editing requires permission to edit the service request; permission to comment does not grant permission to change additional information.
Comments, Work Chat and time entries
To add a general task comment, open the task details and tap the add button on the Comments card. On Android, this is the green plus icon below the card. In the comment window that opens, use the microphone icon in the text field. Open the comment list from the Comments card. See also task comments.
For a service request, use the plus button under Comments in the open request and the recognition icon in the comment window. On iOS, you can also open the comment list and select Add. Recognition can also be used in an editable comment. For more information, see the service request comments guide. On Android, recognition is also available in the purchase order comment window.
You can recognize the opening text of a new Work Chat on both platforms: open Work Chat, tap its add button and select the item for the conversation. Use the icon in the first comment window that opens. For detailed instructions on selecting an item, see using Work Chat.
When editing a time entry, open Add Comment or View Comment and use the icon in the comment window. This works on both platforms when the comment is editable. On Android, you can also use recognition for a product row comment opened from a task's or service request's Products view, using the same comment functions.
Capture, crop and check the text
- Tap the recognition icon for the destination field and select Use camera to scan text in the window that opens.
- Allow camera access if your phone asks for permission. Capture the desired text as clearly as possible.
- Crop the image to include only the text area you need. On Android, confirm the crop with Crop; on iOS, use the confirmation button in the crop view.
- Check all the text in the result window that opens and correct any errors there. The Android window title may be Edit recognized text even when the app is in Finnish.
- Transfer the corrected result using Apply on Android or APPLY on iOS. If you do not want to use the result, select Cancel or CANCEL in the result window.
The applied result completely replaces the current text in the destination field. It does not append the recognized text to the existing text. If you want to keep any previous content, copy it before applying the result and combine the texts before saving the actual information. Canceling the result window leaves the result untransferred. Note the iOS field comment limitation described above.
Pay particular attention to letters and numbers in IDs, the decimal separator, minus signs, units and line breaks. Text transferred to a number field must be corrected into a number format accepted by the field. Recognition does not convert units of measurement or check whether a number corresponds to the actual measurement.
The field's normal format and character limit also apply to recognized text. Android's shared comment windows show the character count and maximum length, and a recognition result that is too long is truncated at that limit. Also check the end of the text transferred to the field.
Save the information and verify the result
Apply in the recognition result window does not by itself save the information to the service. After that, save the form or comment itself:
- Device card: select Save in the edit view and confirm the save. The saved value or definition replaces the previous information, and the change is included in the data field's normal change history.
- New task: also fill in the task name, Spot, responsible party, due date and any other required information. Create the task using the form's create button. Recognizing the description alone does not create the task.
- Service request: check the service request type and title, as well as the Spot and mandatory additional information required by the type. Save the request or changed additional information from the form. See also creating a service request.
- Spot message: check the Spot, message type and entry time, and save the message form. A numeric message must contain a valid number. Saving uses the message's normal functions, including any notifications associated with the message type. See recording a message or measurement.
- Task form: confirm the field comment if necessary and select Save at the end of the section. On iOS, check the field comment limitation described above. Mandatory fields must be filled in for the section to be completed. Completing the entire task is a separate action.
- Comment or new Work Chat: send or save the text using the comment window's own button. Applying the recognition result does not yet add the comment to the conversation.
- Time entry or product row comment: confirm the comment in its window and also save the entry or product row itself. If needed, see correcting a time entry.
Wait for the actual save to succeed. Reopen the item or refresh its details and check the correct field and the beginning and end of the text. A comment should appear in the correct item's comment list, and a form value in the correct section. If saving reports an error, the recognition result appearing in the field does not mean that the information has been saved to the service.
If recognition does not work
If the camera does not open, check the camera permission granted to Spotilla on your phone. If no result appears or the result is incorrect, take a clearer photo and crop the text area again. iOS may display the message No text recognized. Please try again. Android may not display a message for a recognition or cropping error. You can enter or correct the information manually.
If the icon is missing or unavailable, check the field type, your edit permission and the status of the item or section. On iOS, the same icon is also used for speech recognition, and a change in speech recognition availability may disable the shared icon.