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:

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 primedocs-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>

ThemeId

Über das ThemeId-Element kann ein bestimmtes Thema ausgewählt werden. Ohne Angabe eines expliziten Theme wird das Standard Theme von der Organisationseinheit genutzt.

<Profile>
  <ThemeId>CustomThemeId</ThemeId>
</Profile>

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 }

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:

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>