OneVizion® supports the use of an iOS Apple iPhone or an iOS Apple iPad to upload data into the OneVizion application. To download the Application, go to the App Store and search for the OneVizion Mobile App or click the following link:

https://itunes.apple.com/us/app/onevizion-mobile/id1090849488?mt=8

On iPad devices, the iOS App runs in "Compatibility Mode and the Apple App Store must be pointed at iPhone apps and not iPad Only apps to download the app.
The iOS App supports devices running iOS version 15+ or greater.

FieldVizion Android and iOS apps with versions prior to 20.1.0 will require an upgrade to work with OneVizion installations running versions 19.12.8 and above

Security

Although the app is openly available on the App Store, only users with existing security credentials will be able to make use of the app. The same security protocols governing the web application are applicable in the android app. I.E., A user in the mobile app will not have access to any places within the system that they are not already granted.

See Security Roles for more information.

URL

Field	Description
SiteURL	Site domain without “http: or https:” , or may use the site port. For example “trackor.onevizion.com".

Error Messages

Incorrect address

Unsupported URL

The mobile app can be connected to different server versions (recent or ESR).
The App responds with the list of supported API versions, and the server decides, is any of these versions supported and allows the App to connect.

App is outdated

Server is outdated

Users will use the credentials supplied by the system administrator to login.

FieldVizion iOS shows all internal labels using language which the user selects on the login page. WorkFlow labels (step title, field labels, etc.) will be shown in the user-selected language too.

Field	Description
UN/Email	User Name or Email associated with the OneVizion account.
Password	Password associated with account.

In the iOS App, a user MUST be online to log in to the App. Once the user is logged into the App, the user can go offline indefinitely without being logged off and requiring re-authentication.

