将Google Map添加到SugarCRM模块

概述

管理员可以利用Google Maps™地图服务的API将地图图像嵌入到Sugar®记录视图中,并使用户可视化其客户的位置。 

先决条件

  • 要将Google Map嵌入到Sugar等第三方网站上,必须使用您的Google帐户从Google获取API密钥。有关创建和获取API密钥的信息,请参阅Google的 Google Maps Embed API 文档。 
  • 您要在其中显示Google Map的Sugar模块必须包含一个“地址”类型字段组,以供Google Maps API引用。

用例

在此示例中,我们将使用“联系人”模块的“主要地址”字段组通过Google地图检索联系人位置的可视图像。Google地图将添加到“记录视图”布局中。 

完成步骤

请按照以下步骤在“联系人”模块中创建一个类型为“ IFrame”的新字段,并使用“主要地址”字段生成对Google Maps的查询。有关在Sugar中创建字段的更多信息,请参阅Studio文档。

  1. 导航到管理> Studio>联系人>字段,然后单击“添加字段”。
  2. 使用以下值创建一个新的IFrame字段:
    • 数据类型:iframe
    • 字段名称:contactsmap
    • 显示标签:位置
    • 系统标签:LBL_CONTACTSMAP
  3. 选中“生成URL”复选框旁边的复选框。
    Contacts_LocationField_Add
  4. 在“默认值”字段中输入以下网址,将“ API_KEY”替换为您通过前提条件 部分通过Google获得的API密钥: https://www.google.com/maps/embed/v1/place?key=API_KEY&q= 
  5. 使用“生成URL”下拉菜单选择要添加到Google Map查询的地址字段。对于此示例,地址字段以“ primary_address_”为前缀,但是您的用例可以使用具有不同地址字段的模块。例如,帐户模块的现成地址字段名称以“ billing_address_”或“ shipping_address_”为前缀。请根据您的需要选择适当的字段。
    • 选择“ primary_address_street”,然后单击“插入字段”。
    • 选择“ primary_address_city”,然后单击“插入字段”。
    • 选择“ primary_address_postalcode”,然后单击“插入字段”。
    • 选择“ primary_address_country”,然后单击“插入字段”。
      image_8新
      现在,“默认值”字段中的URL看起来应类似于以下地址:
      https://www.google.com/maps/embed/v1/place?key=API_KEY&q={primary_address_street}
      {primary_address_city} {primary_address_postalcode} {primary_address_country}
  6. 接下来,通过在每个地址字段之后添加逗号和空格字符来修改URL。最终URL看起来应类似于以下内容,但具有唯一的API密钥和所选的Sugar模块的相应字段名称:
    https://www.google.com/maps/embed/v1/place?key=API_KEY&q={primary_address_street}、{primary_address_city}、{primary_address_postalcode}、{primary_address_country
    }
  7. 您也可以根据需要调整地图字段的“最大尺寸”(以字符为单位的宽度)和“ IFrame高度”(以像素为单位的高度)。在我们的示例中,我们将使用默认的“最大尺寸”值255和IFrame高度400。
  8. 将IFrame字段的“导入”选项更改为“否”,以防止用户覆盖您配置的预设查询格式。 
  9. 点击“保存”以创建新的IFrame字段。
    Contacts_LocationField_Save

有关您可以在Google Maps查询中使用的其他参数的列表,请参阅  Google Developer网站上的Google Static Maps开发人员指南文档。 

应用

现在已经创建了位置字段,通过管理> Studio>联系人>布局>记录视图将该字段添加到“联系人”模块的“记录视图”布局中。有关在布局中添加字段的更多信息,请参考Studio文档或“编辑模块的布局”一文。

注意:对于旧版模块,请将字段放置在DetailView布局上。不要将字段添加到EditView布局中,因为该值是自动生成的,并且最终用户无需编辑任何内容。

将“位置”字段添加到“联系人”记录视图布局后,导航到现有的联系人记录以查看Google地图。请注意,联系记录必须包含主要地址街道,城市,邮政编码和国家/地区,以便正确生成地图。

LocationResults ContactRecord

推荐阅读

  1. SugarCRM新用户向导
  2. 如何开启使用SugarCRM 11?
  3. 从SugarCRM实例中删除较旧的电子邮件
  4. 从移动设备访问SugarCRM
  5. SugarCRM重置密码-从数据库重置管理员密码
  6. SugarCRM MS Outlook插件安装指南
  7. SugarCRM MS Outlook插件用户指南
  8. SugarCRM发布了2.7.2版的Outlook插件

发表评论

您的电子邮箱地址不会被公开。 必填项已用*标注