Objetos do Projeto em Tempo de Execução

Runtime Project Objects

Or Action.NET has a structure supported by Object-Oriented programming, as already explained in the item "Object Model and Namespaces" . The documentation. NET for namespaces, following the MSDN layout, is accessible in http://www.spinengenharia.com.br/help/an-2016/runtime/index.html .

Classes do Microsoft .NET Framework

O The Action.NET tem acesso a todos os recursos do has access to all the features of the Microsoft dotNET Framework, como uma aplicação de código gerenciado puro. Para obter informações sobre cas classes C # e VB.NET refira-se a such as a pure managed code application. For information about cas classes C# and VB.NET refer to Microsoft MSDN. Framework 4 documentação on-line Net em Net online documentation at http:// msdn.microsoft.com/en-us/library/gg145045 (v=vs.100).aspx .

Script Toolkit

Ao criar código de scripts dentro do When creating script code within the Action.NET, pode-se utilizar um conjunto de métodos utilitários públicos, a que chamamos Script Toolkit. Esses métodos estão disponíveis no TK namespace a partir de qualquer código dentro do projeto. Os métodos disponíveis são definidos em you can use a set of public utility methods, which we call script toolkit. These methods are available in the TK namespace from any code within the project. The available methods are defined in http://www.spinengenharia.com.br/help/an-2016/runtime/index.html

Teclados personalizados em Telas

Ao usar painéis touchscreen, você pode personalizar um teclado já fornecido no Action.NET sobre tela. Ou pode fazer uma tela-Teclado própria.. Contate-nos para exemplos de código fonte sobre a implementação de teclados personalizados.

Toolkit de controles WPF

Você pode adicionar qualquer controle WPF diretamente em telas do Action.NET sem necessidade de quaisquer ferramentas adicionais. Mas, se você quer ter um diálogo de configuração personalizada, acessando os Tags na aplicação, você pode usar as interfaces do WK (Toolkit de controles WPF). Contate-nos para obter exemplos sobre a criação de controles WPF, ou se você precisar de ajuda para encapsular controles Active-X ou dot NET para usá-los dentro de telas Action.NET.

API de acesso a dados COM

Custom Keyboards on Screens

By using touchscreen panels, you can customize a keyboard already provided on Action.NET on screen. Or you can make a screen-keyboard of your own.. Contact us for source code examples about implementing custom keyboards.

WPF control toolkit

You can add any WPF control directly to Action.NET without the need for any additional tools. But if you want to have a custom configuration dialog by accessing the Tags in the application, you can use the WPF Controls Toolkit (WK) interfaces. Contact us for examples about creating WPF controls, or if you need help encapsulating Active-X or DOT NET controls to use them within Action.NET.

COM data access API

If you need to access the database in real time from external applications, using any programming language or even JavaScript code in web browsers, you can use the COM data access API, described in http:// www.spinengenharia.com.br/help/an-2016/runtime/index.html.

Driver Import Wizard and Toolkit

Action.NET tem extensões para permitir que você crie seus próprios "drivers" de comunicação com dispositivos (protocolos de comunicação), usando o Toolkit de drivers, bem como Ferramentas de importação personalizadas e componentes "add-in". Contate SPIN se você precisar de informações sobre essas extensões adicionaishas extensions to allow you to create your own communication drivers with devices (communication protocols) using the Driver Toolkit, as well as custom import tools and add-in components. Contact SPIN if you need information about these additional extensions.

Namespace Tag

Todas as variáveis em tempo real do projeto, ou Tags de Projeto, como são normalmente chamadas em sistemas SCADA, estão disponíveis neste Namespace. Os tags são criados na All real-time project variables, or Project Tags, as they are commonly called on SCADA systems, are available in this Namespace. Tags are created in the interface Edit >Tags> Objects. Para cada tag é definido um tipo para o seu valor. Os tipos disponíveis são mostrados em "Tipos de Tags pré-definidos" na página 94.
A sintaxe tag.<TagName> está disponível para todos os tipos de tag. Para saber o tipo de um tag em particular é possível acessar propriedades adicionais e métodos usando a sintaxeFor each tag a type is defined for its value. The available types are shown in "Predefined Tag Types" on page 94.
The syntax Tag. <TagName> is available for all tag types. To know the type of a particular tag you can access additional properties and methods using syntax:
Tag. <TagName>. <PropertyName>. O elemento TagObj mostra propriedades e métodos disponíveis para todos os tipos de tag. Por outro lado, Analog mostra as propriedades comuns a todos tags Analógicos (refere-se ao tipo de tag para propriedades específicas). São permitidos os tipos criados pelo usuário (templates) em combinação com os tipos nativos pré-definidos.

