Revision history for Perl extension Net::Z3950::FOLIO.

2.2.0 (Fri Jul 16 12:21:00 BST 2021)

• Change default configuration so queryFilter omits instances that are suppressed from discovery. Add documentation on using queryFilter to omit discovery-suppressed records. Fixes ZF-50.

2.1.0 (Thu May 6 16:17:03 BST 2021)

• Add missing virtual fields to the GraphQL query used to fetch instances with their holdings and items: holdings temporary location, and item permanent and temporary locations. When used with a suffiently recent mod-graphql, fixes ZF-43.
• The GraphQL query now specifies to fetch up to 100 holdings records, and up to 100 items per holdings record. Fixes ZF-42.
• The virtual item records in holdings, from which OPAC records and holdings-related MARC fields are generated, now contains not only temporaryLocation but also the private field _permanentLocation. MARC holdings mappings can refer to this field, and the examples now map it to subfield L of the 952 field. An attempt to be all things to all people in ZF-43.
• Updates to release-procedure documentation.

2.0.0 (Mon Apr 26 12:19:40 BST 2021)

• Change to three-facet version numbers, which it turns out Perl has supported for a long time. This is necessary (as well as desirable) because CPAN thinks version 1.10 is older than 1.9, which is why there is no version 1.10 there. Fixes ZF-46.
• Update the release-procedure document to mention FOLIO-standard handling of version-number in the module descriptor. Fixes ZF-45.
• Increase version number to 2.0.0, so CPAN will recognise this as newer. NOTE. No functional changes since v1.10.

1.10 (Fri Apr 23 16:30:29 BST 2021)

• Add and document boolean nologin configuration element, which prevents login. This is potentially useful for running against hypothetical unsecured FOLIO instances, but the real reason we need it is for testing.
• Add new test-suite script that exercises the Z39.50 server's Fetch operation to get a higher-level entry into all the underlying mechanisms. Fixes ZF-37.
• MARCXML output now includes the same generated holdings-and-items data as USMARC output. Fixes ZF-38.
• Refactor internals so each Record is responsible for its own MARC, etc. Fixes ZF-39.
• Rename all snake-case methods to consistent camel-case. Fixes ZF-40.
• Fetching a record more than once no longer repeatedly appends multiple sets of holdings/item information. Fixes ZF-36.
• Post-processing is be applied to generated holdings and item fields. Fixes ZF-35.
• Replicate holdings-level permanent location at the item level, whence it can be included in MARC records. Fixes ZF-34.
• Update source-code overview documentation. Fixes ZF-41.

1.9 (Tue Mar 9 16:51:24 GMT 2021)

• Barcode Search in default connfiguration (use attribute 9998) now uses exact match (==) rather than the default string match operator (=). Fixes an issue raised in DEVOPS-558.

1.8 (Fri Feb 26 12:12:08 GMT 2021)

• Optionally, restrict item-level MARC holdings info to item mentioned in barcode search. Fixes ZF-32.
• Make t/07-short-session.t robust: skip this test if zoomsh is not available.

1.7 (Wed Feb 24 18:28:36 GMT 2021)

• The stripDiacritics post-processor handles additional special cases. Fixes ZF-31.
• The sample Dockerfile now invokes the server with the -v-session command-line option. This disables logging of new and ended sessions, which is a practical neccesity when deployed using Kubernetes, AWS ECS or similar setups, as these frequently ping the server to check that it's alive, resulting in log-flooding.
• Clarifications to the documentation.
• We no longer need to use a configuration override for ISBN searching in the Chicago service. Completes ZF-24.
• Towards providing MARC holdings data. Part of ZF-30.

1.6 (Tue Jan 26 15:34:56 GMT 2021)

• Element-set names are treated case-insensitively, meaning that (among other things) "F" and "B" are recognized as well as "f" and "b". Fixes ZF-29.

1.5 (Mon Nov 30 15:07:08 GMT 2020)

