Überblick

Ist bereits eine OneOffixx Connect Lösung im Einsatz und es sollen nun auch Vorlagen der neusten Generation (“primedocs Vorlagen” bzw. nicht “classic”-Vorlagen) genutzt werden können, kann die primedocsConnectBridge genutzt werden.

Die primedocsConnectBridge sollte nur genutzt werden, wenn man sowohl “classic” als auch primedocs Vorlagen nutzen möchte.
Nutzt man nur primedocs Vorlagen, kann man primedocs Connect direkt nutzen.

Über die primedocsConnectBridge können Daten an 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 vom 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. primedocs Vorlagen

Die primedocsConnectBridge fungiert nur als Brücke für nicht “classic” Vorlagen. Im Zweifel müssen alle Daten, welche z.B. vorher im Dokumentparameter angegeben wurden, auch in Forms angegeben werden.

Da es keine Recipient-Funktion in modernen Vorlagen gibt, muss sich 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>