Spatial Workplace is an application that allows users to visualize pins and their information over real-life objects. Its installation is available on a Microsoft HoloLens 2, iOS devices (iPhones and iPads), Android devices, and desktop devices.

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 Confirm.

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

Templates screen

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

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 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.

Workflow Navigation

On mobile devices, there is the option to see the pins and content of a workflow through different views. The flat and anchored content modes are two possible ways of visualizing the content of pins in AR. The user can switch between the views and content displays using the workflow menu on the top left. 

Workflows are shown in the flat content mode by default. This means you can tap on the screen to select icons and buttons.

If the workflow is displayed in anchored content mode, a selection cursor appears in the middle of the device. The cursor can be moved by moving the device around. Users can trigger buttons by pointing their device's viewpoint at the buttons so that the cursor lies over it. Once over the button, a red loading circle appears around the button. Wait until the bar completes the turn to select it. The user can speed up the process by touching the button while it is loading.

AR overlay view

The AR overlay view is the default way of presenting pins in augmented reality over the real component. The pin shape will always be presented in the exact position in relation to the spatial reference. The content can be displayed as flat or anchored. Flat content displays the information of the pins in a menu on the right side of the screen in a static way. Anchored content displays the information in a banner next to the actual position of the pin and moves vertically, following the user's movement.

Flat content:

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 and close the model view, select Show in 3D on the Workflow Menu. This option is available for all pins that contain at least one hologram or have scene states visible.

Inside this view, users can perform the following actions:

  • Use one finger to turn the hologram.
  • Pinch with two fingers to zoom in or out.
  • Use three fingers to drag the hologram sideways.
  • Tap on a particular part to hide it.

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.

Note: The 3D model view can be used to explore the details of the hologram's model without the need to point the device to its real-life position. In this view, the remaining content of the pin (text, videos, pictures, audio, pdf) is always presented on a flat display.

Controlling the model inside the 3D model view

Steps that contain Holograms can also be visualized inside the 3D model view, which allows for handling the holograms in more detail and separately from the real-life environment. Open the top menu during a step with holograms and select See in 3D.

  • Turning the model around its axis: Touch the screen with one finger and move it around.
  • Zooming in and out: Pinch-zoom with two fingers bringing them closer or further from each other.
  • Dragging the model: Touch the screen with three fingers and move them around.
  • 3D model view information: The 3D model view allows users to visualize holograms of pins independently from their position in the real world.

Positioning workflow content

To place the content of the workflow in real life, the user needs to scan their surrondings by following the instructions given. 

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.

Tap on the More button (3 dots) in the top-right corner. You can choose from the menu to type your comment or upload media.

 

Then continue with Next.

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, for more information, please visit our Custom Themes page.

Settings and  information

Changing settings

In the top-right corner of the main menu, tap on the Settings icon and change any of the following settings:

Language

Defines the language of the application. Currently supported languages are English, German, Portuguese, French, Spanish, Chinese (simplified), and Japanese.

Help

  • Knowledge Base: Redirects you to the Knowledge Base web page.
  • Contact: Redirects you to your default mail application to write a mail to [email protected] address.

About

  • Privacy Policy: Redirects you to the Teamviewer website that contains the various privacy notices.
  • Third Party Copyright: Opens the copyright information within the app.
  • EULA: Redirects you to the section of the TeamViewer website that contains the EULA and the DPA. 

Advanced Settings

  • UI Layout: Allows you to choose where (Right side/Bottom side) text instructions are displayed in the workflow.
  • Show Pin Shapes: Toggle option where you can enable Point of Interests and shapes on the 3D model.

Logout

You can logout from your account simply tapping on this option.

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 Start Login.

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

Templates screen

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

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.

Workflow Navigation

On mobile devices, there is the option to see the pins and content of a workflow through different views. The flat and anchored content modes are two possible ways of visualizing the content of pins in AR. The user can switch between the views and content displays using the workflow menu on the top left. 

Workflows are shown in the flat content mode by default. This means you can tap on the screen to select icons and buttons.

If the workflow is displayed in anchored content mode, a selection cursor appears in the middle of the device. The cursor can be moved by moving the device around. Users can trigger buttons by pointing the viewpoint of their device at the buttons so that the cursor lies over it. Once over the button, a red loading circle appears around the button. Wait until the bar completes the turn to select it. The user can speed up the process by touching the button while it is loading.

AR overlay view

The AR overlay view is the default way of presenting pins in augmented reality over the real component. The pin shape will always be presented in the exact position in relation to the spatial reference. The content can be displayed as flat or anchored. Flat content displays the information of the pins in a menu on the right side of the screen in a static way. Anchored content displays the information in a banner next to the actual position of the pin and moves vertically, following the user's movement.

