Collaboration

A Thread is a communication between users in a discussion list. Threads be made private or public based on your requirements.

There of two types of discussion threads:

• Public Thread: Any user with access to the artifact (scenario/report) can view the thread.

• Private Thread: Access to the thread is controlled by the owner of the group. Only users who are given access by the group owner will have access to private threads.

Collaboration facilitates communication in the form of discussion threads. Users can post comments, upload files, post status messages, makes comments and like the discussion.

For example, you can create a group for a planning scenario. All users who have access to this scenario can view the thread from the Planning Control Panel or in the widget on the main page that is available to show all threads if public. If private, access to the thread is controlled by the owner of the discussion thread.

To configure collaboration details:

1. Navigate to Maintenance > Admin > Configuration Tasks. The Configuration Task List page is displayed.

2. Click Collaboration Configuration. This opens the Collaboration Configuration page.

3. Click Enable Configuration. This below fields are enabled.

   • Service Provider - Select the name of community link provide from the drop down list.

   • URL - Provide the community URL.

   • User Name - Provide an Administrator type of user name created in Socialcast. Ideally, use the same account that you created.

4. Click Authorize. You must authorize Socialcast to access your Planful account by providing user ID and password as this requires OAuth authentication

5. Click Save.

1. Navigate to Maintenance > Admin > Configuration Tasks. The Configuration Task List page opens.

2. Click Collaboration Configuration. This opens the Collaboration Configuration page.

3. Click Collaboration Mapping. This opens the Collaboration Mapping page.

4. Choose users required for Collaboration. Only the users in the Mapped Users pane will have access to Collaboration.

5. Select the users to map/unmap accounts from Socialcast.

6. Mapping creates user accounts in Socialcast using the same user accounts that are available in Planful. Users can however, create accounts directly in Socialcast as well and map them using the Collaboration Mapping page.

7. Unmapping deletes user account from Socialcast.

8. User creation is performed user by user. When the first user is mapped, Planful tries to create a user in Socialcast and confirms the user creation. Next, the user can be mapped or a bulk mapping can be done.

9. Click Save.

1. Navigate to the Planning Control Panel. A list of scenarios that are accessible for users are displayed. Select a scenario and click the Chat icon.

2. When you click the Chat, you create a discussion thread for a scenario. The user who creates a thread becomes the owner of the thread.

3. Make your discussion public or private depending on your privacy policy and the content being discussed.

• Select Public, to allow all users with access to the scenario discussion.

• Select Private to make the discussion available only to approved users.

Once a discussion is created, anyone with access to the scenario can join the discussion by clicking the Chat icon.

Threads are unique. They apply only to a single artifact (Scenario, Budget and Reports).

1. Navigate to Reports > Dynamic Reports.

2. Select a report. The Collaboration icon is displayed in the right side of the menu.

This opens the discussion thread. You can collaborate with other users using the collaboration for dynamic reporting.

• For every report, there is only one thread, which is applicable only to that report.

• Collaboration appears as a small icon in screens to which you have access to.

• If a discussion thread is already created for a scenario or report, and if you are provided with access permissions, the content streams within the Collaboration widget.

Apart from Planning Control Panel and Dynamic reports, you can click the Collaboration icon on the left navigation pane.

Click the Collaboration icon on the left navigation pane to display the Planful:Home Stream page. The Planful:Home Streampage provides a discussion thread applicable to your environment. On this page, you can post status, likes, and comments in discussion forums.

A discussion thread is created when you click Create Discussion in the Collaboration widget.

The user that creates the thread owns it.

The name of the thread is based on the configured attributes or combination of artifacts that are configured as contexts for discussion threads.

For example, a discussion thread for a scenario is created as “Scenario Name”. A discussion thread for a report is created using the name of Dynamic report.

For instance, let's say a scenario and a Dynamic report have the same name. To avoid confusion, when a discussion thread is created it is suffixed by the type of discussion. For instance – Scenario “Budget 2016” will be created in Socialcast as “Budget 2016 (Scenario)” and a report is created with the Report suffix as follows: “Budget 2016 (Report).

Security for a discussion thread is enabled when a thread is created as Private or Public. For a Private discussion, when a user tries to access the thread, a Collaboration widget displays an option for the user to place a request. The request is sent to the owner of the thread who can then grant permission to the user's request.

Yes, if you are the owner of the thread, you can choose to convert the security of a discussion thread to Public.

The user account in Socialcast is not immediately deleted. You must use unmap the user account in Planful or delete the user account directly in Socialcast.

If you delete a user account in the Socialcast application, you will not be able to access the discussion threads in Planful.

Within Planful, if you delete names of artifacts such as scenarios, Dynamic reports and so on. This will not impact discussion threads in Socialcast. The discussion thread in Socialcast will continue to exist.

Within Socialcast, if you delete discussion threads, the reference to the discussion thread is lost within Planful. When a user attempts to click Create Discussion, a new discussion thread is started.

When the configuration is carried out for Socialcast Collaboration, a token is provided by Socialcast which is stored by the Planful application. From a security perspective, this token is refreshed periodically, which will result in the token expiring. The Socialcast administrator will need to re-save the configuration once the token expires, to get a new one.

The default value of 'Refresh token lifetime' is 90 days and as an Administrator of Socialcast, can be extended for up to 999 days. This will avoid the need to resave the configuration every 90 days.

To change the expiration setting for the token, navigate to Admin Settings >> Apps in Socialcast.

The revised expiration date is shown once the token is refreshed. For instance, if the original expiration date is May 02, 2017 and you revise the number of days to 999, this will extend the expiration date approximately to January 25, 2020. So, if you login to Socialcast before May 02, 2017, the expiration date would still be shown as May 02, 2017 as the earlier token has not yet expired. After May 02, the earlier token would expire. Thereafter January 25, 2020 would show as the token would be refreshed.