Creating or Editing a Partner

This topic describes how to create or edit a partner. The partner configuration describes and classifies the partner, sets the non-repudiation of origin period, configures certificates for the partner, and provides contact information.

When you first create a partner, Microsoft BizTalk Accelerator for RosettaNet (BTARN) creates two send ports to be used by that partner, one asynchronous and one synchronous. These send ports are named <partner name>.Async send port and <partner name>.Sync send port. BTARN automatically enlists and starts these send ports based upon the partner agreement. You can view these ports in the BizTalk Administration Console.

Partner settings are as shown in the following table, arranged by tab. For instructions about how to create and edit a partner, see the procedures after the table.

Tab Setting Usage
General Name The name for the trading partner.

Required field.

Maximum length: 255
General GBI The Global Business Identifier for the partner. This must be nine digits long, and must correspond to the DUNS number.

Required field.
General Description A description that identifies the partner.
General Hold until The date on which BTARN will submit a message to the MessagesFromLOB table. BTARN will not deliver this message until the Hold until date. Partners must agree on this date, based on when the receiving partner will be ready to receive the message. This setting may be useful if a partner will not be available to process messages, for example, during a holiday.

The default value is the current date.
General Partner classification The type of the partner organization.

Can be Carrier (the default), Distributor, End User, End User Government, Financier, Manufacturer, Retailer, or Shopper.

BTARN includes the value of this field in the Service header.

You can enter another value for the partner classification in the service header of a message, overriding this property, by entering a PPCC custom property in the Custom Properties tab of the agreement. For more information, see Creating or Editing an Agreement.
General Non-Repudiation of Origin The number of days BTARN will hold the wire format of a message in the MessageStorageIn or MessageStorageOut database for non-repudiation (to prove legally that it has received it). BTARN will stamp this date on each incoming or outgoing message.

The default value is 2485 days.

However, BTARN will not delete a message from the database upon expiration of this period. If you want to delete these messages, develop an SQL script to delete old messages based on this date/time stamp.
General

(Public key certificates area)
Signature The public key certificate that BTARN will use to verify the partner's signature on an incoming message. This certificate must be stored in the Other People certificate store in the Certificate (Local Computer) node in the BTARN Management Console.

The default value is <none>.
General

(Public key certificates area)
Encryption The public-key encryption certificate that BTARN will use to encrypt outgoing messages to a partner. This certificate must be stored in the Other People certificate store in the Certificate (Local Computer) node in the BTARN Management Console.

The default value is <none>.
Contact Properties Contact name The name of the contact at the partner.

Required field.
Contact Properties E-mail address The e-mail address of the contact at the partner.

Required field.
Contact Properties Telephone number The telephone number for the contact at the partner.

Required field.
Contact Properties Fax number The fax number for the contact at the partner.

Required field.
Contact Properties Supply chain code The supply chain code for the partner. For example, "Information Technology" or "Electronic Components".

Required field.

To create a partner

  1. Click Start, point to All Programs, point to MicrosoftBizTalk Accelerator for RosettaNet, and then click BizTalk Accelerator for RosettaNetManagement Console.

  2. In the BTARN Management Console, expand BizTalk Accelerator for RosettaNet.

  3. Right-click Partners, point to New, and then click Partner.

  4. In the New Partner Properties dialog box, on the General and Contact Properties tabs, type values for the settings. For information about these settings, see the preceding table.

  5. Click OK.

To edit a partner

  1. Click Start, point to All Programs, point to MicrosoftBizTalk Accelerator for RosettaNet, and then click BizTalk Accelerator for RosettaNet Management Console.

  2. In the BTARN Management Console, expand BizTalk Accelerator for RosettaNet, and then click Partners.

  3. Right-click the partner that you want to edit, and then click Properties.

  4. In the <partner> Properties dialog box, on the General and Contact Properties tabs, change settings as needed. For information about these settings, see the preceding table.

  5. Click OK.

See Also

Manage configuration, certificates, databases, and security
Administering the BTARN Configuration