Overruling ERP servers configuration

You can overrule activation-related ERP servers configuration properties at runtime. Specify the settings for the activation properties in the SOAP message (header).

You can overrule these activation properties:

  • User name
  • Password
  • Company

If the ERP server is configured to allow anonymous requests, you can optionally use the overrule mechanism and change the properties. You must use the User name and Password activation properties together.

Note: 
  • If the ERP server does not allow anonymous requests, you must overrule the user name and password.
  • If the ERP server has been configured with "baanlogin_ssl" activation, you cannot overrule the user name and password. Any such values in the SOAP header are ignored.

When the overrule mechanism is active, the changed properties overrule the configured ERP server configuration settings. This enables the creation of more flexible connection towards the ERP Server.

The SOAP header definition of these properties is specified in the WSDL. Therefore, clients using generated proxy code based on the WSDL have some API extensions to set the properties.

From version 10.5.1.0042 of the Connector for Web Services, you can also override the user name and password in an HTTP header using Basic Authentication. For a specification of Basic Authentication, see https://www.ietf.org/rfc/rfc2617.txt.

If the user name and password are overridden in both the SOAP header and the HTTP header, the value from the SOAP header is used.

Note: 
  • Changing user or company has effect on the ERP Server for either installed software (package VRC) or data (companies).
  • Specifying one of the properties creates a new ‘virtual’ ERP Server configuration. Passing the same property values again will point to the same ‘virtual’ ERP Server configuration and enable connection pooling.