Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

event.consumer.ldnmessage.class = org.dspace.app.ldn.LDNMessageConsumer
event.consumer.ldnmessage.filters = Item+Install

...


...

Testing

Request Endorsement (LDN Message on item submission)

Let's configure a new Notify Service such as:

...

Create a new Community:

Create a new Collection inside the community

created above.

It is important for this community to have no Entity Type set.

Take a look into the item-submission.xml file for the

"traditional" steps sequence configuration. Here we've set

the coarnotify-step! The traditional step sequence is used as the

default, and the default is used for Collection with no entity

type associated.

If the coar-notify step is needed for every collection possible,

the entry-step must be added onto every <submission-process>

described into item-submission.xml


Create a new Item, select the collection created above.

As expected we see the COAR Notify section: here it is the

ldn request configuration: comboes for Review, Endorsement and

Ingest are filled with the corresponding configured LDN Services.

For this example we see only one value for the Endorsement 

combo (see the Inbound Pattern configured onto the Notify Service

named NotifyService Score0.123 - first screenshot of this paragraph)

 Deposit the item.


A new LDN Message of type Offer: Endorsement Action

is stored and enqueued! As soon as the Extractor manages it, it is

enrouted to the Processor configured at ldn-coar-notify.xml

(as one of the <outcomingProcessors>). The processor

is the bean named outcomingAnnounceEndorsementAction, which lists 

the SendLDNMessageAction. So, it is only at this point, when the

action SendLDNMessageAction is executed - that the notification

 is sent out to the external Notify Service.


To whom the notification is sent out? To the url configured 

as the LDN Inbox property of the Notify Service

(see above: https://notify-inbox.info/inbox/).

as soon as our Offer is correctly received on the Notify Service side,

the Notify Service has to provide us - asynchronously as a separate Acknowledge

LDN message - the Acceptance or Rejection of the Endorsement we offered.


When Acceptance is received:

The Acknowledge LDN Message - when received - is managed by the Processor

configured into the bean named acceptAckAction.


When Rejection is received:

The Acknowledge LDN Message - when received - is managed by the Processor

configured into the bean named rejectAckAction.


 Until an Acknowledge or an Announce is received for this item, on the item page you can see the upper yellow

window as:
 

at time of writing COAR service for test purposes is responding an HTTP 500

as we sent the Offer. This error did not exist back in December 2023 when we

firstly developed the LDN implementation.

...



Testing Announce Review

Let's trigger an Request Review (see COAR official pattern documentation here).Create a new Item into the COAR Notify Collection (collection created for the previous test).

Configure a new Notify Service such as:

Image Removed

By clicking the + New green button fill the form as:Image Removed

For this specific example we can set just the first Inbound Pattern as Request Review and leave the item filter blank. This test is not about item submission.
Pick the following POST call from the Postman project (see below to download it and import it to your installed PostMan instance): let's emulate the Notify Service external system sending us an LDN Message!  

For this test request to succeed you MUST UPDATE THE JSON BELOW you must update the json below based on your system configuration.  See the "IMPORTANT" lines.

...