This function returns the ID of a partner channel that has an additional ID with name a and value b.

If the optional parameter c is set, the search will be restricted to partner channels of a given type.

If d is true, the search will be restricted to active channels only.

If no fitting channel is found, an empty string with set Empty Flag will be returned.

Parameters

Parameter	Description
a	Name of the additional ID.
b	Value of the additional ID.
c	(optional) Type of the partner channel to restrict the search. Default: No restriction. Note: Use the three dots to select a value.
d	(optional) "true" if only active partner channels should be used. Default: "false".

Examples

The partner channel administration should contain two partner channels for partner Lobster with the following attributes (simplified).

Partner channel ID	<Partner name>:<Channel name>	Channel type	Active?
1	Lobster:FTP	ftp	true
2	Lobster:AS2	as2	false

The following additional references are defined.

Partner channel ID	Name of additional ID	Value of additional ID
1	customerid	4711
1	accountno	12345
2	customerid	4712
2	accountno	23456

This will lead to the following results.

Parameter a	Parameter b	Parameter c	Parameter d	Result
customerid	4711	ftp		1
accountno	23456	as2		2
customerid	4712	ftp		(Empty string with set Empty Flag.)
customerid	4713	ftp		(Empty string with set Empty Flag.)
customerid	4711	ftp	true	1
customerid	4712	as2	true	(Empty string with set Empty Flag.)

You can, for example, store the result in system variable VAR_SYS_CHANNEL_RESPONSE[1..n] (see explanation there) to exchange the channel of a Response. Note: See also VAR_SYS_TRIGGER_CHANNEL_ID for exchanging time-driven Input Agents.