OneOffixx-Connect (Legacy-Format)

Neben dem primedocs Connect versteht primedocs weiterhin das ältere XML-Format OneOffixx-Connect mit dem Wurzelelement <OneOffixxConnectBatch>. Bestehende Anbindungen, etwa aus einem GEVER-System, laufen damit unverändert weiter. Neue Anbindungen verwenden primedocs Connect.

Verarbeitung

• Clientseitig: primedocs Desktop verarbeitet eine OneOffixx-Connect-Datei wie eine Connect-Datei, zum Beispiel über den Protokollhandler mit connector=. Neue Dokumente und das Aktualisieren bestehender Dokumente sind möglich.
• Serverseitig: Die Server-Applikation Connect nimmt OneOffixx-Connect-XML entgegen und liefert das erzeugte Dokument zurück. Sie ist als veraltet markiert und erstellt nur neue Dokumente. Enthält ein Aufruf keinen Eintrag, der ein neues Dokument erstellt (auch nicht im Editor-Modus), antwortet sie mit HTTP 400. Für neue serverseitige Anbindungen die Connect API verwenden.

Aufbau

<?xml version="1.0" encoding="utf-8"?>
<OneOffixxConnectBatch>
  <Entries>
    <OneOffixxConnect>
      <Arguments>
        <TemplateId>6f1c2b1e-0000-4000-8000-000000000001</TemplateId>
        <LanguageLcid>2055</LanguageLcid>
      </Arguments>
      <primedocsConnectBridge>
        <Forms>
          <Value Key="Subject">Offerte Nr. 2026-0815</Value>
        </Forms>
        <Data>
          <Value Key="CaseNumber">2026-0815</Value>
        </Data>
      </primedocsConnectBridge>
    </OneOffixxConnect>
  </Entries>
</OneOffixxConnectBatch>

Unter <Arguments> steht die Vorlage als <TemplateId> oder als <TemplateFilter> mit einem oder mehreren <Tag>-Elementen, ein bestehendes Dokument als <DocumentLocation>. Weitere Argumente sind unter anderem LanguageLcid, ProfileId und Organization.

Webfähige Vorlagen und primedocsConnectBridge

Über OneOffixx-Connect lassen sich auch webfähige Vorlagen erstellen. Deren Formular- und Datenwerte stehen im Element <primedocsConnectBridge>, mit denselben Elementen wie Forms und Data im primedocs Connect: Value, Object und ObjectCollection, jeweils mit dem Attribut Key.

Das Ergebnis einer webfähigen Vorlage ist ein Dokument, keine Vorlagendatei. primedocs Desktop öffnet es wie beim Erstellen aus primedocs als .docx, .xlsx oder .pptx. Die Server-Applikation liefert es unter seinem Dokumentnamen, ohne Namen als result.docx, result.xlsx oder result.pptx. Weder die Einstellung AutoConvertToDocument noch der Befehl ConvertToDocument sind dafür nötig. Nur im Editor-Modus von primedocs Desktop bleibt das Ergebnis eine Vorlage (.dotx, .xltx oder .potx). Für classic-Vorlagen bleibt das bisherige Verhalten bestehen.

Bestehendes Dokument aktualisieren

Enthält <Arguments> ein nicht leeres <DocumentLocation>, aktualisiert primedocs das Dokument an diesem Ort. Das gilt auch dann, wenn zusätzlich <TemplateId> oder <TemplateFilter> gesetzt ist. Ein neues Dokument entsteht nur ohne <DocumentLocation>. Das entspricht dem Verhalten von primedocs Connect, siehe Aktualisieren von Dokumenten.

Enthält die Datei keine <Commands>, weder im Eintrag noch auf Ebene des Batches, speichert primedocs das aktualisierte Dokument am selben Ort und öffnet es. Ist das Dokument aus einer webfähigen Vorlage entstanden, übernimmt primedocs die Werte aus <primedocsConnectBridge>. Nicht mitgelieferte Werte bleiben dabei erhalten, siehe Mitgelieferte und nicht mitgelieferte Werte.