SetDistributionChannel

SetDistributionChannel

What to use it for

Prerequisites for usage

Essential options to set

In very rare cases a subset of documents might need Distribution Channel filtering rules that are more specific than the built-in Distribution Channel filters allow. Only in these rare cases, use SetDistributionChannel Activity as alternative Distribution Channel settings.

 Click here to expand...

With the Distribution Channel settings you can filter documents on a combination of doctype, docsubtype, format, sender, recipient, etc. In almost all cases, these options suffice, except in rare cases when documents are identical in all these properties.

Example:

Two documents are highly identical: Same doctype, same format, same sender, same recipient, etc. The difference might be that one of these was sent using a different communication module, and your business partner expects you to send a returning document to this different communication module. As the Distribution Channel settings have no option to filter on communication properties, you will need to use SetDistributionChannel.

  • Relevant Distribution Channel
  • Relevant Communication Module.

One of the options:

  • Communication module type(s)
  • Communication module configuration
  • Address

 

Options for SmartBridge 3

OptionWhat is itHow to use it
Current document

Use CurrentDocument to indicate which data you want to process with the current Activity.

This option only becomes relevant in case a preceding Activity generated new documents.

In general, leave at the default value.

  • In most cases you do not need to modify this option.

    • With the default value, the Activity will process the original document.
  • Only enter a custom alphanumeric ID when necessary to be able to process a newly generated document.

 

 Read more »

The only situation in which you might need to modify this option, is when your Workflow produces several new documents based on one incoming original document. Activities that use a single document to produce several documents:

These Activities produce several documents, and some of those might require additional, specific processing.

To be able to indicate which documents require different processing, you will need to have done the following:

  • Have SmartBridge assign an ID to the newly produced documents.
  • Within in the current Workflow, create a specific sequence of Activities for these documents.
  • Assign the documents to their sequence, by referring to their IDs.
Communication module type(s)Which types of communication modules are allowed to be used for sending.
  • Enter one or more of the following types:
    • Exite, FileSystem, Smtp, Smi, Ftp, X400, SAP, AS2ICS, Gxs, Iex, Oftp, Ism, Allegro, SapXi, AddIn
  • Separate multiple values with a comma.
  • Entries are case sensitive.

 Supports dynamic values from Macros »

Instead of using static values you can also use dynamic values.

With so called Macros you can have SmartBridge dynamically replace (part of) the value with properties extracted from a document (e.g. recipient), or with system settings (e.g. date). See the Macros for Workflows for more details and examples.

Communication module configurationThe name of a Communication Module configuration that you want to use for sending.

Enter the name of a specific, existing Communication Module configuration.

 Supports dynamic values from Macros »

Instead of using static values you can also use dynamic values.

With so called Macros you can have SmartBridge dynamically replace (part of) the value with properties extracted from a document (e.g. recipient), or with system settings (e.g. date). See the Macros for Workflows for more details and examples.

AddressSpecific address to where the document should be sent.

Enter a specific address of the recipient. The address should already be in use in one of the existing Distribution Channels.

 Supports dynamic values from Macros »

Instead of using static values you can also use dynamic values.

With so called Macros you can have SmartBridge dynamically replace (part of) the value with properties extracted from a document (e.g. recipient), or with system settings (e.g. date). See the Macros for Workflows for more details and examples.

Options for SmartBridge 2

 Click here to expand...

All options

Activity

Every Workflow Activity needs to have a name, and be configured to be either on or off. These generic properties are part of the Activity properties.

Option

What is it

How to use it

Name

 

A unique name for the Activity. Names are used for two reasons:

  • So you are able to identify the activity throughout the Workflow.
  • More importantly, a name is essential in case you want one Activity to refer to another, specific Activity.
  • Leave the generated name (default)
  • Or enter a unique name.

Description

Description of the activity, to give others some context about the Activity.

Enter an optional description.

Enabled

 


Specifies if the Activity should be enabled or not.

Disabled Activities will be skipped during Workflow execution and validation.

Select option from the dropdown:

  • True – Enables the Activity (default).
  • False – Disables the Activity.

Recommended: True

Distribution channel

OptionWhat is itHow to use it
Comm module configurationThe name of a Communication Module configuration that you want to use for sending.

Enter the name of a specific, existing Communication Module configuration.

 Supports dynamic values from Macros »

Instead of using static values you can also use dynamic values.

With so called Macros you can have SmartBridge dynamically replace (part of) the value with properties extracted from a document (e.g. recipient), or with system settings (e.g. date). See the Macros for Workflows for more details and examples.

Address

Specific address to where the document should be sent.

Enter a specific address of the recipient. The address should already be in use in one of the existing Distribution Channels.

 Supports dynamic values from Macros »

Instead of using static values you can also use dynamic values.

With so called Macros you can have SmartBridge dynamically replace (part of) the value with properties extracted from a document (e.g. recipient), or with system settings (e.g. date). See the Macros for Workflows for more details and examples.

Document identification

In case you use the Clone Activity, SmartBridge will use this property to identify cloned documents.

Option

What is it

How to use it

Document Key

Only relevant for Workflows that contain a CloneDocument Activity.

The key of the cloned document to be used for processing.

 Click here to expand...

When creating a clone of the document (using the CloneDocument activity) you need to specify whether SmartBridge should process the clone or the original. When you have specified a Document Key, SmartBridge will assign the Document Key to cloned documents. With the Document Key assigned to cloned documents, you will be able to refer to the clones for further processing.

  • Leave empty if the activity should process the original document (default).
  • Enter or assign the Clone Document Key if the activity should process a clone document.

Recommended: Leave empty when you are not using a Clone Activity.

In SmartBridge 3 this option is replaced with 'Input Options'.

 

On this page