SAP Métodos de conector

O conector SAP fornece vários métodos que você pode usar para automatizar fluxos de trabalho nas interfaces SAP da interface gráfica do usuário (GUI). SAP métodos de conector estão disponíveis em diferentes níveis - conector, tela e elemento.

SAP Métodos de conector

Os métodos do conector SAP estão disponíveis em três níveis.

• Aplicação: você pode encontrar esses métodos ao clicar duas vezes no objeto de conector SAP. Para acessar esses métodos, siga estas etapas:
  1. Adicione o conector SAP em Objetos globais no painel Explorador de projetos.

     Para obter mais informações, consulte Configurar o conector SAP.

  2. Clique duas vezes no objeto do conector do SAP.

     Os métodos aparecem no painel Pesquisador de objetos.

• Tela: use esses métodos para automatizar tarefas em uma tela da aplicação SAP que você adicionou. Por exemplo, automatize a maximização de uma janela de aplicação. Para acessar esses métodos, siga estas etapas:
  1. Adicione uma ou mais telas da aplicação SAP. Para aprender a configurar, consulte Configurar o conector SAP.
  2. Clique duas vezes na tela que você adicionou.

     Os métodos aparecem no painel Pesquisador de objetos.

• Elemento: use esses métodos para automatizar ações nos elementos de IU da tela SAP, por exemplo, um botão ou uma caixa de seleção. Por exemplo, automatize a seleção de um botão. Para acessar esses métodos, siga estas etapas:
  1. Adicione uma ou mais telas da aplicação SAP. Para aprender a configurar, consulte Configurar o conector SAP.
  2. Capture um ou mais elementos de tela. Para aprender a capturar, consulte Usar a caixa de diálogo Capturar elemento.

     Os elementos de tela aparecem na tela do SAP capturada.

  3. Clique duas vezes no elemento de tela.

     Os métodos aparecem no painel Pesquisador de objetos.

Usar os métodos

Para criar uma automação usando os métodos, arraste-os do painel do Pesquisador de objetos para a superfície Design e conecte-os.

Métodos no nível da aplicação

OpenConnection

Estabelece uma conexão entre o conector e a aplicação SAP. Você deve primeiro usar este método antes de executar uma automação.

Tabela 1. Parâmetros do método OpenConnection

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório?
nome	O nome da conexão.	Entrada de dados	Cadeia de caracteres	Nenhum(a)	Sim
nome do usuário	Nome de usuário para fazer a conexão.	Entrada de dados	Cadeia de caracteres	Nenhum(a)	Sim
senha	Senha para fazer a conexão.	Entrada de dados	Cadeia de caracteres	Nenhum(a)	Sim

DefinirSessãoPadrão

Torna a sessão selecionada uma sessão padrão.

Tabela 2. Parâmetros do método SetDefaultSession

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório?
sessionId	ID exclusivo da sessão que você deseja definir como padrão.	Entrada de dados	Cadeia de caracteres	Nenhum(a)	Sim

FecharConexão

Encerra a conexão entre o conector e a aplicação SAP.

Métodos no nível da tela

Clique em ItemDeMenu

Seleciona o item de menu em que você especifica o ID de na tela SAP.

Tabela 3. Parâmetros do método ClickMenuItem

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório?
menuId	O ID do menu que deve ser selecionado.	Entrada de dados	Cadeia de caracteres	Nenhum(a)	Sim

Encerrar

Encerra a sessão da tela SAP.

Criar sessão

Cria uma sessão da tela SAP.

Tabela 4. Parâmetros do método CreateSession

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório?
tCode	Código de transação que permite acessar uma parte específica da aplicação SAP.	Entrada de dados	Cadeia de caracteres	N/D	Sim
Retornar	Retorna o ID da sessão criada.	Saída de dados	Cadeia de caracteres	N/D	N/D

Término da sessão

Encerra a sessão aberta.

EndTransaction

Encerra uma transação.

Foco

Define o foco na sessão aberta.

ObterItemMenu

Obtém o nome do item de menu especificado.

