DMSObjDef XML-Format

Das DMSObjDef-Format beschreibt die vollständige Objektdefinition eines enaio®-Systems. Es enthält alle Schränke (Archive), Objekttypen und deren Felder einschließlich Layout-, Steuerungs- und Validierungseigenschaften.

Die zugehörige Schema-Datei ist DMSObjDef.xsd.

Die DMSObjDef.xsd ist veraltet und spiegelt nicht mehr den vollständigen Stand der enaio®-Objektdefinitionen wider. Attribute und Elemente, die in realen Objektdefinitionen vorkommen, können in der XSD fehlen oder abweichen. Diese Dokumentation ist daher möglicherweise unvollständig.

1. Verwendung

Das DMSObjDef-Format wird von folgenden Jobs verwendet:

Job Beschreibung

dms.GetObjDef

Liefert die vollständige Objektdefinition des Systems als XML

dms.GetXMLSchema

Liefert die Schema-Datei DMSObjDef.xsd (Schema=DMSObjDef)

2. XML-Struktur

<asobjdef version="5.00" created="2024-01-01T00:00:00" limited_objects="0">
  <languages>
    <language lang_id="1" active="1" name="de_DE"/>
  </languages>
  <cabinet cotype="0" name="Patientenakte" internal="patient_cabinet">
    <object maintype="1" cotype="0" tablename="object1"
            name="Ordner" internal="folder" iconid="0"
            os_guid="..." compressionflags="0" historyflags="0">
      <names>
        <name lang_id="1">Ordner</name>
      </names>
      <fields>
        <field name="Nachname" internal="last_name" os_guid="..." taborder="1">
          <names>
            <name lang_id="1">Nachname</name>
          </names>
          <flags dt="A" flags="0" flags1="0" flags2="0"
                 control_type="edit" datatype="text" align="left"
                 required="0" readonly="" multifield="0"/>
          <field_pos top="0" left="0" right="200" bottom="20"/>
          <input_pos top="0" left="100" right="400" bottom="20"/>
        </field>
      </fields>
      <ids oid="196616" pid="0" vid="0"/>
      <frame top="0" left="0" right="800" bottom="600"/>
      <multiframe height="600" width="800"/>
    </object>
  </cabinet>
</asobjdef>

3. Elemente und Attribute

3.1. <asobjdef> — Wurzelelement

Attribut Typ Pflicht Beschreibung

created

dateTime

Ja

Erstellungszeitpunkt der Objektdefinition

version

String

Nein

Schema-Version (Standard: 5.00)

limited_objects

Short

Nein

1 = Objektdefinition enthält eingeschränkte Objekte; Standard: 0

3.2. <languages> / <language>

Listet alle im System konfigurierten Sprachen.

Attribut Typ Pflicht Beschreibung

lang_id

Long

Ja

Numerische Sprach-ID

active

Short (0–2)

Ja

Aktivierungsstatus: 0 = inaktiv, 1 = aktiv, 2 = Standard

name

Name

Ja

Sprachbezeichnung (z. B. de_DE, en_US)

3.3. <cabinet> — Schrank (Archiv)

Ein <asobjdef> enthält null oder mehrere <cabinet>-Elemente.

Attribut Typ Pflicht Beschreibung

name

String (1–100)

Ja

Anzeigename des Schranks

cotype

Short

Ja

Interner Schrank-Typ

internal

String

Nein

Interner Name des Schranks

3.4. <object> — Objekttyp

Jeder Schrank enthält mindestens einen <object>-Eintrag.

Attribut Typ Pflicht Beschreibung

name

String (1–100)

Ja

Anzeigename des Objekttyps

internal

String

Nein

Interner Name des Objekttyps

tablename

NMTOKEN

Ja

Datenbankname der Objekttabelle (z. B. object1)

extablename

String

Nein

Name der erweiterten Datenbanktabelle

os_guid

String

Ja

Globale eindeutige ID des Objekttyps

maintype

Short

Ja

Haupttyp des Objekttyps. Wertebereich und Bedeutung siehe Objekttyp-ID.

cotype

Short

Ja

Untertyp des Objekttyps (Lowword der Objekttyp-ID). Siehe Objekttyp-ID.

iconid

Long

Ja

ID des benutzerdefinierten Icons (0 = Standard-Icon)

compressionflags

Long

Ja

Kompressionseinstellungen (Bitmask)

historyflags

Long

Ja

Verlaufseinstellungen (Bitmask)

no_dias

Short

Nein

1 = keine Diaschau-Unterstützung; Standard: 0

reference

Short

Nein

1 = Verweisobjekt; Standard: 0

fulltext

Short

Nein

1 = Volltextindexierung aktiviert; Standard: 0

apply_security

Short

Nein

1 = Sicherheitssystem aktiv; Standard: 0

multidoc

Short

Nein

1 = Mehrfachdokument-Typ; Standard: 0

Sub-Elemente von <object>:

Element Beschreibung

<names>

Mehrsprachige Anzeigenamen — enthält je ein <name lang_id="…​"> pro Sprache

<fields>

Liste der Indexfelder des Objekttyps (<field>-Elemente)

<ids>

Interne Typ-IDs: oid (Objekt-ID), pid (Parent-ID), vid (Versions-ID)

<frame>

Größe und Position der Eingabemaske (Attribute: top, left, right, bottom)

<multiframe>

