Service Configuration

Settings > Service Provider Settings > Service Configuration

Basic Service Configuration

These values define the basic service configuration:

First-Time Service Configuration

Configure the Service Settings and specify Service and Domain names:

Parameter	Description	Typical Value
Service Name	Name of the service provider	Financiocorp Services
Prefix for Service Domain	Optional subdomain name	Allowed characters: a-z, A-Z, 0-9, - (alphanumeric, plus hyphen) Example: service
Service Domain	The Domain Name part of the URL	mydomain.com
Domain URL	Read Only Automatically populated as: Prefix + Service Domain	service.mydomain.com

Subsequent Configuration

These additional parameters become available after the initial configuration is complete.

Parameter	Description	Typical Value
Recaptcha Private Key	After signing up for Google's reCaptcha implementation of the Captcha service, enter the public and private keys here. (They are used to interact with that service.)
Recaptcha Public Key
Copyright Notice	Copyright notice, appears at the bottom of all pages	Copyright 2010
Space Notification Email Address	An email message is sent to this address when Storage Space limits are reached	systemadministrator@mydomain.com
Error Notification Email Address	An email message is sent to this address when errors occur	customer_support@mydomain.com
Help Domain	Required field; Domain name for user help; This page is opened in a new browser window when Help is invoked from the platform	http://www.mydomain.com/help
Custom Help Domain	Optional; If present, it is the domain name for user help; Can be used with a custom Help URL in Custom Object	http://www.customhelp_mydomain.com Or, with Help URL http://www.customhelp_mydomain.com/userdefined_object_name
Document Directory	File location for Documents	/usr/local/
Temp Directory	Used as a temporary storage location	/temp/
Supported Languages	Languages that are supported in this instance of the platform, and are available for selection by tenants. Learn more: Translation Workbench

Primary Service Domain and Alternate Service Domain

The Primary Service Domain and Alternate Service Domain names are configured in Service Provider Settings and comply with the following guidelines:

• Service Domain names can contain the following characters:

• alphanumeric (a-z, A-Z, 0-9)
• hyphen (-)
• period, dot, full stop (.), used as the delimiter in the Prefix for Service Domain

Considerations for the Primary Service Domain

• The Primary Service Domain is required
• If the Primary Service Domain is being used by an MSP, then it cannot be changed
• The Primary Service Domain and Alternate Service Domain names must be unique

Considerations for the Alternate Service Domain

• The Alternate Service Domain is optional
• If an Alternate Service Domain is being used by an MSP, then it cannot be changed

Learn more: Bounced Email Configuration for Alternate Service Domains

Example

For an MSP choosing a prefix of abcde, the following Domain URLs would be available in MSP Settings

Primary Service Domain	Alternate Service Domain	Domain URL(s) Available to the ISV
serviceproviderdomain.com	MSPdomain.com	www.abcde.serviceproviderdomain.com www.abcde.MSPdomain.com

Prefix for Service Domain

About the Prefix for Service Domain

Help URL and Custom Help Domain

As a Service Provider, you might create a help website to align with a customer's branded instance of the platform. In this case, the URL of this help website would be used as the default Help Domain. When a user clicks the Help link in the platform, this default Help Domain opens in a new browser window.

Custom Help Domain

Support Service Configuration

This information is published for users to contact you regarding your service.

• When tenants publish Packages, this email address receives the notification

Parameter	Description	Typical Value
Support Organization	Name of the Support Organization	Service Provider Support Team
Support Email	Email address to send support requests	support@mydomain.com
Available Case Types	Picklist of types of support cases

Email Configuration

Configuration for all the emails sent from the AgileApps Cloud platform.

Parameter	Description	Typical Value
Alternate Service Domain No Reply Email Address	The "reply" address for emails sent from the platform.	no-reply@{platform}.com
Hostname For Relay Server	Hostname	localhost
User Name	User/login name for the email relay server
Password	Password related to the user/login name for the email relay server

