Axiell WebAPI home page > Documentation > Axiell FotoWare image plugin

Axiell FotoWare image plugin

The Axiell WebAPI image server configuration

From WebAPI version 3.3.1.1665, an Axiell.Fotoware.Plugin.dll plugin for the Axiell WebAPI is available to allow the retrieval (not the ingest) of images from a FotoWare DAMS. In 3.3.2.1808 the functionality was still revised. As all other plugins it allows you or your Axiell system to use getcontent calls to communicate with the DAMS-specific API via the Axiell WebAPI. An appropriate configuration in adlibweb.xml is all you need to retrieve digital content via wwwopac.ashx getcontent queries. For FotoWare you need a configuration similar to the following:

<!-- Image server settings -->
<imageServerConfiguration name="fotoware">
    <servertype>FileSystem</servertype>
    <path>C:\Data\Projects\model5.0\images</path>
    <ImagePlugin type="Axiell.Fotoware.Plugin.FotowarePlugin, Axiell.Fotoware.Plugin">
      <Host>https://ourdomain.org</Host>    
      <ArchiveUrl>/fotoweb/archives/</ArchiveUrl>
      <UniqueIDField>187</UniqueIDField>
      <Oauth>
         <ClientId>1e2ge492-2234-4bww-831a-ab99a52awq7b</ClientId>
         <ClientSecret>TMAEWbEiBMdstNjJPperHsAEVtGUn4pa59-y1me4i5</ClientSecret>
      </Oauth>
      <MaxSize>1200</MaxSize>
    </ImagePlugin>
</imageServerConfiguration>

As you can see there are just 6 elements to configure:

  • Host: the domain part of the URL to the Fotoware repository (the DAMS)
  • ArchiveUrl: the remaining part of the URL to the Fotoware repository
  • UniqueIDField: the Fotoware field containing the unique ID of the asset
  • ClientId: the unique of the client as provided by the Fotoware repository
  • ClientSecret: the secret client key as provided by the Fotoware repository
  • MaxSize: optional size limit for getting renditions (or previews) from Fotoware. See below for a list of previews with their size values. When a MaxSize is configured and there‚Äôs no width and height used on the getcontent request, the preview retrieved will not be of a higher size than the configured MaxSize value.

Previews:

  • 0 (size = 800, width = 800, height = 675)
  • 1 (size = 1200, width = 1200, height = 1013)
  • 2 (size = 1600, width = 1600, height = 1350)
  • 3 (size = 2400, width = 2400, height = 2025)
  • 4 (size = 200, width = 200, height = 169)