Compartilhar via

Ações de automação do SAP

Nosso grupo de ações para automação do SAP fornece um conjunto de ferramentas para ajudar a agilizar e automatizar seus fluxos de trabalho do SAP. Com essas ações, você pode iniciar facilmente o aplicativo GUI do SAP, criar novas sessões, selecionar itens de menu, iniciar e encerrar transações e muito mais.

Com as ações do grupo de automação do SAP, você pode interagir facilmente com os elementos da interface do usuário do SAP clicando neles, preenchendo campos de texto e extraindo seus dados. Basta inserir o valor do atributo da ID do elemento da interface do usuário do SAP. Se você não souber o valor da ID, poderá usar o seletor de elementos da interface do usuário do Power Automate para desktop para capturar o elemento SAP necessário e recuperar o valor da ID. Quando você captura um elemento de interface do usuário do SAP dessa maneira, apenas o valor de ID do elemento é recuperado e nenhum elemento de interface do usuário é adicionado ao repositório de elementos de interface do usuário do fluxo da área de trabalho.

Nossas ações de automação do SAP também podem ser perfeitamente integradas a outras ações disponíveis no Power Automate para desktop, incluindo o grupo de ações de automação da interface do usuário. Esse grupo de ações permite capturar todos os elementos da interface do usuário da GUI do SAP e adicioná-los ao repositório de elementos da interface do usuário do fluxo da área de trabalho. Ao combinar nossas ações de automação da GUI do SAP com o grupo de ações de automação da interface do usuário, você pode criar fluxos de trabalho RPA avançados que automatizam até mesmo os processos SAP mais complexos.

Observação

O Power Automate para desktop suporta automação com A GUI do SAP versão 750 ou posterior.

Iniciar o SAP

Abra o aplicativo da GUI do SAP e conecte-se a um sistema SAP.

Para modo de conexão:

  • A opção de descrição do servidor permite conectar-se a um sistema SAP por meio do nome SAP ou endereço IP. Para fazer isso, você precisa das credenciais de login e permissões de acesso necessárias. A descrição do servidor é um nome ou descrição legível do sistema SAP.
  • A opção de cadeia de conexão do servidor permite conectar-se a um sistema SAP por meio de uma cadeia de conexão. A cadeia de conexão do servidor normalmente inclui o nome ou endereço IP do servidor, o número da instância e o ID do sistema. A cadeia de conexão do servidor é um formato específico para identificar e conectar-se a um sistema SAP.

Para várias opções de logon:

  • A opção Encerrar este logon encerra o logon da ação específica.
  • Continue esse logon e finalize qualquer outro logon. A opção substitui a instância SAP existente pelo logon específico.
  • Continuar esse logon sem encerrar nenhum outro logon na opção do sistema cria uma nova sessão SAP.

Observação

A GUI do SAP não permite mais de seis conexões ativas (sessões) com um sistema SAP.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Modo de conexão N/A Descrição do servidor e cadeia de conexão do servidor Descrição do servidor Especifique como se conectar ao servidor da GUI do SAP.
Modo de logon N/A Logon manual e logon único (SSO) Logon manual Especifique como fazer logon no servidor da GUI do SAP, entre manualmente no servidor inserindo seu nome de usuário e sua senha ou usando o logon único (SSO).
Descrição do servidor Sim Valor do texto Especifica o nome do sistema SAP ou o endereço IP da conexão.
Connection string Sim Valor do texto Especifica a cadeia de conexão para o servidor GUI do SAP. A cadeia de conexão é um identificador exclusivo que especifica o nome do servidor, o número do sistema e outros detalhes da conexão.
Cliente Não Valor do texto Especifica o número do cliente SAP para conexão.
Username Não Valor do texto Especifica o ID do usuário SAP para logon.
Password Sim Valor do texto Especifica a senha do usuário SAP para logon.
Linguagem Não Valor do texto Especifica o idioma de logon do SAP para a interface do usuário.
Várias opções de logon Não Encerre este logon, continue este logon e encerre quaisquer outros logons, Continue este logon sem encerrar nenhum outro logon no sistema Terminar este logon Várias opções de logon especificam como o sistema SAP se comporta quando o usuário tenta fazer logon quando já está conectado.

Variáveis produzidas

Argumento Type Description
SAPInstance Instância do SAP A instância do SAP a ser usada com ações de automação SAP. A instância SAP refere-se à janela SAP específica.
CurrentSAPLoginTerminated Valor booliano Se o logon SAP que está sendo executado com a ação específica foi terminado ou não.
OtherSAPLoginTerminated Valor booliano Se os outros logons do SAP foram terminados ou não.

