Important: It is required that you have Release Control installed in order to use the request collection widget. 

To implement the request widget in your application:

1. Download request_widget_files_ver_1.0.zip.
2. Open the application in Serena Composer.
3. Under Extensions/Web Services, import scriptRunnerService.wsdl file found in the zip.
4. Under Extensions/Form Extensions, import Request Collection Widget.cfx.
5. In the primary table, add a numeric field to store the request collection id. This field will be referred to as RequestCollectionId field in these instructions.
   
6. Create a custom state form to display the widget:
   1. Add the RequestCollectionId  field to the form.
   2. Drag on widget.
   3. On the parameters tab:
      • Map the request collection id parameter to your RequestCollectionId  field.
      • Set the mode as view.
        
        
   4. Add a form action to load the widget. This can occur when the form loads. Here is an example: 
      
      
7. Create a custom transition form which will be used to modify the request collection:
   1. Add the RequestCollectionId  field to the form.
   2. Drag on the widget.
   3. On the parameters tab:
      1. Map the request collection id parameter to your RequestCollectionId  field
      2. Set the mode as edit.
   4.  Add a form action to load the widget. 
   5. Optional: You can use a form action to check to see if the request collection has been edited (requests deleted or added) using the "RequestWidget has been edited" condition. For example, the following form action will add a note to the System Log field when the request widget has been modified. If the collection was not modified, the transition will simply be canceled.
      
8. On a transition, add an action to call the webservice to create the request collection. Map it to the createRequestCollection.groovy script. 
   1. Select the transition and choose to Call a Webservice after the transition occurs. 
   2. On data mapping, enter the following for inputs:
      
      Important: If you are creating the request collection on submit, you cannot map stringParam0 to the item id or Context:Item ID values since they do not yet exist. 
   3. Enter the following for outputs. 
      
9. Deploy the app, ensuring that the correct endpoint is set for your server, for example: http://servername:8085/rlc/scriptRunnerService.

If you have configured request providers, such as the SBM Provider or Dimensions Provider included with Serena Release Control 6.0, you will be able to relate requests to this item.