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 verbunden werden.

<DocumentLocation>c:\Temp\Doc1.docx</DocumentLocation>

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 OneOffixx-Clients verwendet bzw. auf Serverseite das erste Profil des jeweiligen Benutzers. Es gibt zwei Möglichkeiten, das Profil auszuwählen:

Über Profil-ID

<ProfileId>25558547-a6fb-4fad-908b-63118dcee5c9</ProfileId>

Über Profilname

<ProfileId>Hans Muster</ProfileId>

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

<Profile>
  <OrganizationId>25558547-a6fb-4fad-908b-63118dcee5c9</OrganizationId>
</Profile>

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

<Profile>
  <OrganizationId>{Org.Name = IT-Abteilung}</OrganizationId>
</Profile>

Die Syntax lautet dabei: { Feldname = Wert }

Important

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

<Version>Draft</Version>

Mittels der Version-Angabe 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.

<Editor>true</Editor>