Flat content:

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 and close the model view, select Show in 3D on the Workflow Menu. This option is available for all pins that contain at least one hologram or have scene states visible.

Inside this view, users can perform the following actions:

  • Use one finger to turn the hologram.
  • Pinch with two fingers to zoom in or out.
  • Use three fingers to drag the hologram sideways.
  • Tap on a particular part to hide it.

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.

Note: The 3D model view can be used to explore the details of the hologram's model without the need to point the device to its real-life position. In this view, the remaining content of the pin (text, videos, pictures, audio, pdf) is always presented on a flat display.

Controlling the model inside the 3D model view

Steps that contain Holograms can also be visualized inside the 3D model view, which allows for handling the holograms in more detail and separately from the real-life environment. Open the top menu during a step with holograms and select See in 3D.

  • Turning the model around its axis: Touch the screen with one finger and move it around.
  • Zooming in and out: Pinch-zoom with two fingers bringing them closer or further from each other.
  • Dragging the model: Touch the screen with three fingers and move them around.
  • 3D model view information: The 3D model view allows users to visualize holograms of pins independently from their position in the real world.

Positioning workflow content

To place the content of the workflow in real life, the user needs to scan their surrondings by following the instructions given. 

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.

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.

Settings and  information

Changing settings

In the top-right corner of the main menu, tap on the Settings icon and change any of the following settings:

Language

Defines the language of the application. Currently supported languages are English, German, Portuguese, French, Spanish, Chinese (simplified), and Japanese.

Help

  • Knowledge Base: Redirects you to the Knowledge Base web page.
  • Contact: Redirects you to your default mail application to write a mail to [email protected] address.

About

  • Privacy Policy: Redirects you to the Teamviewer website that contains the various privacy notices.
  • Third Party Copyright: Opens the copyright information within the app.
  • EULA: Redirects you to the section of the TeamViewer website that contains the EULA and the DPA. 

Advanced Settings

  • UI Layout: Allows you to choose where (Right side/Bottom side) text instructions are displayed in the workflow.
  • Show Pin Shapes: Toggle option where you can enable Point of Interests and shapes on the 3D model.

Logout

You can logout from your account simply tapping on this option.

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.

To sign in:

  1. Enter the username and password provided by your administrator.
  2. Tap on Sign In.
  3. After signing in, click on YES to grant access to Spatial Workplace.

Signing out of the app

  1. In the top-right corner, tap on the Profile 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. Enter the new company link and domain name provided by your administrator.
  3. Tap on Confirm.

User interface

Status bar

The status bar is located at the very top of the Spatial Workplace desktop 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 right under the  status bar. 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

Templates screen

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

Tasks

Tasks are used to assign workflows to the users. You can start a task simply by clicking on it.

Cancelling a Task

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

1. On the top-left corner, choose (X) Cancel Task.

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

3. Click on Yes.

Adding comments to a Pin

It is possible to add comments to a Pin.

Tap on the More button (3 dots) in the top-right corner. You can choose from the menu to type your comment or upload media.

 

Then continue with Next.

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.

Controlling the model inside the 3D model view

Steps that contain Holograms can also be visualized inside the 3D model view, which allows for handling the holograms in more detail and separately from the real-life environment. Interacting with the 3D model using a mouse, touchpad, and touch interactions is possible.

  • Mouse interactions:

    • Rotating the model: click and hold left mouse button, move the mouse.

    • Zoom in and out: scrolling wheel of the mouse

    • Dragging the model: click and hold the right mouse button OR the scrolling wheel, move the mouse

  • Trackpad interactions:

    • Rotating the model: click and hold the left trackpad button, and move your finger through the trackpad.

    • Zoom in and out: pinching two fingers on the trackpad (apart and towards each other) OR Place two fingers on the touchpad and slide horizontally or vertically.

    • Dragging the model: click and hold the right trackpad button, and move your finger through the trackpad.

There are options for Reset view and Lock view while viewing the models.

  • Reset View: resets the model position to the default 
  • Lock View: When enabled, fixes the camera on the currently viewed pin. When disabled, the camera automatically pans to show all visible pins, models, and holograms

Templates 

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

The process for workflow navigation, 3D model view, and controlling the model inside the 3D model view 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, for more information, please visit our Custom Themes page.

Settings and Information

Click the profile icon in the right corner of the status bar to access the Settings, About, and Logout sections.

Changing settings

In the drop-down of the profile menu, click on the Settings icon and change any of the following settings:

Language

Defines the language of the application. Currently supported languages are English, German, Portuguese, French, Spanish, Chinese (simplified), and Japanese.

UI Layout

