Difference between revisions of "LatestValues Editor Column Settings Tab"

From dataZoa Wiki
Jump to: navigation, search
(Display Settings:)
 
(36 intermediate revisions by the same user not shown)
Line 3: Line 3:
 
<div style="margin: 2em; margin-left: 6em;>
 
<div style="margin: 2em; margin-left: 6em;>
 
A LatestValues display can have up to 9 columns of data, each of which can be individually specified and formatted.  Each column has its own numbered sub-tab indicating what to show and how to show it.
 
A LatestValues display can have up to 9 columns of data, each of which can be individually specified and formatted.  Each column has its own numbered sub-tab indicating what to show and how to show it.
 +
</div>
  
==== Subtab: <div class="GfakeTabGroup"><div class="GfakeTab">Column 1</div></div><div class="GfakeTabGroup"><div class="GfakeTab">Column 2</div></div><div class="GfakeTabGroup"><div class="GfakeTab">Column ...<>iN</i></div></div> ====
+
==== <b>Subtabs:</b> <div class="GfakeTabGroup"><div class="GfakeTab">Column 1</div><div class="GfakeTab">Column 2</div><div class="GfakeTab">Column 9<i>N</i></div></div> ====
 +
<div style="margin: 2em; margin-left: 6em;>
 +
</div>
 +
 
 +
==== <b>Display Settings:</b> ====
 
<div style="margin: 2em; margin-left: 6em;>
 
<div style="margin: 2em; margin-left: 6em;>
 
<table class="Gbb1">
 
<table class="Gbb1">
<tr><td><b>Row Label:</b></td><td>Alternative label for selected row.</td></tr>
+
<tr><td>Field</td><td>Description</td><td>Example</td></tr>
<tr><td><b>Row Label Hover Info:</b></td><td>Adds a text-only message shown when the current row is hovered with the mouse</td></tr>
+
<tr><td class="GbcLgray" colspan="2"><b>Display Settings</b></td><td class="GbcLgray">Year-over-Year, where "down" is good...</td></tr>
 +
<tr><td>Show</td><td>What to show; latest, prior, etc</td><td>Percent Change</td></tr>
 +
<tr><td>Timespan</td><td>Number and type of earlier values to show</td><td>1 Year</td></tr>
 +
<tr><td>Arrows</td><td>Red/Green indicator arrows</td><td>Down is Green</td></tr>
 +
<tr><td>Date</td><td>Show date of the observation right in the column</td><td></td></tr>
 +
<tr><td>Units</td><td>Show date of the observation right in the column</td><td></td></tr>
 
</table>
 
</table>
</div>
+
<br>
 +
<div class="imgGlyph24 imgHowTo"></div>&nbsp;Notes on Display Settings:<br>
 +
<ul style="margin-left: 3em;">
 +
<li>When <i>"Latest Values"</i> or <i>"External Data"</i> are selected, the <b>Timespan</b> (offset) and <b>Arrows</b> settings have no effect. The most recent values are always displayed.</li>
 +
<li>When <i>"Prior Values"</i> is selected, the <b>Arrows</b> setting has no effect.</li>
 +
<li>When <i>"Prior Values"</i> are displayed for Weekly data, values and dates shown are for the week inclusive of N periods in the past, and this can have subtle consequences.  For example, showing Weekly data for One Month ago may show data in the current or prior calendar month, depending on calendar details.</li>
 +
</ul>
  
  
 +
<div class="imgGlyph24 imgIdea"></div><div class="imgGlyph24 imgHowTo"></div>&nbsp;Showing values from unrelated series as a column in a LatestValues Display
 +
<div style="margin-left: 3em;">
 +
<p>Generally speaking, each column in a LatestValues Display derives from its row Series.  By choosing <i>External Data</i> for a column, you can show values from Series that are <i>not</i> among the rows of the display itself.</p>
 +
<p>To designate these External series, you provide the name of a GroupList that lists the Series of interest in the order you like.  This column then shows the latest value for each Series in that GroupList.</p>
 +
<p><b>Remember:</b>  Changes to the GroupList will affect this embed.</p>
  
The top portion of the tab is used to set the row to work on, as well as add or remove rows.
+
<b>Usage Notes:</b>
 +
<ul>
 +
<li>The dates of the displayed values will match those of the primary data series (seen under "Row Settings").</li>
 +
<li>If the GroupList contains more series then the primary data then the extra series are ignored.</li>
 +
<li>Empty values indicate either a missing series or lack of a value on the specified date.</li>
 +
<li>If all values are empty, check that you have correctly entered the name of a valid, non-empty GroupList.</li>
 +
