Managing Sharing in an App

A powerful feature of the Kahua platform is the ability to share project information across domains. For example, a general contractor can share a project's RFI log or submittal log on a project with the subcontractors on that project, ensuring everyone is on the same page. For more general information on sharing in Kahua, refer to Sharing Apps with External Party.

The company sharing their information can control which records are shared from selected apps, and what permissions the receiving company will have for those records. They can initiate, edit, or end the share at any time.

The receiving company can control what project the shared records appear in. The records appear in their own separate list within the appropriate application.

If you have the appropriate permissions, you can share an app from a project directly from the application, as described below. You can also share multiple apps at one time through an invitation template, and you can manage inbound and outbound shares in the Share Manager app. Refer to Creating an Invite Template and Share Manager.

Key features to know about this feature include the following:

• When an app is shared with another organization, the contents of that app appear in real-time in the other organization's domain. It is not a copy of the data, it is the actual records. 
• If you are the person initiating the share, you must have the appropriate permissions to do so. This typically requires an Administrator or Moderator role.
• You can edit or end the share at any time.
• You can apply a filter to the share to limit which records in the app are shared.
• You can allow the other party to keep a viewable copy of the records after the share is ended by selecting Allow copy on the share document.
• The invitation recipient accepts the share on behalf of their organization. The invitation appears as a task in their Kahua domain. The share can be added to an existing project, or the recipient can create a new project from the invitation itself. For information on accepting a share, refer to Accepting a Shared Application

TABLE OF CONTENTS

• Share an application from an app
• Edit an existing share
• End an existing share

Share an application from an app

To share an application with an outside company or contact, complete the following steps:

1. Review the header to ensure that you are in the correct project or partition.
2. Navigate to the application you want to share. 
3. Click the Share icon  in the action bar. The log view with any existing shares appears.
4. Click Add in the action bar to add a new share. The New Share page appears.

   
   
   
   

5. Complete the following fields as appropriate:

   Field	Description
   Project	The name of the current project appears here.
   Application	The name of the current app appears here.
   List\Folder	If the app includes lists or folders, select the appropriate option here.
   Share With:	Select Company or Group. Typically it is advisable to select the Company option.
   Company	This option appears if you selected Company above. Select the company name. Not that to be available for selection, the company must appear in the Companies app in your domain and be a Kahua user. To accept the share, they will have to have the appropriate licenses.
   Permission Level	Select the name of the group with the appropriate permissions for this application. Once you select the group name, the roles assigned to the group appear below the selection. For example, if you are a general contractor and want to allow your subcontractors to view RFIs for a project in your domain, you can set up a group with Observer permissions for RFIs and select that group here. Note that this selection can be edited after the share is accepted.
   Send Invite To:	If you selected to share with a company, select which Kahua user from the named company to send the invitation to. If you selected to share with a group, the members of the group appear for selection. Choose members of the group to receive an invitation. The invitation will appear as a task in the recipient's Kahua domain. The invitation recipient can determine if they want to add the share to an existing project or create a new one. In your domain, the invitation will appear as ‘Pending’ until the invitation is accepted. Note that the selected invitation recipients must appear in your Contacts app.
   Allow copy	Select this option to allow the company you are sharing with to keep a copy of the shared records when the share ends. This creates a static list that can only be viewed and not edited. This is a recommended practice to allow the company receiving the share to be able to view the records once the share ends. Note that this selection can be edited after the share is accepted.
   Filters	Filters allow you to restrict what records are available from the shared application. You can select one of the standard filters, or create your own. The available standard filters will vary depending on the application being shared. Some typical filters include the following: User's Company is Named on Record Created By Current User's Company Created by Current User To create a custom filter instead, select a field to filter by in the Custom Filter section. You can filter by multiple fields and use either AND or OR conditions. Note that this selection can be edited after the share is accepted.

6. Click Send Invitation when you are done.

Edit an existing share

Outbound shares can be edited in the app from which they are shared, or in the Share Manager application. In the Share Manager app, you can manage all the shares in your domain from one log view. Refer to Share Manager.

To edit an existing share from the app where it was shared, complete the following steps:

1. Review the header to ensure that you are in the correct project or partition.
2. Navigate to the application with shares you want to edit. 
3. Click the Share icon  in the action bar. The log view with any existing shares appears.
4. Click on the share you want to edit and click Edit in the action bar.
5. The Edit Share page appears. You can edit the Permission Level, Allow copy, and Filter fields. Note that these fields can be edited after the share is accepted.
6. Click Save when you are done.

End an existing share

To end an existing share, complete the following steps:

1. Review the header to ensure that you are in the correct project or partition.
2. Navigate to the application with shares you want to end. 
3. Click the Share icon  in the action bar. The log view with any existing shares appears.
4. Click on the share you want to terminate and click End Share in the action bar.
5. A confirmation message appears. Click Ok to end the share. Click Cancel to keep the share.