This function identifies a partner Channel that has an additional ID (see Channels) 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 a 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 a set empty flag.) |
customerid | 4711 | accountno | smtp | (Empty string with a 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).