MSECSD—Search Custom Screen Definitions

Processes associated with this form

This screen is accessed from the MSECSD—Custom Screen Definitions application for searching for CC and MSE applications that are personalised or customised.

Warning: The CCCSD—Custom Screen Definitions application supercedes the MSECSD—Custom Screen Definitions application that is supplied in the CCLAS package, and is, in fact, a system-scoped personalisation of it. It has improved services, additional search criteria to allow the search to return only Search or Detail pages, and the Change Status dialog has improved usability compared to the MSECSD—Custom Screen Definitions application.

The improved services include:

  • Search—Much faster than the MSECSD—Custom Screen Definitions application's Search as it uses a more efficient approach to determine whether a screen can be upgraded or not (does this during CCLAS deployment and persists the upgradable status), and allows wildcards in the Application Name, Alias and Scope Value search criteria.

  • Upgrade—Runs an enhanced algorithm to upgrade personalised screens.

  • UpgradeAll—Runs similarly to the MSECSD Upgrade All, except that it upgrades every single personalised page)

  • Import—Runs a different import to establish correct differences between personalised screens.

*** The Upgrade, Upgrade All or Import flows in the MSECSD—Custom Screen Definitions application SHOULD NOT BE USED as they could corrupt personalised or customised screens, thus rendering them unusable. Instead, use these services in the MSECSD—Custom Screen Definitions application to perform all personalised or customised screen upgrades and imports.

*** The MSECSD ALL core right is adjusted such that the CUSTOMISATION:UPGRADE, CUSTOMISATION:UPGRADEALL and CUSTOMISATION:IMPORTCUSTOMISATION resources are removed so that the out-dated services are not inadvertently run, and the CCSCREENCUSTOMISATION:SEARCH, CCSCREENCUSTOMISATION:UPGRADE, CCSCREENCUSTOMISATION:UPGRADEALL and CCSCREENCUSTOMISATION:IMPORTDEFINITION resources are added so that the new services can be run.

This screen can be used to also:

  • Change the scope of a personalised or customised application screen

  • Change the alias (name) of a personalised or customised application screen

  • Activate or deactivate a personalised or customised application screen

  • Delete a personalised or customised application screen

  • Upgrade a personalised or customised application screen

  • Import and export a personalised or customised application screen

  • Copy an existing personalised or customised application screen.

Note: This screen can only be accessed by the System Administrator or an employee who is given security access to manage personalisations and customisations.

Screen flows
  • Submit—Perform a search using the entered search criteria and display the results in the grid.
  • New Search—Return to the Search screen and clear the search results and the search criteria.
  • Saved Searches—Display a saved searches menu where you can save a search, rename and delete existing searches. Refer to Using the Screen Interface for more information.
  • Import—Import a JSON file.
  • Upgrade All—Upgrade upgrade all personalised or customised application screens.
Search Criteria

The primary criteria to search for custom screen definitions.

  • Core Applications Only

    Search customised and personalised screens by whether an application is a core application. Where checked, then other search criteria are ignored. Where cleared, then personalised and customised applications are returned in the search.

    Note: If this check box is selected, only the Import and Export actions are available.

  • Application Name

    Search customised and personalised screens by the name of the application, for example, CCSCHM.

  • Scope

    Search customised and personalised screens by scope type:

    • User—Return personalised or customised screens for the specified user.

    • System—Return personalised or customised screens with a scope of system.

    • Laboratory—Return personalised or customised screens for the specified laboratory.

  • Scope Value

    Search customised and personalised screens by the value of scope. Entry in this field is only needed if Scope Type is selected as User, System or Laboratory.

  • Screen Type

    Search customised and personalised screens by screen type:

    • Empty—Both personalised and customised screens are returned

    • Personalised—Personalised screens are returned

    • Customised—Customised screens are returned.

  • Alias

    Search customised and personalised screens by alias.

  • Status

    Search customised and personalised screens by status:

    • Active

    • Inactive.

Search Results Grid

  • Grid row flows

    • Copy—Create a copy of an existing personalised or customised screen.

  • Grid flows

    • Export—Export the selected application screens to either a JSON or XML file.

    • Change Scope—Change the scope of users that use personalised or customised screens.

    • Set Alias—Set (change) the name of the personalised or customised screen.

    • Change Status—Change the activity status of the personalised or customised screen.

    • Delete—Delete the selected custom screen definitions.

    • Upgrade—Upgrade the selected custom screen definitions screens.

  • Application Name

    The name of the application.

  • Application Description

    The description of the application, for example, if the screen name is CCCLNT, then this field displays a description of Search or Update Clients.

  • Alias

    The unique name for the personalised or customised screen.

  • Form

    The screen type, for example a Search or Detail screen.

  • Scope

    The scope type for the screen:

    • User

    • System

    • Laboratory.

  • Scope Value

    The scope value associated with the screen, for example, where Scope is User, then the user's Code displays in the field.

  • Screen Type

    The type of screen alteration:

    • Personalised

    • Customised.

  • Status

    The status of the personalised or customised screen:

    • Active

    • Inactive.

  • Is Upgradeable

    Where checked, then:

    • The personalisation screen has not been personalised on the most current core application screen.

    • An upgrade of the application screen is unsuccessful and it is still based on an earlier version of the core application screen.

    For failed upgrades, the following can be performed:

    • Manually perform the personalisation (using Open Personalisation) on the current core application screen.

    • When the application that is not upgradeable, you can export the application screen as XML and customise it, then re-import the application screen as a customised screen.

    Note: This check box cannot be selected manually—it is selected by the system. Customised screens are not supported. Each time a search is performed in the CCCSD—Custom Screen Definitions application, then a validation is performe to see if the application screen requires an upgrade.