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
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.
- In the Activity Properties panel, go to STREAMS > Output. The existing stream is displayed.
- If you want to delete the existing stream, click Remove button. Click Yes, when prompted to confirm.
To create a new stream, enter the name for the Stream in the Name field and select the consumer from Consumer drop-down list.
Info Click Visible button to display the stream in canvas area. Click Add button and name of the Stream is displayed in the Streams list.
Info If you are creating an error stream, click toggle button Error button . - Repeat steps 4 to 6 and 5 to create another stream.
- Click Done to Click on canvas area to return to the Graph Canvas Area. The created streams are displayed in the Graph 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 asks user if he/she wants confirm with users to delete the underlying stream.
To hide the Artifacts, click View in the menu bar and deselect the Show Artifacts and Associations option.
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.
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
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
...
If you are creating an error stream select the Error Stream checkbox.
...
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.
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
...
.
...
...
Click Done button to save the stream and return to Process Designer screen.
...