find channel reference-value(a,b,c,[d],[e])

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

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

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

Parameter c is then used in the found partner channel to return the value of another additional ID with the name c. If nothing is found, an empty string with set Empty Flag will be returned.

Parameters


Parameter

Description

a

Additional ID 1: Name.

b

Additional ID 1: Value.

c

Additional ID 2: Name.

d

(optional) Type of partner channel to restrict the search. Default: No restriction. Note: Use the three dots to select a value.

e

(optional) true if only active partner channels should be used. Default: false.

Examples


Assume two partner channels with the following attributes (simplified).


Partner channel ID

<Partner name>:<Channel name>

Partner channel type

Active?

1

Lobster:FTP

ftp

true

2

Lobster:AS2

as2

false

The following additional IDs 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

Parameter e

Result

customerid

4711

accountno

ftp


12345

accountno

23456

customerid

as2


4712

customerid

4711

accountno

ftp

true

12345

customerid

4712

accountno

ftp

true

(Empty string with set Empty Flag.)

customerid

4711

accountno

smtp


(Empty string with set Empty Flag.)


If you use a specific channel for a partner, you can save customer-specific values in its additional IDs. If you then get a customer-specific value in your input file (say the customer ID), you can use it to determine another customer-specific value (for example, the customer's bank account number).