Größe des Mehrfachrahmen-Bereichs (Attribute: height, width)

<limited_objects>

Eingeschränkte Untertypen (<limited_object type="…​" count="…​">)

3.5. <field> — Indexfeld

Beschreibt ein einzelnes Indexfeld eines Objekttyps.

Attribut Typ Pflicht Beschreibung

name

String (1–100)

Ja

Anzeigename des Feldes

internal

String

Nein

Interner Feldname

fieldname

Name

Nein

Datenbankfeldname

os_guid

String

Ja

Globale eindeutige ID des Feldes

taborder

Long

Ja

Tabulatorreihenfolge in der Eingabemaske

tooltip

String

Nein

Tooltip-Text

prnalias

String

Nein

Druckbezeichnung (Alias für Berichte)

classstring

String

Nein

CSS-Klassen-Bezeichner für UI-Steuerung

init

String

Nein

Initialisierungsausdruck

Sub-Elemente von <field>:

Element Beschreibung

<names>

Mehrsprachige Feldbezeichnungen

<ids>

Interne Feld-IDs (optional)

<flags>

Feldeigenschaften (Datentyp, Steuerelement, Validierung — siehe unten)

<field_pos>

Position der Feldbezeichnung in der Maske (top, left, right, bottom)

<input_pos>

Position des Eingabefelds in der Maske (top, left, right, bottom)

<init>

Initialisierung: func (Funktions-ID), init_type (const, func oder mask)

<list>

Wertliste für Listen-Steuerelemente (rawdata, extra, row-Einträge)

<listctrl>

Spaltendefinition für Tabellen-Steuerelemente (grid)

<page>

Seiten-Darstellung des Feldes (enthält ein weiteres <field> vom Typ fieldType)

3.5.1. <flags> — Feldeigenschaften

Attribut Typ Standard Beschreibung

dt

osdatatype

—

Datentyp des Feldes (siehe Felddatentypen)

flags

Long

—

Interne Feld-Flags (Bitmask)

flags1

Long

—

Erweiterte Feld-Flags 1 (Bitmask)

flags2

Long

—

Erweiterte Feld-Flags 2 (Bitmask)

control_type

controltype

edit

Steuerelement-Typ (siehe Steuerelementtypen)

datatype

contenttype

text

Inhaltlicher Datentyp (siehe Inhaltstypen)

align

aligntype

left

Textausrichtung: left, right oder center

readonly

readonlytype

—

Schreibschutz-Modus (siehe Schreibschutz-Typen)

required

Short

0

1 = Pflichtfeld

multifield

Short

0

1 = Mehrfachparameterfeld

zeropad

Short

0

1 = Führende Nullen auffüllen

constraints

constraintype

none

Eingabeeinschränkung (siehe Einschränkungstypen)

input_length

Long

0

Maximale Eingabelänge in Zeichen (0 = unbegrenzt)

crosscheck

Short

0

1 = Kreuzprüfung mit Listenwerten aktiv

color

String

—

Schriftfarbe des Feldes (HTML-Farbwert)

case

Short

0

Groß-/Kleinschreibungsregel: 0 = keine, 1 = Großschreibung, 2 = Kleinschreibung

4. Typdefinitionen

4.1. Felddatentypen (osdatatype)

Wert Bedeutung

A

Alphanumerisch (variabel)

C

Einzelzeichen

D

Datum

F

Dezimalzahl

G

Interner Typ

I

Ganzzahl

K

Interner Typ

L

Liste

M

Memo (mehrzeiliger Text)

Q

Interner Typ

S

Zeichenkette (fest)

T

Zeit

V

Interner Typ

W

W-Dokument-Typverweis

X

Interner Typ

Z

Interner Typ

0, 1, 9, #

Interne Sondertypen

4.2. Steuerelementtypen (controltype)

Wert Bedeutung

edit

Einzeiliges Eingabefeld (Standard)

textarea

Mehrzeiliges Eingabefeld

static

Nur-Lese-Anzeige

checkbox

Kontrollkästchen

radio

Optionsfeld

list

Listenfeld (Dropdown)

dblist

Datenbankverknüpfte Liste

tree

Baumstruktur

hierarchy

Hierarchie-Steuerelement

structure

Strukturfeld

grid

Tabellen-Steuerelement (Tabellenfelder)

pagecontrol

Registersteuerung (Tab-Seiten)

addon

Erweiterungsmodul

4.3. Inhaltstypen (contenttype)

Wert Bedeutung

text

Text (Standard)

date

Datum

dec

Dezimalzahl

num

Ganzzahl

bitmap

Bild

group

Gruppe

upper

Text (automatische Großschreibung)

4.4. Schreibschutz-Typen (readonlytype)

Wert Bedeutung

(leer)

Kein Schreibschutz — Feld ist bearbeitbar

supervisor

Nur für Supervisoren schreibbar

arch

Nach Archivierung schreibgeschützt

init

Nur bei der Ersterfassung schreibbar

always

Immer schreibgeschützt (nur Anzeige)

4.5. Einschränkungstypen (constraintype)

Wert Bedeutung

none

Keine Einschränkung (Standard)

mask

Eingabemaske (Format vorgegeben)

uppercase

Eingabe automatisch in Großschreibung

gender

Geschlechtsangabe

direction

Richtungsangabe

patient

Patientenspezifische Eingabe

question

Fragestellung