Difference between revisions of "Dossier Element (Data)"

From HLKitWiki
Jump to: navigation, search
(New page: {{context|Kit Reference|Data File Reference}} ==The "dossier" Element== Dossiers represent a logical set of output for a portfolio, such as a character sheet, statblock, or even expo...)
 
Line 23: Line 23:
 
|-
 
|-
 
|[[#dossier_text|dossier_text]]
 
|[[#dossier_text|dossier_text]]
|Zero or more "dossier_text" elements may appear as defined by the given link. This element specifies text-based output, such as a statblock.
+
|An optional "dossier_text" element may appear as defined by the given link. This element specifies text-based output, such as a statblock.
 
|-
 
|-
 
|[[#dossier_export|dossier_export]]
 
|[[#dossier_export|dossier_export]]
Line 32: Line 32:
 
==The "dossier_sheet" Element{{anchor|dossier_sheet}}==
 
==The "dossier_sheet" Element{{anchor|dossier_sheet}}==
  
The "layoutref" element identifies a layout used within the sheet and assigns it a logical name for use within the Position script. The complete list of attributes for this element is below.  
+
The "dossier_sheet" element defines the structure of a printed dossier, containing a collection of sheets. The complete list of attributes for this element is below.  
  
 
:{| class="infotable"
 
:{| class="infotable"
|class="leftnormal"|layout
+
|class="leftnormal"|grouping
|Id Unique id of the layout to be utilized within the sheet.
+
|Text Specifies the name of the group into which this dossier should be placed for display. The groupings are used to logically organize multiple dossiers for presentation to the user, with the various groupings being sorted alphabetically.
 
|-
 
|-
|reference
+
|default
|(Optional) Id Specifies the alternate unique id to be used when referencing this layout within the Position script. This makes it possible to re-use the same layout more than once within the same sheet, giving each instance a different logical id. If empty, the reference id is simply the layout id. Default: Empty.
+
|(Optional) Boolean Indicates whether this dossier should be the default dossier that is pre-selected for the user when first outputting a dossier. Default: "no".
 
|-
 
|-
 
|}
 
|}
 +
 +
The "dossier_sheet" element also possesses child elements that describe its contents. The list of these child elements is below and must appear in the order shown. Click on the link to access the details for each element.
 +
 +
:{| class="infotable"
 +
|class="leftnormal"|[[#live|live]]
 +
|An optional "live" element may appear as defined by the given link. This element defines a [[Live Tag Expression]] that determines whether the dossier is made available for selection.
 +
|-
 +
|[[#sheetref|sheetref]]
 +
|Zero or more "sheetref" elements may appear as defined by the given link. This element identifies a sheet to be included in the dossier output.
 +
|-
 +
|}
 +
 +
===The "live" Element{{anchor|live}}===
 +
 +
The "live" element defines a [[Live Tag Expression]] for the dossier, which determines whether the dossier is shown to the user as a selection. The tag expression is compared against the tags assigned to the current actor. If the tag expression is satisfied, the dossier can be output, else it is hidden. This is ideal for situations like spellbooks that should only be shown for spellcasters. The complete list of attributes for this element is below.
 +
 +
:{| class="infotable"
 +
|class="leftnormal"|PCDATA
 +
|TagExpr – Specifies the code comprising the Live tag expression.
 +
|-
 +
|}
 +
 +
===The "sheetref" Element{{anchor|sheetref}}===
 +
 +
The "sheetref" element specifies a sheet to be output as part of the dossier. The sequence in which the sheets are specified dictates the order in which they will be processed in the output. The complete list of attributes for this element is below.
 +
 +
:{| class="infotable"
 +
|class="leftnormal"|sheet
 +
|Id – Specifies the unique id of the sheet to be included in the dossier output.
 +
|-
 +
|}
 +
  
 
==The "position" Element{{anchor|position}}==
 
==The "position" Element{{anchor|position}}==

Revision as of 15:51, 3 December 2008

Context: HL KitKit Reference … Data File Reference 

The "dossier" Element

Dossiers represent a logical set of output for a portfolio, such as a character sheet, statblock, or even export data for use with another product. Each dossier is specified through the use of a "dossier" element. The complete list of attributes for this element is below.

id Id – Specifies the unique id of the dossier. This id is used in all references to the dossier.
name Text – Public name associated with the dossier. Maximum length of 100 characters.

The "dossier" element also possesses child elements that define various facets of the dossier. The list of these child elements is below and must appear in the order shown. Click on the link to access the details for each element.

IMPORTANT! Exactly one of these child elements may be specified for each dossier. If multiple are given, a compiler error will be reported. The chosen child element dictates the type of dossier that is being defined and its characteristics.

dossier_sheet An optional "dossier_sheet" element may appear as defined by the given link. This element defines the structure of a printed dossier, such as a character sheet.
dossier_text An optional "dossier_text" element may appear as defined by the given link. This element specifies text-based output, such as a statblock.
dossier_export An optional "dossier_export" element may appear as defined by the given link. This element defines output that is tailored for use within another product, such as d20Pro.

The "dossier_sheet" Element

The "dossier_sheet" element defines the structure of a printed dossier, containing a collection of sheets. The complete list of attributes for this element is below.

grouping Text – Specifies the name of the group into which this dossier should be placed for display. The groupings are used to logically organize multiple dossiers for presentation to the user, with the various groupings being sorted alphabetically.
default (Optional) Boolean – Indicates whether this dossier should be the default dossier that is pre-selected for the user when first outputting a dossier. Default: "no".

The "dossier_sheet" element also possesses child elements that describe its contents. The list of these child elements is below and must appear in the order shown. Click on the link to access the details for each element.

live An optional "live" element may appear as defined by the given link. This element defines a Live Tag Expression that determines whether the dossier is made available for selection.
sheetref Zero or more "sheetref" elements may appear as defined by the given link. This element identifies a sheet to be included in the dossier output.

The "live" Element

The "live" element defines a Live Tag Expression for the dossier, which determines whether the dossier is shown to the user as a selection. The tag expression is compared against the tags assigned to the current actor. If the tag expression is satisfied, the dossier can be output, else it is hidden. This is ideal for situations like spellbooks that should only be shown for spellcasters. The complete list of attributes for this element is below.

PCDATA TagExpr – Specifies the code comprising the Live tag expression.

The "sheetref" Element

The "sheetref" element specifies a sheet to be output as part of the dossier. The sequence in which the sheets are specified dictates the order in which they will be processed in the output. The complete list of attributes for this element is below.

sheet Id – Specifies the unique id of the sheet to be included in the dossier output.


The "position" Element

The "position" element defines a Position Script for the sheet, which performs all the appropriate sizing and positioning of the contained layouts within the sheet. The complete list of attributes for this element is below.

PCDATA Script – Specifies the code comprising the Position script.

Example

The following example demonstrates what a "dossier" element might look like. All default values are assumed for optional attributes.

<dossier id="standard" name="Standard Character Sheet">
  <dossier_sheet grouping="AtTop" default="yes">
    <sheetref sheet="standard1"/>
    <sheetref sheet="standard2"/>
    </dossier_sheet>
  </dossier>