Data sharing – manage sessions

The Data Sharing module enables provider organizations to exchange data of specific assets (vehicles) with different leasing organizations. After the contract manager of the data provider organization creates an agreement (and optionally a contract), the session manager can create a session to activate the data sharing mode.

Role and permissions #

This matrix outlines the responsibilities of the Contract manager and Session manager role and the accompanying permission sets.

Role	Responsibility	Permission
Session manager	Create sessions under a contract	Full CRUD (create, read, update, delete) functions for sessions

Add a session #

After an agreement is created, the session manager must create a session to initiate the data sharing process with the data consumer organization.

Sessions created under FWA	Sessions created under contracts
– The edit option to modify the session validity date is available. – If a session is pending, both from and to dates can be modified. – If a session is running, only the end date can be modified.	– The edit option to modify the session validity date is unavailable. – If a session is created under a contract the dates are automatically pulled in and the period duration cannot be modified for any asset (pending and running). – The Session manager must be provided control while creating a session under contracts.

1. From the left navigation pane, click Sessions . The Data sharing sessions page is displayed.



2. Click Create session. The Add new session dialog is displayed.
   
3. Enter information in the Data consumer organization and Framework agreement fields. The Contract field becomes available.
NOTE:
• In the Framework agreement list, you can view agreements specific to the selected organization.
• Data consumer organization and Framework agreement information are mandatory fields.
4. Select the contract from the Contract list, and then click Continue.  The Create new data sharing sessions page is displayed.



NOTE:

Creating a contract is optional. If the contract manager has not created a contract for the consumer, no option for contract selection will be available.

Add new data sharing sessions #

1. On the Create new data sharing sessions page > in the Session validity section, select the date and time range.
NOTE:
• If the period duration of the data sharing session is specified in the contract, the date and time range are automatically pulled in.
• In the Session validity section, if the start date is not selected, the session starts immediately and goes to running state. If the end date is not selected, the session continues indefinitely.
2. In the Shared entity details section, select the asset sub type, for example, in case of trailer asset type, the sub type selected could be ‘Dry vans’.
3. Click Add assets. The Add assets dialog is displayed.



NOTE:

At a time, up to 25 assets can be selected irrespective of the Framework agreement and/or contract definition.

Asset selection is limited to the number of sessions specified in the contract.

4. Select the required assets from the list, and then click Add. The selected assets are displayed in the Shared entity details section on the Create new data sharing sessions page.



NOTE:
• You can select the active and inactive assets from the list to create a session. If an inactive asset is selected, the data sharing session is initiated after the asset turns to an active state.
• If the provider specifies the assets to be shared in the contract, these assets and asset kinds are selected automatically while creating a session.
• You can change the asset kinds only if it is allowed by the provider in the contract.To filter the assets in the Add assets dialog, click Asset type.
• You can select only one type of asset from the Asset kinds list. To revert to the default filter option, click Reset.
5. On the Create new data sharing sessions page, click Save. A new session for data sharing is created.
   

View sessions #

You can view the running, pending, and stopped session details on the Data sharing sessions page on the Our sessions and Shared with us tabs.

1. From the left navigation pane, click Sessions . The Our sessions tab is displayed on the Data sharing sessions page.



NOTE:

On the Our sessions tab, you have provider control and can edit or stop a session. For more information, see how to edit or stop a session.

2. On the Sessions page > click the Shared with us tab to view sessions shared with you by another organization.
NOTE:

On the Shared with us tab, you have consumer control and you can only view the session details for the shared assets. Any other actions are not allowed. You can contact the provider organization to make any changes.

Available columns

Columns	Description
Session ID	The session ID generated for the session created
Shared entity	Asset or unit type shared with the data consumer
Our asset name/unit IMEI (International mobile equipment identity)	Asset name or the unique identifying number assigned to the asset by the data provider organization
Data consumer asset name	Asset name assigned to the asset shared with the consumer
Consumer organization	Consumer organization name with which the asset data is shared
Valid from	Session start date and time
Valid until	Session end date and time
Framework agreement	Agreement name created for the consumer
Contract	Contract name created for the consumer
Value proposition	Value proposition (VP) selected for the consumer Important considerations To share asset data through a session, you can select a single value proposition. You can create multiple sessions to enable selection of other VPs. If a contract is mandatory, VP selection is restricted to the value propositions defined in the contract. In this example, the following VPs (shown in this image) have been configured in the Framework agreement that has no accompanying contract. Hence, the Session manager can select from among multiple VPs for asset data sharing. To view all the VPs and their status, click View all. The Value propositions popu-up is displayed.
Status	Status of the session created: Running, Pending, or Stopped. NOTE: The status of the asset will be inactive after the session period is over.

Edit a session #

You can edit the date and time for an ongoing session or a session that is yet to start.

1. From the left navigation pane, click Sessions . The Data sharing sessions page is displayed.
2. On the Our sessions tab, select a session from the list. The selected session information page is displayed.
   
3. In the Sessions validity section, click Edit . The Session validity page is displayed.



4. In the To date and Time fields, select the date and time, and then click Save. The date and time for the session is modified.
NOTE:
• If a session is active or running, you can only modify the end date. The Time field is enabled after you select the date.
• If a session is inactive or pending, the start and end dates can be modified.

Stop a session #

A session can be force-stopped before the set end date.

1. From the left navigation pane, click Sessions . The Data sharing sessions page is displayed.
2. On the Our sessions tab, select a session from the list. The selected session information page is displayed.
3. In the Stop this session section, click Stop. The Stop session dialog is displayed.
NOTE:

The Edit option to edit session validity is available only if the session is created under an FWA. The edit option is unavailable for a session created under a contract.




4. To confirm, click Stop. The status of the session changes to Stopped and it becomes inactive.
NOTE:

After a session is stopped, the action cannot be reversed. All the extended sessions linked to the parent session will stop as well.

Search a session #

On the Data sharing Sessions page, you can search for a session by entering the asset, consumer, framework agreement, or contract name in the Search box.

Filter sessions #

You can filter the sessions to view records that are active or have been inactivated.

On the Data sharing sessions page > click the status and select the required option from the list.

The results matching the selection criteria are displayed.

Customize columns #

You can customize the view on the Sessions page by displaying or hiding the columns.

On the Data sharing sessions page > click Columns, and then select the required checkboxes from the Column display list. The sessions list view is rendered based on the selected columns.