Nesta lição, você configurará a extensão parameterValidator
definida na lição anterior para o projeto de plug-in.
O ponto de extensão parameterValidator permite
às extensões de contribuição validarem o valor de um parâmetro
específico à medida que ele vai sendo inserido pelo usuário. Para essa amostra, o parâmetro value
aceita um caractere numérico de único dígito menor do que quatro. Serão usados
os diferentes valores possíveis que o usuário pode inserir no parâmetro value
para exibir diferentes mensagens informativas para o usuário e para garantir
que o usuário insira somente caracteres numéricos.
- Comece configurando a extensão parameterValidators.
Na perspectiva Desenvolvimento de Plug-in, clique com o botão
direito do mouse no projeto de plug-in com.ibm.carma.plugin.howto
e selecione Ferramentas do PDE > Abrir Manifesto.
O Editor de Plug-in será
aberto.
- Na lista de guias da parte inferior, selecione Extensões.
Nessa página, deverão aparecer as extensões associadas ao projeto de
plug-in. Selecione a opção (parameterValidator) abaixo
do ponto de extensão com.ibm.carma.ui.parameterValidators. À direita, os Detalhes do Elemento de Extensão serão
listados.
- Use o RAM do PDS de Amostra para essa amostra, uma vez que este é o
RAM ao qual foi incluída a ação customizada e os parâmetros apropriados
no arquivo de configuração criado na Lição 1. No campo de texto uniqueId,
insira com.ibm.carma.sample.PDSRAM.
- Abra a visualização Repositórios do CARMA
e conecte ao sistema remoto.
- Expanda o sistema host e clique com o RAM que gostaria de usar,
clique com o botão direito do mouse no RAM específico e selecione Propriedades.
- Na caixa de diálogo Propriedade para RAM que é
aberta, deve aparecer a identificação exclusiva listada. Esse
é o uniqueId que será usado ao configurar os pontos de extensão.
- No campo de texto classe, insira o nome
da classe que contém o código que especifica os detalhes
da validação do parâmetro. Insira o nome de classe com.ibm.carma.plugin.howto.action.ValueParamValidationAction.
Essa classe será criada posteriormente neste exercício.
- No campo de texto parameterId, insira
o parâmetro definido no RAM do PDS ao qual a validação do parâmetro
se aplica. Para essa amostra, use o parâmetro value,
definido no RAM do PDS com um parameterId de 000 na
Lição 1.
- Finalmente, no campo de texto actionId,
insira a ação definida no RAM do PDS ao qual a validação do parâmetro
deve ser aplicada. Para essa amostra, use a ação customizada Instruções,
definida no RAM do PDS com um actionId de 100 na
Lição 1.
Agora você configurou um parameterValidator para
validar o parâmetro value na ação customizada Instruções
para o RAM do PDS.