Sterling OMS HTTP API Tester
Why we need this tool ? : Using HTTP tester you can test any new service created or existing API.
Is this only way to test ? : we can create simple Java HTTP program and do the same activity.
How to use HTTP API testing with OMS?
After successful IBM Order Management System install should be able to test the application using http tester. Should be enabled only in test.
Specify the following URL to access the HTTP API tester:
http://localhost:7001/smcfs/yfshttpapi/yantrahttpapitester.jsp
Note: Below link works only when application is up and running.
| Attribute Name | Remarks |
| Is a Service | If we are calling out of the box API we should not select the checkbox
If we are calling a service created by our own; we should select the checkbox |
| Service Name | If Is a Service check box selected; enter the Service name (Case Sensitive) |
| API Name | Select API name from drop down (Out of the box API’s) |
| User ID | Sterling application user ID. Refer yfs_user table column LOGINID |
| Password | Sterling application password. Refer yfs_user table password (Encrypted) |
| Version | Select if needed; else blank |
| Locale | Enter locale code; else blank (en_US_EST) |
| Message | Input XML message; should be valid XML |
| Template | Valid template XML; How your output needs to be displayed; |
Question : In production how to stop the HTTP tester?
- Modify the web.xml: By implementing the security-constraint element with the web-resource-collection element, you can set up authorization to protect this page from unauthorized access.
- OR simply remove the yfshttpapi directory under /repository/eardata/platform/war and secure the /interop/InteropHttpServlet servlet using the security features provided by your application server
You can register with us to get more OMS learning updates
Sterling OMS add new column (Extending)
Very nice topic and usefull.
Aman. Thanks for your review and nice comment.
To exclude the HTTP API Tester in the production build, specify the following parameter when calling buildear.sh (refer Installation Guide)
-Ddevmode=false
Thanks for the information. Let us keep learning.
why we used template XML in API Tester?
:—— Template XML file allows you to specify a subset of the elements and attributes that the API returns.
Yes Thanks for the information. here is some more additional information
What is difference between TotalNumberOfRecords attribute vs MaximumRecords attriute
TotalNumberOfRecords : Used part of output XML template. When this attribute used select count(*) from table_name where x=y (Search condition applied) query been fired to calculate the total record count. This can create performance issue if more records found.
MaximumRecords : Used part of list API calls (getOrderList, getItemList). If value not specified defaulted to 5000 record (Most of the cases). if specified returns only number of records specified.
Wonder from where this 5000 value coming from ? Is it possible to override this value ?
properties\yfs.properties file
yantra.app.maxrecords=5000
You can override this value from customer override properties. But remember this change will get applied to entire system.
Thanks you for More Explanation.
You are most welcome
Is there a way to set API query timeout for sterling API calls ? I came across the link below and wanted to check if the yfs.ui.queryTimeout would the API timeout abort the session and rollback the transaction context that the API is executing in ?
http://www-01.ibm.com/support/docview.wss?uid=swg21519180
Abhi, thanks for your question. Need some time to test this and get back you. Thanks
Pingback: Sterling OMS Creating Integration Server - Learn IBM Sterling Order Management System
Pingback: Sterling OMS Understanding Supply Demand without Reservation - Learn IBM Sterling Order Management System
I have done the code change in UE which is called via one service in my local. Now if i call that service directly from api tester, my code change is working. If the agent is processing that, i am not seeing my changes. It is working with old code. since there is no app box or agent box in local, I am not sure why my code is not working when agent is processing the orders
Radha,
Sorry for late response. Not sure if this issue resolved or not. Newly build jar which contain latest jar is missing. How are you exporting your UE code ?Can you please let us know if you face issue.
Can we customize yantrahttpapitester.jsp. How to deploy these customized changes. I tried changing the jsp in smcfs.ear/smcfs.war/yfshttpapi/yantrahttpapitester.jsp directly and restart app server. but the changes did not reflect. Can we do this any other way? like extending.