SAP Métodos de conector

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 7 min. de leitura
  • . SAP o conector fornece vários métodos que você pode usar para automatizar fluxos de trabalho no SAP Interfaces de interface gráfica do usuário (GUI). SAP os métodos de conector estão disponíveis em diferentes níveis - conector, tela e elemento.

    SAP Métodos de conector

    . SAP Os 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 SAP objeto 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. SAP conector.

      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. SAP conector.
      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 SAP Elementos 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. SAP conector.
      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 conectados.

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

    Conexão aberta
    Estabelece uma conexão entre o conector e o. SAP aplicaçã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 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
    ConecçãoEncerrar
    Fecha a conexão entre o conector e o. SAP aplicação.

    Métodos no nível da tela

    Clique em MenuItem
    Seleciona o item de menu do qual você especifica o ID em SAP tela .
    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 SAP tela.
    CreateSession
    Cria uma sessão do SAP tela.
    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
    Retornar 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 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 N/D
    ObtWindowHandle
    Retorna o identificador da janela do SAP tela da aplicação.
    ÉCriado
    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. SAP tela.
    Minimizar
    Minimiza o. SAP tela.
    Redimensionar
    Redimensiona o. SAP tela 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 SAP tela da aplicação como uma cadeia de caracteres.
    Chaves de envio

    Envia os pressionamentos do teclado para o. SAP tela 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 SAP tela. 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
    JunteTodos os Filhos 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 SAP conector, 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
    Realce
    ÉCriado
    Clique com o mouse
    Chaves de envio
    Definir foco
    WaitForCriar
    Tabela 12. Métodos GuiCheckBox
    Elemento Métodos
    GuiCheckBox Verificação
    Realce
    Está verificado
    ÉCriado
    Chaves de envio
    Definir foco
    Desmarque
    Clique com o mouse
    WaitForCriar
    Tabela 13. Métodos GuiComboBox
    Elemento Métodos
    GuiComboBox Obter
    Nome de GetIconName
    GetList
    Realce
    ÉCriado
    Chaves de envio
    Definir
    Definir foco
    Clique com o mouse
    WaitForCriar
    Tabela 14. Métodos GuiCtrlGridView
    Elemento Métodos
    GuiCtrlGridView Clique em ButtonCell
    Clique em Célula
    DeseleçãoTodosRows
    GetCellType
    Valor de célula
    Obter colunas
    Par de valores de GetColumnsKeyValuePair
    Contagem de linhas
    GetRows
    ObteRowsByColumn
    Colunas selecionadas
    GetSelectedRows
    Obtuma linha
    GetVisibleRows
    Realce
    ÉCriado
    Clique com o mouse
    Chaves de envio
    Definir foco
    SelecioneTodosRows
    SelecioneCélula
    SelecionContextMenuItemById
    SelecionoContextMenuItemByPosition
    SelecionarContextMenuItemByText
    SelecioneLinha única
    SelecionarToolbarMenuItemById
    SelecionoMenuitemToolbarMenuByPosition
    SelecionarMenuBarra de ferramentas por Texto
    Valor de célula
    WaitForCriar
    Tabela 15. Métodos de guilabel
    Elemento Métodos
    Guilabel Gettext
    Realce
    ÉCriado
    Clique com o mouse
    Chaves de envio
    Definir foco
    WaitForCriar
    Tabela 16. Métodos do GuiPass
    Elemento Métodos
    GuiPass Realce
    ÉCriado
    Chaves de envio
    PosiçãoCaretCaretPosition
    Definir foco
    SetText
    Clique com o mouse
    WaitForCriar
    Tabela 17. Métodos GuiRadioButton
    Elemento Métodos
    GuiRadioButton Realce
    Está verificado
    ÉCriado
    Selecionar
    Chaves de envio
    Definir foco
    Clique com o mouse
    WaitForCriar
    Tabela 18. Métodos GuiStatusBar
    Elemento Métodos
    GuiStatusBar GetStatus
    Realce
    ÉCriado
    Clique com o mouse
    Chaves de envio
    Definir foco
    WaitForCriar
    Tabela 19. Métodos GuiTab
    Elemento Métodos
    GuiTab Realce
    ÉCriado
    SelecioneTab
    Chaves de envio
    Definir foco
    Clique com o mouse
    WaitForCriar
    Tabela 20. Métodos GuiTableControl
    Elemento Métodos
    GuiTableControl DeseleçãoAllVisibleRows
    DeseleçãoLinha
    DeseleçãoVisibleRow
    ObteTodosVisibleRows
    GetColumnNames
    ObtMaximumScrollOffset
    Posição de GetScrollScrollPosition
    Obtuma linha
    Obter tabela
    Contagem de FilmeVisibleRowCount
    Realce
    ÉCriado
    Clique com o mouse
    ScrollDownByOneRow
    DeslocaPosição Horizontal
    ScrollToNextPage
    ScrollToAnteriorPágina
    Posição vertical
    ScrollUpByOneRow
    SelecioneTodosRows
    SelecioneLinha única
    SelecionoVisibleRow
    Chaves de envio
    Definir foco
    WaitForCriar
    Tabela 21. Métodos GuiTextBox
    Elemento Métodos
    GuiTextBox Gettext
    Realce
    ÉCriado
    Chaves de envio
    PosiçãoCaretCaretPosition
    Definir foco
    SetText
    Clique com o mouse
    WaitForCriar
    Tabela 22. Métodos GuiTree
    Elemento Métodos
    GuiTree Verificação
    Clique em NodeItem
    CollapseNodeItem
    Duplo clickNode
    DuplockNodeItem
    Par de valores de GetColumnsKeyValuePair
    GetTreeType
    GetNodeKeyByPath
    GetNodeKeyByText
    GetNodeItemText
    NoesSelecionados
    GetNodeItemCheckBoxState
    Realce
    ÉCriado
    Botão ItemNodeItem
    SelecioneTab
    Chaves de envio
    Definir foco
    Clique com o mouse
    SelecionoNodeItem
    Nó Selecionável
    SelecionContextMenuItemById
    SelecionarContextMenuItemByText
    SelecionoContextMenuItemByPosition
    Desmarque
    WaitForCriar
    Tabela 23. Métodos GuiUserArea
    Elemento Métodos
    GuiUserArea Realce
    ÉCriado
    Clique com o mouse
    ScrollToNextPage
    ScrollToAnteriorPágina
    Chaves de envio
    Definir foco
    SetHorizontalScroll
    SetRolagem vertical
    WaitForCriar