Table of Contents
Last updated: 10/9/2024

Supported web browsers


The supported Web Browsers for clients running the ShareAspace Web User Interface are:

  • Google Chrome
  • Microsoft Edge

Supported releases of the ShareAspace Web User Interface will continuously be kept up to date with the latest (evergreen) updates of the browsers listed above.

Collection


The ShareAspace Nova Collection Home Screen is often the first place where you as an end user will end up after login. From the Collection Home Screen it is possible to navigate further into the Spaces that you have access to.

Log on


When signing on to ShareAspace Nova following default configuration for the collection site https://myServer/sasweb you will end up at the Collection home screen.

Login form using ShareAspace Identity Provider

Login

Tip

It is possible to follow a link to navigate straight to a specific Space after sign on. More on this in the Space section.

Layout


Collection Layout

1. List of spaces

The list of Spaces will list all Spaces to where you have been invited. A Space can be based on either an InReach or an InControl Space Template.

To navigate to Space start page, simply click on one of the Spaces presented in the list.

2. News

The news section is visible to all users invited to the collection. The Collection Administrator controls the information put under the News section.

3. User menu

User Menu

From the User menu, while on the collection level you have two options. Edit your user profile (Collection Profile), manage your personal access tokens (PAT), and sign out. If you are a Collection Administrator you will have one more option. More on that here.

Collection Profile

My Profile

Setting Description
Display name What will be presented in the application where you as a user are referenced.
Avatar upload You can upload an image file to be used as you user avatar. Use a square image to get the correct aspect ratio. Supports png and jpg.
Language The default language setting used by default in all Spaces. Can be overridden on each single Space. By default ShareAspace only supports English. This is however configurable
Time zone The default time zone to be used when presenting dates and time within the application. Can be overridden on each single Space.
Change password If ShareAspace is setup to use the ShareAspace Identity store, clicking this link will allow you to change your ShareAspace password.

Personal access token

Clicking the "Personal access tokens" item in the user menu brings up the PAT administration. All PATs that you have created will be listed here.

Personal access token list

Using the actions in the ribbon menu you can:

  • Create a new PAT.
  • Revoke an existing PAT.
  • Extend the life time of an already existing PAT.
Create a new PAT

Create new PAT

When creating a new PAT you need give it a unique name and set the validity time of the token. Once done you click "Save changes".

New PAT created

This brings up another window allowing you to copy the newly created access token.

Note

ShareAspace will only provide the PAT value when it is first created. The PAT is not stored in ShareAspace so there is no way of getting the value for a specific PAT at a later time.

Important

The PAT should be kept secret and handled with care.

4. Get back

From anywhere within the ShareAspace Web Application you can always navigate back to the Collection Home Screen by clicking the ShareAspace Logo.

Space


When navigating to a Space via a direct link or by navigating from the Collection Home Screen; you will end up on the start page for that specific Space.

Tip

You can use a direct link to a Space, by default it will look like this: https://myServer/sasweb/space/{spaceId}. The web application will make sure to first redirect you to the authentication page if you are not already authenticated.

Main Layout


The landing page for the Space might look a bit different depending on the configuration of the Space and your active Role. However there is a generic layout, independent of the configuration.

Space Layout

1. Get back

From anywhere within the ShareAspace Web Application you can always navigate back to the Collection Home Screen by clicking the ShareAspace Logo.

2. Get Back to Space Start

Takes you back to the Space Start Page.

3. Modules

This section will show tile icons for Modules that you have access to. The icons are often grouped together by functionality. By clicking on a module icon that Module will open in a new tab within the Space User Interface.

As a user, you can specify what Modules you want to display on your start page selecting from what Modules you have access to with your current Role.

Tile with number

Some Modules can display a number on the tile. This number is the result counter for a query, i.e. it shows the total number of hits from a query. In the example above the counter shows how many Work items are assigned to the current user. If the total number of hits of the configured query exceed 1000 hits the number indicator will display -1.

What modules are available and what their names are fully depends on the configuration of the Space.

