SAP Métodos de conector

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

SAP Métodos de conector

. SAPOs métodos de conector estão disponíveis em três níveis.

• Aplicação : Você pode encontrar esses métodos ao clicar duas vezes em SAPobjeto do conector. Para acessar esses métodos, execute as seguintes etapas:
  1. Adicione o conector SAP em Objetos globais em Explorador de projetos painel.

     Para obter mais informações, consulte Configure o. SAPconector.

  2. Clique duas vezes no objeto Conector SAP.

     Os métodos aparecem no painel Explorador de objetos.

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

     Os métodos aparecem no painel Explorador de objetos.

• Elemento : Use estes métodos para automatizar ações no SAPElementos de IU da tela, 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, execute as seguintes etapas:
  1. Adicione uma ou mais telas da aplicação SAP. Para aprender a configurar, consulte Configure o. SAPconector.
  2. Capture um ou mais elementos da tela. Para aprender a capturar, consulte Use a caixa de diálogo Capturar elemento.

     Os elementos da tela aparecem na tela SAP capturada.

  3. Clique duas vezes no elemento da tela.

     Os métodos aparecem no painel Explorador de objetos.

Use os métodos

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

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

Conexão aberta

Estabelece uma conexão entre o conector e o. SAPaplicação. Primeiro, você deve 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.	Dados em	Cadeia de caracteres	Nenhum(a)	Sim
nome do usuário	Nome de usuário para fazer a conexão.	Dados em	Cadeia de caracteres	Nenhum(a)	Sim
senha	Senha para fazer a conexão.	Dados em	Cadeia de caracteres	Nenhum(a)	Sim

SetDefaultSession

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.	Dados em	Cadeia de caracteres	Nenhum(a)	Sim

Conexão encerrada

Fecha a conexão entre o conector e o. SAPaplicação.

Métodos no nível da tela

Clique em MenuItem

Seleciona o item de menu do qual você especifica o ID em SAPtela .

Tabela 3. Parâmetros do método MenuItem

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.	Dados em	Cadeia de caracteres	Nenhum(a)	Sim

Fechar

Fecha a sessão do SAPtela.

CreateSession

Cria uma sessão do SAPtela.

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 parte específica da aplicação SAP.	Dados em	Cadeia de caracteres	N/D	Sim
Retorno	Retorna o. ID da sessão criada.	Saída de dados	Cadeia de caracteres	N/D	N/D

Sessão final

Encerra a sessão aberta.

Transação final

Encerra uma transação.

Foco

Define o foco na sessão aberta.

GetMenuItem

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.	Dados em	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 por seu 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

ObtWindowHandle

Retorna o identificador da janela do SAPtela da aplicação.

EstCriado

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

SessiçãoBusy

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

Maximizar

Maximiza o. SAPtela.

Minimizar

Minimiza o. SAPtela.

Redimensionar

Redimensiona o. SAPtela de acordo com as dimensões especificadas.

Tabela 7. Parâmetros do método de redimensionamento

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.	Dados em	Inteiro	Nenhum(a)	Sim
Pos	Posição da tela ao longo do eixo Y.	Dados em	Inteiro	Nenhum(a)	Sim
Largura	Largura da tela.	Dados em	Inteiro	Nenhum(a)	Sim
Altura	Altura da tela.	Dados em	Inteiro	Nenhum(a)	Sim

Restaurar

Restaura a tela para suas dimensões originais.

ScreenId

Retorna o ID do SAPtela da aplicação como uma cadeia de caracteres.

EnviarChaves

Envia os pressionamentos do teclado para o. SAPtela da aplicação.

Tabela 8. Parâmetros do método de chaves de envio

Parâmetro	Descrição	Tipo de entrada de porta de dados	Tipo de dados	Valor padrão	Obrigatório?
Chaves	Pressionamentos de teclado que você deseja enviar para SAPtela.	Dados em	Cadeia de caracteres	N/D	Sim

Transação inicial

Inicia uma transação.

Tabela 9. Parâmetros do método de transação inicial

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 parte específica da aplicação SAP.	Dados em	Cadeia de caracteres	N/D	Sim

WaitForCriar

Aguarda a duração especificada enquanto a tela está sendo criada. Isso permite que todos os controles dinâmicos sejam carregados após a criação da tela.

Tabela 10. WaitForCriar parâmetros de método

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.	Dados em	Inteiro	Nenhum(a)	Sim
MatchAllChildren	Opção para indicar se, antes de carregar a tela, o método corresponde a todas as telas secundárias capturadas e elementos com a tela.	Dados em	Booliano	Falso(a)	Não

Métodos no nível do elemento

Em SAPconector, você pode usar esses métodos no nível do 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	Clicar
	Realce
	EstCriado
	Clique com o mouse
	EnviarChaves
	Definir Foco
	WaitForCriar

Tabela 12. GuiCheckBox

