Quickstart

This section gives an introduction about senaite.autopublish. It assumes you have SENAITE LIMS and senaite.autopublish already installed, with a reserved zeo client listening at port 8089 and a regular zeo client listening at port 8080. Please read the Installation for further details.

Control panel

Visit the control panel view for senaite.autopublish to configure the settings. This control panel is accessible to users with Site Administrator role, through “Site Setup” view, “Add-on Configuration” section:

http://localhost:8080/senaite/@@autopublish-controlpanel

Note

It assumes you have a SENAITE zeo client listening to port 8080

From this control panel view you can define the following settings:

  • Timeout: the maximum number of seconds the system will wait for a URL to complete while generating the results report. A default value of works for most instances, but consider to increase this value when there are too many failures in the queue monitor view or TimeoutException appears too often in the zeo client’s log.
  • Base URL: SENAITE’s url of the zeo client to use for the generation of results reports. This url is called by the queue’s zeo client. For instance, with a value of http://localhost:8081/senaite, the automatic results report generation will be done by the client listening at port 8081. If this setting is empty, the generation of results reports will by handled by queue’s zeo client.

Auto-publish samples

Login as a SENAITE regular user with enough privileges to publish samples. Be sure you have some samples in “verified” status. Go to Samples listing, and click to the “Verified” filter button (at the top of the list). Select some samples and a button “Auto publish” will be displayed at the bottom of the list.

Press the “Auto publish” button at the bottom and a confirmation view is displayed:

Confirmation view

Once the “Confirm” button is pressed, the system delegates the publication process of the selected samples to senaite.queue. These samples will be eventually published. Meanwhile, a progress icon is displayed next to them in listings.

Monitoring

You can keep track of the samples that are in the publishing queue from the top-right “hamburger” menu, link “Queue Monitor”:

http://localhost:8080/senaite/queue_tasks

From this view you can cancel the auto-publication of individual samples or see the details of each task. Visit the Documentation of senaite.queue for further details.