4. News and Space name

The news and Space name settings will show the News set for the current space as well as the name of the current space.

The news is managed by the "Space Administrator" (users with the Manage Space Definition access modifier on one of their roles).

The name is managed by the Collection Administrator.

5. Favorites

Favorites are objects that you decide you want to see here in this "space" screen. They will stay here in this screen until you once again choose to not see them here any more. See the Favorites section for more information about creating/removing/using favorites.

6. User Menu & Modules Menu

Like on the Collection Home Screen the User Menu is in the top right corner. This menu is always available to you but the contents of the menu will vary depending if you are in a Space or on the Collection Home Screen. However, included in this menu is the "Modules Menu."

The top will display your configured Display Name and your uploaded avatar image.

While in the context of a Space your current role will show beside your Display Name (using the format Role@Participant).

User Menu

The bottom half of the menu after the horizontal line is the "Modules menu" which is a list of all modules you are allowed to view for your role in the space.

Note

Some Modules requires input parameters to start. These Modules can only be opened from within other Modules. I.e. it is not possible to have a tile link to these Modules. Also, Modules with start parameters will not show up in the Modules Menu.

My Profile

My Profile will let you edit your user's Collection Profile see Collection profile.

Files

Files will bring up the files modules in a modal window. For more information about the files module, see the File management user interface.

My Space Settings

My Space Settings will bring up a form for setting Space specific settings for your user account.

My Space Settings

Setting Description
Current Role Displays your current active Role and let you switch the active role, picking from all Roles you have been given within the Space. The selection will be stored as your default role, i.e. the selection will be kept when you log on the next time.
Mail Out When unticked the System will not be able to send Space specific emails to your email.
Language The language settings for the current Space. Will default to your Collection settings but can be overridden on each Space.
Time zone The time zone settings for the current Space. Will default to your Collection settings but can be overridden on each Space.
Effectivity Your current effectivity filter setting. More details under advanced.
Application Context Your current Application Context filter setting. More details under advanced.
Identifier Context Your current Identifier Context filter setting. More details under advanced.
Owner Context The Participant that will be the Owner of new Unit of Informations created. This will be the Participant for the the current Role that you have selected. You can only create Unit of Informations if that Role has the Create access modifier.
Modules A list of all available Modules that does not require input parameters to open. If the Put on homescreen checkbox is ticked, the Module tile for the specific Module will be displayed on the Space Home Page.

Advanced

Advanced

Tip

Start by reading about the the concepts of Information filter.

Setting Description
Effectivity The effectivity settings used to filter effectivity controlled references. When enabled and Mode is set to Live, all information fetched from the system will be showing what the information looks like at the time of the request and Role Actual. When enabled and Mode is set to Explicit, it is possible to set a point in time as well as defining the Role to filter on (Actual or Planned). Disabling the effectivity filter does not apply to SoftTypes - it can only be used with the Model Browser and the Binary export. If disabled, the system will return the full history of information.
Application context Only applicable to the Model Browser and Binary exports. Defines what Application Context to use when filtering Master-Version-Definition objects.
Identifier context Only applicable to the Model Browser and Binary exports. Defines what identifiers and names should be presented as default (based on the context of the identifiers and names).

Sign Out

Will make you sign out from the system. To get back in. You will need to go through the login process again.

7. History

By clicking on the "history" icon in the upper right-hand corner of the screen you can see a history of all objects you have clicked on in the current session.

History

See the History section for more information about history.

Module Layout


There are many different kinds of Modules in the ShareAspace Web Application. While the layout and design might differ there are a couple reoccurring designs and layouts.

To exemplify this we use a configured Authoring Module from the InReach Knowledge Transfer Space template. This Module deals with authoring of Parts and Documents.

Authoring Module

As the name entails the Quick Search lets you quickly search for information handled by the Module. The Quick Search can be configured to run any Query that takes one input parameter. What this Query does is entirely up to the configuration however the Quick Search is often configured to take id and/or name as the input parameter.

