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

Bei ausschliesslicher Nutzung von webfähigen Vorlagen kann direkt primedocs Connect genutzt werden.

Ü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 />
      </primedocsConnectBridge>
    </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>