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).