2. Query List

The Query List will show Queries configured for the Module. The Queries are grouped under three categories, Space, Participant, and Personal.

Queries listed under Space are Queries that was part of the Space Template configuration.

Queries listed under Space are Queries that has been setup during runtime. These Queries has been configured by someone with Write Access to a Participant to which
you as a user has the minimum of Read Access.

Queries listed under Personal are Queries that you as a user has defined for yourself.

Finally there is a Section, Charts, this section will list queries that also has a chart view configured.

Queries that are defined with values for the search terms will also be executed directly when selected. Queries that have empty values for the query terms will first require user input before the query is executed. The default query of a module will always be executed by default even if it requires user input. For this case the input fields will be ignored until they are given values by the user.

All queries can be opened in the details mode. This is done by clicking the magnifying glass.

Edit query

From this view it is possible to change the parameters of the query terms. It is also possible to redefine the query completely and executing it even without having to save the query.

Depending on the user's access to the query there will be different actions available on the query itself.

  • Save - If the user has access to edit the query this option will be available. Save will save any configuration done to the query at runtime.
  • Save as - Allows the user to save a copy of a query. Depending on the user's access this query could be stored on:
    • the Space - the query will be available to everyone within the space.
    • a Participant - the query will be available to all users with a role in that Participant.
    • a personal query - the query will be personal and only be available to the user that created the query.
  • Advanced settings - If the user has access to edit the query it is possible to quickly access the advanced configuration. From here the user can control the query in full, this includes controlling what columns should be displayed etc.

You can read more about how to configure queries at runtime in the Index and queries user guide.

3. Query Result

The Query Result is the main area of the Module. Here you will be able to see the result of a Query.

Some Modules are configured to run a Query when the Module is opened.

Some Queries take input parameters, in which case you will first be asked to provide the input before the query is executed and the results are displayed.

Query input

The result counter of the Query result will stop counting when reaching more than 1000 hits. The user interface will then display, 999+ hits. You can however still page past 1000 hits.

At the bottom of the result list you will see the page navigation.

Tip

You can reorder the result by sorting descending/ascending on the Query result columns. Just click a header title to sort.

4. Export CSV

In some configured modules you will also be able to see a button, "Export to Excel". Clicking this button will export the full Query result to a CSV-file (with a maximum of 10 000 records).

5. Ribbon Menu

At the top of the Query Result there is a ribbon menu. This menu can have buttons, both static (e.g. Create) as well as object context dependent.

Object context dependent buttons require you as a user to first select and object from the Query Result.

What buttons that will show up in the ribbon menu depends on both the Configuration as well as your current Role and its' access.

6. Object Viewer

The Object Viewer will present detailed information about the object selected in the Query result view.

7. Module Help

If the configuration contains help link configurations, clicking the question mark will open the documentation for that specific module.

8. SoftType Help

If the configuration contains help link configurations for the SoftTypes, clicking the question mark in the Object Viewer will bring up the documentation for that specific SoftType.

9. Module Tab

Each opened module will be presented as a Tab in the ShareAspace Web Application. When hovering the mouse over the Tab, two buttons will show. One for reloading the module content and one for closing the module.

It is possible to have multiple instances of the same module open at the same time.

10. Query result navigation

This will show you what page of the query result you are looking at. It will also contain clickable navigation texts to navigate between the query result pages.

11. Favorite

This star you can click on to select the object as a favorite. If the star is yellow then it is already a favorite. Clicking on a yellow star will remove the object from the favorite list.

To navigate between modules simply click the module tab for the module that you want to navigate to.

As state earlier, some modules require start parameters, i.e. these module cannot be opened from the Module menu. One example of this is using the Open in ribbon button.

Open in

Tip

It is possible to use links, so called deep links to directly navigating to a module. Example: https://myServer/sasweb/space/{spaceId}/{moduleId}.

History


There is a "history" list of all SoftType object instances that you have selected in any window during your nova session. You can see this history list by clicking on the History icon open history window in the tab row as shown below:

