Sugar 11.3 (Q1 2022) Customization Guide

Rafael Fernandes — Mon, 04 Mar 2024 16:21:57 GMT

Current Revision posted to Dev Tutorials by Rafael Fernandes on 3/4/2024 4:21:57 PM

The purpose of this document is to provide insight to Sugar Developers for adapting custom Sugar code, extensions, and integrations to the Sugar 11.3 (Q1 2022) release. This guide provides an overview of some of the new features and identifies changes in Sugar 11.3 (Q1 2022) that could cause an immediate impact on Sugar customizations and integrations built for earlier Sugar versions.

Please check out the Q1 2022 Developer Webinar recording for more developer highlights. For Admin and End User release notes, please visit the Sugar 11.3.0 Release Notes.

User Experience Updates

Admin UI Redesign

We're introducing a new redesigned Admin landing page built on Sidecar. Sugar has kept compatibility as much as possible therefore, error messages shown on the admin page remain the same in terms of content and all the links are shown as per the role/license similar to the old admin landing page. (customers can still access the old BWC admin page via the old URL.)

Notable changes that require attention:

Admin icons are now 12px by 12px (before was 16x16, so please update your icons)
New Admin API endpoint to retrieve landing page definitions
New icons use SugarIcon library instead of gif files
Admin can search for link text/description on the admin landing page and see the results on a pop up.
HTML markups are not supported going forward (text strings should be plain or escaped now in Sidecar)

On upgrade customers would see the new landing page UI.

We encourage you to update your references from #bwc/index.php?module=Administration to #Administration

Dropdown-Conditional RV Layouts

This release we give you the ability to create dropdown-conditional Record Views and in 11.3, we want to create a Dropdown driven RV layout that displays different Record Views depending on the Type of Record. Therefore you'll be able to control conditional field availability and position with minimal effort as well as move fields to different positions based on which are more important for some records than others. You don't need to maintain and manage duplicate dependency formulas on individual fields.

These changes were applied to [module]>Layouts>Record View:

Updates made to fields that disappear after a DBV field is triggered will not be saved. We’ll only save values in fields that are still present in the UI. a Popup warning will appear when a user is editing the Record and then selects a Dropdown field that’s going to change the layout, to let the user know that the dropdown selected will change their view and they will lose some of their edits. If a user has no access to the selected Dropdown field, they will still see the layout view of the Record’s selected Dropdown.

On upgrade, we don’t touch users existing customizations.

Dark mode compatibility to filter divider rows

Filters and mass update row dividers have dark mode compatibility. We also improved the filter view by using a dynamic color variable “@ borderColor” when dark mode is enabled. Added to (List views, Search and select, Subpanel filters, List views dashlet configuration, Data archiver, Console config)

Node we added two css utility classes:

border-{side}-n where side is empty, t (top), b (bottom), l (left), r (right) and n is 0, 1, 2px
border-{style} where style is solid, dashed, dotted, double

wUtilities. Import into SugarCRM

We are bringing former wUtilities into Sugar in this release. You may want to check your code for conflicts (or became obsolete now that is part of the core). We're adding the following:

Clone - this item allows admin to copy some of a given user's setup such as their Default Teams, Favorite Reports, Navigation Bar Module Selection, and Scheduled Reports to another user or users in a particular team or role
Dashboards - allows to clone the already configured dashboards from particular modules to the particular user/teams/roles
Filters - allows to clone existing user’s filters to particular user/teams/roles
User settings - enables an option to set up different user-level preferences like Date format, Time zone, Preferred currency, etc., for a user/teams/roles

Border around Dashlets being removed

We have removed borders around dashlets in favor of box-shadows, specifically for Dashlets, we have added an extra shadow on over for header with exterior strokes.

Please check your dashlet customizations to comply with this change.

Introduce newly reusable UI components in Sugar

We are going to start looking at creating newly designed, more reusable components in Sugar. For start, we've added a new utility class that allows you to specify the background colou for a given component using only classes. Ex. bg-content-background will set background-color: var(--content-background).

There’s been added utility for border-radius: rounded-{size}. Right now, there are a few different sizes: rounded-none, rounded-sm, rounded, rounded-md, rounded-lg, rounded-xl, rounded-2xl , rounded-3xl, rounded-full.

Tasks card in the Timeline Dashlet

We've added tasks card for all the Timelines for Sugar App. For all the modules for which timeline is enabled, if tasks can be related as sub-panel to that module then the task card would show up on that timeline. Users would be able to filter the timeline based on Tasks. If you've customized that, make sure you review your code.

Improvements on Loading... message

We have made an improvement on this "Loading..." message when there was a javascript error it would just stay there, now when there is a persistent “Loading…” message that does not disappear, user can close the message by clicking an “X” at the top right.. Please check your customizations if you've made an improvement on this behavior.

Forecasting at the Opportunity Level

We introduced two new fields in the Opportunity Level, "Forecast" and "Forecast Likely". “Forecasted Likely” field in Opps adds up the Likely amount for RLIs that have their values set to an included Forecast range. This is available for users using Opps + RLIs. The field will only appear on Opps not related RLIs. Users will be able to filter and report on the new field.

If users have edit access to “Forecast” on edit or create, they will see the “Set Across Revenue Line Items” checkbox and when checked, we’ll cascade the Opps value down to the related eligible RLIs. Cascading does not work on closed RLIs.

Update date on the left for timeline cards for few modules

We are updating the date on the left for Timeline Cards to be same as the date which is used for sort order i.e. Start Date for the following cards for Timeline dashlet. Our default behavior prior to this release was to sort based on the start date but display the create date on the left. Also added tooltips as the field name for the Start Date on the left of the cards for Calls, Meetings and Messages cards in order to make it more clear for the user. Please check your customizations if you've made an improvement on this behavior

Sugar REST API updates

This Sugar release introduces REST v11_15.

Admin Landing page definitions

You can now get admin definitions metadata (used by Admin Landing page Sidecar). This endpoint is only available to administrators and developers with access to any module.

GET <sugar instance>/rest/v11_15/Administration/adminPanelDefs

* Important to note that this endpoint returns two icons definition (icon and customIcon)

icon refers to SugarIcon library (either customized/replaced or a default icon)
customIcon is the legacy icon defined in the admin extension

Admin Landing page Errors

You can now get current system errors or warnings available on Admin landing (used by Admin Landing page Sidecar). This endpoint is only available to administrators and developers with access to any module.

GET <sugar instance>/rest/v11_15/Administration/errors

PHP Library Upgrades

Adding vanderlee/php-stable-sort-functions

We are adding back this library as it was mistakenly removed instead of deprecated.

It is not used by our core platform therefore is deprecated and will be removed for good soon.

JS Library Upgrades

Update Sidecar's NodeJS to 10

In this release, we are upgrading our Sidecar core code to be compatible with Node >=10.24.1 and NPM >=6.14.12.

There's minimum impact for developers, you might need to upgrade your versions to run some of the unit tests that rely on this versions.

Configurability updates

Sugar Logic

Work in progress.

Sugar Catalog Server

Work in progress.

SugarBPM

Work in progress.

Studio

Work in progress

Sugar Config Settings

Setting Name

Default

Override Example

Description

proxy_visible

true (non cloud)

false (cloud)

$sugar_config['proxy_visible'] = false;

Determines whether the Proxy Settings panel is visible to administrators in Admin > System Settings. Instances running on Sugar's cloud environment will have this setting enforced as false.

developer_mode_visible

true (non cloud)

false (cloud)

$sugar_config['developer_mode_visible'] = false;

Determines whether the Developer Mode flag is visible to administrators in Admin > System Settings. Instances running on Sugar's cloud environment will have this setting enforced as false.

Removed Features

Changes on our Legacy SOAP API

In this release we are updating our SOAP API to be WS-I 1.0 Compliant, therefore when accessing the soap entry point, you will be provided with rpc/encoded formatting.

You may change the encoded by literal if need be, however, we are not serving document style anymore, therefore valid options are:

https://{sugar_url)/service/v4_1/soap.php?wsdl
http:s//{sugar_url)/service/v2/soap.php?wsdl
https://{sugar_url)/service/v4_1/soap.php?wsdl&style=rpc&use=encoded
https://{sugar_url)/service/v4_1/soap.php?wsdl&style=rpc&use=literal
https://{sugar_url)/service/v2/soap.php?wsdl&style=rpc&use=literal
https://{sugar_url)/service/v2/soap.php?wsdl&style=rpc&use=encoded

Data Changes

Fixed attachment_flag is set to 1 for legacy note records

We've fixed this issue when a Note has an attachment and when you open the related Opportunity, the Note record does not appear in the Notes subpanel. The workaround was to update the attachment_flag field from 1 to 0 via an SQL query. This change will be reverted if a user edit/save the Note. Now it's fixed, so if you've customized/workaround it, please review your code.

Data Archiving process on the pmse_BpmFlow table

We no longer allow archiving directly on the pmse_bpmFlow table since this is not an exposed table in Sugar. Now the user can only see the pmse_Inbox table in the list of modules to archive dropdown.

Tre are several options on which to filter on for this table, however, the system requires that the user select ‘Process status’ as one of the filter options for this to be a valid data archiver.

When an archival process is run on the pmse_Inbox table, the entry from that table will be archived as well as all entries in pmse_BpmFlow and pmse_BpmThread that have the matching ‘cas_id’ related to that process

Filesystem Changes

Ex. Changes to Sugar filesystem structure.

Platform Updates

List View & Subpanel-Store Columns, Order, and Sort in the DB

In this release, we are storing users' List View and Sub-panel organization into the database not the browser so they can access it from anywhere and don’t have to worry about losing everything after clearing their browser. User can drag and drop their columns, change the order and widths, on LV, Subpanels, Filters, and everywhere they can change layout configs. Please check your customizations if you've implemented similar functionality.

Respect Product Categories' "Order" field in the PC dashlet

We have implemented ordering in the PC dashlet respecting the Order field, now you can choose which products show up first.

