Basisitem

Basisitems können Systemobjekte, Systemfunktionen und Vorbelegungen zu Objekten wie z. B. Diagnosen, Dokumente und Prozeduren enthalten.

Funktionen sind dabei z. B. die Ausgabe von Objekten wie Dokumentdruck oder die Anzeige einer URL, aber auch die Einbindung externer Anwendungen.

Basisitems werden in Komponenten wie Behandlungspfade und Dokumentationsarbeitsplatz eingesetzt.

Auf welches Objekt sich ein Basisitem bezieht, legen Sie im Basisitemtyp fest.

Sie verknüpfen Basisitems mit Objekten der verwendenden Komponente in der Regel in der Definitionsapplikation. Danach steht das Basisitem zur Ausführung zur Verfügung. In Abhängigkeit von der Komponente sind unter Umstände weitere Schritte notwendig. Näheres finden Sie in der Dokumentation der jeweiligen Komponente.

Wie Sie ein Basisitem anlegen, lesen Sie unter Bearbeitung von Basisitems.

Struktur

Ein Basisitem wird gegenüber dem Benutzer durch seine Bezeichnung identifiziert. Diese muss eindeutig sein und wird durch das System geprüft. Basisitems auf Kundensystemen müssen mit A - Z, a - z, 0 - 9 oder _ beginnen. Sie können ein Basisitem durch die Beschreibung näher erläutern.

Ein Basisitem bezieht sich auf eine Einrichtung. Komponenten können nur Basisitems verwenden, die in ihrer Einrichtung liegen.

Der Basisitemtyp charakterisiert das Basisitem. Eine mögliche Ausprägung ist z. B. das Dokument. Jedes Basisitem muss genau einem Basisitemtyp zugeordnet sein.

Die Erstaktion legt fest, welche der im Basisitemtyp definierten Funktionen bei der erstmaligen Ausführung des Basisitems aufgerufen wird. Sie wird nur einmal pro Objekt ausgeführt.

Die Wiederholaktion legt fest, welche der im Basisitemtyp definierten Funktionen bei der wiederholten Ausführung des Basisitems aufgerufen wird. Sie kann erst aufgerufen werden, nachdem die Erstaktion erfolgreich durchgeführt wurde. Die Anzahl der Aufrufe ist nicht begrenzt.

Mit den Filterwerten Vor Ausführung und Nach Ausführung kann eine Implementierung des zum Basisitemtyp gehörenden BAdI vor und nach Ausführung der im Basisitem definierten Aktion aufgerufen werden. Diese Funktion ist nicht für alle Basisitemtypen verfügbar.

Der Status kennzeichnet die Änderbarkeit des Basisitems und seine inhaltliche Fertigstellung (Freigabe). Ein Basisitem, das sich in Bearbeitung und im Test befindet, hat den Status Inaktiv. Sobald das Basisitem einsetzbar ist, sollten Sie es in den Status Aktiv setzen. Nur im Status Aktiv kann ein Basisitem auf einem Mandanten im Produktivbetrieb ausgeführt werden. Auf allen anderen Mandantenrollen, wie z. B. Test oder Customizing, kann auch ein inaktives Basisitems zugeordnet und ausgeführt werden.

Durch das Löschen eines Basisitems wird es mit einer Löschvormerkung versehen. Die Löschvormerkung ist Vorraussetzung zur physischen Löschung.

Sie können Basisitems einer Gruppe zuordnen. Die Gruppierung erleichtert das Auffinden von Basisitems aus dem Katalog der verfügbaren Basisitems.

Integration

Basisitems sind an das Transport- und Korrekturwesen angeschlossen. Bei der Bearbeitung eines Basisitems werden, in Abhängigkeit von der Mandanteneinstellung, die Änderungen in einen Transportauftrag aufgezeichnet. Die Änderung auf einem produktiven Mandanten ist nicht möglich.

Erstellen Sie Basisitems auf Ihrem Test- oder Customizing-Mandanten. Testen Sie sie, aktivieren Sie sie und transportieren Sie die aktivierten Basisitems auf Ihren Produktivmandanten.

Ausführung

Die Ausführung eines Basisitems erfolgt in mehreren Schritten. Je nachdem, ob ein Basisitem für ein Objekt bereits ausgeführt wurde oder nicht, werden unterschiedliche Funktionen ausgelöst:

Aufruf des zum Basisitemtyp gehörenden BAdIs mit dem Filterwert Vor Ausführung.
Besitzt das BAdI keine Default-Implementierung, wird dieser Schritt übergangen.
Ausführung der im Basisitem festgelegten Erstaktion oder Wiederholaktion.
Welche Aktion ausgeführt wird, hängt davon ab, ob das Basisitem bereits ausgeführt wurde.
Sichern des Ergebnisses der Ausführung des Basisitems.
Aufruf des zum Basisitemtyp gehörenden BAdIs mit dem Filterwert Nach Ausführung. Wenn das BAdI keine Default-Implementierung hat, wird dieser Schritt übergangen.

Manche Basisitemtypen haben ein abweichendes Ablaufschema ab. Nähere Informationen finden Sie dazu bei dem jeweiligen Basisitemtyp.

Beispiel

Sie haben ein Basisitem erstellt, das Sie in einer Aufgabe des Dokumentationsarbeitsplatzes Ambulanz nutzen wollen.

Erstellen Sie in der Vorlagenverwaltung (Transaktion N2WLD) eine Aufgabevorlage und ordnen Sie dieser das erstellte Basisitem zu.
Aktivieren und sichern Sie die Aufgabenvorlage.
Wechseln Sie in den Dokumentationsarbeitsplatz Ambulanz.
Rufen Sie einen Patienten mit einer Situation auf und fügen Sie der Situation eine Aufgabe aus der neuen Aufgabenvorlage hinzu.
Wählen Sie die neue Aufgabe aus der Aufgabenliste aus.
Das Basisitem wird ausgeführt.