KINAMU Business Solutions GmbH

Talpagasse 1A | A-1230 Wien
www.kinamu.com | office@kinamu.com | Tel: +43 1 306 20-0

KINAMU Addresses Enhancement Addon

for storing multiple addresses (as locations) in SugarCRM modules Vienna, Mai 2026 Version 1.0

Module Overview

The Address Enhancement add-on is not accessible from the main navigation panel. It provides its functionality through integration with individual core modules.

Module Details

Compatible Sugar Core Modules

The addon can cooperate with all the Sugar core modules with address fields:

• Accounts (billing and shipping address)
• Contacts (primary and alternate)
• Leads (billing and shipping)
• Quotes (billing and shipping)
• Targets (primary and alternate)
• Business Centers (business center address)

When creating a new address or editing an existing one, only the relevant address types are displayed.

Module-specific Fields

• Addresses Type (required): the SugarCRM address type under which the address entry is categorized. Any type can be specified in any module, but only address entries directly related to the bean can be updated automatically.
• Primary?: If set, the corresponding address type of the parent bean will be actialised.
• Version (optional): with version numbers, address entries of the same address type can be versioned. Additionally,
• From Date (optional): if specified, the parent bean’s address of the corresponding type will automatically adopt the provided address data during the date interval defined by the From Date and To Date fields.
• To Date (optional): if specified, the parent bean’s address of the corresponding type will automatically adopt the provided address data during the date interval defined by the From Date and To Date fields.
• Country (required): the "country" component of the address data
• Region (required): the "state" component of the address data
• City: the "city" component of the address data.
• Street (optional): the "street" component of the address data. It is stored separately from the house number component in the Addresses module. However, in SugarCRM core modules' address data, street name and house number components are joined fields, stored and displayed together.
• House No. (optional): the "house number" component of the address data. It is stored separately from the street name component in the Addresses module. However, in SugarCRM core modules' address data, street name and house number components are joined fields, stored and displayed together.

Appearance

List View

You can build custom filters using the address fields. A special filter field named "Account" is also integrated.

With this special filter, you can choose one or more accounts and list all related addresses, including relevant contact, business center, quote and lead addresses. You can combine this special filter with any other fielter filter fields.

Record View

There’s no need to bother naming the address either as it automatically gets a name based on the address type and location.

Subpanel View

Google Maps-specific functions

With integrated Google Maps support, this addon gives you better user experience and more features to address handling. These features require a valid Google Maps API key, properly configured in the config panel and on Google Console.

Address Input Helpers

Address fields can both entered manually but the fields can also be filled out with the aid of an address autocomplete match or by simply selecting the location directly on the map area.

Autocomplete

This function gives you address matches as you begin to enter an address. The action field for this function is the "Street" field. Just start typing the desired address and if Google finds matches to it, a collection of these matches are displayed. You can either just ignore the recommendations or you can also select and click the desired address.

After clicking on an address element, all address field components will be are automatically filled out.

Point-and-click Address Selection

This function is available in the create and record view of the Addresses module. During editing, the "Select Place From Map" button appears in the header:

After clicking the button, a map drawer appears:

You can zoom in on the area of the desired location using the integrated autocomplete search field, then mark the exact spot by clicking on it. Similarily to the autocomplete function, after clicking on a location point, all address field components will be are automatically filled out.

Geocoding

If Google Maps API is activated, addresses are validated using Google's geocoding feature. If the input matches an actual address, its coordinates are stored and the record is marked as a validated address.

Geocoding process is initiated in the background without any further user interaction and can occur in two different ways:

• At runtime - for a single record
• Daily mass update - for any record that needs to be updated

At Runtime

When the user enters a new address record or making changes on an existing one, geocoding occurs after the saving process. Normally, the results are visible immediately.

Mass Update Scheduler

Once a day, the add-on scheduler updates records that could not be refreshed at the time of editing for some reason (e.g. imported records or because the API was unavailable during editing).

Addresses Dashlet

The dashlet works only with validated (geocoded) addresses.

There is an Addresses dashlet available for all supported Sugar core modules (Accounts, Contacts, Leads, Prospects, Business Centers) record view for visual representation of the bean-related addresses. The dashlet offers an overview map and a function for searching nearby entities.

Adding To Parent Sidepanel

On the sidepanel of a supported Sugar module (see above) go to a Dashboard and click on 'Add Dashlet'. In the dashlet list, select 'Addresses', give it a name and save it.

Show entity's addresses on map

When using in a supported module's record view, the dashlet lists all addresses related to the actual entity (Account, Contact etc.). You can navigate through addresses by clicking on them. The selected address is highlighted in the list and shown on the map.

Searching Nearby Entities

Clicking the "What's nearby?" link next to the items in the dashlet's address list displays the addresses of nearby compatible entities (Accounts, Contacts, etc.) on the map. The search radius can be configured in the settings (see the Admin Guide).

The results are displayed in two ways:

• on the map, as icons representing the entity type (Accounts with the Account icon, Contacts with the Contact icon, etc.). Hovering over an icon displays the name of the entity associated with the address (e.g. the Account name).
• in a list below the currently selected base address. Hovering over an item in the list provides visual feedback on the corresponding icon on the map. Clicking on a list item opens the bean of the corresponding entity.

Row action menu items

You can also use the above functions using the Addresses subpanel's row action menu entries:

• Show on Map
• What's Nearby?

Using dashlet in Addresses module

You can also use the above functions in the Addresses module's list view. Unlike the subpanel under the core modules, a single address is displayed here instead of an address list, which can be shown using the "Show on Map" button in the row action menu of an address entry. Nearby addresses can be shown by using the row action menu "What's Nearby?" or by clicking the corresponding link in the address row displayed on the dashlet.

Route Planning

This function works only with validated (geocoded) addresses. It can by used on the Address subpanel of a supported Core module or on the Addresses module list view.

To plan a route, the desired waypoints (two or more) must first be selected from the Addresses subpanel. Google then generates an optimized driving route based on the selected points.

Show Route Internally On Sugar Drawer

After selecting the waypoints, click on the selection's action menu "Route Planning". A dashlet appears, showing the optimized route within the waypoints.

Show Route Externally On Google Maps

On the Route Panning drawer you can either close the drawer or go further on planning with detailed instructions. To do that, click on "Open in Google Maps" button. A new tab opens with Google Maps showing the instructions for the actual route.