Getting Started: Admin Checklist
The following three steps are required to use the Mapview for Salesforce managed package. Please make sure you have followed all of the steps outlined in this guide. If you still have questions, contact us at appsupport@thecaseygroup.com.
- Step 1: Install the Mapview managed package
- Step 2: Clone Mapview user permission sets
- Step 3: Set up the task field 'Email'
- Step 4: Edit the task page layout to include all necessary fields
- Step 5: Enable Notes
*The above list is a basic overview of the steps to be taken. Depending on your organization's setup, you may have additional steps to take.
Step 1: Installation
Follow the steps below to install the Mapview for Salesforce managed package.
- Go to the AppExchange and search for Mapview.
- Click 'Get it Now'
- Follow the installation prompts.
- Choose 'Install for All Users' and click 'Install.'
Step 2: Permission Sets
Now that you have installed the Mapview managed package, login to Salesforce and follow the steps below to clone the Mapview permission set.
- In the upper right hand corner, click the gear icon and choose 'Setup Home'.
- Then in the left sidebar under 'Administration' open 'Users' -> 'Permission Sets'.
- Click on the 'Clone' link next to Mapview Permission Set. (The Mapview managed package bundles this permission set to simplify the setup process. The permission set is pre-configured to allow the access of necessary Apex and Visualforce pages)
- Now, if you like, you can change the permission set details such as a new label, api name or description. Please do not edit any of the set permissions as it may disrupt the functionality of the app.
- When you are finished you should have two permission sets listed as shown below.
Step 3: Setup the task field 'Email'
By default, in the Professional Edition the task type 'Email' does not exist. In order for Mapview to function properly, the admin must create the task type 'Email'. To do this, please follow the steps below.
- Click 'Setup' in the top right corner of your Salesforce org.
- On the left side bar under 'Build' go to 'Customize' -> 'Activities' -> 'Task Field'.
- Click the field label 'Type'.
- Under 'Task Type Picklist Values' click 'New'.
- Type 'Email' in the edit box and click 'Save' to continue.
Step 4: Edit the Task Page Layout
By default in the Professional Edition, the task fields 'Type', 'Location', 'Completed On' and 'Started On' are not added to the task layout. For Mapview to function properly, please add the mentioned fields to the task page layout by following the steps below.
- Click 'Setup' in the top right corner of your Salesforce org.
- On the left hand side bar under 'Build' go to 'Customize' -> 'Activities' -> 'Task Page Layout'.
- Drag each mentioned field to the page layout under 'Task Information' (any order is fine) and click 'Save'.
Step 5: Enable Notes
Notes must be enabled for Mapview to work. To enable notes, go to 'Setup' -> 'Notes' -> 'Notes Settings' and make sure the checkbox is selected.
Admin Tips: Best Practices
- If hidden fields are made visible to API for a given user profile then the Salesforce admin should advise all users of that profile to delete all imported views of that object and reimport the data in the Mapview for Salesforce app.
- Mapview for Salesforce will not import a view if there are more than 2000 records. To remedy the situation you can create views with less than 2000 records in Salesforce.
- If a user changes the view definition of a public or private view definition, then the Salesforce admin should notify all users to remove all imported data of that view on the object and reimport the view again.
- If a Salesforce record is changed using the edit functionality inside Mapview and the change makes that record be qualified for some other view, then the change will not be effective inside Mapview for Salesforce app until a user refreshes all views of the given object.
- To ensure data encryption at the device level, users must have a passcode set to enter their device
Next Steps: Review the Admin Screen Guide
Thank you for using Mapview for Salesforce.
If you have any difficulties with installation, please contact us.