IV. Message system
111
Developer handbook DATAformXTension © 1992-2004 www.gassenhuber.de
Building a message
Message files are simple text files consisting of key value pairs separated by carriage returns.
The file names can be chosen freely, but should be unique to avoid duplicates. The DATAform
database builds the names as “seconds since midnight” + “txt”, e.g. “48788.txt”
An example of a message file to import a text with DATAformTags:
FROM: Benutzer
TO: DATAform
SUBJECT: IMPORT
DFTEXT: HD internal:DATAformImport.txt
DOCUMENT:
FROM:
The name of the folder in the folder Ausgang into which DATAformXTension
will place its answer.
TO:
Constant DATAform
SUBJECT:
The command that DATAformXTension should execute. The following values
are possible: IMPORT, EXPORTALL, IMPORTEXPORTALL, IMPORTEX-
PORT, EXPORTGROUP.
DFTEXT:
The platform specific path to the text with DATAformTags file that should be
imported or created upon export, such as C:\Catalogue\import.txt.
The import settings of the preferences dialogue, import via clipboard, via
DATAform.QXP etc. are not applied.
If you wish to use the file DATAform.QXP upon import in the message system,
you transfer under DFTEXT the path: [QuarkXPress folder]:DATAform:
DATAform.QXP. The DATAform database also uses this method. It has the
advantage that the import file may be, for example, imported from the menu
command “Import boxes” even if the server is deactivated.
For an import via message the database creates two files in any case: the messa-
ge file and the DATAformTags file that should be imported.
DOCUMENT: A path to a QuarkXPress document may be specified here. The document will
then be opened first. If the path is missing, the command relates to the currently
opened document.
After processing the command DATAformXTension creates a file with the same name in the
folder [QuarkXPressFolder]:DATAform:Ausgang:Benutzer with i.e. the following content:
FROM: DATAform
TO: Benutzer
SUBJECT: IMPORT
DFTEXT: HD internal:DATAformImport.txt
DOCUMENT:
RESULT: 0, error number: 0
If an error appears, it will be transferred after RESULT with a text message: e.g.:
RESULT: 65584, There is no current QuarkXPress document
RESULT: 65493, The file could not be found. (-43)
The text message is language dependent. In a German QuarkXPress it is German otherwise
English. A list of all error messages may be found under error messages in the appendix.
If the message file cannot be processed, because e.g. after SUBJECT: no valid command is
given, the file will be moved to the error folder DATAform:Fehler.
herunterladen