FunktionsdokumentationFremddatenbausteine

 

Fremddatenbausteine (FDBS) dienen der Einbindung von Fremddaten (Daten aus anderen Anwendungen oder aus anderen Teilen der medizinischen Dokumentation) in parametrierte Dokumente. Mit FDBS können Sie auch Daten, die in parametrierten Dokumenten erfasst wurden, in anderen Anwendungen speichern, und Auswahlhilfen anbieten. Wollen Sie z.B. in ein Feld Ihres Dokuments das Alter des Patienten aufnehmen (dieser Wert ist im System als Teil der Patientenstammdaten bekannt), könnten Sie mit einem entsprechenden FDBS auf dieses Feld aus dem Patientenstamm verweisen, um den Feldinhalt zu kopieren.

Ein FDBS wird im abstrakten oder konkreten Entwurf dem Dokumentationselement eines konkreten Dokumenttyps zugeordnet.

Hinweis Hinweis

Fremddatenbausteine sind vom Dokumenttyp unabhängig und damit grundsätzlich wiederverwendbar. Sie erfordern jedoch eine eigene Stammdatenverwaltung.

Im Gegensatz dazu sind User-Exits, die ebenfalls eine Fremddateneinbindung ermöglichen, vom Dokumenttyp abhängig.

Ende des Hinweises

Quelle der Fremddaten

FDBS können Daten aus anderen parametrierten Dokumenten bereitstellen oder auch solche Daten verarbeiten, deren Quelle außerhalb der parametrierten Dokumentation liegt (feste Entitäten, externe Objekten). Dabei kann es sich z.B. um Patientenstammdaten, Daten zum Fall oder zur Anforderung, Leistungen, Daten zu einer Bewegung, Diagnosen, den aktuellen Benutzer sowie Systemdaten (u.a. Systemzeit, Systemdatum) handeln.

Fremddateneinbindung

Fremddatenbausteine können normalen nicht strukturierten Dokumenationselementen, Langtextfeldern, normalen Strukturen und multiplen Strukturen zugeordnet werden. Welche Art von Elementen bzw. Strukturen ein Fremddatenbaustein versorgt, ist eine seiner charakteristischen Eigenschaften.

Fremddaten aus anderen parametrierten Dokumenten

Fremddatenbausteine, die Daten aus anderen parametrierten Dokumenten bereitstellen, können Sie über eine Dialogfunktion erzeugen. Diese erreichen Sie ausgehend vom Bild SAP Easy Access über Anfang des Navigationspfads Klinisches System Navigationsschritt Klinische Basisdaten Navigationsschritt Klin. Dokumentation Navigationsschritt Fremddatenbaustein Navigationsschritt Dokumentdefinition Navigationsschritt Pflegen Ende des Navigationspfads.

Fremddaten externer Objekte

Fremddatenbausteine, die Daten externer Objekte verarbeiten, müssen von Hand angelegt und entwickelt werden, wenn sie nicht bereits aus einem anderen Anwendungszusammenhang heraus vorhanden sind.

Wird ein FDBS für die Fremddatenversorgung aus externen Entitäten eingebunden, für den über den Funktionsbaustein PARAMSTR eine Erfassmaske für die Festparameter zur Steuerung des FDBS implementiert wurde, so wird im Rahmen der Fremddateneinbindung bei der Anlage und Änderung von Dokumentationselementen und DokElementzuordnungen (konkreter Entwurf) eine Drucktaste aktiviert, über die Sie in die Eingabe der Festparameterwerte wechseln können.

Formate und Semantik

Zur reibungslosen Verarbeitung der Fremddaten ist es notwendig, dass die Formate der Datenquellen und der Datenziele identisch sind. Bei der Versorgung von einfachen und multiplen Strukturen sind die Zielelemente (Namen der Dokumentationselemente, die in die Fremddatenversorgung einbezogen werden sollen) durch die Semantik des FDBS vorgegeben. Bei Fremddatenbausteinen, die Daten aus anderen parametrierten Dokumenten bereitstellen, sind das die Namen der Dokumentationselemente der Quellstruktur. Bei Fremddatenbausteinen, die Daten aus festen Entitäten verarbeiten, sind das die Namen, die bei der Erstellung des Fremddatenbausteins vereinbart wurden.

Eigenschaften von Fremddatenbausteinen

Referenz

