Built-in Resource Provider

ActiveMatrix BusinessWorks provides an alternative way to retrieve resources using a feature called Built-in Resource Provider.

This feature enables the ActiveMatrix BusinessWorks engine to listen on a configured port and retrieve resources such as a WSDL file, XSD file, Process file, Image file, and so on. This out-of-the-box solution performs tasks similar to that of the Retrieve Resource activity, but eliminates the need to create a process definition to use the Retrieve Resource activity. For details about the process definition, refer to Process definition using the Retrieve Resources activity .

Since the feature works the same as Retrieve Resource activity, the client side functionalities with respect to Retrieve Resource activity remain the same.

However, the only exception is that this feature does not support Client authentication for SSL.

ActiveMatrix BusinessWorks provides parameters to enable or disable the feature, and override the defaults configuration. You can set these values in the bwengine.xml to be reflected in the TIBCO Administrator after deploying the project.

BW.platform.services.retreiveresources.Enabled

This property specifies whether the Built-in Resource Provider feature is enabled or not. Setting it to true enables the feature. By default it is set to false.

BW.platform.services.retreiveresources.Httpport

This property specifies the port number that is configured to listen for incoming HTTP requests. This property is set to 8010 by default.

BW.platform.services.retreiveresources.isSecure

This property specifies if the incoming requests must use the HTTPS (secure socket layer) protocol. The HTTPS protocol authenticates the server to the client. By default, this property is set to false.

BW.platform.services.retreiveresources.enableLookups

This property, when set to true, enables the HTTP client to look up a Domain Name System and resolve the IP address to a DNS Name.

Setting this property to true adversely affects the throughput. Hence this property can be enabled only when required. By default, this property is set to false.

BW.platform.services.retreiveresources.defaultEncoding

This property specifies the encoding to use for the URL if no charset is specified in the Content Type header of the message. By default, this property is set to ISO-8859-1.

BW.platform.services.retreiveresources.identity

This property specifies the Identity resource that contains the HTTP Server’s digital certificate and private key. This property is available when the bw.platform.services.retreiveresources.isSecure property is set to true.

BW.platform.services.retreiveresources.Hostname

This property specifies the hostname to which the request has been sent. It is useful to identify the exact host in a multi-host configuration to whom the request has been sent. By default, this property is set to localhost.

Note: When an Enterprise Archive file, generated with ActiveMatrix BusinessWorks 5.4.x or earlier versions, is deployed in TIBCO Administrator, the built-in resource provider parameters are not available in TIBCO Administrator.
To enable specifying the built-in resource provider parameters, recreate the Enterprise Archive file with ActiveMatrix BusinessWorks 5.6.0 and deploy in TIBCO Administrator.