<li>This data is only exported with the download tool when using the "Only Data as Shown" option.</li>
 +
</ul>
 +
 
 +
[[LatestValues_Display_External_Data_Example|<b>Example</b>]]
 +
 
 +
</div>
 +
 
 +
</div>
 +
 
 +
==== <b>Header Settings:</b> ====
 +
<div style="margin: 2em; margin-left: 6em;>
 
<table class="Gbb1">
 
<table class="Gbb1">
<tr>
+
<tr><td>Field</td><td>Description</td><td>Example</td></tr>
<td>
+
<tr><td class="GbcLgray" colspan="3"><b>Display Settings</b></td></tr>
<b>Select Row:</b>
+
<tr><td>Custom Label</td><td>Free text/(limited)html</td><td>Y/Y % Chg</td></tr>
</td>
+
<tr><td>Show Header</td><td>Show or suppress column header entirely</td><td></td></tr>
<td>
+
Use this drop-down list to work on a particular row in your LatestValues display.  The rows are numbered and labeled as shown in the Preview section at the bottom of the editor.
+
</td>
+
</tr>
+
<tr>
+
<td>
+
<b>Add Row(s):</b>
+
</td>
+
<td>
+
If you have any data series checked in the Workbench view, these buttons let you insert them before or after the current row.
+
</td>
+
</tr>
+
 
</table>
 
</table>
 
</div>
 
</div>
 +
<br>
  
 
+
==== <b>Cell Formatting (column <i>N</i> only) button</b> ====
==== Subtab: <div class="GfakeTabGroup"><div class="GfakeTab">Cell Formatting (column <i>N</i> only)</div></div> ====
+
 
<div style="margin: 2em; margin-left: 6em;">
 
<div style="margin: 2em; margin-left: 6em;">
 
Tabular displays have highly refined formatting options. This tab controls formatting for the selected row.  All rows can be formatted at once in the <b><i>LatestValues Settings</i></b> tab.  Read about the [[Display Editor Cell Formatting Tab|cell formatting tab here]].
 
Tabular displays have highly refined formatting options. This tab controls formatting for the selected row.  All rows can be formatted at once in the <b><i>LatestValues Settings</i></b> tab.  Read about the [[Display Editor Cell Formatting Tab|cell formatting tab here]].
 
</div>
 
</div>
 +
[[Category:Displays]][[Category:Editing]][[Category:Intermediate]]

Latest revision as of 12:51, 26 December 2023

Column Selection

A LatestValues display can have up to 9 columns of data, each of which can be individually specified and formatted. Each column has its own numbered sub-tab indicating what to show and how to show it.

Subtabs:
Column 1
Column 2
Column 9N

Display Settings:

FieldDescriptionExample
Display SettingsYear-over-Year, where "down" is good...
ShowWhat to show; latest, prior, etcPercent Change
TimespanNumber and type of earlier values to show1 Year
ArrowsRed/Green indicator arrowsDown is Green
DateShow date of the observation right in the column
UnitsShow date of the observation right in the column


 Notes on Display Settings:
  • When "Latest Values" or "External Data" are selected, the Timespan (offset) and Arrows settings have no effect. The most recent values are always displayed.
  • When "Prior Values" is selected, the Arrows setting has no effect.
  • When "Prior Values" are displayed for Weekly data, values and dates shown are for the week inclusive of N periods in the past, and this can have subtle consequences. For example, showing Weekly data for One Month ago may show data in the current or prior calendar month, depending on calendar details.


 Showing values from unrelated series as a column in a LatestValues Display

Generally speaking, each column in a LatestValues Display derives from its row Series. By choosing External Data for a column, you can show values from Series that are not among the rows of the display itself.

To designate these External series, you provide the name of a GroupList that lists the Series of interest in the order you like. This column then shows the latest value for each Series in that GroupList.

Remember: Changes to the GroupList will affect this embed.

Usage Notes:

  • The dates of the displayed values will match those of the primary data series (seen under "Row Settings").
  • If the GroupList contains more series then the primary data then the extra series are ignored.
  • Empty values indicate either a missing series or lack of a value on the specified date.
  • If all values are empty, check that you have correctly entered the name of a valid, non-empty GroupList.
  • This data is only exported with the download tool when using the "Only Data as Shown" option.

Example

Header Settings:

FieldDescriptionExample
Display Settings
Custom LabelFree text/(limited)htmlY/Y % Chg
Show HeaderShow or suppress column header entirely


Cell Formatting (column N only) button

Tabular displays have highly refined formatting options. This tab controls formatting for the selected row. All rows can be formatted at once in the LatestValues Settings tab. Read about the cell formatting tab here.