Create a Document Exchange Record

Edit online

About this task

To describe properties of the documents and messages passed between you and your RosettaNet trading partner, you must create a document exchange record.

To create a document exchange record:

Procedure

  1. From the Trading Partner menu, select Setup > Advanced > Document Exchange.
  2. Next to Create New Document Exchange, click Go!
  3. In the New Document Exchange: Information page, complete the following fields and click Next:
    Field
    Description
    Name
    Name for the document exchange to create for this RosettaNet trading partner. Required.
    Note: You may use part of the company name or DUNS number in this field.
    Identity
    Unique ID used when you created an identity record for this RosettaNet trading partner. Required.
  4. In the Retry Settings page, complete the following fields and click Next:
    Field
    Description
    Number of Retries
    Number of times that the Sterling B2B Integrator tries to contact this RosettaNet trading partner before timing out. Type the value 3. Required.
    Retry Interval (sec)
    Number of seconds that the Sterling B2B Integrator waits before trying again to contact this RosettaNet trading partner after the previous attempt timed out. Type the value 3000. Required.
    Persist Duration (sec)
    Number of seconds that a message received is kept before being passed to the integration engine. Type the value 10000. Required.
  5. In the Enveloping Properties page, complete the following field and click Next:
    Field
    Description
    Protocol
    The security protocol to be used. If using digital signatures to exchange RosettaNet messages, select SMIME from this field (if not exchanging RosettaNet messages, you would select None). Required for RosettaNet.
  6. Skip this step if you are not using digital signatures to exchange RosettaNet messages. Otherwise, in the Security page, complete the following fields and click Next:
    Field
    Description
    Encryption Algorithm
    Algorithm used to encrypt outbound RNIF v02.00 messages. Not used for inbound and RNIF v1.1. Required if this document exchange is for the trading partner running the Sterling B2B Integrator and sending encrypted RNIF v02.00 messages to a trading partner. Optional.

    Supported algorithms are:

    • Triple DES 168 CBC with PKCS5 padding
    • 56-bit DES CBC with PKCS5 padding
    • 128-bit RC2 CBC with PKCS5 padding
    • 40-bit RC2 CBC with PKCS5 padding
    Signing Algorithm
    Algorithm used to sign outgoing RosettaNet messages. Required if this document exchange is for the trading partner running the Sterling B2B Integrator . Otherwise, use the default value. Optional.

    Valid values are:

    • MD5 – Message digest algorithm that verifies the integrity of data through a 128-bit message digest.
    • SHA1 – Secure hash algorithm that verifies the integrity of data through a 160-bit (20 byte) message digest. Transmission is a bit slower than MD5; however, the larger message digest size offers a more secure data transference.
    Signing Key Certificate
    Key certificate used to sign outgoing RosettaNet messages. This certificate is a system certificate created for the trading partner running the Sterling B2B Integrator and it contains a private key. Select the appropriate key certificate from this field. If this document exchange is used for a trading partner other than the one running the Sterling B2B Integrator , use the default value. Required.
    Signing User Certificate
    Trusted certificate that contains the public key used to verify incoming digital signatures from a trading partner. If using this document exchange for a trading partner other than the one running the Sterling B2B Integrator, verify that None Available is selected from this field. Otherwise, select the appropriate trusted certificate from this field. Required.
  7. Click Finish to add the document exchange record.

Results

You are now ready to create a delivery channel record.