Article ID: 115890, created on Apr 3, 2013, last review on Aug 12, 2014

  • Applies to:
  • Operations Automation 5.4


APS 1.2 application of External System type designed for PA.

Desired Behaviour

Application is linked with domain (or domains) that belong to customer's account. DNS records are automatically added or replaced in domain zone.


To enable domain integration in APS application of External System type, use the setting with class ="domain-name" (refer to Application Integration Guide for more details).

There may be 2 different use cases.

Use case #1. Application is installed on one domain.

Examples - mobile site (GoMobi application), eShop (ePages application).

To achive installation on customer's domain, add domain name setting with type="domain-name", e.g.:

<setting id="shop_domain" class="domain-name" visibility="hidden" protected="true" type="domain-name">
   <name>Shop domain</name>

In addition to the domain-name value of setting, it is necessary to enable the 'Provision application on account's domain' activation parameter in the corresponding 'Application' resource type in POA.

Refer to the Knowledgebase article How to install an APS application on a customer's domain automatically for more details how to configure automatic installation of APS application on domain.

Currently POA does not allow to change domain an application is installed on.

It is recommended to use domain-name setting in the entry point.

Use case #2. Application can receive several domains.

Example - Spam Filter.

If several domains can be added to the APS application, use the domain-name setting with type="list", e.g.:

<setting id="domains" class="domain-name" type="list" element-type="string" track-old-value="true">
     <name>List of domains</name>

When such setting is defined in APS application APP-META.xml, the 'Domains' tab will appear at application screen in POA Customer Control Panel. Customer can add several domains from the list of domains that are registered in their customer account.

To have domains added to application automatically, enable the 'Bind domains to application instance' activation parameter in the corresponding 'Application' resource type in POA.

Note: if application is installed automatically, empty domains list can be received on installation step. Then, when domains registration is completed in PA, application script will be called with the 'configure' parameter and domain list will be passed to application.

Configuration script receives domain list as usual list setting.

For example, and are added to application on installation step. Application has domain list setting as in the example above. On application installation step configuration script receives domains in the following environment variables:

Later, when customer adds one more domain in Customer CP, for example the domain, configuration script is being called with the 'configure' parameter, and domains are being sent as follows:

If the domains setting has attribute track-old-value, the old list of domains will be sent as well:

Replacing DNS record

To replace a DNS record in domain zone, use the substitute option.

The example of scenario when application needs to replace DNS record: Spam Filter application changes existing MX records in domain in order to receive email, filter it and send to original mail server.

Application configuration script receives original DNS records as DNS_<id>_SUBSTITUTE environment variable. In addition to this, in case when 'list' domain-name setting is used, the following environment variables are sent:

DNS_<id>_SUBSTITUTE_<domain_name>_<seq number>

For example, DNS requirement id is 'MX1', and the originally had 2 MX records: and, and - and In such case, the variables related to MX records substituting will be as follows:

Search Words

APS with domain



5356b422f65bdad1c3e9edca5d74a1ae caea8340e2d186a540518d08602aa065 ac82ce33439a9c1feec4ff4f2f638899 2554725ed606193dd9bbce21365bed4e e12cea1d47a3125d335d68e6d4e15e07

Email subscription for changes to this article
Save as PDF