(This means that a user should, for example, be able to log in at their hotel in the morning, head out the field with no connectivity, and be able to access the App with having to enter User ID/Password while offline.

Login page for legacy auth mode on ESR servers

Users who do not have a login may use the link on the login page

Click/Tap on Log In and the log in process will begin. If login attempt is invalid the user will see the screen below.

Invalid Login Attempt

Once login is successful the user will see the following screen. This will show all available WorkFlow Templates.

Once the user has logged in successfully, the login credentials will be saved in the local app storage and on the next application launch users will not need to enter their password again.

Users will not lose current position in App after OS kill process because of low memory or other reason when user switch screen to other App.

Application Screen

The Application Screen options are described below.

Number	Description	Usage
1	Settings	In "Settings" users are able to Purge Downloads, View "About" OneVizion information, and Log Off. Users are also able to see the Host and Username.
2	Template List	Count of active Templates listed on the display.
3	Online/Offline	Users may choose to work Online or Offline . Some WorkFlows may not be available in Offline mode. In the iOS App, a user MUST be online to log in to the App. Once the user is logged into the App, the user can go offline indefinitely without being logged off and requiring re-authentication. What this means is that a user should for example be able to log in at their hotel in the morning, head out the field with no connectivity, and be able to access the App with having to enter User ID/Password while offline. Even if the device battery dies or the device is rebooted the user should still be able to get back into the app while offline. If User2 completes a workflow step while User1 is offline, when User1 goes back online the completed step will not be automatically deleted from User1’s app. The user can “force” a sync-up in multiple ways on the iOS App, but the simplest method is to drag down on the template list immediately upon going back online.
4	Quick Search	Users may search values in the list by click on Quick Search button. Then the search window will open. This will limit the active workflows displayed to the search text entered. To close the search window use the Cancel button. Users can filter tabs by status by typing part of the status label or full status label in the search box at Tab List window.
5	Templates	Available WorkFlow Templates. The Type of Template is displayed along with the number of associated WorkFlows.
6	Start New WorkFlow	Opens the selected WorkFlow.

Third-Party Licenses

Third-party licenses list window for libraries used in FieldVizion iOS has been implemented. The list can be accessed from Settings -> About -> Third-Party Licenses link

Starting a WorkFlow

For the Mobile app, the two methods for starting a workflow would be:

Workflow creation following some event via Rules (I.E. work plan task completion, configured field update, etc.)
- This requires rule configuration by a system admin
- An example of this method would be the creation of a Closeout Package workflow for a particular Job when the WorkPlan task 'Notice to Proceed Complete' is populated
Workflow creation within the mobile app
- This requires consideration when designing the workflow template structure.
- I.E., if the workflow creation requires the creation of a new Trackor®, then a PL/SQL step is needed at the beginning of the workflow to create the new Trackor entry

Some amount of configuration from the System Administrator is required for all workflow templates. Please refer to the WorkFlow Templates documentation for detailed information regarding setting up a WorkFlow.

Instruction and Configured Applet workflow step types are not supported.

The iOS App does not “sort” results returned for WorkFlow template lists and WorkFlow. The results appear as configured by the System Administrator.

To download the WorkFlow to device click on the Download Icon, . When the WorkFlow download is complete the "Downloaded" icon, will appear. The changes made to the WorkFlow will be saved and available on the host platform when user is online.

WFs sorted by distance. Shown ft/mi or km/,.
From 0 to 5280 feet - shows feet, above - miles
From 0 to 1000 metres - show metres, above - kilometres

User location updated every 10 seconds

Working with a Template (New WorkFlow)

Select a Template.

The App loads all a list of all running WorkFlows corresponding to the selected Template. In this example we have chosen the Mobile WF template.

To begin a new WorkFlow click/tap the Start WorkFlow button. Users will then see dialog with new WorkFlow settings. Populate the Available Template, WorkFlow Name and the Description. Then select the Done button. User will then be able to select the Next button. Users will then be redirected to first step of the WorkFlow.

Message: Selecting OK will terminate this process and remove it from your work queue. Are you sure you want to do this?

Timeout for receiving GPS data has been implemented. This allows user to not wait infinitely if phone can't receive coordinates.

Connection read timeout increased from 60 to 180 seconds

Latitude and Longitude locations will update when user open step has been implemented.

Completing Assigned Steps

Each tab contains a list of fields that users should fill with values that are determined by the administrator. From each WorkFlow step window users are able to perform the tasks by clicking/tapping on the Step Name. Pressing the "Next" button will submit your Checklist Section for review. Once a Checklist Section is under review, you will no longer have access. Are you ready to submit for review?"

In the example above the "Fields" is a list of configured fields in the WorkFlow step. By selecting this users will be asked to complete each field on the current step.

The "Next/previous step" messages must be configured in the workflow template editor.

Required fields are labeled with an * asterisk.

Users are able to upload photos or videos.

Users are able to clear value in a filed by tapping the field and choosing the Delete Value icon, .

Users may also have the option to proceed to the "Next" a step or return to a "Previous" step. Users will be asked the following question on the screen.

Users will be shown how many steps have been completed and how many remain.

Select a Tab to complete. Populate all required Fields.

When all Tabs are completed, the Step will be listed with a "Blue Check-mark" indicating the Step is complete. In the example below the "Site Photos with Collection" is complete.

Field Descriptions

Users are able to see the description of the config field on the form. The blue "i" button used to see the field description. The button is displayed only for fields that have a description. By pressing on this button, the popup panel appears. By pressing on any point on the screen panel disappears. The panel uses fade animation to show and hide. Disabled/RO/locked fields will also show their description.

WorkFlow Status Visualization

A blue bar will be shown at the left edge of the WorkFlow and Workflow tab when the changes are not saved.

If there is a submit error, a red bar will be shown.

When the workflow is complete, the user will be directed to the Step List screen.
Screen with message "Workflow Complete!. Your workflow is done and has been submitted." has been removed from user flow

The updates to individual configured fields are changed and actualized in the database regardless of whether the workflow has been completed.

The system administrator can configure the content of the error text returned by the server in various situations. The header and text of the error are contained in the system labels.

Field Types

The following Data Types are supported in the iOS Application.

Relation and Multi-Line Configured Fields are not supported in the iOS Application.

Some value lists may be too long. To resolve this we use “endless” scrolling. Application loads 100 values per one request. After you scroll down at last element you will see label “Loading data…” and after few seconds list will be filled with new loaded elements.

Images and eFiles

Images and eFiles are supported using the mobile application.

For fields containing an efile, the user must download the file and then open it using a user-installed app appropriate for the file format. For fields containing a photo users are able to open using the iOS Application.

How to check geotagging in the Camera app

1) Launch Settings from the Home screen of your iPhone or iPad.

2) Tap Privacy. You'll have to scroll down a bit to find it.

3) Tap Location Services.

4) Tap Camera.

5) Check this value.

To take a photo or video and upload use the Paper Clip icon, . The photo will then be uploaded to the application. Users may choose to Take a Photo, Take Photos with Markup, Take Video, Choose Photo from Library, Choose a File, or Cancel.

Download/Preview Files

FieldVizion iOS show image thumbnail, preview button, and "Download" menu item for locked or read-only E-File fields with data

Users may click on the E-File icon (or photo) to view (or download) the file.

Multiple-Photo Fields

