...
NOTE: While the orders schemas already have some notion of alerts, they're not being used at - 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.
...
- 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
- Add new field to composite_purchase_order
- numAlerts
- integer
- default 0
- derived property - not stored.
- numAlerts
- Update GET /orders/composite-order/<id>
- calculate numAlerts
Schemas
alert_type
Property | Type | Default | Required | Notes |
|---|---|---|---|---|
id | string | NA | No | UUID of the AlertType - generated by the system if not provided |
| name | string | NA | Yes | A name for the alert type, e.g. "Failed to open", |
| description | string | NA | No | An optional description of the alert type |
| metadata | metadata | NA | No | System generated metadata |
alert
Property | Type | Default | Required | Notes |
|---|---|---|---|---|
id | string | NA | No | UUID of the AlertType - generated by the system if not provided |
| alertTypeId | string | NA | Yes | UUID of an alert type |
| context | string | NA | Yes | Free form text providing additional context, e.g. an error message |
| metadata | metadata | NA | No | System generated metadata |
APIs
mod-orders
Interface | Method | Path | Request | Response | Description | Notes |
|---|---|---|---|---|---|---|
| alert-types | POST | /alert-types | alert_type | alert_type | Create an alertType | Proxy to storage module. |
| alert-types | GET | /alert-types | CQL Query | collection<alert_type> | List/search alertTypes | Proxy to storage module. |
| alert-types | GET | /alert-types/<id> | NA | alert_type | Get a particular alertType | Proxy to storage module. |
| alert-types | PUT | /alert-types/<id> | alert_type | 204 | Update an alertType |
| Proxy to storage module. | ||||||
| alert-types | DELETE | /alert-types/<id> | NA | 204 | Delete an alertType | Proxy to storage module. |
JIRA
Feature:
| Jira Legacy | ||||||
|---|---|---|---|---|---|---|
|
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
...
mod-orders-storage
Interface | Method | Path | Request | Response | Description | Notes |
|---|---|---|---|---|---|---|
| order-storage.alert-types | POST | /order-storage/alert-types | alert_type | alert_type | Create an alertType | |
| order-storage.alert-types | GET | /order-storage/alert-types | CQL Query | collection<alert_type> | List/search alertTypes | |
| order-storage.alert-types | GET | /order-storage/alert-types/<id> | NA | alert_type | Get a particular alertType | |
| order-storage.alert-types | PUT | /order-storage/alert-types/<id> | alert_type | 204 | Update an alertType | |
| order-storage.alert-types | DELETE | /order-storage/alert-types/<id> | NA | 204 | Delete an alertType |
User Interface
Several requirements related to this work necessitate some UI work:
- ability to filter - give me orders and lines w/ alerts
- Populate filter based on:
GET /alert-types?limit=N GET /orders/composite-orders?query=cql.allRecords=1 NOT alerts ==/respectAccents []GET /orders/order-lines?query=cql.allRecords=1 NOT alerts ==/respectAccents []- NOTE: These queries may change once the order/order-line views are replaced with foreign keys and cross-index subqueries
- Populate filter based on:
- ability to see in order search results that there are N alerts
- use composite_purchase_order.numAlerts
- ability to see in order-line search results that there are N alerts
- use length of alerts array
- ability to add one or more alerts to a poLine
- ability to remove an alert - eventually the ability to mark as resolved
...
Stories:
...
Mock up to be provided by Dennis Bridges
JIRA
Jira Legacy server System JIRA serverId 01505d01-b853-3c2e-90f1-ee9b165564fc key UXPROD-2327