Configure the process for creating medical devices included in in-service requests

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 3 min. de leitura

    • Use scripted extension points to decide what medical devices are created after an in-service request for a medical device is submitted.

    Antes de Iniciar

    Importante:
    Starting with the Xanadu release, Healthcare Computerized Maintenance Management System is being prepared for future deprecation. It will be hidden and no longer activated on new instances but will continue to be supported. For details on the deprecation process, see the Deprecation Process [KB0867184] article in the Now Support Knowledge Base.

    To use maintenance and servicing workflows or inventory and management workflows, please see Clinical Device Management.

    Set the application scope to Healthcare Computerized Maintenance Management System using the application picker. For more information, see Application picker.

    Role required: admin

    Por Que e Quando Desempenhar Esta Tarefa

    The Healthcare Computerized Maintenance Management System (Healthcare CMMS) application installs the sn_hcls_cmms.CreateDevicesForOnboardCase script, the CreateDevicesForOnboardCase script include, and the CreateDevicesForOnboardCase extension point.

    The sn_hcls_cmms.CreateDevicesForOnboardCase script is preconfigured to set the medical devices in-service request form available by default within the application. Before creating a medical device in-service request case, the application runs the sn_hcls_cmms.CreateDevicesForOnboardCase script and uses the following submission workflow logic to create records and avoid duplication of records:
    1. Create a medical device if the serial number of the device doesn't exist.
    2. Create a medical device model if one doesn't exist or associate the medical device with an existing model as included in the medical device in-service request form.
    3. Create work orders for the initial inspection of medical devices.
    4. Set the state of the devices to Installed when the medical device in-service case is set to Closed complete.

    Using extension points makes it easier to integrate customizations without actually altering the base code. You can extend standard base functionality using customized scripts. For more information, see Using extension points to extend application functionality.

    An implementation is available in the base system for scripted extension points. You can modify the data and add additional fields.

    Procedimento

    1. Navigate to All > System Extension Points > Scripted Extension Points.
    2. In the API Name column, search for and click sn_hcls_cmms.CreateDevicesForOnboardCase.
    3. On the Extension Point form, select a script include to use the CreateDevicesForOnboardCase extension point by creating and registering a custom script include.

      You can refer to the CreateDevicesForOnboardCase script include provided with the application to create a custom script include to set the medical device in-service cases. For more information, see Registering custom script includes against the scripted extension points.

    4. Customize the submission workflow logic of your medical device in-service request form by adding the createDevices,checkForDuplicateDevices, checkForDuplicateDevicesForNewModel, associateToExistingModel, createModel, createInspectionWorkOrders, installDevices, and cancelDevices methods to your script include that implements the CreateDevicesForOnboardCase extension point.
      You can create multiple implementations for an extension point and provide an order number for each implementation. The implementation that has the lowest order number is executed first.
      Tabela 1. Medical device in-service customizations

      Customization

      Implementation

      Create a medical device only when the selected model contains a device with a unique serial number.

      Include the createDevices method of the CreateDevicesForOnboardCase extension point in the implementation.

      When selecting an existing medical device model, check whether the serial numbers of the medical devices included in the medical device in-service request exist.

      Include the checkForDuplicateDevices method of the CreateDevicesForOnboardCase extension point in the implementation.

      When adding a new medical device model, check whether the serial numbers of the medical devices included in the medical device in-service request exist.

      Include the checkForDuplicateDevicesForNewModel method of the CreateDevicesForOnboardCase extension point in the implementation.

      Check whether any existing medical device model of the same name, serial number, and manufacturer included in the medical device in-service request exists and associate the model of the medical device with the medical device in-service case.

      Include the associateToExistingModel method of the CreateDevicesForOnboardCase extension point in the implementation.

      Create a medical device model with the name, serial number, manufacturer, and description as included in the medical device in-service request and associate the medical device model with the medical device in-service case.

      Include the createModel method of the CreateDevicesForOnboardCase extension point in the implementation.

      Create work orders for the initial inspection of each medical device included in the medical device in-service case.

      Include the createInspectionWorkOrders method of the CreateDevicesForOnboardCase extension point in the implementation.

      Set the status of medical devices that are associated with the medical device in-service case to Installed.

      Include the installDevices method of the CreateDevicesForOnboardCase extension point in the implementation.

      Set the status of medical devices that are associated with the medical device in-service case to Canceled.

      Include the cancelDevices method of the CreateDevicesForOnboardCase extension point in the implementation.
    5. On the Extension Point form, click Update.