Knowledge Base

The menu bar which is located at the top of the workspace, provides users with to access the functionalities listed below.

Creating a new project and importing a 3D model

A Spatial project is a file created in Spatial Editor that stores the information about the 3D model in use along with markers, pins, and other content added to it.

1. After signing in, click on Create New Project.
2. Click on Import Model in the top bar and select the file you want to upload.
3. To try it out, you can download this file. It is a 3D model of a pump that is also shown as an example to explain features in the subsequent text.
4. Choose the import scale according to your requirements. If you are using the pump model, you can select Meter (Note: Do not worry if the chosen scale turns out to be incorrect. This can be changed later in the model settings. If the pins added to the workflow seem to be too big or too small, the scale needs to be adjusted accordingly.)
5. To change the orientation of the model, click inside the Scene Explorer on the left of the window. For the pump model, you can select the “WaterPump” root assembly of the model and then use the Transform or Quick-Rotate menu on the right to adjust the model as needed.
6. To rotate the 3D scene, left-click over the scene and drag the mouse. Doing the same with a right-click instead pans the scene. Scrolling with our mouse wheel zooms in and out of the scene.

Saving a project as .v3pproj file

Project files are created in the Frontline Spatial Editor and contain information about the 3D model in use, along with the markers, pins, and content added to it. The projects can be saved locally in the form of a .v3pproj file. To do so:

1. Click on Save in the top menu.
2. Choose the folder where the file should be saved.
3. After the file is saved, the name of the saved project appears at the top of the software window. If there are any unsaved changes in the project, the name is followed by an asterisk (*).

Export Model

To export the model:

1. Select the Export Model option on the top.

Export a workflow to FCC

Workflow files contain the components of a workflow, which are basically a set of pins that portray information over a real component, e.g. a machine. Additionally, at least one marker (or other spatial references) is added to the workflow to enable the correct positioning of the pins over the real component.

To export workflow files:

1. Once the user is done editing the project in Spatial Editor, they can click on Export Workflow > Export Workflow to FCC in the top menu to upload it to FCC where they can manage it.
2. By default, the editor automatically creates a template from this workflow and assigns it to the currently signed in user while uploading it to FCC. This way, the template will be already available on the user's device once the upload has been completed. However, the user can also choose to uncheck the Create Template checkbox to later create a template or task manually in FCC.

3. The user can select the preferred device for the upload and click on Export.

4. After the upload has been completed, the user can see the template in the template list of their selected device.

Mandatory Workflow Update

Frontline 4.27 requires users to reupload their workflows to remain compatible. Before following the steps to do that, please make sure that your local files are ready and that Spatial Editor is on version 4.26:

1. Create a backup of the project file. (optional but recommended) 

2. Locate your project in your Windows File Explorer and open your project in Spatial Editor (v4.26) 

3. Save it with a new name (e.g. editor_project1_BACKUP.v3pproj).

4. Update Spatial Editor to 4.27.

5. Open the original project file, the non-backup, (e.g. editor_project1.v3pproj) in Spatial Editor (v4.27).

6. Wait until fully opened and then Export to FCC.

Workflow assignments

In Spatial Workplace, all assignments happen based on user accounts. A task or template is assigned to a user via FCC, which makes them available for the user to view on any device after they have signed in to Spatial Workplace. For more information on how to assign previously created templates to other users and how to further manage them, please see the Templates section of the Solutions guide.

Workflow Languages

Workflow Language is the language that appears in the UI of the Editor, which appears in the inspectors of the pins, and in the connections for a particular workflow. It appears everywhere where there is a string in the workflow inside Spatial Editor. This is the default language for all tasks that originate from this particular workflow.

Users can extract all the strings present in a workflow in a CSV file and get them translated by an external translator or translate the strings themselves in the CSV file outside Spatial Editor. This will allow reusability of the same workflow in different locations.

To translate the present strings in a workflow:

1. Select Language from the toolbar.
2. Click on Add to choose the additional language you want the workflow to be translated into.
3. Click on Export CSV.

In order to display the CSV file correctly, the user should uncheck the Use system separators box in Excel (File -> Options -> Advanced). The user should then configure the default Decimal Separator as comma (,) and Thousands Separator as period (.).

In the file, the first column contains string IDs. The second column has the existing strings in the chosen Workflow Language, and the rest of the columns represent other languages.

These additional language columns will be empty for untranslated strings. Users must translate these strings on their own or hire an external service.

4. After getting the file translated, go back to Spatial Editor.

5. Click on Language from the toolbar.

6. Click on Import CSV.

7. Upload the new file.

⇒ The additional languages are added to the workflow.

Settings

Settings gives users options to configure the Editor, Pin content, keyboard hotkeys, and text-to-speech.