• Bring version-number in ModuleDescriptor.json up to date. I forgot to do this in v1.4, with the result that it wouldn't build in Jenkins.
• Add a Jenkins build to the release-procedure instructions.

1.4 (Fri Nov 27 00:49:05 GMT 2020)

• Add support for searching by local barcode. Fixes ZF-23.
• Add developer documentation with an overview of the source code. Fixes ZF-28.
• Use Z39.50 database name to indicate FOLIO tenant. Fixes ZF-2.
• Implement, test and document stacking configurations: base, tenant, filters. Fixes ZF-27.
• OPAC record now includes availableThru field, construed as the material-type of the item (provided that mod-graphql is running against a sufficiently new version of the mod-inventory-storage JSON schemas). Fixes ZF-26.
• z2folio writes to both standard output and standard error in UTF-8 mode. Yes, like you, I assumed this would be the default behaviour in 2020, but apparently Perl never got the memo.
• Support post-processing rules for MARC fields: diacritic removal and regular-expression substitution. Tests and documentation. Should give us all the flexibiliy we need for ZF-25.
• Support Chicago's currently non-standard ISBN searching. Fixes ZF-24.

1.3 (Thu Sep 24 20:16:12 BST 2020)

• Make robust when dealing with MARC fields that have no subfields.
• Add dependency on source-storage-source-records interface.
• When substituting environment variables in the configuration file, recognise the bash-like fallback syntax ${NAME-VALUE}, which uses the value of the environment variable NAME when defined, falling back to the constant value VALUE otherwise. This allows the configuration to include default values which can be overridden with environment variables.
• Use default configured index when no Z39.50 access-point is specified for a search.
• Support Z39.50 sorting. Fixes ZF-1.
• Make the set of available record-syntaxes and element-sets more coherent.
• Add configuration option to omit specified sort-index modifiers for specific access points. We should not need this, but in practice we will until CQLPG-102 is fixed.
• Provide documentation of server capabilities. Fixes ZF-17.
• Modify how FOLIO location data is mapped to OPAC-record fields. Fixes ZF-19.
• The itemId field in the OPAC record now contains the item barcode instead of HRID. Fixes ZF-21.
• Support and document relation specification in index-map specification, allowing the use of == for HRID searches. Fixes ZF-20.

1.2 (Fri Sep 18 10:15:11 BST 2020)

• Fix a couple of archaic formations that recent Perls complain about: unescaped { in regular expressions, passing a scalar reference to keys. These were causing test failures on some platforms.

1.1 (Thu Sep 17 19:46:10 2020 +0100)

• Attempt to mark classes in the Net::Z3950::RPN namespace as non-indexed, so PAUSE doesn't trip up on them when trying to index the module and seeing that classes of the same name are defined the SimplerServer distribution. Note that this have no functional effect on the behaviour of the code: it is only matter of getting the release to appear on CPAN.

1.0 (Thu Sep 17 16:25:51 BST 2020)

• First released version. Includes:
  • ZF-3 (Support returning OPAC records)
  • ZF-4 (Support returning MARC records)
  • ZF-5 (Get MARC records directly from linked storage (SRS))
  • ZF-6 (Get the basic server working)
  • ZF-7 (Improve query-mapping)
  • ZF-12 (Generate OPAC record from holdings/items according to mapping)
  • ZF-15 (Dockerize the Z39.50 server)
  • ZF-16 (Make release v1.0)

0.01 (Thu Dec 6 13:03:26 2018)

• Original version; created by h2xs -X --name=Net::Z3950::FOLIO --compat-version=5.8.0 --omit-constant --skip-exporter --skip-ppport

To do

• Determine FOLIO tenant from database name, and postpone initialisation and authentication until we know that (ZF-2).
• Automatic generation of MARC records (ZF-14). Thi will need a non-trivial version of etc/folio2marcxml.xsl (ZF-8).