IBM Maximo policy

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

You can use an IBM Maximo Request node in a message flow to connect to IBM Maximo and issue requests to create, retrieve, update, delete, replace, or download objects. You can use an IBM Maximo Input node in a message flow to monitor and accept input from IBM Maximo, such as information about new assets. The IBM Maximo policy controls, at run time, access to the IBM Maximo application.

The IBM Maximo policy is created when you configure a connection between an IBM Maximo Input or IBM Maximo Request node and IBM Maximo, 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 Maximo policy. The policy is created with a type of IBM Maximo, and the name of the policy is returned to the node and specified in the Connection tab, in the format {policyProjectName}:policyName.

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

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

Table 1. Properties of the IBM Maximo policy
Property	Property name in .policyxml file	Description of properties
Maximo URL	endpointUrl	The URL of the IBM Maximo instance, in the format `<http or https>://<hostname>:<port>`
Credential Name	credentialName	This property specifies the name of the credential that will be used for the connection to IBM Maximo. 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.
IBM Maximo Authentication method	authenticationMethod	This property specifies the type of authentication that is used for the connection between IBM App Connect Enterprise and IBM Maximo. Valid values are `BASIC` and `API_Key`, and must match the set of properties configured on the referenced credential.
IBM Maximo Application Type	applicationType	This property is reserved for future use and must be set to the value `onprem`.
IBM Maximo Application Version	applicationVersion	This property is reserved for future use and must be set to the value `v1`.