Generate Project Wizard

Generate Project Wizard guides you through a wizard driven, drag and drop process to build an integration solution - whether it is API based, scheduler based or otherwise.

Before proceeding further, please familiarize yourself with Source, Processor and Application Patterns. You would need to seed at least one pattern of each type into your Exchange before you can follow along.

Steps to create the project using the Generate Project wizard are:

  1. Select the Generate Project option from the IZ Accelerator menu to launch the wizard. generate project select menu 63f28

  2. Enter the project name, system type, select whether you would like to start with a project template or start from scratch in the Basic details section of the wizard. Click next after completing the fields. generate project project details 0bcee

    The only difference between selecting a template and proceeding without a template will be the pre-filled flows and patterns in the APIs & Patterns wizard step. Please refer to Generate Template topic for more details on creation of templates.

  3. Source patterns seeded in Exchange should be visible in the APIs & Patterns wizard step. Drag and drop a source pattern (in this example RAML API source pattern) to the source section of a flow as shown below. generate project add source c1f98

    If you do not see any source patterns, it most likely means either the user doesn’t have access to query exchange assets or there are no source patterns defined in the exchange. Please refer to Pattern Generator section to create a new pattern or Seeding Patterns section to seed patterns from Integral Zone to use as starting point.

  4. Click on edit icon on the source pattern to customize the pattern further. generate project edit source b678f

    Depending on the type of source pattern, you might not need to edit the pattern further. This step is needed only for advanced patterns which take user input and configuration to work further.

  5. Search for the API you would like to implement in the source section. Select the API checkbox and click the button to select the API and return to the wizard. generate project select api 2f853

  6. Depending on the type of source pattern, additional changes might be done to the processor section of the flows. In this example, once the API has been selected, the RAML will be parsed and all the different resources of the API will be added to the processor as shown below. generate project default routes 28bf0

  7. If you do not select any specific route, any processor pattern added to the processor section of the flow will apply to all resources. If you would like apply different logic to different resources, add additional resources as required by clicking "Add Processor" button and configure it further as shown below. generate project processor patterns 20dde

  8. After making changes to the flow, you can click the "Validate Flow" button to validate the configured flows. In case of errors, the wizard shows the error message above the pattern with a clear description. generate project validate error 60c5f

  9. You can fix the configuration errors (in this example there were more than one processor with the same name), you can validate the flow again. You won’t be able to proceed to the next step till the interface flows are valid. generate project validate success 79e52

  10. You can add optional application patterns to the interface design to enhance the capabilities of the integration solution. You can see a couple of application patterns added to the integration flow below. Once you are happy with interface definition, please click "Next". generate project application properties 2fd8a

  11. Options for saving the generated project will be shown in Generate section of the wizard. By default Download Local option will be selected. generate project generate project loal db30c

  12. If you click "Generate Project" button, the project will get generated based on the selected setting. In the example below, the project will be generated as a zip file and will be downloaded by the browser. generate project download project 06680

  13. If you select other option (like Bitbucket), additional configuration options will be required to be provided. Based on information provided, different options like Repository Selection and Branch Selection will need to be performed. generate project bitbucket save 8d88f

  14. If "Generate Project" operation is performed with valid Bitbucket settings, the generated project code will be committed directly into Bitbucket with initial commit message from the IZ Accelerator. generate project bitbucket commit ecb4b

See also