Knowledge Base

Basic actions

Pairing the app with the server (first-time use) 

When opening Spatial Workplace mobile app for the first time, you need to pair it with the right server instance. This ensures the correct syncing of the necessary data.

1. Enter the company link provided by your administrator.
2. Enter the domain name provided by your administrator.
3. Tap on Continue.

Signing in to the app

After pairing, you will be directed to the Single-Sign-on page in a web browser.

To sign in:

1. Enter the username and password provided by your administrator.
2. Tap on Sign In.

Signing out of the app

1. In the top-right corner, tap on the Settings button.
2. Tap on Logout.
3. Tap on Ok!.

Changing the paired server

Re-pairing the app after logging out is possible by entering your credentials manually for alternative licenses and permissions.

To change the server you have paired previously:

1. Sign out of the app.
2. Tap on Edit Configuration.
3. Enter the new company link and domain name provided by your administrator.
4. Tap on Confirm.

User interface

Status bar

The status bar is located at the very top of the Spatial Workplace mobile app. It informs you about the overall status of your device. You can see the connection status, search for tasks and templates, and access the app settings.

Navigation section

The navigation section is located at the very bottom of the Spatial Workplace mobile app. It gives you access to the Task List and Templates.

Task List screen

The Task List shows all the tasks assigned to the user. Here you can download and execute tasks.

1. Status bar
2. Task List screen
3. Navigation section

It is possible to manage this list by removing the downloaded tasks. To delete a downloaded task from Task List:

1. Long press on the screen, this will make the selector options appear.
2. Select the task/tasks to delete. 
3. Tap on Remove on the top-right bottom.
4. Confirm the removal.

Note: Only the downloaded tasks can be deleted.

After removing a task from the list, it will be shown as Not-Downloaded. It is possible to re-download that task later, as these tasks are still assigned to the same user.

Templates screen

The Templates lists all the assigned templates to the user. Here you can download and execute templates.

1. Status bar
2. Task List screen
3. Navigation section

It is possible to manage this list by removing the downloaded items. To delete a downloaded template from the Templates List:

1. Long press on the screen, this will make the selector options appear.
2. Select the template/templates to delete. 
3. Tap on Remove on the top-right bottom.
4. Confirm the removal.

Note: Only the downloaded templates can be deleted.

After removing a template from the list, it will be shown as Not-Downloaded. It is possible to re-download that template later, as these templates are still assigned to the same user.

Tasks

Tasks are used to assign workflows to the users. When you tap on a task, you can view the details such as planned date, by whom it is created by, and tags etc. From there, you can start a task simply by tapping on the Start Task button.

Alternatively, open a specific workflow using your device's camera:

1. Open Frontline Command Center.
2. Go to Tasks and find the workflow to open on the device.
3. Click on Print QR Code.
4. Point the camera of your device to the QR code. 

⇒ By opening the link, the application opens automatically and runs the selected workflow.

Note: If the user is not assigned to the selected workflow, the application will open on the main menu.

Cancelling a Task 

It is possible to cancel a task with a given reason. Within your workflow:

1. Tap on the Workflow Menu.

2. Select Cancel Task.

3. Choose a reason from the list; for example, Made a mistake.

4. Tap on Yes.

Anchored content:

3D Model view

The 3D model view, on the other hand, gives the user the possibility to see and handle the workflow in a virtual environment that is independent of the physical world. There is no necessity for a Scene State node or a hologram to be visible at a certain step for the user to be able to go to the 3D view.

To open the 3D model view, select Show in 3D from the Workflow menu.
This option is available for all pins that contain at least one hologram or have scene states visible.

To return to the AR view or flat content, select Show in AR while in the 3D view. 

Within the 3D view, users can access a menu offering several display-related options.

After a part of the hologram has been hidden, the eye toggle appears on the top right of the screen. Tap on it to unhide the part.

Navigating with Menus inside the workflow

You can easily navigate inside the workflow with the Menu options.

By tapping on the sections, you can step into the desired part of the workflow.

The highlighted Menu button shown here has an index functionality. It will only appear when the user has passed through previous menus, and will include all past menus.

You will return to the previous state when you close the menu options.

Positioning workflow content

Later on, you need to perform specific actions depending on the spatial reference (markers, or object tracker) used in the workflow.

Workflows with markers

After finishing the surronding scanning, the marker scanner appears. On the top, the marker IDs are activated to start the workflow. The device's camera will open in the background and the user can focus on the chosen marker to display the first pin.

Workflows with object tracker

After finishing the surronding scanning, the hologram of the initial pose of the object appears. The device camera opens in the background and the user can position the object inside the outline until loading is completed.

Changing the initial pose: To change the initial pose of the object, change the position of the object tracker in relation to the model inside your Spatial Editor project.

Workflow with model placement

After opening the workflow, the camera of the device opens in the background and users can move their device around to find a flat surface (e.g., a floor or a table). Recognized surfaces will be marked with white dots.

To adjust the position and rotation of the model:

