...
Configuring a logical representation of the freezer within OpenSpecimen.
This configuration is performed by an OpenSpecimen user
Setting up notifications from the Strata freezer to OpenSpecimen, ensuring that the system is alerted whenever specimens are stored or retrieved.
Most of this configuration is handled by an OpenSpecimen user, except for the final step (see point #3.b at the end of this document).
By following these steps, seamless communication between OpenSpecimen and the Azenta Strata freezer can be achieved.
...
Create an automated freezer provider. The provider serves as a list of settings required to connect to the Strata freezer for placing the retrieve request, and process store and /retrieve notifications from Strata. A sample configuration is shown in the screenshot below:
username and password are authentication credentials required for connecting to Strata to retrieve specimens etc
system_id identifies the physical Strata freezer
url encompasses everything leading up to the web service endpoint of the Strata APIs (i.e., all components before /ws)
Providers can be created by navigating to Home --> Extras --> Automated Freezer --> New Provider
The newly created provider needs to be subsequently used in the dimensionless storage container that represents Strata freezer within OpenSpecimen. Refer to the illustration below:
...
Once the above configuration is done, the Strata freezer needs to be instructed to alert/notify OpenSpecimen whenever specimens are either stored or retrieved from the freezer. Specifically, the Strata freezer needs to be asked to send TrayInputEvent and TrayOutputEvent notifications to OpenSpecimen.
Subscription to events is achieved by invoking the following OpenSpecimen API
Code Block |
---|
Method: PUT
Endpoint: <OpenSpecimen_URL>/rest/ng/strata-notifications/subscribe?providerId=<ProviderId>
Body: {}
Response: {"status": "OK"} |
...