QuickCRM Mobile

 

Mobile Access to SugarCRM

 

User Manual

 

Version: 3.1


I         Introduction

 

QuickCRM Mobile gives you access to your CRM data on your smartphone.

 

QuickCRM Mobile comes in two editions:

*     QuickCRM Mobile CE (GPLv3)

*     QuickCRM Mobile Pro (Commercial License)

 

Once QuickCRM Mobile is installed on your SugarCRM server, you can access the mobile version from native apps or from your device browser.

 

Buttons and menus are available in English, German, Italian, Spanish and French.

All languages are supported for fields and values display.

 

For more information about QuickCRM Mobile Pro:

Visit www.quickcrm.fr/mobile or contact us at quickcrm@ns-team.fr

 

Disclaimer:

The software and documents are distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied.

 

II       Release Note

Version 3.1

·       New Homepage with a "Facebook-like" left panel with Global Search and Last Viewed items

·       Display on a map Contacts/Accounts/... within a given distance from your current location

·       Display on a map Contacts/Accounts/... within a given distance from a given Account/Contact/... (QuickCRM Mobile Pro)

·       New Lock button adds a password protection to your data

·       Traditional Chinese and Simplified Chinese

·       Select interface language

·       Bug fixes

 

Note: Display on maps require JJWDesign Google Maps and QuickCRM Mobile 3.0 modules installed in SugarCRM


III    Using QuickCRM Mobile

III.1     SugarCRM Configuration (iOS and Android apps)

 

On the Home Page, tap on  in the left panel.

To open the left panel, tap on  or swipe left on the homepage.

 

Choose "My SugarCRM Server" then enter your SugarCRM URL, your username and your password.

If you have requested a trial version of QuickCRM Mobile Pro, enter the code you have received in "Trial Code".

Tap on Save.

 

Notes:

-      Do not add /mobile or /mobile_trial to your SugarCRM URL

-      If you are using LDAP, please enter your local Username.

 

III.2     Login (Web version)

 

Open your browser and connect to http://your-sugarcrm-server/mobile or https://your-sugarcrm-server/mobile depending on your configuration

 

 

Enter your SugarCRM login and password, and then click on Login.

If you check "Remember Me", you will not be asked your user name and password next time you access QuickCRM.


III.3     Search CRM Data

 

 

You can search Accounts, Contacts, Leads, Opportunities or Tasks with

-      Name

-      "My items"

-      Other standard or custom fields (Pro version only).

 

For date fields, you can search From a date, To a date, between dates, today, this week, this month, etc.

 

Searching automatically extends your search keyword with wildcards, so you just need to type a few letters to search data.

Example:

-      Searching for ban might return

o   Bank of America

o   Union Francaise de banque

Search on Contacts looks for your keyword in First Name and Last Name.

 

Activating "My items" restricts search to data assigned to you.

 

Search fields can be extended with other standard or custom fields (see Field Management).

When searching for Tasks or Opportunities, the More Options button (Pro Version) you could, for example, search by Task status or Opportunity Sales stage:

 

      

 

Saved Searches (Pro Version)

 

Users can save their favorite searches on their mobile:

 

 

For example, you can create a search named "Won this year" where you select Opportunities in Closed Won sales stage and Expected Close Date This year.

The search will be saved when you click on Search.

 

A dropdown menu will be available with saved search for that module.

 

If you click on "Mark as Favorite" on a saved search, this search will be directly accessible on your home page:

 

 

Global Search

 

Global search allow you to search for a text in multiple modules.

You can access Global Search from the Homepage left panel, or from Last Viewed and All Modules with the Search Icon.

 

 

Enter the text to search and tap on Search.

 

Search will be made into Accounts, Contacts, Leads, Opportunities, Cases and Projects.

In Offline mode, search also applies to Meetings and Calls.


III.4     Display Data

Lists

When clicking on Search, you get the list of records matching your search filter:

Number of items found and current page information (ex: 1-20/200) are displayed with SugarCRM 6.2 and later.

 

 

 

 

 

 

 

 

 

 

 

 

In this list, records containing phone numbers are displayed with a  icon (Pro version).

You can then directly place calls to one of these phone numbers by clicking on that icon:

 

 

The detail view is displayed when you click on a line in the search results.

 

 

 

