SugarCRM SupportProduct GuidesMobile SolutionsSugarCRM Mobile AppSugarCRM Mobile App User Guide

SugarCRM Mobile App User Guide

Overview

The SugarCRM mobile app enables access to Sugar from users' mobile devices to access data, manage daily activities, initiate phone calls, send SMS and emails, map record addresses and more while away from their computers. The app may also be used on tablets running a compatible version of Android or iOS. The app will automatically adapt to tablet-sized screens. For more information on supported platforms, please refer to the Mobile Supported Platforms page.

Installing

SugarCRM's mobile app is available for download from the Apple app store and the Google Play store. Use the following steps to download and run the application on your device:

  1. Search for "SugarCRM" in the app store. If searching from an iPad, choose the "iPhone Apps" tab in the Apple app store.
  2. Select the "SugarCRM" app.
  3. Tap "Install" to install the application.

Note that the mobile app cannot be used on a jailbroken or rooted device. If you install it on a jailbroken or rooted device, an error message will appear when you try to open the app, preventing you from accessing the application.

Logging In

In order to log in to your Sugar instance using the mobile app, you will need the following pieces of information:

  • Username: The username you use to access your Sugar instance in a desktop browser.
  • Password: The password you use to access your Sugar instance in a desktop browser.
  • Sugar Instance or single sign-on URL: The URL of your Sugar instance.
    Note: "http://" can be included or left off without effect, but be careful to only include "www." if this is included when accessing your instance from a desktop browser.
  • Use secure connection: Whether or not your instance is accessed using HTTPS. If you access your instance using "http://", uncheck this box.
  • Single Sign-On: Whether or not your instance is configured to use legacy single sign-on authentication. If your instance uses SugarIdentity authentication, you do not need to enable Single Sign-On.

The sections below outline the steps to log in based on the authentication type used by your Sugar instance. If you are unsure if your instance uses SugarIdentity, you can easily check by navigating to the edit view of your profile in the desktop application. If your instance uses SugarIdentity, a popup will appear stating that you must contact your administrator to make changes to read-only fields. Otherwise, the popup will not appear. If you are still unsure, you can also contact your administrator to confirm which authentication type your instance uses.

Standard Login

