Header “tenant”

In an Integration Service environment that uses more than one tenant, i.e. if there is more than one tenant with the state “enabled”, incoming requests from clients must be assigned to a certain tenant. In this case the SOAP request header must contain the name of a tenant. All web service operations of the Integration Service interpret the tenant header (or its absence) as follows:

• If the tenant header is absent the Integration Service assumes the default tenant (the tenant with ID one).

• Multiple occurrences of the tenant header cause the header to be ignored. The default tenant will be used.

• If a tenant header contains a name that is not known to the system the operation returns an error with code TEN-01000 (UNKNOWN_TENANT).

• If a tenant header contains a known tenant name but the tenant is disabled the operation returns an error with code TEN-00999 (DISABLED_TENANT).

Example: