Database asset groups dependencies

All WebSphere Commerce database assets are divided into groups for creation and loading. These groups are a logically related set of tables. The order in which these database asset groups are organized is important to data loading, since certain objects must exist before you load the relationship between objects.

When you load database assets in XML format for your store, you can choose to load only selected groups. These groups consist of the database assets, such as catalog or fulfillment. Before you load data groups as instructed in Loading database asset groups:

  • Determine which database asset group you are loading. Each group contains dependencies that must be met before the assets can be loaded. Review the information in Database asset groups.
  • Ensure that you create or update the XML files for the selected database asset group. When you create or update XML files, the information for a parent table must precede information for a child table.

Each database asset group draws its information from WebSphere Commerce database tables. Database assets have dependencies within their own group. That is, a database asset group cannot draw data in other XML files from a different data group, and each group is independent minus the foreign keys. However, if the database asset group needs to refer to the external data defined in another group, then you need to provide that data manually. This means that the data from one group has an external dependency on data that is defined outside of its domain, that is, on another database asset group. External dependencies occur when a database asset group has a foreign key relationship to the primary key of a table in another group. To load a database asset group, its external dependencies must be satisfied. To use an example from the following chart, one of the external dependencies for the store database asset group is fulfillment.FFMCENTER.FFMCENTER_ID, which indicates that the fulfillment database assets must exist in the WebSphere Commerce database before you can load the store database asset group.

Consider the following chart before you begin your loading process. Each group of database assets is dependent on other database tables, from which the data is loaded.

Some points to remember:

  • Some external dependencies might not be satisfied by a single group. Site wide or general database assets, which are used by every store, are prepopulated at instance creation in the bootstrap and can be readily accessed. Tables that are contained in database asset groups have foreign key references to this type of data. Bootstrap data is divided into common and locale-specific data. If you have a multilingual store, you need to choose the common and the locale-specific bootstrap data. For example, you need the language and member bootstrap data. The instance creation process populates the LANGUAGE table with the supported WebSphere Commerce languages for your store and creates a root organization (MEMBER.MEMBER_ID=-2001) and a default organization (MEMBER.MEMBER_ID=-2000). You must use the root organization where required, but you should create a store owner organization instead of using the default organization.
  • The files that are listed under the External dependencies column use the following naming structure: database asset group. database table. database column. Using the store.STOREENT.STOREENT_ID file as an example, the data is taken from the store database asset group, STOREENT table, and STOREENT_ID column. File names that begin with bootstrap indicate that the data was populated during the WebSphere Commerce instance creation.
  • The files that are listed under the External dependencies column contain foreign key references to the Related tables. These tables must be populated first.
  • For presentation purposes only, the tables are split to indicate the locale-specific tables that contain multilingual information, such as product descriptions.
  • The tables in the chart represent the database assets from the WebSphere Commerce starter stores. The tables can vary according to your store's size, function, and needs. Depending on your store's requirements, ensure that you include all database tables that contain your store's assets, even if that particular table is not listed.
