Skip to Main Content
IBM Z Software


This portal is to open public enhancement requests against IBM Z Software products. To view all of your ideas submitted to IBM, create and manage groups of Ideas, or create an idea explicitly set to be either visible by all (public) or visible only to you and IBM (private), use the IBM Unified Ideas Portal (https://ideas.ibm.com).


Shape the future of IBM!

We invite you to shape the future of IBM, including product roadmaps, by submitting ideas that matter to you the most. Here's how it works:

Search existing ideas

Start by searching and reviewing ideas and requests to enhance a product or service. Take a look at ideas others have posted, and add a comment, vote, or subscribe to updates on them if they matter to you. If you can't find what you are looking for,

Post your ideas
  1. Post an idea.

  2. Get feedback from the IBM team and other customers to refine your idea.

  3. Follow the idea through the IBM Ideas process.


Specific links you will want to bookmark for future use

Welcome to the IBM Ideas Portal (https://www.ibm.com/ideas) - Use this site to find out additional information and details about the IBM Ideas process and statuses.

IBM Unified Ideas Portal (https://ideas.ibm.com) - Use this site to view all of your ideas, create new ideas for any IBM product, or search for ideas across all of IBM.

ideasibm@us.ibm.com - Use this email to suggest enhancements to the Ideas process or request help from IBM for submitting your Ideas.

Status Not under consideration
Workspace z/OS Connect
Created by Guest
Created on Dec 11, 2018

Zos Connect API requestor support for RAML service documentation

zOS connect API requestor currently consumes request and response json as swagger input. API gateway such as Mulesoft publish documentation as RAML which means they cannot simply be consumed by zOS Connect.

The requirement is to enable zCEE to consume RAML directly or provide a solution to convert to swagger for consumption.

Idea priority High
  • Guest
    Reply
    |
    Dec 18, 2018

    Thank you for this RFE.

    The strategic direction of z/OS Connect EE is to move towards supporting OpenAPI Spec 3.0. OAS 3.0 is the place where the market is moving to and the point where Swagger and RAML will converge:
    https://swagger.io/blog/news/mulesoft-joins-the-openapi-initiative/

    In the meantime there are a number RAML to Swagger 2.0 conversion tools available. We are unfortunately unable to make a public recommendation here, however a quick web search on "raml to swagger converter" shows a number of potential options for you to assess.

    Given that RAML is not the strategic future choice for us, and there are options available for conversion to swagger 2.0 for the near term, this RFE is correspondingly being rejected at this time.

    Please feel to raise an RFE for OAS 3.0 if you feel that you would need it in future, given the convergence of RAML and Swagger stated above.