IBM Support

JR57839: RECURSIVE PARAMETER IS GENERATED FOR AN ENUM PROPERTY IN A SWAGGER DEFINITION

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

APAR status

  • Closed as program error.

Error description

  • A business object of the Selection type is not generated when
    you're trying to discover an external service in the web Process
    Designer by using a Swagger definition file that defines an
    object with a nested enum property.
    
    PRODUCTS AFFECTED:
    IBM Business Process Manager (BPM) Advanced
    IBM BPM Standard
    IBM BPM Express
    

Local fix

  • Modify the Swagger file so that there are no nested enum types
    defined more than one level deep. Then rediscover the external
    service.
    
    For example, if you have the following YAML definition for a
    type that defines the enum property nested two levels deep
    (conditions property)
    
    definitions:
      SavedSearchDefinition:
        type: object
        properties:
          conditions:
              type: array
              items:
                type: object
                properties:
                  field:
                    type: string
                  operator:
                    type: string
                    enum:
                      - Equals
                      - NotEquals
                      - StartsWith
                      - Contains
                      - GreaterThan
                      - LessThan
                      - FullTextSearch
    
    change it to explicitly declare the Anonymous type:
    
    definitions:
      SavedSearchDefinition:
        type: object
        properties:
          conditions:
            type: array
            items:
              type: object
              $ref: '#/definitions/Condition'
      Condition:
        type: object
        properties:
          field:
            type: string
          operator:
            type: string
            enum:
              - Equals
              - NotEquals
              - StartsWith
              - Contains
              - GreaterThan
              - LessThan
              - FullTextSearch
    

Problem summary

  • The problem occurs during an intermediate step of JSON to XSD
    conversion. An enum property nested two or more levels deep
    (object > anonymous type > anonymous enum) is not extracted as a
    top-level element in the XSD and, therefore, is not discovered
    as a Selection business object. As a result, the type of the
    property that uses the enum is incorrectly set to the business
    object from the parent Anonymous type instead.
    

Problem conclusion

  • A fix will be included in IBM BPM V8.5.7 cumulative fix 2017.06
    that correctly generates the business object parameter and its
    type.
    

Temporary fix

Comments

APAR Information

  • APAR number

    JR57839

  • Reported component name

    BPM ADVANCED

  • Reported component ID

    5725C9400

  • Reported release

    857

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-04-28

  • Closed date

    2017-04-28

  • Last modified date

    2017-05-12

  • 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

    BPM ADVANCED

  • Fixed component ID

    5725C9400

Applicable component levels

  • R857 PSY

       UP

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSFTN5","label":"IBM Business Process Manager Advanced"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"857","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
12 May 2017