Fremddaten können als Referenz oder als Kopie eingebunden werden:

  • Referenzierte Daten spiegeln bei der Pflege (Anlegen und Ändern, nicht jedoch bei der Wiedergabe) stets den aktuellen Zustand des Fremddokuments wieder.

  • Kopierte Daten spiegeln als Vorbelegung, sofern sie im aktuellen Dokument nicht weiter verändert werden, den historisch korrekten Zustand der Fremddaten zum Zeitpunkt der Dokumentanlage wieder. Sie werden bei einer späteren Bearbeitung des Dokuments nicht automatisch aktualisert.

  • Falls dieses Feld markiert ist, ist eine Einbindung als Referenz erwünscht. Falls es nicht markiert ist, wird der Fremddatenbaustein zu Vorbelegung verwendet.

Ändern

Markieren Sie das Feld Ändern, wenn ein Änderungsbaustein auch zur ändernden Fremddateneinbindung eingesetzt werden soll. Ändernde Fremddateneinbindung heißt dabei, dass mit der Sicherung der Daten des aktuell bearbeiteten Dokument die betreffenden Daten auch in der Fremddatenquelle gesichert oder geändert werden. Eine ändernde Fremddateneinbindung ist nur für solche FDBS vorgesehen, die die Verarbeitung von Daten fester externer Entitäten (Objekte) ermöglichen.

Wertehilfe

Markieren Sie Wertehilfe, wenn die zu einem Fremddatenbaustein implementierte allgemeine Auswahlhilfe (Wertehilfe) genutzt werden soll. Bei Wertehilfen für einfache oder multiple Strukturen müssen Sie das Feld bei der Struktur und bei den Dokumentationselementen markieren.

Festparameter

Im Feld Festparameter können Sie feste (bereits zum Parametrierungszeitpunkt bekannte) Parameter als Zeichenkette übergeben. Mögliche vom FDBS akzeptierte Werte sind durch diesen vorgegeben und sind ggf. dessen Dokumentation zu entnehmen. Die beim Dokumentationselement aufgegebenen Werte im Feld Festparameter haben Vorrang vor denjenigen, die bei der Anlage des FDBS aufgegeben wurden.

Neue Suche

Wenn neue Suche markiert ist, wird in jedem Fall die Recherche erneut ausgeführt und nicht ein möglicherweise schon vorhandenes Ergebnis aus dem FDBS-Gedächtnis verwendet. Das Kennzeichen neue Suche sollten Sie z.B. einsetzen, wenn zwei verschiedene Instanzen der gleichen Entität an verschiedenen Stellen im Dokument referenziert werden sollen.

Referenzfeld

In diesem Feld wird der Name des für die Fremddaten zu erzeugenden Referenzfeldes abgelegt. Unter diesem Namen wird in der unter 'Datenbanktabelle' genannten transparenten Tabelle über die Tabellenpflege ein Tabellenfeld angelegt, in dem Referenzen abgelegt werden können. Der Name des Referenzfelds darf nicht gelöscht werden, da die Existenz eines Referenzfelds bei der Generierung der Dialoganwendung zwingend vorausgesetzt wird.

Hinweis Hinweis

Bei der Bearbeitung einer Fremddateneinbindung beim Dokumentationselement bzw. im konkreten Entwurf (DokElementzuordnung) werden Plausibilitätsprüfungen durchgeführt. In die Prüfung werden die Art des DokElements, die Optionen bei der Fremddateneinbindung und die Eigenschaften des Fremddatenbausteins einbezogen.

Ende des Hinweises
Abläufe beim Generieren

Bei der Erstellung des konkreten Entwurfs werden in die Feldgruppe Fremddateneinbindung zunächst die Angaben, die bei den jeweiligen Dokumentationselementen gefunden wurden, übernommen. Zusätzlich wird für jedes Dokumentationselement, dem ein Fremddatenbaustein zugeordnet wurde, der Feldname für ein Tabellenfeld erzeugt, in dem der Referenzschlüssel gespeichert werden kann.

Die Angaben zur Fremddateneinbindung können im konkreten Entwurf geändert werden.

Mit den Optionen Referenz, Ändern, Wertehilfe und Neue Suche werden bei der Generierung der Dialoganwendung jeweils Programmteile erzeugt, die diese Eigenschaften für den eingebundenen FDBS aktivieren. Sie stellen z.B. für ein bestimmtes Dokumentationselement eine Wertehilfe bereit, aktualisieren die übernommenen Fremddaten in der Änderungsfunktion, sichern geänderte Fremddaten in der Fremdentität oder initiieren eine erneute Fremddatensuche bei wiederholtem Aufruf eines Fremddatenbausteins in einem Dokument. Voraussetzung dafür ist, dass es sich bei dem Fremddatenbaustein auch tatsächlich um einen Referenz- oder Änderungs- oder Wertehilfebaustein handelt.

Achtung Achtung

Wenn Sie die Generator-Version 2 einsetzen, beachten Sie die in Generator-Version 2 beschriebenen Abweichungen.

Ende der Warnung.