Elemente der Elemente der verschiedenen XML’sKonfigurationsdateien
Die Konfiguration des docxworld.COLLI kann über 2 verschiedene Konfigurationsdateien erfolgen. Hierbei gibt es die Basis-Es gibt zwei verschiedene Arten von XML’s. Dabei wird unterschieden zwischen der Konfigurationsdatei (config.xml) und der erweiterten eine optionale erweiterte Konfigurationsdatei (additional_config.xml).
In der Basis-Konfigurationsdatei (config.xml) können Konfigurationsgruppen und der Pfad zur erweiterten Konfigurationsdatei (additional_config.xml) angegeben werden. Bei der erweiterten Konfigurationsdatei (additional_config.xml) ist es nur möglich mehrere weitere Konfigurationsitems anzugeben.
...
Element | Werte | Beschreibung |
|---|
additionalConfigGroups | href | Innerhalb einer Konfigurationsgruppe kann man eine erweiterte Konfigurationsdatei angeben. Dafür muss man das Element additionalConfigGroups mit dem Wert href hinzufügen. Beim Wert href ist der Pfad anzugeben, wo die erweiterte Konfigurationsdatei liegt. |
configGroups | description, displayName | In der Konfigurationsgruppe <configGroups> kann man eine Beschreibung <description> und den Anzeigenamen <displayName> für die UI angeben. Der Anzeigename darf maximal 16 Zeichen lang sein. Innerhalb einer Konfigurationsgruppe können mehrere Konfigurationsitem Konfigurationsitems <configGroup> mit einem Anzeigename <displayName> festgelegt werden. Der Anzeigename eines Konfigurationsitems darf maximal 64 Zeichen lang sein. |
| license | Lizenzschlüssel |
|
| templatesFolder |
| Hier muss der Pfad hinterlegt werden, wo sich die PDF-Vorlagen befinden. |
Konfigurationsitem
Element | Werte | Beschreibung |
|---|
addressPosition | x, y, width, height | Bei der Adressenposition muss man den Startpunkt x und y angeben, ausgerichtet an der oberen, linken Ecke. Zusätzlich muss die Breite und Höhe angegeben werden, in welchem Bereich die Adresse auf dem Dokument erwartet wird. |
pdfOptions | embedAddress | Damit kann entschieden werden, ob vor dem Absenden eines Dokumentes der Endnutzer, noch die Postleitzahl und das Länderkennzeichen erfassen muss. |
url |
| Es muss mind. 1 Spooler-URL pro Konfigurationsitem angegeben werden. Wenn mehrere Spooler-URL’s angegeben werden, dann werden diese nach dem Failover Ansatz abgearbeitet. |
variable | key, value | Bei einer Variablen muss es einen Schlüssel mit einem Wert geben. Diese beiden Angaben , werden dann mit an den Spooler gesendet. |
Beispiele
| Erweitern |
|---|
| title | Basis-Konfigurationsdatei (config.xml) |
|---|
|
| Auszug |
|---|
für eine XML |
| Codeblock |
|---|
| <?xml version="1.0" encoding="UTF-8"?>
<config version="1.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<configGroups description="Konfigurationsgruppe" displayName="Dokumentenart">
<configGroup displayName="Mahnung">
<addressPosition x<addressPosition x="15" y="45" width="85" height="45"/>
<pdfOptions embedAddress="false"/>
<url>spooler1:9093</url>
<url>spooler1 <url>http://spooler:9090</url>
<url>http://spooler:9091</url>
<url>http://spooler:9092</url>
<variable key="SpoolerVarMarkeOderWorkflow" value="mahnung"/>
<variable key<variable key="key1" value="val1"/>
</configGroup>
<configGroup displayName="Rechnung">
<addressPosition x="25" y="60" width="76" height="30"/>
<pdfOptions embedAddress="true"/>
<url>http<url>hhttp://localhost:62616/oms/upload<spooler:9090</url>
<variable key="SpoolerVarMarkeOderWorkflow" value="weltbildrechnung_de"/>
<</configGroup>
<additionalConfigGroups href="<Pfad wo die Datei liegt>"/>
</configGroups>
<license></license>
<templatesFolder>Pfad
wo die Datei liegt>
<templatesFolder>C:\Users\Username\Documents\Templates</templatesFolder>
</config> |
|
code
language| Erweitern |
|---|
| xml | title | aktueller baseConfigSchema.xsd |
|---|
|
| Codeblock |
|---|
| <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="config">
<xs:complexType>
<xs:sequence>
<xs:element name="configGroups" minOccurs="1" maxOccurs="1">
<xs:complexType>
<xs:sequence>
<xs:element name="configGroup" minOccurs="1" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="addressPosition" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:attribute name="x" type="xs:integer" use="required"/>
<xs:attribute name="y" type="xs:integer" use="required"/>
<xs:attribute name="width" type="xs:integer" use="required"/>
<xs:attribute name="height" type="xs:integer" use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="pdfOptions" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:attribute name="embedAddress" type="xs:boolean" use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="url" type="xs:anyURI" minOccurs="1" maxOccurs="unbounded"/>
<xs:element name="variable" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:attribute name="key" type="xs:string" use="required"/>
<xs:attribute name="value" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="displayName" use="required">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="64"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
<xs:element name="additionalConfigGroups" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:attribute name="href" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="description" type="xs:string" use="required"/>
<xs:attribute name="displayName" use="required">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="16"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
<xs:element name="license"/>
<xs:element name="templatesFolder" minOccurs="1" maxOccurs="1"/>
<xs:element name="showAddressRectangles" minOccurs="0">
<xs:simpleType>
<xs:restriction base="xs:boolean"/>
</xs:simpleType>
</xs:element>
</xs:sequence>
<xs:attribute name="version" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
</xs:schema> |
|
| Erweitern |
|---|
| title | erweiterte Konfigurationsdatei (additional_config.xml) |
|---|
|
| title | aktueller additionalConfigSchema.xsd<?xml version="1.0" encoding="UTF-8"?>
<additionalConfigGroups xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<configGroup displayName="Information">
<addressPosition x="50" y="50" width="300" height="150" />
<pdfOptions embedAddress="true"/>
<url>http://spooler:9093</url>
<url>http://spooler:9094</url>
<url>http://spooler:9095</url>
<url>http://spooler:9096</url>
<variable key="SpoolerVarMarkeOderWorkflow" value="information" />
</configGroup>
<configGroup displayName="Abschlagsrechnung">
<addressPosition x="20" y="55" width="85" height="40"/>
<url>http://spooler:9093</url>
<url>http://spooler:9094</url>
<variable key="SpoolerVarMarkeOderWorkflow" value="abschlagsrechnung"/>
</configGroup>
</additionalConfigGroups> |
|
|---|
| Erweitern |
|---|
| title | additionalConfigSchema.xsd |
|---|
|
| Codeblock |
|---|
| <xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="additionalConfigGroups">
<xs:complexType>
<xs:sequence>
<xs:element name="configGroup" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="addressPosition" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:attribute name="x" type="xs:integer" use="required"/>
<xs:attribute name="y" type="xs:integer" use="required"/>
<xs:attribute name="width" type="xs:integer" use="required"/>
<xs:attribute name="height" type="xs:integer" use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="pdfOptions" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:attribute name="embedAddress" type="xs:boolean" use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="url" type="xs:anyURI" minOccurs="1" maxOccurs="unbounded"/>
<xs:element name="variable" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:attribute name="key" type="xs:string" use="required"/>
<xs:attribute name="value" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="displayName" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema> |
|