Tabela 5. Parâmetros do método GetMenuItem

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório?
menuId	ID do item de menu para obter o nome.	Entrada de dados	Cadeia de caracteres	Nenhum(a)	Sim
Retornar	Retorna o nome do item de menu	Saída de dados	Cadeia de caracteres	Nenhum(a)	N/D

GetMenuItemsIdsByName

Recupera o ID do menu que você especifica pelo nome.

Tabela 6. Parâmetros do método GetMenuItemsIdsByName

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório?
menuItemName	Nome do item de menu.	Saída de dados	Lista	Nenhum(a)	N/D

GetWindowHandle

Retorna o identificador da janela da tela da aplicação SAP.

É criado

Retorna verdadeiro se a sessão for criada, falso se a sessão não for criada.

É sessão ocupada

Retorna verdadeiro se a sessão estiver ocupada e falso se não estiver ocupada.

Maximizar

Maximiza a tela SAP.

Minimizar

Minimiza a tela SAP.

Redimensionar

Redimensiona a tela SAP de acordo com as dimensões especificadas.

Tabela 7. Redimensionar parâmetros do método

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório?
xPos	Posição da tela ao longo do eixo X.	Entrada de dados	Números inteiros	Nenhum(a)	Sim
yPos	Posição da tela ao longo do eixo Y.	Entrada de dados	Números inteiros	Nenhum(a)	Sim
Largura	Largura da tela.	Entrada de dados	Números inteiros	Nenhum(a)	Sim
Altura	Altura da tela.	Entrada de dados	Números inteiros	Nenhum(a)	Sim

Restaurar

Restaura a tela às suas dimensões originais.

ScreenId

Retorna o ID da tela da aplicação SAP como uma cadeia de caracteres.

SendKeys

Envia os toques do teclado para a tela da aplicação SAP.

Tabela 8. 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?
Chaves	Toques do teclado que você deseja enviar para a tela SAP.	Entrada de dados	Cadeia de caracteres	N/D	Sim

IniciarTransação

Inicia uma transação.

Tabela 9. Parâmetros do método StartTransaction

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório?
tCode	Código de transação que permite acessar uma parte específica da aplicação SAP.	Entrada de dados	Cadeia de caracteres	N/D	Sim

AguardarCriação

Aguarda a duração especificada enquanto a tela é criada. Isso permite que todos os controles dinâmicos sejam carregados depois que a tela é criada.

Tabela 10. Parâmetros do método WaitForCreate

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório?
timeoutInSeconds	Duração após a qual o método expira.	Entrada de dados	Números inteiros	Nenhum(a)	Sim
CorresponderTodos os Filhos	Opção para indicar se, antes de carregar a tela, o método corresponde a todas as telas e elementos secundários capturados com a tela.	Entrada de dados	Booliano	Falso	Não

Métodos no nível do elemento

No conector SAP, você pode usar esses métodos no nível de elemento para identificar elementos, verificar sua presença na tela ou definir ações a serem executadas nos elementos.

As tabelas a seguir incluem elementos e seus métodos disponíveis. Para obter a descrição desses métodos e seus parâmetros, consulte SAP Métodos de conector.

Tabela 11. Métodos GuiButton

Elemento	Métodos
GuiButton	Clique em
	Realce
	É criado
	Clique do mouse
	SendKeys
	DefinirFoco
	AguardarCriação

Tabela 12. Métodos GuiCheckBox

Elemento	Métodos
GuiCheckBox	Verificação
	Realce
	Está verificado
	É criado
	SendKeys
	DefinirFoco
	Desmarcar
	Clique do mouse
	AguardarCriação

Tabela 13. Métodos GuiComboBox

Elemento	Métodos
GuiComboBox	Obter
	GetIconName
	ObterLista
	Realce
	É criado
	SendKeys
	Conjunto
	DefinirFoco
	Clique do mouse
	AguardarCriação

Tabela 14. Métodos GuiCtrlGridView

