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 erstellt es wie beim Erstellen aus primedocs als .docx, .xlsx oder .pptx. Ob es anschliessend geöffnet wird, hängt von den Commands ab, siehe Dokument mit DefaultProcess öffnen. 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.

Dokument mit DefaultProcess öffnen

In primedocs Desktop öffnet DefaultProcess mit Start=true das Dokument. Ein ausdrücklich angegebenes <Command Name="DefaultProcess" /> ohne Start oder mit Start=false führt keine Aktion aus. Die Dokumenterstellung wird dadurch nicht verhindert. Dieser Befehl öffnet das Dokument jedoch nicht.

Bei neuen Dokumenten ergänzt primedocs automatisch DefaultProcess mit Start=true, wenn im Eintrag kein DefaultProcess vorhanden ist und der Batch keine eigenen Befehle enthält. Das gilt auch, wenn der Eintrag andere Befehle enthält. Ein vorhandener DefaultProcess wird nicht um Start ergänzt.

Um das Dokument ausdrücklich zu öffnen, folgenden Block als Kind von <OneOffixxConnect> einsetzen, neben <Arguments> und <primedocsConnectBridge>:

<Commands>
  <Command Name="DefaultProcess">
    <Parameters>
      <Add key="Start">true</Add>
    </Parameters>
  </Command>
</Commands>

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.

Enthalten weder der Eintrag noch der Batch Befehle, ergänzt primedocs beim Aktualisieren automatisch SaveAs mit DocumentLocation als Ziel und anschliessend DefaultProcess mit Start=true. In primedocs Desktop wird das Dokument dadurch am selben Ort gespeichert und geöffnet. 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.