Métodos de emulador do Rocket BlueZone

Use os métodos do emulador Rocket BlueZone para executar várias tarefas de automação no emulador Rocket BlueZone.

Métodos no nível da tela

Use métodos no nível da tela para executar as tarefas de automação na tela do emulador. Por exemplo, você pode usar Simular um comando na tela ou obter texto da tela.

GetFieldText

Retorna o texto que um campo contém depois de identificar o campo pelo número de linha e coluna que você especificar. A linha e a coluna especificadas são o ponto de partida do campo. O método identifica o campo inteiro e retorna o texto no campo. No exemplo a seguir, . é a primeira letra e o ponto de partida no campo e. SO do host: é o texto completo no campo.

Tabela 1. Parâmetros do método GetFieldText

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório(a)	Anotações
Linha	Número da linha do campo que identifica o campo.	Dados em	Inteiro	N/D	Sim
Coluna	Número da coluna do campo que identifica o campo.	Dados em	Inteiro	N/D	Sim
Retornar	Retorna o texto no campo.	Saída de dados	Cadeia de caracteres	N/D	N/D

GetTextFromRect

Retorna o texto em todos os campos de uma área retangular que você define na tela. Você define uma área fornecendo as linhas iniciais e finais e os números das colunas. O método localiza e identifica o primeiro e o último campos e retorna todo o texto em todos os campos nessa área. O exemplo a seguir mostra a área que você definiu.

Tabela 2. Parâmetros do método GetTextFromRect

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório(a)	Anotações
Linha Inicial	Número de linha que indica o primeiro caractere do primeiro campo na área retangular.	Dados em	Inteiro	N/D	Sim
StartCol	Número da coluna que contém o primeiro caractere do primeiro campo na área retangular.	Dados em	Inteiro	N/D	Sim
EndRow	Número da linha que contém o último caractere do último campo na área retangular.	Dados em	Inteiro	N/D	Sim
EndCol	Número da coluna que contém o último caractere do último campo na área retangular.	Dados em	Inteiro	N/D	Sim
Retornar	Retorna o texto de todos os campos na área retangular.	Saída de dados	Cadeia de caracteres	N/D	N/D

ÉCriado

Verifica se a tela do emulador existe com base na regra de correspondência de tela e pode aceitar entradas do usuário. Após a verificação, o método retorna o valor booliano apropriado.

Tabela 3. Éparâmetros do método criado

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório(a)	Anotações
MatchAllChild	Opção para encontrar a tela do emulador combinando os elementos secundários que você capturou.	Dados em	Booliano	Falso(a)	Sim	Aviso: Usar esta opção pode tornar o método mais lento.
Retornar	Retorna o valor booliano dependendo se a tela do emulador existe com base na regra de correspondência de tela e pode aceitar entradas do usuário.	Saída de dados	Booliano	N/D	N/D

SearchText

Retorna os números da linha e da coluna que contém o primeiro caractere do texto especificado. Por exemplo, se você especificar a cadeia de caracteres emulador , o método retorna os números de linha e coluna do ponto inicial da palavra emulador que é e .

Nota:

Se você fornecer o texto que abrange vários campos, as portas Linha e Coluna retornarão 0 porque o método oferece suporte ao texto somente de um único campo.

Tabela 4. Parâmetros do método SearchText

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório(a)	Anotações
Texto	Texto pesquisado pelo método.	Dados em	Cadeia de caracteres	N/D	Sim	O texto especificado pode diferenciar maiúsculas de minúsculas, dependendo do emulador usado.
Linha	Número da linha que tem o primeiro caractere do texto especificado.	Saída de dados	Inteiro	N/D	N/D	Se o texto especificado ocorrer em várias linhas e colunas, o método retornará a primeira linha e coluna que contém o texto.
Coluna	Número da coluna que tem o primeiro caractere do texto especificado.	Saída de dados	Inteiro	N/D	N/D	Se o texto especificado ocorrer em várias linhas e colunas, o método retornará a primeira linha e coluna que contém o texto.

Chaves de envio

Simula os pressionamentos de tecla inseridos no teclado na posição do dispositivo do mouse na tela do emulador. Por exemplo, você pode simular o. <enter> pressionamento de tecla na tela.

Tabela 5. Parâmetros do método SendKeys

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório(a)	Anotações
Chaves	Pressionamentos de tecla que você insere no teclado.	Dados em	Cadeia de caracteres	Nenhum(a)	Sim	Dica: Para saber mais sobre os pressionamentos de tecla, consulte a respectiva documentação do emulador de terminal.

