# Line Chart
## About
Line charts can retrieve output from scripts and APIs to display the data in a chart.
### Display Data from an API
You will need to return an array of JSON objects from your API in order to use a bar chart. An example would be returning a list of hashtables serialized to JSON.
```
@(
@{
Name = "Name1"
Value = Get-Random
}
@{
Name = "Name2"
Value = Get-Random
}
@{
Name = "Name3"
Value = Get-Random
}
) | ConvertTo-Json
```
In this example, you would configure the data source to an API and select your API endpoint.
You would then specify Name as the X axis and Value as the Y axis.
The resulting chart contains the data from the API. Each time the page is loaded, the API is called.
### Display Data from a Script
You will need to return PSCustomObjects, objects or hashtables from your script in order to display a chart from a script.
```
@(
@{
Name = "Name1"
Value = Get-Random
}
@{
Name = "Name2"
Value = Get-Random
}
@{
Name = "Name3"
Value = Get-Random
}
)
```
You will need to set the data source to script and select the script you want to retrieve data for.
You will need to set the Y and X axis to the properties of the object returned from the script.
The chart will appear on the page like this. Loading the page will not call the script again. It will load the result of the last time the script ran.
## Properties
| Property | Description | Available Since |
| ---------------- | --------------------------------------------------------- | --------------- |
| Id | The ID of this component | 2.2.0 |
| X Axis Field | The field to use as the X Axis for data within the chart. | 2.2.0 |
| Y Axis Field | The field to use as the Y Axis for data within the chart. | 2.2.0 |
| Data Source Type | Whether to use a script or API as a data source. | 2.2.0 |
| Data Source | The script or API to use as data for the chart. | 2.2.0 |
| Color | The bar color to use for the chart. | 2.2.0 |
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.powershelluniversal.com/v3/userinterfaces/pages/line-chart.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.