Allows you to choose where (Right side/Bottom side) text instructions are displayed in the workflow.

Show Pin Shapes

Toggle option where you can enable Point of Interests and shapes on the 3D model.

Help

  • Knowledge Base: Redirects you to the Knowledge Base web page.
  • Contact: Redirects you to your default mail application to write a mail to [email protected] address.

Legal

  • Privacy Policy: Redirects you to the Teamviewer website that contains the various privacy notices.
  • Third Party Copyright: Opens the copyright information within the app.
  • EULA: Redirects you to the section of the TeamViewer website that contains the EULA and the DPA. 

About 

In the drop-down of the profile menu, click on the About button to view the current version you have and your IP address.

Logout

You can logout from your account simply clicking on this option in the drop-down of the profile menu..

Basic actions

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

When opening Spatial Workplace for the first time, there are a couple of steps users need to follow.

1. Provide the company URL and domain to pair it with the right server instance. This ensures the correct syncing of the necessary data.

You can either manually enter the information or scan a corresponding QR Code to auto-fill it.

The QR code can be accessed in an internet browser by an admin user in Frontline Command Center (FCC) under Configuration > Application Management > More as shown below:

2. On HoloLens, click on Scan Bootstrap Code to scan the QR code shown in the browser.

After scanning it, the company link and domain fields are automatically filled in and an authentication code appears.

3. On the FCC dashboard, click on ENTER DEVICE LOGIN CODE.

4. Add the 8-letter code to finish the sign-in procedure on the HoloLens with the same user account as in FCC.

Position of the main menu

On the HoloLens 2, the main menu follows the head movements and is not fixed. Users can use their hands to grab the menu and position it elsewhere or use the hand-ray gesture to hold the menu from afar and move it around. The size of the menu can be increased or decreased by holding and dragging one of its four corners.

Selection cursors

The head-gear cursor

In the middle of the view, there is a white circle. This is the head-gaze cursor that can be used to select icons. Users can move the cursor around by moving their head, which makes selecting icons as easy as turning your head at them.

To select an icon, users can move their head until the cursor lies over it and a red loading bar appears inside it. Wait until the bar completes the turn to select it. 

Source: https://docs.microsoft.com/en-us/windows/mixed-reality/design/cursors

The hand-ray cursor

The hand-ray cursor can be used to select objects and holograms that are out of reach. However, the selection ray comes out of your hands.

This cursor starts at the palm of your hand and ends in ring-shaped cursors at the object or icon to be selected. As long as at least one of your hands is inside the hand-tracking frame of the HoloLens, the hand-ray cursor will be activated.

Note: The head-gaze cursor cannot be used while the hand-ray cursor is active.

Source: https://docs.microsoft.com/en-us/windows/mixed-reality/design/cursors

The finger cursor

This cursor is at the point of your index and middle finger and can be used to select icons that are within arm's reach.

Source: https://docs.microsoft.com/en-us/windows/mixed-reality/design/cursors

The cursor does not appear when the fingers are far away from a UI surface (4). When the user gets closer with their hands, a ring cursor appears perpendicular to their fingers (3) and then aligns with the UI surface (2). When contact is made with the interactive icon, the ring shrinks into a dot (1). This selection works exactly like the ones on a touch screen, clicking on icons and buttons by touching them.

Resizing items

While using the HoloLens 2, users can resize all items that show blue highlights on their corners. These include the Workplace main menu and the manner in which the content of pins are shown.

Source: https://docs.microsoft.com/en-us/hololens/hololens2-basic-usage

Voice commands

At any time during a workflow, these are the available voice commands that help you navigate through your steps without using cursors:

  • Done: The following pin with a default connection is shown.
  • Back: The previous pin is shown.
  • Reposition workflow: Tracking is restarted to reposition the content of the workflow.
  • Reset workflow: The workflow is completely restarted.
  • Menu: The main menu of the app is opened.
  • Reset: This resets the position of a billboard to the default. The billboard to be reset must be focused with the head cursor of the HoloLens when the command is spoken.

Note: The Done command only works as expected if the currently active pin does not have a connection with a custom label. For more information about custom labels, see Connecting Pins.

Additionally, if there are multiple Done buttons at different pins when the command is used, the workflow will continue through a randomly picked connection. 

User Interface

  1. Tabs: Allows you to switch between Task & Templates, Workflow Editor, and Call Support tabs.
  2. Status bar: Allows you to view connection status, download all button, and settings.
  3. Navigation section: Allows you to switch between Task List and Templates.

Tasks & Templates

The workflows assigned to the user are listed under Task List and Templates. Here, you can view, download, and execute the workflows. You can start a Task simply by tapping on it.

