SELECT_APPOINTMENTS

Definition

You use this method to select which appointments are to be displayed. The possible selection criteria are the organizers, the participants, and the linked business objects of an appointment. The method can be called repeatedly with different parameters. The selected appointments are stored in the main memory and can then be displayed using the SHOW method.

Structure

Import Parameters

Import Parameters

Description

DATE_FROM

Start date and end date of selection period.

Only specify the selection period yourself in exceptional cases (for example, as a type of filter) because it is normally determined by the appointment display from the period displayed. If you specify the period yourself, you have to note that the appointments are then not automatically selected if the user changes the period displayed. You can display several unrelated intervals by calling the method repeatedly.

DATE_TO

ORGANIZER_LIST

Organizers of group appointments.

Organizers can be users, organizational units, or BOR objects.

All appointments for which at least one of the specified objects is entered as the organizer are selected.

A table of users, organizational units, and other BOR objects.

The display searches the appointment management for appointments that at least one of these objects has organized (created).

PARTICIPANT_LIST

Participants in the appointment.

A table of users, organizational units, and other BOR objects. The display searches the appointment management for appointments for which at least one of the specified objects is entered as a participant.

In the case of organizational units, you can specify whether the organizational unit is to be expanded and all appointments whose participants are members of the organizational unit are to be displayed as well. Using this indicator, you can display the appointments of all the employees in a department, for example.

In the case of users and organizational units, you can specify whether appointments are also to be displayed whose participants are organizational units that contain those users and organizational units. This indicator enables departmental meetings to be held dynamically with regard to the participants, that is, only the department is entered as the participant but all members can see the meeting in their calendars.

Participants can be users, organizational units, or BOR objects.

All appointments for which at least one of the specified objects is entered as a participant are selected.

APPL_OBJECT_LIST

Objects that are linked with the appointment.

You can specify the BOR objects for which the linked appointments are to be displayed. For each BOR object, you can also specify the role used for the link. If you do not specify a role, the standard role APPL_OBJECT is used. If you enter * as the role, the selection is role-independent.

All appointments that are linked with at least one of the specified objects are selected.

A table of BOR objects containing the application BOR objects and their roles.

The display searches for appointments that are linked with at least one of these objects using the generic object services. The link can be created and managed by the API modules of the appointment management, for example, if requested.

INCLUDE_ORG_APPOINTMENTS

Indicates whether appointments of associated organizational units are also to be selected.

If you enter a user or an organizational unit as a participant and set this indicator, the appointments of all organizational units that contain this user or organizational unit as a member (superordinate) are also displayed.

WEGID_FOR_ORG_APPOINTMENTS

Indicates whether the appointments of members of organizational units are also to be selected.

If you enter an organizational unit as a participant and set this indicator, all appointments in which a member of the organizational unit is a participant (subordinate) are also displayed.

This enables the appointments of all employees in a department, for example, to be displayed.

ADDITIONAL_APPOINTMENTS

Reference to an instance of a class that has implemented the IF_ORGANIZER_CALL_BACK_APPT interface.

Only use this parameter in exceptional cases. The appointments that are additionally displayed using this parameter are not displayed in the calendar display of other applications. This must be explained to users who use the appointment display in multiple applications so that they do not become confused when some appointments are not always displayed.

Additional appointments

Appointments that are not in the central appointment management.