Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
how_to:understanding_data_references [2018/02/16 22:43]
tatewise
how_to:understanding_data_references [2019/10/10 11:43] (current)
tatewise [Sentence Template Data References]
Line 1: Line 1:
 ====== Understanding Data References ====== ====== Understanding Data References ======
 +
 +{{entry>​Customisation/​Understanding Data References;​See Index for related topics.}}
 +{{entry>​Data References/​Understanding Customisation;​-*}}
  
 ===== Introduction ===== ===== Introduction =====
Line 6: Line 9:
   * **[[:​Glossary:​Queries]]** to specify Columns, Row filters, and Titles   * **[[:​Glossary:​Queries]]** to specify Columns, Row filters, and Titles
   * **Diagram Text Schemes** to define the content of Diagram Boxes   * **Diagram Text Schemes** to define the content of Diagram Boxes
-  * **Diagram Options** in **Boxes** tab to define ​Diagram Box style since {{fh}} V4 +  * [[Using Flags and Icons and Expressions|Diagram ​Options ​Boxes > Conditions]] ​to define ​box style since {{fh}} V4 
-  * **Reports** to define Data items in certain Report Sections +  * [[.Report Options:​Main Contents|Reports]] to define Data items in certain Report Sections 
-  * **Sentence Templates** for **Narrative Reports** since {{fh}} V6+  * [[Customising Record Window Columns]] or **Named List** Columns 
 +  ​* **Captions** and **Custom Fields** in Property Boxes 
 +  * [[Narrative Report Fact Sentence Templates]] ​since {{fh}} V6
   * **Override Templates** for **Fact** displays since {{fh}} V6   * **Override Templates** for **Fact** displays since {{fh}} V6
 For a full list see the **Family Historian Help > Using Family Historian > Advanced Topics > Expressions and Contexts of Use**. For a full list see the **Family Historian Help > Using Family Historian > Advanced Topics > Expressions and Contexts of Use**.
Line 116: Line 121:
 ^ %CUR_FILE_OWNER% ​   | File Owner nearly everywhere ​  | ^ %CUR_FILE_OWNER% ​   | File Owner nearly everywhere ​  |
 ^ %CUR_FILE_HEADER% ​  | File Header nearly everywhere ​ | ^ %CUR_FILE_HEADER% ​  | File Header nearly everywhere ​ |
 +Narrative Sentence Templates:​\\
 +^ %CUR_PRIN% ​                | First or current principal for the fact  |
 +^ %CUR_PRIN2% ​               | Second or other principal for the Family fact  |
 +^ %CUR~WITN% and %CUR~WITN>​% | Current witness ​ |
  
 Contextual data references behave like ordinary data references, in that you can expand them to refer to any detail of the record in question. For example, **%CUR_SPOU>​SEX%** refers to the sex of the Individual'​s current spouse, and **%CUR_FILE_ROOT.SEX%** refers to the sex of the current file root.  Contextual data references behave like ordinary data references, in that you can expand them to refer to any detail of the record in question. For example, **%CUR_SPOU>​SEX%** refers to the sex of the Individual'​s current spouse, and **%CUR_FILE_ROOT.SEX%** refers to the sex of the current file root. 
Line 127: Line 136:
 Typically the data reference is enclosed in curly brackets and its context is the current fact, e.g. **{%FACT.PHON%}** refers to the fact phone number.  ​ Typically the data reference is enclosed in curly brackets and its context is the current fact, e.g. **{%FACT.PHON%}** refers to the fact phone number.  ​
  
-To refer to witness details from a witness sentence template requires the use of the **=GetContextItem()** function, and its context codes: +To refer to witness details from a witness sentence template requires the use of the **%CUR~WITN%** contextual data reference shown above.\\ 
-^ WITNESS ​      | Refers to the Witness Individual record ​   | +^ {%CUR~WITN>NAME:​GIVEN%} ​ | Returns the Witness record forename ​ | 
-^ WITNESS_LINK ​ | Refers to the link to the current Witness ​ | +^ {%CUR~WITN.NOTE2%} ​      ​| Returns the Witness role local Note  |
-e.g+
-^ {=GetFieldText(GetContextItem(WITNESS),"​%~.NAME:GIVEN%")}  | Returns the Witness record forename ​ | +
-^ {=GetFieldText(GetContextItem(WITNESS_LINK),"​%~.NOTE2%") | Returns the Witness ​link role Note   ​|+
  
 ===== Related Pages ===== ===== Related Pages =====