O cadastro dos Tipos de Comandos deve ser realizado na aba Comandos do objeto Configuração do Power. Alguns exemplos de Tipos de Comandos são: posição de disjuntor, posição de tap de transformador e troca no modo de operação da proteção, entre outros.
Assim como na padronização dos Estados ou Significados das Medidas Discretas, cada Tipo de Comando pode ter uma ou várias Ações de Comando. Exemplos de requisições de ações são Subir posição de tap, Abrir chave e Habilitar função de religamento. Os Tipos de Comandos podem ser configurados em tempo de execução no objeto retornado pela propriedade CommandTypes do objeto Configuração do Power. A figura a seguir mostra a aba de configuração de padrões de Comandos.
Aba de configuração de padrões de 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 na 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 (permite adicionar tanto Comandos Discretos quanto Comandos de Passo), Remover 
, 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 |
Remover |
Remove a Conversão selecionada na caixa de seleção. Só é permitido remover 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 Adicionar , para criação de uma nova Ação de Comando, e Remover , 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 o objeto de Comando receber 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 do objeto Conversão |
Tempo limite de feedback (ms) |
Tempo, em milissegundos, que a rotina de verificação de execução do 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 do objeto Conversão |
Máximo de retentativas |
Indica o número de retentativas de execução do 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 do objeto Conversão |
Tempo entre retentativas (ms) |
Indica o tempo, em milissegundos, entre as retentativas de execução de um Comando. Se este valor for igual a 0 (zero), a retentativa é executada o mais rápido possível. Esta opção corresponde à propriedade RetryPeriod do objeto Conversão |
Nome |
Nome da Ação de Comando. Este valor só pode ser modificado em Ações criadas pelo usuário. Este nome é utilizado no objeto Unidade de Comando para criar uma associação das configurações de Comando. Esta opção corresponde à propriedade Name do objeto Significado |
Descrição |
Descrição da Ação de Comando. Este texto pode ser usado em botões para explicitar qual a Ação que este botão realiza. Por exemplo: "Abrir", "Fechar", "Habilitar", "Desabilitar", etc. Esta opção corresponde à propriedade Caption do objeto Significado |
Operate Value |
Valor que deve ser escrito na propriedade OperateWriteTag do objeto de Comando quando o método Operate é chamado. Esta opção corresponde à propriedade OperateValue do objeto Valores da Conversão |
Operate Feedback |
Valor que a propriedade OperateFeedbackTag configurada no 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 do objeto Valores da Conversão |
Select Value |
Valor que deve ser escrito na propriedade SelectWriteTag do 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 do objeto Valores da Conversão |
Select Feedback |
Valor que a propriedade SelectFeedbackTag configurada no 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 do objeto Valores da Conversão |
Cancel Value |
Valor que deve ser escrito na propriedade CancelWriteTag do 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 do objeto Valores da Conversão |
Cancel Feedback |
Valor que a propriedade CancelFeedbackTag configurada no 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 do 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 nos 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 |
|---|---|
Adicionar |
Adiciona um script ao evento selecionado na caixa de seleção |
Remover |
Exclui o script do evento selecionado na caixa de seleção |
AppBrowser |
Abre o AppBrowser |
Procurar |
Procura por palavras no script |
Procurar Anterior |
Procura a ocorrência anterior de uma palavra |
Procurar Próximo |
Procura a próxima ocorrência de uma palavra |
Substituir |
Substitui ocorrências de uma palavra |
Compilar Script |
Verifica os scripts do evento corrente |
Compilar Scripts da Conversão |
Verifica todos os scripts da Conversão corrente |
Compilar Scripts do Comando |
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 do 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 do 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 do 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 no objeto de Comando) apresentar o valor igual ao campo Operate Feedback (configurado na área de Ações de Comandos). Este evento também ocorre nas seguintes situações: término do tempo limite de feedback, pedido de cancelamento do Comando, ou falha na execução do método Operate. Este evento pode ser utilizado para gerar logs e mensagens de status da operação |
OnSelectFinished |
Evento acionado quando a propriedade SelectFeedbackTag (configurada no objeto de Comando) apresentar o valor igual ao campo Select Feedback (configurado na área de Ações de Comandos). Este evento também ocorre nas seguintes situações: término do tempo limite de feedback, pedido de cancelamento do Comando, ou falha na execução do método Select. Este evento pode ser utilizado para gerar logs e mensagens de status da operação |
OnCancelFinished |
Evento acionado quando a propriedade CancelFeedbackTag (configurada no 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 for detectada na execução do método Cancel. Este evento pode ser utilizado para gerar logs e mensagens de status da operação |
Cada evento possui um conjunto de parâmetros que permite que o 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 são apresentados na tabela a seguir.
Parâmetros disponíveis nos scripts de métodos e eventos dos Comandos
Parâmetro |
Descrição |
|---|---|
ActorID |
Disponibiliza para o script o nome do usuário que requisitou o 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 do 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 do Comando foi provocada por time-out (FeedbackError igual a Verdadeiro) |
ScriptError |
Booleano disponível nos eventos OnOperateFinished, OnSelectFinished e OnCancelFinished para indicar que ocorreu erro de script |
Para acessar valores da instância do objeto de Comando nos scripts de eventos, utilize a expressão Application.GetObject, informando a propriedade que deseja acessar. Exemplo:
Set Tag = Application.GetObject(OperateWriteTag)