Configurando Conexões de Bancos de dados

Configuring Database Connections

By default, Action.NET uses a built-in SQLite SQL database manager for Tag and Alarm Historians. You can configure other external databases, such as Microsoft SQL Server, Oracle, ou outros. Se você tem a expectativa de que estes historiadores vão necessitar armazenar grandes quantidades de dados e exigir maior robustez e características cliente/servidor, você deve considerar desde a implantação inicial o uso de um banco de dados externo.

Ao usar o banco de dados integrado, o Action.NET cria automaticamente o arquivo de banco de dados. Ao usar bancos de dados externos, o arquivo do banco de dados deve ser criado pelos utilitários pelo uso do gerenciador escolhido. No entanto, o Action.NET pode criar as tabelas no banco de dados, disponibilizado.
Você pode usar também bancos de dados externos como fonte de dados em sua aplicação para exibir dados como informações do cliente ou de seus produtos ou para configurar sistemas de receitas.

O botão SQL Query Builder possibilita a chamada a um aplicativo que é uma ferramenta para a construção de consultas SQL. Veja nesta documentação a a secção Visual SQL Query Builder com detalhes sobre a utilização deste aplicativo.

Você precisa estar logado como administrador no Action.NET, para configurar o login e a senha do banco de dados.

Image Removed

Para configurar um banco de dados externo:

1. Vá para Edit> Datasets > DBs.

2. Clique em Create New.

   • É mostrada a janela de Criar Nova Conexão de banco de dados.

3. Digite ou selecione as informações, conforme necessário

Image Removed

Coluna

Descrição

Name

Digite um nome para a configuração do banco de dados. O sistema indicará se o nome não é válido, mostrando a célula com o contorno vermelho.

Description

Digite uma descrição para o banco de dados.

Provider

Selecione o provedor de banco de dados.

Database

As opções mostradas aqui dependem dos drivers de provedores existentes e instalados na máquina. Selecione o tipo de banco de dados que será usado

1. Clique OK.

   • O banco de dados é adicionado como uma nova linha na tabela.

2. Digite ou selecione as informações, na nova linha da tabela, conforme necessário, para concluir a configuração do banco de dados

Coluna

Descrição

Name

Digite um nome para a configuração do banco de dados. O sistema indicará se o nome não é válido, mostrando a célula com o contorno vermelho.

Provider

Selecione o provedor de banco de dados.

Database

As opções mostradas aqui dependem dos drivers de provedores existentes e instalados na máquina. Selecione o tipo de banco de dados que será usado

ConnectionString 

 Digite as informações necessárias para se conectar ao banco de dados.

LogonName

Digite um nome de login válido para o banco de dados.

LogonPassword

 Digite a senha que corresponde ao LogonName

Description

Digite uma descrição para o banco de dados.

[Outras colunas] 

 Para definições de outras colunas que estão disponíveis em muitas tabelas, consulte "Descrição de colunas comuns"

1. Se você estiver usando um novo banco de dados externo para o historiador de tags ou de alarmes, mude o nome dos bancos de dados existentes TagHistorian or AlarmHistorian para outros, e em seguida, mude o nome da nova configuração de banco de dados para TagHistorian ou AlarmHistorian.

   • Para os bancos de dados de historiador de tags ou de alarmes, a configuração dos nomes dos banco de dados nesta aba devem ser TagHistorian ou AlarmHistorian. Você não pode ter dois bancos de dados com o mesmo nome.

2. Continue adicionando tantos bancos de dados quantos que você precisa.

   • As bases de dados que você criar estarão disponíveis para uso na aba Tags> Historian, na confecção de telas e para os scripts.

   • Se necessário, clique com o botão direito em uma linha para cortar, copiar, colar ou excluir a linha.

Para acessar o Manager do Servidor de banco de dados

O botão DBAdmin é utilizado para ativar o aplicativo manager do servidor de banco de dados utilizado para o banco de dados externo. 

Accessando o Microsoft Excel

Para conectar-se à bancos de dados do Excel pode-se utilizar um driver ODBC, um DSN ODBC, ou OleDB. As seções a seguir apresentam detalhadamente os passos para configurar cada um destes métodos de conexão.

Criando as bases de dados ODBC

1. Selecione, e atribua um Nome para um intervalo de linhas e colunas na planilha. Isso permitirá que o software possa ler as informações como uma tabela.

2. Escolha um dos seguintes processos de nomeação para a sua versão do Microsoft Excel.

   • Para o Microsoft Office 2007:

     • Botão direito do mouse na área selecionada e escolha "Nome de um Range".

Image Removed

or others. If you have the expectation that these historians will need to store large amounts of data and require greater robustness and client/server characteristics, you should consider since initial deployment the use of an external database.

Image Added

When using the built-in database, Action.NET automatically creates the database file. When using external databases, the database file must be created by the utilities by using the chosen manager. However, the Action.NET can create the tables in the database, made available.
You can also use external databases as a data source in your application to display data as customer or product information, or to configure revenue systems.

The button SQL Query Builder enables the call to an application that is a tool for building SQL queries. See in this documentation the section Visual SQL Query Builder with details about the use of this application.

You must be logged in as an administrator Action.NET the database to set up the database login and password.

Image Added

To set up an external database:

1. Go to Edit> Datasets > Dbs.

2. Click Create New York, U..

   • The Create New Database Connection window is shown.

3. Enter or select the information as needed, a new row in the table will be inserted.

Image Added

• Click OK.

  • The database is added as a new row in the table.

• Enter or select the information in the new row of the table as needed to complete the configuration of the database

• If you are using a new external database for the tag or alarm historian, change the name of the existing TagHistorian or AlarmHistorian databases to others, and then change the name of the new database configuration to TagHistorian or AlarmHistorian.

• For tag historian or alarm databases, the configuration of the database names in this tab must be TagHistorian or AlarmHistorian. You cannot have two databases with the same name.

• Keep adding as many databases as you need.

  • The databases you create will be available for use in the Tags> Historian, in the making of screens and for the scripts.

  • If necessary, right-click a line to cut, copy, paste, or delete the line.

To access the Database Server Manager

The button DBAdmin is used to activate the database server manager application used for the external database. 

Historian and Alarms Connection String 

The connection string for the TagHistorian and AlarmHistorian has parameters that can be configured to avoid data loss. They are:

• Data Source: The server path and instance that will have the databases.

• Initial Catalog: The name of the database that will be used.

• Store and Forward: Enabling this option will cause the system to store the data locally if communication with the database is lost, and forwards the data to synchronize once the connection is back again.

• Keep the local copy: Enabling this option will make the system store a local database with the same data that has been stored in the main DB. The system will use the internal database to store it, and the file can be located on the same folder that the project is in. 

Image Added

Accessing Microsoft Excel

To connect to Excel databases you can use an ODBC driver, an ODBC DSN, or OleDB. The following sections detail the steps to configure each of these connection methods.

Creating ODBC databases

1. Select, and assign a Name to a range of rows and columns in the worksheet. This will allow the software to read the information as a table.

2. Choose one of the following naming processes for your version of Microsoft Excel.

   • For Microsoft Office 2007:

     • Right-click on the selected area and choose "Name of a Range".

Image Added

• For Microsoft Office 2003:

• In Microsoft Excel go to "Insert > Name > Define".

• 

• Nomeie a seleção (por exemploName the selection (for example, "itensTableTable items"). O arquivo Excel está agora pronto para o uso.

Métodos para se comunicar usando ODBC

• The Excel file is now ready for use.

Methods for communicating using ODBC

Using ODBC Microsoft Excel Driver:

1. In the workspace Datasets choose the "DBs"

1. tab and create a new Provider by clicking Create New

1. Select "Odbc Data Provider"

1. in the "Provider" field

1. In the "Database"

1. field choose "Microsoft Excel Database".

1. Click Ok.

Image Removed

Image Added

1. A new row will be created in the table, click the "ConnectionString" column.

Image Removed

Usando ODBC com um DSN:

1. A window appears: It enter the path and file name in the Extended Properties field.

2. Optionally click the "Test" button to make sure the connection is OK.

Image Added

Using ODBC with a DSN:

1. In MS-Windos go to "Control Panel" and select "Administrative Tools".

2. Double-click on "Data Sources (ODBC)".

Na janela "Administrador de Fonte de Dados ODBC":clique em Adicionar. Aparecerá outra janela solicitando para selecionar um

In the "ODBC Data Source Administrator" window:

1. Click Add. Another window will appear asking you to select a "driver",

1. Select the "Microsoft Excel Driver (*.xls)".

1. Click Finish.

2. Click Select Work Folder and select the name of the previously created Excel file.

3. Give the data source a name. example:. "excelDatasource".

1.  If you want to make write accesses, uncheck the "ReadOnly" option

No espaço de trabalho Datasets escolha a aba DBs e crie um novo Provider clicando o botão

1. In the workspace Datasets choose the DBs tab and create a new Provider by clicking the Create New.

Na lista de opções

1. In the list of options "Odbc Data Provider"

escolha

1. choose "ODBC using DSN"

e clique

• Continue adicionando tantas configurações de tabelas quantas você precisar.

Ler e escrever o conteúdo da tabela

O acesso, em tempo de execução, para o conteúdo da tabela é executado automaticamente quando a tabela é mapeada para um Objeto DataGrid, colocado em uma tela ou Relatório. Consulte "Configurando uma Janela DataGrid" .
Você também pode obter o conteúdo da tabela ou executar operações em tabelas, usando as propriedades de tempo de execução do objeto Dataset.Table, consulte

1. and click Ok.

1. Clique a coluna ConnectionString da nova linha criada na tabela de conexões e entre com DSN no campo DSN.

Image Removed

Utilizando OLEDB

1. No espaço de trabalho Datasets escolha a aba "DBs".

2. Selecione "OleDb data provider" e crie uma nova Conexão clicando em Create New

3. Selecione "Microsoft Excel Database" e então clique Ok.

4. Clique na coluna ConnectionString da nova linha criada, e entre com o caminho e o nome do arquivo Excel (.xls) no campo "DataSource"

Image Removed

Configurando acesso à Tabelas de BDs

Se você estiver usando um banco de dados externo como uma fonte de dados em sua aplicação, você pode especificar diretamente qual a tabela que vai utilizar a partir deste banco de dados.

Para configurar as tabelas de banco de dados:

1. Vá para Edit> Datasets >Tables.

2. Digite ou selecione as informações, conforme necessário.

Coluna

Descrição

Name

Digite um nome para a configuração da Tabela. O sistema permite que você saiba se o nome não é válido.

DB

Selecione a configuração de banco de dados

TableName

Selecione o nome da tabela.

WhereCondition

Especifique os parâmetros para filtrar os dados usando a sintaxe SQL.

Access

Selecione as permissões de acesso para a tabela.

Mapping

Clique ... para selecionar os Tags que você deseja preencher com os dados da primeira linha da tabela com dados de colunas específicas

Description

Digite uma descrição para a configuração da tabela.

[Outras colunas] 

 Para definições de outras colunas que estão disponíveis em muitas tabelas, consulte "Descrição de colunas comuns" 

1. Click the ConnectionString column of the new row created in the connection table and enter with DSN in the DSN field.

Image Added

Using OLEDB

1. In the workspace Datasets choose the "DBs" tab.

2. Select "OleDb data provider" and create a new Connection by clicking Create New

3. Select "Microsoft Excel Database" and then click Ok.

4. Click the ConnectionString column of the new row created, and enter the path and name of the Excel (.xls) file in the "DataSource" field

Image Added

Configuring data base Tables

If you are using an external database as a data source in your application, you can directly specify which table you will use from this database.

To configure database tables:

1. Go to Edit> Datasets >Tables.

2. Enter or select the information as needed.

Column	Description
Name	Enter a name for the Table configuration. The system lets you know if the name is not valid.
DB	Select the database configuration
TableName	Select the name of the table.
WhereCondition	Specify the parameters for filtering the data using SQL syntax.
Access	Select the access permissions for the table.
Mapping	Click... to select the Tags you want to populate with the data from the first row of the table with specific column data
MappingDateTime	Select the time reference: UTC or Local.
Description	Enter a description for the table configuration.
[Other columns]	For definitions of other columns that are available in many tables, see "Description of common columns"

• Keep adding as many table settings as you need.

Read and write table contents

Runtime access to table content switches automatically when the table is mapped to a DataGrid Object, placed on a screen, or Report. See "Setting up a DataGrid Window" .
You can also get the contents of the table or perform operations on tables, using the runtime properties of the Dataset.Table object, see +http://+ www.spinengenharia.com.br/help/an-2016/runtime/index.html .

Configurando consultas de banco de dados

Você pode configurar consultas para executar funções mais avançadas com instruções SQL para trabalhar com dados de bancos de dados externos.

Para configurar consultas à banco de dados:

Vá para

Configuring database queries

You can configure queries to perform more advanced functions with SQL statements to work with data from external databases.

To set up database queries:

• Continue adicionando tantas configurações de arquivos quantas você precisar.

Objetos Runtime Datasets

O namespace Dataset é o ponto de entrada para todos os objetos relacionados com o módulo Datasets.
O objeto Dataset.DB. contém a lista de todos os bancos de dados e conexões configuradas e suas propriedades em tempo de execução.
O objeto Dataset.Table lista todas as tabelas configuradas e suas propriedades em tempo de execução.
O objeto Dataset.Query lista todas as consultas definidas e suas propriedades em tempo de execução.
O objeto Dataset.File lista os arquivos de troca de dados definidos e suas propriedades em tempo de execução.
Veja em

1. Go to Edit > Datasets > Queries.

2. Digite ou selecione as informações, conforme necessário.

Coluna

Descrição

Name

Digite um nome para a consulta. O sistema permite que você saiba se o nome não é válido.

DB

Selecione a configuração de banco de dados. da tabela DBs

SqlStatement

Digite a consulta usando a sintaxe SQL.

Mapping

Clique para selecionar os Tags que você deseja preencher com os dados da consulta com os dados de colunas específicas.

Description

Digite uma descrição para a configuração da tabela.

[Outras colunas]

Para definições de outras colunas que estão disponíveis em muitas tabelas, consulte "Descrição de colunas comuns"

• Continue adicionando tantas consultas quanto você precisa.

Obtendo o conteúdo da consulta

O acesso, em tempo de execução, ao conteúdo da tabela é executado automaticamente quando a consulta é mapeada para um Objeto DataGrid, colocado em uma Tela ou Relatório. Consulte "Configurando uma Janela DataGrid".
Você também pode obter o conteúdo da consulta ou executar operações de consulta à tabelas, usando as propriedades de tempo de execução do objeto Dataset.Table, consulte +http://+ www.spinengenharia.com.br/help/an-2016/runtime/index.html.

Configurando Arquivos para troca de dados

Você pode configurar arquivos para recuperar dados de um local qualquer de uma rede. acessível

Para configurar os arquivos de banco de dados:

1. Vá para Edit> Datasets > Files.

2. Digite ou selecione as informações, conforme necessário.

Coluna

Descrição

Name

Digite um nome para o arquivo de configuração. O sistema permite que você saiba se o nome não é válido.

FileName

Digite o caminho completo para o arquivo.

FileType

Selecione o tipo de arquivo.

XmlSchemaType

Se o arquivo tem o formato XML, indique se sua definição é para TagList ou para TagObject.

Objects

Clique para selecionar os Tags que você deseja preencher com dados do arquivo com dados de colunas específicas.

Description

Digite uma descrição para o arquivo de configuração..

[Outras colunas]

Para definições de outras colunas que estão disponíveis em muitas tabelas, consulte "Descrição de colunas comuns"

1. Enter or select the information as needed.

Column	Description
Name	Enter a name for the query. The system lets you know if the name is not valid.
DB	Select the database configuration. from the DBs table
SqlStatement	Type the query using SQL syntax.
Mapping	Click to select the Tags that you want to populate with the query data with the specific column data.
MappingDateTime	Select the time reference: UTC or Local.
Description	Enter a description for the table configuration.
[Other columns]	For definitions of other columns that are available in many tables, see "Description of common columns"

• Keep adding as many queries as you need.

Getting the contents of the query

Runtime access to table content runs automatically when the query is mapped to a DataGrid Object, placed on a screen, or report. See "Setting up a DataGrid Window".
You can also get the contents of the query or perform query operations on tables, using the runtime properties of the Dataset.Table object.

Configuring Files for Data Exchange

You can configure files to retrieve data from any location on a network. accessible

To set up database files:

1. Go to Edit> Datasets > Files, files.

2. Enter or select the information as needed.

Column	Description
Name	Enter a name for the configuration file. The system lets you know if the name is not valid.
Filename	Enter the full path to the file.
FileType	Select the file type.
XmlSchemaType	If the file has the XML format, indicate whether its definition is for TagList or TagObject.
Objects	Click to select the Tags that you want to populate with file data with specific column data.
Description	Enter a description for the configuration file..
[Other columns]	For definitions of other columns that are available in many tables, see "Description of common columns"

• Keep adding as many file settings as you need.

The Datasets Namespace

The namespace Dataset is the entry point for all objects related to the Datasets module.
The object Dataset.DB. contains the list of all databases and configured connections and their properties at run time.
The object Dataset.Table lists all configured tables and their properties at run time.
The object Dataset.Query lists all defined queries and their properties at run time.
The object Dataset.File lists the data exchange files defined and their properties at run time.
See in {+}http://www.spinengenharia.com.br/help/an-2016/runtime/index.html+ .para a referência de programação completa em objetos de tempo de execução.

for the full programming reference on runtime objects.