Coupa policy

A Coupa policy contains the connection details that are used by a Coupa Input or Coupa Request node when connecting to a Coupa application.

You can use a Coupa Request node in a message flow to connect IBM® App Connect Enterprise to Coupa applications and issue requests to create, retrieve, update, or delete objects such as expense reports, exchange rates, and invoices. You can use a Coupa Input node to monitor and accept input from Coupa. The Coupa policy controls, at run time, access to the Coupa application.

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

You can also create, update, or delete a Coupa 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 a Coupa policy, all message flows that are using the policy will be stopped and restarted.

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

Table 1. Properties of the Coupa policy
Property	Property name in .policyxml file	Description of properties
Credential Name	credentialName	This property specifies the name of the credential that will be used for the connection to Coupa. 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.
API URL	apiUrl	This property specifies the URL of the Coupa REST API.
Coupa Authentication method	authenticationMethod	This property is reserved for future use and must be set to the value `OAUTH2_CREDENTIALS`.
Coupa Application Type	applicationType	This property is reserved for future use and must be set to the value `online`.
Coupa Application Version	applicationVersion	This property is reserved for future use and must be set to the value `v1`.