Bookshelf Home | Contents | Index | Search | PDF

Siebel Interactive Selling Transact Server Interface Reference > Integrating the Order Management System > Working With the DTD >

The LineItem DTD Elements

---

Elements identify the nature of the content. The LineItem DTD contains the following elements:

SiebelLineItem
User
Price
ConfigData
Item

Attributes are name-value pairs that occur inside tags after the element name. Attributes for each element are listed in the following section.

SiebelLineItem

The SiebelLineItem element is required. It contains information about a line item using the following attributes:

siebel_id
This required attribute provides a unique Siebel identifier that the Order Management System will use in its linkback URL.
created_on
This required attribute provides the date and time when the line item was created.
id
This implied element provides a third-party unique identifier.

The DTD contains the following code for this element.

<!ELEMENT SiebelLineItem (User?, Item+)>
<!—siebel_id: Siebel unique identifier —>
<!-- created_on: timestamp -->
<!-- id: 3rd party unique identifier -->
<!ATTLIST SiebelLineItem
siebel_id ID #REQUIRED
created_on #REQUIRED
id ID #IMPLIED
>

User

The User element is optional. It contains information that identifies the buyer using the following attributes:

user_id
This required attribute provides a unique user identification. This attribute matches the user id property stored in your LDAP system.
account_id
This implied attribute provides a unique account identification. This attribute matches the account id property stored in your LDAP system.
session_id
When a configuration is passed into Transact on linkback from the Order Management System, this implied attribute provides a unique session identification as a persistent parameter for the OMS.
order_id
When a configuration is passed into Transact on linkback, this implied attribute provides a unique order identification as a persistent parameter for the OMS.

The DTD contains the following code for this element.

<!-- user element is optional, contains buyer identification information -->
<!ELEMENT User>
<!ATTLIST User
user_id CDATA #REQUIRED
account_id CDATA #IMPLIED
session_id CDATA #IMPLIED
order_id CDATA #IMPLIED
>

Price

The price element is used for every item where price is defined in the data model. This element contains price information for the line item using these attributes:

type
This required attribute defines the type of price.
Valid values: "quoted" and "discount"
currency
This implied attribute defines the type of currency.

The DTD contains the following code for this element.

<!--Price type examples: quoted, list, discount -->
<!ELEMENT Price (#PCDATA)>
<!ATTLIST Price
type CDATA #REQUIRED
currency CDATA #IMPLIED

>

ConfigData

The ConfigData element is required. This element contains information that defines the configuration or feature data using these attributes:

name
This required attribute is the name of the data element in the eAdvisor data model (table name.column name or column name).
Example: TABLENAME.DESC
character data
The value of the ConfigData element is the contents of the selected row for the column, indicated by the name attribute information from the data model. In the following example, the character data is the string Cat.
Example: <ConfigData name = PETTYPE> Cat </ConfigData>

The DTD contains the following code for this element.

<!ELEMENT ConfigData (#PCDATA)>
<!ATTLIST ConfigData
name CDATA #REQUIRED

>

<!— An item must have config data (name/value pairs) associated with it
An item can have zero or more items as children
An item can have zero or more Price elements —>

Item

The Item element is required. It contains the information for the item using the attributes:

part_number
This implied attribute is the part number for the item. For information on setting the part number variable (called order_subvar), see Setting the Order_Subvar Configuration Variable.
quantity
This required attribute is the number of items ordered.
description
This implied attribute provides a description of the item.

The DTD contains the following code for this element.
Note that Item can have Price and Item (for nested items) children and must have at least one ConfigData child.

<!ELEMENT Item (ConfigData+, Price*, Item*)>
<!ATTLIST Item
part_number CDATA #IMPLIED
quantity CDATA #REQUIRED
description CDATA #IMPLIED

>

Bookshelf Home | Contents | Index | Search | PDF