Ansicht
Dokumentation

CL_ISHMED_IM_API - Bildintegration: API zum Zugriff auf eine Bildstudie

ROGBILLS - Synchronize billing plans RFUMSV00 - Advance Return for Tax on Sales/Purchases
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Diese Klasse bietet den zentralen Zugriff auf eine Bildstudie der Bildintegration. Alle wesentlichen Dialogfunktionen und Daten einer Bildstudie sind über diese Klasse verfügbar.

Wenn in einem Kundenprogram Daten der Bildintegration gelesen oder geändert werden, sollte immer diese Klasse sowie die Klasse CL_ISHMED_IM_CONTROLLER verwendet werden. Andere Klassen der Bildintegration sollten in Kundenprogrammen nicht direkt instanziiert werden.

Erzeugen einer neuen Instanz:

Um eine neue Studie anzulegen rufen Sie die Methode CREATE_STUDY auf. Diese Methode öffnet den Studienanlage-Dialog des Bildsystems und erlaubt dem Anwender, eine neue Bildstudie zu erfassen. Nach Abschluss der Studienanlage wird eine Instanz vom Typ CL_ISHMED_IM_API zurückgeliefert, mit der auf alle weiteren Funktionen der Studie zugegriffen werden kann.

Falls Ihr Programm stattdessen eine vorhandene Studie zur Anzeige oder Bearbeitung laden soll, rufen Sie die Methode OPEN auf. Die Methode OPEN erwartet die Übergabe des Schlüssels einer Bildstudie und liefert ebenfalls eine Instanz vom Typ CL_ISHMED_IM_API zurückgeliefert, mit der auf alle weiteren Funktionen der Studie zugegriffen werden kann.

Beachten Sie dass Sie nach Anlage einer Studie und nach dem Durchführen von Änderungen die SAVE-Methode der API-Instanz gerufen werden muss, damit die Studie gesichert wird.

Freigabe einer Instanz:

Jede von Ihnen mit der Methode OPEN oder CREATE_STUDY erzeugte Instanz dieser Klasse muss, wenn sie von Ihrem Programm nicht mehr benötigt wird, freigegeben werden. Die Freigabe geschieht durch Aufruf der Methode FREE. Ihre Anwendung muss die Methode FREE für jede CONTROLLER-Instanz genau so oft rufen, wie zuvor von Ihrem eigenen Programmcode die Methode OPEN oder CREATE_STUDY gerufen wurde. Falls Ihr Programm die FREE-Methode seltener oder häufiger als OPEN und CREATE_STUDY aufruft, werden entweder nicht alle Sperren freigegeben oder es kann zu Daten-Inkonsistenzen wegen fehlender Sperren oder sogar zu Programmabstürzen innerhalb der Bildintegration kommen.

Wichtige Methoden

Methodenname	Beschreibung
OPEN	Eine vorhandene Bildstudie für die weitere Bearbeitung einlesen.
CREATE_STUDY	Eine neue Bildstudie mit Hilfe des Studienanlagedialogs des Bildsystems anlegen. Diese Studie muss danach noch durch Aufruf von SAVE innerhalb von i.s.h.med gesichert werden.
OPEN	Eine vorhandene Bildstudie zur Bearbeitung öffnen

SHOW_STUDY	Das Bildsystems aufrufen und die Studie darin anzeigen
EDIT_STUDY	Das Bildsystems aufrufen und die Studie darin bearbeiten
PRINT_STUDY	Die Studie über das Bildsystem drucken (beachten Sie dass diese Funktion bisher nicht von IMAGIC ims unterstützt wird)
REASSIGN_STUDY	Die Studie an einen anderen Patienten oder Fall umhängen
RELEASE_STUDY	Die Studie freigeben. Achtung: die Studie kann danach nie wieder geändert werden
SHOW_STUDY_INFO	Einen Popup-Dialog anzeigen, in dem technische Informationen zur aktuellen Bildstudie angezeigt werden
UPDATE_STUDY	Die in i.s.h.med gehaltenen Daten der Studie werden an das Bildsystem übermittelt und dort aktualisiert. Diese Methode muss von Ihnen gerufen werden, wenn Sie Daten der Studie per Programm geändert haben und diese Änderung auch an das Bildsystem übermittelt werden sollen. Beachten Sie dass bei IMAGIC ims nur dann eine Übermittlung der Änderungen möglich ist, wenn auf dem Arbeitsplatz des Anwenders der IMAGIC-Client installiert und korrekt eingerichtet ist.