ClassTagObj

Classe de base para todos os objetos tag.

ForceValue

Força a propriedade de valor do objeto ser alterada para o valor dado como parâmetro. ExemploThe element TagObj shows properties and methods available for all tag types. On the other hand, Analog shows the properties common to all Analog tags (refers to the tag type for specific properties). User-created types (templates) are allowed in combination with predefined native types.

ClassTagObj

Base class for all tag objects.

ForceValue

Forces the value property of the object to be changed to the value given as a parameter. Example:
@Tag.AnalogInt1.ForceValue(10)(VB) @Tag.AnalogInt1.ForceValue(10);(C#)

Tostring

Retorna uma string que representa o objeto atual. ExemploReturns a string that represents the current object. Example:
Dimsas string(VB) @Tag.AnalogInt1= 33
s=@Tag.AnalogInt1.Tostring();
strings;(C#) @Tag.AnalogInt1= 33;
s=@Tag.AnalogInt1.Tostring();
Neste exemploIn this example, s será avaliado como will be evaluated as "33".

Alarm Disable

Retorna ou altera o estado de alarme desabilitado do Tag. Se Returns or changes the disabled alarm state of the tag. If 0 (zero), a propriedade AlarmDisable não fica ativa. No caso de valores diferentes de the AlarmDisable property is not active. In the case of values other than 0 (zero), a propriedadethe
AlarmDisable fica ativa. Quando a propriedade AlarmDisable não está ativa, todos os alarmes associados ao Tag atual não são tratados. Exemplobecomes active. When the AlarmDisable property is not active, all alarms associated with the current tag are not handled. Example:

Neste exemplo, os alarmes associados ao objeto AnalogInt1 não serão tratadosIn this example, the alarms associated with the AnalogInt1 object will not be handled.

Alarm State

Retorna ou alterao estado de alarme do Tag. Se Returns or changes the alarm state of the tag. If 0 (zero): fora de estado de alarme. No caso de valores diferentes de Out of alarm state. In the case of values other than 0 (zero): em estado de alarme. Exemploin alarm state. Example:
Dim alarmStateas Integer(VB) alarmState= @Tag.AnalogInt1.AlarmState intalarmState;(C#)
alarmState=@Tag.AnalogInt1.AlarmState;

GetName

Fornece o nome do Tag. É ideal para definir o "target" de um tag de referência.ExemploProvides the name of the tag. It is ideal for setting the "target" of a reference tag. Example:
@Tag.ReferenceTagName.Link=@Tag.TagName.GetName()(VB) @Tag.ReferenceTagName.Link= @Tag.TagName.GetName();(C#)

Changed

Retorna ou altera o estado de "houve alteração" do valor do Tag. True: valor foi alterado. False: valor não foi alterado.

Domain

Retorna ou altera a propriedade de Domínio do Tag. Se Returns or changes the state of "there has been a change" in the tag value. True: Value has changed. False: Value has not changed.

Domain

Returns or changes the Domain property of the Tag. If 0 (zero): servidorserver. Se If 1: clientecustomer.

Units

Retorna ou altera as unidades de engenharia usadas para quantificar o Tag, como definido na sua criação.

Format

Retorna ou altera o formato do valor do Tag para fins de exibição.

Historian

Fornece o objeto HistoryItem onde o Tag atual está configurado como TagName. Se são permitidos tags duplicados nas tabelas de Historiadores, então o Historiador apontará para o último objeto HistoryItem onde o Tag atual está configurado como TagName. ExemploReturns or changes the engineering units used to quantify the tag, as defined in its creation.

Format

Returns or changes the format of the tag value for display purposes.

Historian

Provides the HistoryItem object where the current tag is configured as tagname. If duplicate tags are allowed in historian tables, then the Historian will point to the last HistoryItem object where the current tag is configured as TagName. Example:
@Tag.AnalogInt.Historian.Deadband=5(VB) @Tag.AnalogInt.Historian.Deadband= 5;(C#)

Locked

Retorna ou altera a condição de Returns or changes the "locked" do Tag. Quando um Tag está "locked", o valor usado para o processamento origina-se da propriedade LockValue e não da propriedade Value.
Se condition of the tag. When a tag is locked, the value used for processing originates from the LockValue and not the property Value.
If 0 (zero): desbloqueado. No caso de valores diferentes de unlocked. In the case of values other than 0 (zero): bloqueadolocked. ExemploExample:
@Tag.AnalogDouble1.Locked=1(VB) @Tag.AnalogDouble1.Locked= 1;(C#)

Quality

Retorna ou altera o estado de qualidade do Tag.
Para a qualidade são utilizados os códigos definidos pelo padrão OPC-DA. Os dois códigos de qualidade OPC mais comuns são:

Returns or changes the quality state of the tag.
For quality, the codes defined by the OPC-DA standard are used. The two most common OPC quality codes are:

• 192 or Hex C0 is of good quality.

• 0 (decimal ou or hexadecimal) é de má qualidade.

• is of poor quality.

Several qualities in the OPC protocol standards are shown in the following table:

Para mais informações, consulte as especificações do OPC. (Nota: nem todos os servidores suportarão todos esses códigos). ExemploFor more information, see the OPC specifications. (Note: Not all servers will support all of these codes.) Example:

Retentive

Retorna ou altera a propriedade Retentiva do Tag. Esta propriedade especifica se o Valor do Tag deve ser salva quando a aplicação for encerrada. O valor salvo é então usado como o valor de inicialização na execução da próxima aplicação. Se Returns or changes the Retentive property of the tag. This property specifies whether the Tag Value should be saved when the application is terminated. The saved value is then used as the startup value when running the next application. If 0 (zero): não retentivo. No caso de valores diferentes de non-retentive. In the case of values other than 0 (zero): retentivoretentive. ExemploExample:
@Tag.AnalogInt1.Retentive=1(VB) @Tag.AnalogInt1.Retentive= 1;(C#)

TimeStamp

Timestamp

Returns or changes the Timestamp property of the tag, i.e. the date and time when the last change in the value or quality of the tag occurred. Example:
Dim dtAsDateTimeOffset(VB) dt = @Tag.AnalogInt1.Timestamp
DateTimeOffsetdt;(C#)
dt=@Tag.AnalogInt1.Timestamp;

ValueType

Retorna a propriedade ValueType do Tag. Para cada tipo de tag é definido um numero int que representa este tipo. Os numeros acima de 100 são reservados para os Returns the ValueType property of the tag. For each tag type, an int number is defined that represents this type. Numbers above 100 are reserved for UserTypes (templates). ExemploExample:
Dim doubleTypeAs Integer(VB) doubleType= @Tag.AnalogInt1.ValueType
intdoubleType;(C#)
doubleType=@Tag.AnalogInt1.ValueType;

Visibility

Retorna ou altera o estado de visibilidade do Tag. Se Returns or changes the visibility state of the tag. If 0 (zero): privadoprivate, 1: protegido e protected, and 2: público. Para o significado destes valores veja em "Criando e Editando Tags" na página 91. Exemplopublic. For the meaning of these values see in "Creating and Editing Tags" on page 91. Example:
Dim visibilityStateas Integer(VB) visibilityState= @Tag.AnalogInt1.Visibility
intvisibilityState;(C#)
visibilityState=@Tag.AnalogInt1.Visibility;

Class Digital

Propriedades do Runtime para Classe properties for Digital Class. Valores possíveisPossible values: 0 = false e and 1 = true. Tipos equivalentes no Equivalent types in the script:
•C#: int32
•VB: int
•.NET: int

Toogle

Alterna a propriedade de valor do Tag entre Toggles the tag value property between 0 (zero) e and 1. Se o valor atual é If the current value is 0 (zero), então o novo valor é 1. Se o valor atual é 1, então o novo valor é then the new value is 1. If the current value is 1, then the new value is 0 (zero). ExemploExample:
DimnewValueasByte(VB)
newValue=@Tag.Digital1.ToggleValue()
bytenewValue;(C#)
newValue=@Tag.Digital1.ToggleValue();

LockValue

Retorna ou altera a propriedade LockedValue do Tag. Quando um Tag está bloqueado, o valor usado para o processamento origina-se da propriedade LockValue e não da propriedade Valor. É um int32 ExemploReturns or changes the LockedValue property of the tag. When a tag is locked, the value used for processing originates from the LockValue property and not from the Value property. It's an int32 example:
@Tag.Digital1.LockValue=1(VB) @Tag.Digital1.LockValue= 1;(C#)

State

Fornece a propriedade de Estado do Tag digital. Valor = 0 corresponde ao estado Provides the state property of the digital tag. Value = 0 corresponds to state = False (VB) ou estado or state = false (C#). Valor Value = 1 corresponde ao estado corresponds to state = True (VB) ou estadoor state= true (C#).

Value

Retorna ou altera a propriedade de Valor do Tag digital. Valores válidosReturns or changes the Digital Tag Value property. Valid values: 0 (zero) ou or 1. ExemploExample:
@Tag.Digital1.Value=1(VB) @Tag.Digital1.Value= 1;(C#).

Class Analog

Propriedades do Runtime para properties for Analog Class.

Bit0, Bit1,... Bit31

Retorna ou altera o estado do bit de ordem 0,Returns or changes the state of the order bit 0.1,... 31 do valor de um um of the value of an AnalogInt.

Hi, HIHi, Lo LoLo

Retornam ou alteram o valor do limite atual Return or change the value of the current Hi, HiHI, LO,LO LO de um tag de tipo Analog, qualquerlimit of an Analog tag, any.

Anchor
Class_Analog<T> Class_Analog<T>

Anchor
_bookmark354 _bookmark354

Class Analog<T>

Propriedades de Runtime para Classe properties for Analog Class <T>. Estas Classes derivadas da Analog são defibnidas para cada um dos tipos de valor que podem ser utilizadosThese Analog-derived classes are defibnidas for each of the value types that can be used: AnalogInt, AnalogDecimal, AnalogDouble, AnalogLong.

Deadband

Retorna ou altera a banda morta do Tag analógico. ExemploReturns or changes the dead band of the analog tag. Example:
@Tag.AnalogDouble1.Deadband=5(VB) @Tag.AnalogDouble1.Deadband= 5;(C#)

LockValue

Retorna ou altera o valor de bloqueio do Tag analógico. ExemploReturns or changes the lock value of the analog tag. Example:
@Tag.AnalogDouble1.LockValue=50(VB) @Tag.AnalogDouble1.LockValue= 50;(C#)

Analog.Min

and Analog.Max

Retorna ou altera o valor mínimo ou máximo do Tag analógico. ExemploReturns or changes the minimum or maximum value of the analog tag. Example:
@Tag.AnalogDouble1.Min = 120(VB) @Tag.AnalogDouble2.Min = 120;(C#)
@Tag.AnalogDouble3.Max = 120(VB) @Tag.AnalogDouble4.Max = 120;(C#)

StartValue

Retorna ou altera o valor inicial do tag analógico, que pode ser definido em tempo de configuração no TManager. ExemploReturns or changes the initial value of the analog tag, which can be set at setup time in the TManager. Example:
@Tag.AnalogDouble1.StartValue=50(VB) @Tag.AnalogDouble1.StartValue= 50;(C#)

State

Retorna ou altera o estado do Tag analógico. Se o valor é igual a Returns or changes the state of the analog tag. If the value is equal to 0 (zero), o estado é FALSE. Se o valor é diferente de the state is FALSE. If the value is different from 0 (zero), o estado é the state is TRUE. ExemploExample:
Dim state as Boolean(VB) state = @Tag.AnalogInt1.State bool state;(C#)
state=@Tag.AnalogInt1.State; @Tag.AnalogInt1.Value=55(VB)ou or @Tag.AnalogInt1=55 @Tag.AnalogInt1.Value=55;(C#) ou or @Tag.AnalogInt1=55;

Anchor
Class_AnalogInt Class_AnalogInt

Anchor
_bookmark355 _bookmark355

Class AnalogInt

Propriedades do Runtime para properties for AnalogInt Class.

Anchor
Class_AnalogDecimal Class_AnalogDecimal

Anchor
_bookmark356 _bookmark356

Class AnalogDecimal

Propriedades do Runtime para Classe Decimal AnalógicaRuntime properties for Analog Decimal Class.

Anchor
Class_AnalogDouble Class_AnalogDouble

Anchor
_bookmark357 _bookmark357

Class AnalogDouble

Propriedades do Runtime para Classe properties for AnalogDouble Class.

Anchor
Class_Text Class_Text

Anchor
_bookmark358 _bookmark358

Class Text

Propriedades do runtime para classe textoRuntime properties for text class.

LockValue

Retorna ou altera o valor de bloqueio do tag de texto. ExemploReturns or changes the lock value of the text tag. Example:
@Tag.Text1.LockValue="Text to display "(VB) @Tag.Text1.LockValue="Text to display";(C#)

Value

Retorna ou altera o valor do tag de texto. ExemploReturns or changes the value of the text tag. Example:
@Tag.Text1.Value ="This text"(VB)ou or @Tag.Text1="This text" @Tag.Text1.Value ="This text";(C#) ou or @Tag.Text1="This text";

Anchor
Class_TDataTime Class_TDataTime

Anchor
_bookmark359 _bookmark359

Class TDataTime

Propriedades do Runtime para ClasseTDataTimeRuntime properties for ClassTDataTime.

LockValue

Retorna ou altera o valor de bloqueio do Tag de TDataTime. ExemploReturns or changes the lock value of the TDataTime tag. Example:
@tag.dataTime1.LockValue = DateTime.Now;

Value

Retorna ou altera o valor do Tag de TDataTime. ExemploReturns or changes the value of the TDataTime tag. Example:
@tag.dataTime1.Value = DateTime.Now;

Anchor
Class_Counter Class_Counter

Anchor
_bookmark360 _bookmark360

Class Counter

Define propriedades do Runtime para Classe CounterSets Runtime properties for Counter Class.

Event

Fornece o evento do Provides the Tag Counter event. Valores possíveisPossible values: "Change", "ChangeUp" e and "ChangeDown". ExemploExample:
Dim counter1Event asstring(VB) counter1Event=@Tag.Counter1.Event stringcounter1Event;(C#) counter1Event= @Tag.Counter1.Event;

Model

Fornece o modelo do Provides the Tag Counter template. Valores possíveisPossible values: "Up" e and "Down". ExemploExample:
Dim counter1Model asstring(VB) counter1Model=@Tag.Counter1.Model stringcounter1Model;(C#) counter1Model= @Tag.Counter1.Model;

Trigger

Retorna ou altera o disparo do Tag Counter. ExemploReturns or changes the tag counter trigger. Example:

Anchor
Class_Timer Class_Timer

Anchor
_bookmark361 _bookmark361

Class Timer

Propriedades do Runtime para Classe properties for Timer Class.

Interval

Retorna ou altera o intervalo do Returns or changes the range of the Tag Timer. Trata-se de uma string que representa o intervalo de tempo exibido no formato This is a string that represents the time interval displayed in the format "hh:mm:ss.mmm". ExemploExample:
@Tag.Timer1.Interval="0:0:10"(VB) @Tag.Timer1.Interval= "0:0:10";(C#)

Model

Fornece o modelo do Provides the Tag Timer template. Valores possíveisPossible values: "SquareWave", "Pulse" e and "Comparer". ExemploExample:
Dim timerModelas string(VB) timerModel=@Tag.Timer1.Model stringtimerModel;(C#) timerModel= @Tag.Timer1.Model;

Anchor
Class_Reference Class_Reference

Anchor
_bookmark362 _bookmark362

Class Reference

Propriedades de Runtime para a Classe ReferenceRuntime properties for the Reference Class.

Link

Retorna ou altera o link do Returns or changes the Tag Reference link. ExemploExample:
@Tag.Reference1.Link=@Tag.TagName.GetName()(VB) @Tag.Reference1.Link= @Tag.TagName.GetName();(C#)

Class TDataTable

Propriedades do Runtime para Classe properties for TDataTable Class.

Initialize

Define uma nova referência ao objeto Tabela. Este método é usado somente internamenteSets a new reference to the Table object. This method is used only internally.

Table

Fornece uma cópia do objeto DataTable. ExemploProvides a copy of the DataTable object. Example:
DimdtasNewTDataTable(parent,id)(VB)
Dim table As DataTable table =dt. Table
TDataTable dt=newTDataTable(parent, id);(C#) DataTabletable;
table=dt. Table;

OverwriteOnUpdate

Retorna ou altera o operando OverwriteOnUpdate. Esta propriedade é usada somente internamenteReturns or changes the OverwriteOnUpdate operand. This property is used only internally.

Update

Atualiza o objeto Tabela. Este método é usado somente internamente. ParâmetrosUpdates the Table object. This method is used only internally. Parameters: DataTable table

UserType Class

Propriedades do Runtime para Classe properties for UserType class.