1. Tap on the screen to position the model on this surface.
2. Pinch your fingers on the model to zoom in and out.
3. Tap over the model and move your finger around to rotate it.
4. Tap outside the model, on a free surface, to reposition it.

It is also possible to reposition and rotate the model during the execution of the workflow. Users can rotate the model, rescale it with pinching in/out, and move it up and down with a three-finger hold. The degree values and percentage of scale are visible while making adjustments.

Note: Readjustments are possible only if the model has been made visible with a scene state node in the workflow with proper adjustments. Please see this page about how to make models visible using scene states.

Adding comments to a Pin

It is possible to add comments to a Pin.

After tapping the More button (3 vertical dots), you can choose from the menu to type your comment or upload media.

When the user switches to 3D view, they can take a screenshot and add it as a comment to the Pin.

This option is available only when the workflow is initialized in AR from the Editor side. 

Reporting an error 

When an issue arises, Spatial Workplace users can submit a report automatically or manually. This supports faster and more accurate troubleshooting by administrators. 

While reporting errors manually, you can add a description, a screenshot and mention the workflow name in your report. 

For reporting errors automatically, tap on the Send Report button from the pop up:  

Restart tracking

If the content drifts from its correct placement during the workflow, the user can reposition the workflow and reset its spatial reference. On the workflow menu, select the Reposition Workflow option. The user is prompted to reset the spatial reference of the workflow (e.g., rescan the marker) and then the workflow continues with the previous step. 

Templates

Templates are used to assign workflows to the users. From there, you can start a task simply by tapping on the template. 

Alternatively, open a specific workflow using your device's camera:

1. Open Frontline Command Center.
2. Go to Templates and find the workflow to open on the device.
3. Click on Print QR Code.
4. Point the camera of your device to the QR code. 

⇒ By opening the link, the application opens automatically and runs the selected workflow.

Note: The application will open on the main menu if the user is not assigned to the selected workflow.

The process for workflow navigation, AR overlay view, 3D model view, controlling the model inside the 3D model view, positioning workflow content, workflows with markers, workflows with object tracker, workflows with model placement, and restart tracking are the same as Tasks. For these details, please refer to the Tasks section above.

Custom theme applied

Custom Themes allow the user to customize the theme and appearance of Frontline Spatial Workplace application. Custom themes are configured in Frontline Command Center by Frontline Experts. For more information, please visit our Custom Themes page.

Basic actions

Pairing the app with the server (first-time use) 

When opening Spatial Workplace for the first time, provide the company URL and domain to pair it with the right server instance. This ensures the correct syncing of the necessary data.

1. Enter the company link provided by your administrator.
2. Enter the domain name provided by your administrator.
3. Click on Confirm.

Signing in to the app

After pairing, you will be directed to the Single-Sign-on page in a web browser.

1. Status bar
2. Task List screen
3. Navigation section

It is possible to manage this list by removing downloaded tasks. To delete a downloaded task from the Task List:

1. Directly click on the task line you wish to delete (when hovered over, the selector options will appear on the left).
2. Click on the Remove download files button on the top-right.
3. Confirm the removal.

Only the downloaded tasks can be deleted.

After removing a task from the list, it will be shown as Not-Downloaded. It is possible to re-download that task later, as these tasks will be still assigned to the same user.

Templates screen

The Templates lists all the assigned templates to the user. Here you can download and execute templates.

1. Status bar
2. Task List screen
3. Navigation section

It is possible to manage this list by removing the downloaded templates. To delete a downloaded template from the list:

1. Directly click on the template line you wish to delete (when hovered over, the selector options will appear on the left).
2. Click on the Remove download files button on the top-right.
3. Confirm the removal.

Only the downloaded templates can be deleted. 

After removing an item from the list, it will be shown as Not-Downloaded. It is possible to re-download that template later, as these templates are still assigned to the same user. 

Reporting an error 

When an issue arises, Spatial Workplace users can submit a report automatically or manually. This supports faster and more accurate troubleshooting by administrators. 

The functionality is located in the Help section:

While reporting errors manually, you can add a description, a screenshot and mention the workflow name in your report. 

For reporting errors automatically, click on the Send Report button from the pop up:  

Workflow Navigation

In the workflows, models can only be viewed in 3D model view since AR and VR options are not available for desktop devices.

3D Model View

The 3D model view allows users to observe and manipulate the workflow within a virtual environment separate from the physical world. The 3D model view can be used to explore the details of the hologram's model. In this view, the remaining content of the pin (text, videos, pictures, audio, pdf) is always presented on a flat display.

Navigating with Menus inside the workflow

You can easily navigate inside the workflow with the Menu options.

By tapping on the sections, you can step into the desired part of the workflow.

The highlighted Menu button shown here has an index functionality. It will only appear when the user has passed through previous menus, and will include all past menus.

You will return to the previous state when you close the menu options.

Custom theme applied

Custom Themes allow the user to customize the theme and appearance of Frontline Spatial Workplace application. Custom themes are configured in Frontline Command Center, for more information, please visit our Custom Themes page.