Fremddatenbausteine
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
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.
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.
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 .
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.
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
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.
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
Wenn Sie die Generator-Version 2 einsetzen, beachten Sie die in Generator-Version 2 beschriebenen Abweichungen.