Both SugarIdentity and non-SugarIdentity instances can use the standard login process if an admin has not configured single sign-on (SSO). Use the following steps to log in to your instance via standard login:

  1. Once the app is installed, tap the SugarCRM cube icon to run the application. If you are using iOS, you will be prompted by the iOS operating system to allow push notifications. If you wish to take advantage of push notifications from the app for Comment Log mentions and record assignments, be sure to allow this in the pop-up that appears.
  2. Enter your Sugar instance URL. If your instance does not use SSL (i.e., you access it with http:// rather than https://), uncheck "Use secure connection". Tap "Continue".
    Note: If you have previously used the app on your mobile device, you must tap the gear icon in the top right corner to modify these settings.
    StandardLogin
  3. Enter your username and password then tap "Log In".
    • For instances that do not use SugarIdentity
      Login 
    • For instances that use SugarIdentity
      Mobile LoginIDM MFA
  4. For iOS devices with Touch ID, tap "Enable" on the Enable Touch ID screen to allow logging in to the app with your fingerprint.
    Note: Touch ID cannot be used for instances that use SugarIdentity.
    TouchID 
  5. For iOS devices with Face ID, tap "Enable" on the Enable Face ID screen to allow logging in to the app using Face ID.
    Note: Face ID cannot be used for instances that use SugarIdentity.
    Mobile Login iOS FaceID 
  6. If this is your first time logging in, a pop-up will appear asking you to acknowledge that the app uses cookies. Tap "Continue" to access the mobile app.
  7. For instances that use SugarIdentity, a user consent screen will appear requesting access to certain Sugar data (e.g., your Sugar profile). Tap "Allow access" to continue to the app.

The first time you log in and navigate through the app, a brief tour will appear to help familiarize you with the application.

Logging in With SugarIdentity Using Multi-Factor Authentication

SugarIdentity supports multi-factor authentication, which provides an added layer of security for Sugar to prevent unauthorized users from gaining access to your account. When multi-factor authentication is enabled for your Sugar instance, you will need to use an authenticator app (e.g., Authy, Google Authenticator, Microsoft Authenticator) on a mobile device when logging in to your Sugar account via the standard mobile login.

Use the following steps to log in to your instance using SugarIdentity with multi-factor authentication:

  1. Follow steps 1-3 in the Standard Login section above. 
  2. If this is your first time logging in after multi-factor authentication has been enabled for Sugar, a QR code will appear on the screen. Scan the QR code using your mobile authenticator app (e.g., Authy), then tap "Continue". If you cannot scan the QR code using a mobile device, skip to step 3. 
    Note: If you have already paired an authenticator app with Sugar, then skip to step 4. 
    Mobile LoginMFA QRCode
  3. If you cannot scan the QR code on step 2 using a mobile device, tap the "Can't scan?" link and enter the secret key that appears on the screen into your authenticator app. Tap "Continue".
    Mobile LoginMFA SecretKey
  4. On the next screen, enter the 6-digit code generated from your authenticator app, then tap "Log In".
    Note: Once your authenticator app is paired with Sugar, for future logins, you will just be required to enter a new 6-digit code on this screen after entering your Sugar login credentials.
    Mobile LoginMFA CodeScreen
  5. A user consent screen will appear requesting access to certain Sugar data (e.g., your Sugar profile). Tap "Allow access" to continue to the app.

The first time you log in and navigate through the app, a brief tour will appear to help familiarize you with the application.

Legacy Single Sign-On Authentication

Use the following steps to log in to your instance using SAML without SugarIdentity:

  1. Once the app is installed, tap the SugarCRM cube icon to run the application.
  2. Enter your Sugar instance URL.
    Note: If you have previously used the app on your mobile device, you must tap the gear icon in the top right corner to access these settings.
  3. If your instance does not use SSL (i.e. you access it with http:// rather than https://), uncheck "Use secure connection".
  4. Enable the Single Sign-on toggle, then tap "Continue".
    LegacySSO
  5. The application will redirect you to your single sign-on login page. Enter the SAML login credentials.
  6. Finally, if this is your first time logging in, a pop-up will appear asking you to acknowledge that the app uses cookies. Tap "Continue" to access the mobile app.

The first time you log in and navigate through the app, a brief tour will appear to help familiarize you with the application.

Note: Only instances that are configured to use SAML authentication are able to log in through legacy single sign-on in the mobile app.

Single Sign-On Authentication With SugarIdentity

Use the following steps to log in to your instance using single sign-on (SSO) with SugarIdentity:

  1. Once the app is installed, tap the SugarCRM cube icon to run the application.
  2. Enter your Sugar instance URL.
  3. If your instance does not use SSL (i.e. you access it with http:// rather than https://), uncheck "Use secure connection", then tap "Continue". Note that the Single Sign-On field is not needed to use SugarIdentity and its value will be ignored.
    StandardLogin
  4. The application will redirect you to your SugarIdentity login page. Enter the SugarIdentity login credentials. 
  5. After logging in, a consent screen will appear requesting access to certain Sugar data (e.g. your Sugar profile). Tap "Allow access" to continue to the app.
  6. Finally, if this is your first time logging in, a pop-up will appear asking you to acknowledge that the app uses cookies. Tap "Continue" to access the mobile app.

The first time you log in and navigate through the app, a brief tour will appear to help familiarize you with the application.

Note: Only instances that are configured to use SugarIdentity authentication are able to log in through SugarIdentity in the mobile app. In addition, the iOS Face ID and Touch ID features cannot be used with SugarIdentity.

Offline Records

If your Sugar instance is enabled for offline use, the Offline Records screen will appear upon first logging in to the app. While a small number of records are automatically cached to your device for offline use, you have the option to bulk download your assigned, favorited, and followed records. Click "Download" to initiate the download which will continue in the background while you use the app. Alternatively, click "Not Right Now" if you do not wish to make these records available for offline use. Check the "Use Cellular Data" box to have the download continue using cellular data when a wifi connection is not available.

You can initiate the bulk download at any time from the Offline Settings option in the main menu. For more information, refer to the Offline section of this documentation.
Offline Records on Login

The main menu can be accessed from any page by tapping the three-bar icon at the top left. Tap the icon again to close the menu. The menu will open from the left and allow you to work with your user profile, access Sugar modules, dashboards, and the calendar, view information about the application, configure the application, access the desktop version of Sugar, and log out.
MainMenu Hamburger

Profile

Your user profile by tapping your name or the user icon at the top of the main menu. To make changes to any fields, edit them using the instructions in the Editing Records section of this documentation, then tap "Save" to preserve your changes. 
Profile

Note: Fields that are unavailable for editing are greyed out.

Dashboards

Beneath the calendar, the main menu displays each of the dashboards you have access to and have marked as a favorite in your Sugar instance, as long as they contain at least one dashlet that is available in the mobile app. To switch between your dashboards, tap the main menu icon and select the desired dashboard. Dashboards and dashlets must be created and edited in the desktop version of Sugar, but note that not all dashlets are available in the mobile app and some may not appear. After making a change to your dashboards in the desktop version, log out and back in to the mobile app, then click "OK" to confirm you wish to load the new dashboard changes.
Nomad4.0 MultipleDashboards

From the dashboard view, tap any dashlet's icon to view the individual dashlet.
Dashboard OpenDashlet

From any dashlet, you can tap the Dashboard icon to return to the tiled view of all of your available dashlets. For dashlets that display records in a list view, swipe from right to left on a record's row to open the Actions menu.
ListViewDashlet

Note: When using a tablet, tapping on the name of a record in a dashlet will open the record in detail view to the right of the dashlet.

At the bottom of any dashlet, there is a navigation bar with colored dots representing which of your dashlets you are currently viewing. You can move forward or backward through your dashlets by tapping the forward and back arrows or by swiping left or right within this bar.
ListViewDashletSwitch

For information about configuring and using dashlets, please refer to the Dashboards and Dashlets documentation.

Note: Dashlets that list records (e.g., list view dashlets and chart dashlets) will not load any new data while your device is offline. Only data that has previously been loaded in the dashlet will be displayed until the application reconnects to your Sugar instance.

Note: A user must log in to the desktop version of Sugar at least once before any dashboards will appear in the mobile app.

Calendar

SugarCRM's mobile calendar is available in the main menu under your dashboards and has two different layouts for seeing your schedule based on the calendars you have configured in the desktop application. In Sugar versions 11.2 and higher, you can configure any number of calendars in the desktop app based on different modules, but in Sugar 11.1 and lower, it is limited to only calls, meetings, and tasks. You must have access to at least one of the configured calendars' modules to see the mobile calendar.

In addition, you can add calendars of events belonging to other users or teams to your calendar view in the mobile app so that you can view an overlay of various schedules in one place. See the Calendar Settings section for details on adding new user and team calendars.

The default view when you open the calendar is agenda view, which shows a summary of all your upcoming activities. Tap the calendar icon across the top to switch to day view, where you can see an hourly view of a single day with the activities displayed within their time slots.
CalendarIcon

In day view, the calendar icon becomes a list icon and tapping it brings you back to agenda view.
ListIcon

In either view, the top bar offers the same abilities: choosing a different date to view, switching between views, searching the calendar, and creating a new event. The following elements are available:

  • Month navigator: Displayed as the currently-viewed month and year (e.g., May 2022), tapping this button expands and collapses the month view of the current month. In this view, you can swipe up and down to scroll through the months and tap a day to open it in the calendar. Days with at least one scheduled event have a grey dot below them. Note that you cannot scroll to months in the past.
    MonthNavigator2
  • View switcher: Displayed as either a calendar icon or a list icon, depending on your current view, tapping this icon switches between agenda view and day view. If you have selected a specific day other than today in either view, switching between views keeps that day in focus. In agenda view, the day at the top of the screen is considered the selected date, but you can also tap on a date in the month navigator to select it.
    ViewSwitcher2
  • Search: Displayed as a magnifying glass icon, tapping this icon opens a search bar where you can enter text to filter the events that are displayed in your current view (i.e., agenda view or day view). Note that only events that take place within the next year are returned.
    Search2
  • Create: Displayed as a plus icon, tapping this icon allows you to create a new record based on the types of calendars you have configured in the desktop app. Once you select the type of event to create, its edit view is opened. After you save, you are returned to the calendar.
    Create2

The bottom bar contains the following two abilities regardless of which view you are in: navigating back to today's date and refreshing the calendar. The following elements are available:

  • Today navigator: Displayed as a Today link, tapping this button opens the current date in whichever view you have open (i.e., agenda view or day view).
    TodayLink
  • Refresh: Displayed as an icon with two circular arrows, tapping this icon refreshes the current view so any changes to the events are visible.
    RefreshIcon

Agenda View

Agenda view, accessible via the list icon in the top bar if not already open, shows all future events as color-coded cards in a list by date. Every date has a heading with the events, if any, displayed in chronological order beneath the heading. Each event shows its subject, description, start time, and duration and is displayed as a color-coded card according to the type of activity (e.g., call). Tap any event to open its detail view.
AgendaView

Day View

Day view, displayed by default when you first open the calendar after logging in, is an hourly view of a single day with all events displayed within their time slots; a blue, horizontal line is displayed at the current time in the view. Each event shows its subject, description, start time, and duration and is displayed as a color-coded card according to the activity type (e.g., call). If an event lasts 24 hours or longer, it is displayed as an all-day event at the top of the view on every day for which it spans the entire day. Tap any event to open its detail view and scroll up and down within the day to see different hours of the day.
DayViewUpdated2

At the top of the view is an overview of the week, starting with the first day of the week, as configured in the calendar settings. The currently-selected date is displayed in a solid blue circle and today's date, if not selected, is displayed in blue text. Swipe left and right to scroll through the weeks and tap a specific date to open it in day view. Note that you cannot scroll to weeks in the past.

Calendar Settings

Clicking the gear icon in the top right corner of the calendar opens the Calendar Settings screen.
CalendarSettings

The first setting on this page allows you to select on which day of the week (e.g., Sunday) the calendar's week should start:
WeekStartDay

Below this, you can enable and disable each of your own calendars for display and add or remove other users' and teams' calendars that you wish to see in your mobile calendar. The tabbed view contains two tabs listing your own calendars in the first tab and any shared calendars you have added in the second tab.
SettingsTabs

The My Calendars tab lists all calendars you have configured in the desktop application. Tap any calendar in the list to enable or disable it for display in the mobile calendar, but note that you cannot add or remove any calendars from the mobile app. These can only be configured in the desktop app.

The User and Team Calendars tab lists all calendars of records belonging to other people that you have added via the mobile app. Use the Add Calendar button to add a new shared calendar, tap any existing shared calendar to enable or disable it for display in the app, and tap the X next to any calendar to remove it from the app. Note that the list of shared calendars in the mobile app is configured separately from the list in the desktop app; you must add a calendar in each application to see it there.
UserAndTeamCalendarsTab

Once you have made your changes to your calendar settings, be sure to tap "Save" in the top right corner to save the changes.

Adding Calendars

Tapping "Add Calendar" allows you to add new shared calendars to your mobile view. Once you are on the Add Calendar screen, tap "Search and Select Calendar" at the top to choose a calendar you have configured in the desktop application as the basis for this shared calendar. Once you have selected one, tap a user or team from the displayed list; this indicates that you want to see the records specified by the selected calendar belonging to the user or team you have chosen. Use the filter above the list to narrow it down to only users or only teams and use the magnifying glass icon across the top to search for something specific.
AddCalendar

When you are happy with your selection, tap "Done" to add the calendar. Calendars that you add will appear under the User and Team Calendars tab and, when enabled, their events will be visible in your mobile calendar alongside your own events.
UserAndTeamsCalendarsTab

When logging in to SugarCRM's mobile app, your Global Search page will be displayed first unless a different option is selected in your Start Screen option. You can navigate to the Global Search page from anywhere within the application by tapping the three-bar icon to access the main menu then choosing "Global Search". By default, the Global Search page will show a list of your recently viewed records from all available modules. The list will be empty if there are no recently viewed records to display.
GlobalSearch

The app allows you to search across all modules at once from the Global Search page. You can use the out-of-the-box filter options (i.e., All Records, My Favorites, My Records, and Recently Viewed) or build your own Global Search filter by tapping "Build Filter". You can also tap the magnifying glass icon to expand the search box and begin typing your search criteria.
GlobalSearchFilters

When the search bar is expanded after tapping the magnifying glass, you can continue to filter the list by tapping the filter button and selecting the desired search filter (e.g., All Records). The records list will automatically update to show records that match your search criteria and/or the selected filter. Tap the "x" within the search bar to clear your search.
GobalSearch 2

Records with any matching field that has been enabled for full-text search are returned. Beneath each returned record's name is the field within that record that matched your search term. Please note that if changes are made to your instance's full-text search configuration, users must log out and back in to the mobile app in order for the matched field to be displayed as expected. For more information on configuring full-text search, refer to the System documentation.

If you enter text that matches one or more Tag records, the matching tags appear under the search bar as tappable grey pills. Tap a tag's pill to filter your search by that tag; this will cause the pill to change to blue. To remove the tag from your search filter, tap it again to deselect it. If you wish to filter by multiple tags or a combination of tags and text, simply tap a tag to select it. Then, enter new search criteria in the search box to find more tags or filter the results by your desired text.

Tag Search Cropped

For information on editing tags and adding them to a record in the mobile app, see the Editing Tags section of this page. For more details on how tags work in Sugar, refer to the Tags documentation in the Application Guide.

For more details on how global search works, see the Global Search documentation in the Application Guide.

Global Search Filters

Custom filters can be created on the Global Search page to help filter the results to specific modules or criteria, which can be used in conjunction with search text entered in the search bar. To create your own filter, tap the filter button and select "Build Filter". This opens the Build Filter screen where you can create a filter using the following fields:

  • Save filter: Enable this checkbox to save the filter for future use in the mobile app on your device. Saved custom filters will show "Local filter" below them in the list of filters.
  • Filter name: Enter a name for the filter if you do not want to use the default name provided by the app.
  • Module Selector: Select one or more modules to filter the search results by. Records in any of the selected modules will be returned by the filter.
  • Select Additional Parameters: Select one or more of the following parameters to further filter the search results: Modified by Me, My Favorites, Assigned to Me, and Created by Me.

BuildFilter

Once your filter is configured, tap the button in the top right corner to apply it - either "Apply" or "Save" depending on if you chose to save the filter or not. This will return you to the Global Search page where you can see that your new filter is applied. The pencil icon will also be available so you can edit it further or open the Edit Filter page to delete it. Note that if you did not save the filter, it will automatically disappear when you choose a different filter from the list.
AppliedFilter

Actions Menu

From the Global Search page, you can access a menu of actions to be performed on a single record by swiping the grip icon of any record's row to the left.
Nomad2.7 Global ActionsMenu

Doing so will open a context-sensitive menu of actions available for this record, meaning that the options available will differ according to the type of record and the fields it has populated. For a full list of available actions and a description of each, refer to the Record Actions section of this documentation.  

Quick Create

The Quick Create button appears as a verticle ellipsis on the top of the Global Search page's header bar. From the Global Search page, the Quick Create menu will allow you to create a new record of any type which you have access to create in the mobile app.

The following steps will cover creating a new Account from the Global Search page quick create as an example:

  1. Navigate to the Global Search page by tapping "Global Search" within the main menu.
  2. Tap the verticle ellipsis Quick Create button at the top right of the page.
    QuickCreate1
  3. Choose "Create Account".
    QuickCreate2
  4. Fill in all desired fields using the instructions in the Editing Records section of this documentation.
    Note: Fields that are required will show "Required" in grey to the right of the field name.
  5. When all desired fields are populated, tap "Save" to create the new account record. Tapping "Cancel" will return you to the Global Search page without creating a new record.
    QuickCreate3

Please note that your ability to create records in Sugar may be restricted by a role. For more information on roles, please refer to the Role Management documentation. Check with your system administrator if you do not see the Create options.

Note: Report, employee, and knowledge base records may not be created from the mobile app.

Activity Stream

The Activity Stream option in the main menu displays recent activity in records you follow across all Sugar modules. If you wish to see the Activity Stream page when first logging in to the mobile app, you can select it as your Start Screen option.
ActivityStream

Note: Activity streams may be disabled in your Sugar instance. For more information, refer to the System page of the Administration Guide.

Users can create posts by tapping "Add a Comment" at the top of the Activity Stream page. To leave a comment on a specific post, simply tap the vertical ellipsis to the far right of each post then select "Comment". In addition, you can mention specific users or records by typing @ followed by the user's name or # followed by the record's name in the post or comment. Users or records included in posts can be tapped to open them in detail view. For more information, please refer to the Activity Streams documentation.
ActivityStream2

Document Merges

If you are connected to a Sugar instance with access to Doc Merge, you can generate documents based on record data from the mobile app. See the Merging Records With a Document Template section of this page for more details on using Doc Merge in the mobile app.
MainMenuDocMerge2

Sugar Modules

Below your user profile, dashboards, calendar, global search, and activity stream is a list of Sugar modules that you can access using the mobile app. Tapping one of the Sugar module names will open its list view. You can also press and hold any module to drag it to a new location within the list. This way, you can organize the module list so that your most-used modules are at the top.

The following modules may be made available for use in the app by your administrator via Admin > Mobile. For more information on controlling which modules are available in the mobile app, please refer to the System documentation. Note that certain modules are only available if connected to a Sugar instance on a specific minimum version.

  • Accounts
  • Calls
  • Cases (for Sugar Sell 12.0 and higher, Serve, Enterprise, and Professional)
  • Contacts
  • Contracts
  • Documents
  • Document Templates
  • Emails
  • Employees
  • Escalations (for Sugar Sell and Serve)
  • Knowledge Base
  • Leads (for Sugar Sell, Enterprise, and Professional)
  • Meetings
  • Messages
  • Notes
  • Opportunities (for Sugar Sell, Enterprise, and Professional)
  • Processes
  • Purchases (for Sugar Sell and Serve)
  • Purchased Line Items (for Sugar Sell and Serve)
  • Quoted Line Items (for Sugar Sell, Enterprise, and Professional)
  • Quotes (for Sugar Sell, Enterprise, and Professional)
  • Reports
  • Revenue Line Items (for Sugar Sell and Enterprise)
  • Tasks
  • Any Custom Module

Note: The Employees, Reports, and Knowledge Base modules are read-only for all users when accessing them from the mobile app. The Quotes module may be read-only when using some older, unsupported versions of Sugar.

Please note that your ability to access the above modules may be restricted by a role. For more information on roles, please refer to the Role Management documentation. Check with your system administrator if you cannot access the above modules.

About

The About page shows the following information in addition to providing the privacy policy and terms and conditions.

  • App Version: The version of your mobile application
  • Server Version: The version of the Sugar instance that the application is accessing
  • Server URL: The URL of the Sugar instance that the application is accessing
  • Support: A link to the Support site containing all SugarCRM product documentation
  • Sugar Mobile for Android/iOS Release Notes: A link to the release notes for the version of the app that you are using
  • Sugar Mobile for Android/iOS User Guide: A link to the mobile app user guide

Settings

The settings page includes the following configurations:

Language

The Settings page allows you to configure what language your mobile application will use.
Language

While English is the default language, the stock Sugar languages are available for use:

  • Arabic
  • Czech
  • Bulgarian
  • Chinese
  • Danish
  • Dutch
  • English-UK
  • Estonian
  • French
  • German
  • Hebrew
  • Hungarian
  • Italian
  • Japanese
  • Lithuanian
  • Norwegian
  • Polish
  • Portuguese
  • Romanian
  • Russian
  • Spanish
  • Swedish
  • Turkish

Font Size

Users can alter the font size for the entire app, based on their personal preference. Tap the Font Size line and choose the desired option. Once the font size has been adjusted, click "Save" in the main Settings window to finalize the change.
FontSize

Appearance

Users can choose the color scheme of the entire app using the Appearance setting. The following options are available: "Light", "Dark", and "Use system setting". Selecting "Light" displays the app in its default white-based theme. Selecting "Dark" turns on dark mode in the app, and selecting "Use system setting" changes the app to match your device's system setting. That is, if your device is using dark mode, the app will too. When you make a selection, the Settings screen is immediately updated to use the selected theme so you can preview what it will look like, but note that you must still tap "Save" to have the change take effect across the app.
DarkMode

Email Client

Users can choose if they wish to use the built-in Sugar Emails module to compose emails in the app or use the default email application on their device. The options include "Sugar Email Client" and "External Email Client".
EmailSetting

If you have access to Sugar Maps, this setting allows you to choose if you wish to use Sugar Maps when mapping records or one of the mapping applications installed on your device. The options include "Sugar Maps" along with any mapping apps recognized by the SugarCRM mobile app (e.g., Apple Maps, Google Maps). Note that if your Sugar instance does not have Sugar Maps, this setting will not be available and you will always use your default mapping application.
MapSetting

Start Screen

Users can specify what screen they want to appear upon first logging in to the app.
StartScreen iOS

The following options are available:

  • Activity Stream: Displays the user's main activity stream
  • Calendar: Displays the mobile calendar
  • Global Search: Provides a search across all records available as well as displaying a list of recently viewed records
  • Specific Dashboard: Displays the dashboard of the user's choice
    Note: When "Specific Dashboard" is selected from the Start Screen dropdown, users have the option to select all dashlets or a single dashlet from the specified dashboard to use as their Start Screen. 
  • Specific Module: Displays the list view of a single module of the user's choice

Enable Offline Capabilities

The Settings page has a toggle to enable or disable offline capabilities. Select the "Enable offline capabilities" checkbox and click the Save button to activate.
EnableOfflineCapabilities

Note: In order for the "Enable offline capabilities" option to appear, an administrator must first enable the option on your Sugar instance. For more information on enabling offline capabilities for an instance, please refer to the System documentation.

When enabled, your mobile device will cache records for offline viewing as well as buffer changes you make to records while offline to be synced upon reconnecting. This includes the addition and removal of attachments. Viewing a record in any list view, detail view, or edit view will cause it to be automatically cached in your local database, although attachments are not cached. Additionally, users will have the opportunity to preemptively download their assigned, favorited, and followed records from the Offline Settings menu. Data will sync between the mobile app and the Sugar database when the application is open and actively in use. If you navigate away from the application, synchronization will be suspended until you return to the mobile app.

To disable the service, unselect the "Enable offline capabilities" checkbox and click the Save button. Doing so will delete your device's local copies of any Sugar records and forget any changes that were made to records on the device but have not yet synced to the instance.

Touch ID

Users that are using an iOS device can specify if they want to be able to log in to the mobile app using their fingerprint. Enabling Touch ID will require tapping your Sugar password.
TouchID2

Enhanced Security Mode

The Setting page has a toggle to enable or disable Enhanced Security Mode, which behaves slightly differently on iOS versus Android devices.

On both iOS and Android devices, enabling this setting turns on the following security feature for the mobile app: when the mobile app is in the background on your device, the contents of the app are hidden and cannot be previewed in the list of open apps. This way, it is not possible to see any potentially sensitive data while scrolling through the list of apps.

On Android devices, this setting enables the following additional security feature: it is not possible to take a screenshot of any part of the app.
EnhancedSecurityMode iOS2

Notification Settings

If you are connected to an eligible Sugar instance, the mobile app can send push notifications to your device when certain events take place. Enable each setting if you wish to receive those notifications on your current device. If you log in to the app on multiple devices, you will also receive the notifications on those devices.
NotificationSettings

To stop receiving push notifications for one or more categories of events, simply disable the field in Notification Settings in the app. If you turn off notifications in the app on one mobile device, the notifications will stop on all devices.

You can turn on push notifications for the following types of events in Sugar:

Tapping a notification opens the relevant record in the app. If you are not logged in at the time, the login screen is opened instead and the relevant record will be opened after logging in.

Eligible Sugar Instances

You must be connected to a Sugar instance that meets the following conditions in order to access the Notification Settings screen and receive push notifications from the mobile app. The instance must be:

  • On Sugar version 11.1 or higher
  • On Sugar Sell, Serve, or Enterprise
  • Hosted in Sugar's cloud environment in one of the following regions:
    • ap-southeast-1: Asia Pacific (Singapore)
    • ap-southeast-2: Asia Pacific (Sydney)
    • ca-central-1: Canada (Central)
    • eu-central-1: Europe (Frankfurt)
    • eu-west-2: Europe (London)
    • us-west-2: US West (Oregon)
  • SugarIdentity-enabled

Offline

When the SugarCRM mobile app is offline enabled, the Main Menu includes an Offline Settings option that includes an offline status indicator, Always Offline mode, a transaction log, and an Offline Records screen with download settings and offline record counts.

Note that Sugar Logic calculations that use a related record will not be calculated correctly while your device is offline. When your device goes back online, the affected field will be recalculated using related record values as they exist at the time of reconnecting to the server. The correct value will then be stored in the server's database and synced back to your device.

In addition, dashlets that list records (e.g., list view dashlets and chart dashlets) will not load any new data while the app is offline. Only data that has previously been loaded in the dashlet will be displayed until the application reconnects to your Sugar instance.

Lastly, emails with an implicit relationship will not appear in the related record while the app is offline.

Offline Status Indicator

To the left of the Offline Settings menu item is an offline status indicator. Tapping to enter the Offline Settings menu reveals more details about the current status. When the indicator is amber or red, it will also appear overlayed on the Main Menu button in the app's header.
Offline Status Indicator

There are three statuses, each represented by a different color:

  • Green: The device is online and all records are synced. This dot will appear on the Offline Settings option in the Main Menu but not in the app's header. 
  • Amber: The device is offline, either because the user enabled Always Offline mode or due to no available connection, or the device is online but has pending changes in the transaction log which have not yet been synced. This last scenario can occur when the connection is very slow. The transaction log may contain errors, but they are not blocking the sync and will be retried when a connection is available. An amber dot will also appear overlayed on the Main Menu button in the app's header.
  • Red: There are pending changes in the transaction log that failed to sync because of some unrecoverable error. Critical error codes include 403, 405, 422, and 500. The failed transaction(s) will be retried, but these errors are unlikely to be resolved without user intervention. A red dot will also appear overlayed on the Main Menu button in the app's header.

Always Offline Mode

The Always Offline Mode setting can be enabled to force the app to stay offline, regardless of the availability of a network connection. This can be used when you know you will have an unreliable connection for a while, such as when entering a remote area with poor cellular service. When going in and out of service, the app normally tries to sync with your Sugar instance and only queues pending actions in the transaction log if unable to connect to the instance to complete the action. However, for large actions that may take a long time (e.g., uploading large files) or when working with an extremely unstable network, it is possible that the transaction will not sync as expected. To avoid this, enable "Always Offline Mode" before entering the area of unreliable service. The app will queue every action you take in the transaction log and will not attempt to sync anything with the server until you disable the Always Offline Mode setting. This way, you can have more confidence that all transactions will succeed by waiting to sync until your connection is reliable.
AlwaysOfflineMode

If you enter Always Offline mode and leave it on for more than a day, the mobile app will prompt you each morning to confirm if you want to continue in Always Offline mode or if you want to disable it and sync to the server again. This is to ensure that you only queue up actions to be synced for the minimum time necessary, since working while offline always poses some risk of becoming out of sync with your Sugar instance.

Transaction Log

The Transaction Log contains a list of pending and failed transactions between the mobile app and the instance. The pending changes have a white background and should be pushed to the instance without incident once a connection is re-established and the application is open and in use. Changes that cannot be pushed to the instance due to some problem or error will be listed with a yellow background. The offline status indicator will also appear in red to notify the user that such an issue has been encountered and requires attention. These changes require user intervention to clear.

You can view the details of any change by tapping its name. If a change has failed to take place, you will be presented with the Rollback option at the bottom. Use this option to revert the change on your local database and prevent it from being pushed to the instance upon reconnection. This removes the failed transaction from the log. If a change encountered a conflict with server configuration changes made by the admin in your Sugar instance and it is not possible to roll back your change, you will be presented with the Delete option. Use this option to clear the transaction from the Transaction Log. If a configuration change occurred but did not conflict with your change, your change will succeed after syncing with the Sugar instance.

Use the following steps to clear a change that is encountering an error:

  1. Tap "Offline Settings" from the Main Menu.
  2. Tap "Transaction Log".
    TransactionLog
  3. To view the details of a failed change, tap the change's row.
  4. Scroll down and tap "Rollback" in order to revert this change on your device and prevent the change from being made on the instance. You can tap "Cancel" to exit the log without removing the affected change.
    Offline Rollback

Offline Records

The Offline Records page displays counts of downloaded records as well as allowing you to configure and initiate a bulk download of records for offline use. Tap "Records" from the Offline Settings menu to access these options.
Records

Downloading Records

The SugarCRM mobile app allows you to proactively download your assigned, favorited, and followed records in addition to automatically downloading records you access in the app. The Download Settings section displays the last time a bulk download was performed. Tap the "Download" button to initiate the process. 

Note: Records related to your assigned, favorited, and followed records will not automatically be downloaded unless they, too, fall into one of these categories.
Offline Download

The download will automatically pause when you exit the app and resume when you begin using the app again. You can also manually pause or resume the download by tapping "Pause" or "Resume".

Note: Upon first login after enabling offline capabilities, you will be presented with the option to download your records. You may also choose to initiate the download at any time from the Offline Settings menu.

Use Cellular Data

By default, the app will only perform the bulk download using a Wi-Fi connection. Enable the Use Cellular Data toggle if you want to bulk download records even when no Wi-Fi connection is available.
Offline CellData

Record Counts

As you use the application, any records displayed in a list view, detail view, or edit view will automatically be stored in your local database while offline capabilities are enabled. Your device will download up to 3000 accounts, 3000 contacts, 3000 teams, 3000 employees, 3000 product catalog records, and 1000 records belonging to other modules. If you download more than the maximum number of records, the app will purge unused or less important records down to 90% of the maximum the next time you open the app.
Offline TotalRecords

Desktop Version

The Desktop Version option will switch applications on your phone to open your browser and navigate to your Sugar instance's login screen. This can be useful when you desire to access a module or perform an action in Sugar that is not supported in the mobile application.

Log Out

Tapping "Log Out" from the main menu will return to the SugarCRM Login screen where you can access the same instance from a different user or access a different installation of Sugar.

List View

The SugarCRM mobile app's list view lists records within a specific module as well as providing tools for searching, creating, and working with those records. As you scroll through the results, the app loads more records at the bottom of the list so you can continue scrolling. List views can be accessed from the main menu by tapping any module name. For example, tapping "Accounts" will open the Accounts list view. From a list view, you can return to the main menu by tapping the three-bar icon.
Nomad4.0 AccountsModuleMM

Using Studio from the desktop Sugar application, administrators can configure a default layout for each list view and the additional fields that are available for users to add to their views. For more information on configuring this default mobile layout, refer to the Studio documentation.

Users can update the default layout of their list views to design a list view that is most helpful to them for each module. See the List View Builder section below for details on how to do this.

Quick Create

The Quick Create button allows you to create a new record in the current module and appears at the top right corner of most modules' list views. 

The following steps cover creating a new account from the Accounts list view quick create as an example:

  1. Navigate to the Accounts list view by tapping "Accounts" within the main menu.
  2. Tap the "+" quick create button at the top right of the page.
    QuickCreate
  3. Fill in all desired fields using instructions in the Editing Records section as needed.
    Note: Fields that are required will show "Required" in grey.
  4. Tap "Save" to create the new account record. Tapping "Cancel" will return you to the Accounts list view without creating a new record.

Please note that your ability to create records in Sugar may be restricted by a role. For more information on roles, please refer to the Role Management documentation. Check with your system administrator if you do not see the Create options.

Note: Report, employee, and knowledge base records may not be created from the mobile app, so these modules do not include a Quick Create button.

You can search within a module from the top of each module's list view to see the list of matching results in the layout you have configured. Tap the magnifying glass icon in the header to expand the search box and begin typing the name of a record you wish to access.
Search

When the search bar is expanded, you can also filter the list of records by tapping the filter button and selecting the desired search filter (e.g., All Accounts, My Favorites). By default, the search filter is set to show all records. The record list automatically shows records with names starting with the characters you have typed and/or matching the selected filter. Tapping "x" clears your search term while tapping "Cancel" closes the search to show the previous list of records.
Search2

Wildcards can be used to search for criteria without including the entire word in the search. The wildcard character % matches any number of characters, including zero. Note that the wildcard character (%) is implicitly appended to the end of your search phrase.

Filters

In addition to searching for record names, you can filter the records in a list view in the same way you can in your desktop Sugar application. By default, the filter is set to show all records. Tap the Filter button to select the desired search filter or create a new one. 
BuildFilter

To create a new filter with customized criteria, follow these steps in any module's list view:

  1. Open the Filter menu by tapping the name of the currently applied filter, then select "Build Filter".
  2. First, enable the Save Filter checkbox if you wish to preserve this filter for use in the future. If this is a temporary, one-time-use filter, you can leave this checkbox disabled; this will cause the filter to automatically disappear the next time you switch to a different filter.
  3. If you are saving the filter, provide a name for the filter.
  4. Then, if you are saving the filter to your device and you wish to make this filter available to you in the desktop application too, enable "Save to Desktop App". Otherwise, leave it disabled to only save the filter locally in the mobile app. Or, if you are not saving the filter, you can ignore this field.
    Note: "Save to Desktop App" performs a one-way save and does not subsequently keep the filter in the mobile app in sync with the filter in the desktop app.
    SaveToDesktopApp2
  5. In the empty criteria box, select a field to filter by.
  6. Doing so displays the Operator field. Here, choose from the operators (e.g. "is any of") available for the type of field you selected.
  7. In the Value field that appears, choose the value(s) for the field that you want to filter the results by. For example, you may wish to filter accounts by a subset of industries.
    FilterCriteria
  8. To add another filter criteria, tap the Add Criteria button at the bottom and repeat steps 4-6 for each subsequent criteria. Once complete, the filter may look similar to this:
    FilterCriteria2
  9. Tap "Save" in the top right corner to preserve the new filter.

After saving, the filter is now applied to the list view.
FilterApplied

To edit an existing custom filter, tap the pencil icon next to the filter name when it is applied to open the Edit Filter screen.
PencilIcon

Here, you can change the name and criteria of the filter or delete it. If the filter has not yet been saved to your device or to the desktop Sugar application, you can also do so by enabling "Save filter" and "Save to Desktop App". However, if the filter has been saved to your Sugar instance, you cannot undo this change.

Once a filter has been selected in a list view, the search will be preserved when you navigate away from the page. Returning to the list view will automatically display the results of your last filter.

The following filter options are available in list views:

Filter Name Used With Search Description
All Records Yes Returns all records to which you have access
Note: By default, the module list view is set to "All <Module Name>".
My <Module Name>
My Records
Yes Returns only records assigned to you 
My Favorites Yes  Returns only records you have marked as favorites
Recently Viewed No Returns only records you have viewed within the last 7 days
Recently Created No  Returns only records you created in the module within the last 7 days
My Scheduled <Module Name> No Returns only scheduled calls or meetings assigned to the user
Note: This filter option is only available for the Calls and Meetings modules.
My Sent No Returns only email records where you are the sender
Note: This filter option is only available for the Emails module.
My Received No Returns only email records that were sent to you
Note: This filter option is only available for the Emails module.
My Drafts No Returns only email records assigned to you that have a status of "Draft"
Note: This filter option is only available for the Emails module.
With Charts No Returns only report records that have a chart
Note: This filter option is only available for the Reports module.
Custom Filters No Returns all records in the module that meet the specified criteria

Please note that you will only be able to see records as allowed by your team membership, user access type, and assigned roles. For more information on teams and roles, please refer to the Team Management and Role Management documentation.

Sorting

Module list views and lists of related records provide the ability to sort the current search or filter results by a specified field in either ascending or descending order. To sort, tap the sort button and select the desired field in the dropdown. To toggle sorting in ascending or descending order, tap the arrow icon to the right of the sort button. If you sort by a field that is not currently displayed in your configured list view layout, it is added to the bottom of each record.

Note: Multiselect-type fields and Teams fields are not available to be used with sorting.
Sorting

Actions Menu

Swipe left on a record's row in list view to open a context-sensitive menu of actions available for this record. The options which appear will differ based on the type of record and the fields it has populated. For a full list of available actions and a description of each, refer to the Record Actions section below.
Swipe1

If there are more than three available actions, tap "More" to access the remaining actions.
Swipe2

Multiple Selection

Press and hold a record in any list view to initiate multiple-selection mode. After a moment, a checkbox will appear next to every record, indicating whether or not it has been selected. The record you chose will be selected and you can tap other records to add them to your selection. A message across the top of the screen will show how many records you currently have selected (e.g., "3 Items Selected") and a three-dots menu will appear in the top right corner to allow you to perform mass actions on your chosen records.
MultiSelect

Scroll down the list to continue adding more records while maintaining your existing selections. If you wish to select all records, tap the three-dots menu in the top right corner and choose "Select all". This opens a pop-up asking if you would like to select just the records that are currently loaded or all records in the full result set, up to a maximum of 1000.
SelectAll

Once you have finalized your list of selections, use the mass actions in the three-dots menu in the top right corner to perform an action on the records. Or, to clear your selections, tap "Cancel" or use the Back button on your mobile device.

Mass Actions Menu

The following actions are available in the three-dots menu in the top right corner of list view when you are in multiple-selection mode:

  • Map: View multiple records on a map within Sugar Maps, if your instance has Sugar Maps.
  • Delete: Delete the selected records. 
  • Doc Merge: Merge multiple records into one document, for example, a set of mailing labels based on contact records in Sugar, if your instance has Doc Merge.
  • Email: For records with an email address (e.g., contacts, leads), start composing an email to all selected recipients.
  • Export CSV: Export the selected records to a CSV file that can be opened in a spreadsheet application.

MassActions

Note that each action is only available if it applies to the module you are viewing and you have the necessary role access for that action.

List View Builder

The List View Builder screen allows you to fully design the layout of the list view for each module so that you can choose the fields that are displayed and how they are organized. This layout also applies to List View dashlets. To access List View Builder, tap the gear icon on the right side of any list view:
LVB Gear

Once open, the screen has three main components: the List View Builder section, the Available Fields section, and the Restore Defaults link:
LVB WholeScreen

On top, the List View Builder section shows an outline of what the list view will look like with the current configuration. On the left side of the view, you can add up to four rows and each row can hold up to six fields. On the right side, you can also add up to four rows but each row holds only one field. Each individual field is represented by a draggable pill; empty placeholders, where fields can be dropped, are represented by a dotted-line box.

Press and hold fields to drag and drop them within List View Builder or up from the Available Fields section and drop them onto a placeholder to put them there or onto an existing field to swap the two. Placeholders expand when you hold a selected field over them to indicate that you have targeted that location. To remove a field from the layout, drag it to the trash can icon in the top right corner.
LVB LVB

The Available Fields section contains all fields that can be added to the view that are not already placed, as configured by your administrator in Studio. Use the Field Search bar to filter the list of available fields by name then drag the desired field onto a placeholder in the layout. If there is a horizontal scrollbar in the List View Builder section, simply hold a dragged field over the far side of the section to scroll in that direction before dropping the field.
LVB SearchBar

When you have organized the layout how you would like, tap "Save" in the top right corner of the screen to preserve your changes and see how they look once applied. Note that the list view for a module will look the same everywhere, whether you access it from the main menu or via the related records on another module (e.g., viewing the list of calls related to an account). Layout changes made in any location are applied everywhere you can view that module's list view.

At the bottom of the screen, you can use the Restore Defaults link to return the layout to the default state, as configured by an administrator in Studio. To save the default layout, be sure to tap "Save" afterward.
LVB RestoreDefaults

For more information on how admins can configure the default list view layout for each module and the list of fields that are available for users to add, see the Studio documentation in the Administration Guide.

Detail View

The SugarCRM mobile app's detail view shows the details, related records, dashboards, and activity stream of one specific record as well as providing the ability to edit and perform other actions on the record. Detail views can be accessed from many places in the application by tapping any record's hyperlinked name. For example, tapping a row on the Accounts list view or on the Global Search page will open the record in detail view.
DetailView

The following elements are available on detail view pages:
DetailView Labeled

  1. Previous Page: Tap the arrow on the top left to return to the page you last viewed.
  2. Main Menu: Tap the three-bar icon on the top left to access the main menu.
  3. More Actions Menu: The following actions are available by tapping the vertical ellipsis icon on the top right:  
    • Edit: Modify the values of this record.
    • Copy: Make a new record with the same field values as this record. 
    • Link Existing Record: Relate an existing record to this record.
    • Create Related Record: Create a new record and relate it to this record.
    • Share: Send a link to this record using the sharing options available on your device.
    • Download Quote PDF: On quote records only, download a PDF version of the quote using the PDF template specified in the menu item name.
    • Escalate: On accounts, cases, and opportunities, create an escalation record related to this record.
    • Doc Merge: If you have access to the Doc Merge functionality, merge this record with a document template to generate a PDF or DOCX file.
  4. Favorites Designation: Tap the Star icon to toggle whether a record is marked as a favorite for your user. A solid white star indicates it is a favorite. For more information, refer to the Favoriting Records section below.
  5. Record Actions: The context-sensitive menu of actions will differ based on the type of record and the fields it has populated. For a full list of available actions and a description of each, refer to the Record Actions section below.
  6. Record Tabs: The tabs below the Record Actions menu provide the following information and functionality. Each is described in greater detail in the following sections.
    • Details: Tap the Details tab to view the record's field values.
    • Related: Tap the Related tab to view, edit, and create records related to the current record.
    • Dashboards: The Dashboards tab displays the dashboards you configured to appear on this module's record view.
    • Activity Stream: The Activity Stream tab displays recent activity on this record and allows you to add comments or posts.

Details Tab

The Details tab shows the record's fields. Field values shown in blue can be tapped to open the related record or take an action such as calling a phone number or mapping an address. You can also press and hold an address field to copy the address to your clipboard for pasting elsewhere, such as in an email or text message.
DetailView Details

In addition, if the Tags field is displayed, you can tap an individual tag to open Global Search filtered by the tag to see all records with that tag.
Tag Cropped

If connected to a Sugar Sell, Serve, or Enterprise instance on version 11.2 or higher, admins can also configure and add certain Action Buttons to detail and edit view. These buttons are displayed within the list of fields and tapping them will perform specific, pre-configured actions as set up by your admin.
ActionButton

The following types of Action Buttons can be used in the mobile app:

  • Assign Record
  • Compose Email
  • Create Record
  • Doc Merge
  • Open URL
  • Update Record

If other types of buttons are displayed in the app, they will be disabled and cannot be used. Also, note that buttons configured to appear in the record header will not be displayed in the mobile app; they must be displayed within a detail view or edit view layout to be accessed via the app. See the Action Buttons documentation in the Administration Guide for more details on Action Buttons and the different types.

Note: Administrators have the ability to configure which fields appear here using Studio from the desktop Sugar application. In addition, if an admin has configured the view to change based on the value selected in a dropdown field, you could see a different layout for different records. For more information on configuring the Mobile DetailView layout or dropdown-conditional views, refer to the Mobile Layouts section and the Creating Dropdown-Field-Based Record View Layouts section in the Studio documentation.

The Related tab displays subpanel lists of records that are related to the record you are viewing. Each related module is displayed with the count of related records within that module. Tap the module name to see a list of its individual related records or tap the plus icon to add a related record of that module type. You can also press and hold any module to drag it to a new location within the list. This way, you can organize the subpanels so that your most-used modules are at the top.
DetailView Related

Once a list of related records is opened, the following options are available: 
RelatedTab

  1. Previous Page: Tap the arrow on the top left to return to the detail view.
  2. Quick Create: Tap the plus icon at the top right to quick-create a new related record. Once saved, the new record will automatically be related to the original record.
  3. Filter: Tap the Filter button to restrict which related records are displayed. For more information, refer to the Filters section.
  4. Sort: Select a field by which to sort the related records or tap the arrow icon to toggle between sorting in ascending or descending order. 
  5. Actions Menu: Swipe left on a row to display a context-sensitive menu of actions you can take on the record. For more information, refer to the Record Actions section. The "Unlink" action is unique to lists of related records. Tapping it removes the relationship between the two records without deleting either record. To close the menu without taking any action, swipe right on the record's row.
  6. Record Details: Tap a record's row to open it in detail view.

Dashboards Tab

The Dashboards tab contains the dashlets you have configured to appear on the module's record view via the desktop Sugar application. Tap the Dashboards tab to see the list of dashlets and then tap the dashlet's icon to open it. If you have more than one dashboard configured for this module's record view, you can select which to view from the dropdown list.
DetailView DashboardstTab2

Refer to the Dashboards section above for more information on working with dashboards in the mobile app. For information about configuring and using dashlets in desktop Sugar, please refer to the Dashboards and Dashlets documentation.

Activity Stream Tab

The Activity Stream tab displays recent activity on the record you are currently viewing. These posts will also appear on your main activity stream if you have marked the record as a favorite. Create posts by tapping "Add a Comment". To leave a comment on a specific post, simply tap the vertical ellipsis to the far right of each post then select "Comment". In addition, you can mention specific users or records by typing @ followed by the user's name or # followed by the record's name in the post or comment. Users or records included in posts can be tapped to open them in detail view. For more information, please refer to the Activity Streams documentation.
DetailView ActivityStream

Record Actions

The SugarCRM mobile app offers context-sensitive menus for performing operations on individual records. These menus are available on record views, list views, lists of related records, dashlets displaying a list of records, and the Global Search page. A subset of the following operations will be available in a record's Actions menus, depending on the record's type and populated fields:

Menu Item Description
Edit Opens the record for editing
Favorite/Unfavorite Favorites / Unfavorites the record
Delete Deletes the record from your Sugar instance
Call For records with a phone number, calls the number from your phone
SMS For records with a phone number, sends a text message from your phone
Email For records with an email address, sends an email from the mobile app
Web For records with a website, opens the website in your phone's browser
Map For records with an address, lets you map the address
If you have Sugar Maps, this will map the address within the mobile app using Sugar Maps, or if you do not have Sugar Maps or have selected a different default mapping application, it will open the address in that application.
File For records with attached images or files, opens the list of files available to be opened
If there is only one attached file, the file is opened immediately.
Attachments For records (e.g., emails) with file attachments, downloads and opens the file for viewing 
Unlink In a list of related records, deletes the relationship between the two records
Close For calls, meetings, and tasks in a non-closed status, changes the Status field to "Completed"

Accessing Actions Menus From Lists

On a list view, list of related recordsglobal search, and dashlets that display lists of records (e.g. list view dashlets), swipe right to left on a row to reveal its Actions menu. If more than three actions are available for a record, tap "More" to access the additional options.
ActionsMenu Swipe

Note: The action items that appear in the actions menu are dependent on the relevant field being added to the Mobile List View layout in Admin > Studio as well as the field being populated in the record. See the Studio documentation for details on updating mobile layouts.

Accessing Actions Menus From Detail View

On a record's detail view, the Actions menu will appear in a ribbon above the record's tabs. Scroll the menu horizontally to access all options.
DetailViewActionsMenu

Relationships between records allow you to connect relevant records together. While related records can be created and viewed from the detail view of a record, relationships can also be created via a record's detail view using the More Actions menu and the related records listing.

Please note that your ability to create and edit records in Sugar may be restricted by a role. For more information on roles, please refer to the Role Management documentation. Check with your system administrator if you do not see the desired options.

Users can create new records that are automatically related to an existing after save. As an example, the following steps use the Plus icon on the Related tab to create a new call related to the account you are viewing:

  1. From the account's detail view, tap the Related tab.
  2. Tap the plus icon on the Call module's row.
    CreateRelated
  3. Populate the desired fields and tap "Save".

The following methods also allow you to create new records related to the record you are currently viewing or editing:

  • Tap the More Actions menu's vertical ellipsis on the top right of a detail view and choose"Create Related Record".
    CreateRelated MoreActions
  • From the Related tab on a detail view, tap the desired module name (e.g., Calls), then tap the three-dot menu on the top right of the list of related records to access the Create Related Call menu option.
    RelatedCalls
  • When editing relate fields (e.g., "Account Name") or flex relate fields, tap the plus icon to the right of the magnifying glass icon.
    SelectAccount

Note: Report, employee, and knowledge base records may not be created or duplicated from the mobile app.

Linking Existing Records

Users can create a relationship between two existing records from the detail view of one of the records. As an example, the following steps use the detail view's More Actions menu to link an existing contact to the account record you are currently viewing:

  1. From the account's detail view, tap the vertical ellipsis at top right to access the More Actions menu.
    LinkRecord1
  2. Select "Link Existing Record" from the menu.
  3. On the "Choose Link Type" page which appears, select the Contacts module. The modules shown are all those which have a many-sided relationship to the original record's module.
    LinkRecord3
  4. You can use the filter and sort options or tap the magnifying glass icon to search in order to locate the records you wish to link to the original record. Select one or more records' checkboxes and tap "Done" to form the link.
    LinkExisting

You can also link existing records from the Records tab on a detail view by tapping the desired module, then tapping the More Actions menu's vertical ellipsis at the top right and selecting "Link Existing Record".
RelatedCalls

You can edit a related record directly from another record's detail view. As an example, the following steps demonstrate editing a call record from its related account detail view:

  1. Tap the Related tab on the account's detail view then tap the Calls module. 
    RelatedCalls
  2. Locate the desired record in the list of related records and swipe to the left on the record's row to access the Actions menu.
    EditRelatedCall
  3. Tap "Edit" and make changes as desired using instructions in the Editing Records section, then tap "Save" to preserve your changes.

Note: Quote records may not be editable when using some older, unsupported versions of Sugar.

If a relationship should no longer exist between two records, the records may be unlinked. Deleting the relationship will not delete either record. As an example, the following steps demonstrate deleting a relationship between an account and a call from the account's detail view:

  1. Tap the Related tab on the account's detail view then tap the Calls module. 
    RelatedCalls
  2. Locate the desired record in the list of related records and swipe to the left on the record's row to access the Actions menu.
    Unlink
  3. Choose "Unlink" from the list of options. If there are more than three actions available, tap "More" to access the additional options.

Creating Records

New records may be created in the mobile app from several different locations. You can create new records from the Global Search page, from a module's list view, or from an existing record's detail view by duplication or creating a related record.

Please note that your ability to create records in Sugar may be restricted by a role. For more information on roles, please refer to the Role Management documentation. Check with your system administrator if you do not see the Create options.

Note: Report, employee, and knowledge base records may not be created or duplicated from the mobile app.

Creating via Duplication

Creating a new record by duplication will copy the original record's field values but not any of its relationships. As an example, the following steps demonstrate creating a contact by duplicating an existing contact:

  1. Navigate to a contact's detail view.
  2. Tap the vertical ellipsis icon on the top right then select "Copy" from the More Actions menu.
    Mobile DV VerticalEllipsis Copy
  3. The displayed edit view is pre-populated with the original record's values. Update the necessary fields, then tap "Save".

Editing Records

Records may be edited from the mobile app by navigating to the detail view, tapping the vertical ellipsis icon on the top right, and selecting "Edit". This will open the record in edit view where values can be viewed and modified. All required fields will indicate "Required" in the field and must be completed prior to saving. Once you have made the desired modifications to a record's fields, tap "Save" to preserve the changes. You can tap "Cancel" at any time to return to the previous page without editing the record.
Mobile EditView

Administrators have the ability to configure which fields appear here using Studio from the desktop Sugar application. In addition, if an admin has configured the view to change based on the value selected in a dropdown field, you could see a different layout for different records and the layout could change when you update a dropdown field. For more information on configuring the Mobile EditView layout or dropdown-conditional views, refer to the Mobile Layouts section and the Creating Dropdown-Field-Based Record View Layouts section in the Studio documentation.

Please note that your ability to edit records in Sugar may be restricted by a role. For more information on roles, please refer to the Role Management documentation. Check with your system administrator if you do not have the ability to edit records.

Note: Report, employee, and knowledge base records may not be edited in the mobile app. Quote records may not be editable when using some older, unsupported versions of Sugar.

Note: Calculated or dependent fields which use a related function do not work when offline. Once users enter online mode, the calculated or dependent fields will show the correct value.

Editing Email Addresses

Email address fields can store one or more email addresses for a single record. You can also designate whether they are the primary email address for a record, are opted-out, or are invalid.

Use the following steps to edit an email address field:

  1. Tap "Add email" to add a new email address to the record. 
  2. To edit an existing email address, tap on the specific email address and make the necessary changes. Tapping the "x" will clear the email address.
    Mobile EditView EmailAddress
  3. Tap the vertical ellipsis icon to the right of the email address to set it as the primary email address for the record, mark it as opted-out, mark it as invalid, or remove it.

Editing Multiselect Fields

Multiselect fields provide a list of values where one or more values can be selected at a time.

Use the following steps to edit a multiselect field:

  1. Tap the multiselect field.
  2. Mark the checkboxes of the items you wish to select. If you wish to have no items selected, choose the blank option.
  3. Tap "Done" to preserve your new values. Tapping "Cancel" will return you to the edit view page without altering the field's value.
    Mobile EditView Multiselect Select
  4. To remove an item from the multiselect field, tap the "x" icon located to the right of the item tag.
    Mobile EditView Multiselect Remove

Editing Radio Fields

Radio fields provide a list of values where only one value can be selected at a time.

To edit a radio field, tap the field and select the desired value.
Mobile EditView Radio

Editing Relate & Relationship Fields

Relate fields allow you to create a one-way link from your original record to another record in Sugar. Relationships allowing only one link from your original record to another module are edited the same way.

The following steps cover editing the Account Name field as an example:

  1. Tap the "x" icon to the right of the record's name to clear the value first or you can simply tap the field to select or create a record.
    Mobile5.1.0 AccountNameField Xicon
  2. You can use the filter and sort options or tap the magnifying glass icon to search in order to locate and select an account you wish to relate to the current record.
  3. If you wish to create a new related record, simply tap the Plus icon to the right of the magnifying glass icon. Populate the desired fields then tap "Save".
    Note: Your ability to create records in Sugar may be restricted by a role. For more information on roles, please refer to the Role Management documentation. Check with your system administrator if you do not see the Create options.
    Mobile5.1.0 AccountNameField SelectAccountPage1

Note: If any view includes a relate field to a disabled module, the view will display "No Access" in the mobile app.

Editing Flex Relate Fields

Flex relate fields allow you to select the desired module first then a record from that module to relate it to the current record.

The following steps cover editing the Related To field in the Calls module as an example:

  1. Tap the Related To field in the edit view.
  2. Select the module (e.g., Account) you wish to relate to on the Choose Parent Type page.
    ChooseLinkType
  3. You can use the filter and sort options or tap the magnifying glass icon to search in order to locate and select a record you wish to relate to the current record.
  4. If you wish to create a new related record, simply tap the plus icon to the right of the magnifying glass icon. Populate the desired fields then tap "Save".
    Note: Your ability to create records in Sugar may be restricted by a role. For more information on roles, please refer to the Role Management documentation. Check with your system administrator if you do not see the Create options.
    SelectAccount2

Editing Teams

The team field specifies which team of users have access to view the record.

Use the following steps to edit a record's assigned teams:

  1. To assign a team to the record, simply tap the Teams field.
  2. Use the Select Teams page to search for and mark the checkboxes of teams you wish to assign to the record.
  3. Tap "Done" to add the chosen team(s) to your record.
    Mobile EditView TeamsField SelectTeams
  4. To remove any unwanted teams, simply tap the "x" icon to the far right of the team name.
  5. To designate a team as the record's primary team, tap the star icon.
    Mobile EditView TeamsField Remove Favorite

Editing Tags

The Tags field lists all tags that have been applied to the record, and you can tap an individual tag to open Global Search filtered by the tag to see all records with that tag. Refer to the Tags documentation in the Application guide for more information on how tags work in Sugar.

Use the following steps to edit a record's tags:

  1. To add a new tag, tap "Add tag" under the Tags field in edit view. Start typing the name of an existing tag and select it when it appears in the list of options, or select the "New tag" option to create a new tag with the name you have entered.
    AddTag
  2. To remove a tag, simply tap the "x" icon next to it in edit view:
    RemoveTag
  3. Once you have finished updating the record's tags, press "Save" to preserve your changes.

Editing Image Fields

It is possible to edit the image-type field of any module in the mobile app as long as the image field is present on the module's edit view. For information on modifying mobile layouts, please refer to the Studio documentation.

The following steps cover editing a lead's image-type field via edit view as an example:

  1. Navigate to a lead's edit view and tap the existing image or the placeholder image icon.
    Mobile EditView Leads ImageField Edit
  2. Tap the appropriate option to either take a new picture using your device's camera or select a photo from your device's photo album.
  3. Once you have selected an image, tap the File Size link to open the Image Quality screen if you wish to change the size at which the file is saved. To preserve the original quality of the image, choose "Original"; if the file is large, you may wish to choose a smaller size to reduce upload time by reducing the image quality. An estimated file size for each size option is shown at the bottom.
    ImageResize2
  4. To remove an image, simply tap the "x" icon on the far right.
    nomad_editimage_5
  5. Tap "Save" to preserve your changes. Note that on detail view, the image will be accessible using the File icon.

The Contacts module allows its Picture field to be edited directly via the mobile detail view instead of only from edit view. Use the following steps to edit a contact record's Picture field via detail view:

  1. Navigate to a contact's detail view and tap the existing image or the placeholder image icon.
    Editing Image Fields Nomad2.6
  2. Tap the appropriate option to either take a new picture using your device's camera or select a photo from your device's photo album.

Adding Comment Log Entries

The Comment Log field allows users to add messages, comments, or other text to a log appearing on the detail view of a record.
CommentLog Crop

To add an entry, tap "Add a Comment" to open a new screen where you can add text, mention users, and reference records. For more information on tagging users and records in this way, refer to the User Interface documentation. To add your comment, tap "Done" and then "Yes" in the confirmation dialog that appears. This appends the message to the log with a link to the user that added the entry and the date and time the entry was created. Once saved, entries cannot be edited or removed.
CommentLogAdd Crop

Comment Log entries can be sorted by timestamp using the arrow next to the field; this sort order is remembered per record the next time the record is opened. Note that if you add a new entry when the Comment Log is sorted with the oldest on top, the new entry is still added at the top. The new entry will be placed in the correct order the next time the record is opened. Entries longer than 150 characters are truncated on detail view, but tapping "Show entire comment" opens the full text.

The Comment Log field is displayed on the detail view of the Cases module by default and can also be added to most other modules in Studio.

Deleting Records

Records can be deleted from your Sugar instance using the Delete option in the Actions menuMass Actions menu, or at the bottom of edit view. Deleting a record will not delete its related records and will only remove the relationship, so you may wish to also delete any related records to avoid orphaned records.

Please note that your ability to delete records in Sugar may be restricted by a role. For more information on roles, please refer to the Role Management documentation. Check with your system administrator if you do not see the Delete options.

Deleting via Record Lists

Individual records can be deleted from the Global Search page or list view by selecting the "Delete" action from the row's Actions menu as described in the Accessing Actions Menus From Lists section above.
Mobile ListView Delete

You can also delete many records at once from a list view by selecting multiple records and using the Mass Actions menu to delete them.

Records may not be deleted from a list of related records, but their relationship can be removed from this screen using the Unlink option. If you wish to delete a related record rather than just unlink it, you must first tap the related record's name to open its detail view, then follow the instructions in the Deleting via Edit View section below.

Deleting via Edit View

Use the following steps to delete a record from its edit view:

  1. Navigate to a record's detail view, tap the vertical ellipsis icon on the top right, then select "Edit" from the More Actions menu.
    Mobile VerticalEllipsis Edit
  2. Scroll to the bottom of the edit view and tap "Delete". 
    Mobile EditView Delete
  3. A pop-up message will display asking for confirmation. Tap "Yes" to proceed.

Working With Calls and Meetings

Certain aspects of call and meeting records have additional functionality that allows you to create recurring events without having to do so manually, add invitees from different modules (e.g., contacts, leads) efficiently, and close events quickly. See the sections below for details on how to work with calls and meetings in the mobile app.

Creating Recurring Calls and Meetings

When you need a call or meeting that takes place at a regular interval, you can create a recurring event from within the mobile app, which creates a record for each recurrence automatically. The following steps cover creating a recurring meeting as an example:

  1. Create a new meeting record and populate the basic, required fields such as "Subject".
  2. In the Repeat field, tap "Configure" to open the Repeat screen, where you can configure the details of the recurrence.
    ConfigureRecurrence
  3. Choose a repeat type (e.g., "Weekly"). This will cause more fields to appear below based on your selection.
  4. In this example of creating a weekly meeting, the Repeat on Days of Week field appears; select the desired days of the week.
  5. In the Repeat field, choose the method of defining the end of the series. In this example, we will use "Occurrences".
  6. In the Repeat Occurrences field, specify the number of times the recurrence should take place.
    RecurrenceSettings
  7. Tap "Done" in the top right corner and then save the meeting.

A new meeting record for each recurrence of the event should now exist in the Meetings module. When deleting a recurring meeting from list view, you will be presented with the additional option to delete all recurrences instead. This will delete every event in the series.

For more information on recurring meetings and calls, refer to the Meetings and Calls documentation in the Application Guide.

Inviting Call and Meeting Attendees

Contacts, leads, accounts, and other Sugar users can be added to calls and meetings as attendees. You will have the option to email attendees an invitation when saving the call or meeting. For more information about attendees, please refer to the Calls or Meetings documentation.

Adding Attendees During Creation

When a call or meeting is initially being created, a Guests field is available where you can add invitees. The following steps cover adding a contact to a new call as an example:

  1. Create a new call record and populate the desired fields.
  2. Scroll to the bottom of the page and tap the Guests field.
  3. On the Choose Link Type page, select the Contacts module.
    Mobile EditView Guests ChooseLinkType
  4. You can use filtersort, or search in order to locate the contact records you wish to add as attendees for the call. Select one or more records' checkboxes and tap "Done" to add the attendees.
    LinkExisting
  5. To have an email invitation sent to the attendees upon save, tap the "Send invite" checkbox. To remove an unwanted attendee, tap the x icon to the right of the attendee's name.
    Mobile EditView Guests Final
  6. Tap "Save" to finish creating the call.

Adding Attendees to Existing Records

Once a new call or meeting has been saved, the Guests field is no longer available to edit. For these existing records, you may remove attendees or add additional attendees via the Related tab. The following steps cover adding a contact as an attendee to an existing call as an example:

  1. From the call's detail view, tap the vertical ellipsis at the top right and select "Link Existing Record" from the More Actions menu.
    CallMoreActions
  2. On the Choose Link Type page, select the Contacts module.
    Mobile EditView Guests ChooseLinkType
  3. You can use filtersort, or search in order to locate the contact records you wish to add as attendees for the call. Select one or more records' checkboxes and tap "Done" to add the attendees.
    LinkExisting

Closing Calls, Meetings, and Tasks

Users can easily change the status of calls, meetings, and tasks to "Completed" without having to directly edit the Status field. The activity records can be closed when editing the record or from the Actions menu when viewing a list of records.

Note: Only records in a non-closed status will allow the following closing options.

The following steps cover closing a task from Tasks edit view as an example:

  1. Navigate to the task's detail view, tap the vertical ellipsis icon on the top right, then select "Edit".
  2. Tap the down arrow to the right of "Save" then select "Close task and save".
    Mobile Tasks CloseTaskAndSave

From a list of records such as Global Search, list view, dashlets, or lists of related records, you can select the "Close" action from the row's Actions menu as described in the Accessing Actions Menus From Lists section above.

Composing Emails

You can compose and send emails directly in the SugarCRM mobile app so that the emails are archived in your Sugar instance and related to all relevant records. For example, you may want a history of your email communications with a contact to be displayed in the Emails subpanel for that contact; sending the email via the SugarCRM mobile app instead of an external application will do this automatically. You also have the option to manually archive an email in Sugar by navigating to the Emails module and accessing the Archive Email option in the three-dots menu in the top right corner:
ArchiveEmail

You can also compose an email from this menu as well as from several other places throughout the app. For a list of the places where you can start composing an email, see the Emailing Records section of this page.

The fields available when composing and viewing emails in the mobile app are the same as when working with emails in the desktop application; refer to the list of Email fields in the Application Guide for a summary of these fields. In addition, for a complete overview of how emails work in Sugar, including topics such as sending, receiving, and archiving emails, see the full Emails page in the Application Guide.

Once the Compose Email screen is open in the app, use the fields shown to prepare the email. To draft the body of the email, simply tap the Email Message field to open the WYSIWYG text editor, where you can write your email and apply basic formatting. Tap "Save" on this screen to return to the Compose Email screen where you can continue by choosing recipients and using templates or signatures. Refer to the below sections for details on these steps:

In addition to the above, you can also add attachments to an email in the same way you add attachments to other records in the app (e.g., notes). See the Uploading Record Files section of this page for more details on how to do this.

When you are ready to send the email, tap "Send" in the top right corner. If you wish to save the email as a draft instead, tap "Cancel" in the top left corner. This will cause a pop-up to appear asking if you would like to save the email as a draft or discard it. If you choose to save as a draft, you can then return to it later to continue editing.

Note: Email composing and sending is not available when your device is offline.

Working With Recipient Fields

There are three recipient fields you can use: "To", "Cc", and "Bcc". The Cc and Bcc fields are not displayed by default but can be opened by tapping the CC and BCC buttons on the right-hand side:
CcBcc

Tap the button again to hide the field. Note that if you hide the field after adding recipients, the recipients remain in the field and will still receive the email unless you manually remove them.

You can add recipients to all three fields using one of two methods: either use the address book or start typing using freehand entry. If you use freehand entry, the app will suggest matching recipients for you to select or you can simply enter the complete email address yourself. Once a recipient is added, you can remove it by tapping the "x" within the recipient's pill when the specific field (e.g., "To") is active:
DeleteRecipient

If the field is not active, the recipients are displayed as text instead. Simply tap anywhere in the field to activate it for editing.

Using the Address Book

To add someone to one of the recipient fields using the address book, tap the Address Book icon next to that particular field:
AddressBookIcon

Once open, the address book provides you with a list of users, contacts, leads, and accounts with at least one valid email address. The record's module (e.g., contact) is indicated by the color-coded circle next to the record. Tap the magnifying glass at the top of the screen to search for specific recipients and use the filter dropdown on the left to narrow the matching results down to a particular module.
AddressBook3

After you have filtered the list as needed, tap each result you wish to add. Once you have made your selections, tap "Done" in the top right corner to add the selections to the email's recipients list.


AddressBook4

Freehand Address Entry

In addition to using the address book, you can also add someone just by typing in the recipient field. Tap the field to make it active, which displays the keyboard. Start typing the name or email address of the recipient you wish to add; as you type, a list of matches will appear, allowing you to select one. The record's module (e.g., contact) is indicated by the color-coded circle next to the record. Alternatively, you can simply type the entire email address yourself if it is not an email address that is currently in your Sugar database.
Freehand2

Adding Email Attachments

You can attach one or more files to an email from either your local device or from a Sugar document record. Simply tap the paperclip icon:
Attachments

This opens a pop-up menu where you can choose where to select the file from. Note that selecting a document record does not create a relationship between the email and the document. It simply takes the file in the document and attaches that file to the email.
Attachments2

Once your selected file(s) are uploaded, they are shown in the Attachments field and can also be removed from the email by tapping the "x" icon next to them. See the Uploading Record Files section for more information on working with attachments in the mobile app.

Using an Email Template

Email templates can be used to save time and reduce errors when drafting emails in the SugarCRM mobile app, although the templates can only be created or edited in the desktop application. To use a template, tap the Template icon and select one from the list of templates that are available to you.
Template2

Note that if the body or subject of your email contains any data before you select a template, the body and subject will be removed and replaced with the template data. Similarly, if the message contains an attachment, the attachment will be removed and replaced with any attachments that the template may contain. Refer to the Emails page in the Application Guide for best practices when working with email templates and details on creating and editing templates in the desktop app.

Once an email template has been inserted in the email editor, users are free to edit the subject and email body, add or remove attachments, and insert a signature on the message.

Using an Email Signature

Email signatures can be added to emails in the SugarCRM mobile app to standardize the messages you send, although they can only be created or edited in the desktop application. If you have a default signature configured in your Sugar instance, this signature will automatically be applied when drafting new emails. See the Emails page in the Application Guide for more information on creating signatures and choosing a default via the desktop app.

To manually select a signature to use, tap the Signature icon and select one from the list of signatures that are available to you. Once selected, the signature's text will be inserted into the email body.
Signature2

If you do this while you already have a signature applied, it will be replaced with your new selection. If you wish to completely remove a signature from your message, you must edit the email body and manually delete the text.

Converting Leads

When a lead is qualified as a sales opportunity according to your organization's practices (e.g., after an evaluation/qualification process or upon entering into business with the individual), you can convert the lead via the Leads detail view or list view. To initiate the conversion process, simply tap the Convert icon in the detail view's Record Actions menu or select the Convert action from the list view row's Actions menu. When the lead is converted, a new contact record is created in your Sugar instance with a relationship to the original lead record. In addition, the lead conversion process gives you the option to create an account and opportunity record. Please note that lead conversion is not available when there is no internet connection on your mobile device.  

Administrators have the ability to mark modules as required for conversion, add additional modules to the lead conversion process, and remove modules from the lead conversion process by configuring the Convert Lead layout via Admin > Studio on the desktop Sugar application. For more information on configuring the Convert Lead layout, please refer to the Studio documentation. Note that only the following modules are supported for lead conversion in the mobile application:

  • Contacts
  • Accounts
  • Opportunities (for Sugar Sell, Enterprise, and Professional)
  • Tasks
  • Cases
  • Notes
  • Revenue Line Items (for Sugar Sell and Enterprise)
  • Custom modules (enabled for the mobile app)

Note: Users assigned a role in Sugar restricting access or edit permission for a supported module (e.g., Opportunities) will not see the particular module step during the lead conversion process.

If any unsupported modules are added to the Convert Lead layout and marked as required, the lead conversion feature becomes disabled in the mobile app and the Convert icon will not appear in the Record Actions menu.

Use the following steps to convert a lead via the Leads detail view:

  1. Locate an unconverted lead record and open its detail view.
  2. Tap the Convert icon in the Record Actions menu to initiate the lead conversion process. Or, from the Leads list view, simply select the Convert action from the row's Actions menu as described in the Accessing Actions Menus From Lists section.
    From Leads detail view:
    LeadConversion DetailView ConvertIcon
    From Leads list view:
    LeadConversion ListView ConvertOption
  3. The system will automatically perform a duplicate check to see if any existing records are found in the modules. The duplicate records, if any, will be displayed on the screen for the particular module (e.g., Contact) during the lead conversion process. You can click the Show More link to view additional record details. If you wish to relate an existing record to the lead, simply tap the radio button to the left of the record's details. 
  4.  If you wish to perform a list view search for other existing contact records to relate to the lead, simply tap the Search Existing Contacts link.
    LeadConversion Contact SelectFromDuplicate1
  5. To create a new record, tap the Create Contact link instead and the displayed edit view will be pre-populated with the lead's values. Update any necessary fields then tap "Save" to relate the new record to the lead. The created contact will automatically be selected and the record details will be displayed on the previous Contact step.
    LeadConversion CreateContact
  6. Tap the Account button to proceed to the Account step of the lead conversion process.
    Note: As each step of the lead conversion is completed, the progress bar on the upper right of the screen will advance.
    LeadConversion ContactCreatedSelected
  7. If the lead record's Account Name field is populated and there are no duplicate account records found, the new record will be automatically created and selected on the Account step. Tap "Edit" to update any fields for the record. If you wish to relate an existing account instead, simply tap the Search Existing Accounts link. Tap the Opportunity button to proceed to the Opportunity step. If you wish to navigate back to the previous step, tap the Contact link. 
    Note: If the lead record's Account Name field is not populated, the Account step will be displayed, giving users the option to associate an existing account or create a new account record instead.
    LeadConversion AccountStep
  8. New or existing opportunity records can be related to the lead by tapping the "Search Existing Opportunities" or "Create Opportunity" link. If the Opportunities step indicates that it is optional, then an opportunity record is not required to convert the lead. If any other supported modules are added to the Convert Lead layout in Studio, you will continue the lead conversion process by tapping the <Module Name> button (e.g., Task) to relate a new or existing record to the lead as necessary.
    LeadConversion OpportunityStep
  9. Once all of the necessary steps have been completed, tap the Convert button to convert the lead.
    LeadConversion Convert

Once the lead conversion process completes, you will return to the lead's detail view, and the Status field will now display "Converted". Links to any contact, account, or opportunity records you created during conversion are added to the bottom of detail view. In addition, the Convert icon will no longer be displayed in the Record Actions menu. Please note that the Status field becomes read-only upon conversion and cannot be manually changed for the lead.
LeadConversion ConvertedStatus

Building Quotes

Quotes may be created and modified from within the SugarCRM mobile app. This includes building quotes by creating groups, comments, and quoted line items which are based on items from the product catalog. Groups are optional but can be used to organize similar products or services. For example, a quote for software might have a group labeled "Services" to contain the quoted line items for implementation and extended support. For more information about working with quotes, please refer to the Quotes documentation.

When creating or editing a quote record, tap the Quoted Line Items tab to access its worksheet where you can add and manipulate line items, comments, and groups. Tap the Details tab to view and modify the quote's fields (e.g., Valid Until and Quote Stage).
EditingQuote

Note: The Quotes and Quoted Line Items modules may need to be made available in the mobile app by your administrator via Admin > Mobile. For more information on controlling which modules are available in the mobile app, please refer to the System documentation. In addition, your administrator may need to take action for the quote worksheet configuration to be in sync with the configuration in the desktop app after upgrading to Sugar 10.0.5 or 11.0.x. To resolve this, an admin must re-save the Quotes Configuration by navigating to Admin > Quotes Configuration in the desktop application and clicking "Save". More information can be found in the Quotes Configuration documentation in the Administration Guide.

Working With Groups

The quoted line items and comments for a quote may optionally be organized into groups to bundle similar products or services together. For more information on quoted line item groups, please refer to the Quotes documentation.

To insert a group, tap "Add a Group" then tap the blank space beneath "Group Name" to type the group's name. You can then add line items and comments to the group by tapping "+ Quoted Line Item" and "+ Comment" buttons at the bottom of the group. Each group will display a Group Total value which sums all line item totals within the group.
Quote Group1

You can delete a group by tapping the "x" in the group's header. Doing so will move all comments and line items to the ungrouped portion of the quote.

Working With Quoted Line Items

Quoted line items can be added independently or within groups. To add a line item to a group, you must first create the group, then use the "+ Quoted Line Item" button at the bottom of the desired group. Tapping the "+ Quoted Line Item" at the top of the quote will create an ungrouped line item.

After adding the quoted line item, select an item from the product catalog by tapping the Line Item field then complete and adjust any other desired fields. The line item, group, and quote totals will update as you work.

If you have "Show Preferred Currency" enabled in your profile in Sugar, quoted line items are displayed in the app in your preferred currency, with the quoted line item's currency displayed next to each value. Please note that this is not the same as how the Quotes module works in the desktop application. See the Quotes documentation for more details.
Quoted Line Item

Note: The ability to create custom quoted line items is not supported in the mobile app. Ad-hoc line items can be created from the desktop application.

You can delete a quoted line item by tapping the "x" in the line item's header. This can also be done through the menu next to each line item when viewing the quote.

Working With Comments

Comments can be added independently or within groups. To add a comment to a group, you must first create the group, then use the "+ Comment" button at the bottom of the desired group. Tapping the "+ Comment" at the top of the quote will create an ungrouped comment.

After adding the comment, tap the blank space below the Comment header, type your desired text, and tap "Done" at the top of the screen.
Quote Comment

You can delete a comment by tapping the "x" in the comment's header. This can also be done through the menu next to each comment when viewing the quote.

Totals and Shipping

As you work to build the quote, various fields will automatically calculate to show updated values. Totals encompassing the entire quote appear at the top of the worksheet along with a Shipping field which is user provided. In edit view, these totals are displayed at the bottom of the worksheet.

If you have "Show Preferred Currency" enabled in your profile in Sugar, the values are displayed in the app in your preferred currency, with the quote's currency displayed next to each value. Note that in the desktop application, only the quote's currency is used. See the Quotes documentation for more details.
Quote Totals

  • Line Item Total: The calculated total for an individual quoted line item.
  • Group Total: The calculated sum of a group's line item totals.
  • Total Discount: The calculated sum of all discounts appearing on any of the quote's line items.
  • Discounted Subtotal: The calculated total of all line items, including their discounts.
  • Tax: The calculated total tax amount based on the quote's tax rate being applied to line item totals. Please note that an admin needs to add the Tax Rate field to the Quotes module's Mobile EditView via Admin > Studio in order to set a quote's tax rate via the app. For more information, refer to the Studio documentation.
  • Shipping: A user-provided cost for shipping the quoted items.
  • Grand Total: The calculated sum of all line items plus any taxes and shipping costs within a quote.

An administrator can configure which fields are displayed in the worksheet totals via Quotes Configuration in Sugar; this configuration applies to both the Sugar desktop application and the mobile app. Refer to the Quotes documentation for more details.

Note: At this time, the ability to view and modify the quote's currency is not supported in the mobile app. A quote's currency can be viewed and changed from the desktop application.

Downloading Quote PDFs

Quotes can be downloaded as PDFs using the PDF templates created by your system administrator. To download a quote PDF, open the More Actions Menu via the vertical ellipsis icon in the top right corner when viewing a quote record. The menu contains a download option for each PDF template associated with the Quotes module:
DownloadQuotePDFBoxedCropped

Tapping the Download button opens the PDF in the default PDF application on your device. From there, you can save the file to your device or share it with others using your device's email application.

Note that downloading quote PDFs only works with Sugar instances on version 9.0.x and higher and does not work on device web browsers. In addition, if an administrator adds or removes a template, you will need to log out and in to see the changes in the mobile app.

Cascading Opportunity Values

If you are using opportunities with revenue line items, it is possible to cascade values on an opportunity down to its revenue line items. When editing the opportunity, you will see a checkbox below certain fields called "Update Open Revenue Line Items". Enable this checkbox to make the field above it available for editing. When you save the opportunity, the value you entered will also be applied to any eligible revenue line items.
Cascading

The fields that can be cascaded in this way are:

  • Expected Close Date
  • Forecast
  • Sales Stage
  • Service Duration
  • Service Start Date

To learn more about opportunity cascading, see the Opportunities documentation in the Application Guide.

Executing SugarBPM Processes

The SugarCRM mobile app allows users to approve, reject, and route SugarBPM processes, including self-service processes, from their mobile device. To view all running processes that are either assigned to you or available to be claimed, view the Processes dashlet in the mobile app. Note that the dashlet must first be added to one of the dashboards in your Sugar instance. For more information on adding dashlets to a dashboard, refer to the Dashboards and Dashlets documentation in the Application Guide.

You can also use the Processes module to access processes that are assigned to you, but self-service processes can only be viewed from the Processes dashlet.

To execute a process, use the following steps:

  1. Open the Processes dashlet. Using the Current and Overdue filters in combination with the My Processes and Self Service Processes tabs, tap the process that you would like to execute:
    Process Select
  2. After tapping a process, the target record's detail view is displayed with a pop-up asking how you would like to complete the process. Depending on if the process is an approval or routed process, tap the appropriate button in the pop-up to proceed:
    Process Route
  3. If the record is missing values for any fields that are required by the process, edit view is opened. Fill in all required fields and proceed by tapping the Route or Approve button in the top right corner:
    Process Required

Once the process has been executed, the Processes dashlet is displayed again.

For more details on SugarBPM processes, refer to the Processes documentation in the Application Guide.

Escalating Records

In Sugar Sell, Serve, and Enterprise on version 11.2 and higher, it is possible to escalate records in the following modules in the mobile app: accounts, cases, and opportunities. This can be done via the More Actions menu in the top right corner of a record's detail view and selecting "Escalate" or by adding a new escalation via the Escalations subpanel in the Related tab. If a record has at least one open escalation, a banner is displayed across its detail view indicating that the record is escalated. If an admin has configured it, the Escalated field can also be added to your list view layouts so you can see which records are currently escalated from list view.
Escalation

Note that since the Bugs module is not available in the mobile app, you can view a bug escalation but cannot see any details on the bug itself. For more information on escalations, see the Escalations page in the Application Guide.

Merging Records With a Document Template

If you are connected to a Sugar instance with access to Doc Merge, you can generate documents based on record data from the mobile app. From the More Actions menu on any record, select "Doc Merge" and then choose "Doc Merge to PDF" to generate a PDF file or "Doc Merge" to generate a DOCX file.
RecordActionDocMerge

You can also merge multiple records into one document (e.g., a set of mailing labels) by selecting several records in list view and using the Mass Actions menu to initiate the document merge. To do this, you must ensure that the template you use is designed for a multiple-record merge. See the Doc Merge documentation in the Application Guide for more details.

After selecting a file type, a list of document templates to which you have access is displayed. Tap the template you wish to use to initiate the merge process.
NewTemplates

After starting the merge, you will be navigated to the Document Merges screen to see the status of your merge. Here, you can also see the status of all past merges you have performed, whether you performed them in the desktop application or the mobile app. If a merge failed due to an error, tap the merge in the list to view the error message. This screen does not refresh automatically, so swipe down on the screen to refresh the list to see when your merge is complete.
InProgress2

If you do not wish to wait for the merge, you can return to the Document Merges screen at any time from the main menu of the app:
MainMenuDocMerge

To view the list of document templates available to you, you can either open the Document Templates module from the main menu if it is displayed there or from within the Document Merges screen using the icon in the top right corner:
DocTemplates

Favoriting Records

Users have the option to designate favorite records so that they can be located in lists of records using the My Favorites filter as well as having their updates appear in the main menu's activity stream. For more information about favorites, refer to the User Interface documentation.

When viewing a record's detail view, you can tap the star icon on the top right. A solid white star indicates it is a favorite. Tap the star again toggle the favorites designation off.
Mobile DetailView Favorite

From a list of records such as Global Search, list view, dashlets, or lists of related records, you can select the "Favorite" and "Unfavorite" actions from the row's Actions menu as described in the Accessing Actions Menus From Lists section above.

Calling Records

If a record has a populated phone number field, you can tap the Call icon in the Actions menu in detail view. Please note that the Call icon will be grayed out if the record's phone number field is not populated. Additionally, you can tap the phone number itself on the Details tab. Your device's phone application will appear where you can make the call.
Mobile DetailView Call

From a list of records such as Global Search, list view, dashlets, or lists of related records, you can select the "Call" action from the row's Actions menu as described in the Accessing Actions Menus From Lists section above.

After you complete the call and return to the SugarCRM mobile app, you will be asked if you want to log the call. If you do, the newly created call will automatically be related to the record from which the call originated. An exception to this is calling a contact that has a related account; in this case, the account will be populated in the Related To field instead. However, you can change the value of the field before saving if you prefer to relate it to something else, such as the relevant opportunity.

Note: If the phone number field and Call action do not appear for a module, check with your Sugar administrator. For more information on editing mobile layouts, please refer to the Studio documentation.

Text Messaging Records

If a record has a populated phone number field, you can tap the SMS option in the record's Actions menu to compose a text message to the phone number. When viewing a record's detail view, you can tap the SMS icon in the Actions menu. Please note that the SMS icon will be grayed out if the record's phone number field is not populated. Additionally, you can tap the phone number on the Details tab. Your device's messaging application will appear where you can complete and send the text.
Mobile DetailView SMS

From a list of records such as Global Search, list view, dashlets, or lists of related records, you can select the "SMS" action from the row's Actions menu as described in the Accessing Actions Menus From Lists section above.

Note: If the phone number field and SMS action do not appear for a module, check with your Sugar administrator. For more information on editing mobile layouts, please refer to the Studio documentation. 

Emailing Records

There are a few possible ways to start writing an email in the SugarCRM mobile app:

  • From Global Search or the Emails module, tap the three-dots menu in the top right corner and select "Compose Email".
  • On the detail view of a record with an email address, tap the Email icon in the Record Actions section.
  • Tap an email address field directly on the Details tab of any detail view.
  • On a list of records with email addresses (e.g., in list view, Global Search, dashlets, or subpanels), swipe to the left to reveal the Actions menu and choose the Email option.
  • From list view for a module with an email address, select several records and use the Mass Actions menu to compose an email to all of the selected recipients.
  • If your admin has configured an Action Button that allows you to compose an email on a record's detail view, tap that button.

If you have your preferred email client set to "Sugar Email Client" in your user profile in the desktop application, the mobile app will always open the Compose Email screen when you use one of the methods above. If you have the setting set to "External Email Client", the mobile app will open the default email app on your device instead.

If you wish to reply to or forward an existing email, you can do so using the Record Actions section of an email record's detail view:
ReplyForward

When you start writing an email using one of the above methods, the Compose Email screen will open with the recipient's email address and the specific record you are emailing, if any, populated in the Related To field on the email. If you are replying to or forwarding an email, the full email thread will be displayed in the email body when you tap to start editing it. See the Composing Emails section for details on working in this screen and how to draft and send emails in the mobile app.
Mobile DetailView Email

If the email field and Email action do not appear for a module, check with your Sugar administrator. For more information on editing mobile layouts, please refer to the Studio documentation.

Note: Email composing and sending is not available when your device is offline.

Mapping Records

Sugar records with an address can be mapped, allowing you to view them on a map and receive step-by-step directions to navigate to the address from your current location. If you are using Sugar Maps, all of these actions are performed directly within the SugarCRM mobile app. If you are using an external mapping application, the SugarCRM mobile app opens that app instead. See the following sections to understand how to work with maps depending on which configuration you are using:

If you have access to Sugar Maps, you can choose which mapping option you wish to use (i.e., Sugar Maps or an external app) in the Settings menu. If your instance is not configured to use Sugar Maps, this setting will not be displayed and you will always use your default mapping application.

There are several places within the app from which you can map a record:

  • From a list of records such as Global Search, list view, dashlets, or lists of related records, you can select the Map action from the row's Actions menu as described in the Accessing Actions Menus From Lists section.
  • From a record's detail view, you can use the Map icon to map the record, as described in the Accessing Actions Menus From Detail View section.
  • If you are using Sugar Maps, from list views, you can use Multiple Selection to select several records you wish to view on a map and choose the Map option in the Mass Actions Menu

Note: If the address fields and Map action do not appear for a module, check with your Sugar administrator. For more information on editing mobile layouts, please refer to the Studio documentation.

Sugar Maps

If your instance has Sugar Maps and it is set as your preferred navigation provider in the Settings menu, you can access its full suite of mapping capabilities within the mobile app, which includes the following:

You can receive step-by-step directions from your current location to a Sugar record by using the Map action from the Record Actions menu on list view or detail view. When you tap the action, the map is displayed:
FullPreview

Use the buttons in the top right corner to explore the map by changing the type of map view, focusing the map on your own location, and zooming in and out. You can also drag the view around to explore further and use a pinching motion to zoom in and out.

When you are ready to navigate to this record, tap "Route" in the bottom right corner. This opens a panel at the bottom with the step-by-step directions to navigate from your location to the record:
Navigate

Viewing Records on a Map

In addition to viewing a single record on a map using record actions as described above, you can also view multiple records on a map at the same time. To do this, open list view and press and hold a record to initiate multiple selection and select all of the records you wish to view on a map together. Once you have chosen the records, use the Map action from the Mass Actions menu (i.e., three-dots menu) in the top right corner to load a map showing pins for each of the selected records. Note that you cannot create a route between multiple records and can only view them on a map together, but you can tap a record on the map to create a route from your current location to that individual record.
Multiple

Finding Nearby Records

You can see records that are near the record you are viewing using the Maps subpanel in the Related tab on detail view. Open the subpanel to view the list of nearby records and build a filter to define the subset of records you wish to compare to and the radius to search.
SubpanelFilter

When the filter is applied, use the sort order field in the top right to sort by nearest or farthest first, and use the distance value displayed next to each record to see how far from the current record each result is.
SubpanelResults

Note that if no filter is applied, the list is filtered by default to all records within the current module within 250 miles of the target record.

Filtering List Views by Distance

To find records that are a certain distance from a specific location, use the Distance criteria when building a filter in list view. This specific criteria option is available for all records that can be mapped and allows you to provide a zip code and a radius from that zip code to filter by.
DistanceFilter

When applied, the list view will be filtered to records that are located within the specified radius of the provided zip code. You can also combine this with other filter criteria to further refine the results.

Geocoding Records

Records must be geocoded in order for Sugar Maps to know the coordinates of their physical location. This is done automatically by a scheduled job for most records, but there may be occasions where you need to manually geocode a record. To do so, select the Geocode option from the More Actions menu (i.e., three-dots menu) on detail view; you may also be prompted to geocode if you try to map a record that has not yet been geocoded. This opens a map with a search bar where you can type in an address to find the location of the record. Alternatively, you can simply tap a point on the map to choose that location. Tap "Save" in the top right corner to save the selected location as the geocoded pin for the record. After doing this, you can use Sugar Maps to map this record, but note that updating the geocoded pin does not change any address fields on the record. See the Sugar Maps documentation for more details on manually geocoding records.

External Mapping Applications

If your instance does not have Sugar Maps, performing any mapping action in the SugarCRM mobile app will always open your default external mapping application. If you have access to Sugar Maps but have chosen to use an external navigation provider in the Settings menu, performing a mapping action will first open a preview of the map within the SugarCRM mobile app. Tapping the Route link in the bottom right corner of the preview will open your selected mapping application. Note that if you have mapped multiple records, you will need to tap one on the map to route to it.
Route

If a record has a populated address field, you can tap the Map option in the record's Actions menu or the address itself in the Details tab. Please note that if your instance does not have Sugar Maps, the Map icon will be grayed out if the record's address field is not populated.

Both the Android and iOS apps can open addresses in Google Maps or Waze. Additionally, the iOS app can also open addresses in Apple Maps. If your instance does not have Sugar Maps and you have more than one of these apps installed, you will be asked which application to use when you select "Map".

To return to the SugarCRM mobile app, simply exit the mapping app then tap the SugarCRM cube icon again.

Sharing Records

Links to records can be sent to other users in your organization using the Share option from a record's detail view. The link will be sent via email, text message, or other method depending on your device's sharing options. From the desired record's detail view, tap the vertical ellipsis icon on the top right then select "Share" from the More Actions menu. 
Nomad2.7 Share Record

The recipient can simply click the link in the email, text, etc. to access the record in their Sugar account. If the recipient opens the link from their mobile device and they have the SugarCRM mobile app installed, they will have the option to view the record in the app.  Please note that the user must log in to Sugar to access the record. Users will only be able to view the shared record as allowed by their team membership, user access type, and assigned roles. For more information on teams and roles, please refer to the Team Management and Role Management documentation.

Exporting Records

Using the Mass Actions menu in any list view, you can export records to a CSV file that can be opened in a spreadsheet application. Simply select several records and choose the Export CSV mass action from the three-dots menu in the top right corner:
ExportCSV

You can also use the Select All option in the menu to select all records in the result set, but note that there is a maximum of 1000. To export more than 1000 records, use filters to group the records into smaller batches for export.

The field values that will be exported for each record are those that are currently visible in the mobile app's list view. These fields are configurable and can be changed per module using List View Builder, which you can access via the gear icon in the top right corner.

For more details on exporting Sugar records to CSV files and how to work with these files, see the Export documentation in the Application Guide.

Uploading Record Files

Users can easily upload image or file attachments (e.g., .pdf, .doc, .csv, .xls, .xml, .jpg, .png, .txt, video, audio) to records that have a File-type field (e.g., Attachments), such as notes. Once a file is uploaded, other users can download or view the attachment via the mobile app and the desktop application. If the file is an image, you can choose to resize it before saving; select a smaller size to reduce the quality of the image if you want to also reduce the upload time. See the Editing Image Fields section for more details on image resizing.

Note that it is only possible to attach more than one file to a note and to change the file name before uploading in Sugar versions 11.0 and higher.

Certain restrictions are applied to the upload of HEIC files:

  • The resolution must not exceed 4,096 x 4,096 px.
  • The file must have EXIF data present.

Note: If the Attachments field and File action do not appear for a module, check with your Sugar administrator. For more information on editing mobile layouts, please refer to the Studio documentation.

The following steps cover uploading two files to a note record as an example:

  1. Tap the verticle ellipsis Quick Create button at the top right of the Global Search page and select "Create Note".
    UploadFile1
  2. Once the edit view opens, tap the Attach link under the Attachments field.
    CreateNote
  3. Select one of the desired files from your device's list of available options (e.g., Google Drive, photo). Note that you cannot select multiple files at once to attach.
  4. If you wish to change the name of the file before uploading, press and hold the name of the file. A pop-up will appear allowing you to provide a new name if you are connected to a Sugar instance on version 11.0 or higher.
  5. Tap "Attach" again to select the second desired file. Optionally, you can resize the images before saving by tapping "File Size" and selecting a new size.
    MultipleNotes
  6. Tap "Save" to preserve the changes. Both files are now accessible via the File icon.

Note: File attachments from your computer are stored in the Notes module, so you must have permission to create notes to upload attachments. If you do not have permission to create notes, the ability to add attachments will be hidden. For more information on configuring roles in Sugar, refer to the Role Management documentation in the Administration Guide.

Viewing Record Files

When a record contains one or more images or file attachments, you can tap the File icon in the record's Actions menu to download the files. The File icon will be greyed out if the record's File-type field (e.g., Attachments) is not populated. It is important to note that if the admin has added an image field to the detail view, it is not displayed within the list of fields; instead, its image file is accessible via the File icon.

Note: If the Attachments field and File action do not appear for a module, check with your Sugar administrator. For more information on editing mobile layouts, please refer to the Studio documentation.

ViewingFile

If there is a single attachment, the file will immediately be downloaded. If there is more than one, a pop-up will appear listing the files. Tap a file to download it. Note that notes can only have more than one attachment on Sugar instances on version 11.0 and higher.

Once the download is complete, you will be able to view the file (e.g., .jpg, .gif, .doc, .pdf, video, audio) from within the mobile app. In addition, you can also share the file via email, text message, or other available options:

On Android, tap the Share option in the menu that appears.
Mobile5.1.0 Android ShareMenu

On iOS, tap your device's Share menu.
Mobile5.1.0 iOS ShareMenu1

Importing Files From Emails

When viewing image or file attachments from your device's email application (e.g., Mail, Gmail), you have the option to import the file (e.g., .xls, .xlsx, .htm, .html, .pptx, .pdf, .xml, .txt, .ods, .doc, .docx, .csv, .gif, .jpg, .svg, .png, .bmp, .mov, .zip) directly to the mobile app. On Android, simply select "SugarCRM" from your device's applicable menu (e.g., Open with). On iOS, select the "Import with SugarCRM" option in your device's Share menu to create a new note record including the file attachment.

If the file is an image, you can choose to resize it before saving; select a smaller size to reduce the quality of the image if you want to also reduce the upload time. See the Editing Image Fields section for more details on image resizing.

Importing in Android

Use the following steps to import a file attachment from the email application to the Notes module on an Android device:

  1. Tap the file (e.g., MyAttachment.pdf) in the email.
  2. Select "SugarCRM" from the "Open with" menu.
    Note: If asked to choose "Always" or "Just Once", select "Always" to set SugarCRM as the default app and bypass the menu going forward. Select "Just Once" if you wish to select an app each time via the "Open with" menu.
    ImportAndroid
    Note: For image-type files, tap the image then tap the vertical ellipsis on the upper right of the image viewer and select "Share". Select "SugarCRM" from the menu that appears asking you to choose which application to use to complete the action.
    ShareImageAndroid
  3. The mobile app will open and display the Create Note page. The file will automatically be attached to the note.
    CreateNote Attachment
  4. Fill in the appropriate fields then tap "Save" to create the record. 
    Note: All required fields will indicate "Required" and must be completed prior to saving.

Importing in iOS

Use the following steps to import a file attachment from the email application to the Notes module on an iOS device:

  1. Tap the file (e.g., filename.docx) in the email, then tap your device's Share menu.
    EmailFile ShareMenu2
  2. Next, select the "Import with SugarCRM" option in the menu.
    Note: To import image-type files for iOS 9, you will first select "Quick Look" in the Share menu, tap the Share icon on the following screen, then select "SugarCRM".
    ImportiOS
  3. The mobile app will open and display the Create Note page. The file will automatically be attached to the note.
    CreateNote Attachment
  4. Fill in the appropriate fields then tap "Save" to create the record.
    Note: All required fields will indicate "Required" and must be completed prior to saving.

Visiting Record Websites

If a record has a populated website field, you can tap the Web option in the record's Actions menu to open the site in your device's web browser. When viewing a record's detail view, you can tap the Web icon in the Actions menu. Please note that the Web icon will be grayed out if the record's Website field is not populated. Additionally, you can tap the Website field's value on the Details tab.
Action Web Nomad2.6

From a list of records such as Global Search, list view, dashlets, or lists of related records, you can select the "Web" action from the row's Actions menu as described in the Accessing Actions Menus From Lists section above.

To return to the SugarCRM mobile app, simply exit the browser then tap the SugarCRM cube icon again.

Note: If the Website field and Web action do not appear for a module, check with your Sugar administrator. For more information on editing mobile layouts, please refer to the Studio documentation.

Refreshing Pages

To refresh pages (e.g., list view, activity stream, global search) in the mobile app, simply place your finger on the middle of the page then drag the page down and release. This action will refresh the page to display the most current list of records, entries, results, etc. For detail view, you will need to navigate away from the record then return to the detail view to see and updates. 
Refresh

Working With Erased Fields

Depending on your organization's data privacy policies, there may be occasions when you need to immediately and permanently remove information from your Sugar instance. One example is fulfilling a request to erase an individual's personal information. Fields which have been designated as personal information in Admin > Studio can be erased via a data privacy record. For detailed information about data erasure in Sugar, please refer to the Data Privacy Guide.

Once a field (e.g., office phone, address) gets erased in a Sugar record (e.g., contact), "Value Erased" will be displayed in the mobile app as a placeholder where the value used to appear.
Mobile ErasedField

"Value Erased" will also appear in grey when editing erased fields although users have the ability to re-populate the erased field. However, the field should only be re-populated if the individual has provided their consent for your organization to use the information, or as specified by your organization's data privacy policy.

Conflict Resolution

As you make changes to records in the mobile app, changes may also be made to the same records by other users. This is especially likely when reconnecting to internet access after operating offline. When a field has a new value on both the instance and your mobile device, the following will occur:

Online Mode

The mobile app provides a message and choice:

  1. Discard the mobile app's changes and load the instance value.
  2. Load the instance copy and override fields you have changed with the mobile app's values.
Offline Mode The mobile app's new value for the field overrides the change stored in the instance. See the Understanding Conflict Resolution in Offline Mode section for a more detailed example of how this works.

Understanding Conflict Resolution in Offline Mode

While offline, if your changes to a record conflict with changes made to the record by someone else, the mobile app syncs the values at the field level, preserving any field values saved in the mobile app while offline over any changes that may have been made by someone online. It is important to note that this field-level conflict resolution only applies to offline mode. When online, conflicts are resolved as described in the table in the Conflict Resolution section, where you are presented with two options to resolve the conflicting data. The following is an example scenario where changes are made to multiple fields in the mobile app while offline while they are also changed by another user in the desktop application at the same time:

  1. The initial state of an account record has the following field values:
    Field Value
    Industry Apparel
    Office Phone (589) 685-0571
    Email Address phone92@example.net
  2. Sally is using the mobile app and goes offline with the above account data cached in her device.
  3. Chris edits the account while online in the desktop application. He changes the values to the following:
    Field Value
    Industry Banking
    Office Phone (094) 158-0575
    Email Address im45@example.tv
  4. After Chris has saved his changes, Sally, still offline, changes the Industry value to "Communications" but leaves the other fields the same. She does not yet see Chris's changes because she is offline, so she still sees the initial values of the other two fields. In the Sugar instance, Sally's change is not visible because the app cannot yet connect to the server.
  5. Soon after, Sally's device returns online and the mobile app starts to sync with the instance. The app identifies that Sally made a change to the Industry field and pushes only that field's value to the Sugar instance, overwriting Chris's value. The other two fields are updated on the mobile app to show the values Chris selected because Sally did not change these fields. In other words, only the field that Sally changed, the Industry field, was pushed to the server and overwrote Chris's entry. The final values in both the mobile and the desktop apps are as follows:
    Field Value
    Industry Communications
    Office Phone (094) 158-0575
    Email Address im45@example.tv

Administering the Mobile App

Sugar users with administrator access can configure the SugarCRM mobile app to suit their users' needs. In Admin > Mobile, you can configure which modules are available for use in the app. For more information on enabling modules for use in the application, refer to the System documentation. Administrators can also configure the mobile app's edit views and detail views for each module. For more information on configuring mobile layouts, refer to the Studio documentation.

Server Configuration Changes

After an administrator makes mobile app configuration changes in Admin > Mobile or Admin > Studio, your app will display the following alert:
Resync

Tap "OK" to sync your app's configuration with the server and resume working in the app.

Configuring and Deploying via MDM

Administrators can configure and distribute the SugarCRM mobile app using Mobile Device Management solutions. The following configurations are available to control via MDM:

Setting Key Default Description
Touch ID loginTouchId 1 (Enabled) Determine whether iOS users will have the option to log into the app using their fingerprint via iOS's Touch ID service.
Instance URL serverUrl   Pre-populate your instance's URL to prevent users having to manually enter this value.
Secure Connection useHttps 1 (Enabled) Pre-populate the secure connection checkbox during login. Configure this to "0" in order to disable SSL and allow VPN to be enabled.
Single Sign-On ssoOption 0 (Disabled) Pre-populate whether single sign-on is enabled during login.

Last modified: 2022-11-10 15:05:57