With DocuWare Printer, you print documents directly from your applications (e.g. MS Word, ERP) and store them in the long-term archiving format PDF/A directly in your DocuWare file cabinet or in your document tray. Simply select DocuWare Printer from the printer list and give the print command.
The number of pages that can be printed with DocuWare Printer depends on the amount of text per document. DocuWare Printer supports the printing and storage of a maximum of 10,000 document pages per print job.
DocuWare Printer generates PDFs, so you should not print documents that are already in PDF format. This could cause problems with the processing of the document and its subsequent layout.
Printer with DocuWare Control
With the DocuWare Control font you can control processing of your documents with DocuWare Printer directly from your applications, e.g. from your ERP or MS Word. You do this by writing text commands in the DocuWare Control font in your documents or document templates. It does not matter which formatting, font size, or color is used. The commands are run if the document concerned is imported into DocuWare. You can select a complete printer configuration to be run for the relevant documents by text command. Alternatively you can add individual commands according to the DocuWare Printer functionalities, for instance to split the document at a specific place. As soon as a DocuWare Control command on the document has been recognized, the Document identification step is generally skipped.
The DocuWare Control (DWControl.ttf) font is automatically installed on your computer with the installation of DocuWare Desktop Apps. The DocuWare Control commands can only be written with this font. They are placed on empty areas of your document, like at the top or bottom of a page. Each individual command is part of a tag with a simple syntax:
The Syntax
Tag structure
If you use a command, insert it into a tag with a specific structure. Please note the following rules when creating a tag.
Each tag must begin with this character string:
<dwControl:The command then follows without spaces, for example to split the document:
NewDocumentThe tag ends with the following characters:
/>
The whole tag to split a document is therefore:
<dwControl:NewDocument/>
Attribute
Most commands must be specified in greater detail using attributes, for example in the case of SelectConfiguration enter the name of the configuration. In this case extend the tag as follows:
First enter the attribute; in the example the name is followed by an actual character:
<dwControl:SelectConfiguration name=Then enter the attribute value, in this case the name of the configuration, with the value in either single or double quotation marks. Close the tag with /> as described above:
<dwControl:SelectConfiguration name="Invoices"/>
Character
For the characters used in the tags, please note the following:
The character string "<dwControl:" is not permitted within the parameter values.
No single quotation marks are permitted within single quotation marks. You can, however, use double quotation marks.
No double quotation marks are permitted within double quotation marks. You can use single quotation marks.
Defining language and region
For numeric fields, the following table contains the abbreviation for the language and associated countries/regions
Abbreviation | Language – Country/Region |
---|---|
af | Afrikaans |
af-ZA | Afrikaans – South Africa |
sq | Albanian |
sq-AL | Albanian – Albania |
ar | Arabic |
ar-DZ | Arabic – Algeria |
ar-BH | Arabic – Bahrain |
ar-EG | Arabic – Egypt |
ar-IQ | Arabic – Iraq |
ar-JO | Arabic – Jordan |
ar-KW | Arabic – Kuwait |
ar-LB | Arabic – Lebanon |
ar-LY | Arabic – Libya |
ar-MA | Arabic – Morocco |
ar-OM | Arabic – Oman |
ar-QA | Arabic – Qatar |
ar-SA | Arabic – Saudi Arabia |
ar-SY | Arabic – Syria |
ar-TN | Arabic – Tunisia |
ar-AE | Arabic – United Arab Emirates |
ar-YE | Arabic – Yemen |
hy | Armenian |
hy-AM | Armenian – Armenia |
az | Azeri |
az-AZ-Cyrl | Azerbaijani (Cyrillic) – Azerbaijan |
az-AZ-Latn | Azerbaijani (Latin) – Azerbaijan |
eu | Basque |
eu-ES | Basque – Basque Country |
be | Belarusian |
be-BY | Belarusian – Belarus |
bg | Bulgarian |
bg-BG | Bulgarian – Bulgaria |
ca | Catalan |
ca-ES | Catalan – Catalonia |
zh-HK | Chinese – Hong Kong (Special Administrative Region) |
zh-MO | Chinese – Macao (Special Administrative Region) |
zh-CN | Chinese – China |
zh-CHS | Chinese (Simplified) |
zh-SG | Chinese – Singapore |
zh-TW | Chinese – Taiwan |
zh-CHT | Chinese (Traditional) |
hr | Croatian |
hr-HR | Croatian – Croatia |
cs | Czech |
cs-CZ | Czech – Czech Republic |
da | Danish |
da-DK | Danish – Denmark |
div | Dhivehi |
div-MV | Dhivehi – Maldives |
nl | Dutch |
nl-BE | Dutch – Belgium |
nl-NL | Dutch – Netherlands |
en | English |
en-AU | English – Australia |
en-BZ | English – Belize |
en-CA | English – Canada |
en-CB | English – Caribbean |
en-IE | English – Ireland |
en-JM | English – Jamaica |
en-NZ | English – New Zealand |
en-PH | English – Philippines |
en-ZA | English – South Africa |
en-TT | English – Trinidad and Tobago |
en-GB | English – Great Britain |
en-US | English – USA |
en-ZW | English – Zimbabwe |
et | Estonian |
et-EE | Estonian – Estonia |
fo | Faroese |
fo-FO | Faroese – Faroe Islands |
fa | Farsi |
fa-IR | Farsi – Iran |
fi | Finnish |
fi-FI | Finnish – Finland |
fr | French |
fr-BE | French – Belgium |
fr-CA | French – Canada |
fr-FR | French – France |
fr-LU | French – Luxembourg |
fr-MC | French – Monaco |
fr-CH | French – Switzerland |
gl | Galician |
gl-ES | Galician – Galicia |
ka | Georgian |
ka-GE | Georgian – Georgia |
de | German |
de-AT | German – Austria |
de-DE | German – Germany |
de-LI | German – Liechtenstein |
de-LU | German – Luxembourg |
de-CH | German – Switzerland |
el | Greek |
el-GR | Greek – Greece |
gu | Gujarati |
gu-IN | Gujarati – India |
he | Hebrew |
he-IL | Hebrew – Israel |
hi | Hindi |
hi-IN | Hindi – India |
hu | Hungarian |
hu-HU | Hungarian – Hungary |
is | Icelandic |
is-IS | Icelandic – Iceland |
id | Indonesian |
id-ID | Indonesian – Indonesia |
it | Italian |
it-IT | Italian – Italy |
it-CH | Italian – Switzerland |
ja | Japanese |
ja-JP | Japanese – Japan |
kn | Kannada |
kn-IN | Kannada – India |
kk | Kazakh |
kk-KZ | Kazakh – Kazakhstan |
kok | Konkani |
kok-IN | Konkani – India |
ko | Korean |
ko-KR | Korean – Korea |
ky | Kyrgyz |
ky-KG | Kyrgyz – Kyrgyzstan |
lv | Latvian |
lv-LV | Latvian – Latvia |
lt | Lithuanian |
lt-LT | Lithuanian – Lithuania |
mk | Macedonian |
mk-MK | Macedonian – Former Yugoslav Republic of Macedonia |
ms | Malay |
ms-BN | Malay – Brunei |
ms-MY | Malay – Malaysia |
mr | Marathi |
mr-IN | Marathi – India |
mn | Mongolian |
mn-MN | Mongolian – Mongolia |
no | Norwegian |
nb-NO | Norwegian (Bokmål) – Norway |
nn-NO | Norwegian (Nynorsk) – Norway |
pl | Polish |
pl-PL | Polish – Poland |
pt | Portuguese |
pt-BR | Portuguese – Brazil |
pt-PT | Portuguese – Portugal |
pa | Punjabi |
pa-IN | Punjabi – India |
ro | Romanian |
ro-RO | Romanian – Romania |
ru | Russian |
ru-RU | Russian – Russia |
sa | Sanskrit |
sa-IN | Sanskrit – India |
sr-SP-Cyrl | Serbian (Cyrillic) – Serbia |
sr-SP-Latn | Serbian (Latin) – Serbia |
sk | Slovakian |
sk-SK | Slovakian – Slovakia |
sl | Slovenian |
sl-SI | Slovenian – Slovenia |
es | Spanish |
es-AR | Spanish – Argentina |
es-BO | Spanish – Bolivia |
es-CL | Spanish – Chile |
es-CO | Spanish – Colombia |
es-CR | Spanish – Costa Rica |
es-DO | Spanish – Dominican Republic |
es-EC | Spanish – Ecuador |
es-SV | Spanish – El Salvador |
es-GT | Spanish – Guatemala |
es-HN | Spanish – Honduras |
es-MX | Spanish – Mexico |
es-NI | Spanish – Nicaragua |
es-PA | Spanish – Panama |
es-PY | Spanish – Paraguay |
es-PE | Spanish – Peru |
es-PR | Spanish – Puerto Rico |
es-ES | Spanish – Spain |
es-UY | Spanish – Uruguay |
es-VE | Spanish – Venezuela |
sw | Swahili |
sw-KE | Swahili – Kenya |
sv | Swedish |
sv-FI | Swedish – Finland |
sv-SE | Swedish – Sweden |
syr | Syrian |
syr-SY | Syrian – Syria |
ta | Tamil |
ta-IN | Tamil – India |
tt | Tatar |
tt-RU | Tatar – Russia |
te | Telugu |
te-IN | Telugu – India |
th | Thai |
th-TH | Thai – Thailand |
tr | Turkish |
tr-TR | Turkish – Turkey |
uk | Ukrainian |
uk-UA | Ukrainian – Ukraine |
ur | Urdu |
ur-PK | Urdu – Pakistan |
uz | Uzbek |
uz-UZ-Cyrl | Uzbek (Cyrillic) – Uzbekistan |
uz-UZ-Latn | Uzbek (Latin) – Uzbekistan |
vi | Vietnamese |
Defining date format
Define the date format according to the following model: Sample date is March 14, 2017.
Year (e.g. 2017)
- y = 7
- yy = 17
- yyy = 017
- yyyy = 2017Month (e.g. March)
- M = 3
- MM = 03
- MMMM = MarchDay (e.g. 14)
- d = 4
- dd = 14
You can use DocuWare Control also when importing documents: If you wish to import documents from external applications, e.g. from your ERP, to your DocuWare system, you can include the indexing data of the documents as XML files in the DocuWare Control format. You can find further information in the section Adding Metadata File with Indexing.
The commands
Select configuration: SelectConfiguration
This command skips the Identification step for the DocuWare Printer configuration and the defined configuration is directly selected and run. To define the configuration, enter its name as a value. From DocuWare Version 6.8, the following additional DocuWare Control commands are permitted for the document: Field, FileCabinet, DocumentTray. All other DocuWare Control commands are ignored.
Example tag: <dwControl:SelectConfiguration name='Rechnungen'/>
Select file cabinet: FileCabinet
This command selects a target file cabinet for the document. To define the file cabinet, enter the file cabinet name as a value.
Example tag:
<dwControl:FileCabinet name="Invoices"/>
Select document tray: Basket or DocumentTray
Both these commands select a target document tray for the document. To define the document tray, enter the document tray name as a value.
Example tag:
<dwControl:DocumentTray name="Inbox"/>
If the command Basket or DocumentTray, and the command FileCabinet, is found in a document, Basket or DocumentTray are given preference.
Add form/letterhead: Form
This command stores a form or letterhead for the document. The form/letterhead must be in PDF format. You can define the form/letterhead in two ways:
Enter the path within the file system for the path attribute.
<dwControl:Form path="C:\Forms\Letterhead.pdf"/>Or, for the configName attribute, enter the name of the DocuWare Printer configuration in which the form/letterhead is used. This option is useful, for instance, if users do not have access to the company file system.
Example tag:
<dwControl:Form configName="Letters" configForm="1"/>
Print on real printer: Print
This command prints out the document on a real printer. You define the device using the attribute device. If you do not want to print out a form that is attached to the document, specify this with the attribute withoutForm .
Example tag:
<dwControl:Print device="My letter printer" withoutForm="false"/>
If an additional document also needs to be printed, e.g. General Terms and Conditions of Business, you can define this with the additionalFilePath attribute.
<dwControl:Print device="My letter printer" additionalFilePath="C:\Terms\Conditions.pdf"/>
Sign document: Sign
This command provides the document with an electronic signature. To define the signature certificate, enter as the configName the name of the DocuWare printer configuration in which you selected the signature certificate attribute.
Example tag:
<dwControl:Form configName="Letters" configForm="1"/>
Split document: NewDocument
This command splits the document. To split the document in several places, place the command at each of the required positions.
Example tag:
<dwControl:NewDocument/>
Write data in field: Field
This command writes data into an index field, i.e. text field, keyword field, numeric field, or date field. The field is defined by its type, length, and name in each case.
Text field
Example tag:
<dwControl:Field dbName="Employee" type="Text" value="Mark Smith"/>Memo field
Example tag:
<dwControl:Field dbName="MEMO" type="Memo" value="This is text in the memo field."/>Keyword field
Example tag:
<dwControl:Field dbName="Remark" type="Keyword" value="one"/>
If several values need to be written into a keyword field, you will need several tags according to this model; in the case of a second tag:
<dwControl:Field dbName="Remark" type="Keyword" value="one"/>Numeric field / decimal field
Characters such as commas, periods, or colons are interpreted differently depending on language and region. You must therefore define language and region so that a value can be interpreted correctly. If a document needs to be stored in the document tray, the number of decimal places must also be indicated for the value.
Example tag numeric field:
<dwControl:Field dbName="Salary" type="Numeric" value="31.2" culture="en-US" decimalPlaces="2"/>
Example tag decimal field:
<dwControl:Field dbName="Salary" type="Decimal" value="31.2" culture="en-US" decimalPlaces="2"/>Date field
So that a value can be interpreted correctly, you must define language and region as with the numeric field. You must also define date format.
Example tag:
<dwControl:Field dbName="EmploymentDate" type="Date" value="2010-04-03" culture="en-US" format="yyyy-MM-dd"/>
Attach document to email: Email
You automatically attach the document to a new email using this command: During processing your email client opens with the document in the attachment. You can already specify the subject, content, and name of the document.
Example tag:
<dwControl:Email to="receiver@domain.com" subject="Invoice 321" attachmentName="invoice321" body="Dear customer, Please find enclosed our invoice no. 321. Would you please pay it. Best regards, The Company" newlineMarker=" " />