PlanningCalendar type information is wrong

[martin-d-aleksandrov]

The type information of PlanningCalendar.getSelectedAppointment() method is defined as

 /**
     * Holds the selected appointments. If no appointments are selected, an empty array is returned.
     *
     * @since 1.54
     *
     * @returns Array of IDs of selected appointments
     */
    getSelectedAppointments(): CalendarAppointment[];

Although, the method return type is declared as an array of CalendarAppoinments, in runtime it actually returns an array of strings, representing the controls' ids

[ndeshev]

Hello @martin-d-aleksandrov in the function description it is stated that it returns an array of ID's of the selected appointments in order for the return array type to be more clear.

[codeworrior]

@ndeshev I think, @martin-d-aleksandrov is complaining about the generated typescript types, they don't match the runtime behaviour of the method. And this is caused by the wrong JSDoc type info here.

Should be

 * @returns {sap.ui.core.ID[]} Array of IDs of selected appointments

[ndeshev]

I've created an internal incident DINC0364557 for an update of the documentation. The status of the issue will be updated here in GitHub.