Primärdokumente anhängen

XBAU-137
  • K1.1-E2
Geprüft
Do., 11.08.2022 - 15:04
Fertig
Mi., 31.03.2021 - 14:00
priority-icon High
  • Kernmodul

Mechanismus Interner Anhang sollte gestrichen werden

  • Diesesr Mechanismus ist aus diversen Gründen für die Übermittlung von Primärdokumenten nicht hilfreich.
  • Primärdokumente sollten ausschließlich als Attachments übermittelt werden dürfen. Das verbessert Übertragungstechnik und Interoperabilität.
  • Die Verwendung von Attachments ist wohldefiniert (zumindest für XTA- und OSCI-Schnittstellen) im Transportprofil im Anhang der XBau-Spezifikation zu beschreiben.

Kommentare

Antragsteller ist Hr. S., Dataport. 

Antrag vom 12.02.2021

Anmerkung aus der Umsetzung

Bei der Übertragung von Nachrichten mit der Software COM-Despina wird der Inhalt anscheinend mehrfach Base64-codiert. Bei Benutzung der Methode Interner Anhang führt dies offenbar dazu, dass die Datenmenge etwa um den Faktor 2 vergrößert wird.

Der CR wurde im XBau-Kernmodul umgesetzt. 

Der Mechanismus interner Anhang wurde entfernt, ebenso das dazugehörige Element primaerdokument (in das das base64-kodierte Primärdokument eingefügt werden sollte) aus dem Datentyp AnlageBauvorlage.

Die verbleibenden beiden Mechanismen zur Übertragung von Primärdokumenten heißen jetzt Anhang und Verlinkung (vgl. Abschnitt  II.1 Primärdokumente der Spezifikation Kernmodul Version 1.1).

Die Versionshistorie wurde angepasst.

(die Anpassung des OSCI-Transportprofils wird im verlnkten CR XBau-138 beschrieben)

QS durch Hr. S. / Dataport am 26.05.2021

auf Seite 7 sollte das Wort Anhang durch Attachment ergänzt werden, da dies besser zu den Transportprofilen passt. Das Wort „lokaler“ führt nur zur Verwirrung bei und sollte entfallen.

Der IT-Planungsratsbeschluss schreibt XTA 2.1.1 und OSCI-Transport vor. Es gibt nichts zum Thema zip-Archive. Daher sollte alles mit Zip-Archive entfallen.

 

  1. Anhang: Sie werden als lokaler Anhang (Attachment) übermittelt:

II.1.1 Anhang

Bei diesem Mechanismus werden die Primärdokumente als Anhänge mit der XBau-XML-Nachricht

(XBau-Fachnachricht) zusammengelegt und -gemeinsam als Bündel übertragen (-innerhalb eines

gemeinsamen Containers übertragen, z.B. innerhalb eines zip-Archivs oder innerhalb eines XTA ContentContainers-)-.

 

Auf Seite 8 muss folgender Block komplett entfallen:

Die Abbildung zeigt einen Zip-Container, der eine XBau-Fachnachricht neben einer Reihe von Primärdokumenten

enthält. In die Fachnachricht sind Verweise (ID und Dateiname) auf die im Container liegenden

Primärdokumente eingetragen.

Abbildung II.1.1. Primärdokumente als Anhang zur XBau-Fachnachricht

mit Grafik

 

Seite 21: Sicherheitshalber sollte hier klargestellt werden, dass bei Rückweisungen nur das Fach-XML ohne Attachments eingebettet wird.

nachricht xs:base64Binary 1

Dieses Element bildet die zurückgewiesene Fachnachricht-Nachricht ohne Attachments im Binärformat ab.

 

Seite 49

Die Bauvorlage wird entweder als Anhang (Attachment) zur XBau-Fachnachricht übermittelt (Metadaten dokumentid

und dateiname).

 

Ich frage mich warum der Dateiname die Anz. 1 hat, wäre hier nicht 0..1 besser?

 

Seite 84

Dieser Klammerzusatz sollte gestrichen werden, da der IT-Planungsratsbeschluss XTA-WS 2.1.1 empfiehlt:

(vorzugsweise XTA-WS 2.1.1, gilt aber genauso für andere Versionen).

 

Die QS-Ergebnisse vom 26.05. wurden eingearbeitet.  

Die Abbildungen wurden überarbeitet.

Häufigkeit 1 beim Element dateiname im Datentyp  MetadatenAnhang: wurde beibehalten, das Element hat auch im Standard XFamilie die Häufigkeit 1.
 

QS durch hale am 18.08.21

Tippfehler in der ersten Zeile von Kapitel II.1.2:
..."sieht vor, dass in geeigneten Elemeneten"

Korrektur gemäß Befund vom 18.08. wurde eingefügt.

QS durch XLeitstelle am 10.02.2022:

Korrektur bestätigt. -> Status geprüft