OneOffixx Connect Struktur
- 1 Arguments
- 1.1 TemplateId: Auswahl der Vorlage
- 1.2 TemplateTags: Auswahl der Vorlage
- 1.3 LanguageLcid: Auswahl der Sprache
- 1.4 DocumentLocation: Auswahl eines bestehenden Dokuments
- 1.5 ProfileId: Auswahl des Profils
- 1.5.1 Über Profil-ID
- 1.5.2 Über Profilname
- 1.6 ThemeId
- 1.7 OrganizationId: Auswahl der Organisationseinheit
- 1.7.1 Über Organisations-ID
- 1.7.2 Über Abfrage
- 1.8 Version: Auswahl der Dokumentversion
- 1.9 Editor: Auswahl des Modus (für Type Data)
Arguments
Über die Connect-Arguments können Vorlage, Sprache, Profil, Organsiationseinheit und andere Parameter für den Aufruf definiert werden.
<OneOffixxConnectBatch>
<Entries>
<OneOffixxConnect>
<Arguments>
... hier gehören die Argumente hin
</Arguments>
...
</OneOffixxConnect>
</Entries>
</OneOffixxConnectBatch>
TemplateId: Auswahl der Vorlage
Über die TemplateId wird die Vorlage für die Dokumentverarbeitung gewählt. Als Angabe dafür muss die genaue GUID der Vorlage übergeben werden.
<TemplateId>6bb49520-1ebd-4f68-bb5f-02f46a9e1ec8</TemplateId>
TemplateTags: Auswahl der Vorlage
<TemplateFilter>
<Tag>Tag1</Tag>
<Tag>Tag2;Tag3;Tag4</Tag>
</TemplateFilter>
AND-Verknüpfungen werden innerhalb eines Tag-Elements durch Semikolons getrennt definiert, OR-Verknüpfungen durch mehrere Tag-Elemente. Das obige Beispiel zeigt alle Vorlagen, die mit Tag1 oder Tag2, Tag3 und Tag4 markiert sind. Gibt es mehrere Vorlagen, die den Filterkriterien entsprechen oder wird weder ein TemplateTag noch eine TemplateId angegeben, öffnet sich ein Auswahldialog, durch den der Benutzer die gewünschte Vorlage auswählen kann.
TemplateTags können auch serverseitig genutzt werden. Falls es mehrere Vorlagen gibt, die dem Filterkriterium entsprechen, wird stets der erste Eintrag genommen. Die Reihenfolge ist dabei nicht garantiert!
LanguageLcid: Auswahl der Sprache
Über LanguageLcid wird die Dokumentsprache für die Verarbeitung gesetzt. Es muss eine genaue LCID angegeben werden. Die meistgenutzten LCIDs sind:
LCID | Tag | Sprache |
---|---|---|
1031 | de-DE | Deutsch - Deutschland |
2055 | de-CH | Deutsch - Schweiz |
1033 | en-US | Englisch - Vereinigte Staaten von Amerika |
2057 | en-GB | Englisch - Grossbritannien |
4108 | fr-CH | Französisch - Schweiz |
1036 | fr-FR | Französisch - Frankreich |
2064 | it-CH | Italienisch - Schweiz |
1040 | it-IT | Italienisch - Italien |
DocumentLocation: Auswahl eines bestehenden Dokuments
Über die DocumentLocation können bestehende Dokumente aktualisiert oder zwei bestehende Dokumente zusammengeführt werden.
ProfileId: Auswahl des Profils
Über das ProfileId-Element kann ein bestimmtes Profil ausgewählt werden. Ohne Angabe eines expliziten Profiles wird das aktuelle Profile des primedocs-Clients verwendet bzw. auf Serverseite das erste Profil des jeweiligen Benutzers. Es gibt zwei Möglichkeiten, das Profil auszuwählen:
Über Profil-ID
Über Profilname
Diese Funktion steht nur in Client-Seitig zur Verfügung.
ThemeId
Diese Funktion steht nur in den neuen Vorlagtypen zur Verfügung. Weitere Informationen finden Sie hier.
Über das ThemeId-Element kann ein bestimmtes Thema ausgewählt werden. Ohne Angabe eines expliziten Theme wird das Standard Theme von der Organisationseinheit genutzt.
OrganizationId: Auswahl der Organisationseinheit
Diese Option erlaubt es, eine beliebige (freigegebene) Organisation in der Profildaten- und Themes-Dokumentfunktion zu nutzen. Wird die angegebene Organisation gefunden, werden für den Aufruf die entsprechenden Organisationsdaten genutzt. Sie kann über zwei Arten gesucht werden.
Über Organisations-ID
Über Abfrage
Im Feldnamen können alle konfigurierten Felder für Organisationseinheiten genutzt werden. Werden mehrere Organisationen gefunden, wird die erste genommen, wobei keine Reihenfolge garantiert ist.
Die Syntax lautet dabei: { Feldname = Wert }
WICHTIG
Die gefundene Organisationseinheit ersetzt die eigentlich konfigurierte Organisationseinheit für das aktuell ausgewählte Profil während der Dokumenterstellung.
In Kombination mit dem TemplatePicker kann zwar ein beliebiges Profil gewählt werden, jedoch werden trotz der Auswahl die Organisationsdaten aus dem Connect Aufruf verwendet.
Version: Auswahl der Dokumentversion
Mittels der Versionsangabe kann exakt gesteuert werden, welche Version der Vorlage dabei im Editor geöffnet wird. Wenn mit Filter oder ohne TemplateId aufgerufen wird, kann dazu auch der TemplatePicker benutzt werden.
Folgende Werte sind möglich:
Wert | Id-Typ | Version der ausgewählten Vorlage | Aufgelöste Version der Abhängigkeiten | Template-Picker |
---|---|---|---|---|
Published | Template-ID | Published | Published | ✓ |
PublishedDraft | Template-ID | Published | Draft | ✓ |
Draft | Template-ID | Draft | Draft | ✓ |
SpecificDraft | Versions-Template-Id | Specific | Draft |
|
SpecificPublished | Versions-Template-Id | Specific | Published |
|
Editor: Auswahl des Modus (für Type Data)
Falls Connect mit Type Data eingesetzt wird, kann über diesen Parameter festgelegt werden, dass die Vorlage im Editor-Modus in Word geöffnet werden soll, um die Felder zu platzieren.
PrimeSoft AG, Bahnhofstrasse 4, 8360 Eschlikon, Switzerland