Invoking Good Email

Overview

Verivo’s platform allows users invoke the Good Dynamics for Enterprise email client through the use of the “Click to Native Browse” feature. This feature lets users create a new email in their Good email client by selecting a configured control. This functionality also allows you to preset fields within the email, for example the To and Subject fields.  

To successfully invoke the Good email client from a control, you must configure the following properties in the Click Handling section of the control’s properties:

  • Action: Click to Native Browse
  • Target Screen & View: Leave blank
  • Transition Style: ScreenSetting
  • Target Control: Set to a text control whose value starts with “gmmmailto:”

Target Control

The Target Control value must start with “gmmmailto:” to invoke the Good email client. After the “gmmmailto:” prefix, you must specify the email address to which the message should be sent, followed by an optional  “?” if you wish to set any additional parameters.

The following is the format to create an email in the Good client:

gmmmailto:<Email Address>?<Option 1>&<Option 2>&<Option 3> …

 The options portion of the address gives you the ability to preset fields, such as the email subject. This is a great feature in situations where you want to set up a button control that triggers a standard request for information about a particular record. The following are some options available to you: CC, subject and body.

Below is an example of a lookup control that sends an email to info@verivo.com and presets additional fields.

gmmmailto:info@verivo.com?subject=Please Send Info&body=I am requesting AppStudio information

Additional Information

Dynamic Target Control

Typically, the email address that you want to send to is not static and instead depends on the current record selected. The best way to set up the target control in this situation is to create an additional Data Field within the entity. In that newly created Data Field, set the calculated column to the following:

‘gmmmailto:’+ <field that contains the email address>

On the screen that you want to invoke click to email, reference this new data field as the Target Control in the Click Handling section.

LUA scripting

Instead of calculated columns, it is also possible to use LUA scripting by updating the Target Control based on the current record selected. For example, the LUA script could append Product information to the body of the email for the current item selected.

* This is subject to change if Good makes any updates to the API

Example Script:

I have put following script to OnLoad event on Screen propery:
local c = thisview:getAllControls()

if (c.ControlName:getValue() ~= "")
then
c.txtEmail:setValue("gmmmailto:" .. c.ControlName:getValue() .."@emailAddress.com")
--inform (c.ControlName:getValue())
end

txtEmail is Target Control on ControlName field

Have more questions? Submit a request

1 Comments

  • 0
    Avatar
    devin.weise

    Can this functionality be leveraged to send an email to multiple recipients through one control (say if I had a primary email and alternate email address, and I wanted to send an email to both by tapping one text control)? 

     

    Thanks,

    Devin Weise

    JPMorgan Asset Management

Please sign in to leave a comment.
Powered by Zendesk