Introducing the all-new TIBCO Community site!

For current users, please click "Sign In" to reset your password and access the enhanced features. If you're a first-time visitor, we extend a warm welcome—click "Sign Up" to become a part of the TIBCO Community!

If you're seeking alternative community sites, explore ibi, Jaspersoft, and Spotfire.

Jump to content
  • BW6.X - BWCE - How to manage a Swagger file update in BusinessWorks 6.X and BusinessWorks Container Edition

    BusinessWorks 6.X and BusinessWorks Container Edition conveniently allow the creation of Processes exposing or invoking REST APIs using Swagger files previously created, this approach is usually called the design first approach.

    But once Processes have been implemented how to manage the case where a new version of the Swagger file is delivered and has to be taken into account ?

    This can be done using the approach described in this article.

    Uploading the new Swagger file

    It is recommended to first make sure the latest version of the application code can be recovered in case of problems.

    Then import the updated Swagger file, the file name of the updated Swagger should be the exact same file name as in the original import.


    Finally confirm that you want to overwrite the existing file.

    Updating the XML Schemas

    Refresh the XML Schemas generated when the Service or Reference were initially created in the Process by Right clicking on the Swagger file and selecting ‘Refactor -> Generate XSD Schema …’


    In the next panel click finish


    Then it is recommended to do a project clean

    Updating the processes

    You now have to update the impacted Processes to take into account the changes, this mostly consist in:

    . Removing mappings corresponding to fields that no longer exist

    . Creating mappings for new fields

    To speed up the work you can just check errors present in each process and fix them one by one. Remember also you can use the ‘Quick fix’ option in many cases.

    User Feedback

    Recommended Comments

    There are no comments to display.

    Create an account or sign in to comment

    You need to be a member in order to leave a comment

    Create an account

    Sign up for a new account in our community. It's easy!

    Register a new account

    Sign in

    Already have an account? Sign in here.

    Sign In Now

  • Create New...