find channel reference-value(a,b,c,[d],[e])
|
Group |
Different partner channels can have different values for the same additional IDs. This function uses parameters a and b to identify a partner channel that has an additional ID with name a and value b. Parameter c is then used to return the value of the (other) additional ID with the name c (of the found partner channel).
If the optional parameter d is set, the search will be restricted to partner channels of a certain type. The following types are allowed.
ftp
smtp
mail
oftp
ssh
as2
x400
sftp
ftps
If e is true, the search will be restricted to active partner channels only. If no matching partner channel is found, an empty string will be returned.
Description of Parameters
|
Parameter |
Description |
|
a |
Additional ID 1: Name. See section Additional IDs (central). |
|
b |
Additional ID 1: Value. |
|
c |
Additional ID 2: Name. |
|
d |
(optional) Type of partner channel to restrict the search. Default: No restriction. |
|
e |
(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 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 Addtional ID |
Value of Additional ID |
|
1 |
custid |
4711 |
|
1 |
account |
12345 |
|
2 |
custid |
4712 |
|
2 |
account |
23456 |
This will lead to the following results.
|
Parameter a |
Parameter b |
Parameter c |
Parameter d |
Parameter e |
Result |
|
custid |
4711 |
account |
ftp |
12345 |
|
|
acount |
23456 |
custid |
as2 |
4712 |
|
|
custid |
4711 |
account |
ftp |
true |
12345 |
|
custid |
4712 |
account |
ftp |
true |
|
|
custid |
4711 |
account |
smtp |
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).