General¶

Introduction¶

The General build page is where you configure the following:

• The SMTP server used when App Builder or your app sends emails.

• A Google Maps API key, needed if your app uses Location type fields.

To open the General build page, go to Configuration > General:

SMTP¶

The SMTP panel is where you configure a custom SMTP server (for one type of email—see below):

There are three types of email App Builder or an app can send:

• Bulk emails: An app user can send selected records to other (registered) app users using the Send Email button.

  The SMTP settings for this type of email are defined in the app user's UI, on the Administration > Email Accounts page.

• System emails: At different times in an app's lifecycle, App Builder sends these system emails:

  Recipient	Event
  App administrator	First time you publish an app
  App user	New account creation
  App user	Password reset
  App user	App access granted

  Emails of this type always use App Builder's built-in SMTP server. (To have system emails sent from a custom SMTP server, contact Jitterbit Support.)

• Flow emails: If an app has a microflow with a Send Email step, emails are automatically sent to the app users defined in the step.

  With an empty SMTP configuration, emails of this type use the built-in SMTP server. If you define a custom SMTP server, only flow emails use it; system emails continue to be sent via the built-in SMTP server.

The following table summarizes the source of SMTP configuration for each type of email:

Custom SMTP Server¶

To define a custom SMTP server, follow these steps:

1. In the SMTP panel, set values for the following:

   • Host: Enter the SMTP server's hostname.

   • Port: Enter the SMTP server's port number (usually one of 25, 465, 587, or 2525).

   • User: Enter the username used to access the SMTP server.

   • Password: Enter the password for User.

   • Secure Connection (SSL): Set On to enable SSL.

   • Senders: The email's sender addresses (as seen in a sent email's From field). You must add at least one before you can save the settings.

2. Click Save.

To return to using the built-in SMTP server, click Delete. (This action affects both support-enabled custom SMTP system emails and flow emails.)

Add a Sender¶

To add a sender, follow these steps:

1. In the Senders section of the SMTP panel, click the icon. The Sender Add dialog opens.

2. Enter values for these fields:

   • Name: Enter the name for the sender.

   • Email: Enter a valid email address for the sender.

   • Default: Set On to make this sender the default.

3. Click Add to add the sender, or Cancel to cancel.

To edit a sender, follow these steps:

1. In the Senders section of the SMTP panel, click the icon for a sender. The Sender Modify dialog opens.

2. Edit the values, then click Add to save, or Cancel to cancel.

To delete a sender, follow these steps:

1. In the Senders section of the SMTP panel, click the Delete icon for a sender.

2. The sender is deleted. (There is no confirmation.)

Google Maps API Key¶

A Google Maps API key is defined in the Google Maps API Key panel on the General build page:

To define a key for a Location field, follow these steps:

1. Create a Google Cloud Platform (GCP) project in your GCP Console, and enable the Maps Javascript API, Maps Static API, and Places API.

2. In the Your API Key field on the Google Maps API Key panel, enter your Google Maps API key.

3. Click Save.

4. Publish your app. (Location fields do not work in an app preview.)