Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

Stream represents the flow of data in a process flow. Multiple streams are used when the output of an activity needs to be sent to two or more activities in a process flow.

Steps to create multiple streams for an activity

  1. Click the activity in Canvas area from which multiple streams are to be generated and select View Properties  icon in Context Pad to display the Activity Properties panel.

  2. In the Activity Properties panel, go to STREAMS > Output. The existing stream is displayed.



  3. If you want to delete the existing stream, click Remove  button. Click Yes, when prompted to confirm.

  4. To create a new stream, enter the name for the Stream in the Name field and select the consumer from Consumer drop-down list.



    Click Visible  toggle button to display the stream in canvas area.

  5. Click Add button and name of the Stream is displayed in the Streams list.


    If you are creating an error stream, click Error toggle button .
  6. Repeat steps 4 and 5 to create another stream.
  7. Click on canvas area to return to the Canvas Area. The created streams are displayed in the canvas area by data objects Artifact.



 

The Artifacts are only to show the flow of streams therefore it is necessary to add the activities with appropriate flows. If user deletes a stream from the Multiple Stream Dialog box, then the corresponding Artifacts are also deleted. If an Artifact representing a stream is deleted then the stream is also deleted. Web Process Designer confirm with users to delete the underlying stream. 
 

To hide the Artifacts, click data object Artifact and select Hide Stream option.


The Multiple Stream feature can be used in three scenarios: 

Creating more than one Stream

When data from one stream is sent to more than one activity, you can create more than one stream. However, more than one stream can be created only with the selected activities. These activities are Mapping Transformation, Custom Plugin, Repeater Service, XML Validator and Decoder.

 

 

A Mapping activity does not always generate multiple streams. It is based on the schemas used in the mapping activity.


Creating Error Stream
If a source or target schema is not compliant with the corresponding source or target data, then the process flow execution will generate error records. Sometimes these error records are useful for users and user may want to store them for debugging. In such a case, error stream is created along with data stream. This error stream can be mapped to some other activity for further processing. For example, user may want to store the error records in a File Target. To specify a stream as an error stream, check the Error Stream checkbox in the Multiple Stream Dialog Box. Error stream can be generated for Schema, Database source, Database target, Advanced Database target and XML Validator only.

Creating Default Stream
Sometimes an action, for example the Delay action, is used between two activities. In such type of situation data from the first activity does not pass to another activity because the action Delay does not consume data from the first activity and hence cannot pass it to another. To avoid this condition default stream is used.
 

Steps to create a default stream

  1. Right click the first activity and select Multiple Stream. The Multiple Stream dialog box appears.
  2. Delete the existing stream.
  3. Select another activity from the Activities drop-down list.
  4. Click Default Stream (  ) button and then click Map button.

  5. Ensure that the Explicit Stream checkbox is checked.



  6. Click Done button to save the stream and return to Process Designer screen.

     

    If you map a stream from a source activity to multiple activities (for example, Schema or Target activities) using the Multiple Stream option, only one target activity can get the stream from the source activity. The other target activities do not get the stream from the source activity and thus get aborted. This in turn aborts the process flow. It will only work if a gateway element is used in a process flow. This element will include a condition, on the basis of which one target activity can be selected at runtime. Another way is to use a Repeater Node to pass the stream to more than one activity. For details on using a Repeater Node, refer to the Using Repeater Node section.

Stream represents the flow of data in a process flow. Multiple streams are used when the output of an activity needs to be sent to two or more activities in a process flow.

Steps to create multiple streams for an activity

  1. Right-click the activity in the Graph Canvas from which multiple streams are to be generated and then select Multiple Streams. The Multiple Stream Dialog screen is displayed.



  2. In the Stream Information Table, the existing stream is displayed. If you want to delete the existing stream, click on the stream to select it and then click Delete Stream (  ) button. The selected stream is deleted.

  3. To create a new stream, enter the name for the Stream in the Stream Name field and then click Add Stream button. The name of the added Stream is displayed in the Streams drop-down list.



  4. The Activity which will consume the stream currently selected in the Streams drop-down list is already displayed, however to change it, select the activity from the Activities drop-down list, and then click Map button. The mapped stream and the activity are displayed in the Stream Information Table.
  5. Ensure that the Explicit Stream checkbox is selected.



     

    If you are creating an error stream select the Error Stream checkbox.

  6. Repeat steps 4 to 6 to create another stream.
  7. Click Done to return to the Graph Canvas. The created streams are displayed in the Graph canvas by data objects Artifact.



 

The Artifacts are only to show the flow of streams therefore it is necessary to add the activities with appropriate flows. If user deletes a stream from the Multiple Stream Dialog box, then the corresponding Artifacts are also deleted. If an Artifact representing a stream is deleted then the stream is also deleted. Process Designer asks user if he/she wants to delete the underlying stream. 
 

To hide the Artifacts, click View in the menu bar and deselect the Show Artifacts and Associations option.


The Multiple Stream feature can be used in three scenarios: 

Creating more than one Stream

When data from one stream is sent to more than one activity, you can create more than one stream. However, more than one stream can be created only with the selected activities. These activities are Mapping Transformation, Custom Plugin, Repeater Service, XML Validator and Decoder.

 

 

A Mapping activity does not always generate multiple streams. It is based on the schemas used in the mapping activity.


Creating Error Stream
If a source or target schema is not compliant with the corresponding source or target data, then the process flow execution will generate error records. Sometimes these error records are useful for users and user may want to store them for debugging. In such a case, error stream is created along with data stream. This error stream can be mapped to some other activity for further processing. For example, user may want to store the error records in a File Target. To specify a stream as an error stream, check the Error Stream checkbox in the Multiple Stream Dialog Box. Error stream can be generated for Schema, Database source, Database target, Advanced Database target and XML Validator only.

Creating Default Stream
Sometimes an action, for example the Delay action, is used between two activities. In such type of situation data from the first activity does not pass to another activity because the action Delay does not consume data from the first activity and hence cannot pass it to another. To avoid this condition default stream is used.
 

Steps to create a default stream

  1. Right click the first activity and select Multiple Stream. The Multiple Stream dialog box appears.
  2. Delete the existing stream.
  3. Select another activity from the Activities drop-down list.
  4. Click Default Stream (  ) button and then click Map button.

  5. Ensure that the Explicit Stream checkbox is checked.



  6. Click Done button to save the stream and return to Process Designer screen.

     

    If you map a stream from a source activity to multiple activities (for example, Schema or Target activities) using the Multiple Stream option, only one target activity can get the stream from the source activity. The other target activities do not get the stream from the source activity and thus get aborted. This in turn aborts the process flow. It will only work if a gateway element is used in a process flow. This element will include a condition, on the basis of which one target activity can be selected at runtime. Another way is to use a Repeater Node to pass the stream to more than one activity. For details on using a Repeater Node, refer to the Using Repeater Node section.

  • No labels