<content> Element

This element defines a content reference file.

Parent Elements

contentList

Attributes

Name	Type	Description	Required
fileName	string	The file name of the content file. If this is not specified as an absolute path (i.e., it includes a drive letter or UNC server name), then it is assumed to be relative to the directory configured via baseDirectory of <referenceContent> Element (for line). Variable placeholders and some wildcards are supported (see the remarks below). See the remarks below for a list of supported file types and other requirements.	Yes
unitModelNum	string	The unit model number(s) to which this content file applies. Wildcards are supported. If this is not specified, this content file will apply to all unit model numbers.	No
unitSerialNum	string	The unit serial number(s) to which this content file applies. Wildcards are supported. If this is not specified, this content file will apply to all unit serial numbers.	No

Child Elements

Name	Description	Required
parameters	Defines additional parameters specific to each file type.	No

Remarks

fileName can contain variable placeholders. The following variable placeholders are supported:

Placeholder	Gets Replaced By
@unitSerialNumber@	the unit serial number
@unitModelNumber@	the unit model number
@unitModelNumberAlias@	the unit model number alias

fileName can contain the following wildcards:

Wildcard	Matches
*	zero to many characters, not including directory separators
**	arbitrary directory depth

When wildcards are used, the first matching file found will be used. If no matching file is found, then the result will be as if this content does not apply.

Acuit Pinpoint Server must be able to read the file:

• The configured file name should be relative to Acuit Pinpoint Server.
• The account under which Acuit Pinpoint Server is running must have read access to the file.

The appropriate file viewer is determined by the file extension. The following file formats are supported:

• Text (.txt, .log, .dat)
  Various encodings, including ASCII and Unicode, are supported. Files are displayed word-wrapped horizontally, with vertical scrolling.

• Adobe Acrobat (.pdf)
  The first page (by default) will be displayed, with the page scaled to fit the display region. Paging, panning, and zooming are supported via the mouse and keyboard. The following special parameters are supported:

  Name	Type	Description
  page	integer	Which page number to display. When this is specified, all other pages are removed before displaying the document.
  scale	floating-point	The size of the PDF file being displayed relative to its original size. When not defined, the PDF will be sized to fit the PDF viewer.
  horizontalScrollOffset	floating-point	The initial position of the horizontal scroll bar, in device-independent pixels. If not specified, this defaults to 0, the leftmost position.
  verticalScrollOffset	floating-point	The initial position of the vertical scroll bar, in device-independent pixels. If not specified, this defaults to 0, the topmost position.

  Note: "device-independent pixels" are 96 pixels per inch, which may or may not reflect actual pixels or actual measurements on the screen, depending on hardware and system settings.

• Open XML Paper Specification (.xps, .oxps)

• Images (.bmp, .gif, .ico, .jpg, .jpeg, .png, .wdp, .tiff, .tif)

• HTML (.html, .htm, .mht)
  Internet Explorer components are used to render the file, so any content supported by Internet Explorer is supported.

• Rich Text Format (.rtf)

• Multimedia (video/audio; e.g., .mpg, .wmv, .mp3, .wav)
  Windows Media components are used, so all formats supported by Windows Media are supported; additional codecs can be installed on the Acuit Pinpoint Workstation computers as necessary. The following special parameters are supported:

  Name	Type	Description
  autoPlay	boolean	Whether to automatically start playing the media. If not specified, this defaults to true.