Versions Compared

Key

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

...

  1. Configuring a logical representation of the freezer within OpenSpecimen.

    1. This configuration is performed by an OpenSpecimen user

  2. Setting up notifications from the Strata freezer to OpenSpecimen, ensuring that the system is alerted whenever specimens are stored or retrieved.

    1. 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.

...

  1. 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:

    1. username and password are authentication credentials required for connecting to Strata to retrieve specimens etc

    2. system_id identifies the physical Strata freezer

    3. url encompasses everything leading up to the web service endpoint of the Strata APIs (i.e., all components before /ws)

      ProviderConfig.png

      Providers can be created by navigating to Home --> Extras --> Automated Freezer --> New Provider

  2. 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:

    ContainerConfig.png

...

  1. 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.

  2. 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"}

...