Bounced Email Configuration

This email configuration will process all the bounced emails sent through the platform. When an email message does not reach the recipient, it is returned (considered "bounced"). This can happen when an email address is no longer active, or because the recipients' email box is full.

Learn more: Bounced Email Configuration for Alternate Service Domains

To enable Bounced Email Processing:

1. From the Email Configuration section, complete the following information:
2. Enable Bounced Email Processing

   Click the checkbox icon to enable processing for bounced email messages and complete the information in the required fields

3. Optionally, Enable Bounced Email Processing to the Alternate Service Domain

   Click the checkbox icon to enable processing for bounced email messages and complete the information in the required fields

Parameter	Description	Typical Value
Enable Bounced Email processing	Email Bounce Address	Checkbox: Yes/No
Hostname	Hostname	pop.my_secure_email_provider.net
Mailbox Address	Email Mailbox Address	bounce@myemailprovider.com
Mailbox Password	Specify the password for this email account	T0pS3cr3tPa$$word
Enable Bounced Email Processing to the Alternate Service Domain	Email Bounce Address	Checkbox: Yes/No
Hostname	Hostname	pop.my_secure_email_provider.net
Mailbox Address	Email Mailbox Address	bounce@my-alternate-emailprovider.com
Mailbox Password	Specify the password for this email account	T0pS3cr3tPa$$word

Marketing Campaign Email Configuration

This email configuration is used to send email messages as part of an Email Campaign. This email setup provides the ability to personalize the marketing messages sent from your organization. It is possible to configure Marketing Campaign Email from an email relay server. This configuration is applied immediately after settings are saved, and are used for any new Email Marketing Campaign.

To setup Marketing Campaign Email Configuration:

1. Click Settings > Service Provider Settings > Service Configuration
2. In the Marketing Campaign Email Configuration section, complete the following information:

   Use Vertical Response

   Checkbox

If checked, use a Vertical Response account; Learn more: Vertical Response Configuration The following information is required to configure Email Marketing with Vertical Response Login Vertical Response account username Password Vertical Response account password Keystore Password Password of Vertical Response keystore file

If unchecked, complete the following information to configure Marketing Campaign Email: Hostname For Relay Server IP address or the Domain name of the email relay server Port The TCP port of the email relay server; The default value is 25 and can be changed User Name The username associated with the mailbox used to connect to the email relay server Password The password associated with the mailbox used to connect to the email relay server From Email Address This address is displayed on the email as from email address To process bounced emails for Marketing Campaign, complete the following information: Hostname Hostname used for processing the bounced emails generated by the marketing campaign Port The TCP port of the email relay server; The default value is 25 and can be changed Mailbox Address The mailbox used for processing the bounced emails from the Email Marketing campaigns Password The password for the mailbox used to track bounced emails

Considerations

• If the email relay server details are specified:

• Any Marketing campaign that is launched is routed through the configured server, including Test email messages
• Bounce email configuration is required if the email relay server details are specified

• It is not possible to specify just the email relay server details without specifying the bounce mailbox and password

• The bounce mailbox address must be validated to ensure that the value does not match the other Mailbox addresses that are present in Service Provider Settings

• If the email relay server details are not specified:

• Campaigns can be created, however it is not possible to send a test message or launch the campaign
• Any Callback URL in the Marketing campaign emails point back to the Service Domain that has been specified in the Service Provider Settings

External Email Tracking Configuration

To enable external email tracking, set the following attributes to initialize the service:

Parameter	Description	Typical Value
Enable External Email Tracking	Option to enable External Email Tracking	Checkbox: Yes/No
Hostname	Specify the email provider hostname that manages email messaging to/from your site	pop.my_secure_email_provider.net
Mailbox Address	Specify the email address used for email messaging to your site	service@mydomain.com
Mailbox Password	Specify the password for this email account	T0pS3cr3tPa$$word