Exceções

Exceção Description
A ação de logon da GUI do SAP falha Indica um problema ao entrar em um sistema GUI do SAP.

Attach

Anexe o aplicativo SAP GUI em execução a uma instância SAP.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Modo Anexar Não Primeiro plano ou último ativado, título da janela Título da janela Especifica o modo para vincular a instância SAP a uma janela. Se a opção Primeiro plano ou a última opção ativada for selecionada, a instância SAP será vinculada à sessão SAP em primeiro plano. Se não houver nenhuma sessão SAP em primeiro plano, ela será vinculada à última sessão SAP que foi iniciada, e ainda não foi fechada.
Título da janela Sim Texto Especifica o título da janela SAP à qual a instância está vinculada. O título da janela pode ser selecionado na lista suspensa de sessões SAP existentes ou inserido manualmente.

Variáveis produzidas

Argumento Type Description
SAPInstance Instância do SAP A instância do SAP a ser usada com ações de automação SAP. A instância SAP refere-se à janela SAP específica.

Exceções

Exceção Description
Anexar a erro do SAP Indica um problema ao vincular a uma instância SAP.

Criar sessão SAP

Cria uma sessão SAP com base na mesma instância SAP.

Observação

A GUI do SAP não permite mais de seis conexões ativas (sessões) com um sistema SAP.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
SAPInstance Não Instância do SAP Selecione a variável que mantém a instância SAP na qual você deseja trabalhar. Essa variável deve ser definida em uma ação de logon do SAP anterior.

Variáveis produzidas

Argumento Type Description
SAPInstance Instância do SAP A instância do SAP a ser usada com ações de automação SAP. A instância SAP refere-se à janela SAP específica.

Exceções

Exceção Description
Falha ao criar nova ação de sessão SAP Indica um problema ao criar uma nova sessão do SAP.

Selecionar o item de navegação do SAP

Selecione um item de menu do SAP na barra de ferramentas do aplicativo da janela da SAP.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
SAPInstance Não Instância do SAP Selecione a variável que mantém a instância SAP na qual você deseja trabalhar. Defina essa variável em uma ação de login anterior do SAP.
Nome do item de navegação Não Valor do texto O nome do item na barra de ferramentas de navegação a ser selecionado, como 'Sistema'. Você também pode especificar uma opção em um submenu usando o símbolo '>' para indicar a relação pai-filho. Por exemplo, 'Programa > Executar' significa que foi selecionada a opção 'Executar', que faz parte do submenu em 'Programa'.

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Erro de item da barra de ferramentas de navegação selecionado pelo SAP GUI Indica um problema ao selecionar um item da barra de ferramentas de navegação.

Selecionar item de menu do SAP

Selecione um item de menu SAP na barra de ferramentas da janela. Insira manualmente o nome do item no respectivo parâmetro de entrada, no mesmo idioma em que a tela da GUI do SAP está sendo exibida.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
SAPInstance Não Instância do SAP Selecione a variável que mantém a instância SAP na qual você deseja trabalhar. Essa variável deve ser definida em uma ação de logon do SAP anterior.
Nome do item de menu Não Valor do texto O nome do item de menu na barra de ferramentas a ser selecionado, como 'Salvar'. Insira o nome do item de menu conforme exibido na instalação SAP da máquina.

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
A ação de seleção do item de menu do SAP falha Indica um problema ao selecionar um item de menu.

Encerrar conexão de SAP

Fecha a conexão do SAP da instância SAP selecionada. Observe que todas as instâncias relacionadas à conexão específica serão encerradas.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
SAPInstance Não Instância do SAP Selecione a variável que mantém a instância SAP na qual você deseja trabalhar. Essa variável deve ser definida em uma ação de logon do SAP anterior.

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
A ação de fechar sessão do SAP falha Indica um problema ao fechar uma sessão do SAP.

Iniciar transação SAP

Abre um código de transação específico na sessão existente.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
SAPInstance Não Instância do SAP Selecione a variável que mantém a instância SAP na qual você deseja trabalhar. Essa variável deve ser definida em uma ação de logon do SAP anterior.
Código da transação Não Valor do texto O código de transação que você deseja executar.

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Falha ao iniciar ação de transação do SAP Indica um problema ao iniciar uma transação do SAP.

Encerrar transação SAP

