Contact us Blog

Sharing Apsona components among users

Overview

Here we describe how to enable Apex sharing of Apsona items, so that an administrator has fine-grained control over sharing.

As an administrator, you may want to set up a base collection of reports, field sets and filters, and then share the collection with your users. This way, creating the components is a one-time effort, and all your users benefit from that effort.

However, you might also want fine-grained control. For example, you might create one such collection for your marketing users and a different collection for your support users. You would then want to ensure that the collection for the marketing users is not shared with anyone else but the marketing users. Similarly for the support users.

In such situations, you might consider enabling Apex sharing of your Apsona item records. Without this feature enabled, you would rely on Apsona's coarse-grained sharing in which filters are either "public" or "private", and single-step reports and field sets are visible to everyone. When you enable this feature, you gain precise control over exactly which user or user group has access to a specific report, field set or filter.

How to enable sharing

To enable sharing of Apsona Items, follow these steps:
  1. In Salesforce, navigate to Setup - Administer - Security Controls - Sharing Settings. Then click the Edit button.
  2. Change the Default Internal Access value for the Apsona Item object to "Private". See how.
  3. We suggest adding a sharing rule to ensure that the Apsona Configuration items are visible to all users. (This rule makes it much easier to manage access to Apsona. Without this rule, you would have to share each Configuration item with the corresponding profile, and it can get a bit tedious.) To do this:
    1. Navigate to Setup - Create - Objects - Apsona item, scroll to the section for Apsona item Sharing Rules, and click New. (In some orgs, you get to this screen via Setup - Security Controls - Sharing Settings - scroll down to Apsona Item Sharing Rules - New.)
    2. In the resulting screen, create a sharing rule that shares all Apsona Item records of type 'config' with all internal users, as in the screen shot below. Then click Save.
  4. Navigate to Apsona and click Settings - Clear cache so that the sharing takes effect.
  5. For any user profile that should have restricted access to the Apsona Item object, make sure that the profile's View All and Modify All permissions for that object have been turned off. If you don't do this, the sharing rule settings will be ignored for that user profile.
Similar to the Apsona Configuration sharing set up above, you can also set up rules that share other types of Apsona items broadly across all users. For instance, if you want all filters to be visible to all users, you might create a rule like the one below:

Within the Apsona Item record, each item type is indicated by a short symbol, so in order to share items of a particular type, you would need to use the corresponding short symbol in the Value box. Below is the list of symbols that Apsona item types support.
Item typeSymbol
Apsona Configurationconfig
Chartchart
CSV Match Actioncsv_match_action
Console view layoutlayout
Dashboarddashboard
Dedup Actiondedup_action
Default Console View Layoutconsole_view_layout
Filterfilter
Import Mappingimport_mapping
Initial filterinitial_filter
Merge Actionmerge_action
Multi-step ReportmultiStepReport
Multi-step Report FoldermultiStepReportFolder
Reportreport
Tabular View FieldSettabular_view_fieldset
Tabular View Layouttabular_view_layout

Once this feature is enabled, any non-shared Apsona Item - such as a filter, report or field set - will by default be visible only to the owner of the item and to anyone whose profile has the "View All" and "Modify All" permissions on the Apsona Item object. (That, of course, includes Administrators.)

Sharing with specific users

To share one or more items with specific users, follow these steps: If you wish to unshare one or more items, use the Unshare button in the popup.

Notes and caveats