refs #12050, #11810

* enables a configurable item id for ILS connection health checks

config/vufind/config.ini

@@ -217,6 +217,9 @@ driver          = Sample
 ;loadNoILSOnFailure - Whether or not to load the NoILS driver if the main driver fails
 loadNoILSOnFailure = false
 
+; default item id to look up when performing health checks
+healthCheckItemId = 1
+
 ; This setting determines how and when hold / recall links are displayed.
 ; Legal values:
 ; - all (Show links for all items - Place Hold for Available Items and Place Recall

local/config/vufind/config.ini

@@ -165,6 +165,9 @@ driver          = Sample
 ;loadNoILSOnFailure - Whether or not to load the NoILS driver if the main driver fails
 loadNoILSOnFailure = true
 
+; finc specific item id to look up when performing health checks
+healthCheckItemId = 0000000001
+
 ; This setting determines how and when hold / recall links are displayed.
 ; Legal values:
 ; - all (Show links for all items - Place Hold for Available Items and Place Recall

module/finc/src/finc/ILS/Connection.php

@@ -90,4 +90,32 @@ class Connection extends \VuFind\ILS\Connection implements TranslatorAwareInterf
         }
         return $response;
     }
+
+    /*
+     * Overrides super method to look up a configurable item for health checks.
+     * TODO: Adjust super method and create pull request to community repo.
+     *
+     * */
+    public function getOfflineMode($healthCheck = false)
+    {
+        // If we have NoILS failover configured, force driver initialization so
+        // we can know we are checking the offline mode against the correct driver.
+        if ($this->hasNoILSFailover()) {
+            $this->getDriver();
+        }
+
+        // If we need to perform a health check, try to do a random item lookup
+        // before proceeding.
+        if ($healthCheck) {
+            $this->getStatus($this->config['healthCheckItemId']);
+        }
+
+        // If we're encountering failures, let's go into ils-offline mode if
+        // the ILS driver does not natively support getOfflineMode().
+        $default = $this->failing ? 'ils-offline' : false;
+
+        // Graceful degradation -- return false if no method supported.
+        return $this->checkCapability('getOfflineMode')
+            ? $this->getDriver()->getOfflineMode() : $default;
+    }
 }