PH49569: OPENAPIPARAM PROPERTY DEFAULTS CAUSE ERRORS IN GENERATED DOCUMENTS IN RSA 9.7.1

APAR status

• Closed as program error.

Error description

• When modeling OpenAPI3 parameters, the OpenAPIParam stereotype
  defaults to invalid values. It does not provide the ability to
  define simple (non-array) parameters.
  
  Both Path and Query parameters style property default to
  0-matrix which indicates an array is desired. This array type is
  not valid for Query parameters. There is no way to eliminate the
  style and explode fields to define a simple parameter.
  
  Below are the further points regarding this issue:
  - The OpenAPIParam was a stereotype property which was
  defaulting to "0 - matrix" and this would cause the resulting
  generated swagger to be invalid.
  - The stereotype was accessed by going to the Properties ->
  Stereotypes -> Stereotype Properties section -> Style
  - Generated .yaml file can be validated using
  https://editor.swagger.io/
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * -                                                            *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * In RSAD 971, OpenAPI param's style attribute default value   *
  * is coming as 0-matrix.                                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• OpenAPI param's style attribute default value is coming as
  0-none
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  SW ARCHITECT WI

• Fixed component ID

  5724I7001

Applicable component levels