Cancelling a Task 

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

1.  Choose to Cancel Task from the hand menu.

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

3. Select Yes.

Navigate through the pins by using the control icons around them:
  • Done: Moves on to the next pin or pins.
  • Back: Goes back to the previous pin or pins. If there are pins with auto connections, then Back takes the workflow to the last pin that does not have an auto type of connection coming out of it.
  • Comment: While executing a workflow, it is possible to drop comments on pins by simply tapping on the Comment button at the bottom of the pin content. You can also go back and edit your comments.
  • Workflow menu: The menu contains actions to reposition the marker, to open the main menu, and to choose between the content displays (only for mobile devices, read more under Different Views in mobile devices below).

Note: The Done button may be substituted by another word or phrase if the workflow creator defines a custom label for the relevant connection.

Workflow menu: On HoloLens, the workflow menu stays above the position of the spatial reference. For example, after scanning a marker, the menu will be placed above it. Alternatively, to display the menu next to your hand, simply raise your hand in the HoloLens field of view. On mobile devices, the workflow menu always stays in the top left corner of the screen.

The AR overlay view is the default way of presenting pins in augmented reality over the real component. The pin shape will always be presented in the exact position in relation to the spatial reference. This is the only available view type for HoloLens.

Positioning workflow content

To place the content of the workflow in real life, the user needs to scan their surrondings by following the instructions given. 

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 starting the workflow, a UI element asks the user to tap-to-place. To place the model, users can use the HoloLens air-tap gesture.

Position of the model: The model will be placed in relation to the head position, at the same distance that the model is from the model placement element in the Spatial Editor project.

Adding comments to a Pin

By selecting the Documentation option, it is possible to add comments specifically to a Pin. You can take a photo or record a video as a comment.

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 Adjust Model 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. Users can also choose Restart Tracking option to start over.

Call Support

To access the call menu, you can select the Call Support tab on the top.

Calling a specific expert

  1. On the home screen, choose the Call Support tab.
  2. Under Contacts, select the user.
  3. Confirm the selection.
  4. You will see a new window on your HoloLens with in-call options.

Using in-call options

You can hear and see the video of the other participant through the new window that opens up. On top of the video stream, you have the following features (as marked in the above image):

  1. Disable marking: This button is used to deactivate the marker or paint tools.
  2. Marker: On enabling, you can place pointers to highlight objects in the video stream. You can place multiple markers during a call via hand gestures. To stop adding markers, you need to use Disable marking button.
  3. Paint: On enabling, you can draw to highlight things in your video stream using hand gestures.
  4. Take picture: This button is used to grab a screenshot which is then shared in the chat.
  5. Remove last: With this button, you can undo/remove the last marker or painted object you added.
  6. Clear all: Clears the screen of all markers and painted objects.
  7. Chat: This button allows you to get the chat window back on if previously closed. The chat window opens by default and can be closed if necessary. Using it, you can send and receive messages.
  8. Participants: Displays the list of participants present in the call.
  9. Video stream: Toggles the video stream on or off.
  10. Microphone: Toggles the microphone on or off.
  11. End call: Exits the call.

Accepting or rejecting a call

When another user calls you, the application will show a notification message and play a sound signal. The calls can be answered from any screen that you are working on, even while you are in the middle of a task, to get expert advice.

  • To join the call, select OK!
  • To dismiss the call, select No, thanks.

Log Files

To download log files from Spatial Workplace (Version 4.15 onwards):

  1. After logging in to Spatial Workplace, go to Settings.
  2. Select Download Logs.
  3. You will have 2 options: download Recent Logs(last 24 hours) or All Logs.
  4. After selecting either of the two options, the log files will be downloaded onto your device.

5. To access these log files, connect your HoloLens 2 to your Windows laptop.

6. The files can be found on the following path through the File Explorer:

HoloLens ->Storage ->Downloads ->TeamViewer Frontline Spatial

7. The log files can also be accessed through Microsoft Device Portal under:

System -> File Explorer -> Downloads -> Frontline Spatial -> Zipped logs folder

Settings and Information

Changing settings

In the top-right corner of the window, tap on the Settings icon and change any of the following settings:

Far Interaction

A toggle option that allows users to enable and disable far interaction.

Language

Defines the language of the application. Users can choose the desired language from the list.

Help

Legal

  • Privacy Policy: Redirects you to the Teamviewer website that contains the various privacy notices.
  • Third Party Copyright: Opens the copyright information within the app.
  • EULA: Redirects you to the section of the TeamViewer website that contains the EULA and the DPA. 

Download Logs

Alows you to download all logs or recent logs (last 24 hours).

Signout

You can signout from your account simply tapping on this option.