Dear Team,

Seems like REST developers guide is missing from the documentation from 10.5 version.

May I know rational behind this. It is a good documentation for the starters.

https://higherlogicdownload.s3.amazonaws.com/IMWUC/webMethods/Files3/b93fa78aef89ff0249c15bf69aa016a5181b7658_2_631x750.png 1.5x, https://higherlogicdownload.s3.amazonaws.com/IMWUC/webMethods/Files/b93fa78aef89ff0249c15bf69aa016a5181b7658.png 2x" data-dominant-color="DAE1E7">

image644×764 60.7 KB

I’ve written to the documentation team, Sri.
It’s available for 10.5, but missing in 10.7 and 10.11.

KM

Thanks Bro. Not sure why it was removed.

WS, Pub-Sub, JMS, MIME and even WMDB users guide is there but REST is missed for some reason.

Hi @Venkata_Kasi_Viswanath_Mugada1 ,

Just noticed - even 10.5 REST User guide has bugs - https://documentation.softwareag.com/webmethods/integration_server/pie10-5/10-5_Rest_Developers_Guide.pdf page#22 refers to rad URL but does not explain about RAD creation.

https://higherlogicdownload.s3.amazonaws.com/IMWUC/webMethods/Files/8c144c084a63a5181647bff1525c054441f5020a.png 1.5x, https://higherlogicdownload.s3.amazonaws.com/IMWUC/webMethods/Files/8c144c084a63a5181647bff1525c054441f5020a.png 2x" data-dominant-color="F4F4F4">

image852×260 74.2 KB

Seems like after 10.3 version - https://documentation.softwareag.com/webmethods/integration_server/pie10-3/10-3_Rest_Developers_Guide.pdf the documentation is not updated.

Noted, Sri - I’ve highlighted this to the team as well; thanks for picking this up!

KM

@srikanth.prathipati1803, the guide has been moved -

From the IS readme (link) -

https://higherlogicdownload.s3.amazonaws.com/IMWUC/webMethods/Files/ffb655471a938354b4736cf9d91cae7c7621c2cf.png 1.5x, https://higherlogicdownload.s3.amazonaws.com/IMWUC/webMethods/Files/ffb655471a938354b4736cf9d91cae7c7621c2cf.png 2x" data-dominant-color="EBEBEB">

image783×86 40.2 KB

KM

Hi @Venkata_Kasi_Viswanath_Mugada1 ,

Thanks for figuring this out.

I dont find this on Service Development Help either - https://documentation.softwareag.com/webmethods/designer/sdf10-11/10-11_Service_Development_Help.pdf.

Seems like this useful information is definetely lost. It seems odd to keep REST Developers guide in Service development help where as all JMS, Web Services, Pub-SUb, Mime, etc. developer guides are with Integration Server.

IMHO, It just confuses the developers to go all over the place.

This is a fair comment, Sri; I do agree with you -

I’ve reviewed the Service Development Help guide and I see that the REST content has been gradually reduced from 10.5 through 10.11. For instance, content on the legacy approach is no longer available in 10.11, which is fair in my opinion. The part that I see missing is about how the IS handles REST.

I’m positive that there was some thought process to why this was moved and slowly trimmed; I will ask around and get back
I’d suggest that you create a support ticket to get a quicker/formal response.

KM

Update - The REST guide is small and it is a major feature, so the contents were moved into the Development guide for easy access. The other guides, such as DSP and Guaranteed Delivery, for instance, have a smaller audience.

Note - The team is, however, reevaluating the REST documentation right now, so if you have a list of items/contents that you’d like to see in the IS/Designer REST documentation, please share it with me.

KM

I think legacy topics can be flushed out and only keeping restv2 and rad parts adds real value.