SAP Métodos de conector

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 6 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 Design e conecte-os.

    Métodos conectados.

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

    OpenConnection
    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 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
    Encerrar Conexão
    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. Clique em 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 ID da sessão criada. Saída de dados Cadeia de caracteres N/D N/D
    EndSession
    Encerra a sessão aberta.
    EndTransaction
    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 especificado 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
    GetWindowHandle
    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.
    IsSessionBusy
    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 do ecrã ao longo do eixo X. Dados em Inteiro Nenhum(a) Sim
    YPos Posição do ecrã 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 SAP tela da aplicação.

    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 Pressionamentos do teclado que você deseja enviar para SAP tela. Dados em Cadeia de caracteres N/D Sim
    Iniciar transaçã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 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. Todos os controles dinâmicos são carregados depois que a tela é criada.
    Tabela 10. 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?
    TimeoutInSeconds Duração após a qual o método expira. Dados em Inteiro Nenhum(a) Sim
    MatchAllChild 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. Dados em Booliano Falso(a) Não

    Métodos em nível de 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
    MouseClick
    Chaves de envio
    SetFocus
    WaitForCriar
    Tabela 12. Métodos GuiCheckBox
    Elemento Métodos
    GuiCheckBox Verificação
    Realce
    Está verificado
    ÉCriado
    Chaves de envio
    SetFocus
    Desmarque
    MouseClick
    WaitForCriar
    Tabela 13. Métodos GuiCombo
    Elemento Métodos
    GuiCombo Box Obter
    GetIconName
    GetList
    Realce
    ÉCriado
    Chaves de envio
    Conjunto
    SetFocus
    MouseClick
    WaitForCriar
    Tabela 14. GuiCtrlGridView métodos
    Elemento Métodos
    GuiCtrlGridView Clique em ButtonCell
    Clique em Célula
    Desmarque AllRows
    GetCellType
    GetCellValue
    ObtColunas
    GetColumnsKeyValuePair
    GetRow Count
    GetRows
    ObteRowsByColumn
    ObtColunas Selecionadas
    ObtedRows Selecionados
    GetSingleRow
    GetVisibleRows
    Realce
    ÉCriado
    MouseClick
    Chaves de envio
    SetFocus
    SelecionoTodas as Rows
    Célula Selecionável
    ContextMenuItemById
    SeleContextMenuItemByPosition
    SeleContextMenuItemByText
    SelecionoSingleRow
    SelecionarMenuItemById da ferramenta
    SelecionoToolbarMenuPorPosition
    SelecionoMenuBarMenuPorText
    SetCellValue
    WaitForCriar
    Tabela 15. Métodos de Guilabel
    Elemento Métodos
    Guilabel Gettext
    Realce
    ÉCriado
    MouseClick
    Chaves de envio
    SetFocus
    WaitForCriar
    Tabela 16. Métodos do GuiPassword
    Elemento Métodos
    GuiPassword Realce
    ÉCriado
    Chaves de envio
    SetCaretPosition
    SetFocus
    SetText
    MouseClick
    WaitForCriar
    Tabela 17. Métodos GuiRadioButton
    Elemento Métodos
    GuiRadioButton Realce
    Está verificado
    ÉCriado
    Selecionar
    Chaves de envio
    SetFocus
    MouseClick
    WaitForCriar
    Tabela 18. Métodos GuiStatusBar
    Elemento Métodos
    GuiStatusBar ObtStatus
    Realce
    ÉCriado
    MouseClick
    Chaves de envio
    SetFocus
    WaitForCriar
    Tabela 19. Métodos GuiTab
    Elemento Métodos
    GuiTab Realce
    ÉCriado
    SelecionTab
    Chaves de envio
    SetFocus
    MouseClick
    WaitForCriar
    Tabela 20. Métodos GuiTableControl
    Elemento Métodos
    GuiTableControl Desmarque AllVisibleRows
    Desmarque a linha
    Desmarque VisibleRow
    ObteToVisibleRows
    GetColumnNames
    GetMaximumScrollOffset
    GetScrollPosition
    GetSingleRow
    GetTable
    GetVisibleRow Count
    Realce
    ÉCriado
    MouseClick
    ScrollDowByOneRow
    RollToHorizontalPosition
    ScrollToNextPage
    ScrollToAnteriorPágina
    RollToPosiçãoVertical
    ScrollUpByOneRow
    SelecionoTodas as Rows
    SelecionoSingleRow
    SeleLinha Visible
    Chaves de envio
    SetFocus
    WaitForCriar
    Tabela 21. Métodos GuiTextBox
    Elemento Métodos
    GuiTextBox Gettext
    Realce
    ÉCriado
    Chaves de envio
    SetCaretPosition
    SetFocus
    SetText
    MouseClick
    WaitForCriar
    Tabela 22. Métodos GuiTree
    Elemento Métodos
    GuiTree Verificação
    Clique em NodeItem
    CollapseNodeItem
    DoubleClickNode
    DoubleClickNodeItem
    GetColumnsKeyValuePair
    GetTreeType
    GetNodeKeyByPath
    GetNodeKeyByText
    GetNodeItemText
    ObterNodes Selecionados
    GetNodeItemCheckBoxState
    Realce
    ÉCriado
    Botão ItemNodeItemPressNode
    SelecionTab
    Chaves de envio
    SetFocus
    MouseClick
    SelecionNodeItem
    SelecionNó
    ContextMenuItemById
    SeleContextMenuItemByText
    SeleContextMenuItemByPosition
    Desmarque
    WaitForCriar
    Tabela 23. Métodos GuiUserArea
    Elemento Métodos
    GuiUserArea Realce
    ÉCriado
    MouseClick
    ScrollToNextPage
    ScrollToAnteriorPágina
    Chaves de envio
    SetFocus
    SetHorizontalScroll
    SetVerticalRolagem
    WaitForCriar