Apresentação

O controle BarAndSplineCustomChart é um gráfico customizado desenvolvido para apresentar valores de histórico de uma determinada tag no formato de colunas e com linha que toca os valores de histórico no gráfico.

Image Removed

Como usar

Requisitos mínimos

Presentation

The BarAndSplineCustomChart control is a custom chart designed to display history values for a given tag in column format and with a row that touches the history values on the chart.

Image Added

How to use

Minimum requirements

• Action.Net version 9.2.28.1 ou posterioror later;

Configuração

Configuration

1. Insert the file "SPIN. ActionNet.View.Wpf.Charts.dll” na pasta WpfControls da instalação (normalmente em “Cdll" in the WpfControls folder of the installation (typically in "C:\Program Files (x86)\SPIN\Action.Net\an-x.x\WpfControls\”) caso o mesmo não exista.

2. Abrir o projeto do Action.Net onde o controle será utilizado;

3. Na aba “Draw”, escolher a página onde o controle será utilizado;

4. Na barra lateral de ferramentas, escolher o item “Insert Component”;

   Image Removed

5. Ao abrir a tela de seleção de componentes, selecionar o controle BarAndSplineCustomChart;

   Image Removed

6. Inserir o controle na tela e dimensioná-lo.

7. Selecionar o controle e inserir um Uid para o mesmo. É este que será utilizado no code-behind para passar os dados ao gráfico.

8. Configurar o código no code-behind da tela:

1. ") if it does not exist.

2. Open the project of the Action.Net where the control will be used;

3. In the "Draw" tab, choose the page where the control will be used;

4. In the toolbar, choose the item "Insert Component";

   Image Added

5. When you open the component selection screen, select the BarAndSplineCustomChart control;

   Image Added

6. Insert the control on the screen and scale it.

7. Select the control and enter a Uid for it. This is what will be used in the code-behind to pass the data to the graph.

8. Configure the code in the screen code-behind:

Initially, it is necessary to access the control from your Uid. To get a reference from the control to use it, use the following script:

SPIN.ActionNet.View.Wpf.Charts.BarAndSplineCustomChart barAndSplineCustomChart1 = 
		this.CurrentDisplay.GetControl("barAndSplineCustomChart1") as SPIN.ActionNet.View.Wpf.Charts.BarAndSplineCustomChart;
		
if(barAndSplineCustomChart1 != null){

//... code goes here

}

Em seguida, os dados precisam ser passados para o controle. O mesmo dispõe de uma função para a passagem dos dados a partir de um datatable para o controle. Sua assinatura pode ser conferida abaixoThen the data needs to be passed to the control. It has a function for passing data from a datatable to the control. Your signature can be checked below:

public void ApplyHistorianData(string tagName, DataTable histValues){}

OndeWhere:

tagName: refere-se ao tag de pesquisa. Este parâmetro é usado para o Header do gráficorefers to the search tag. This parameter is used for the Chart Header.

histValues: refere-se a uma tabela cujo formato consiste na primeira coluna com valores compatíveis com o tipo DateTime e a segunda coluna com valores compatíveis com os tipos float ou double.Esta função pode ser chamada de como mostrado abaixorefers to a table whose format consists of the first column with values compatible with the type DateTime and the second column with values that are compatible with the types float or Double.

This function can be called as shown below:

string tagName = @"SE01\TR01\tag1.MED.MW";
DataTable result = GetHistorianMeasures(tagName);
if(result != null && result.Rows.Count > 0)
    barAndSplineCustomChart1.ChartControl.ApplyHistorianData(tagName, result);

This specific application of the example used the Spin toolkit to search for measurements of a certain period (last 10 days). The complete code for this application can be checked below:

using SPIN.ActionNet.View.Wpf.Charts;
	  
public void DisplayOpening()
{
}

public void DisplayIsOpen()
{
}

public void DisplayClosing()
{
}
 
////This method is only called on Dialog displays
public bool DialogOnOK()
{
	return true;
}

public DataTable GetHistorianMeasures(string tagName){
	DataTable result = null;
	
	try{
		DateTime startDate = DateTime.Now.AddDays(-10);		
		result = @Script.Class.CustomMeasures.GetMeasures(tagName, startDate, DateTime.Now, 10);
	}
	catch(Exception ex){
		@Info.Trace(ex.Message);
	}
	
	return result;
}

public void ButGetSampleData_Click(object sender, System.Windows.Input.InputEventArgs e)
{
	SPIN.ActionNet.View.Wpf.Charts.BarAndSplineCustomChart barAndSplineCustomChart1 = 
		this.CurrentDisplay.GetControl("barAndSplineCustomChart1") as SPIN.ActionNet.View.Wpf.Charts.BarAndSplineCustomChart;
		
	if(barAndSplineCustomChart1 != null){
		string tagName = @"SE01\TR01\tag1.MED.MW";
		DataTable result = GetHistorianMeasures(tagName);
		if(result != null && result.Rows.Count > 0)
			barAndSplineCustomChart1.ChartControl.ApplyHistorianData(tagName, result);		
	}
	
}

using SPIN.ActionNet.Biz.Toolkit.Reports;
using System.Threading.Tasks;

public DataTable GetMeasures(string tagName, DateTime startDate, DateTime endDate, int interval)
{
	List<string> tagNames = new List<string>();
	tagNames.Add(tagName);
	
	DataTable result = Measures.GetReport(tagNames,startDate, endDate, interval);
	
	return result;
}

BarAndSplineCustomChart

No controle foram expostas aos usuários algumas propriedades e métodos para uso do gráfico. Nas tabelas a seguir, é possível visualizar os nomes das propriedades e dos métodos e suas descrições:

Propriedades

Nome

Descrição

TagName

Nome da tag a qual o gráfico se refere. Este nome será mostrado no cabeçalho do gráfico

HistValues

Lista observável de objetos do tipo HistorianValues que contém informações de valor e Timestamp da tag

XAxisLabelFormat

Corresponde ao formato do texto desejado para o label do eixo X. Este é o eixo de data / hora.

O formato padrão para esta propriedade é “MMM-dd HH:mm”.

XAxisLabelRotationAngle

Corresponde ao ângulo de rotação desejado para o label do eixo X. Deve-se passar valores de -360 a 360.

YAxisLabelFormat

Corresponde ao formato do texto desejado para o label do eixo Y. Este é o Eixo de valores.

O formato padrão para esta propriedade é “N0”.

YAxisLabelRotationAngle

Corresponde ao ângulo de rotação desejado para o label do eixo Y. Deve-se passar valores de -360 a 360.

Métodos

Nome

Descrição

ApplyHistorianData(string, DataTable)

Método que transforma os parâmetros passados em linhas e colunas do gráfico e aplica estas informações ao gráfico.

Parâmetros

tagName: refere-se ao tag de pesquisa. Este parâmetro é usado para o Header do gráfico.

Members

In the control, users were exposed to some properties and methods for using the chart. In the following tables, you can view the names of properties and methods and their descriptions:

Properties

Methods