Elemento	Métodos
GuiCtrlGridView	CélulaClicarBotão
	Célula de clique
	Desmarcar todas as linhas
	ObterTipoDeCélula
	ObterValorCélula
	ObterColunas
	ObterParDeChaveColunas
	ObterContagemDeRinhas
	ObterRinhas
	ObterRowsByColumn
	ObterColunasSelecionadas
	ObterRinhasSelecionadas
	ObterSingleRow
	GetVisibleRows
	Realce
	É criado
	Clique do mouse
	SendKeys
	DefinirFoco
	SelecionarTodasRinhas
	Selecionar célula
	SelectContextMenuItemById
	SelectContextMenuItemByPosition
	SelectContextMenuItemByText
	SelecionarSingleRow
	SelectToolbarMenuItemById
	Selecionar item de menu da barra de ferramentas por posição
	SelecionarBarraDeFerramentaMenuItemPorTexto
	DefinirValorCélula
	AguardarCriação

Tabela 15. Métodos GuiLabel

Elemento	Métodos
RótuloGuil	ObterTexto
	Realce
	É criado
	Clique do mouse
	SendKeys
	DefinirFoco
	AguardarCriação

Tabela 16. Métodos GuiPassword

Elemento	Métodos
SenhaGuia	Realce
	É criado
	SendKeys
	SetCaretPosition
	DefinirFoco
	Definir texto
	Clique do mouse
	AguardarCriação

Tabela 17. Métodos GuiRadioButton

Elemento	Métodos
GuiRadioButton	Realce
	Está verificado
	É criado
	Selecionar
	SendKeys
	DefinirFoco
	Clique do mouse
	AguardarCriação

Tabela 18. Métodos GuiStatusBar

Elemento	Métodos
GuiStatusBar	ObterStatus
	Realce
	É criado
	Clique do mouse
	SendKeys
	DefinirFoco
	AguardarCriação

Tabela 19. Métodos GuiTab

Elemento	Métodos
GuiTab	Realce
	É criado
	Selecionarguia
	SendKeys
	DefinirFoco
	Clique do mouse
	AguardarCriação

Tabela 20. Métodos GuiTableControl

Elemento	Métodos
GuiTableControl	Desmarcar todas as linhas visíveis
	Desmarcar linha
	Desmarcar linha visível
	ObterRinhasTodasVisíveis
	GetColumnNames
	GetMaximumScrollOffset
	GetScrollPosition
	ObterSingleRow
	ObterTabela
	GetVisibleRowCount
	Realce
	É criado
	Clique do mouse
	Rolar para BaixoPorUmaLinha
	RollToHorizontalPosition
	Rolar para a próxima página
	Rolar paraPáginaAnterior
	RollToVerticalPosition
	Rolar para CimaPorUmaLinha
	SelecionarTodasRinhas
	SelecionarSingleRow
	Selecionar linha visível
	SendKeys
	DefinirFoco
	AguardarCriação

Tabela 21. Métodos GuiTextBox

Elemento	Métodos
GuiTextBox	ObterTexto
	Realce
	É criado
	SendKeys
	SetCaretPosition
	DefinirFoco
	Definir texto
	Clique do mouse
	AguardarCriação

Tabela 22. Métodos GuiTree

Elemento	Métodos
GuiTree	Verificação
	ClickNodeItem
	CollapseNodeItem
	NóDoubleClick
	ItemDeNóDeDoubleClick
	ObterParDeChaveColunas
	ObterTipoDeÁrvore
	GetNodeKeyByPath
	GetNodeKeyByText
	ObterNodeItemText
	ObterNodesSelecionados
	GetNodeItemCheckBoxState
	Realce
	É criado
	PressNodeItemButton
	Selecionarguia
	SendKeys
	DefinirFoco
	Clique do mouse
	SelecionarNodeItem
	SelecionarNode
	SelectContextMenuItemById
	SelectContextMenuItemByText
	SelectContextMenuItemByPosition
	Desmarcar
	AguardarCriação

Tabela 23. Métodos GuiUserArea

Elemento	Métodos
GuiUserArea	Realce
	É criado
	Clique do mouse
	Rolar para a próxima página
	Rolar paraPáginaAnterior
	SendKeys
	DefinirFoco
	DefinirRolagemHorizontal
	DefinirRolagemVertical
	AguardarCriação