{"type":"doc","content":[{"type":"paragraph","content":[{"text":"This section describes the Workflow Bridge agents. The agents are used for fast collection and forwarding of data between workflows. The agents can be part of both batch and real-time workflows. The Workflow Bridge forwarding agent is listed among the processing agents in Desktop while the Workflow Bridge collection agent is listed among the collection agents. ","type":"text"}]},{"type":"paragraph","content":[{"text":"The Workflow Bridge agents act as a bridge for communication between real-time workflows, or between a batch and a real-time workflow, within the same ","type":"text"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"b21f8a3c-c991-4f25-a077-aa3d680a68dd","collection":"contentId-23135018","height":"12"}}},{"text":" system.","type":"text"}]},{"type":"paragraph","content":[{"text":"The Workflow Bridge agents do not use any storage server to manage the data. Data is instead stored in memory cache when executing on the same EC, or streamed directly from one agent to another, over TCP/IP, when executing on different ECs. This provides efficient transfer of data, especially from batch to real-time workflows.","type":"text"}]},{"type":"paragraph","content":[{"text":"The forwarding and collection workflows communicate by using a dedicated set of UDRs:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data is sent from a forwarding workflow to a collection workflow in a ","type":"text"},{"text":"ConsumeCycleUDR","type":"text","marks":[{"type":"code"}]},{"text":". Refer to ","type":"text"},{"text":"ConsumeCycleUDR","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"linkType":"page","contentTitle":"ConsumeCycleUDR","versionAtSave":"7"},"href":"https://infozone.atlassian.net/wiki/spaces/MD91/pages/23144283"}}]},{"text":" for further information.","type":"text"}]},{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"ConsumeCycleUDR","type":"text","marks":[{"type":"code"}]},{"text":" there are also fields that enable broadcasting and load balancing. Broadcasting, i e sending the same UDR to several different workflow instances in the collecting workflow, can be made to a configurable number of workflow instances. Load balancing enables you to configure to which workflow instance each UDR should be sent, based on criteria of your choice.","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"Note!

If any other UDR than ConsumeCycleUDR is routed to the forwarding agent, the bridge will only support one collector, which means that it will not be possible to broadcast or load balance.

","block-inline":true,"nestedContent":{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Note!","type":"text"}]},{"type":"paragraph","content":[{"text":"If any other UDR than ","type":"text"},{"text":"ConsumeCycleUDR","type":"text","marks":[{"type":"code"}]},{"text":" is routed to the forwarding agent, the bridge will only support one collector, which means that it will not be possible to broadcast or load balance.","type":"text"}]}]}],"version":1},"reason":"A note macro in a list item can't be created or edited in the new editor."}}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Each state of a forwarding workflow is sent in a separate ","type":"text"},{"text":"WorkflowState","type":"text","marks":[{"type":"code"}]},{"text":" UDR to the real-time collection agent. The batch forwarding workflow sends all states from initialize to deinitialize, while a real-time forwarding workflow only sends the initialize state. The deinitialize state is sent by the real-time collection workflow if the connection goes down between the collection workflow and a forwarding workflow (batch or real-time).","type":"text"}]},{"type":"paragraph","content":[{"text":"For more information regarding the workflow execution states, see ","type":"text"},{"text":"Workflow Monitor","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"linkType":"page","contentTitle":"Workflow Monitor","versionAtSave":"2"},"href":"https://infozone.atlassian.net/wiki/spaces/MD91/pages/23136928"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"User defined action UDRs can be sent from the collection workflow to communicate actions back to the forwarding workflow. For further information, see ","type":"text"},{"text":"User Defined Action UDRs","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"linkType":"page","contentTitle":"User Defined Action UDRs","versionAtSave":"5"},"href":"https://infozone.atlassian.net/wiki/spaces/MD91/pages/23372609"}}]},{"text":".","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"In the collecting workflow, the APL has to be configured to communicate responses for the UDRs to the Workflow Bridge collection agent. When both the forwarding and collecting workflows are real-time workflows, only responses for ","type":"text"},{"text":"WorkflowState","type":"text","marks":[{"type":"code"}]},{"text":" UDRs have to be configured. However, when the forwarding workflow is a batch workflow, responses for ","type":"text"},{"text":"ConsumeCycle","type":"text","marks":[{"type":"code"}]},{"text":" UDRs have to be configured as well.","type":"text"}]},{"type":"paragraph","content":[{"text":"Responses for ","type":"text"},{"text":"WorkflowState","type":"text","marks":[{"type":"code"}]},{"text":" UDRs are always communicated back to the forwarding workflow. If you want to communicate responses for ","type":"text"},{"text":"ConsumeCycle","type":"text","marks":[{"type":"code"}]},{"text":" UDRs back to the forwarding workflow as well, the ","type":"text"},{"text":"Send Reply","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"Over Bridge","type":"text","marks":[{"type":"strong"}]},{"text":" option has to be selected in the Workflow Bridge profile, see ","type":"text"},{"text":"Workflow Bridge Profile","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"linkType":"page","contentTitle":"Workflow Bridge Profile","versionAtSave":"3"},"href":"https://infozone.atlassian.net/wiki/spaces/MD91/pages/23372525"}}]},{"text":" for further information.","type":"text"}]},{"type":"paragraph","content":[{"text":"Workflow Bridge has two essential features; Session Context and Bulk Forwarding.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"SessionContext"},"legacyAnchorId":{"value":"WorkflowBridgeAgents-SessionContext"},"_parentId":{"value":"23144092"}},"macroMetadata":{"macroId":{"value":"6740df83-3606-444d-96d6-0baffb3830c8"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Session Context","type":"text"}]},{"type":"paragraph","content":[{"text":"By using a session context, arbitrary data can be stored and managed by the Workflow Bridge real-time collection agent during the whole transaction. This is achieved by populating the SessionContext field in the ","type":"text"},{"text":"InitializeCycle","type":"text","marks":[{"type":"code"}]},{"text":"UDR or ","type":"text"},{"text":"BeginBatchCycleUDR","type":"text","marks":[{"type":"code"}]},{"text":" with the data, which is then included in all subsequent UDRs after \"initialize\" or \"begin batch\". The field is cleared at \"deinitialize\", when the connection to the forwarding workflow goes down.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Note!","type":"text"}]},{"type":"paragraph","content":[{"text":"The SessionContext field is only writable in the ","type":"text"},{"text":"InitializeCycleUDR","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"BeginBatchUDR","type":"text","marks":[{"type":"code"}]},{"text":" and the session context is only available in a collection workflow.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Refer to ","type":"text"},{"text":"Workflow Bridge UDR Types","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"linkType":"page","contentTitle":"Workflow Bridge UDR Types","versionAtSave":"3"},"href":"https://infozone.atlassian.net/wiki/spaces/MD91/pages/23144265"}}]},{"text":" for more information about the Workflow Bridge UDR types.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"BulkForwardingofData"},"legacyAnchorId":{"value":"WorkflowBridgeAgents-BulkForwardingofData"},"_parentId":{"value":"23144092"}},"macroMetadata":{"macroId":{"value":"b15ecc16-e252-40af-855b-025691b23b78"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Bulk Forwarding of Data","type":"text"}]},{"type":"paragraph","content":[{"text":"To enhance performance, it is possible to collect and send data in a bulk from the forwarding agent. When the data bulk has been received by the Workflow Bridge real-time collection agent, it is unpacked and forwarded as separate UDRs by the agent.","type":"text"}]},{"type":"paragraph","content":[{"text":"The bulk is created by the Workflow Bridge forwarding agent after a configured number of UDRs has been reached, or after a configured timeout. This is specified in the Workflow Bridge profile, see ","type":"text"},{"text":"Workflow Bridge Profile","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"linkType":"page","contentTitle":"Workflow Bridge Profile","versionAtSave":"3"},"href":"https://infozone.atlassian.net/wiki/spaces/MD91/pages/23372525"}}]},{"text":" for more information.","type":"text"}]},{"type":"paragraph","content":[{"text":"Bulking of data can only be performed for data being sent in the ","type":"text"},{"text":"ConsumeCycle","type":"text","marks":[{"type":"code"}]},{"text":"UDR and not for the states that are sent in the state-specific UDRs.","type":"text"}]},{"type":"paragraph","content":[{"text":"Bulk forwarding is not performed when the Workflow Bridge agents are executing on the same EC.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Transaction Safety","type":"text"}]},{"type":"paragraph","content":[{"text":"The Workflow Bridge collection workflow is a real-time workflow and as such, the transaction safety will have to be handled with APL code. The forwarding workflow execution states are transferred as Workflow State UDRs from the Workflow Bridge forwarding Agent, which enables the collection workflow to take different actions depending on the execution state of the forwarding workflow.","type":"text"}]},{"type":"paragraph","content":[{"text":"The Workflow Bridge collection agent requires that all Workflow State UDRs are returned before the next Workflow State UDR is forwarded into the workflow. The only exception to this is that the collection agent accepts to have several ","type":"text"},{"text":"ConsumeCycle","type":"text","marks":[{"type":"code"}]},{"text":"UDRs outstanding at the same time. However, all ","type":"text"},{"text":"ConsumeCycleUDR","type":"text","marks":[{"type":"code"}]},{"text":"s must have been returned before the next type of Workflow State UDRs is forwarded. If the forwarding workflow is a batch workflow, this means that all ","type":"text"},{"text":"ConsumeCycleUDR","type":"text","marks":[{"type":"code"}]},{"text":"s must be returned before the ","type":"text"},{"text":"DrainCycleUDR","type":"text","marks":[{"type":"code"}]},{"text":" is forwarded into the workflow.","type":"text"}]},{"type":"paragraph","content":[{"text":"For more information on the workflow execution states, see ","type":"text"},{"text":"Workflow Monitor","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"linkType":"page","contentTitle":"Workflow Monitor","versionAtSave":"2"},"href":"https://infozone.atlassian.net/wiki/spaces/MD91/pages/23136928"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Broadcasting and Load Balancing","type":"text"}]},{"type":"paragraph","content":[{"text":"The same UDR can be sent to multiple workflow instances in the collection workflow using broadcasting. If the forwarding workflow has many workflow instances as well, all the UDRs sent from these instances can also be sent to all the instances in the collecting workflow.","type":"text"}]},{"type":"paragraph","content":[{"text":"Load balancing can be used to direct different UDRs to different workflow instances","type":"text"},{"text":" ","type":"text"},{"text":"using a static load-balancing strategy","type":"text"},{"text":" ","type":"text"},{"text":"(see","type":"text"},{"text":" ","type":"text"},{"text":"Workflow Bridge Profile Configuration General Tab","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"linkType":"page","contentTitle":"Workflow Bridge Profile Configuration General Tab","versionAtSave":"9"},"href":"https://infozone.atlassian.net/wiki/spaces/MD91/pages/23209440"}}]},{"text":"). Each workflow instance in the collection workflow is assigned a LoadId by adding this field to the workflow instance table in the Workflow Properties and then entering specific Ids for each instance.","type":"text"},{"text":" ","type":"text"},{"text":"In the APL code, it is possible to determine specific UDRs that can have the forwarding workflow routed to a designated LoadId.","type":"text"}]},{"type":"paragraph","content":[{"text":"You configure the number of workflow instances you want to send UDRs to in the Workflow Bridge profile.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Transport","type":"text"}]},{"type":"paragraph","content":[{"text":"You have the option to select the best transport for your needs. See also the ","type":"text"},{"text":"Transport","type":"text","marks":[{"type":"strong"}]},{"text":" setting in ","type":"text"},{"text":"Workflow Bridge Profile Configuration General Tab","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"linkType":"page","contentTitle":"Workflow Bridge Profile Configuration General Tab","versionAtSave":"9"},"href":"https://infozone.atlassian.net/wiki/spaces/MD91/pages/23209440"}}]},{"text":".","type":"text"}]},{"type":"table","attrs":{"__autoSize":true},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Option","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Transport","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Select the transport protocol that you prefer for the best performance.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"scroll-ignore","parameters":{"macroParams":{"scroll-viewport":{"value":"false"},"scroll-pdf":{"value":"true"},"_parentId":{"value":"23144092"},"scroll-office":{"value":"false"},"scroll-chm":{"value":"true"},"scroll-docbook":{"value":"true"},"scroll-eclipsehelp":{"value":"true"},"scroll-epub":{"value":"true"},"scroll-html":{"value":"false"}},"macroMetadata":{"macroId":{"value":"e8b2554d-fad5-49a8-8dd5-74b1b6b444f2"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"icon","data":{"url":"https://scroll-exporter-extensions.de.exporter.k15t.app/static/assets/images/macro-icons/scroll-ignore.svg"}}],"title":"Scroll Ignore"}}},"content":[{"type":"paragraph","content":[{"text":"The section contains the following subsections:","type":"text"}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"children","parameters":{"macroParams":{"_parentId":{"value":"23144092"}},"macroMetadata":{"macroId":{"value":"d62cc125-aeaa-4d5a-aebb-4eb0e8d36cd8"},"schemaVersion":{"value":"2"},"title":"Child pages (Children Display)"}}}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported