Object documentationServices Application Component (Item Component)

 

The Services application component provides the fields for entering the services, which should be ordered or preregistered in the order item of the clinical order.

Note Note

Unlike the service request, a service in the clinical order is no longer compulsory. This means that you can also create clinical orders without services.

End of the note.

 

This application component is an item component. This means that the user can enter the services for the order items in the Item Level Tab Page in the clinical order.

System administration decides whether the user should enter this information in the corresponding order header in the clinical order. In addition, system administration defines the name of the tab page that is available for services.

See Structuring Tab Page

Methods
  • Services -> SET_SERVICE_2_CF

    You can integrate the method services -> SET_SERVICE_2_CF for the services component on the Methods Tab Page in the order type.

    You can use this method to determine that the services of an order item should be set to Confirmed status (CF) at a specific time (in the life cycle of the order).

    To do this you assign the method Services -> SET_SERVICE_2_CF to a specific item status (time). When the item status is changed or the clinical order is saved, the system sets all services of the item to the status CF.

    Note Note

    During customizing you must ensure that, in the clinical order workflow, no services are reset to Confirmed status (CF) from a higher status.

    End of the note.
  • Services -> SET_SERVICE_2_UA

    You can integrate the method services -> SET_SERVICE_2_UA for the services component on the Methods Tab Page in the order type. The prerequisite is that you use the services component in the corresponding order type.

    You can use this method to determine that several services are reset to the service status Unconfirmed Requested (UA) in one step when the status of the order item is changed or the clinical order is saved.

  • Services -> GENERATE_CYCLE_SERVICE

    To create cyclical individual services according to the cycle information, you must generate them.

    You can integrate the method services -> GENERATE_CYCLE_SERVICE for the services component on the Methods Tab Page in the order type. See Methods Tab Page.

    If you assign this method to the order type, the system will execute the method at the defined time. According to the cycle information, the system will generate corresponding individual services for the ordered cyclical services.

    However, you can customer-specifically override the generation logic. See Customer-Specific Enhancements for the Clinical Order

    You can use the organizational unit-related parameter (OU parameter) N1CCYGH to determine the generation horizon in weeks. See Organizational Unit-Related Parameters for Clinical Orders

    Note Note

    This function is available to you if you have activated the business function Clinical System Situation-Based Clinical Documentation (ISHMED_SCD).

    End of the note.

Structure

The application component contains, for example, the following fields for entering services:

  • Service

  • Service Description

  • Quantity

  • Status

  • Localization

  • Supplementary Text

  • Fasting Indicator

  • Appointment Date and Appointment Time (date and time of appointment with which the service is connected)

  • Desired Date and Desired Time (date and time of desired date according to appointment template)

    Note Note

    The desired date and desired time of the appointment proposal are identical for all services of the component. Changes affect the desired data and desired time of all services.

    End of the note.
  • Visit Date and Visit Time (date and time of visit with which the service is connected)

    Note Note

    In the services component of the clinical order the user can display and plan appointments for individual services, but only display desired appointments and visits.

    The columns Appointment Date and Appointment Time, Desired Date and Desired Time and Visit Date and Visit Time of the service component are also integrated into status-dependent screen modification. This means you can show or hide individual fields depending on the item status. It is therefore not necessary for you to manage the columns using the (user-specific) layout management.

    End of the note.

The following fields are also available on the Ordered Services tab page:

  • Code of Cycle (displays the cycle which was ordered for this service)

    Note Note

    You can order cycles as follows:

    • Cycle without defined end

      Note that in case of a cycle without a defined end the end date is defined in the movement duration of the clinical order.

    • Cycle with defined end

      You can restrict a cycle with an end date and time or using the duration. With a cycle with defined end, the system are generated until the end date is reached.

    End of the note.
  • Duration of Ordered Cyclical Service (specifies how long the cycle is valid)

  • Duration Time Unit (determines the unit of measure, e.g. days, weeks, etc.).

    Note Note

    You must use the central unit of measure of the SAP system for the Duration Time Unit. To do this, choose Start of the navigation path SAP NetWeaver Next navigation step General Settings Next navigation step Check Units of Measure End of the navigation path in Customizing.

    You can assign units of measure to objects of clinical orders in Customizing under Start of the navigation path Industry-Specific Component Clinical System Next navigation step Clinical Order Next navigation step Clinical Order Basic Data Next navigation step Manage Unit for Clinical Orders End of the navigation path.

    Note that the day is generally used as the time unit for the duration. This must therefore exist in the system.

    End of the note.
  • Start Date/Start Time Ordered Cyclical Service

    Note Note

    The Start Date/Start Time Ordered Cyclical Service fields specify the time from which cyclical individual services should be generated using the ordered service and the corresponding cycle. Note that the start date and the time are preset with the system time. If an appointment template is entered the system presets the start date and time with the information from the appointment proposal. In order to be able to generate services you must at least enter the start date and the time.

    Note that the entered Start Date/Start Time can be influenced by the start date of the cycle definition.

    End of the note.
  • End Date/End Time Ordered Cyclical Service

    Note Note

    The fields End Date/End Time Ordered Cyclical Service specify the time until which the cyclical individual services are generated using the ordered services.

    Note that the entered End Date/End Time can be influenced by the end date of the cycle definition.

    End of the note.
  • Maximum Number of Generated Cyclical Services

    Note Note

    The field Maximum Number of Generated Cyclical Services specifies the maximum number of individual services the system should generate for an ordered cyclical service. If you enter a maximum number of generated individual cyclical services, you cannot enter an end date or duration.

    Note that it is possible to additionally manually enter cyclical individual services.

    End of the note.
  • Cycle Indicator

    The system displays the following icons in the Cycle Indicator field:

    • Cycle Manually Changed (Cycle Manually Changed)

      This icon is available if the cycle definition was manually changed.

    • Cycle Ended (Cycle Ended)

      This icon is available if the ordered cyclical service was ended with this function.

    • Ordered Cyclical Service Canceled (Ordered Cyclical Service Canceled)

      Note that this function is only available in the cycle definition as long as no individual services have been generated. If the service to be canceled is an ordered cyclical service, the system will cancel all individual services which belong to this, and the cycle. See Cancel Clinical Order

    Note that these icons are also displayed at item level.

See Tab Page on Item Level