Printer

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.

  1. Each tag must begin with this character string:
    <dwControl:

  2. The command then follows without spaces, for example to split the document:
    NewDocument

  3. The 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:

  1. First enter the attribute; in the example the name is followed by an actual character:
    <dwControl:SelectConfiguration name=

  2. 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.

More information about DocuWare Control

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.

  1. Year (e.g. 2017)
    - y = 7
    - yy = 17
    - yyy = 017
    - yyyy = 2017

  2. Month (e.g. March)
    - M = 3
    - MM = 03
    - MMMM = March

  3. Day (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,&#10; Please find enclosed our invoice no. 321. Would you please pay it.&#10;Best regards,&#10;The Company" newlineMarker="&#10;" />