Communication Channel
Configuration
Create a communication channel and then choose the Parameters tab.

It is recommended to use the channel templates provided whenever possible and configure communication channels only when really needed.
Configure the following values:
Label |
Value |
Adapter Type |
RNIF |
Sender or Receiver |
Choose Receiver |
Transport Protocol |
HTTP or HTTPs |
Message Protocol |
RNIF 2.0 |
Adapter Engine |
Choose the Adapter Engine on the Integration Server or select a non-central Adapter Engine. |
Choose Single-Action Asynchronous Request.
Field |
Value |
Agency |
RosettaNet (default – refers to the global administering authority code) |
Version |
2.0 (default – standard version identifier). The version identifier is different from the PIP version that is listed in the PIP dictionary on the RosettaNet website. |
Field |
Value |
Current |
<locationID> of the XI party. Example: New York |
Partner |
<locationID> of the configured partner. Example: Frankfurt |
Field |
Value |
Number of Retries |
Default value available. This value is taken from the Retry Count column from the PIP specification’s Business Activity Performance Controls table.
|
Time to Acknowledge Receipt |
Time interval between subsequent retries of Business Action messages in case an acknowledgement is not received from the partner. This attribute is present only in the receiver channel. This value must be taken from the Time to Acknowledge column from the PIP specification’s Business Activity Performance Controls table. |
Field |
Action |
RNIF Protocol Field |
Code |
PIP standard code ex. 3A7 |
ServiceHeader– ProcessControl/ ProcessIdentity/ GlobalProcessIndicatorCode |
Version |
PIP version. The PIP version identifier is found on the front page of the PIP specification and is shorter than the PIP Version. Example: V02.02 is the version identifier while V02.02.01 is the PIP version. |
ServiceHeader– ProcessControl/ ProcessIdentity/ VersionIdentifier |
Business Transaction Activity |
Value must be taken from the Activity Name column of the PIP specification’s Business Activity Descriptions table. |
ServiceHeader-ProcessControl/ TransactionControl/ TransactionIdentity/ GlobalTransactionCode |
Requesting Action |
Value must be taken from the Business Action in FSV column of the PIP specification's Business Action - Business Document Mapping table. |
ServiceHeader– ProcessControl/ TransactionControl/ ActionControl/ ActionIdentity/ GlobalBusinessActionCode |
Current Role |
Value must be taken from the corresponding FromRole element (or ToRole element, as the case may be) in the PIP specification corresponding to the currently executing PIP, Activity and Action. |
ServiceHeader– ProcessControl/ TransactionControl/ PartnerRoleRoute/ fromRole. PartnerRoleDescription/ GlobalPartnerRole ClassificationCode |
Partner Role |
Value must be taken from the corresponding ToRole element (or FromRole element, as the case may be) in the PIP specification corresponding to the currently executing PIP, Activity and Action. |
ServiceHeader– ProcessControl/ TransactionControl/ PartnerRoleRoute/ toRole. PartnerRoleDescription/ GlobalPartnerRole ClassificationCode |
Current Business Service Code |
Value must be taken from the corresponding FromService element (or ToService element, as the case may be) in the PIP specification corresponding to the currently executing PIP, Activity and Action |
ServiceHeader– ProcessControl/ TransactionControl/ ActionControl/ PartnerRoute/ fromPartner/ PartnerDescription/ BusinessDescription/ GlobalPartner ClassificationCode |
Partner Business Service Code |
Value must be taken the corresponding ToService element (or FromService element, as the case may be) in the PIP specification corresponding to the currently executing PIP, Activity and Action. |
ServiceHeader– ProcessControl/ TransactionControl/ ActionControl/ PartnerRoute/ toPartner. PartnerDescription/ BusinessDescription/ GlobalPartner ClassificationCode |
Document Schema Specification |
Enter the value of the DTD for the corresponding action from the XI Integration Builder. Configure this field only for the receiver channel. |
URI reference to external DTD as system identifier, formed in DOCTYPE - XML processing instruction |
Field |
Value |
Sign Action Message |
Select or deselect Sign Action Message. Your selection will determine whether the action message is required to be signed before sending. |
Sign Signal Message |
Select or deselect Sign Signal Message. Your selection will determine whether the signal message is required to be signed before receiving. |
Non-Repudiation of Origin and Content |
Check or uncheck depending on the standard. |
Non-Repudiation of Receipt Acknowledgement |
Check or uncheck depending on the standard. |
Value |
Description |
URL |
Enter the partner address to which the RosettaNet Signal Message will be sent by the adapter. |
Persist Duration |
Enter the duration during which the message will be persisted on the messaging system store. The default value can be chosen. |
This depends on whether you use HTTP or HTTPs as the transport protocol.
If you choose HTTP:
Value |
Description |
Client Authentication Required |
Check this value |
User name |
Provided by the partner |
Password |
Provided by the partner |
If you choose HTTPs:
Value |
Description |
Authentication Mode |
Username/Password or Certificate Logon If you choose Certificate Logon, specify the values for Keystore Entry and Keystore View. |