Database asset External dependencies Related tables from the database asset XML files Related locale-specific tables from the database asset XML files
Access control database assets bootstrap.LANGUAGE.LANGUAGE_ID (root and store owner organizations), bootstrap.MEMBER.MEMBER_ID (root and store owner organizations) accesscontrol.xml ACACTACTGP, ACACTGRP, ACACTION, ACPOLICY, ACRESCGRY, ACRESGPRES, ACRESGRP accesscontrol.xml ACACGPDESC, ACACTDESC, ACPOLDESC, ACRSCGDES, ACRESGPDES
Business policy database assets bootstrap.LANGUAGE.LANGUAGE_ID, boostrap.MEMBER.MEMBER_ID, store.STOREENT.STOREENT_ID (store owner organization) businesspolicy.xml POLICY, POLICYCMD businesspolicy.xml POLICYDESC
Campaign database assets store.STOREENT.STOREENT_ID campaign.xml CAMPAIGN, COLLATERAL, EMSPOT campaign.xml COLLDESC
Catalog database assets bootstrap.LANGUAGE.LANGUAGE_ID, bootstrap.MEMBER.MEMBER_ID (store owner organization), store.STOREENT.STOREENT_ID, shipping.CALCODE.CALCODE_ID, tax.CALCODE.CALCODE_ID catalog.xml BASEITEM, CATALOG, CATENTREL, CATENTRY, CATGROUP, CATGRPREL, CATTOGRP, ITEMSPC, ITEMVERSN, RA, RADETAIL, STOREITEM, STORITMFFC, VERSIONSPC offering.xml CATGRPTPC, MGPTRDPSCN, OFFER, OFFERPRICE, TRADEPOSCN storefulfill.xml INVENTORY store-catalog.xml DISPCGPREL, DISPENTREL, STORECAT, STORECENT, STORECGRP store-catalog-shipping.xml CATENTCALCD, CATENTSHIP store-catalog-tax.xml CATENTCALD catalog.xml ATTRIBUTE, ATTRVALUE, BASEITMDSC, CATALOGDSC, CATENTDESC, CATGRPDESC, PKGATTR, PKGATTRVAL,
Command database assets store.STOREENT.STOREENT_ID command.xml CMDREG N/A
Contract database assets store.STOREENT.STOREENT_ID The contract database tables are not loaded directly and follow a different process than the other WebSphere Commerce data groups.
Currency database assets store.STOREENT.STOREENT_ID currency.xml CURCVLIST currency.xml CURCONVERT, CURLIST
Fulfillment database assets bootstrap.LANGUAGE.LANGUAGE_ID, boostrap.MEMBER.MEMBER_ID (store owner organization) fulfillment.xml FFMCENTER, STADDRESS fulfillment.xml FFMCENTDS
Organization database assets bootstrap.LANGUAGE.LANGUAGE_ID (root and store owner organizations), boostrap.MEMBER.MEMBER_ID (root and store owner organizations) organization.xml ADDRBOOK, ADDRESS, MBRREL, MEMBER, ORGENTITY N/A
Shipping database assets bootstrap.LANGUAGE.LANGUAGE_ID, bootstrap.MEMBER.MEMBER_ID (store owner organization), fulfillment.FFMCENTER.FFMCENTER_ID, store.STOREENT.STOREENT_ID shipping.xml CALCODE, CALRULE, CRULESCALE, JURST, JURSTGPREL, JURSTGROUP, SHIPMODE, STENCALUSG shipping.xml SHPJCRULE, SHPARRANGE shipping.xml CALCODEDSC, CALRANGE, CALRLOOKUP, CALSCALE, SHPMODEDSC
Store database assets bootstrap.LANGUAGE.LANGUAGE_ID, bootstrap.MEMBER.MEMBER_ID (store owner organization), bootstrap.SETCURR.SETCURR_ID, fulfillment.FFMCENTER.FFMCENTER_ID store.xml INVADJCODE, RTNREASON, STORE, STORENT, STORELANG, VENDOR store.xml FFMCENTDS, INVADJDESC, RTNRSNDESC, STADDRESS, STOREENTDS, STORLANGDS, VENDORDESC
Store default database assets shipping.SHIPMODE.SHIPMODE_ID (if applicable, this file must be loaded first), contract.CONTRACT.CONTRACT_ID, store.STOREENT.STOREENT_ID store-default.xml STOREDEF N/A
Tax database assets bootstrap.LANGUAGE.LANGUAGE_ID, boostrap.MEMBER.MEMBER_ID (store owner organization), store.STOREENT.STOREENT_ID, fulfillment.FFMCENTER.FFMCENTER_ID, store.STOREENT.STOREENT_ID tax.xml CALCODE, CALRANGE, CALRLOOKUP, CALRULE, CALSCALE, CRULESCALE, JURST, JURSTGROUP, JURSTGPREL, STENCALUSG, TAXCGRY, TAXJCRULE taxfulfill.xml TAXJCRULE tax.xml CALCODEDSC, CALSCALEDS, TAXCGRYDS