Kontakt

Ansicht
Dokumentation

ISH_NURSE_STATION_GRAPHIC - IS-H call for graphic station overview

ISH_NURSE_STATION_GRAPHIC - IS-H call for graphic station overview

RFUMSV00 - Advance Return for Tax on Sales/Purchases   BAL Application Log Documentation  
This documentation is copyright by SAP AG.
SAP E-Book

Functionality

The function module ISH_NURSE_STATION_GRAPHIC provides data to the IS-H nurse station graphic.

Corresponding structure and patient data must be provided.

When the user carries out a function, the data and the affected objects are transferred.

Notes

The functionality of the nurse station graphic is defined in the program code. Changes to the interface are therefore not allowed.

The number of objects that can be displayed is limited. A maximum of

  • 70 rooms,

  • 140 doors,

  • 70 beds,

  • 200 patients in total, including

  • 60 patient in arrivals list and not more than

  • 60 patients in departures list

are possible. Otherwise it is not possible to use the graphical display.

The interface is described below. Following this description, notes are given as to the customizing of the nurse station structure.

The interface was (technically) defined as follows:

Status: July 1996, Version 3.0e of the nurse station graphic

Basic data provided (only when calling the graphic for the first time:)
________________________________________________________________________

Header:

1-12 alphanum. short description of OU (nurse station)
8 num. (yyyymmdd) date for status of data
6 num. (hhmmss) time for status of data (24h)
8 num. (yyyymmdd) planning horizon start date (historical)
8 num. (yyyymmdd) planning horizon end date (prospective)
0-73 alphanum. error number and text from R/3 action
(if defined and if it can be carried out)
1 alpha confirmation indicator (X=active, can be
deactivated using the SET/GET-Parameter NGS)

Rooms:

1-8 alphanum. identification key of room
1-2 alpha room category (F=corridor, K=room, S=other)
0-12 alphanum. room short description (only category S)
0-8 alphanum. identifier of room building unit (door plate)
1 alpha smokers' room indicator(X=smokers' room)
1 alpha sex indicator (m, f, SPACE=mixed)
1-3 num. x position (left lower corner)
1-3 num. y position (left lower corner)
1-3 num. size in x coordinates
1-3 num. size in y coordinates

Doors:

1-8 alphanum. identification key of corridor
1-8 alphanum. ID key of room; for corridor door: ID key of
corridor again
1-3 num. x position ref. to corridor (corridor door see
below

1-3 num. ,,y position ref. to corridor (corridor door see

below

Beds:

1-8 alphanum. Identification key of bed location
0-8 alphanum. Identifier of building unit bed location
1-8 alphanum. Identification key of room
1-3 num. x position ref. to room (see below)
1-3 num. y position ref. to room (see below)
(left lower corner is (0,0))
1 alpha planning indicator (X=a planned assignment is
defined for the bed)
1 alpha blocked indicator (' '=available (i.e. the bed
is displayed), X=blocked)
0-15 alphanum. blocking reason text
0/8 num. (yyyymmdd) valid end date of the current bed status
0/6 num. (hhmmss) valid end time of bed status
2 alphanum. bed category (01=standard, 02=special,
03=overflow bed)

Patients

1-10 alphanum. patient number
0/1 alphanum. check digit of patient number
1-10 alphanum. case number
0/1 alphanum. check digit of case number
0-15 alphanum. name affix
0-30 alphanum. first name
0-30 alphanum. last name
1 alpha sex (m, f, u= unknown)
0/8 num. (yyyymmdd) date of birth
1 alpha private patient indicator (X=private patient)
1 alpha infection indicator (X=infection risk)
1 alpha risk factor indicator (X=risk factor definded)
1 alpha report indicator (X=new report available)
1 alpha external assignment (X=external assignment)
1 alpha observation patient indicator (X=observation
patient indicator)
0-15 alphanum. patient group according to PPR (Germany)
1 num. companion indicator: 0= none,
1= patient has companion,
2= this is a companion
0-10 alphanum. case number of companion reference person
(double concatenation)
0-8 alphanum. identification key of bed location
1 alpha nurse station assignment planning indicator
(P=planned, I=actual)
0/8 num. (yyyymmdd) nurse station assignment start date
0/6 num. (hhmmss) nurse station assignment start time
0/8 num. (yyyymmdd) nurse station assignment end date
0/6 num. (hhmmss) nurse station assignment end time
1 alpha Status: A=admitted, u=leave,
B=bed assigned (no movement), U=leave
(but bed assigned), E=discharged,
V=transf.
0-15 alphanum. movement type text (departures list)
1 alpha movement planning indicator
(P=planned, I=actual)
0/8 num. (yyyymmdd) movement start date
0/6 num. (hhmmss) movement start time
0/8 num. (yyyymmdd) movement end date
0/6 num. (hhmmss) movement end time
0-8 alphanum. ID key of room (if patient assigned)
0-6 alphanum. treatment category
0-15 alphanum. treatment category text

________________________________________________________________________

Provide update data (when calling the active graphic):
________________________________________________________________________

Header:

1-12 alphanum. short description of OU (nurse station)
8 num. (yyyymmdd) date for status of data
6 num. (hhmmss) time for status of data (24h)
8 num. (yyyymmdd) planning horizon start date (historical)
8 num. (yyyymmdd) planning horizon end date (prospective)
0-73 alphanum. error number and text from R/3 action
(if defined and if it can be carried out)
1 alpha confirmation indicator (X=active, can be
deactivated using the SET/GET-Parameter NGS)
Beds (only when changed):
1-8 alphanum. identification key of bed location
1 alpha planned indicator (X=a planned assignment is
defined for the bed)
1 alpha blocking indicator (' '=available (the bed is
displayed), X=blocked)
0-15 alphanum. blocking reason text
0/8 num. (yyyymmdd) valid to date of the current bed status
0/6 num. (hhmmss) valid to time of bed status

Patients (all):

1-10 alphanum. patient number
0/1 alphanum. check digit of patient number
1-10 alphanum. case number
0/1 alphanum. check digit of case number
0-15 alphanum. name affix
0-30 alphanum. first name
0-30 alphanum. last name
1 alpha sex (m, f, u= unknown)
0/8 num. (yyyymmdd) date of birth
1 alpha private patient indicator (X=private patient)
1 alpha infection indicator (X=infection risk)
1 alpha risk factor indicator (X=risk factor definded)
1 alpha report indicator (X=new report available)
1 alpha external assignment (X=external assignment)
1 alpha observation patient indicator (X=observation
patient indicator)
0-15 alphanum. patient group according to PPR (Germany)
1 num. companion indicator: 0= none,
1= patient has companion,
2= this is a companion
0-10 alphanum. case number of companion reference person
(double concatenation)
0-8 alphanum. identification key of bed location
1 alpha nurse station assignment planning indicator
(P=planned, I=actual)
0/8 num. (yyyymmdd) nurse station assignment start date
0/6 num. (hhmmss) nurse station assignment start time
0/8 num. (yyyymmdd) nurse station assignment end date
0/6 num. (hhmmss) nurse station assignment end time
1 alpha Status: A=admitted, u=leave (only arrivals),
B=bed assigned (no movement), U=leave
(but bed assigned), E=discharged,
V=transferred
0-15 alphanum. movement type text (departures list)
1 alpha movement planning indicator
(P=planned, I=actual)
0/8 num. (yyyymmdd) movement start date
0/6 num. (hhmmss) movement start time
0/8 num. (yyyymmdd) movement end date
0/6 num. (hhmmss) movement end time
0-8 alphanum. ID key of room (if patient assigned)
0-6 alphanum. treatment category
0-15 alphanum. treatment category text

________________________________________________________________________

Data transferred from graphic:
________________________________________________________________________

ACTION

4 alphanum. 4 character identifier for action requested by
(required) the user;
Concept: use transaction codes if possible
(see below);

FALL1

10 alphanum. case number 1 (right alignment)

FALL1PZIFF

1 alphanum. check digit of case number 1

BED1

8 alphanum. identification key of first selected bed
(when changing beds, the "from" bed) (right
alignment)

FALL2

10 alphanum. case number 2 (right alignment)

FALL2PZIFF

1 alphanum. check digit of case number 2

BED2

8 alphanum. identification key of the bed selected second
(when changing beds, the "to" bed) (right alignment)
________________________________________________________________________

Defined ACTION codes (alphabetical order ACTION; when the case number is returned, the corresponding check digit is also returned; the codes must be defined with the previously set GUI status (default: SAPLNGRB, status STATGRAF)):

Function   Returned data
Departures   ABGL
Back   BACK
Planning   BTTL
Assign bed   BTTN +FALL1+BED1
Swap beds   BTTT +FALL1+BED1+FALL2+BED2
List display   CHAR
Choose form print option   FORA +FALL1
Form printout acc. to parameter (key)   FORM +FALL1
Standard form print option   FORS +FALL1
Extended help   HLP1
Medical nurse station list   MDLI
Create material reservation   MB21
Change material reservation   MB22
Display material reservation   MB23
Medical records   ND02 +FALL1
Maintain case-rel. service entry   NL10 +FALL1
Display case-rel. service entry   NL11 +FALL1
Maintain building unit planning char.   NM32 +BED1
Change patient master data   NP02 +FALL1
Display patient master data   NP03 +FALL1
Maintain risk factors   NP04 +FALL1
Display risk factors   NP05 +FALL1
Maintain delivery data   NP20 +FALL1
Display delivery data   NP21 +FALL1
Maintain newborn admission   NP22 (+FALL1)
Display newborn admission   NP23 (+FALL1)
Maintain companions   NP26 +FALL1
Display companions   NP27 +FALL1
Maintain companion admission   NP30 (+FALL1)
Display companion admission   NP31 (+FALL1)
Maintain persons assigned   NP32 +FALL1
Display persons assigned   NP33 +FALL1
Create surgery   NP37 +FALL1
Change surgery   NP38 +FALL1
Display surgery   NP39 +FALL1
Create outpatient visit   NP41 (+FALL1)
Change outpatient visit   NP42 (+FALL1)
Display outpatient visist   NP43 (+FALL1)
Maintain case-rel. nursing acuity   NP51 +FALL1
Display case-rel. nursing acuity   NP52 +FALL1
Maintain nursing acuity (environment)   NP53
Display nursing acuity (environment)   NP54
Maintain case-rel. case classification   NP55 +FALL1
Display case-rel. case classification   NP56 +FALL1
Maintain case classif. (environment)   NP57
Display case classif. (environment)   NP58
Maintain case-rel. diagnoses   NP61 +FALL1
Display case-rel. diagnoses   NP62 +FALL1
Maintain OU-rel. diagnoses   NP63
Display OU-rel. diagnoses   NP64
Create absence   NP91 (+FALL1)
Change absence   NP92 (+FALL1)
Display absence   NP93 (+FALL1)
Create discharge   NP97 (+FALL1)
Change discharge   NP98 (+FALL1)
Display discharge   NP99 (+FALL1)
Other nurse station overview   NR12
Visit planning (planned)   NR15
Evaluate nursing acuity (environment)   NRPP
Inquiry   NRSM
Create standard admission   NV01
Change standard admission   NV02 (+FALL1)
Display standard admission   NV03 (+FALL1)
Create quick admission   NV04
Change quick admission   NV05 (+FALL1)
Display quick admission   NV06 (+FALL1)
Create emergency admission   NV07
Change emergency admission   NV08 (+FALL1)
Display emergency admission   NV09 (+FALL1)
Create transfer   NV11 (+FALL1)
Change transfer   NV12 (+FALL1)
Display transfer   NV13 (+FALL1)
Maintain case-rel. insurances   NV25 +FALL1
Display case-rel. insurances   NV26 +FALL1
Print room and bed listing   PRI
Patient index search   PSRC
Refresh   RFSH
Set view   SICH
Movement overview   UBEW +FALL1
Change room/bed   UMBT +FALL1+BED1 +BED2
Waiting list   WAIT
Arrivals   ZUGL
ACTION codes reserved for later use:
Action with optional case selection   RFO0 (+FALL1)
...   ...
Action with optional case selection   RFO2 (+FALL1)
Action with required case selection   RFM0 +FALL1
...   ...
Action with required case selection   RFM2 +FALL1
________________________________________________________________________

Notes for customizing the nurse station structure

The graphical display of the nurse station is based on a right-angle, whole-number coordination system. One unit corresponds to one meter in reality. For all size and position values only positive, whole numbers (integers) are allowed.

All rooms are displayed with right angles. For the graphic, the size of a bed location is predefined as 2 x 2 meters. When defining the size of rooms, you have to bear this in mind.

All data is transferred using the function module ISH_NURSE_STATION_GRAPHIC.

With respect to this subject, there is a collective note in the SAP-System OSS. The note has the number 29418.

Special agreements:

  1. If no doors are defined on the database, only an entry 'xxxxxxxx' 'xxxxxxxx' '000' '000' is transferred to the door table.
  2. If there are no patient movements to the nurse station, an entry with the patient number 'xxxxxxxxxx' is transferred. The other patient fields can be empty.
  3. If no bed locations are defined for the nurse station, an entry with the bed location number 'xxxxxxxxxx' is transferred. The other bed location fields can be empty.

Special characteristics of coordinates:

All coordinates must be positive or equal to zero(>=0). All position specifications refer to the left lower corner of an object.

You do not have to position the left lower corner of the nurse station at the origin of the coordination system. It is therefore possible to position the nurse station somewhere in the "positive" area. Subsequent extensions "in the direction of the origin" are then still possible without having to adjust existing coordinates.

The position specification for bed locations (always with the size 2 x 2 meters) in a room is illustrated by the figure below (room size 4 x 4 meters):
4 + + + + + a = (0,2)
I I b = (1,2)
3 + + c = (2,2)
I d = (0,1)
2 a b c + e = (1,1)
I f = (2,1)
1 d e f + g = (0,0)
I h = (1,0)
0 g h i + + i = (2,0)

0 1 2 3 4

Given the bed size, no other position specification makes sense!!!

The position specifications of doors always refer to the corridor. Figure with corridor size 6x2m:


           (1,2)     (3,2)     (5,2)
      (0,2)     (2,2)     (4,2)
      +    +    +    +    +    +    +
(0,1) I                             I (6,1)
      +                             +
(0,0) I                             I (6,0)
      +    +    +    +    +    +    +
      (0,0)     (2,0)     (4,0)
           (1,0)     (3,0)     (5,0)

The use of (0,0) twice is not a mistake! This is how it works.

The following rules apply to corridor doors (here corridor size 3x3m)


horizontal doors:             vertical doors:

+    (0,3)     +              +    +    +    +
I              I              I    I    I    I   a = (3,3) !!!
+    (0,2)     +                                 =========
I              I              a    b    c    d   b = (1,0)
+    (0,1)     +                                 c = (2,0)
I              I              I    I    I    I   d = (3,0)
+    (0,0)     +              +    +    +    +

Note: the vertical door at the left corridor end has the coordinate of the upper right corner of the corridor!





Parameters

ACTION
BED1
BED2
BEDS
CBED
DOOR
FALL1
FALL1PZIFF
FALL2
FALL2PZIFF
HEAD
M_TYP
PATS
RBUFF
ROOM
RWNID
STAT
WINID

Exceptions

Function Group

NGRB2

ABAP Short Reference   Vendor Master (General Section)  
This documentation is copyright by SAP AG.

Length: 41214 Date: 20240523 Time: 133810     sap01-206 ( 170 ms )