SendKeySecure

Simula os pressionamentos de tecla que é uma cadeia de caracteres segura na posição do dispositivo do mouse na tela do emulador.

Tabela 6. Parâmetros do método SendKeySecure

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório(a)	Anotações
Chaves	Pressionamentos de tecla que você insere como uma cadeia de caracteres segura.	Dados em	Cadeia de caracteres protegida	Nenhum(a)	Sim	Dica: Para saber mais sobre os pressionamentos de tecla, consulte a respectiva documentação do emulador de terminal.

ConfiguCursorPosition

Tenta definir o mouse no número de linha e coluna que você especificar.

Tabela 7. Parâmetros do método SetCursorPosition

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório(a)	Anotações
Linha	Opção para fornecer o número da linha com base na qual o método tenta definir o mouse na tela.	Dados em	Inteiro	N/D	N/D	O número da linha deve ser positivo e estar dentro do tamanho da tela do emulador. Por exemplo, se o tamanho da tela for 24x80, o valor máximo que você pode fornecer para uma linha será 24.
Coluna	Opção para fornecer o número da linha com base na qual o método tenta definir o mouse na tela.	Dados em	Inteiro	N/D	N/D	O número da coluna deve ser positivo e estar dentro do tamanho da tela do emulador. Por exemplo, se o tamanho da tela for 24x80, o valor máximo que você pode fornecer para uma coluna será 80.

WaitForCriar

Aguarda a duração especificada enquanto o conector usa a regra de correspondência de tela para descobrir se a tela existe.

Tabela 8. WaitForCreate parâmetros do método

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório(a)	Anotações
Timeoutemsegundos	Opção para fornecer o número de segundos que o método espera enquanto o conector usa a regra de correspondência de tela para descobrir se a tela existe.	Dados em	Inteiro	30	Sim
MatchAllChild	Opção para corresponder a todos os elementos da tela que você capturou para descobrir se a tela existe.	Dados em	Booliano	Falso(a)	Sim	Aviso: Usar esta opção pode atrasar a execução do método.
Retornar	Retorna o valor booliano com base na localização da tela do emulador.	Saída de dados	Booliano	N/D	N/D

Métodos em nível de elemento

Os métodos no nível de elemento executam tarefas de automação nos elementos da tela do emulador que você adiciona na tela Conector de terminal. Você pode adicionar um elemento de tela como um campo ou uma tabela.

GetAsTable

Retorna o texto que você capturou como um objeto de tabela de dados. Use este método ao capturar os dados de uma tela como uma tabela. No entanto, você também pode usar o método para os dados que captura como um campo. Para saber como capturar os dados como uma tabela, consulte Configure o. IBM Emulador de Comunicações pessoais.

Tabela 9. Parâmetros do método GetAsTable

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório(a)	Anotações
Retornar	Retorna o texto capturado da tela do terminal como um objeto de tabela de dados.	Saída de dados	Tabela de dados	N/D	N/D	Para exibir a tabela, clique com o botão direito do mouse no parâmetro e selecione Visualizar dados .

Gettext

Retorna o texto no campo que você capturou na tela do emulador. Se você usar este método para uma tabela que capturou, ele retornará o texto no primeiro campo do retângulo.

Tabela 10. Parâmetros do método gettext

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório?	Anotações
Retornar	Retorna o texto do campo capturado.	Saída de dados	Cadeia de caracteres	N/D	N/D

ÉCriado

Corresponde às regras e verifica se o elemento capturado existe.

Tabela 11. Éparâmetros do método criado

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório(a)	Anotações
Retornar	Retorna o valor booliano com base se o elemento está ativo.	Saída de dados	Booliano	N/D	N/D

SetText

Tenta definir o texto para o campo.

Tabela 12. Parâmetros do método SetText

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório(a)	Anotações
Texto	Opção para especificar o texto que o método tenta definir no campo.	Dados em	Cadeia de caracteres	N/D	Sim	Este método não pode ser usado em telas de emulador protegidas.

WaitForCriar

Aguarda a duração especificada enquanto o conector usa a regra de correspondência para descobrir se o elemento existe.

Tabela 13. WaitForCreate parâmetros do método

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório(a)	Anotações
Timeoutemsegundos	Opção para fornecer o número de segundos que o método espera enquanto o conector usa a regra de correspondência para descobrir se o elemento existe.	Dados em	Inteiro	30	Sim
Retornar	Retorna o valor booliano dependendo se o elemento foi encontrado.	Saída de dados	Booliano	N/D	N/D