If you click on a phone number, a call will be placed to that phone number.

If you have selected "Log Calls" on the Options page, a call will be created in SugarCRM (Pro version).

 

For mobile phone numbers, an SMS will be initialized if you click on the  button.

 

When clicking on an address, a map is displayed.

 

If you click on an email address, an email is prepared for that contact, lead or account.

 


III.5     Create or edit Data (QuickCRM Pro)

 

Edition

To edit existing data (Account, Contact, Opportunity, etc.), find this element, then click on the Edit button.

A form is then opened allowing you to update existing data:

 

 

 

Click Confirm to save your modifications.

If your access rights do not allow you edition on these data, you will get an "Access Denied" error message.

 

Creation

 

Records can be created from Search Pages, List Pages or All Module page.

You can also create records from subpanels:

 

For example, a Contact can also be created from the detail view of its account.

 

When creating a contact from an account, the link with the account will be automatically set, avoiding you searching for the account.

The address and phone number will be automatically copied from the account.

Notes

Depending on your device and OS version, you will be able to upload attachments to notes. On most devices, that would be limited to images.

 


III.6     Maps

 

You can display on a map:

·       Contacts, Accounts, ... within a given distance from your current location;

·       Contacts, Accounts, ... within a given distance from a selected Contact, Account, ... (Pro Version only)

 

 

 

This function requires JJWDesign Google Maps and QuickCRM Mobile version 3.0 or later installed in SugarCRM.
It is only available in iOS and Android native apps.

The distance unit is the default distance unit selected in JJWDesign Google Maps settings (SugarCRM Admin Page).


III.7     Calendar (QuickCRM Mobile Pro)

 

The Calendar button gives you a quick access to your calls and meetings

 

 

-      Today : Calls and Meetings planned today

-      7 Days : Calls and Meeting planned in the next 7 days (including today)

-      30 Days : Calls and Meeting planned in the next 30 days (including today)

-      Late : Calls and Meeting planned in the past and still not held


III.8     Alerts

 

Alerts are available in the native apps for iOS and Android (CE and Pro Version) and in the "web app" (Pro Version only).

These alerts will be displayed if another user assigns data to you or modifies your own data.

 

New alerts are available when a yellow flag appears on the top right of the Home screen.

 

 

 

Tap on the flag to display the alerts list.

 

 

 

Tap on any item in the list to view this item.

Tap on Clear to clear the alerts list.

 

Alerts can be turned on/off on the Options page. They are turned on by default in the native apps.

 

Only Contacts, Leads, Calls and Meetings are supported.

 


III.9     Online/Offline mode

 

The offline mode gives the capability to use QuickCRM without actually being connected to the internet and send the updated data to SugarCRM when back online.

That can reduce communication costs for some users, and make access much faster when users have a bad internet connection.

 

Before going Offline, your data are downloaded onto your device, where you will be able to view, edit and create without connection to SugarCRM.

 

The Sync icon on the Home Page allows you to switch between online and offline modes.

Going Offline

 

Tap on the Sync Icon on the Home Page, the click on Sync.

 

 

Download of your data starts and the progress is displayed for each module:

 

 

The download operations can take some time and Wi-Fi connection is strongly recommended during this synchronization.

 

Once download is done, the "Go Offline" button is available.

 

In Offline mode, a red icon is displayed on the top right of the home page

 

 

 

 

Going Online

 

When you switch back online with the Sync icon on the home page, all items created, updated or deleted are sent to your SugarCRM server.

 

The number of items sent to SugarCRM is displayed during this synchronization.

Once the synchronization is done, the "Go Online" button is displayed.

 

Please note that the Offline mode is limited to 7 consecutive days.
It is important to go back online regularly to get new data that have been assigned to you.

 

Sync Options

 

The memory available on your device is too small to download the complete CRM.

The Sync options allow you to refine which data are downloaded.

 

For each module, you can select:

-      None: This module will not be available offline

-      Related: Only records required by other modules will be downloaded.

o   For example, if you select My items for Accounts and Related for Opportunities, opportunities will be downloaded only for your accounts

-      My items: Your items will be downloaded, as well as items related to other modules

-      All: All items will be downloaded, regardless of assignments.

 

The number of items for each module is limited to 2000.

