Wird primedocs aus einer Fachapplikationen heraus aufgerufen, können fachapplikationsspezifische Daten an die Vorlage übergeben werden. Element- und Attributnamen sind frei wählbar bzw. können von der Fachapplikation definiert und angepasst werden. Pro Schnittstelle muss ein eindeutiger Schnittstellename definiert werden. Dadurch ist primedocs in der Lage, die Daten intern zu transformieren und für die Dokumentgenerierung aufzubereiten.
<Interface Name="ExampleInterface" />
Beispielkonfiguration:
<Function name="CustomInterfaceConnector" id="70E94788-CE84-4460-9698-5663878A295B">
<Arguments>
<Interface Name="ExampleInterface">
<Node Id="KeyA">ValueA</Node>
<Node Id="KeyB">ValueB</Node>
<Node Id="KeyC">ValueC</Node>
</Interface>
</Arguments>
</Function>
Transformation
primedocs transformiert das XML der Fachapplikation in ein internes Format. Dazu muss in der Vorlage die Dokumentfunktion Connect-Schnittstellendefinition angehängt und konfiguriert werden.
Es ist möglich, Bilder in Form einer URL oder im Base64-Format zu übergeben. Dafür muss im Node Element das Attribut Type="Image" zusätzlich angeben werden. Sofern eine URL übergeben wird, muss der Client und/oder der Server Lesezugriff auf die Bilder haben.
Beispiel einer Transformationskonfiguration; die Elementinhalte werden als Beispielinhalte während der Designphase verwendet:
<InterfaceDescription Name="CollectionDemo">
<Node Id="SimpleBindingOne" XPath="//SimpleBindingOne">SimpleBindingOneText</Node>
<Node Id="SimpleBindingTwo" XPath="//SimpleBindingTwo">SimpleBindingTwoText</Node>
<Node Id="SimpleBindingThree" XPath="//SimpleBindingThree">SimpleBindingThreeText</Node>
<NodeCollection Id="ListBinding" XPath="//List/EachElement">
<Node Id="Firstname" XPath="./FirstName" /> // these Elements are beneath <EachElement>
<Node Id="Surname" XPath="./Surname" /> // these Elements are beneath <EachElement>
<NodeCollection Id="Orders" XPath="./Orders/Order"> // even Collection in Collections are supported
<Node Id="OrderId" XPath="./Id" />
<Node Id="OrderProduct" XPath="./Product" />
</NodeCollection>
</NodeCollection>
<!-- Bild wird im Base64-Format übergeben -->
<Node Id="PictureSample" Type="Image" XPath="//PictureSample" >iVBORw0KGgoAAAANSUhEUgAAAF8AAAB4CAIAAAAbh7ksAAAAAXNSR0IArs4c6QAAAARnQU1BAACx
jwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAAZdEVYdFNvZnR3YXJlAHBhaW50Lm5ldCA0LjAu
MTHaDTpWAAAA8UlEQVR4Xu3QQQ0AIAwAMfz/UIS0oWCnoEkV9Nw3bOwUO8VOsVPsFDvFTrFT7BQ7
xU6xU+wUO8VOsVPsFDvFTrFT7BQ7xU6xU+wUO8VOsVPsFDvFTrFT7BQ7xU6xU+wUO8VOsVPsFDvF
TrFT7BQ7xU6xU+wUO8VOsVPsFDvFTrFT7BQ7xU6xU+wUO8VOsVPsFDvFTrFT7BQ7xU6xU+wUO8VO
sVPsFDvFTrFT7BQ7xU6xU+wUO8VOsVPsFDvFTrFT7BQ7xU6xU+wUO8VOsVPsFDvFTrFT7BQ7xU6x
U+wUO8VOsVPsFDvFTrFT7BQ7xc7uzQeYsdPzpHNxAAAAAABJRU5ErkJggg==</Node>
<!-- Bild wird als URL übergeben -->
<Node Id="PictureFilePathSample" Type="Image" XPath="//PictureFilePathSample" /> <!-- The file path needs file:// as a prefix -->
</InterfaceDescription>
Beispiel-Aufruf, wobei eine Transformation konfiguriert wird:
<Function name="CustomInterfaceConnector" id="70E94788-CE84-4460-9698-5663878A295B">
<Arguments>
<Interface Name="ExampleInterface">
<Allgemein>
<Telefon_a>#Telefon_a#</Telefon_a>
<Telefon_b>#Telefon_b#</Telefon_b>
<Homepage>#Homepage#</Homepage>
<akadTitel>#akadTitel#</akadTitel>
<TelefonSekretariat>#TelefonSekretariat#</TelefonSekretariat>
<ObjKeyOrgProfile>#ObjKeyOrgProfile#</ObjKeyOrgProfile>
<PictureFilePath>http://www.mycompany.com/files/pics/Bild_1234.jpg</PictureFilePath>
<Picture>iVBORw0KGgoAAAANSUhEUgAAAF8AAAB4CAIAAAAbh7ksAAAAAXNSR0IArs4c6QAAAARnQU1BAACx
jwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAAZdEVYdFNvZnR3YXJlAHBhaW50Lm5ldCA0LjAu
MTHaDTpWAAAA8UlEQVR4Xu3QQQ0AIAwAMfz/UIS0oWCnoEkV9Nw3bOwUO8VOsVPsFDvFTrFT7BQ7
xU6xU+wUO8VOsVPsFDvFTrFT7BQ7xU6xU+wUO8VOsVPsFDvFTrFT7BQ7xU6xU+wUO8VOsVPsFDvF
TrFT7BQ7xU6xU+wUO8VOsVPsFDvFTrFT7BQ7xU6xU+wUO8VOsVPsFDvFTrFT7BQ7xU6xU+wUO8VO
sVPsFDvFTrFT7BQ7xU6xU+wUO8VOsVPsFDvFTrFT7BQ7xU6xU+wUO8VOsVPsFDvFTrFT7BQ7xU6x
U+wUO8VOsVPsFDvFTrFT7BQ7xc7uzQeYsdPzpHNxAAAAAABJRU5ErkJggg==</Picture>
</Allgemein>
<Auftrag>
<EntscheidDatum>#EntscheidDatum#</EntscheidDatum>
<VersandDatum>#VersandDatum#</VersandDatum>
<SBEntscheid>#SBEntscheid#</SBEntscheid>
<VerfuegungTitel>#VerfuegungTitel#</VerfuegungTitel>
<verrechnungstabelle>
<vteintrag>
<vtperiode>@01.01.1900-01.01.2016</vtperiode>
<vtanspruch>@11'600.00</vtanspruch>
<vtzurueckbezahlt>@1'234.00</vtzurueckbezahlt>
<vtoffen>@5'000.00</vtoffen>
</vteintrag>
<vteintrag>
<vtperiode>@01.01.1901-01.01.2016</vtperiode>
<vtanspruch>@11'600.01</vtanspruch>
<vtzurueckbezahlt>@1'234.01</vtzurueckbezahlt>
<vtoffen>@5'000.01</vtoffen>
</vteintrag>
</verrechnungstabelle>
<VTtotalText>#VTtotalText#</VTtotalText>
<VTTotal>#VTTotal#</VTTotal>
</Auftrag>
</Interface>
</Arguments>
</Function>
Beispiel der dazugehörigen Connectfiles:
<?xml version="1.0" encoding="UTF-8"?>
<OneOffixxConnectBatch xmlns="http://schema.oneoffixx.com/OneOffixxConnectBatch/1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Entries>
<OneOffixxConnect>
<Arguments>
<LanguageLcid>2055</LanguageLcid>
<TemplateId>a032bdcc-78b9-4eda-a75f-d8394226b91f</TemplateId>
</Arguments>
<Function name="CustomInterfaceConnector" id="70E94788-CE84-4460-9698-5663878A295B">
<Arguments>
<Interface Name="CollectionDemo">
<!-- SimpleBindings werden nicht in einer NodeCollection übergeben -->
<SimpleBindingOne>1</SimpleBindingOne>
<SimpleBindingTwo>2</SimpleBindingTwo>
<SimpleBindingThree>3</SimpleBindingThree>
<List>
<!-- Äussere NodeCollection -->
<NodeCollection Id="Row1">
<FirstName>Max</FirstName>
<Surname>Muster</Surname>
<Orders>
<!-- Verschachtelte NodeCollection im Element <Orders> der übergeorneten NodeCollection -->
<NodeCollection Id="Row1">
<Id>123-321</Id>
<Product>Keyboard</Product>
</NodeCollection>
</Orders>
</NodeCollection>
</List>
<!-- Bild wird im Base64-Format übergeben -->
<PictureSample>iVBORw0KGgoAAAANSUhEUgAAAF8AAAB4CAIAAAAbh7ksAAAAAXNSR0IArs4c6QAAAARnQU1BAACx
jwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAAZdEVYdFNvZnR3YXJlAHBhaW50Lm5ldCA0LjAu
MTHaDTpWAAAA8UlEQVR4Xu3QQQ0AIAwAMfz/UIS0oWCnoEkV9Nw3bOwUO8VOsVPsFDvFTrFT7BQ7
xU6xU+wUO8VOsVPsFDvFTrFT7BQ7xU6xU+wUO8VOsVPsFDvFTrFT7BQ7xU6xU+wUO8VOsVPsFDvF
TrFT7BQ7xU6xU+wUO8VOsVPsFDvFTrFT7BQ7xU6xU+wUO8VOsVPsFDvFTrFT7BQ7xU6xU+wUO8VO
sVPsFDvFTrFT7BQ7xU6xU+wUO8VOsVPsFDvFTrFT7BQ7xU6xU+wUO8VOsVPsFDvFTrFT7BQ7xU6x
U+wUO8VOsVPsFDvFTrFT7BQ7xc7uzQeYsdPzpHNxAAAAAABJRU5ErkJggg==</PictureSample>
<!-- Bild wird als URL übergeben -->
<PictureFilePathSample>file://C:/Users/user/Desktop/Image3.png</PictureFilePathSample>
</Interface>
</Arguments>
</Function>
</OneOffixxConnect>
</Entries>
</OneOffixxConnectBatch>
Data CustomInterface
Wird das Interface mit type='Data' mitgegeben, muss kein konfiguriertes Interface in der Konfiguration hinterlegt sein. Die Daten werden als CustomXmlNodes interpretiert und sind sowohl im Editor als auch im Dokument verfügbar.
Beispiel:
<Function name="CustomInterfaceConnector" id="70E94788-CE84-4460-9698-5663878A295B" xmlns="">
<Arguments>
<Interface Name="ReportAusFachapplikation" type="Data">
<Text Id="ID">42</Text>
<Text Id="Vorname">Max</Text>
<Text Id="Ort">Eschlikon TG</Text>
<Text Id="Nachname">Mustermann</Text>
<Text Id="Zivilstand">verheiratet</Text>
<DateTime Id="Geburtsdatum">1998-09-01</DateTime>
<Collection Id="Telefonnummern">
<Element>
<Text Id="Mobil">012 345 67 89</Text>
<Text Id="Festnetz">012 345 67 89</Text>
</Element>
</Collection>
</Interface>
</Arguments>
</Function>