Skip to end of banner
Go to start of banner

Order Alerts

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

Overview

Alerts serve as a way for the system to bring attention to issues that require human intervention.  The context here is orders.  See the linked feature for additional background and use cases.

NOTE: While the orders schemas already have some notion of alerts, they're not being used - At least they're not exposed by the UI and aren't being populated by FOLIO.  This is an artifact from the very early days of acquisitions.  

Approach

  • Introduce a new controlled vocabulary 'AlertType'
    • new schema
    • new storage (CRUD) API
    • new business logic (CRUD) API - proxies to storage API
  • Refactor po-line alerts
    • to reference an AlertType
    • have a single free-form text field for capturing context/error information
    • system generated metadata

Schemas

alert_type

Property

Type

Default

Required

Notes

id
string
NANo

UUID of the AlertType - generated by the system if not provided

namestringNAYesA name for the alert type, e.g. "Failed to open",
descriptionstringNANoAn optional description of the alert type
metadatametadataNANoSystem generated metadata

alert

Property

Type

Default

Required

Notes

id
string
NANo

UUID of the AlertType - generated by the system if not provided

alertTypeIdstringNAYesUUID of an alert type 
contextstringNAYesFree form text providing additional context, e.g. an error message
metadatametadataNANoSystem generated metadata

APIs

mod-orders

Interface

Method

Path

Request

Response

Description

Notes

alert-typesPOST/alert-typesalert_typealert_type

Create an alertType

Proxy to storage module.  
alert-typesGET/alert-typesCQL Querycollection<alert_type>List/search alertTypesProxy to storage module.  
alert-typesGET/alert-types/<id>NAalert_typeGet a particular alertTypeProxy to storage module.  
alert-typesPUT/alert-types/<id>alert_type204Update an alertType Proxy to storage module.  
alert-typesDELETE/alert-types/<id>NA204Delete an alertTypeProxy to storage module.  

mod-orders-storage

Interface

Method

Path

Request

Response

Description

Notes

order-storage.alert-typesPOST/order-storage/alert-typesalert_typealert_type

Create an alertType


order-storage.alert-typesGET/order-storage/alert-typesCQL Querycollection<alert_type>List/search alertTypes
order-storage.alert-typesGET/order-storage/alert-types/<id>NAalert_typeGet a particular alertType
order-storage.alert-typesPUT/order-storage/alert-types/<id>alert_type204Update an alertType 
order-storage.alert-typesDELETE/order-storage/alert-types/<id>NA204Delete an alertType

JIRA

Feature: UXPROD-2327 - Getting issue details... STATUS

Stories:

  • TBD


NOTES:

Alerts:

  • AlertType = controlled vocabulary - with system values that are always there (e.g. for "Order failed to open") - need to define these!
  • Context/Error/Alert text = free form text
  • Metadata = system generated


Also needed:

  • ability to filter - give me orders and lines w/ alerts
  • ability to see in order search results that there are N alerts
  • ability to remove an alert - eventually the ability to mark as resolved

Stories:

  • MODORDERS-176 - do as is 
  • Create stories to implement what we have above
  • Create another story to update various places in order logic to create alerts (e.g. at least the MODORDERS-176)


  • No labels