Create a Document Exchange Record
You can create a document exchange record from the Administration menu.
To create a document exchange record:
- From the Administration Menu, select Trading Partner > Advanced > Document Exchange.
- Under Create, next to New Document Exchange, click Go!
- Specify the
Information settings. On the Information page, complete the following fields and click Next:
Information Fields Description Name Name for the document exchange record to create for this trading profile. Required. Identity Unique ID associated with the identity that links this document exchange record to the identity record. The ID must match the Name field of the identity record. Required.
- Specify the
Retry settings. On the Retry Settings page, complete the following fields and click Next:
Retry Setting Fields Description Number of Retries Number of times that Sterling B2B Integrator tries to contact the trading partner before timing out. Zero (0) is invalid. Required. Retry Interval (sec) Number of seconds that Sterling B2B Integrator waits before trying again to contact the trading partner after the previous attempt timed out. Zero (0) is invalid. Required.Note: To avoid overwriting this Document Exchange portion of trading profile, manually set the Retry Interval field in an inherited document exchange every time you modify the same field in the base document exchange. Persist Duration (sec) Number of seconds that a message received is kept before being passed to the integration engine. Zero (0) is invalid. Required.
- Specify the
Enveloping Properties settings. On the Enveloping Properties page, complete the following field and click Next. If you select None, go to step 7:
Enveloping Properties Fields Description Protocol Used only by the EDIINT Message service. The security protocol to be used. Valid values are SMIME and NONE (default). Required.
- Specify the
Security settings. On the Security page, complete the following fields and click Next:
Security Fields Description Encryption Algorithm Used only by the EDIINT Message service if a payload type requiring encryption is selected. Identifies the encryption algorithm to be used. Required if Protocol value is anything other than None. Required.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 Used only by the EDIINT Message service to transfer data to the trading partner. Identifies the fixed-length of compressed representation of signed messages.Required. 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 that MD5; however, the larger message digest size offers a more secure data transference.
Signing Key Certificate Used only by the EDIINT Message service. The key certificate for the encryption key of the identity, if available, that is used to encrypt the message when using SMIME. Required if Message Symmetric Algorithm Strength is selected.Note: This is also the private key the EDIINT Message Service uses to sign messages it builds. A signing key certificate is not required if encryption is selected.Note: To guarantee that messages are signed, you must also select non-repudiation of origin when creating a delivery channel record. Config Multi Certs Allows you to configure multiple digital certificates against a certificate in Sterling B2B Integrator so you can automate which certificate is used based on a time window, status, and certificate order.
Note: The Config Multi Certs link appears only when multiple certificates are available.
- Select multiple certificates by name – Click the right or left arrow to move selected certificates to or from the used column.
- Specify a Certificate Order – Specifies the order the system should follow to find a certificate to use. The first certificate found in this order that has a status of "Ok" and fits within the specified time window will be used.
- Specify Status – Read-only field that documents the current status of the certificate.
- Edit Go Live Date – Default is: “Not Before Date” in the certificate. You can choose to keep the date in the certificate or change it to a date that exceeds the default. This field does not overwrite the date in the certificate, instead it specifies to the system when you would like to use the certificate. You cannot specify a date that predates the "Not Before Date" in the certificate. You also cannot specify a date for this field that exceeds the "Not After Date" in this window. Type in mm/dd/yy format.
- Edit Not After Date – This field will default to the "Not After Date" in the certificate. You can chose to keep the date or change it to a value that predates the default. This field does not overwrite the date in the certificate, instead, it specifies to the system when you would like to use the certificate. You cannot specify a date that predates the "Not Before Date" in the window. You also cannot specify a date for this field that exceeds the "Not After Date" in this window. Type in mm/dd/yy format.
Signing User Certificate Used only by the EDIINT Message service. The trusted certificate for the signing certificate of the trading partner. Required if Signing Algorithm is selected.Note: This is also a trusted certificate that the EDIINT Message service uses to verify signatures on messages it receives.
- Click Finish to add the document exchange record.
- Click Return to continue.