Open history window

This is a "toggle" button so click on the icon to show the history and click on the icon to hide the history.

When clicked, the window will appear and look like the following:

History window

You can keep this history window visible during your entire session in all views.

Select history item

If you let your mouse pointer hover over one of the items in the history list then 3 dots appear at the right hand side of the row:

Sub menu

Click on these 3 dots and a sub menu will appear and you may then view the object in any of the views shown in the menu

Sub menu

Please note that your menu will most likely be completely different then the menu shown here because this menu is very SoftType/role specific.

Special constraints

Keep in mind the following 2 constraints about history:

  1. The history is only valid for one session. When you log out the history is erased.
  2. There is a maximum of 100 items allowed in the history list. After that the oldest history items will be erased.

Favorites


Favorites are objects that you decide you want to see in the "space" screen. They will stay here in this screen until you once again choose to not see them here any more.

Space layout

You have the option to select a favorite in the "Read view" of an object. In the example below we have:

  1. Selected an object.
  2. If you click on the white star, then the object will show up in the "space" screen and thereby be a favorite. When an object is a favorite, the star will be yellow. By clicking on a yellow star then the object will no longer be a favorite

Favorites select

Below you see how it looks in the favorite screen when there is one favorite. By clicking on three dots beside the favorite, you will see a menu where you can select which screen you want to see this object in.

Favorites

This menu screen is very object dependent so your menu will most likely be very different then the one shown here.

Favorites menu

Role settings for favorites

The favorites list is by default role specific so that if you change to another role, then the favorites list will probably be completely different. You can however change this default functionality by:

  1. Clicking on the space settings menu.

Settings menu

  1. Open the "advanced" section.
  2. Choose "Any role" in the "Favorites role" dropdown list-box
  3. Hit the "save" button.

You will need to do this for each role that you want the "any role" functionality in.

Settings


When viewing an object in any of the modules that supports the "Read view" of objects it is possible to copy a link to that object in that module.

Clicking the copy link button (1).

Copy link

A link to that object in the current module will be saved in the clipboard. A notification in ShareAspace will appear when the save happens.

Link saved to clipboard

You can paste this link in any application. As an example this link can be pasted into an email and sent to some one that should look at this object information.

Note

The people that receives these links will be required to sign in to ShareAspace to view the object. It is also required that these user have access to the actual object. If not they will just get the "No access" prompt when trying to use the link.

Compare


It is possible to "compare" any two versions of any objects. Particularly useful is the comparison of 2 versions of the same object. This comparison may be designed to show only those fields that you might find interesting for such a comparison. The comparison highlights differences.

Note

Because the "Compare" functionality is highly configurable, your menu item texts and views will most likely be very different than all the illustrations shown here.

Start from a known object

There are a few different ways to come to the compare window. Perhaps the most useful is start from an object you see that you want to compare:

  1. Select an object you want to be compared.
  2. Hit the "Open in" menu.
  3. Select "Compare" in the menu.

Start compare

When you come into the compare window, you must select the second object to compare to:

  1. Enter the first few characters of the id of the object you want to compare to.
  2. Select the object you want to compare when it appears. If there are more then one version of the object then you must select the version of the object as well.

Select item

Finally you have defined exactly which items you want to compare and your comparison is shown with differences highlighted in a yellowish color:

Compare Window

Start from a main menu

You might also find your "compare" in either the main space screen or the "Module" menu.

The Main Menu might look something like this:

Compare Window

The module menu might look something like this:

Compare Window

Then you get a completely empty "compare" window where you must search after the two items you want to compare with the "quick select" text boxes:

Compare Window

Copy object and new version


Copy and new version

Copy

When enabled, clicking the Copy button in the ribbon menu will allow you to create a new object by copying all the data from the selected object.

In order to perform a copy:

  • You need to have full read access to the object that you are copying.
  • You need create access in the participant where you want to put the new object.

