Überblick

Ist bereits eine OneOffixx Connect Lösung im Einsatz und sollen nun auch webfähige primedocs Vorlagen mit Connect genutzt werden können, kann die primedocsConnectBridge genutzt werden.

Die primedocsConnectBridge wird nur verwendet, wenn man sowohl “classic” als auch webfähige Vorlagen nutzen möchte.

Nutzt man ausschliesslich webfähige Vorlagen, kann man direkt primedocs Connect nutzen.

Über die primedocsConnectBridge können Daten an die Formulare (Forms) bzw. Data Funktion übergeben werden. “classic” Vorlagen ignorieren die Daten in diesem Element und erhalten nach wie vor ihre Daten über die OneOffixx Connect Funktionen (“DocumentParameter”, “Recipient”, “CustomInterfaceConnector”, etc).

Struktur

Die primedocsConnectBridge ist ein Kind-Element von OneOffixxConnect:

<OneOffixxConnectBatch>
  <Entries>
    <OneOffixxConnect>
    	...
        <primedocsConnectBridge>
            <Data />
            <Forms />
        </primedocsConnectBrigde
      </OneOffixxConnect>
  </Entries>
</OneOffixxConnectBatch>

Innerhalb der primedocsConnectBridge stehen Data und Forms zur Verfügung. Der Aufbau innerhalb dieser Elemente ist identisch zum Aufbau in primedocs Connect.

“classic”-Vorlagen vs. webfähige Vorlagen

Die primedocsConnectBridge fungiert nur als Brücke für webfähige Vorlagen. Allenfalls müssen alle Daten, welche vorher z. B. im Dokument-Parameter angegeben wurden, auch in Forms angegeben werden.

Da es keine Recipient-Funktion in webfähigen Vorlagen gibt, muss ein “Daten-Container” in Forms bzw. Data konfiguriert werden.

Beispiel

<OneOffixxConnectBatch>
  <Entries>
    <OneOffixxConnect>

      <Arguments>
        <!-- primedocs Template -->
        <TemplateId>30b55516-80b5-41d7-801b-b31d6da376ac</TemplateId>
      </Arguments>

      <!-- DocParam etc. can also be specified for classic templates... -->
      
      <!-- This part will only be used with modern primedocs templates -->
      <primedocsConnectBridge>
        <Forms>
          <Value Key="Subject">Test Subject</Value>
        </Forms>
        <Data>
          <Object Key="TestObjectA">
            <Value Key="InObjectATestA">Value A in Object A</Value>
            <Value Key="InObjectATestB">Value B in Object B</Value>
          </Object>
        </Data>
      </primedocsConnectBridge>

      <!-- OneOffixxConnect Commands etc. can be used as well -->
      <Commands>
        <Command Name="ConvertToDocument" />
        <Command Name="SaveAs">
          <Parameters>
            <Add key="Filename">c:\temp\sample.docx</Add>
            <Add key="Overwrite">true</Add>
            <Add key="CreateFolder">true</Add>
            <Add key="CopyOnly">false</Add>
            <Add key="AllowUpdateDocumentPart">false</Add>
          </Parameters>
        </Command>
      </Commands>
    </OneOffixxConnect>
  </Entries>
</OneOffixxConnectBatch>