Fecha a transação do SAP em uma instância SAP específica e retorna ao menu de acesso fácil do SAP. Uma transação do SAP deve ser iniciada antes para a sessão do SAP específica.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
SAPInstance Não Instância do SAP Selecione a variável que mantém a instância SAP na qual você deseja trabalhar. Essa variável deve ser definida em uma ação de logon do SAP anterior.

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Falha ao encerrar a ação de transação do SAP Indica um problema ao finalizar uma transação do SAP.

Clique no elemento da interface do usuário do SAP

Interage por meio da ação de clique em qualquer elemento da interface do usuário de uma janela do SAP.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
SAPInstance Não Instância do SAP Selecione a variável que mantém a instância SAP na qual você deseja trabalhar. Essa variável deve ser definida em uma ação de logon do SAP anterior.
Tipo de elemento Não Elemento SAP básico, caixa de seleção, rótulo, lista suspensa, elemento grade Elemento do SAP básico Selecione o tipo de elemento SAP com o qual você deseja interagir. A opção 'Clique no elemento SAP' executa uma ação de clique em qualquer elemento SAP, como botões, botões de opção, guias, campos de texto ou árvores.
ID do elemento do SAP Não Numérico A ID do elemento SAP. Esse parâmetro determina o elemento da interface do usuário no SAP com o qual a ação interage. Você pode usar o botão abaixo para indicar o elemento da interface do usuário do SAP na tela do SAP ou inserir o valor manualmente.
ID do elemento do SAP Não Numérico A ID do elemento SAP. Esse parâmetro determina o elemento da interface do usuário no SAP com o qual a ação interage. Você pode usar o botão abaixo para indicar o elemento da interface do usuário do SAP na tela do SAP ou inserir o valor manualmente.
Definir o estado da caixa de seleção do SAP como Sim Marcada, Desmarcada Marcados Especifique se a caixa de seleção fica marcada ou desmarcada.
Operação de rótulo do SAP Sim Expandir, Recolher, Escolher Expandir Especifique se deseja expandir ou recolher o rótulo do SAP.
Valor de opção suspensa Sim Valor do texto Especificar se a opção suspensa está selecionada.
Elemento da grade do SAP Sim Célula, Linha, Cabeçalho, Lista, Botão, Botão da Barra de Ferramentas, Caixa de Seleção, Botão de Opção Célula Selecione o tipo de elemento da grade SAP com o qual você deseja interagir.

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Clique em erro de Elemento da GUI do SAP Indica falha no clique.

Obter detalhes do elemento da interface do usuário do SAP

Obtém o valor do atributo de um elemento da interface do usuário do SAP em uma janela do SAP.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
SAPInstance Não Instância do SAP Selecione a variável que mantém a instância SAP na qual você deseja trabalhar. Essa variável deve ser definida em uma ação de logon do SAP anterior.
ID do elemento do SAP Não Numérico A ID do elemento SAP. Esse parâmetro determina o elemento da interface do usuário no SAP com o qual a ação interage. Você pode usar o botão abaixo para indicar o elemento da interface do usuário do SAP na tela do SAP ou inserir o valor manualmente.
Nome do atributo Não Valor do texto Próprio texto O atributo cujo valor é recuperado.

Variáveis produzidas

Argumento Type Description
AttributeValue Valor do texto O valor do atributo do elemento da interface do usuário do SAP.

Exceções

Exceção Description
Erro ao obter detalhes do elemento do SAP Indica um problema ao recuperar o atributo do elemento de interface do usuário.

Preencher campo de texto do SAP no elemento

Preenche uma caixa de texto em uma janela SAP com o texto especificado.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
SAPInstance Não Instância do SAP Selecione a variável que mantém a instância SAP na qual você deseja trabalhar. Essa variável deve ser definida em uma ação de logon do SAP anterior.
ID do elemento do SAP Não Numérico A ID do elemento SAP. Esse parâmetro determina o elemento da interface do usuário no SAP com o qual a ação interage. Você pode usar o botão abaixo para indicar o elemento da interface do usuário do SAP na tela do SAP ou inserir o valor manualmente.
Texto para preencher Não Entrada direta criptografada ou Valor do texto O texto que preencherá o campo de texto do SAP
Se o campo não estiver em branco Sim Substituir texto, acrescentar texto Substituir texto Especifique se o conteúdo existente deve ser substituído ou acrescentado.

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Erro ao Preencher Valor do Campo de Texto do SAP Indica um problema ao preencher o campo de texto do SAP especificado.
  • Last updated on