Dieses Dokument richtet sich an DMS Hersteller und Implementationspartner. Es enthält die Dokumentation über den Aufbau und Inhalt der universellen DMS Schnittstelle ImmoTop2. Das Dokument dient als Implementationshilfe und Nachschlagewerk für DMS Hersteller und Implementationspartner.
- Ein Dokument existiert in ImmoTop2 nur ein einziges Mal.
(entweder im ImmoTop2-internen Archiv oder im externen Archiv eines DMS) - Master für die Indexwerte der Dokumente ist ImmoTop2.
(nur die in ImmoTop2 gespeicherten Indexwerte sind für ImmoTop2 relevant. ImmoTop2 definiert, wo das Dokument gespeichert ist.) - Das DMS ermöglicht das Visualisieren von Dokumenten durch Aufruf einer URL mit der DokumentenID als Platzhalter
- Dokumente werden immer über eine eindeutige DocID identifiziert, die ImmoTop2 geliefert werden muss nach dem Speichern des Dokumentes im externen DMS
Die ImmoTop2-Schnittstellen ermöglichen den DMS:
- lesende und schreibende Zugriffe via REST-Services
- lesende Zugriffe via DatenbankViews und schreibende Zugriffe via Stored-Procedures über eine direkte Datenbank-Schnittstelle
- Dokumente zwischen dem DMS und ImmoTop2 transportieren oder ausführen von Commands (zB Lösche Dokument 123) über Steuerdateien in Staging-Verzeichnissen
REST-Services sind die bevorzugte Schnittstelle. Die Verwendung der REST-Services wird in diesem Dokument beschrieben: REST-Services
Für die Datenbank-Schnittstelle muss eine direkte Netzwerkverbindung vom DMS zur ImmoTop2-Datenbank existieren. ImmoTop 2 stellt Stammdaten den DMS in Views zur Verfügung.
Das DMS erhält einen Benutzer für lesenden und schreibenden Zugriff. Die Verbindung auf die Views oder DB Prozeduren erfolgt mittels REST-Services, Alternativ stehen auch noch ODBC zur Verfügung (nicht mehr empfohlen).
Aus Performancegründen, wird empfohlen, die Daten Lokal in Zwischentabellen zu speichern und nicht in Echtzeit auf die Views oder den REST-Service zuzugreifen.
Die DB Views sind in folgendem Dokument beschrieben: Views
Der Aufruf der Prozeduren ist in folgendem Dokument beschrieben: Prozeduren
Details zu den Staging Tabellen sind hier dokumentiert:
Der Beleg wird im DMS gescannt.
Der Beleg durchläuft im DMS einen Kreditoren-Workflow.
Metainformationen zum Beleg werden vom DMS in die Staging Tabellen von ImmoTop2 geschrieben. Hierfür werden Prozeduren und ein REST-Services zur Verfügung gestellt um die Daten in sogenannte Staging-Tabellen zu schreiben (DmsImport, DmsBeleg und DmsBelegPosten).
In ImmoTop2 wird der Beleg geprüft. Die Daten werden gegebenenfalls ergänzt oder korrigiert und in die Buchhaltung geschrieben.
Die Rechnung wird über ImmoTop2 ausbezahlt.
