Métodos e Propriedades dos Objetos SAP GUI Scripting

Entender os métodos e propriedades dos objetos SAP GUI é importante para que você consiga personalizar o script, usando os recursos disponíveis.

• Métodos: são ações predefinidas que podem ser executadas em um objeto, como clicar em um botão ou pressionar uma tecla.

• Propriedades: são características ou traços que descrevem um objeto, como seu texto, posição ou tipo.

Métodos e Propriedades dos Objetos SAP GUI

Veja a seguir exemplos de propriedades e métodos que você pode encontrar ao trabalhar com SAP GUI Scripting:

1. FindById (Método)
   • Localiza um elemento SAP GUI com base no seu ID único.
   • Exemplo: session.FindById("wnd[0]/usr/txtRSYST-MANDT")
   • Utilizado para acessar campos, botões e outros elementos da interface.
2. SendVKey (Método)
   • Envia uma tecla de função ou atalho para a tela SAP.
   • Exemplo: session.findById("wnd[0]").SendVKey 0
   • Usado para navegar, por exemplo, “Enter” (0), “F3” (3) ou outras teclas.
3. Press (Método)
   • Simula o clique de um botão na interface SAP.
   • Exemplo: session.findById("wnd[0]/tbar[0]/btn[0]").Press
   • Usado para automatizar a interação com botões na tela.
4. Text (Propriedade)
   • Captura ou define o valor de um campo de texto.
   • Exemplo: session.findById("wnd[0]/usr/txtRSYST-MANDT").Text = "100"
   • Usado para inserir ou ler texto de um campo.
5. Selected (Propriedade)
   • Indica ou altera o status de seleção de um checkbox ou radiobutton.
   • Exemplo: session.findById("wnd[0]/usr/chkSOME_CHECKBOX").Selected = true
   • Usado para marcar ou desmarcar opções de seleção.
6. Expand (Método)
   • Expande um nó em uma árvore de navegação.
   • Exemplo: session.findById("wnd[0]/usr/ctxtSOME_TREE").Expand
   • Útil para navegar por estruturas hierárquicas como menus e listas de seleção.
7. Collapse (Método)
   • Oposto de Expand, recolhe um nó expandido.
   • Exemplo: session.findById("wnd[0]/usr/ctxtSOME_TREE").Collapse
   • Usado para fechar seções ou nós.
8. SetFocus (Método)
   • Move o foco para um campo ou elemento específico.
   • Exemplo: session.findById("wnd[0]/usr/txtSOME_FIELD").SetFocus
   • Útil para garantir que um campo específico esteja ativo antes de executar uma ação.
9. DoubleClick (Método)
   • Simula um duplo clique em um objeto.
   • Exemplo: session.findById("wnd[0]/usr/lblSOME_LABEL").DoubleClick
   • Usado para interagir com elementos que requerem essa ação para abrir detalhes, como linhas em uma tabela.
10. Key (Propriedade)

• Define ou captura a chave de um item em uma lista suspensa ou combo box.
• Exemplo: session.findById("wnd[0]/usr/cmbSOME_COMBO").Key = "01"
• Útil para selecionar valores em listas.

11. Rows (Propriedade)

• Captura o número de linhas em uma tabela.
• Exemplo: session.findById("wnd[0]/usr/tblSOME_TABLE").Rows.Count
• Usado para iterar sobre tabelas e processar dados.

12. Column (Propriedade)

• Captura ou define o valor de uma coluna em uma tabela.
• Exemplo: session.findById("wnd[0]/usr/tblSOME_TABLE").Column("SOME_COLUMN").Text
• Usado para ler ou editar valores em colunas específicas de tabelas.

13. Select (Método)

• Seleciona uma linha em uma tabela ou lista.
• Exemplo: session.findById("wnd[0]/usr/tblSOME_TABLE").Rows(0).Select
• Usado para marcar itens em uma lista ou tabela.

14. Close (Método)

• Fecha uma janela ou diálogo no SAP GUI.
• Exemplo: session.findById("wnd[1]").Close
• Usado para fechar janelas auxiliares ou de confirmação.

15. Value (Propriedade)

• Define ou captura o valor de um campo numérico ou texto.
• Exemplo: session.findById("wnd[0]/usr/txtSOME_FIELD").Value = "12345"
• Usado para entrada e extração de valores em campos de input.

Esses métodos e propriedades são amplamente usados em scripts de automação com SAP GUI e Excel VBA para interagir de forma eficaz com os elementos da interface do SAP. Isso permite automatizar operações repetitivas e garantir a consistência nas tarefas executadas.

A documentação completa sobre SAP GUI Scripting, você encontra aqui neste link

Veja aqui, a hierarquia do modelo de objeto do SAP GUI scripting.

Métodos e Propriedades dos Objetos SAP – participe

O que achou dos Métodos e Propriedades dos Objetos SAP? Deixe sua opinião nos comentários.

Se este conteúdo foi relevante para você, convide seus amigos para que eles também fiquem sabendo deste material.

Precisa desta automação na sua empresa? Entre em contato e vamos conversar.

Um abraço e até a próxima.