Login
Home CMS Documentation Home CMS 10 Administration Schema Designer Schema Actions Schema Synchronization

Schema Synchronization

Changes to a schema do not automatically update content items previously created from that schema. For example, if you add a text element to a schema, the element is unavailable in existing content items until the content items sync with the schema. Depending on your site requirements, you may need to perform a sync when you finish editing a schema.

A schema sync produces the following results in selected items:

  • Adds new schema element additions.
  • Removes deleted schema elements.
  • Restructures elements to match schema order.
  • Replaces renamed elements via a two-step process:
    1. Removes the outdated element.
    2. Adds the new element with default values.
  • Updates XML of only outdated pages. To display the pages correctly, a developer must update each page's XSLT stylesheet or ASP.NET view.
Version Notes: CMS 10.3+
In Ingeniux CMS 10.3+, if you change the schema's Root Name value, syncing the schema to the content updates the top-level element of the synchronized instances.

A schema sync doesn't update to reflect all the elements' attributes changes in existing pages. Schema synchronization overwrites only attributes listed in the Schema Attribute Synchronization table.

Note
Saved taxonomy and workflow configurations within the schema apply only to new associated pages, components, assets, or content units. The taxonomy and workflow configurations don't apply to synced content items.

Content Items

Content items include associated pages and components in the Site Tree and assets in the Assets Tree.

Find Out-of-Sync Content Items

The out-of-sync content items table results displays following information:

ColumnDescription
NameFriendly name. Click the name to go to the item.
IDCMS Item ID number.
Root NameThe associated schema's root name.
Checked OutIf an (x) displays, the item is checked out to a user.
Schema VersionVersion of the schema associated with the item.
PresentationsTotal associated Page Builder presentations.
Change EffortTotal out-of-sync changes. See Analyzing Change Efforts for details.

Content Units (component schemas only)

Administrators and users with permissions associate component schemas with component content units in Administration > Presentation Content Units.

Find Out-of-Sync Content Units

The out-of-sync content units table results displays following information:

ColumnDescription
NameFriendly name.
IDCMS Content Unit ID number.
Schema VersionVersion of the schema associated with item.
Change EffortTotal out-of-sync changes. See Analyzing Change Efforts for details.

Embedded Components (component schemas only)

Users with permissions embed components associated with component schemas in the Site Tree.

Synchronizing schemas in the CMS

The out-of-sync embedded components table results displays following information:

ColumnDescription
Page NameFriendly name of the page that contains the embedded component. Click the name to go to the item.
Page IDCMS ID number of the page that contains the embedded component.
Checked OutIf an (x) displays, the page is checked out to a user.
Component Field NameName of the field that contains the embedded component. The page references this field from its associated page schema.
Field IDID number of the field that contains the embedded component.
Schema VersionVersion of the schema associated with embedded component.
Change EffortTotal out-of-sync changes. See Analyzing Change Efforts for details.
 

This section includes: