Das Dokument beschreibt die für das Comet-Standarddatenmodell nötigen Erweiterungen zur Aktivierung neuer Features. Fehlen die Erweiterungen, bleibt das entsprechende Feature deaktiert.

Die folgende Tabelle enthält alle Erweiterungen. In den Beschreibungen ist wenn nötig jweils ein Verweis zu einer ausführlichen Beschreibung. Der in der ersten Spalte der Tabelle verwendete Feature-Name wird auch im Logfile verwendet.

Der aktuelle Status der Features (ausser Löschen von Templates/Rastern/Seitentemplates) wird bei jeder Änderung der Datenverbindung ins Logfile geschrieben.

Hier ein Beispiel:

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

Hier eine Kurzbeschreibung der Log-Einträge. Die Beschreibung bezieht sich hauptsächlich auf XML-Offline und SOAP bzw. PubServer. Die entsprechenden Attribute für ODBC-Verbindungen entnehmen Sie bitte der obigen Tabelle.

Log-Nachricht	Beschreibung
StringIDs	panelstatements.xml : Existiert panelstatements.panelstatement.hasstringids?
Template Scripts	pageitems.xml : Existiert pageitems.pageitem.spread.scriptid?
Template for New Pages	(Fortsetzungstemplates) Existiert pageitems.pageitem.spread.continue?
Template Colors	pageitems.xml : Existiert pageitems.pageitems.color?
Template Version	pageitems.xml : Existiert pageitems.pageitem.version?
Table Placeholders (Kind of Template)	pageitems.xml : Existiert pageitems.pageitems.kind?
Preview Snippets	pageitems.xml : Existieren pageitems.pageitem.record.id, ~.id2, ~.id3, ~.stringid?
Template Visible Flag	pageitems.xml : Existiert pageitems.pageitem.active?
Magnets & Nails	pageitems.xml : Existiert pageitems.pageitem.magnets?
Frame Rules	Existiert die Datei framerules.xml?
Snippet Page Items	pageitems.xml : Existiert pageitems.pageitem.format?
Use UTF8	XML und SOAP/PubServer -> immer YES ODBC -> abhängig von der gewählten Zeichensatz-Kodierung beim Login
Support Globals	XML-Offline und SOAP/PubServer -> immer YES (obwohl kein PubServer globale Variablen von cScript unterstützt. Aber die Plug-Ins könnten es.) ODBC -> Existiert die Tabelle globals?
Support Object Names	placeholder.xml : Existiert metadata.placeholder.objectnameid?
Support Memberships	pageitems.xml : Existiert pageitems.pageitems.memberships?
Support Previews Button State	previewstatements.xml : Existiert previewstatements.previewstatement.hasButtonState?
Support Previews Link Script	previewstatements.xml : Existiert previewstatements.previewstatement.hasLinkScript?
Support Placeholder Pre/Postfix	placeholder.xml : Existieren metadata.placeholder.prefix, ~.postfix, ~.prefixifempty, ~.postfixifempty?
Support Template Textflow Prefix	pageitems.xml : Existieren pageitems.pageitem.textflowPrefix1Action, ~.textflowPrefix1, ~.textflowPrefixNAction, ~.textflowPrefixN?
Support Build Support Script	pageitems.xml : Existiert pageitems.pageitem.buildSupportScript?
Support Template Shapes	pageitems.xml : Existiert pageitems.pageitem.hasShapes?
Support PDF Renderer	XML, SOAP, PubServer -> Immer YES ODBC -> Existiert das Attribut pageitems.dataW2ML?
Has Path Setting	Existiert die Datei setting.xml?
Path Setting Has Version	XML und SOAP/PubServer immer YES ODBC -> Existiert das Tabellen-Attribut comet_setting.application
Has Comet Snippets	XML-Offline und SOAP -> Existiert die Datei snippets.xml? PubServer -> Immer YES ODBC -> Existiert das Attribut comet_snippets.id?
W2ML Page Template	XML, SOAP, PubServer -> Immer YES ODBC -> Existiert das Tabellenattribut pagetemplates.dataW2ML?
Page Templates Document Metadata	XML, SOAP, PubServer -> Immer YES ODBC -> Existiert das Tabellenattribut pagetemplates.metadata?
Templates have Min Sizes	pageitems.xml : Existieren pageitems.pageitem.hasMinSize, ~.realWidth, ~.realHeight?
Templates have Timestamps	pageitems.xml : Existieren pageitems.pageitem.timestamp, ~.updatedby?
Can Placeholder Variants	XML, SOAP, PubServer -> Immer YES ODBC -> Existiert das Tabellenattribut placeholder_variants.placeholderID?
Docwatch	Ist docWatch im Loginskript (Panelstatement 92) aktiviert system::set_docwatch (1)?

Haben Sie ein Attribut zum Datenmodell hinzugefügt, müssen Sie sich mit diesem Pool neu verbinden (Datenordner neu setzen bzw. Logout/Login). Im folgenden wird jeweils an einem Beispiel beschrieben, wie Sie Ihr Datenmodell erweitern können. Alle anderen Erweiterungen können Sie analog machen.

Das Hinzufügen von Attributen in eine XML-Datei können Sie mit einem beliebigen Texteditor, der unformatierten Text bearbeiten kann, machen. Lassen Sie einfach ein geeignetes Ende-Tag ersetzen durch durch dieses Ende-Tag+Zeilentrenner+Neues Tag - und das für die gesamte Datei.

Hinzufügen von active in pageitems.xml

Suche    </spread>
Ersetze  </spread>
       <active>3</active>

Wenn Sie das WERK II Programm xmlquery haben, können Sie es auch etwas eleganter machen :

1. Öffnen Sie die Datei xentities.xml und fügen dort die folgenden Zeilen ein:

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

2. Öffnen Sie die Datei mit dem WERK II Programm xmlquery und sichern Sie die Datei mit commit :

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

3. Die bearbeiteten Dateien enthalten jetzt das gewünschte Attribut jeweils mit dem Wert 3. Damit das Feld nicht jedesmal neu angelegt wird, entfernen Sie die in Schritt 1 eingefügten Zeilen wieder aus xentities.xml.

Das Vorgehen ist analog zu XML. Sie müssen nur vorher die Datei vom Service holen und sie danach wieder an den Service senden.

Datei holen

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

	if (!soap)
	{
		showmessage ("Keine Verbindung zum Internetdienst");
		return 0;
	}

	result = soap::download_tofile (soap, "pageitems.xml", "$DESKTOP");	
	if (result != 0)
	{
		showmessage ("Fehler beim Laden der Datei : %s",
		serror (result));
		return 0;
	}

	return 0;
}

Datei senden

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

	if (!soap)
	{
		showmessage ("Keine Verbindung zum Internetdienst");
		return 0;
	}

	result = soap::upload (soap, "$DESKTOP/pageitems.xml", -1, "pageitems.xml");	
	if (result != 0)
	{
		showmessage ("Fehler beim Senden der Datei : %s",
		serror (result));
		return 0;
	}

	return 0;
}

Die Anweisungen zum Hinzufügen von Tabellenattributen können von Datenbanktyp zu Datenbanktyp unterschiedlich sein. Stellvertretend hier die Anweisung für mySQL (die aber fast überall funktioniert).

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