When copying an object the copy will always copy everything from the copied object, no matter if it is visible in the edit form for the copy operation or not. Alterations made in the form will be merged with the copy operation, i.e. changing values, adding or removing things to a list will override those parts of the copy operation.

Note

When copying information via new version or the copy object, only the latest active values are copied. Historical data (out of the current date and time effectivity) will not be copied.

New version

When creating a new version you have two options.

  • To create a blank new version.
    • With this option you will be presented with a view for filling out data for the new version to be created.
  • To create a full copy of the previous version. This option is accessed by marking the "Copy characteristics" check box. With this option you are presented with a different view where you have the ability to make changes on what to copy.
    • "Copy characteristics" will always copy everything from previous version, no matter if the information is visible in the view or not. Alterations made in the new version form will be merged with the copy of the previous version.

In order to perform a "Copy characteristics" operation, you need to have full read access to the previous version.

Copy characteristics

Multi select/edit


If you select two or more objects in a query window then a "MultiEdit" menu item could appear allowing you to edit several objects at the same time. in the example below, the "MultiEdit" menu is called "Approval."

Select two or more

Note

Because the "MultiEdit" functionality is highly configurable, your menu item texts and views will most likely be very different than all the illustrations shown here.

Press on the "Approval" menu item and a "multi-edit" dialog will appear.

Be aware that each field in the "edit" dialog shows you a quick comparison of all the selected objects:

  1. If the field is blank then that means that either the values in this field in the selected objects are differing or that all values in this field in the selected objects are all blank.
  2. If the field is filled in with a value then that means that all values in this field in the selected objects are identical and are equal to the value shown.
  3. The fields might be disabled which means they are only for viewing purposes and not allowed to be edited.

multiedit Dialog

Keep in mind while editing the fields in the dialog that:

  • If you leave a blank field blank, then the values in this field in the selected objects will remain the same as they were (differing) after you hit update.
  • Any fields you enter a value into will change all the selected objects respective fields to that newly entered value.

Model Browser


The Model Browser is an "Information Expert" view of Unit of Informations.

It presents how objects are persisted in the ShareAspace database according to the ShareAspace Nova Core Model.

It is possible to either start the module and search for an object or starting the module by passing an object as a start parameter from another module.

The module can present instances of SoftTypes as well as imported data that have no SoftType representation.

Layout

Layout

The left hand side structure shows a hierarchical representation of the object graph for a Unit of Information.

The center shows the metadata of a selected Object or Entry. It is possible to navigate to other Unit of Informations by following links to them from within the model browser.

The right hand side list shows a history log of the navigation between different Unit of Informations.

Ribbon Menu and Edit

From the ribbon menu, depending on your current access to the selected, Unit of Information, there is a set of operations.

Ribbon Button Description
Information filter Lets you control the information filter settings for displaying and navigating the information within the Model Browser.
Delete Deletes the selected Unit of Information or Entry. Requires delete access to the data.
Change Owner Lets you change the Owning Participant of a selected Unit of Information (or other pivot object).
Caution

Deleting a Unit Of Information will neither remove it from indexes nor will it remove references to the Unit of Information (from other UoIs).

Edit

Provided that you have the appropriate access to the information, selecting entries, will allow you to edit and/or remove values. This is done using the pen-button and x-button in the detailed view.

Edit

Caution

Use this functionality with caution!

Participant


The Participant module lets you setup Sub Participants for the predefined Participants that have been configured at space creation time.

Module Layout

To open the Participant Module either use the tile icon on the space main page

tile-icon

or the corresponding menu item within the Module Menu:

module-menu

The layout is very similar to the authoring module described in the Space user guide.

Layout

On the left side of the screen, is a tree view that presents the structure of Participants and Sub Participants.

Note

The list of Participants is created together with the Space creation and is not modifiable after.

This module only allows to manage Sub Participants. Read more about the Participant and Sub Participant concepts. .

When selecting a Participant or a Sub Participant, the Object viewer panel displays the following:

  • General information about the selected Participant
  • Internal rights (restriction rights to access the data owned by the Participant for any role given to users within the Participant)
  • External rights: rights that the selected participants has on the other participant (Received) and rights that the selected participants has allowed for other participant (Granted).

A greyed out access right acronym indicates that this rights is disabled. A black bold access right acronym indicates that this rights is enabled.

Create Sub Participant

In the main panel or in the tree on the left select a Participant [1] , a toolbar will appear on top of the main Participant panel table [2].

create-menu

Click the Create button to create a Sub Participant owned by the selected Participant.

create-sub-participant-1

Scroll down and you can access the other attributes that can be edited.

create-sub-participant-2

Attribute Description
Participant Definition The name of the Participant SoftType that will be instantiated for creating the Sub Participant
Id The unique business identifier for the Sub Participant
Organization Name The name of the Organization corresponding to this Sub-Participant. Each Participant or Sub Participant actually have an instance of the Organization PLM object associated (same id as the participant and the given name here).
Internal Access Rights the list of internal access right for the Sub Participant. link
Roles Add users that will be set in the corresponding roles. Those roles are the same as the one defined at the Participant level.
Granted Rights Set access rights for each other Participant into the created Sub Participant. By default the Participant for which the Sub Participant is created is granted all access rights.
Note

To enable/disable Access Rights click on the corresponding acronym. If the acronym is bold black then it is enabled, if it's greyed out then it is disabled.

After creation, the Sub Participant will be available under the Participant in the tree on the left:

create-sub-participant-3

The depth of the participant structure is not limited.

sub-participant-structure-depth

Modify Sub Participant

In the main panel or in the tree on the left select a Sub Participant, a toolbar will appear on top of the Participant panel table.

edit-menu

Click the Edit button to modify the Sub Participant.

edit-sub-participant

The only characteristics that can be modified in the edit dialog for a Sub Participant are the access rights granted for other Participants.

Security


If you are the administrator (you have a role with the Grant User Access access modifier) of a Participant in a Space you will have access to the Security module.

From the Security module you can manage all users' Role assignment to your current Participant.

You can also invite new users to the Space and your Participant.

Layout

On the left hand side you will get a list of all users that have been given a Role within the current Participant. By selecting a user you will get a detailed view to the right.

By selecting a user you will also see that the ribbon menu is updated with the Edit and Remove buttons.

Layout

Invite

To invite one or more users to the Participant, click the Invite button on the ribbon menu.

Invite

Select what roles should be given to the invited users. The list of available roles are dependent on the Space Configuration template.

Under Invitees type the email addresses of the people that you want to invite to the Participant. It is possible to invite more than one person at the time. Separate the email addresses with a semicolon ;.

Under Message you can write a message that will be included in the invite email sent out to the invited people.

Edit Access

To edit what Roles an already invited user should have within the current Participant, select the user in the list and click the Edit button in the ribbon menu.

Edit

Check and/or uncheck the checkboxes for the roles in order to achieve the result you want.

Remove all Access

To remove all Role Assignments (all access) from a user to the current space. Select the user from the list and click the Remove button in the ribbon menu.

Project


The project module is used for managing the project information. InReach templates comes with an instance of a Project PLM object and the Project Module is configured with a link to that object.

From the Project Module it is possible to manage the state of the project, the project metadata, as well as managing the News for the Space.

Layout

The project module displays meta data about the Project instance. The intention is that the project represent additional information about the space.

Layout

Project News

If you are the space administrator (i.e. a role with the Manage Space Definition access modifier) you will see the Edit Space News button in the ribbon menu.

Clicking this button brings up a form with a markdown editor that lets you set the Space News.

The Space News is visible to all users invited to the space and is displayed on the space start screen.

Edit project

Clicking the Edit project button in the ribbon menu brings up a form for editing the metadata of the referenced Project instance.

Next phase

Clicking the Next phase button brings up a form for changing the Project's Level State.

This is the same form that is used for managing the states of all objects configured with a Maturity System. Read more about the Maturity Systems in the Maturity system user guide.