PH47748: An array with minItems:1 and maxItems:1 does not produce expected language structures

APAR status

• Closed as documentation error.

Error description

• An array definition in Swagger that sets the minItems and
  maxItems to a value of 1 will cause the Build Toolkit
  to generate language structures for an array containing
  a single item.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of z/OS Connect V3.0 API           *
  *                 requesters                                   *
  ****************************************************************
  * PROBLEM DESCRIPTION: An array definition in Swagger that     *
  *                      sets the minItems and maxItems to a     *
  *                      value of 1 will cause the build toolkit *
  *                      to generate language structures for an  *
  *                      array containing a single item.         *
  ****************************************************************
  An array definition in Swagger that sets the minItems and
  maxItems to a value of 1 will cause the build toolkit
  to generate language structures for an array containing
  a single item.  Access to the nested item from within
  an application must  refer to the item relative to the
  wrapping array.
  

Problem conclusion

• The topic "Using the build toolkit to generate artifacts for an
  API requester" in the z/OS Connect documentation is updated to
  clarify the behaviour of array definitions where the minItems
  and maxItems properties are set to 1.
  

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

  Z/OS CONNECT EE

• Fixed component ID

  5655CE300

Applicable component levels