SHOW_IMAGE	Das Bildsystem aufrufen und ein Einzelbild der Bildstudie darin anzeigen
EDIT_IMAGE	Das Bildsystem aufrufen und ein Einzelbild der Bildstudie darin bearbeiten

GET_STUDY_OBJECT	Diese Methode liefert Ihnen das eigentliche Studienobjekt vom Typ IF_ISHMED_IM_STUDY zurück. Über das Studienobjekt kann lesend und ändern auf Eigenschaften der Bildstudie und die zur Bildstudie gehörenden Bilder zugegriffen werden. Nachdem Ihr Programm Eigenschaften der Studie geändert wird, kann die Studie durch Aufruf der Methode SAVE von Klasse CL_ISHMED_IM_STUDY gesichert werden.

SAVE	Ungesicherte Änderungen speichern

FREE	Die aktuelle Instanz wieder freigeben

SET_READONLY	Falls Sie der Methode den Wert abap_true übergeben, wird die Studie in den Lesemodus gesetzt, bei Übergabe von abap_false wird sie in den Änderungsmodus gesetzt und kann danach aktualisiert werden. Wenn sich die Studie im Änderungsmodus befindet, wird ihre Bearbeitung durch andere Benutzer gesperrt bis die Instanz wieder in den Lesemodus gesetzt oder durch Aufruf von FREE freigegeben wird. Beim Wechsel vom Anzeigemodus in den Änderungsmodus werden die Daten der Studie automatisch neu von der Datenbank gelesen, weil sie sich inzwischen geändert haben könnten.
GET_READONLY	Liefert zurück, ob sich die Studie im Lesemodus befindet.

REOPEN_RELEASED_STUDY	Mit dieser Funktion wird eine freigegebene Bildstudie entsperrt, wodurch sie wieder für die Bearbeitung zur Verfügung steht. Falls die API für eine noch nicht freigegebene Studie geöffnet wurde, wird der Aufruf ignoriert.

Beziehungen

Beispiel

Beispiel: Anlage einer neuen Bildstudie mit Hilfe des Studienanlagedialogs des Bildsystems

data: lr_study type ref to cl_ishmed_im_api.

try.

lr_study_api = cl_ishmed_im_api=>create_study(

i_institution = ...

i_patient_id = ...

i_case_id = ...

lr_study_api->save( ).

" ... etc. ...

"important: release the API instance when work is finished
lr_study_api->free( ).

cleanup.

if lr_study_api is bound.

"important: release the API instance even in case of errors

lr_study_api->free( ).

endtry.

Beispiel: Laden und Ändern einer vorhandenen Bildstudie

data: l_study_id type n1im_study_id,

lr_study type ref to cl_ishmed_im_api,

lr_study_data type ref to cl_ishmed_im_study.

l_documenting_ou type orgdo.

try.

" determine which study to open

l_study_id = ...

"load the study

lr_study_api = cl_ishmed_im_api=>open(

i_studyid = l_study_id

"switch to update mode

lr_study_api->set_readonly( abap_false ).

"get the actual study object

lr_study_data = lr_study_api->get_study_object( ).

"change the documenting OU of the study

l_documenting_ou = ...

lr_study_data->set_document_ou( l_documenting_ou ).

"use the API to save the changes that were made to the study