A multi-photo field is located on the Site Survey checklist template and is visible on each checklist item. All checklist items share the "General" class, and the mobile displays on the CHI:General tab.

As shown, users can easily capture multiple photos and photos are auto-captioned. Photos can be added or deleted on the desktop.

Multi-efile fields can be used in Word report templates.

In MultiEFile field user is able to see previews for files, that have not been submitted yet (pending files)

Markup Tools for E-Files

Users may choose to Retake of Use the current photo.

User may also choose from the options shown below.

Selected Value

A blue check mark will appear when a value is selected. When you have selected the value, click/tap on the "Fields" label in the blue area to return to the fields list.

Multi-selectors

Multi-selector fields are also supported. When multiple fields are selected blue check marks will be shown by each selected field. When you have selected the value, click/tap on the "Fields" label in the blue area to return to the fields list.

Drop-Downs, DB Selector, Trackor Drop-Downs

Select the value for the field. When you have selected the value, click/tap on the "Fields" label in the blue area to return to the fields list.

Date

Date Fields are fully supported and appear as such. Use the date wheel to select date and then select "done" when complete.

Time

Time Fields are fully supported and appear as such. Use the date wheel to select time and then select "done" when complete.

Date/Time

Date/Time Fields are fully supported and allow you to select date you want. Date edit dialog is similar to Date fields.

Checkboxes

Checkbox Fields are supported using the mobile application. Use the "slide" to choose. Blue indicates (On) "checked". White indicated (Off) "unchecked".

Text Fields

Text Fields are supported using the mobile application. When you have added the text, click/tap on the "Fields" label in the blue area . The text will be added to the field.

When you have completed entry, click/tap on the "Fields" label in the blue area to return to the fields list.

The return key will not work when updating a text field. Line breaks are not allowed.

Number Fields

Number Fields are supported using the mobile application. You will need to click/tap on number field area it will open for you to add text. Click/tap the “Done” button to save the changes.

True numbers only have 1 decimal. For fields that require more than 1 decimal the administrator should use the data type of text not number.

Bar Code Fields

OneVizion has added the support of Barcode in the FieldVizion platform. On the mobile platform, barcodes are supported by text, number, wiki, memo, hyperlink field types.

Supported formats:
UPC-E
Code 39
Code 39 mod 43
EAN-13 (including UPC-A)
EAN-8
Code 93
Code 128
PDF417
QR
Aztec
Interleaved 2 of 5
ITF14
DataMatrix

when setting up the field the must be checked.

To capture a Bar Code click on the Bar Code icon

Using the camera place the code in the frame to scan automatically.

Latitude and Longitude Fields

Latitude and Longitude fields are supported using the mobile application. You will need to allow the OneVizion Mobile Application to access your location.

Then you will need to click/tap on Latitude and Longitude field area it will add your current location.

Memo/Wiki

These fields edit dialog resembles the text fields, however here you can insert multi lined text. When you have completed entry, click/tap on the "Fields" label in the blue area to return to the fields list.

The field types of Memo and Wiki display within the App as a single line. The keyboard used to edit these fields does include the CR/LF symbol and the lines are stored in the App and transmitted back to the host platform correctly.

Users will be shown a message when fields have been updated.

Rollup

FieldVizion iOS supports Rollup fields. Currently, the user needs to do a full step reload to get the actual value of the fields.

Cascading Drop-Downs

Cascading Drop-Downs are now supported field types for FieldVizion. This is supported in both In online and offline mode - dropdown supports dependent values.

To set up a Cascading Drop-Down refer to the documentation here Admin Data Types of Fields.

List of available values in child field depends of parent field value.

Example of relations for Cascading Drop-Downs

Example of children fields when field was deleted on the parent field

Example if there are no available options in Expanded Mode

Error Message

Submit errors are shown to the user in an alert dialog box. Step type is not implemented for Mobile App. Please, choose another WorkFlow." will be shown when user try to open WF Step of type New Trackor.

Showing WorkFlow on a Map

Use the Map Icon, .

Users have the ability to set lat/long properties for WF, show WFs on the map and build route to the WF.

Example of WorfFlow not being available on the WorkFlow.

Adding a Map to the WorkFlow Template.

Satellite View on the map

Users are able to switch from map view to satellite view by selecting the map icon.

WorkFlow color on the map

In the mobile app new map feature: markers are painted in different colors. Colors configured on the server, on the "Config field admin page" - "Lat/Long Field Links" - "Color Legend Field"

Color is retrieved from the DropDown field from the key trackor. Map markers colored according to server color data. If a step has no color data, then marker colored with WHITE color
selected marker has increased font.

On this Page