Laser/ERM integration is a collection of features aimed at allowing a LASER site to synchronize their subscriptions (Content Lists) and licenses with the FOLIO ERM Agreements and Licenses apps. The integration works via a new backed module : mod-remote-sync (https://github.com/folio-org/mod-remote-sync) and related UI: ui-remote-sync (https://github.com/folio-org/ui-remote-sync). Taken together, remote-sync is general purpose scriptable ETL tool for FOLIO into which arbitrary configurations can be loaded and used to keep FOLIO in sync with a remote data source. Whilst remote-sync itself is intended to be general and reusable, the configuration for LASER is solution specific and can be found here (https://raw.githubusercontent.com/k-int/folio-sync-tools/main/laser/laser_registry.json).
...
On the left side, the record source is listed. Boxes in this column represent the actual raw records which will be / have been collected from a remote source. Remote sync runs on a cron schedule which is invoked every 60 minutes. If a previous extract job has not yet completed, the task is skipped. This means remote-sync will try to synchronize with a remote source once per hour. Because some sources (LASER) do not provide a good cursor mechanism the only way to tell if a record has changed is to download the content and compare the current version with the previous one. That is exactly the process which takes place in this box for LASER. The main aim of the first column is to take a datasource with heterogeneous cursor semantics and turn it into a record stream which can be enumerated. The boxes on the left hand side correspond to the "source" record types in the registry.
...
agreementUpdate procedure
buildPeriods procedure
...
- lookUp any existing controlling license
- If the existing (FOLIO) license data is different to the new (LASER) license data unlink the existing controlling license and link the new controlling license
- update periods
- for each period in the FOLIO agreement. If the FOLIO period DOES NOT overlap with the period from the LASER agreement
- Add the agreement period as a new period to the FOLIO agreement
- if it DOES overlap
- We cannot continue, ask the user to rectify the dates
- for each period in the FOLIO agreement. If the FOLIO period DOES NOT overlap with the period from the LASER agreement
- Check that there is an AL for the package attached to this sub - if not - add a new AL for the package (Title list changed at laser effectively)
- post updated subscription information
buildPeriods procedure
- clear any existing periods from the FOLIO record
- replace that period with a new period as per
Map newPeriod = [
startDate: subscription.startDate,
endDate: subscription.endDate
]