Check your customizations and/or naming If you've used the workaround (append numbers or letters) so it would order alphabetically.

Sidecar now provides an easy way to Check for License and user state

In this release, we are providing helper methods in Sidecar to check for various licenses and user states that can be used to determine if we should enable some functionality.

hasSellLicense()
- checks if user has a Sell license
hasServeLicense()
- checks if user has a Serve license
hasSellServeLicense(hasBoth = false)
- if hasBoth is false, returns true if user has either Sell or Serve license
- If hasBoth is true, returns true if user has Both Sell AND Serve licenses
hasLicense(licenseType<string | string[]>, hasAll = false)
- allows a single license type string or an array of strings license types to be passed in
- If hasAll is false, returns true if user matches any license types
- If hasAll is true, returns true is user matches ALL license types
isSetupCompleted()
- checks that the user has already accepted the Cookie Consent & that the user has already been through the User Setup Wizard
- essentially covers the cases where we check:
- app.user.get('cookie_consent') && !app.user.get('show_wizard')

New and Improved Charts!

In this release we have selected ChartJS our core charting engine which brings easier to use, faster and responsive charting experience. With this update you have:

Default engine is now chartjs
New implementation of JSChart that uses chartjs
New implementation of sugarcharts.js that uses the SUGAR.charts namespace
Added 2 new Chart Types: TreeMap and Donut

We have updated our report viewer with ChartJS which means that all Reports generated and rendered from the Reports module will render using ChartJS.

CSP - Content Security Policy UI

We've added the ability for admins to go to a new section “Content Security Policy Settings” and configured Trusted Domains for their instance.

We got 2 tabs now for this settings with the following attributes:

Basic
- Trusted Domains ('default-src')
- Trusted Parent Domains ('frame-ancestors’)
Advanced
- connect-src
- font-src
- form-action
- frame-src
- script-src
- style-src

Improvements on BWC modules loaded via an iframe

In this release we have made more improvements when loading BWC modules via iFrame. Specifically for authentication to work we have updated our cookies to set SameSite=None as well as setting of the secure flag, so such cookies will be served only by HTTPS.

Adding CSV in Scheduled Reports

In this release we have enabled a new option for users to select the report type which they wish to send via the report schedular. Before this release only PDF versions of reports were sent for scheduled reports. Now users would be able to select the option if they want to send the PDF, CSV or Both. Default option is PDF as that is the current behaviour. If the user selects the PDF option then only PDF version is sent. If the user selects the CSV option then only CSV version is sent. If the user selects the Both option then both PDF and CSV versions are sent as separate files (i.e. no zip file).

Font- change from Open Sans to Inter

Sugar is changing the base font in the application from Open Sans to Inter. This change doesn’t require backwards compatibility with Open Sans. Please check your customizations and make sure they still have the UX experience they had with the previous font. Those font files are planned to be removed in v12.2

Administration Links

As part of our efforts to support cross browsers, we are updating the way we navigate routes.

Links need to be wrapped in javascript:void() (true for FF), e.g:

from javascript:parent.SUGAR.App.router.navigate("ContractTypes", {trigger: true});
to javascript:void(parent.SUGAR.App.router.navigate("ContractTypes", {trigger: true}));

void returns undefined after executing the expression and undefined tells the browser to stay on the same page on navigation.

Deprecated functions

Sucrose and NVD3 Deprecated

As we move towards making ChartJS our official charting engine, we are deprecating Sucrose and NVD3 charting engines.

Open Sans Font files deprecated

Those font and related files are planned to be removed in v12.2

Tags: Sugar Q1 2022, Sugar 11.3

Sugar 11.3 (Q1 2022) Customization Guide

Rafael Fernandes — Mon, 10 Jul 2023 12:54:29 GMT

Revision 2 posted to Dev Tutorials by Rafael Fernandes on 7/10/2023 12:54:29 PM

Please check out the Q1 2022 Developer Webinar recording for more developer highlights. For Admin and End User release notes, please visit the Sugar 11.3.0 Release Notes.

User Experience Updates

Admin UI Redesign

Notable changes that require attention:

Admin icons are now 12px by 12px (before was 16x16, so please update your icons)
New Admin API endpoint to retrieve landing page definitions
New icons use SugarIcon library instead of gif files
Admin can search for link text/description on the admin landing page and see the results on a pop up.
HTML markups are not supported going forward (text strings should be plain or escaped now in Sidecar)

On upgrade customers would see the new landing page UI.

We encourage you to update your references from #bwc/index.php?module=Administration to #Administration

Dropdown-Conditional RV Layouts

These changes were applied to [module]>Layouts>Record View:

On upgrade, we don’t touch users existing customizations.

Dark mode compatibility to filter divider rows

Node we added two css utility classes:

border-{side}-n where side is empty, t (top), b (bottom), l (left), r (right) and n is 0, 1, 2px
border-{style} where style is solid, dashed, dotted, double

wUtilities. Import into SugarCRM

We are bringing former wUtilities into Sugar in this release. You may want to check your code for conflicts (or became obsolete now that is part of the core). We're adding the following:

Clone - this item allows admin to copy some of a given user's setup such as their Default Teams, Favorite Reports, Navigation Bar Module Selection, and Scheduled Reports to another user or users in a particular team or role
Dashboards - allows to clone the already configured dashboards from particular modules to the particular user/teams/roles
Filters - allows to clone existing user’s filters to particular user/teams/roles
User settings - enables an option to set up different user-level preferences like Date format, Time zone, Preferred currency, etc., for a user/teams/roles

Border around Dashlets being removed

We have removed borders around dashlets in favor of box-shadows, specifically for Dashlets, we have added an extra shadow on over for header with exterior strokes.

Please check your dashlet customizations to comply with this change.

Introduce newly reusable UI components in Sugar

Tasks card in the Timeline Dashlet

Improvements on Loading... message

Forecasting at the Opportunity Level

Update date on the left for timeline cards for few modules

Sugar REST API updates

This Sugar release introduces REST v11_15.

Admin Landing page definitions

You can now get admin definitions metadata (used by Admin Landing page Sidecar). This endpoint is only available to administrators and developers with access to any module.

GET <sugar instance>/rest/v11_15/Administration/adminPanelDefs

* Important to note that this endpoint returns two icons definition (icon and customIcon)

icon refers to SugarIcon library (either customized/replaced or a default icon)
customIcon is the legacy icon defined in the admin extension

Admin Landing page Errors

GET <sugar instance>/rest/v11_15/Administration/errors

PHP Library Upgrades

Adding vanderlee/php-stable-sort-functions

We are adding back this library as it was mistakenly removed instead of deprecated.

It is not used by our core platform therefore is deprecated and will be removed for good soon.

JS Library Upgrades

Update Sidecar's NodeJS to 10

In this release, we are upgrading our Sidecar core code to be compatible with Node >=10.24.1 and NPM >=6.14.12.

There's minimum impact for developers, you might need to upgrade your versions to run some of the unit tests that rely on this versions.

Configurability updates

Sugar Logic

Work in progress.

Sugar Catalog Server

Work in progress.

SugarBPM

Work in progress.

Studio

Work in progress

Sugar Config Settings

Setting Name

Default

Override Example

Description

proxy_visible

true (non cloud)

false (cloud)

$sugar_config['proxy_visible'] = false;

Determines whether the Proxy Settings panel is visible to administrators in Admin > System Settings. Instances running on Sugar's cloud environment will have this setting enforced as false.

developer_mode_visible

true (non cloud)

false (cloud)

$sugar_config['developer_mode_visible'] = false;

Determines whether the Developer Mode flag is visible to administrators in Admin > System Settings. Instances running on Sugar's cloud environment will have this setting enforced as false.

Removed Features

Changes on our Legacy SOAP API

In this release we are updating our SOAP API to be WS-I 1.0 Compliant, therefore when accessing the soap entry point, you will be provided with rpc/encoded formatting.

You may change the encoded by literal if need be, however, we are not serving document style anymore, therefore valid options are:

https://{sugar_url)/service/v4_1/soap.php?wsdl
http:s//{sugar_url)/service/v2/soap.php?wsdl
https://{sugar_url)/service/v4_1/soap.php?wsdl&style=rpc&use=encoded
https://{sugar_url)/service/v4_1/soap.php?wsdl&style=rpc&use=literal
https://{sugar_url)/service/v2/soap.php?wsdl&style=rpc&use=literal
https://{sugar_url)/service/v2/soap.php?wsdl&style=rpc&use=encoded

Data Changes

Fixed attachment_flag is set to 1 for legacy note records

Data Archiving process on the pmse_BpmFlow table

We no longer allow archiving directly on the pmse_bpmFlow table since this is not an exposed table in Sugar. Now the user can only see the pmse_Inbox table in the list of modules to archive dropdown.

Tre are several options on which to filter on for this table, however, the system requires that the user select ‘Process status’ as one of the filter options for this to be a valid data archiver.

Filesystem Changes

Ex. Changes to Sugar filesystem structure.

Platform Updates

List View & Subpanel-Store Columns, Order, and Sort in the DB

Respect Product Categories' "Order" field in the PC dashlet

We have implemented ordering in the PC dashlet respecting the Order field, now you can choose which products show up first.

Check your customizations and/or naming If you've used the workaround (append numbers or letters) so it would order alphabetically.

Sidecar now provides an easy way to Check for License and user state

In this release, we are providing helper methods in Sidecar to check for various licenses and user states that can be used to determine if we should enable some functionality.

hasSellLicense()
- checks if user has a Sell license
hasServeLicense()
- checks if user has a Serve license
hasSellServeLicense(hasBoth = false)
- if hasBoth is false, returns true if user has either Sell or Serve license
- If hasBoth is true, returns true if user has Both Sell AND Serve licenses
hasLicense(licenseType<string | string[]>, hasAll = false)
- allows a single license type string or an array of strings license types to be passed in
- If hasAll is false, returns true if user matches any license types
- If hasAll is true, returns true is user matches ALL license types
isSetupCompleted()
- checks that the user has already accepted the Cookie Consent & that the user has already been through the User Setup Wizard
- essentially covers the cases where we check:
- app.user.get('cookie_consent') && !app.user.get('show_wizard')

New and Improved Charts!

In this release we have selected ChartJS our core charting engine which brings easier to use, faster and responsive charting experience. With this update you have:

Default engine is now chartjs
New implementation of JSChart that uses chartjs
New implementation of sugarcharts.js that uses the SUGAR.charts namespace
Added 2 new Chart Types: TreeMap and Donut

We have updated our report viewer with ChartJS which means that all Reports generated and rendered from the Reports module will render using ChartJS.

CSP - Content Security Policy UI

We've added the ability for admins to go to a new section “Content Security Policy Settings” and configured Trusted Domains for their instance.

We got 2 tabs now for this settings with the following attributes:

Basic
- Trusted Domains ('default-src')
- Trusted Parent Domains ('frame-ancestors’)
Advanced
- connect-src
- font-src
- form-action
- frame-src
- script-src
- style-src

Improvements on BWC modules loaded via an iframe

Adding CSV in Scheduled Reports

Font- change from Open Sans to Inter

Administration Links

As part of our efforts to support cross browsers, we are updating the way we navigate routes.

Links need to be wrapped in javascript:void() (true for FF), e.g:

from javascript:parent.SUGAR.App.router.navigate("ContractTypes", {trigger: true});
to javascript:void(parent.SUGAR.App.router.navigate("ContractTypes", {trigger: true}));

void returns undefined after executing the expression and undefined tells the browser to stay on the same page on navigation.

Deprecated functions

Sucrose and NVD3 Deprecated

As we move towards making ChartJS our official charting engine, we are deprecating Sucrose and NVD3 charting engines.

Open Sans Font files deprecated

Those font and related files are planned to be removed in v12.2

Tags: Sugar Q1 2022, Sugar 11.3

Sugar 11.3 (Q1 2022) Customization Guide

Rafael Fernandes — Mon, 10 Jan 2022 15:04:23 GMT

Revision 1 posted to Dev Tutorials by Rafael Fernandes on 1/10/2022 3:04:23 PM

Please check out the Q1 2022 Developer Webinar recording for more developer highlights. For Admin and End User release notes, please visit the Sugar 11.3.0 Release Notes.

User Experience Updates

Support for Dark Mode

Dark mode is now available in Sugar. Users have the ability to choose their theme preference by going to their user settings and selecting Use System Settings, Light, or Dark mode in the “Appearance” field. On upgrade, user instances will default to Use System Settings, which will follow the mode the user has selected in their operating system. Sugar Admins can also provide dark and light themed logos under the System Settings panel.

If you have Sugar UI customizations then you should test how they appear in dark mode to ensure acceptable color contrasts and that images display properly. In particular for images, you may need to provide alternative image files for light vs. dark mode. Here's some tips for working with images.

Double click to inline edit list

If a user had edit permission, then double clicking on a record in a list will now toggle edit mode. If you've customized a list view to support double click actions, you should test that this change is not conflicting.

New SugarIcon documentation in Styleguide

SugarIcon documentation has been added to the Styleguide. Developers should be able to reference the list of supported icons and usage instructions under Admin > Styleguide > Base CSS > Icons.

Save & Validation for Opps to RLI Cascade During Create

When editing an opportunity, Sugar validates and will not allow users to check the cascade boxes if they have no eligible RLIs. During create, Sugar allows users to check the boxes and put in values when there are no eligible RLIs to prevent them having to add all their RLIs before being able to input info at the opportunity header level. A validation has been added to warn them if they end up not adding eligible RLIs.

SugarPredict icons on Opps and Leads prediction fields

Sugar Sell now presents SugarPredict icons onto prediction fields. This icon is present in all views: list view, record view, list view dashlet, record view dashlet (including single-record tabs and list tabs), preview, and subpanels. Sugar uses SugarIcon font in @purple and its name is “@sicon-sugar-predict”. Those icons are present in all list views, record view

Create custom Focus Drawer dashboards

Users can create and switch between custom focus drawers depending on team or module access per Team/Module. Dashboard owners can pin to top, create, duplicate, delete, and add a dashlet from the FAB menu. Non-owners can pin to top, create and duplicate dashboard from the FAB menu.

Product Catalog Record View update in Dashlet

Admins can control what fields appear on the top drawer when viewing a product catalog item by clicking the icon in the PC dashlets, therefore now the drawer that opens to let users view a catalog item from those dashlets respect the Product Catalog record view layout. Before, it was its own layout that wasn’t configurable.

Show only Active items in Product Catalog dashlets

The Product Catalog and Product Catalog Quick Picks dashlet allow the users to easily access and instantly add line items in Quote’s Worksheet and Opportunities respectively, which is great for quick access. Now they will only display catalog items with an “Active” status beneath them. Categories with items that are all in “Inactive” Status, will be hidden.

Show Escalated field on various views

Sugar will indicate via Escalated field/badge in various views (record view, list view, record view dashlet, preview view and list view dashlet) for any module that escalation is enabled.

Remove attachments from Notes list view

Sugar is removing attachments from the Notes list view, only parent Notes would now show up and not the child attachments on the notes list.

Added filter on timeline dashlet

Sugar has added a filter in the timeline dashlet as well as sub-panels. Now users can use this filter to easily get to the list of interactions or updates that they are looking for.

Changes to the Product Catalog Record View layout via Studio

Before this release, changes to the Product Catalog Record View layout via Studio did not show up when viewing records from the Product Catalog Dashlet. Admins can now control what fields appear on the top drawer when viewing a product catalog item by clicking the icon in the PC dashlets.

Sugar REST API updates

This Sugar release introduces REST v11_14.

SOAP get_module_fields method is broken after upgrade to 11.1.0

The get_module_fields SOAP method has been fixed in this release and now returns the SOAP envelope as expected.

Module Loader installation progress API

This API is not designed for multi user or parallel usage and works exclusively for a single admin user. In case when a module is not currently installing the API will return the empty or the previous installation results for a given package. Thus using the API not during installation is useless.

PHP Library Upgrades

Smarty

Sugar utilizes a PHP library called Smarty for rendering PDFs in PDF Manager and also for rendering HTML pages used by Backwards Compatibility (BWC) modules. In Sugar 11.2 (Q4 2021), we will be upgrading that library from v2.6.11 to the latest version v3.1.35. There have been significant changes from Smarty 2.x to 3.x and because it is a major version upgrade there are some potential for breaking changes. The upgrade process will scan and identify incompatibilities and attempt to fix those Smarty templates. If it identifies an incompatibility that it can not automatically update then the upgrade will not proceed. See the dev blog for more details.

Symfony Components

Symfony is a leading PHP framework that provides a set of common components. For example, the Symfony Security Component is used by Sugar for input validation. We've updated these libraries to latest patch versions and removed some transitive dependencies.

symfony/cache 3.4.16 → 3.4.47
symfony/console 3.4.16 → 3.4.47
symfony/framework-bundle 3.4.16 → 3.4.47
symfony/security-core 3.4.16 → 3.4.47
symfony/security-csrf 3.4.16 → 3.4.47
symfony/translation 3.4.16 → 3.4.47
symfony/validator 3.4.31 → 3.4.47
symfony/process 3.4.11 → 3.4.47
symfony/http-kernel N/A → 3.4.47

Wikimedia Less.php

Wikimedia Less.php is a LESS compiler library written in PHP that has been upgraded to the latest available version in this release. This update is compatible with latest PHP versions. Check out the CHANGELOG for details.

wikimedia/less.php 1.8.2 → v3.1.0

Google PHP Client

Google API Client library enables Sugar to work with Google APIs such as Gmail, Drive or YouTube. There are major internal changes in this library, if you use them, please refer to this library’s upgrade procedure here.

google/apiclient 1.1.4 → 2.9.2

Microsoft Graph SDK

Microsoft Graph SDK for PHP provides Sugar with a framework for retrieving data from a Microsoft account using the Microsoft Graph API via OAuth2 tokens. There are no known breaking changes in this upgrade, they are mostly newly generated modes and PHP version support.

microsoftgraph/msgraph-sdk-php 1.13.0 → 1.33.0

PhpMailer

PhpMailer provides Sugar with a full featured email transfer class for PHP. All breaking changes are documented in the CHANGELOG.

phpmailer/phpmailer v5.2.22 → v6.5.0

AWS SDK PHP

The PHP library that Sugar uses for interacting with AWS web services has been upgraded. Check out the CHANGELOG for more details.

aws/aws-sdk-php 3.55.3 → 3.183.13

The following packages were upgraded as transitive dependencies.

guzzlehttp/promises 1.3.1 → 1.4.1
guzzlehttp/psr7 1.6.1 → 1.8.2
mtdowling/jmespath.php 2.5.0 → 2.6.0
symfony/polyfill-mbstring 1.15.0 → 1.23.0

Doctrine DBAL

Doctrine DBAL provides Sugar with a powerful database abstraction layer with many features for database schema introspection, schema management and PDO abstraction. There are no breaking changes that may affect Sugar and has most of the deprecations documented in the form @deprecated annotations or in the form of runtime deprecations (disabled by default, see https://github.com/doctrine/deprecations and https://github.com/doctrine/dbal/blob/2.13.x/UPGRADE.md). There is a new SugarConfig option that provides additional logging for the use of deprecated Doctrine functions.

doctrine/dbal 2.12.1 → 2.13.2

JS Library Upgrades

jQuery and Underscore

A couple of core Sidecar JS libraries have been upgraded to latest available versions in this release. Underscore and jQuery are two heavily used libraries in Sugar customizations. There are no known breaking changes in these upgrades, they are minor or patch version bumps. The jQuery version upgrade just includes bug fixes. The Underscore library upgrade adds some new helpers and bug fixes..

jQuery 3.5.1 → 3.6.0
jQuery Migrate 3.3.1 → 3.3.2
Underscore 1.9.1 → 1.13.1

Amazon Connect Libraries

The Amazon Connect Streams and Amazon Connect Chat JS library (ChatJS) are core SugarLive libraries. There are no known breaking changes in these upgrades which include bug fixes and enhancements.

amazon-connect/amazon-connect-streams 1.4.9 → 1.6.9
amazon-connect/amazon-connect-chatjs 1.0.6 → 1.0.8

big.js

big.js provides Sugar with a small, fast JavaScript library for arbitrary-precision decimal arithmetic. All breaking changes are documented in the CHANGELOG.

big.js 3.1.3 → 6.1.1

Configurability updates

Sugar Logic

Sugar Catalog Server

When creating a new instance of 11.2.0 and above, Sugar catalog server is enabled and set to the catalog url of `https://appcatalog.service.sugarcrm.com` irrespective of the instances' regions. This story is to change that catalog url to be region specific url based on instances' regions .

In 10.3 we added an upgrade script for IDM-only instances to set System Settings' catalog_enabled flag to true and set the catalog_url to the region-specific Catalog URL for the instance’s region. Here we added that same functionality to the Install process so new instances being added to the Cloud will have the same config settings set.

SugarBPM

Call sentiment fields are now displayed and evaluated as Positive, Neutral, or Negative instead of a decimal value.

Studio

Sugar Config Settings

Setting Name	Default	Available values	Description
dbal_deprecation_log	false	true, false	Enable NOTICE level log entries of API calls to deprecated Doctrine DBAL functions.

Removed Features

Removal of `facebook-php-sdk`

The Facebook-php-sdk (facebookarchive/facebook-php-sdk) is stored at ./include/externalAPI/Facebook/FacebookLib.php. The API that uses this SDK is not used in Sugar since 2014 and not compatible with current Facebook APIs, therefore it has been removed in this release.

Remove support of MD5 hashing for authentication purposes

Since md5 hashes for authentication is no longer supported and forgot password feature successfully updates user_hash in the database. After the upgrade to SugarCRM 11.2 config option $sugar_config['passwordHash']['allowLegacy'] will have no effect.

Data Changes

Added Active Status field in Product Catalog

A new active_status field has been added to Product Catalog module. It is a drop-down field with 3 default options: Active, Inactive, Retired. This identifies if the product is actively available for sale, temporarily unavailable and therefore inactive, or retired when the organization no longer sells this product.

Added "processed" to list of reserved field names

In this release, Sugar is now reserving the “processed” field name in addition to other reserved field names like "id" and "parent_name". This was necessary to prevent issues with logic hook handling. If your Sugar instance uses the “processed” field name, then you will have to change to use a different field using an un-reserved field name.

Product Catalog Status field using Search and Select

A new attribute has been added to the vardefs for modules. Devs can now make a code change (nothing you can do in studio) to add a default_relate_filter to a module. This allows devs to set an initial filter when going to Search & Select per module.

When populating Product Catalog Relate fields using Search and Select, default a visible filter for “Status is Active” that can be changed by the user to access items that are in different statuses, including inactive.

Note: The only way a user can access an inactive product catalog item, is by using Search and Select.

e.g When creating an RLI with an item that’s inactive, the user has to select Search and Select and kill the default “Status is Active” filter.

Filesystem Changes

Ex. Changes to Sugar filesystem structure.

Platform Updates

Documents and Document Merges (formerly known as WDocs)

We added formerly known WDocs to Core Sugar. A common need among Sugar users is the ability to create letters, contracts, proposals, etc. Documents can be used to quickly create Microsoft Word templates that can be used to merge information from any module in Sugar.

Documents is available for Sell and Serve only. We created Documents Template, a new module where users can store and edit their Document Templates that will be used for document merges. This is different from the original WDocs where templates lived in the Documents module. Documents Template can be configured via studio, but it’s a special module in that it can’t be used to create relationships with other modules that would result in displaying Documents Templates as a subpanel in other modules.

In addition to the Documents Template module, another module called Document Merges was created. Document Merges is backend module that is not visible in studio to any user. This module keeps information on the current merges and it is used as the primary point of data exchange with the documents microservice and repository for merge status and logs. Document Merges data is served through the Documents widget, which is visible in the bottom right hand corner of a user’s Sugar instance.

We added “Merge to Doc” and “Merge to PDF” to these different layouts: Record View, List View, and Subpanel Action menus. Selecting Merge template results in a MS Word doc and selecting Merge template to PDF results in a PDF document. Merge template and Merge template to PDF will also appear in the newly added “Action Buttons” for easier access

Calendar (formerly known as wCalendar)

Calendar, formerly known as wCalendar is a customizable calendar solution that displays a Sugar module on a calendar. One of main things to highlight is the calendar can be used with any SugarCRM module, including future custom ones deployed by users. In addition to viewing calendar in Sugar, users can embed calendars in Records and dashlets. This new Calendar will replace the default SugarCRM calendar page. This new Calendar Center’s UI will be rendered by a 3rd party Kendo Scheduler widget. The third party’s source code will be added to Sugar’s vendor library to make this work.

Users can publish or export their calendar using the Calendar Export option to export their Calendar as an ICS file or choose the Calendar Publish option and paste the URL in their email client. Users can also export their calendar as a PDF file for viewing offline

Created a new custom UI for the CAlendar’s module. Email Templates in the Calendar are going to resemble the Process Email Templates pattern in the fields. Under Settings, in filter, we used the default Sugar filter.
This allows users to filter the events to show for a specific Calendar definition Record and weeds out the unrelated ones. The modules that appear in the filter are dynamically generated to only show ones that contain data.

Note: unlike wCalendar, this calendar will not support various themes and will only be available in the main Calendar Center, not in LVs and Subpanels.

Smarty - Health check routes the upgrade process

New functionality in 11.2 Upgrader Healthcheck, which scans for Smarty customizations that have a syntax that will break with 11.2 upgrade (Smarty 3). When Healthcheck identifies any such instances, it outputs a Bucket F error and upgrade is not able to proceed as well as outputs the specific .tpl file in the Bucket F error.

Smarty Upgrader Script - Upgrader tool to automatically update known syntax issues of customer instances

This script also attempts to programmatically update custom .tpl files to avoid conflicts between Smarty version 2 and version 3.1.34. The script includes output about the successes and failures in these conversions.

Note that this script will be included as part of 11.2 upgrade.The script should find all the .tpl files inside the target directory and convert their syntax to be compatible with Smarty3.

Allow upgrades with version 4.6+ to be installed for RT SalesMap

Healthcheck now allow list containing RT SalesMap v4.6+. Module vendors should be consistent with versioning schema being used for a module. The recommended one is Semver Semantic Versioning 2.0.0, may be prefixed with v letter, e.g. 3.14.15, v0.2.0. If a module already uses different schema - stick with existing one to keep consistency.

Prune tracker table scheduler frequency and configuration policy

Tracker Pruner job scheduler is changed to be executed every day instead of once a month.

Triple curly braces

SugarFields has triple curly braces in templates, like { {{$var… which will be compiled into another template with { $var… but new Smarty doesn’t support spaces between the curly brace and dollar sign.

replace:

{ {{sugarvar  key='options' string=true}}[{{sugarvar key='value' string=true}}]}

with:

{assign var="field_options" value={{sugarvar key='options' string="true"}} }
{assign var="field_val" value={{sugarvar key='value' string="true"}} }
{$field_options[$field_val]}

Sugar Portal update to utilize Content Security Protocol

As of 11.2.0, Ent/Sell/Serve will no longer ship with an index.html file and will instead ship with, and use, index.php so that the portal can leverage the content security policy (CSP) that is inherent to the security of the Sugar platform.

Clickjacking prevention with Content-Security-Policy improvements

To prevent Clickjacking attacks SugarCRM uses Content-Security-Policy that was introduced in 11.0 System - SugarCRM Support Site . SugarCRM utilizes frame-ancestors directive to specify valid parents that may embed a page using <frame>, <iframe>, <object>, <embed>, or <applet>. OOTB frame-ancestors directive is set to 'self' and can’t be overwritten in the Admin panel at the moment.

Deprecated functions

Deprecated use of FontAwesome

Sugar has added a HealthCheck Scanner to search for “fa-*” customizations and notify Admins that they need to fix their code by the release where FontAwesome will be removed. The message is: “FontAwesome is deprecated as of 11.2 and will not be supported in 12.0. Use of FontAwesome detected in: `%s`.”

PHP stable sort deprecation

PHP stable sort functions library (vanderlee/php-stable-sort-functions) provides stable sort utility methods and standalone functions. This library is not currently in use by Sugar so it is being deprecated in this version and soon to be removed. But we did update it to latest patch release (v2.0.5) with no expected breaking changes.

Doctrine DBAL deprecation warnings

In the future, Sugar will move to Doctrine DBAL 3.x which removes some deprecated functionality. In order to find and upgrade the usage of this functionality, you should enable runtime logging of calls to deprecated Doctrine DBAL functions.

$sugar_config['dbal_deprecation_log'] = true; // enable log

$sugar_config['logger']['level'] = 'info'; // set appropriate logging level

Backtrace can be attached to log entries in order to locate the exact source code lines that need to be changed.

$sugar_config['logger']['channels']['deprecation']['processors'] = 'backtrace';

Deprecate API Endpoints for 'aws’ 'csp'

Sugar has deprecated those endpoints that will be refactored and available in different endpoints in future releases:

GET /Administration/aws - getAWSConfig - Gets configuration settings for Amazon Web Services integrations 
POST /Administration/aws - setAWSConfig - Sets configuration settings for Amazon Web Services integrations 
POST /Administration/csp - setCSPConfig - Sets configuration settings for Content Security Policy 
GET /Administration/csp - getCSPSConfig - Gets configuration settings for Content Security Policy

Tags: Sugar Q1 2022, Sugar 11.3