You can set a lower limit to some modules by selecting "Limit" for these modules. The limit is then defined in the options (default: 400)

 

 


III.10 App lock

 

You can restrict access to your data with a password using the lock function.

 

To set a password:

Open the left panel on the Homepage and tap on

Enter twice your password and tap on Save.

 

 

To remove the lock and access your CRM without password:

Open the left panel on the Homepage and tap on

Enter your password and tap on Save.

 


III.11 Options

From the Home Page on your handset, click on Options

General options

 

QuickCRM Mobile toolbar can be displayed with or without labels.

   

 

 

Toolbar Labels:

Hide or display labels in the toolbar icons

 

Rows Per Page:

Number of items displayed when searching items.

 

Subpanels:

Subpanels can be hidden when no data are available in that subpanel.

 

Home Page

 

CE Version

With these options, you can select which icons will be displayed on the home page.

All available modules will still be accessible from the All Modules page.

 

 

Pro Version

When Search is selected, the icon will be displayed on the home page.

A Create button will be displayed on the home page if Create is selected.

 

 

Filter Old Data

 

The "Filter Old Data" option allows you to hide all data created before a chosen date from all lists and subpanels.

Usually you will want to keep all accounts and contacts, but you could hide all opportunities, calls and meeting created before a certain date.

 

Sort Order

 

With the sort order options, you can define how the lists will be ordered.

 

Calls and Meetings (Pro Version)

 

 

Log Calls :

Create a Call in SugarCRM when placing a call.

 

 

Several options are available to limit the quantity of displayed data in the calls and meetings subpanels of Accounts, Contacts, Leads or Opportunities.

 

My Items :

Displays only Calls and Meetings assigned to me

 

# days before

Do not display Calls and Meetings dated before that number of days

 

# days after

Do not display Calls and Meetings dated after that number of days

 

By default, only Calls and Meeting between now - 30 days and now + 30 days are displayed.

 

# Status

Display Calls and Meetings depending on their status

 


IV     Server installation and Configuration

Admin users of SugarCRM can install QuickCRM Mobile using Module Loader.

The mobile access is located in the "mobile" directory of your CRM installation.
Please make sure this directory is writable before installation.

 

NOTE: Due to SugarCRM restrictions, Export rights must be enabled to access CRM data in SugarCRM 6.0 and 6.1.

 

QuickCRM Mobile Pro

When you install QuickCRM Mobile Pro for the first time, you need to select users authorized to access QuickCRM Mobile.

Go to the admin page and click on Users in the QuickCRM Mobile section:

 

Select the users by moving them to the "Mobile Users" table:

Then click "Save".

 

 


V        Modules Management (QuickCRM Mobile Pro)

 

Go to the admin page and click on "Select Modules".

 

 

Drag and Drop the modules (including Custom Modules) that you want displayed or hidden on the mobile, then click on Save.

 

You can also order the displayed modules to define the order of icons on the mobile Home Page.

 


VI     Fields Management (QuickCRM Mobile Pro)

 

With QuickCRM Mobile Pro, very few fields are displayed by default on the mobile.

Before using the software, you should define which fields you want to display for each module, or use as search fields.

 

Go to the admin page and click on "Configuration of QuickCRM Mobile".

Select a module, then click on Displayed fields, Search Fields or Displayed subpanels.

 

 

You can select for each module which fields will be displayed (including custom fields) and the order of those fields.

You must click on "Save" before customizing another module or another view.

 

 

Drag and Drop the fields to be used as additional search criteria, then Save.

 

For each module, you can define and order the subpanels displayed on the detail view.

 

VII  QuickCRM Update

The QuickCRM Update (rebuild configuration) menu on the admin page must be activated when:

-      You upgrade SugarCRM to a new version

-      You add a new language or change default language

-      You change a field definition or edit a drop-down list

 

 


VIII  Advanced customization

Users familiar with HTML and JavaScript can extend QuickCRM Mobile appearance and behavior.

Home Page customization

 

You can add your specific images or links on the mobile Home Page by creating an html file at custom/QuickCRM/home.html.

This html file will be placed on top of the icons.

 

Javascript customization

 

You add your specific functions by creating a JavaScript file at custom/QuickCRM/custom.js.

 

Once you have created or modified a custom file, please click on QuickCRM Update on the admin page so that the apps take these changes in consideration.