Axiell WebAPI home page > Documentation > Provisional release notes for WebAPI 3.2.1.1440

Provisional release notes for WebAPI 3.2.1.1440

Provisional release notes

Version 3.2.1.1405 is not an official release version yet. These release notes will be updated when new bug fixes and functionality are added before the final release.

Bug fixes

  • The getpointerfile command resulted in a SqlNullValueException when the pointerfiles_hitlist table had a "metadata" XML column (as was the case in old Adlib applications). Fixed in 3.2.1.1440.
  • Multilingual context fields could not resolve data correctly. From version 3.2.1.1405, a multilingual context field will be resolved for all languages. Example output:
    <Object_name>
      <object_name>
        <value lang="da-DK" invariant="true">Clairobscurtræsnit</value>
        <value lang="en-US" invariant="false">Chiaroscuro woodcut</value>
      </object_name>
      <object_name.code>co9027483890</object_name.code>
      <object_name.context>
        <value lang="da-DK" invariant="false">
        Arbejde på papir/Arbejde på papir/Grafisk Kunst. Fotografi.Reprografi/Højtryk/Clairobscurtræsnit
        </value>
        <value lang="en-US" invariant="false">
        Works on paper/Works on paper/Graphic art. Photography.Reproductions/Anticyclone/Chiaroscuro woodcut
        </value>
      </object_name.context>
    </Object_name>
    
  • OAI.ashx did not retrieve the last record from a set that is 1 larger than n times the default limit of 10 (so 11, 21, 31, etc.). Fixed in version 3.2.1.1359.

New functionality

New default data language parameter for insertrecord and updaterecord commands

From WebAPI version 3.2.1.1385, a new default data language parameter is available for the insertrecord and updaterecord commands (as well as for the deprecated writerecord command), to allow the client or user to POST monolingual record XML while specifying the default data language for any multilingual target fields once through the URL. This has the advantage that a lang attribute no longer needs to be added to fields in monolingual XML source data that is targeted for a multilingual field. So the client no longer needs to be to be aware of any multilingual fields in the target database and may POST its monolingual source data without lang attributes: the WebAPI will use the new language parameter (with an ISO 639-1-ISO 3166-1 language code like nl-NL or en-GB for example) to determine which lang attribute must be added automatically to any monolingual value when it is written to a multilingual field. Of course, if you're sure there exists no multilingual target fields, then you don't need to use the new parameter.
Partial example URL:

...wwwopac.ashx?command=insertrecord&database=fullCatalogue&language=nl-NL
(If you were to leave out the lang attribute in the XML body AND you do not provide the language parameter while writing the data to multilingual fields, an error will be reported as before in the XML diagnostic section.)

Version 2 of the Piction image plugin

From WebAPI version 3.2.1.1377, a version 2 of this image plugin has been made available. This contains the earlier implementation, as described here, plus a new implementation to support persistent links. To specify that your image server configuration addresses version 2 (instead of the default version 1), include the <Version>V2</Version>setting underneath the <ImagePlugin> node. Contrary to the version 1 implementation, you can specify only one rendition per image server configuration (or none at all, to get the default version from Piction). To compensate for this limitation, you may include an optional rendition=<value> parameter in the URL calling the image server. The parameter will take precendence over the rendition setting in the configuration. If you don’t include the rendition parameter in the request, it will take the value as set in the image server configuration.

The values for the V2 renditions can be one of the values listed below:
THUMBNAIL = thumbnail - this is always an image
T = thumbnail - this is always an image
T1 = thumbnail - this is always an image
THUMB = thumbnail - this is always an image
WEB = web quality derivative - this is always an image
W = web quality derivative - this is always an image
W1 = web quality derivative - this is always an image
Onn = original (nn = n-th version, like O3 for the third version)
MSOFFICE = Jpeg derivative - this is always an image
HIGHRESJPG = Jpeg derivative - this is always an image
ORIGINAL = original 1

Document download is supported too, by requesting an original document.