IBM Watson Discovery policy

An IBM® Watson Discovery policy contains the connection details that are used by an IBM Watson Discovery Request node when connecting to an IBM Watson Discovery application.

You can use an IBM Watson Discovery Request node in a message flow to connect IBM App Connect Enterprise to IBM Watson Discovery applications and issue requests to create, retrieve, update, delete, or add documents. The IBM Watson Discovery policy controls, at run time, access to the IBM Watson Discovery application.

The IBM Watson Discovery policy is created when you configure a connection between an IBM Watson Discovery Request node and IBM Watson Discovery by using the Connector Discovery wizard. During the process of discovery, account credentials are stored in the vault and connection details are stored in an IBM Watson Discovery policy. The policy is created with a type of IBM Watson Discovery, and the name of the policy is returned to the IBM Watson Discovery Request node and specified in the Connection tab, in the format {policyProjectName}:policyName.

You can also create, update, or delete an IBM Watson Discovery policy by using the Manage Discovery Connector Policies and Credentials wizard, which you can access by right-clicking the policy project in the IBM App Connect Enterprise Toolkit and then clicking New > Discovery Connector policies and credentials.

You must deploy this policy before message flows that use the policy are started. If you redeploy an IBM Watson Discovery policy, all message flows that are using the policy will be stopped and restarted.

For more information about using IBM Watson Discovery policies, see Using IBM Watson Discovery with IBM App Connect Enterprise.

Table 1. Properties of the IBM Watson Discovery policy.
Property	Property name in .policyxml file	Description of properties
IBM Watson Discovery Application Type	applicationType	This property is reserved for future use and must be set to the value `online`.
IBM Watson Discovery Application Version	applicationVersion	This property is reserved for future use and must be set to the value `v1` or `v2`.
IBM Watson Discovery Authentication method	authenticationMethod	This property must be set to `BASIC`.
Base URL	endpointUrl	The base URL for your IBM Watson Discovery service instance.
Credential Name	credentialName	This property specifies the name of the credential that will be used for the connection to IBM Watson Discovery. The specified credential can be defined during connector discovery and stored in the vault. Alternatively, you can specify an existing credential that was configured by using the mqsicredentials command or the server.conf.yaml file, or loaded through an external credential provider.