O cadastro de Tipos de Comandos deve ser realizado na aba Comandos do objeto Configuração do Power. Alguns exemplos de Tipos de Comandos são a posição de um disjuntor, a posição de tap de um transformador e a troca no modo de operação de uma proteção.
Assim como na padronização de Estados ou Significados das Medidas Discretas, cada Tipo de Comando pode ter uma ou várias Ações de Comando. Os Tipos de Comandos podem ser configurados em tempo de execução no objeto retornado pela propriedade CommandTypes de um objeto Configuração do Power. A figura a seguir mostra a aba de configuração de padrões de Comandos.
Aba Comandos
A aba de configuração de padrões de Comandos está dividida em quatro áreas distintas. A primeira, apresentada na figura a seguir, serve para criar ou editar os Tipos de Comandos existentes em uma aplicação.
Área de configuração dos tipos de Comandos
A barra de ferramentas desta área contém as opções Adicionar 
, para criação de um novo tipo de Comando e permite adicionar tanto Comandos Discretos quanto Comandos de Passo, Excluir 
, para excluir um tipo de Comando criado pelo usuário, e Ordenar 
, que ordena a visualização da lista de tipos de Comandos.
A segunda área, chamada de Conversões, serve para o usuário cadastrar os diferentes valores de escrita que cada Ação de Comando pode ter. Por exemplo, o comando de Abrir um Disjuntor pode ter que escrever o valor "129" (TRIP-Pulse On), se executado via protocolo DNP3, ou escrever o valor "0" (Single Command), se esta ação é via protocolo IEC 870-5-104. A figura a seguir apresenta a área de criação ou edição de Conversões.
Área de criação ou edição de Conversões de Comandos
Ações relacionadas às Conversões
Ação |
Descrição |
|---|---|
Nova |
Adiciona uma nova Conversão ao tipo de Comando selecionado na área superior da aba |
Renomear |
Renomeia a Conversão selecionada na caixa de seleção. Só é permitido renomear Conversões criadas por usuários |
Excluir |
Exclui a Conversão selecionada na caixa de seleção. Só é permitido excluir Conversões criadas por usuários |
A terceira área, apresentada na figura a seguir, permite que o usuário crie novas Ações de Comando, que determinam características de um Comando que são utilizadas nas Unidades de Comando. Também é permitido nesta área que o usuário altere os valores que podem variar em relação à Conversão selecionada.
Área de criação ou configuração das Ações de Comando
A barra de ferramentas desta área tem as opções Adiciona semântica , para criação de uma nova Ação de Comando, e Excluir semântica , para excluir uma Ação de Comando criada pelo usuário. Ambas ferramentas só são acessíveis em Tipos de Comandos criados pelo usuário, sem o prefixo "*" no nome. Os campos disponíveis para edição na terceira área são apresentados na tabela a seguir.
Campos de edição de Ações de Comando
Campo |
Descrição |
|---|---|
Select automático antes de Operate |
Se Verdadeiro, toda vez que um objeto de Comando recebe uma chamada do método Operate, primeiro é executado o script cadastrado no evento OnSelect, e depois é executado o script cadastrado no evento OnOperate. Esta opção corresponde à propriedade AutoSelect de um objeto Conversão |
Tempo limite de feedback (ms) |
Tempo, em milissegundos, que a rotina de verificação de execução de um Comando espera para constatar se o Comando foi realizado com sucesso ou não. Este tempo deve ser dimensionado conforme a qualidade do link de comunicação e o atraso de transporte. Este valor é opcional e deve ser utilizado apenas se o usuário necessita tratar erros de execução de Comandos. Para verificar o valor de retorno, use as propriedades OperateFeedbackTag, CancelFeedbackTag ou SelectFeedbackTag, configuradas no objeto Comando. Esta opção corresponde à propriedade FeedbackTimeout de um objeto Conversão |
Máximo de retentativas |
Indica o número de retentativas de execução de um Comando, além da tentativa inicial. A retentativa ocorre enquanto o limite estabelecido nesta propriedade não é atingido e a Ação de Comando não foi terminada com sucesso, cancelada ou abortada. Esta opção corresponde à propriedade MaxRetries de um objeto Conversão |
Tempo entre retentativas (ms) |
Indica o tempo, em milissegundos, entre as retentativas de execução de um Comando. Se este valor é igual a 0 (zero), a retentativa é executada o mais rápido possível. Esta opção corresponde à propriedade RetryPeriod de um objeto Conversão |
Nome |
Nome de uma Ação de Comando. Este valor só pode ser modificado em Ações criadas pelo usuário. Este nome é utilizado em um objeto Unidade de Comando para criar uma associação das configurações de Comando. Esta opção corresponde à propriedade Name de um objeto Significado |
Descrição |
Descrição de uma Ação de Comando. Este texto pode ser usado em botões para explicitar qual a Ação que este botão realiza, como por exemplo "Abrir" ou "Fechar". Esta opção corresponde à propriedade Caption de um objeto Significado |
Operate Value |
Valor que deve ser escrito na propriedade OperateWriteTag de um objeto de Comando quando o método Operate é chamado. Esta opção corresponde à propriedade OperateValue de um objeto Valores da Conversão |
Operate Feedback |
Valor que a propriedade OperateFeedbackTag configurada em um objeto de Comando deve apresentar após a execução do método Operate. Este valor é opcional e deve ser utilizado apenas se o usuário necessita tratar erros de execução de Comandos. Esta opção corresponde à propriedade OperateFeedbackValue de um objeto Valores da Conversão |
Select Value |
Valor que deve ser escrito na propriedade SelectWriteTag de um objeto de Comando quando o método Select é chamado. Esta propriedade só deve ser configurada quando o Comando é do tipo Select ou Operate. Esta opção corresponde à propriedade SelectValue de um objeto Valores da Conversão |
Select Feedback |
Valor que a propriedade SelectFeedbackTag configurada em um objeto de Comando deve apresentar após a execução do método Select. Este valor é opcional e deve ser utilizado apenas se o usuário necessita tratar erros de execução de Comandos. Esta opção corresponde à propriedade SelectFeedbackValue de um objeto Valores da Conversão |
Cancel Value |
Valor que deve ser escrito na propriedade CancelWriteTag de um objeto de Comando quando o método Cancel é chamado. Esta propriedade só deve ser configurada quando o Comando é do tipo Select ou Operate. Esta opção corresponde à propriedade CancelValue de um objeto Valores da Conversão |
Cancel Feedback |
Valor que a propriedade CancelFeedbackTag configurada em um objeto de Comando deve apresentar após a execução do método Cancel. Este valor é opcional e deve ser utilizado apenas se o usuário necessita tratar erros de execução de Comandos. Esta opção corresponde à propriedade CancelFeedbackValue de um objeto Valores da Conversão |
A quarta e última área, apresentada na figura a seguir, permite que o usuário defina os scripts que são realizados quando os métodos Operate, Select e Cancel são chamados em objetos de Comando.
Área de definição dos scripts de Comando
A descrição das ferramentas da área de criação de scripts de Comando está na tabela a seguir.
Barra de ferramentas para scripts de Comando
Comando |
Descrição |
|---|---|
Adiciona script |
Adiciona um script ao evento selecionado na caixa de seleção |
Exclui script |
Exclui o script do evento selecionado na caixa de seleção |
Abre AppBrowser |
Abre o AppBrowser |
Procura nesse script |
Procura por palavras no script |
Procura anterior |
Procura a ocorrência anterior de uma palavra |
Procura próxima |
Procura a próxima ocorrência de uma palavra |
Substitui nesse script |
Substitui ocorrências de uma palavra |
Verifica scripts do evento corrente |
Verifica os scripts do evento corrente |
Verifica todos scripts da Conversão corrente |
Verifica todos os scripts da Conversão corrente |
Verifica todos scripts do Comando corrente |
Verifica todos os scripts do Comando corrente |
A caixa de seleção permite que o usuário escolha o evento a ser editado. A tabela a seguir contém a descrição dos eventos disponíveis para edição.
Eventos disponíveis nos Comandos
Evento |
Descrição |
|---|---|
OnOperate |
Define o que é executado quando o método Operate disponível na instância de um objeto de Comando é chamado. A tarefa mais básica realizada neste evento é a escrita do valor OperateValue, configurado na área de Ações de Comandos, na propriedade OperateWriteTag, configurada no objeto de Comando |
OnSelect |
Define o que é executado quando o método Select, disponível na instância de um objeto de Comando, é chamado. A tarefa mais básica realizada neste evento é a escrita do valor SelectValue, configurado na área de Ações de Comandos, na propriedade SelectWriteTag, configurada no objeto de Comando |
OnCancel |
Define o que é executado quando o método Cancel, disponível na instância de um objeto de Comando, é chamado. A tarefa mais básica realizada neste evento é a escrita do valor CancelValue, configurado na área de Ações de Comandos, na propriedade CancelWriteTag, configurada no objeto de Comando |
OnOperateFinished |
Evento acionado quando a propriedade OperateFeedbackTag, configurada em um objeto de Comando, apresentar o valor igual ao campo Operate Feedback, configurado na área de Ações de Comandos. Este evento também ocorre no término do tempo limite de feedback, em um pedido de cancelamento de um Comando ou em uma falha na execução do método Operate. Este evento pode ser utilizado para gerar logs e mensagens de status de uma operação |
OnSelectFinished |
Evento acionado quando a propriedade SelectFeedbackTag, configurada em um objeto de Comando, apresentar o valor igual ao campo Select Feedback, configurado na área de Ações de Comandos. Este evento também ocorre no término do tempo limite de feedback, em um pedido de cancelamento de um Comando ou em uma falha na execução do método Select. Este evento pode ser utilizado para gerar logs e mensagens de status de uma operação |
OnCancelFinished |
Evento acionado quando a propriedade CancelFeedbackTag, configurada em um objeto de Comando, apresentar o valor igual ao campo Cancel Feedback, configurado na área de Ações de Comandos. Este evento também ocorre no término do tempo limite de feedback ou quando uma falha é detectada na execução do método Cancel. Este evento pode ser utilizado para gerar logs e mensagens de status de uma operação |
Cada evento possui um conjunto de parâmetros que permite que um script acesse tanto valores configurados na área de criação ou configuração das Ações de Comando quanto valores passados via chamada de métodos em tempo de execução. Estes parâmetros estão descritos na tabela a seguir.
Parâmetros disponíveis nos scripts de métodos e eventos dos Comandos
Parâmetro |
Descrição |
|---|---|
ActorID |
Disponibiliza para um script o nome do usuário que requisitou um Comando. Este valor deve ser passado como parâmetro na chamada dos métodos Operate, Select e Cancel dos objetos de Comando |
WriteValue |
Este parâmetro disponibiliza os valores configurados na área de criação de Ações de Comando para os eventos OnOperate, OnSelect e OnCancel: •No evento OnOperate, este parâmetro possui o valor do campo Operate Value •No evento OnSelect, este parâmetro possui o valor do campo Select Value •No evento OnCancel, este parâmetro possui o valor do campo Cancel Value |
FeedbackValue |
Este parâmetro disponibiliza os valores configurados na área de criação de Ações de Comando para os eventos OnOperate, OnSelect e OnCancel: •No evento OnOperate, este parâmetro possui o valor do campo Operate Feedback •No evento OnSelect, este parâmetro possui o valor do campo Select Feedback •No evento OnCancel, este parâmetro possui o valor do campo Cancel Feedback |
Failed |
Booleano utilizado para indicar a detecção de falhas nos scripts dos eventos. Este parâmetro pode ser preenchido nos eventos OnOperate, OnSelect e OnCancel, e pode ser tratado nos eventos OnOperateFinished, OnSelectFinished e OnCancelFinished |
Canceled |
Booleano disponível nos eventos OnOperateFinished e OnSelectFinished para indicar que a finalização de um Comando foi provocada por uma chamada do método Cancel |
FeedbackError |
Booleano disponível nos eventos OnOperateFinished, OnSelectFinished e OnCancelFinished para indicar que a finalização de um Comando foi provocada por time-out, ou seja, FeedbackError igual a Verdadeiro |
ScriptError |
Booleano disponível nos eventos OnOperateFinished, OnSelectFinished e OnCancelFinished para indicar que ocorreu um erro de script |
Para acessar valores da instância de um objeto de Comando nos scripts de eventos, utilize a expressão Application.GetObject, informando a propriedade que deseja acessar, conforme o exemplo a seguir.
Set Tag = Application.GetObject(OperateWriteTag)