Skip to content

Commit

Permalink
add info about grid columns for dashboard (#57)
Browse files Browse the repository at this point in the history
  • Loading branch information
natakazakova authored Mar 14, 2019
1 parent 7d072ea commit 7eca53e
Show file tree
Hide file tree
Showing 23 changed files with 81 additions and 0 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,9 @@ This section consists of the following topics.
* [Dimension Column](columns/dimension-column.md)

Describes dimension column specifics.
* [Hyperlink Column](columns/hyperlink-column.md)

Describes hyperlink column specifics.
* [Measure Column](columns/measure-column.md)

Describes measure column specifics.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,9 @@ The **Grid** dashboard item supports four types of columns.
* [Dimension Column](dimension-column.md)

Displays values in the bound data item "as is".
* [Hyperlink Column](hyperlink-column.md)

Allows you to display hyperlinks in the Grid dashboard item.
* [Measure Column](measure-column.md)

Displays summaries calculated against data in the bound data item.
Expand All @@ -32,6 +35,7 @@ Column type indicators are defined as follows:
| Icon | Column Type |
|---|---|
| ![Grid_ColumnTypeIndicators_DimensionColumn](../../../../../images/img19670.png) | [Dimension Column](dimension-column.md) |
| ![Grid_ColumnTypeIndicators_SparklineColumn](../../../../../images/img21673-hyperlink.png) | [Hyperlink Column](hyperlink-column.md) |
| ![Grid_ColumnTypeIndicators_MeasureColumn](../../../../../images/img19671.png) | [Measure Column](measure-column.md) |
| ![Grid_ColumnTypeIndicators_DeltaColumn](../../../../../images/img19669.png) | [Delta Column](delta-column.md) |
| ![Grid_ColumnTypeIndicators_SparklineColumn](../../../../../images/img21673.png) | [Sparkline Column](sparkline-column.md) |
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
---
title: Hyperlink Column
author: Natalia Kazakova
---
# Hyperlink Column

A _hyperlink_ column allows you to display hyperlinks in the Grid dashboard item.

![GridHyperLinkColumn_Example_Win](../../../../../images/GridHyperLinkColumn_Example_Win.png)

You can provide hyperlinks as a separate data column. or they can be automatically created at run-time from any column using the specified **URI pattern**.

In this document, the sample data source contains four fields: country name, official country name, Wikipedia country page's URI and the GDP value.

![GridHyperLinkColumn_UnderlyingDataSource](../../../../../images/GridHyperLinkColumn_UnderlyingDataSource.png)

The following sections describe how to create hyperlink columns in more detail:

- [Data Field Containing Uri Values](#data-field-containing-uri-values)
- [Uri Pattern](#uri-pattern)

## Data Field Containing Uri Values

Drag the _Name_ data field from the Data Source tree view to the column's [data item container](../../../binding-dashboard-items-to-data/binding-dashboard-items-to-data.md). The data field is automatically processed as [dimension](dimension-column.md). Drag and drop the GDP data field to another column's data item container. The data field is recognized as [measure](measure-column.md) and summarized.

![GridHyperLinkColumn_InitialGrid](../../../../../images/GridHyperLinkColumn_InitialGrid.png)

[Drop](../../../binding-dashboard-items-to-data/binding-dashboard-items-to-data.md) the _Link_ field between the _Name_ and the _GDP (Sum)_ data items. The Grid recognizes this field as **dimension** and displays links as plain text.

![GridHyperLinkColumn_HyperlinkAsText](../../../../../images/GridHyperLinkColumn_HyperlinkAsText.png)

Click the [Column Type Indicator](column-type-overview.md) button next to the _Name_ data item and change its type to **Hyperlink**.

![GridHyperlinkColumn_column_options](../../../../../images/gridhyperlinkcolumn_column_options.png)

The Grid displays column values as clickable hyperlinks allowing you to navigate to the Wiki's pages.

![GridHyperLinkColumn_HyperlinkAsLink](../../../../../images/GridHyperLinkColumn_HyperlinkAsLink.png)

You can bind the Display value and URI value to different data fields. Click the _New Column_ data item placeholder and change its type to **Hyperlink**.

![GridHyperlinkColumn_hyperlinkandurifromdata](../../../../../images/gridhyperlinkcolumn_hyperlinkandurifromdata.png)

Drag and drop the _OfficialName_ field to the _Display Value_ data item placeholder to display official country names. Drag and drop the _Link_ field to the _Uri_ data item placeholder to specify URIs.

The grid displays official country names with links obtained from the _Link_ data source field.

![GridHyperLinkColumn_HyperlinkWithDisplayText](../../../../../images/GridHyperLinkColumn_HyperlinkWithDisplayText.png)

## Uri Pattern
In this case, a specified URI pattern is used to generate links.

Drag the _Name_ data field from the Data Source tree view to the column's [data item container](../../../binding-dashboard-items-to-data/binding-dashboard-items-to-data.md). The data field is automatically processed as [dimension](dimension-column.md). Drag and drop the GDP data field to another column's data item container. The data field is recognized as [measure](measure-column.md) and summarized.

![GridHyperLinkColumn_InitialGrid](../../../../../images/GridHyperLinkColumn_InitialGrid.png)

Click the [Column Type Indicator](column-type-overview.md) button next to the Name data item and change its type to **Hyperlink**. Specify the **URI Pattern** option as follows:

```https://en.wikipedia.org/wiki/{0}```

![GridHyperLinkColumn_ColumnOptionsDialog](../../../../../images/GridHyperLinkColumn_ColumnOptionsDialog.png)

The ```{0}``` placeholder is replaced with the _Name_ data item value. The links are generated for country names and displayed in the grid as illustrated in the following picture.

![GridHyperLinkColumn_UriPatternLink](../../../../../images/GridHyperLinkColumn_UriPatternLink.png)
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified dashboard-for-desktop/images/img21673.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified dashboard-for-desktop/images/win-neutral-filter-mode-deselected.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 2 additions & 0 deletions dashboard-for-desktop/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -133,6 +133,8 @@
href: articles/dashboard-designer/designing-dashboard-items/grid/columns/column-type-overview.md
- name: Dimension Column
href: articles/dashboard-designer/designing-dashboard-items/grid/columns/dimension-column.md
- name: Hyperlink Column
href: articles/dashboard-designer/designing-dashboard-items/grid/columns/hyperlink-column.md
- name: Measure Column
href: articles/dashboard-designer/designing-dashboard-items/grid/columns/measure-column.md
- name: Delta Column
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,13 @@ The Grid dashboard item supports four types of columns.
* **Dimension**

A dimension column displays values from the bound data item "as is". If the dimension column is bound to a data source containing images, it can display images.
* **Hyperlink**

A dimension column allows you to display hyperlinks in the Grid dashboard item. You can provide hyperlinks as a separate data column, or they can be automatically created at run-time from any column using the specified **URI pattern**.

![grid_hyperlink_column](../../../../images/grid_hyperlink_column.png)


* **Measure**

A measure column displays summaries calculated against data in the bound data item.
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified dashboard-for-web/images/img125212.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified dashboard-for-web/images/img125253.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified dashboard-for-web/images/img125787.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 7eca53e

Please sign in to comment.