Page History

...

Accessing and browsing the COAR Notify Dashboard

• Login as an Admin. A “COAR Notify > Dashboard” menu entry should be included in the administrative menu

• After clicking on “Dashboard”“Dashboard”, the landing page will display three tabs: Metrics, Logs/Inbound, and Logs/Outbound.

• As a default, the Metrics tab will be displayed as landing page and it will displays the following statistics, grouped in colored boxes (Metrics tab):

  • Number of received LDNs split by Accepted, Processed, Failure, and Untrusted

  • Number of generated LDNs split by Delivered, Queued, Queued for retry, and Failure

  • The total number of items involved, distinguished by received and sent LDNs

• Click on the “Accepted” “Accepted” box in the “Number “Number of received LDN” LDN” section

• The page will shift to the “Logs/Inbound” tab, with the table showing only messages with an Accepted status. The number of messages will match the number displayed in the Accepted box of the Metrics tab

• Browse back to the Metrics tab

• Click on the “Involved items” “Involved items” box in the “Number “Number of received LDN” LDN” section

• The user will be redirected to the Admin Search page, where only items involved in incoming LDN messages will be listed, and it will be possible to filter them by COAR Notify metadata, if any is present in an item

• Browse back to the COAR Notify > Dashboard

• Browse to the Logs/Inbound tab

• The page will present a table listing the logs of all inbound LDN messages, with filters facets on the left side

• Each log will have a corresponding button “Detail”, which will open a modal displaying the LDN message information and the related JSON payload

• Logs with status “Failed” and “Unmapped Action” will display also a “Reprocess” button

• Browse to the Logs/Outbound tab

• The page will present a table listing the logs of all outbound LDN messages, with filters facets on the left side

• Each log will have a corresponding button “Detail”, which will open a modal displaying the LDN message information and the related JSON payload

• Logs with status “Failed” and “Untrusted” will display also a “Reprocess” button

...

Testing Processed LDN Box

• Access the Metric tab in the COAR Notify Dashboard

• Drop Send a valid COAR LDN message from a TRUSTED source to the DSpace inbox

• wait for the extractor to process the LDN 

• The number of received processed LDNs should be incresed increased by one

• Wait up to 2 minutes and refresh the page 

• The number of processed LDNs should be increased by one

Number of received LDN from a UNTRUSTED source

Testing UNTRUSTED LDN Box

• Access the Metric tab in the COAR Notify Dashboard

• Drop Send a valid COAR LDN message from an UNTRUSTED source to the DSpace inbox

• The number of received LDNs should be incresed by one

• Wait up to 2 minutes and refresh the page 

• The number of LDN messages from UNTRUSTED source should be increased by one

...

Testing Failing LDN Box

• Access the Metric tab in the COAR Notify Dashboard

• Drop Send a valid COAR LDN message from a TRUSTED source with an UNMAPPED action to the DSpace inbox related to a not existing DSpace itemThe number of received LDNs should be incresed by one

• Wait up to 2 minutes and refresh the page 

• The number of failing LDN messages should be increased by one

...

Testing Accepted LDN Box

• Access the Metric tab in the COAR Notify Dashboard
• Send a valid COAR LDN message to an external service
• The service should reply with an acceptance LDN
• The number of accepted notification should be increased by one

Testing Queued/Delivered LDN Box

• Submit an item and request a review from a registered LDN service (alternatively, submit an item Submit an item and request a review from a registered LDN service (alternatively, submit an item in a collection for which the request review/endorsement/ingest to a set LDN service is handled automatically)
• Access the Metric tab in the COAR Notify Dashboard

• The number of queued LDN should be increased by one

• Wait for the extractor and refresh the page 

• The number of delivered generated LDN should be incresed by one (in the queued category)Wait up to 2 minutes and refresh the page increased by one

Testing the Failure LDN Box

• Configure a service with an invalid inbox
• Submit an item and request a review for the registered service with the invalid inbox
• Wait for the extractor
• The number of

...

• Failure LDN should be

...

• increased by one

Testing Queued for retry LDN Box

This is quite hard to test. The test should be made against a webservice which is not working at the moment of the request and that eventually starts responding to the LDN requests

Testing Logs of all the outgoing LDN messages

• Access the Logs/Outbound tab in the COAR Notify Dashboard

• The page should lists all outbound LDN messages, paginated, sorted by date descending, with the possibility to filter by Related item, LDN Service, Queue status, Activity stream type, COAR Notify type, and Last processing time

• Submit an item and request a review from a registered LDN service (alternatively, submit an item in a collection for which the request review/endorsement/ingest to a set LDN service is handled automatically)

• Filter by the LDN service, selecting the LDN service target of the request review

• Check that the logs include the messages sent to the selected LDN service

• Filter by Related item, selecting the title of the submitted item

• Check that the logs include the messages related to the submitted item

Testing Logs of all the incoming LDN messages

• Access the Logs/Inbound tab in the COAR Notify Dashboard

• The page should lists all inbound LDN messages, paginated, sorted by date descending, with the possibility to filter by Related item, LDN Service, Queue status, Activity stream type, COAR Notify type, and Last processing time

• Submit an item and request a review from a registered LDN service (alternatively, submit an item in a collection for which the request review/endorsement/ingest to a set LDN service is handled automatically)

• Emulate the Notify Service external system sending us an Announce Review LDN Message as described in COAR Notify Documentation#TestingAnnounceReviewagainstcurrentrepository

• Wait up to 2 minutes and refresh the page

• Filter by the LDN service, selecting the LDN service target of the request review

• Check that the logs include the messages sent by the selected LDN service

• Filter by Related item, selecting the title of the submitted item

• Check that the logs include the messages related to the submitted item, including the simulated Announce Review message

...