Elemento	Métodos
GuiCheckBox	Verificação
	Realce
	Está verificado
	EstCriado
	EnviarChaves
	Definir Foco
	Desmarque
	Clique com o mouse
	WaitForCriar

Tabela 13. Métodos GuiComboBox

Elemento	Métodos
GuiComboBox	Obter
	GetIconName
	GetList
	Realce
	EstCriado
	EnviarChaves
	Definir
	Definir Foco
	Clique com o mouse
	WaitForCriar

Tabela 14. Métodos GuiCtrlGridView

Elemento	Métodos
GuiCtrlGridView	Clique em ButtonCell
	Clique na célula
	DeseleçãoAllRows
	GetCellType
	GetCellValue
	Obter colunas
	Par de valores-chave de GetColumnsKeyValuePair
	GetRowCount
	GetRows
	ObteRowsByColumn
	Colunas selecionadas
	GetSelectedRows
	Obtuma linha
	GetVisibleRows
	Realce
	EstCriado
	Clique com o mouse
	EnviarChaves
	Definir Foco
	SelecionarTodas as Rows
	SelecioneCélula
	SelecionContextMenuItemById
	SelecionoContextMenuItemByPosition
	SelecionarContextMenuItemByText
	SelecioneLinha única
	SelecionarToolbarMenuItemById
	SelecionoMenuBarra de ferramentas DePosição
	SelecionarMenuBarra de ferramentas PorTexto
	Definir Valor Cell
	WaitForCriar

Tabela 15. Métodos de guilabel

Elemento	Métodos
Guilabel	Gettext
	Realce
	EstCriado
	Clique com o mouse
	EnviarChaves
	Definir Foco
	WaitForCriar

Tabela 16. Métodos do GuiPass

Elemento	Métodos
GuiPass	Realce
	EstCriado
	EnviarChaves
	Definir PosiçãoCaretCaretPosition
	Definir Foco
	SetText
	Clique com o mouse
	WaitForCriar

Tabela 17. Métodos GuiRadioButton

Elemento	Métodos
GuiRadioButton	Realce
	Está verificado
	EstCriado
	Selecionar
	EnviarChaves
	Definir Foco
	Clique com o mouse
	WaitForCriar

Tabela 18. Métodos GuiStatusBar

Elemento	Métodos
GuiStatusBar	GetStatus
	Realce
	EstCriado
	Clique com o mouse
	EnviarChaves
	Definir Foco
	WaitForCriar

Tabela 19. GuiTab

Elemento	Métodos
GuiTab	Realce
	EstCriado
	SelecioneTab
	EnviarChaves
	Definir Foco
	Clique com o mouse
	WaitForCriar

Tabela 20. GuiTableControl

Elemento	Métodos
GuiTableControl	DeseleçãoAllVisibleRows
	Desmarque a linha
	Desmarque VisibleRow
	ObteTodosVisibleRows
	GetColumnNames
	GetMaximumScrollOffset
	Posição de ObecçãoScroll
	Obtuma linha
	Obter tabela
	Contagem de FilmeVisible
	Realce
	EstCriado
	Clique com o mouse
	ScrollDownByOneRow
	ScrollToPosição Horizontal
	ScrollToNextPage
	ScrollToAnteriorPágina
	ScrollToPosição vertical
	ScrollUpByOneRow
	SelecionarTodas as Rows
	SelecioneLinha única
	SelecionoVisibleRow
	EnviarChaves
	Definir Foco
	WaitForCriar

Tabela 21. GuiTextBox

Elemento	Métodos
GuiTextBox	Gettext
	Realce
	EstCriado
	EnviarChaves
	Definir PosiçãoCaretCaretPosition
	Definir Foco
	SetText
	Clique com o mouse
	WaitForCriar

Tabela 22. Métodos GuiTree

Elemento	Métodos
GuiTree	Verificação
	NodeItem
	CollapseNodeItem
	Duplo clickNode
	DuplockNodeItem
	Par de valores-chave de GetColumnsKeyValuePair
	GetTreeType
	GetNodeKeyByPath
	GetNodeKeyByText
	GetNodeItemText
	ObtedNodes Selecionados
	GetNodeItemCheckBoxState
	Realce
	EstCriado
	Botão ItemNodeItem
	SelecioneTab
	EnviarChaves
	Definir Foco
	Clique com o mouse
	SelecionoNodeItem
	Nó selecionado
	SelecionContextMenuItemById
	SelecionarContextMenuItemByText
	SelecionoContextMenuItemByPosition
	Desmarque
	WaitForCriar

Tabela 23. GuiUserArea

Elemento	Métodos
GuiUserArea	Realce
	EstCriado
	Clique com o mouse
	ScrollToNextPage
	ScrollToAnteriorPágina
	EnviarChaves
	Definir Foco
	SetHorizontalScroll
	SetRolagem vertical
	WaitForCriar