class prefs

Funktionen zum Export und Import von Benutzerprofilen und der Programmeinstellungen.

static int prefs::export_pdfstyles(char* destPath, StringList onlyThose = 0)

Exportieren von PDF-Profilen in eine XML-Datei. PDF-Profile sind global in den InDesign®-Einstellungen definiert, deshalb werden hier keine weiteren Angaben zum Dokument benötigt.

Die in eckige Klammern eingeschlossenen [InDesign®-Standardprofile] werden zwar exportiert, können aber nicht importiert werden. Sie können die Exportdaten dazu verwenden, aus diesen Einstellungen eigene Profile zu erstellen. Vergessen Sie in diesem Fall nicht, die Klammern um den Profilnamen zu entfernen.

Name Typ Default Beschreibung Return int 0 oder Fehlercode destPath String oder char* - Zielpfad für die XML-Datei. Existiert die Datei bereits, wird sie überschrieben. onlyThose StringList 0 Welche Profile sollen exportiert werden? 0 oder leer : Alle Profile sonst : nur die Profile der Liste Export aller PDF-Profile. int main () { prefs::import_pdfstyles ("$DESKTOP/pfd_profiles_all.xml"); return 0; } Export einiger PDF-Profile int main () { StringList profiles = stringlist::alloc (); stringlist::append (profiles, "Pauls PDF Profile"); stringlist::append (profiles, "Christophs PDF Profile"); prefs::import_pdfstyles ("$DESKTOP/pfd_profiles1.xml", profiles); return 0; }
Seit: Version 3.1 R1760, 25. Feb. 2010
Verfügbarkeit: priint:comet InDesign® Plug-Ins
Siehe auch: import_pdfstyles
list_pdfstyles

Name	Typ	Default	Beschreibung
Return	int		0 oder Fehlercode
destPath	String oder char*	-	Zielpfad für die XML-Datei. Existiert die Datei bereits, wird sie überschrieben.
onlyThose	StringList	0	Welche Profile sollen exportiert werden? 0 oder leer : Alle Profile sonst : nur die Profile der Liste

static int prefs::import_pdfstyles(
char* destPath,
StringList onlyThose = 0,
int mode = 0)

Importieren von PDF-Profilen aus einer XML-Datei. PDF-Profile sind global in den InDesign®-Einstellungen definiert, deshalb werden hier keine weiteren Angaben zum Dokument benötigt.

