Function documentationLogic for Determining Display Variant

 

With appropriate customizing, the logic enables you to use different display variants for different planning organizational units (OUs) without the system displaying the dialog box for selecting a display variant, when the planning OU changes.

Features

If the system does not transfer a display variant to the planning grid, the system determines the display variant using the following logic:

  1. "Check N1PT_INF_DV_UPD_OFF":

    When you access the planning grid the system checks the user parameter N1PT_INF_DV_UPD_OFF.

    1. If the parameter is set (N1PT_INF_DV_UPD_OFF = "X"), the system continues checking with by checking "exactly one valid display variant".

    2. If the parameter is not set (N1PT_INF_DV_UPD_OFF = " ", or not managed), the system continues checking with "Check N1PT_INF_DV_*".

  2. "Check N1PT_INF_DV_*":

    Depending on the call mode (general planning, initial visit, follow-up visit) the system checks whether the display variant stored in the corresponding user parameter for general planning (N1PT_INF_DV_NM), for initial visits (N1PT_INF_DV_IV) or for follow-up visits (N1PT_INF_DV_FV) is valid for the current combination of role, user, and planning OU.

    1. If the display variant is valid, the system calls the planning grid with this variant.

    2. If the display variant is invalid, the system continues checking "exactly one valid display variant".

  3. "Check exactly one valid display variant":

    The system checks whether exactly one valid display variant exists for the planning OU and is also valid.

    1. If exactly one display variant exists and is valid, the system calls the planning grid with this variant. If the user parameter N1PT_INF_DV_UPD_OFF is not set, the system also updates the corresponding user parameter (depending on the call mode) and stores this variant.

    2. If more than one valid display variant exists or it is invalid, the system continues checking with "Check Default Indicator".

  4. "Check Default Indicator":

    The system checks whether there is exactly one display variant for the current combination of role, user, and planning OU, for which the Default indicator is set.

    1. If exactly one display variant exists, the system calls the planning grid with this variant. If the user parameter N1PT_INF_DV_UPD_OFF is not set, the system also updates the corresponding user parameter (depending on the call mode) and stores this variant.

    2. If not exactly one valid display variant exists, the system continues checking with the "Check N1PT_INF_DV_SE".

  5. "Check N1PT_INF_DV_SE":

    The system checks whether the user parameter N1PT_INF_DV_SE is set (N1PT_INF_DV_SE = "X").

    1. If the user parameter N1PT_INF_DV_SE is set, the system displays the dialog box for selecting a display variant.

    2. If the user parameter N1PT_INF_DV_SE is not set, the system calls the planning grid with the standard variant.

The check logic describes above will not be used under the following circumstances:

  • If the system can transfer a display variant during the call, e.g. in the Appointment Planning view type.

  • If you use the Business Add-In (BAdI) BADI: Transfer Display Variant (ISHMED_PG_DISP_VARIANT) to override the check logic for determining the display variant. You can transfer an existing variant when the planning grid is called or dynamically compile the tab pages and columns. See Customer-Specific Enhancements for Planning Grid

Example

Because the display variants additionally include the user, role, planning grid call mode and planning OU, the selection of a display variant using the Default indicator can supply several results.

Assignment table display variant 1:

(Row)

Role

User

Call Mode

Planning OU

Default

(1)

*

Meier

*

*

X

(2)

*

*

*

Endoscopy

X

Assignment table display variant 2:

(Row)

Role

User

Call Mode

Planning OU

Default

(1)

*

Huber

*

Outpatient clinic

X

(2)

*

*

*

Endoscopy

(3)

Physician

*

*

*

X

If the user Meier, who has the role of physician, accesses the planning grid with the Endoscopy planning OU, the selection would supply the following display variants for which the Default indicator is set:

  • Display variant 1, row 1 (-> user Meier)

  • Display variant 1, row 2 (-> Endoscopy planning OU)

  • Display variant 2, row 3 (-> role physician)

In case of several results the following prioritization applies:

  1. User

  2. Role

  3. Planning OU

In the above example, the system would therefore call the display variant 1, row 1.

If the system still cannot make a selection, despite the prioritization, it either uses user parameter N1PT_INF_DV_SE to display the dialog for selecting a display variant, or it calls the standard variant.