This document describes the extensions to the standard comet data model that are prerequisite for activiating new features. If any of these extensions are missing, the corresponding feature remains deactivated.

The following table contains all extensions recognized by the system. The descriptions may refer you to more detailed documentation where applicable. The feature name given in the first column of the table is also used in the Logfile.

The current status of all features (except for deletion of templates / grids / page templates) is written to the log file with each change to the data connection.

For example:

# Configuration for '/Users/paul/Desktop/fifo/priint 5.5/xmldata'
#	StringIDs : YES
#	Template Scripts : YES
#	Template for New Pages : YES
#	Template Colors : YES
#	Template Version : YES
#	Table Placeholders : YES
#	Preview Snippets : NO
#	Template Visible Flag : YES
#	Magnets & Nails : YES
#	Frame Rules : YES
#	Snippet Page Items : YES
#	Use UTF8 : NO
#	Support Globals : YES
#	Support Object Names : NO
#	Support Memberships : YES
#	Support Previews Button State : NO
#	Support Previews Link Script : NO
#	Support Placeholder Pre/Postfix : NO
#	Support Template Textflow Prefix : YES
#	Support Build Support Script : YES
#	Support Template Shapes : YES
#	Support PDF Renderer : YES
#	Has Path Setting : NO
#	Path Setting Has Version : NO
#	Has Comet Snippets : NO
#	W2ML Page Template : YES
#	Page Templates Document Metadata: YES
#	Templates has Min Size : YES
#	Has Placeholder Variants : YES
#	DocWatch : NO

Here is a short description of the log entries. The description mainly refers to XML offline and SOAP/PubServer connections. Please refer to the above table for the corresponding attributes for ODBC connections.

Log Message	Check
StringIDs	panelstatements.xml : Exists panelstatements.panelstatement.hasstringids?
Template Scripts	pageitems.xml : Exists pageitems.pageitem.spread.scriptid?
Template for New Pages	(Continuation templates) pageitems.xml : Exists pageitems.pageitem.spread.continue?
Template Colors	pageitems.xml : Exists pageitems.pageitems.color?
Template Version	pageitems.xml : Exists pageitems.pageitem.version?
Table Placeholders (Kind of Template)	pageitems.xml : Exists pageitems.pageitems.kind?
Preview Snippets	pageitems.xml : Exist pageitems.pageitem.record.id, ~.id2, ~.id3, ~.stringid?
Template Visible Flag	pageitems.xml : Exists pageitems.pageitem.active?
Magnets & Nails	pageitems.xml : Exists pageitems.pageitem.magnets?
Frame Rules	Exists file framerules.xml?
Snippet Page Items	pageitems.xml : Exists pageitems.pageitem.format?
Use UTF8	XML and SOAP/PubServer -> always YES ODBC -> depending on the selected character set encoding at login
Support Globals	XML-Offline and SOAP/PubServer -> always YES (although no PubServer supports cScript global variables. But the plug-ins could.) ODBC -> Exists database table globals?
Support Object Names	placeholder.xml : Existiert metadata.placeholder.objectnameid?
Support Memberships	pageitems.xml : Exists pageitems.pageitems.memberships?
Support Previews Button State	previewstatements.xml : Exists previewstatements.previewstatement.hasButtonState?
Support Previews Link Script	previewstatements.xml : Exists previewstatements.previewstatement.hasLinkScript?
Support Placeholder Pre/Postfix	placeholder.xml : Exist metadata.placeholder.prefix, ~.postfix, ~.prefixifempty, ~.postfixifempty?
Support Template Textflow Prefix	pageitems.xml : Exists pageitems.pageitem.textflowPrefix1Action, ~.textflowPrefix1, ~.textflowPrefixNAction, ~.textflowPrefixN?
Support Build Support Script	pageitems.xml : Exists pageitems.pageitem.buildSupportScript?
Support Template Shapes	pageitems.xml : Exists pageitems.pageitem.hasShapes?
Support PDF Renderer	XML, SOAP, PubServer -> Always YES ODBC -> Exists the database attribute pageitems.dataW2ML?
Has Path Setting	Exists file setting.xml?
Path Setting Has Version	XML and SOAP/PubServer -> always YES ODBC -> Exists the database attribute comet_setting.application
Has Comet Snippets	XML-Offline and SOAP -> Exists file snippets.xml? PubServer -> Always YES ODBC -> Exists the database attribute comet_snippets.id?
W2ML Page Template	XML, SOAP, PubServer -> Always YES ODBC -> Exists the database attribute pagetemplates.dataW2ML?
Page Templates Document Metadata	XML, SOAP, PubServer -> Always YES ODBC -> Exists the database attribute pagetemplates.metadata?
Templates has Min Size	pageitems.xml : Exist pageitems.pageitem.hasMinSize, ~.realWidth, ~.realHeight?
Has Placeholder Variants	XML, SOAP, PubServer -> Always YES ODBC -> Exists the database attribute placeholder_variants.placeholderID?
Docwatch	YES, if docWatch is enabled in the login script (Panelstatement 92) by system::set_docwatch (1).

Once you added an attribute to the data model, you have to reconnect to the data pool (by setting the data directory again or logout/login), for the change to take effect. The following examples show how to extend the data model - all extensions can be applied in an analogous fashion.

You can add attributes to an XML file from within any plain text editor. Simply replace a suitable closing tag with this sequence of closing tag, line break, new tag, for all occurences within the file.

Adding the active tag to pageitems.xml

Find    </spread>
Replace with  </spread>
       <active>3</active>

If you have access to the Werk II Utility xmlquery, you can do this in a more elegant fashion:

1. Open the file xentities.xml and insert the following lines:

<dummy>
  <file>pageitems.xml</file>
  <attr>pageitems.pageitem</attr>
  <name>active</name>
  <type>name</type> 
  <writable>1</writable>
   </dummy>

2. Open the file in the Werk II Utility xmlquery and save it using commit:

   xmlquery
   >open pageitems
   >update active=3 node pageitems.pageitems
   >commit;

3. The updated files now contain the desired attribute with the default value of 3. To prevent this field from being added again, now remove the text you inserted in step 1 from xentities.xml.

The process is analogous to XML, simply retrieve the file from the service and reupload it after editing it.

Retrieve file

int main ()
{
	SOAP		soap = soap::connection ();
	int			result;

	if (!soap)
	{
		showmessage ("No connection to the online service");
		return 0;
	}

	result = soap::download_tofile (soap, "pageitems.xml", "$DESKTOP");	
	if (result != 0)
	{
		showmessage ("An error occured loading the file : %s",
		serror (result));
		return 0;
	}

	return 0;
}

Send file

int main ()
{
	SOAP		soap = soap::connection ();
	int			result;

	if (!soap)
	{
		showmessage ("No connection to the online service");
		return 0;
	}

	result = soap::upload (soap, "$DESKTOP/pageitems.xml", -1, "pageitems.xml");	
	if (result != 0)
	{
		showmessage ("An error occured sending the file : %s",
		serror (result));
		return 0;
	}

	return 0;
}

The command for adding columns to existing tables may vary depending on your database vendor. As an example, here is the command for mySQL (which should work with most databases).

alter table pageitems add active int (10);
update pageitems set active = 3;
commit;