Process Workflow by Email Configuration

Workflows can be email-enabled, using these attributes:

Parameter	Description	Typical Value
Enable Workflow By Email	Option to allow Workflow managment via email	Checkbox: Yes/No
Hostname	Specify the email provider hostname that manages email messaging to/from your site	pop.my_secure_email_provider.net
Mailbox Address	Specify the email address used for email messaging to your site	service@mydomain.com
Mailbox Password	Specify the password for this email account	T0pS3cr3tPa$$word

Service Theme and Stylesheet

Parameter	Description
Theme	Select a default Theme; Defines the color for the tabs, background and highlight colors
Allow Users to Change Colors	Optionally, allow users to personalize the color scheme for their pages. Checkbox: Yes/No
URL for Custom Style sheet	Specify the URL for a CSS (Cascading Style Sheet) that is applied to all pages
UI Container Scripts	CSS style sheet declarations, javascript declarations, or any other HTML elements to be included in the header of each page.

Develop Configuration

Java code running in a tenancy is subject to strict limits--or governors:

• Some settings put limits on the number of resources that tenants can use, to prevent infinite loops and other kinds of runaway programs. The limits apply to each tenant execution interval--from the time that the platform application instance gives control to tenant code, until the time that control returns to the platform. Up to that limit, an application can use as many resources as it wants. But once a constraint is exceeded, the executing code aborts with an exception.

• Other settings restrict the kinds of Java classes that can be used, to prevent unwarranted access to the server and/or security violations.

The Service Provider Settings can be used to tighten those restrictions, ameliorate them, or lift them entirely.

Considerations

• Settings are global. They apply to all tenants in the platform instance.
• Settings apply to scheduled (background) jobs, as well as foreground applications.
• The minimum for all numeric settings is "1".
• Changes to these settings take effect only when the platform application instance is restarted.

Here are the default settings:

Parameter	Description	Default Value
Apply Governors in Java Code?	Whether or not governors are applied to this platform instance. A development instance may want to turn them off, in some cases. Any multi-tenant production instance will want them on, to ensure that a runaway program in one tenant does not interfere with other tenants. Note: Currently, the code governance is available for Linux installations only.	Yes
Max Number of Statements allowed	The maximum number of Java code statements that can be run during an execution interval.	10000
Maximum String Length allowed	The total size of all strings allocated in the Java heap space during an execution interval.	30000
Maximum CPU Time allowed (milliseconds)	The maximum number of CPU milliseconds that can be consumed during an execution interval.	60000
Java classes not allowed in code	There are certain Java classes which are disallowed in tenant classes, to prevent access to the server and any compromise of server security. (They are, however, allowed in global classes developed by the ISV for use by all tenants.) In order to protect the security of the server, enter a comma-separated list of fully qualified Java Class Names for this option. At compile time, application will check if any of these classes are referenced in the user code and throw an exception if they are. Note that this will take effect only after the server is restarted.	java.lang.System, java.lang.Runtime, java.lang.Class, java.lang.ClassLoader, java.lang.Thread, java.lang.ThreadGroup, java.lang.ThreadLocal, java.lang.Runnable, java.lang.Compiler, java.lang.RuntimePermission, java.lang.reflect.AccessibleObject, java.lang.reflect.Array, java.lang.reflect.Constructor, java.lang.reflect.Field, java.lang.reflect.Method, java.lang.reflect.Modifier, java.lang.reflect.Proxy, java.lang.reflect.ReflectPermission, java.io.FileReader, java.io.FileWriter, java.io.FileInputStream, java.io.FileOutputStream, java.net.DatagramSocket, java.net.DatagramSocketImpl, java.net.HttpURLConnection, java.net.Inet4Address, java.net.Inet6Address, java.net.InetAddress, java.net.InetSocketAddress, java.net.JarURLConnection, java.net.MulticastSocket, java.net.ServerSocket, java.net.Socket, java.net.URL, java.net.URI, java.net.URLClassLoader, java.net.URLConnection, java.net.URLStreamHandler, java.lang.Process, java.lang.ProcessBuilder
Libraries supported in Java Code	When compiling user-defined code, the platform allows certain libraries like jars or internal java packages: If a custom library is required, the jar can be placed in the ../tomcat/lib folder of the Apache Tomcat installation To include these library files, enter a comma-separated list of such jar files for this option Note that this will take effect only after the server is restarted.	Empty
No. of Objects in Database Views	Database Views allow the creation of custom categories that join multiple objects These database views can be used as the base category for a Report The maximum number of tables that are allowed is five (5), with a default value of three (3) The number of joins in these tables is restricted to the maximum number + 1	Default: 3, Range is 3-5
Maximum rows in a List View	Maximum number of rows that are fetched in a List View for an object is defined by this option This number is limited by the maximum int value supported by Java/MySQL i.e. 2^16 = 4G	10000
Maximum rows in a report	Maximum number of rows that are fetched in a report This number is limited by the maximum int value supported by Java/MySQL i.e. 2^16 = 4G	5000
Maximum rows in a Scheduled Report	Maximum number of rows that are fetched in a report that runs in the background queue. This number is limited by the maximum int value supported by Java/MySQL i.e. 2^16 = 4G	5000
Maximum Savepoints	Intermediate placemarks, which identify points at which the data fields contain intact, legitimate values	5
Maximum Recursions in Java API	Allow a function to call itself the specified number of times	10

Tenant Configuration

This section is used by:

• ISVs who are hosting clients on a shared instance of the platform.
• ISV users who are setting up an instance of the Installable Version in order to Develop on Separate Platforms.

Allow Unauthenticated Tenant Creation

Allows any prospective customer to create a new tenancy (a trial account).

• Unchecked by default
• If checked, trial accounts can be created by unauthenticated users who have a computer and network connection that meets the Minimum Client Requirements

Enable Tenant Subdomains

This setting lets customers specify a URL subdomain when registering, giving them a unique URL they can use to access their platform applications.

Learn more: Tenant Subdomains

Instance Configuration

This section is used by ISVs who are using the Installable Version of the platform to set up multiple collaborating instances.

Instance Type

Choose one of: Development, Testing, Production

• When a single instance of the platform will be used to host client tenants and/or development tenancies for cloud development, use the default instance type (production).

• When multiple instances of the platform will be used for testing, development, and production, choose the type that corresponds to the work that will be done on this instance of the platform.

Learn more: Collaborative Development Configurations

Considerations:

• For Development and Testing instances, the instance type is part of the generated namespace.
• If Instance Type is Development, then the Metadata Repository feature can be enabled

Catalog Configuration

Catalog Configuration

Catalog Considerations

Community Site Configuration

A Community can be created to support community applications like Support Portal, Answers, Ideas, Social Networking. When enabled, all Users in all the tenancies (under a single ISV) can share knowledge and collaborate, without requiring a separate login to the platform.

Enable Community

Checkbox

Community Tenancy ID

Enter the Tenant ID

Community Site Name

Enter the Site name for the community; this name is displayed on each page

Custom Authentication Configuration

Provide URL for a custom Login Page. Leave this field blank if you are using the default AgileApps Cloud platform login page.

Custom Login Page URL

Registration Configuration

Choose the default settings for new tenants: Registration Sidebar

App Center Sidebar

Enable App Center

URL for Terms of Service

Enable Relay for New Tenants

Application Container URL

Starting Application Configuration

Starting Application Configuration

Field Encryption Settings

Specify a Field Encryption key to use when storing sensitive data. The key is unique to this instance of the platform. Once specified, it does not change.

Generate Encryption Key

This button is available when editing Service Provider Settings. Clicking it generates a new, unique key that is used by the AES128 algorithm to store encrypted data in secure fields.