Name Typ Default Beschreibung Return int 0 oder Fehlercode srcPath String or char* - Vollständiger Pfad der XML-Datei im Format von export_pdfstyles onlyThose StringList 0 Welche Profile sollen importiert werden? 0 oder leer : Alle Profile sonst : nur die Profile der Liste mode int 0 Was soll getan werden, wenn ein Profil bereits existiert? 0 : überschreiben 1 : überspringen 2 : abbrechen Importiere der PDF Profile einer Datei. Das Skript schreibt vor und nach dem Import alle verfügbaren Profile ins Logfile. Beachten Sie, dass die Liste profile vor der zweiten Verwendung gelöscht werden muss! int main () { StringList profiles; char * str; wlog ("", "# Before import\n"); profiles = prefs::list_pdfstyles (""); for (str = stringlist::first (profiles); str; str = stringlist::next (profiles)) { wlog ("", "#\t'%s'\n", str); } prefs::import_pdfstyles ("$DESKTOP/pfd_profiles1.xml", 0); wlog ("", "# After import\n"); stringlist::release (profiles); // Delete list before! profiles = prefs::list_pdfstyles (""); for (str = stringlist::first (profiles); str; str = stringlist::next (profiles)) { wlog ("", "#\t'%s'\n", str); } return 0; }
Seit: Version 3.1 R1760, 25. Feb. 2010
Verfügbarkeit: priint:comet InDesign® Plug-Ins
Siehe auch: export_pdfstyles
list_pdfstyles
list_pdfstyles

Name	Typ	Default	Beschreibung
Return	int		0 oder Fehlercode
srcPath	String or char*	-	Vollständiger Pfad der XML-Datei im Format von export_pdfstyles
onlyThose	StringList	0	Welche Profile sollen importiert werden? 0 oder leer : Alle Profile sonst : nur die Profile der Liste
mode	int	0	Was soll getan werden, wenn ein Profil bereits existiert? 0 : überschreiben 1 : überspringen 2 : abbrechen

static StringList prefs::list_pdfstyles(char* source = 0, StringList listToFill = 0)

Welche PDF-Profile habe ich eigentlich?

Name Typ Default Beschreibung Return StringList Liste der verfügbaren Profile Ist der Parameter listToFill leer, wird eine neue Liste erzeugt, die mit stringlist::release wieder gelöscht werden muss. source String or char* 0 Wo sollen die Profile gesucht werden? 0 oder "" : In den InDesign®-Einstellungen sonst : Pfad zu einer XML-Datei im Format von export_pdfstyles listToFill StringList 0 Liste für die Ergebnisse. Ist der Parameter leer, wird eine neue Liste erzeugt, die mit stringlist::release wieder gelöscht werden muss. Sonst wird die übergebene Liste mit den erhaltenen Profilnamen gefüllt.
Seit: Version 3.1 R1760, 25. Feb. 2010
Verfügbarkeit: priint:comet InDesign® Plug-Ins
Siehe auch: export_pdfstyles
import_pdfstyles

Name	Typ	Default	Beschreibung
Return	StringList		Liste der verfügbaren Profile Ist der Parameter listToFill leer, wird eine neue Liste erzeugt, die mit stringlist::release wieder gelöscht werden muss.
source	String or char*	0	Wo sollen die Profile gesucht werden? 0 oder "" : In den InDesign®-Einstellungen sonst : Pfad zu einer XML-Datei im Format von export_pdfstyles
listToFill	StringList	0	Liste für die Ergebnisse. Ist der Parameter leer, wird eine neue Liste erzeugt, die mit stringlist::release wieder gelöscht werden muss. Sonst wird die übergebene Liste mit den erhaltenen Profilnamen gefüllt.

static int prefs::export_printstyles(char* destPath, StringList onlyThose = 0)

Exportieren von Drucker-Profilen in eine XML-Datei. Drucker-Profile sind global in den InDesign®-Einstellungen definiert, deshalb werden hier keine weiteren Angaben zum Dokument benötigt.

Die in eckige Klammern eingeschlossenen [InDesign®-Standardprofile] werden zwar exportiert, können aber nicht importiert werden. Um ein neues Profile mit neuem Namen zu erhalten, genügt es hier - im Gegensatz zu den PDF-Profilen - nicht, einfach einen Eintrag der XML-Datei zu kopieren und dort den Namen zu ändern. Der Profil-Name ist in den Binärdaten des CDATA-Teils nochmals versteckt und die Kopie hat dann nicht den neuen Namen sondern Alter Name Kopie 1. Sie müssen hier tatsächlich ein neues Profil in InDesign® erstellen.

Name Typ Default Beschreibung Return int 0 oder Fehlercode destPath String oder char* - Zielpfad für die XML-Datei. Existiert die Datei bereits, wird sie überschrieben. onlyThose StringList 0 Welche Profile sollen exportiert werden? 0 oder leer : Alle Profile sonst : nur die Profile der Liste Export aller Drucker-Presets. int main () { prefs::export_printstyles ("$DESKTOP/pfd_profiles_all.xml"); return 0; } Export einiger Drucker-Presets. int main () { StringList profiles = stringlist::alloc (); stringlist::append (profiles, "Pauls PDF Profile"); stringlist::append (profiles, "Christophs PDF Profile"); prefs::export_printstyles ("$DESKTOP/pfd_profiles1.xml", profiles); return 0; }
Seit: Version 3.1 R1760, 25. Feb. 2010
Verfügbarkeit: priint:comet InDesign® Plug-Ins
Siehe auch: import_printstyles
list_printstyles

Name	Typ	Default	Beschreibung
Return	int		0 oder Fehlercode
destPath	String oder char*	-	Zielpfad für die XML-Datei. Existiert die Datei bereits, wird sie überschrieben.
onlyThose	StringList	0	Welche Profile sollen exportiert werden? 0 oder leer : Alle Profile sonst : nur die Profile der Liste

static int prefs::import_printstyles(
char* srcPath,
StringList onlyThose = 0,
int mode = 0)

Importieren von Drucker-Profilen aus einer XML-Datei. Drucker-Profile sind global in den InDesign®-Einstellungen definiert, deshalb werden hier keine weiteren Angaben zum Dokument benötigt.

Wenn Sie den Befehl nach Programmstart zu ersten Mal anwenden, kann er eine Weile dauern. InDesign® braucht einen Moment Zeit, alle aktuellen Drucker zu finden.

Name Typ Default Beschreibung Return int 0 oder Fehlercode srcPath String oder char* - Vollständiger Pfad der XML-Datei im Format von export_printstyles onlyThose StringList 0 Welche Profile sollen importiert werden? 0 oder leer : Alle Profile sonst : nur die Profile der Liste mode int 0 Was soll getan werden, wenn ei Profil bereits existiert? 0 : überschreiben 1 : überspringen 2 : abbrechen Import aller Drucker-Presets einer XML-Datei. int main () { StringList profiles; char * str; int res; wlog ("", "# Before import\n"); profiles = prefs::list_printstyles (""); for (str = stringlist::first (profiles); str; str = stringlist::next (profiles)) { wlog ("", "#\t'%s'\n", str); } res = prefs::import_printstyles ("$DESKTOP/print_profiles1.xml", 0); wlog ("", "# Import result %d\n", res); wlog ("", "# After import\n"); stringlist::release (profiles); // Delete list before! profiles = prefs::list_printstyles (""); for (str = stringlist::first (profiles); str; str = stringlist::next (profiles)) { wlog ("", "#\t'%s'\n", str); } return 0; }
Seit: Version 3.1 R1760, 25. Feb. 2010
Verfügbarkeit: priint:comet InDesign® Plug-Ins
Siehe auch: export_printstyles
list_printstyles
list_printstyles

Name	Typ	Default	Beschreibung
Return	int		0 oder Fehlercode
srcPath	String oder char*	-	Vollständiger Pfad der XML-Datei im Format von export_printstyles
onlyThose	StringList	0	Welche Profile sollen importiert werden? 0 oder leer : Alle Profile sonst : nur die Profile der Liste
mode	int	0	Was soll getan werden, wenn ei Profil bereits existiert? 0 : überschreiben 1 : überspringen 2 : abbrechen

static StringList prefs::list_printstyles(char* source = 0, StringList listToFill = 0)

Welche Drucker-Profile habe ich eigentlich?

Name Typ Default Beschreibung Return StringList Liste der verfügbaren Profile Ist der Parameter listToFill leer, wird eine neue Liste erzeugt, die mit stringlist::release wieder gelöscht werden muss. source String oder char* 0 Wo sollen die Profile gesucht werden? 0 oder "" : In den InDesign®-Einstellungen sonst : Pfad zu einer XML-Datei im Format von export_printstyles listToFill StringList 0 Liste für die Ergebnisse. Ist der Parameter leer, wird eine neue Liste erzeugt, die mit stringlist::release wieder gelöscht werden muss. Sonst wird die übergebene Liste mit den erhaltenen Profilnamen gefüllt.
Seit: Version 3.1 R1760, 25. Feb. 2010
Verfügbarkeit: priint:comet InDesign® Plug-Ins
Siehe auch: export_printstyles
import_printstyles

Name	Typ	Default	Beschreibung
Return	StringList		Liste der verfügbaren Profile Ist der Parameter listToFill leer, wird eine neue Liste erzeugt, die mit stringlist::release wieder gelöscht werden muss.
source	String oder char*	0	Wo sollen die Profile gesucht werden? 0 oder "" : In den InDesign®-Einstellungen sonst : Pfad zu einer XML-Datei im Format von export_printstyles
listToFill	StringList	0	Liste für die Ergebnisse. Ist der Parameter leer, wird eine neue Liste erzeugt, die mit stringlist::release wieder gelöscht werden muss. Sonst wird die übergebene Liste mit den erhaltenen Profilnamen gefüllt.

static int prefs::export_flattenerstyles(char* destPath, StringList onlyThose = 0)

Exportieren von Transparenzreduzierungsvorgaben in eine XML-Datei. Drucker-Profile sind global in den InDesign®-Einstellungen definiert, deshalb werden hier keine weiteren Angaben zum Dokument benötigt.

Name Typ Default Beschreibung Return int 0 oder Fehlercode destPath String oder char* - Zielpfad für die XML-Datei. Existiert die Datei bereits, wird sie überschrieben. onlyThose StringList 0 Welche Profile sollen exportiert werden? 0 oder leer : Alle Profile sonst : nur die Profile der Liste
Seit: Version 3.1 R1760, 25. Feb. 2010
Verfügbarkeit: priint:comet InDesign® Plug-Ins
Siehe auch: import_flattenerstyles
list_flattenerstyles

Name	Typ	Default	Beschreibung
Return	int		0 oder Fehlercode
destPath	String oder char*	-	Zielpfad für die XML-Datei. Existiert die Datei bereits, wird sie überschrieben.
onlyThose	StringList	0	Welche Profile sollen exportiert werden? 0 oder leer : Alle Profile sonst : nur die Profile der Liste

static int prefs::import_flattenerstyles(
char* destPath,
StringList onlyThose = 0,
int mode = 0)

Importieren von Transparenzreduzierungsvorgaben aus einer XML-Datei. Drucker-Profile sind global in den InDesign®-Einstellungen definiert, deshalb werden hier keine weiteren Angaben zum Dokument benötigt.

Name Typ Default Beschreibung Return int 0 oder Fehlercode srcPath String oder char* - Vollständiger Pfad der XML-Datei im Format von export_flattenerstyles onlyThose StringList 0 Welche Profile sollen importiert werden? 0 oder leer : Alle Profile sonst : nur die Profile der Liste mode int 0 Was soll getan werden, wenn ei Profil bereits existiert? 0 : überschreiben 1 : überspringen 2 : abbrechen
Seit: Version 3.1 R1760, 25. Feb. 2010
Verfügbarkeit: priint:comet InDesign® Plug-Ins
Siehe auch: export_flattenerstyles
list_flattenerstyles
list_flattenerstyles

Name	Typ	Default	Beschreibung
Return	int		0 oder Fehlercode
srcPath	String oder char*	-	Vollständiger Pfad der XML-Datei im Format von export_flattenerstyles
onlyThose	StringList	0	Welche Profile sollen importiert werden? 0 oder leer : Alle Profile sonst : nur die Profile der Liste
mode	int	0	Was soll getan werden, wenn ei Profil bereits existiert? 0 : überschreiben 1 : überspringen 2 : abbrechen

static StringList prefs::list_flattenerstyles(char* source = 0, StringList listToFill = 0)

Welche Transparenzreduzierungsprofile habe ich eigentlich?

Name Typ Default Beschreibung Return StringList Liste der verfügbaren Profile Ist der Parameter listToFill leer, wird eine neue Liste erzeugt, die mit stringlist::release wieder gelöscht werden muss. source String oder char* 0 Wo sollen die Profile gesucht werden? 0 oder "" : In den InDesign®-Einstellungen sonst : Pfad zu einer XML-Datei im Format von export_flattenerstyles listToFill StringList 0 Liste für die Ergebnisse. Ist der Parameter leer, wird eine neue Liste erzeugt, die mit stringlist::release wieder gelöscht werden muss. Sonst wird die übergebene Liste mit den erhaltenen Profilnamen gefüllt.
Seit: Version 3.1 R1760, 25. Feb. 2010
Verfügbarkeit: priint:comet InDesign® Plug-Ins
Siehe auch: export_flattenerstyles
import_flattenerstyles

Name	Typ	Default	Beschreibung
Return	StringList		Liste der verfügbaren Profile Ist der Parameter listToFill leer, wird eine neue Liste erzeugt, die mit stringlist::release wieder gelöscht werden muss.
source	String oder char*	0	Wo sollen die Profile gesucht werden? 0 oder "" : In den InDesign®-Einstellungen sonst : Pfad zu einer XML-Datei im Format von export_flattenerstyles
listToFill	StringList	0	Liste für die Ergebnisse. Ist der Parameter leer, wird eine neue Liste erzeugt, die mit stringlist::release wieder gelöscht werden muss. Sonst wird die übergebene Liste mit den erhaltenen Profilnamen gefüllt.

static int prefs::get_script_buffer()

Aktuelle Größe des Skript-Speichers.

Name Typ Default Beschreibung Return int Größe des Skriptpuffers in kB
Seit: Version 3.1 R2021, 20. Juli 2010
Verfügbarkeit: priint:comet InDesign® Plug-Ins, comet_pdf
Siehe auch: set_script_buffer
comet.prefs.getCScriptBuffer

Name	Typ	Default	Beschreibung
Return	int		Größe des Skriptpuffers in kB

static int prefs::set_script_buffer(int newSize)

Setze die Größe des Skript-Puffers. Die Änderungen werden erst ab dem nächsten Skript wirksam. Die Angaben erfolgen in kB und werden automatisch auf den Bereich 1024 - 16384 (also 1-16 MB) beschränkt.

Jedes Skript hat zu seiner Laufzeit einen eigenen Puffer. Ein zu kleiner Puffer kann zum Speicherüberlauf des Skriptes führen (Symbol table full, Out of heap memory). Ein zu großer Puffer kann die Verarbeitung stark verlangsamen oder zum Speicherüberlauf von InDesign® führen. Skriptspeicher können Sie sparen, indem Sie etwa statt

char str [5000];

char * str = alloc (5000);

schreiben. Im ersten Fall werden 5000 Bytes des Skriptbuffers (Heap) verwendet, im zweiten nur 4 - und die 5000 Bytes verwaltet InDesign® für Sie.

Die Standardgröße des Puffers beträgt 128 kB.

Um sicherzustellen, dass Ihre Skripte genügend Speicher bekommen, sollten Sie die Größe des Puffers im Loginskript Ihrer Datenverbindung setzen.

Name Typ Default Beschreibung Return int Neue Größe des Skriptpuffers in kB newSize int - Neue Größe des Skriptpuffers in kB. Die Änderungen werden erst ab dem nächsten Skript wirksam. Die Angaben erfolgen in kB und werden automatisch auf den Bereich 1024 - 16384 (also 1-16 MB) beschränkt.
Seit: Version 3.1 R2021, 20. Juli 2010
v4.1.8 R27460, 9. Sep. 2020, Bereich von 128 kB - 8 MB geändert zu 1 - 16 MB
Verfügbarkeit: priint:comet InDesign® Plug-Ins, comet_pdf
Siehe auch: get_script_buffer
comet.prefs.setCScriptBuffer

Name	Typ	Default	Beschreibung
Return	int		Neue Größe des Skriptpuffers in kB
newSize	int	-	Neue Größe des Skriptpuffers in kB. Die Änderungen werden erst ab dem nächsten Skript wirksam. Die Angaben erfolgen in kB und werden automatisch auf den Bereich 1024 - 16384 (also 1-16 MB) beschränkt.

static int prefs::set_script_nullify_on_release(int newState)

EXPERIMENTELL Setze bei cScript-Aufrufen von release-Funktionen automatisch alle Variablen, die auf die freigegebene Speicheradresse zeigen auf den Wert 0. Die Einstellung wird spätestens beim Trennen der aktuellen Datenverbindung wieder abgeschaltet.

Im Standard verhält sich cScript beim Freigeben von reserviertem Speicher so wie C oder C++: Der Speicher wird freigegeben und die Variable zeigt danach auf den Wert 0. Die Variable selbst behält aber ihren Wert.

Name Typ Default Beschreibung

Return int Bisheriger Status

newState int - Verhalten von cScript beim Freigeben reservierten Speichers mit einer der release-Funktionen.

0 : Bei einem release behalten alle Variablen, die auf den gleichen freigegebenen Speicher zeigen, ihren Wert (und zeigen damit weiter auf die, inzwischen ungültige, alte Speicheradresse).

Vorteil : Nach release (var) führt die Verwendung von var nicht sofort zum Absturz.
Nachteil : *var enthält 'unsichere' Werte - je später, desto falscher. Und irgendwann in naher Zukunft wird die Verwendung dieser Daten zum Absturz führen.
1 : Bei einem release werden alle Variablen, die auf den gleichen freigegebenen Speicher zeigen, auf den Wert 0 gesetzt.

Vorteil : Nach release (var) hat var den sicheren Wert 0 (den Sie dann aber vor weiterer Verwendung der Variable auch mal testen sollten!).
Nachteil : *var führt in Funktionen, die die Variable var nicht vorher testen, zum sofortigen Absturz!

Hier ein kleines Testprogramm, das folgende Ausgabe produziert:

Auto Nullify OFF
    s1 = 32917A800, s2 = 32917A800
    s1 = 32917A800, s2 = 32917A800
Auto Nullify ON
    s1 = 32917A800, s2 = 32917A800
# Auto reset all script variables pointing to released data @ 0x2917A800 to 0
    s1 = 0, s2 = 0

int ttt (char * mess) { char * s1; char * s2;
wlog ("", "%s\n", mess);
s1 = alloc (256); s2 = s1; wlog ("", " s1 = %X, s2 = %X\n", s1, s2);
release (s1); wlog ("", " s1 = %X, s2 = %X\n", s1, s2);
return 0; }
int main () { ttt ("Auto Nullify OFF"); prefs::set_script_nullify_on_release (1); ttt ("Auto Nullify ON"); return 0; }
Seit: v5.0 R35910, 9. Jan 2025
Verfügbarkeit: priint:comet InDesign® Plug-Ins, comet_pdf
Siehe auch: get_script_nullify_on_release
release
string::release
productlist::release
...

Name	Typ	Default	Beschreibung
Return	int		Bisheriger Status
newState	int	-	Verhalten von cScript beim Freigeben reservierten Speichers mit einer der release-Funktionen. 0 : Bei einem release behalten alle Variablen, die auf den gleichen freigegebenen Speicher zeigen, ihren Wert (und zeigen damit weiter auf die, inzwischen ungültige, alte Speicheradresse). Vorteil : Nach release (var) führt die Verwendung von var nicht sofort zum Absturz. Nachteil : var enthält 'unsichere' Werte - je später, desto falscher. Und irgendwann in naher Zukunft wird die Verwendung dieser Daten zum Absturz führen. 1 : Bei einem release werden alle Variablen, die auf den gleichen freigegebenen Speicher zeigen, auf den Wert 0 gesetzt. Vorteil* : Nach release (var) hat var den sicheren Wert 0 (den Sie dann aber vor weiterer Verwendung der Variable auch mal testen sollten!). Nachteil : *var führt in Funktionen, die die Variable var nicht vorher testen, zum sofortigen Absturz!

static int prefs::get_script_nullify_on_release()

Wie verhält sich cScript beim Löschen reservierten Speichers mit einer der release-Funkitonen?

Name Typ Default Beschreibung Return int 0 : Der Speicher wird freigegeben, aber die Variablen behalten ihren aktuellen Wert (entspricht dem Verhalten von C und C++). 1 : Nach dem Freigeben reservierten Arbeitsspeicher werden die entsprechende Variable und alle anderen Variablen, die auf die gleiche Speicheradresse zeigen auf 0 gesetzt. Über Vor- und Nachteile siehe set_script_nullify_on_release.
Seit: v5.0 R35910, 9. Jan 2025
Verfügbarkeit: priint:comet InDesign® Plug-Ins, comet_pdf
Siehe auch: set_script_nullify_on_release
release
string::release
productlist::release
...

Name	Typ	Default	Beschreibung
Return	int		0 : Der Speicher wird freigegeben, aber die Variablen behalten ihren aktuellen Wert (entspricht dem Verhalten von C und C++). 1 : Nach dem Freigeben reservierten Arbeitsspeicher werden die entsprechende Variable und alle anderen Variablen, die auf die gleiche Speicheradresse zeigen auf 0 gesetzt. Über Vor- und Nachteile siehe set_script_nullify_on_release.

static int prefs::sync_server_notes(int v = -1)

Sollen Comet-Notizen beim Öffnen eines Dokuments mit InDesignServer® synchronisiert werden?

Die Anweisung hat nur für InDesignServer® und comet_pdf Bedeutung. In InDesign (Desktop) kann die Anweisung ausgeführt werden, hat aber keine Wirkung. Im Desktop werden Notizen beim Ausbuchen &uu;ber das Publikationspanel immer synchronisiert.

Im Standard ist die Synchronisation von Notizen in InDesign Server® und comet_pdf deaktiviert. Zum Aktivieren müssen folgende Anweisungen angepasst werden

'session::login Skript (Panelstatement 92) sowie
document::after open Skript (Panelstatement 44)

Folgen Sie dazu den Anweisungen im unten stehenden Beispiel!

Bitte beachten Sie: Der Aufruf selbst synchronisiert keine Notizen. Sie legen hier lediglich fest, dass die Notizen beim Bearbeiten auf dem Server synchronisiert werden können.
Konkret bedeutet das:

nach dem Öffnen des Dokuments werden Notizen aus der Datei notes.xml im Metadaten-Ordner imporiert, sofern diese Datei vorhanden ist
im Dokument selbst hinterlegte Notizen werden beim Import ersetzt
nach dem Speichern werden Notizen in ebendiese Datei exportiert und mit den Metadaten an den Server geschickt

Sofern die Bearbeitung oder Verarbeitung von Notizen auf dem Server in Ihrer Anwendung keine Rolle spielt, sollten die Synchronisation deaktiviert bleiben (und die o.g. Panelstatements entsprechend unverändert), da das Anfordern von Metadaten und Import / Export von Notizen zusätzliche Verarbeitungszeit erfordert.

Name Typ Default Beschreibung

Return int aktueller Wert der Eigenschaft

0 : Notizen werden nicht synchronisiert
1 : Notizen können synchronisiert werden

v int - Status setzen/erfragen

-1 : Status erfragen
0 : Notizen werden nicht synchronisiert
1 : Notizen können synchronisiert werden

Notwendige Anpassungen von Panelstatements

// Login / session::login (Panelstatement 92) // Folgende Zeile einfügen: // prefs::sync_server_notes (1);
// After Open / document:after open (Panelstatement 44) // // Folgenden Abschnitt if (system::is_server()) { strcpy(documentId, gDocumentID); result = xml::set_document_attribute(gDocument, "documentId", documentId); } else { xml::get_document_attribute(gDocument, "documentId", documentId); }
// durch diese Zeilen ersetzen: if (system::is_server()) { if (isPublicationDocument(gDocumentID)) { char * documentPath = alloc(4096); strcpy(documentPath, gDocumentPath); priint::checkout (gDocumentID, documentPath); release (documentPath); } strcpy(documentId, gDocumentID); result = xml::set_document_attribute(gDocument, "documentId", documentId); } else { xml::get_document_attribute(gDocument, "documentId", documentId); }
Seit: v4.2 R32300, 8. Feb 2023
Verfügbarkeit: priint:comet InDesign® Plug-Ins, comet_pdf

Name	Typ	Default	Beschreibung
Return	int		aktueller Wert der Eigenschaft 0 : Notizen werden nicht synchronisiert 1 : Notizen können synchronisiert werden
v	int	-	Status setzen/erfragen -1 : Status erfragen 0 : Notizen werden nicht synchronisiert 1 : Notizen können synchronisiert werden

static int (int state)

Farbprofilsicheres Einsetzen von Templates.

Ein InDesign®-Bug bewirkt, dass Templates das im Dokument eingestellte Farbprofil ändern können : Das Farbprofil des Quelldokumentes wird - wenn vorhanden - auch im Zieldokument gesetzt. Ist das Profil nicht vorhanden, wird das eingestellte Standardprofil (Menu "Bearbeiten:Farbeinstellungen...") gesetzt.

Nach (sehr) langer Suche wurde in einer Doku zu InDesign® 2.0 (also noch vor CS-Zeiten, das war 2003 (sic!)) die Beschreibung einer etwas geänderten Methode zum Einfügen von Rahmen gefunden - und mit der bleibt das Farbprofil erhalten. Damit nun nicht alles plötzlich ganz anders funktioniert - das Einsetzen von Templates ist immerhin ein recht zentraler Teil der Comet-Plugins, muss das Feature freigeschaltet werden. Dazu dient der Befehl set_preserve_color_profiles.

Mit state=1 wird das Feature freigeschaltet - und bleibt es bis zum nächsten Neuverbinden mit einer Datenquelle (XML-Ordner, SQL, SOAP, Oracle) oder bis zu einem Aufruf mit state=0.

Will man das Feature für eine Datenverbindung immer zur Verfügung haben, sollte man es also im Loginskript setzen.

Name Typ Default Beschreibung Return int 0 oder Fehlercode state int - 0 : Standardverfahren zum Einsetzen von Templates verwenden 1 : Farbprofilerhaltendes Verfahren verwenden. Die Einstellung wird beim Ändern der Datenverbindung zurückgesetzt.
Seit: Version 3.1 R2050, 5. Aug. 2010
Verfügbarkeit: priint:comet InDesign® Plug-Ins
Deprecated: Nach mehr als acht Jahren übergangszeit streichen wir die Funktion jetzt und das farbprofilerhaltende Verfahren zum Duplizieren von Rahmen wird zum Standard.

Name	Typ	Default	Beschreibung
Return	int		0 oder Fehlercode
state	int	-	0 : Standardverfahren zum Einsetzen von Templates verwenden 1 : Farbprofilerhaltendes Verfahren verwenden. Die Einstellung wird beim Ändern der Datenverbindung zurückgesetzt.

static int ()

Welches Verfahren wird beim Einsetzen von Templates verwendet?

Name Typ Default Beschreibung Return int 0 : Standardverfahren 1 : Farbprofilsicheres Einsetzen von Templates
Seit: Version 3.1 R2050, 5. Aug. 2010
Verfügbarkeit: priint:comet InDesign® Plug-Ins
Deprecated: Nach mehr als acht Jahren übergangszeit streichen wir die Funktion jetzt und das farbprofilerhaltende Verfahren zum Duplizieren von Rahmen wird zum Standard.
Siehe auch: set_preserve_color_profiles

Name	Typ	Default	Beschreibung
Return	int		0 : Standardverfahren 1 : Farbprofilsicheres Einsetzen von Templates

static int (int v = -1)

DEPRECATED! Sollen beim Sichern von Templates automatisch auch IDML-Versionen der Templates abgelegt werden? Unter XML und SOAP werden die IDML-Dateien mit der Endung idml "neben" die InDesign®-Dateien der Templates gelegt (normalerweise also etwa pageitems/data/123.idml. Unter SQL wird das Panelstatement 121 zum Sichern des Datenblobs verwendet. Ist das Panelstatement 121 leer oeder fehlt wird die Anweisung update pageitems set dataIDML = LATIN1 ? where id = ? verwendet. LATIN1 wird dabei durch den aktuellen Wert von LATIN1 in der Tabelle keywords ersetzt.

Beim Trennen der Datenverbindung bzw. beim Neusetzen des Datenordners wird die Option automatisch (wieder) abgeschaltet.