Testing the integration using Postman
Everything is prepared to sent messages to ION CE using IMS.
To verify the proper working, you can use a REST client such as Postman API Client.
Complete these steps:
- Install Postman.
- Import in Postman the IMS v3 template collection: IMS v3 template.postman_collection.json
- At the root level of the newly imported project, edit the configuration.
- In the Variables section, add the values of the variables as you find them in the downloaded csv credential file.
- Fill in the variables applicable for the Direct IMS integration. You must specify both, the initial value and the current value:
- directIMSoauthConsumerKey
- Specify the consumer key generated in the connection point.
- directIMSoauthConsumerSecret
- Specify the secret key generated in the connection point.
- directIMSURL
-
Specify the IMS endpoint for your Enterprise Connector IMS service. If this Postman is running at the same host as the Enterprise Connector, and you used a default IMS installation, you can leave the value
https://localhost:28090/api/ion/messaging/service
. - directIMSTenant
-
Specify the cloud tenant id or the tenant configured in your enterprise connector, see the Enterprise Connector Configuration screen.
For an on-premises ION installation, typically tenant INFOR is used.
- logicalId
-
If you created a connection point with another
lid
than infor.ims.cp_myapp, adjust thelid
here accordingly. DO NOT includelid://
in the value.
- Save the changes (Persist All).
- Fill in the variables applicable for the Direct IMS integration. You must specify both, the initial value and the current value:
- You should now be able to successfully run these IMS methods defined in the Postman project:
- ping
You may receive a 503 if the document flow and thus the connection point is inactive.
A successful ping returns HTTP status code 200 and body: {"status":"OK","code": 200}.
- versions
A successful versions returns HTTP status code 200 and body: {"supportedVersions": ["v1","v2","v3"]}.
- AcceptedDocuments
An inactive connection point returns HTTP status code 412.
A successful acceptedDocuments returns HTTP status code 200 and a body such as: {"logicalId": "lid://infor.ims.cp_myapp","acceptedDocuments": ["Confirm.BOD","Sync.SalesOrder"]}.
multipartMessage
ormessage/multipart
An inactive connection point returns HTTP status code 412.
A successful method call returns HTTP status code 202 and body: {"status": "OK","code": 202,"message": "The request was processed successfully"}.
- ping